Rancher Meetup Tokyo #2 - connpass https://connpass.com/event/44092/ #ranchermeetup

1. 1
Rancher CLIIntroduction to Rancher Command Line Interface
Dec 8, 2016
Rancher Meetup Tokyo #2
#ranchermeetup
@zembutsu

2. 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ドメインを持っていますが、コミュニティにお渡しします。

3. Rancher GUI
3
Easy to use
• visibility
• intuitive
Make Devs happy!
Make Opes happy!
さて今日はRancher。 GUIで、簡単にコンテナやクラスタを使えます。 分かりやすく直感的。 いいね！!

4. 4
Rancher’s background
• What kind of processing is in progress
• Just looking at the screen
• GUI operation missed
でも、画面の後ろ側の処理が見えません。 ホスト追加時は画面を眺めっぱなしですし、作業ミスも起こります…

5. 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」に近いコマンド体系。 分散環境の管理や作業時の調査にも。

6. CLI functions
Rancher Resources management
• host
• environment
• stack
• service
• container
6様々なRancher上のリソースを管理できます。 環境構築から、サービスやコンテナ単位の管理もコマンド１つで。

7. Download CLI
from GUI or GitHub repository
7
https://github.com/rancher/cli/releases
使うには管理画面の右下からバイナリをダウンロードするか、GitHubのリポジトリからダウンロード。

8. 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 -v
rancher version v0.4.0
Linux setup sample
Linuxの場合はこんな感じでシンプル。スクリプトでも入ります。

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

10. 10
configuration
$ rancher --url http://<HOST>:8080/ config
URL [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」コマンドの実行、または環境変数の宣言が必要です。

11. 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」コマンドと、

12. 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. 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. 14
$ rancher run nginx
1s23
$ rancher ps
ID TYPE NAME IMAGE STATE SCALE SYSTEM
ENDPOINTS DETAIL
1s20 kubernetesService default/kubernetes healthy 0/0 false
1s21 kubernetesService default/kubernetes healthy 0/0 false
1s22 kubernetesService default/kubernetes healthy 0/0 false
1s23 service default/suspicious-payne nginx activating 1/1 false
In Progress
$ rancher ps
ID TYPE NAME IMAGE STATE SCALE SYSTEM
ENDPOINTS DETAIL
1s20 kubernetesService default/kubernetes healthy 0/0 false
1s21 kubernetesService default/kubernetes healthy 0/0 false
1s22 kubernetesService default/kubernetes healthy 0/0 false
1s23 service default/suspicious-payne nginx healthy 1/1 false
環境構築後は「docker run」のように「rancher run」でコンテナや、カタログを実行できます。

15. 15
No need to operate GUI
...even if we deploy with Rancher
Rancherを使ったデプロイでも、GUI 操作は不要。 やったね！

16. Questions?
16
Reference
Rancher CLI Commands and Options
http://docs.rancher.com/rancher/v1.2/en/cli/commands/
GitHub Repository
https://github.com/rancher/cli/releases
ぜひ皆さんもお試しくださいね！