rancher command line interface

1

Rancher CLIIntroduction to Rancher Command Line Interface

Dec 8, 2016Rancher Meetup Tokyo #2

#ranchermeetup@zembutsu

Who?

ZEMBUTSU Masahito / @zembutsu• Data Center Operations Engineer - SAKURA Internet Inc.

• Technology Evangelist (do.)

• My interest: Monitoring, laborsaving Operation

• rancher.jp domain name holder (dedicated to our community)

2

twitter: @zembutsu

SlideShare http://slideshare.net/zembutsu

Web Site https://pocketstudio.net/

前佛と申します。監視や省力化に興味あります。rancher.jpドメインを持っていますが、コミュニティにお渡しします。

Rancher GUI

3

Easy to use• visibility

• intuitive

Make Devs happy!

Make Opes happy!

さて今日はRancher。 GUIで、簡単にコンテナやクラスタを使えます。分かりやすく直感的。いいね！!

4

Rancher’s background• What kind of processing is in progress

• Just looking at the screen

• GUI operation missed

でも、画面の後ろ側の処理が見えません。ホスト追加時は画面を眺めっぱなしですし、作業ミスも起こります…

5

?

Rancher Command Line Interface

High affinity with docker• Similar to docker commands

• Distributed environment management

• Debugging and operation with logging

$ rancher ps

$ rancher hosts

そこでCLIの出番。「rancher」コマンドは「docker」に近いコマンド体系。分散環境の管理や作業時の調査にも。

CLI functions

Rancher Resources management• host

• environment

• stack

• service

• container

6様々なRancher上のリソースを管理できます。環境構築から、サービスやコンテナ単位の管理もコマンド１つで。

Download CLI

from GUI or GitHub repository

7

https://github.com/rancher/cli/releases

使うには管理画面の右下からバイナリをダウンロードするか、GitHubのリポジトリからダウンロード。

8

$ cd /tmp$ curl -o rancher-linux-amd64-v0.4.0.tar.gz ¥

-L https://github.com/rancher/cli/releases/download/v0.4.0/rancher-linux-amd64-v0.4.0.tar.gz$ tar xfz rancher-linux-amd64-v0.4.0.tar.gz$ cp ./rancher-v0.4.0/rancher /usr/local/bin/$ rancher -vrancher version v0.4.0

Linux setup sample

Linuxの場合はこんな感じでシンプル。スクリプトでも入ります。

9

API Add Account API Key

そしてCLIを使うには、「API」メニューから「API鍵」の発行が必要です。

10

configuration

$ rancher --url http://<HOST>:8080/ configURL [http://<HOST>:8080/]:Access Key []: <ACCESS_KEY>Secret Key []: <SECRET_KEY>INFO[0008] Saving config to /home/zem/.rancher/cli.json

$ export RANCHER_URL=http://<HOST_IP>:8080$ export RANCHER_ACCESS_KEY=<ACCESS_KEY>$ export RANCHER_SECRET_KEY=<SECRET_KEY>

or

そして、使う環境では「rancher config」コマンドの実行、または環境変数の宣言が必要です。

Deploy Kubernetes with CLI

11

$ rancher env create -t kubernetes myk8s

$ rancher env ls

ID NAME ORCHESTRATION STATE CREATED

1a5 Default cattle active 2016-12-06T00:36:18Z

1a7 myk8s kubernetes active 2016-12-06T07:27:24Z

一旦セットアップが終われば、Kubernetesの環境構築ですら「rancher env create」コマンドと、

Add Hosts

12

$ rancher --env myk8s host create ¥

--driver digitalocean --digitalocean-access-token $DO_TOKEN ¥

--digitalocean-size 1gb --digitalocean-region sgp1 demo1.rancher.jp

その後、ホストを追加するだけ。たった2行のコマンドを入力するだけ！

13

$ rancher --env myk8s host ls -a

ID HOSTNAME STATE CONTAINERS IP LABELS DETAIL

1h8 demo1.rancher.jp active 20 138.197.xxx.xxx

$ rancher events 1h8

GUI なら画面を眺めるだけのk8sセットアップも、「rancher events」コマンドならログや状況が分かります。安心。

14

$ rancher run nginx

1s23

$ rancher psID TYPE NAME IMAGE STATE SCALE SYSTEM

ENDPOINTS DETAIL

1s20 kubernetesService default/kubernetes healthy 0/0 false



1s23 service default/suspicious-payne nginx activating 1/1 false

In Progress

$ rancher psID TYPE NAME IMAGE STATE SCALE SYSTEM

ENDPOINTS DETAIL




1s23 service default/suspicious-payne nginx healthy 1/1 false

環境構築後は「docker run」のように「rancher run」でコンテナや、カタログを実行できます。

15

No need to operate GUI

...even if we deploy with RancherRancherを使ったデプロイでも、GUI 操作は不要。やったね！

Questions?

16

ReferenceRancher CLI Commands and Optionshttp://docs.rancher.com/rancher/v1.2/en/cli/commands/GitHub Repositoryhttps://github.com/rancher/cli/releases

ぜひ皆さんもお試しくださいね！

http://docs.rancher.com/rancher/v1.2/en/cli/commands/

https://github.com/rancher/cli/releases