RancherとGiddyup
この記事はRancher Advent Calendar 2017の12/10の記事です。
12/3にconfdについて書きましたが(時間がなくて尻切れとんぼになったので後で補習記事書きます...)、Rancherでconfdを使用する場合、あくまでoutputはconfファイルのみ。コンテナの起動時にサービスの状態を取得して直接シェルスクリプトで制御したい場合もあります。そういった場合に使用するのがこれから紹介するGiddyupです。
Giddyupってなに?
GiddyupはRancherのサービスを構成する際に補助となるツールです。Goで書かれています。
こいつの存在を知ったのは、MongoDBカタログの特集記事を読んだ時です。
Building a MongoDB Catalog Item for Rancher
興味があって調べていくとDockerfileにgiddyupの存在が確認できます。
https://github.com/rancher/catalog-dockerfiles/blob/master/MongoDB/containers/0.1.0/mongodb-config/Dockerfile#L7
curl -L https://github.com/cloudnautique/giddyup/releases/download/v0.14.0/giddyup -o /opt/rancher/bin/giddyup
MongoDBので使用しているバージョンはBillがforkしたバージョンですがRancherの中の人なので公式と言って差し支えないかと。すでに本体に取り込まれて本体の方がバージョンが高いみたいですね。
(寄り道)MongoDBカタログについて
community-catalogのMongoDBのすごいところは サービス1つで以下構成を形成している
点です。
- primary
- secondary
- secondary
つまり、通常サービス内のコンテナをscaleしても同じ動きしかしないところを、複数の状態を持っているし、サービス内のコンテナ同士で連携もしているのです。
Giddyupを使ってみる
話しが脇道にそれました。では実際にgiddyupを使ってみましょう。
dockerイメージの準備
テスト用にcentosのイメージをベースにこんなDockerfileを書きました。
FROM centos:7
RUN curl -L https://github.com/rancher/giddyup/releases/download/v0.19.0/giddyup -o /giddyup \
&& chmod u+x /giddyup
この辺に置いておきますので使いたい方はどうぞ
https://hub.docker.com/r/mdaichang/giddyup-sample/
Rancherでスタックを作成
んで、テスト用にこんな感じでスタックを作成してみました(画面はサービスですが)。
簡単にカタログ作ってますのでrancher-compose.yml/docker-compose.ymlが欲しいかたはこちらをどうぞ。
https://github.com/m-daichang/rancher-catalog/tree/master/templates/giddyup-sample/0
(もちろんリポジトリごとPrivate Catalogに登録してそこから作成もできます。)
giddyupのテスト
コンテナに入って早速giddyupを叩いてみましょう。
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup
NAME:
giddyup - Entrypoint functions for Rancher
USAGE:
giddyup [global options] command [command options] [arguments...]
VERSION:
v0.19.0
COMMANDS:
exec exec out to a command
health simple healthcheck
ip Get IP information
leader Provides a deterministic way to elect, route traffic, and get a le
ader of a service
probe Probe a TCP/HTTP(S) endpoint to determine if it is healthy
service Service actions
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--metadata-url value override default MetadataURL (default:"http://rancher-metadata/2015-12-19")
--help, -h show help
--version, -v print the version
お約束のヘルプ情報です。
自分のIPを取得する
giddyup ip myip
だと自分のIPが取得できます。コンテナだとip
やifconfig
すら入っていないことが多いため割と便利です。
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup ip myip
10.42.49.154
サービスの全IPを取得する
giddyup ip stringify
だとサービス内のコンテナの全IPが文字列として取得できます。初期値はカンマ区切りですが、--delimiter
オプションを使うと区切り文字が指定できます。後はシェルスクリプト内で好きなように加工してしてください。
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup ip stringify
10.42.235.205,10.42.134.189,10.42.208.134
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup ip stringify --delimiter " "
10.42.235.205 10.42.134.189 10.42.208.134
自分がリーダーかどうかチェックする
自分がリーダー(サービス内で管理用idが一番小さい)かどうかチェックすることができます。これによりprimary/secondaryの制御が可能になります。終了コードで判断するので注意。
- リーダー: 0
- リーダー以外: 1
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup leader check; echo $?
0
[root@giddyup-sample-giddyup-sample-3 /]# /giddyup leader check; echo $?
1
ちなみにリーダーコンテナが障害等でいなくなった場合、自動的にリーダーが変わります。
試しにリーダーのコンテナをdeleteしてみましょう。
すると2号機(giddyup-sample-giddyup-sample-2)にリーダーが変わります。
[root@giddyup-sample-giddyup-sample-2 /]# /giddyup leader check; echo $?
0
その後元リーダーの1号機(giddyup-sample-giddyup-sample-1)は復旧しますが、リーダー以外のままです。
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup leader check; echo $?
1
これで例えばsecondaryがprimaryに昇格した後に、元primaryが復活しても移動したprimaryと喧嘩したりしなくなるわけですね。
サービスのscale数を確認する
giddyup service scale --current
を使うと現在のscale数が取得できます。
[root@giddyup-sample-giddyup-sample-1 /]# /giddyup service scale --current
3
サービスが設定した数が起動するまで待つ
giddyup service wait
を使うと設定したscale数になるまでプロンプトが返ってきません。何に使うかというと、replicationする時などに全コンテナが起動する必要がある場合などに使用します。--timeout
オプションを使用すると設定した秒数まで最大待ちます。
すると、ちゃんとコンテナが起動するまで待ちます。使用したイメージがすでにpull済みなのでscalingに時間がかからず、わかりづらいですが...
[root@giddyup-sample-giddyup-sample-1 /]# time /giddyup service wait scale --timeout 120
real 0m0.007s
user 0m0.000s
sys 0m0.000s
[root@giddyup-sample-giddyup-sample-1 /]# time /giddyup service wait scale --timeout 120
real 0m2.370s
user 0m0.010s
sys 0m0.000s
まとめ
他にも簡易healthcheckとかいろいろできるみたいなのですが、一旦この辺で。giddyupを使用するとサービスの状態とか自分がリーダーかどうか確認することができ、これを上手くentorypointに組み込めばステートフルなサービスもCatalogで組むことができそうです。皆さんも是非試してみてください。
Author And Source
この問題について(RancherとGiddyup), 我々は、より多くの情報をここで見つけました https://qiita.com/m-daichang/items/a9c2577f8e13a2130e6b著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .