Rancher Chartsについて解説しました。 ファイルは、Creative Common フリーカルチャー・ライセンスです。pptx形式でアップロードしていて自由に改変、商用利用可能です。 コメントなどあれば、Qiitaの以下までお願いします。 Rancher Charts 紹介 - Qiita https://qiita.com/ynott/items/4df239022f43fac67590

1. Rancher Charts
Introduction
株式会社スタイルズ
矢野 哲朗
2018年11月17日

2. 自己紹介
経歴 ： システム運用 10年・ネットワーク 6年・SI 8年
近頃はownCloud 営業、翻訳を担当
Rancherの好きな機能 ：
その他 ： 全く上達しないRubyist
一番最初のPCは、OKI if-800 でした…。
矢野 哲朗
tetsurow.yano
株式会社スタイルズ
1

3. Rancher 2.0におけるカタログ
2
Rancher 1.6にはカタログというのがありました。1ボタンで必要なアプリ
ケーションがデプロイできるというとっても便利な機能でした。しかし、そ
れは、docker-compose.ymlを利用してるものでした。
Rancher 2.0 ではオーケストレーションがKubernetesベースになりました。
当然、docker-compose.ymlが使えなくなりました。
Kubernetesでのパッケージマネージャーはまだ混沌としている状態です
が、Rancher 2.0ではHelm Chartsというものを使うようになりました。

4. カスタムカタログとCharts
3
Helm Charts
Helm Chartsとは、アプリケーションを実行する為の様々なアプリケーションを含ん
だパッケージです。
元々のHelm Chartsでは、キーと値をペアのセットのパラメーターを理解し、それを
Answers としてセットしてデプロイする必要があります。
Helm 安定版とHelm インキュベーターでは、元々のHelm Chartがそのまま表示さ
れます。
カスタムカタログでHelm Charts(Rancher形式でない)を利用することもできます(も
ちろん、Rancher Chartsの利用を推奨します)。
Rancher Charts
Rancher Chartsは、元々のHelm Chartsをコピーしたものですが、利便性をよくす
るため app-readme.md と questions.yaml という2つのファイルを追加しています。
それぞれについて詳しくは、Rancher Charts 追加ファイルを参照してください。
https://rancher.com/docs/rancher/v2.x/en/catalog/custom

5. Rancher Chartsのメリット
4
リビジョンの追跡を拡張
Helmでは、バージョンごとのデプロイには対応していますが、Racher ではチ
ャート間のバージョンの違いを表示するためのトラッキングと改訂履歴を追加
しました。
アプリケーション起動の利便性向上
Rancher Chartsは、チャートの詳細と設定フォームを追加して、カタログアプリ
を簡単にデプロイできるようにしています。Rancher のユーザーは、Helm 変
数リストを全て確認して、アプリケーションの起動方法を考える必要はありま
せん。
アプリケーションリソース管理
Rancherは、アプリケーションの利用リソース状況を追跡します。アプリケーシ
ョンを動かす為のオブジェクトがリストアップされたページで簡単に確認するこ
とができ、トラブルシューティングすることもできます。

6. 5
Rancher Catalog
Rancher向けのファイル（元々のHelm Chartにはない）
app-readme.md question.yml
チャートのUIヘッダーに説明的なテキストを提供するファイル。
(以下の画像は、Rancherチャートとネイティブヘルムチャートの
違い)
チャートの展開を簡素化するためのフォームの質問を含むファイ
ル。
これがなければ、Key−Valueを使用して配置を構成する必要があ
る。

7. 6
Rancher Catalog
Chartの構造
Rancher
Chart
Description
app-readme.md ○ Rancher 2.0 UIで表示するためのReadmeファイル
charts/ Chartの依存関係を含めるディレクトリ
Chart.yaml Helm Chartの情報ファイル
question.yml ○ Rancher 2.0 UIに関する質問を含むファイル
templates/ values.ymlと組み合わせ、コンテナを生成するテンプレートYAMLの配
置
requirements.yml チャートの依存関係をリストするファイル
README.md Helm Readmeファイル。[詳細説明]に表示される。
values.yaml チャートのデフォルトの設定値
Helm Chart
Repository charts/<application name>/<app version>/
(例: charts/wordpress/v0.1/)

8. 7
Helm Charts の question.yml（1）
変数種別 値タイプ 必須 詳細
variable string true
values.yml ファイルで指定した変数名を定義する。ネストしたデータには、foo.bar のよ
うに利用する。
label string true
変数のUI上のラベル名を指定する。
description string false
変数の説明を記載する。
type string false
変数の定義種別を指定します。指定しない場合、デフォルトでは String です。現在サポ
ートされているタイプは、string、boolean、int、enum、password、storageclass、
hostname です。
required bool false
この値の定義が必須かどうかを指定します。(true と false)
default string false
変数のデフォルトの値を指定します。
group string false
入力値のグループを指定します。
min_length int false
最小文字数を指定します。
max_length int false
最大文字数を指定します。
min int false
最小値を指定します。
max int false
最大値を指定します。

9. 8
Helm Charts の question.yml（2）
変数種別 値タイプ 必須 詳細
options []string false
変数種別がenumの場合に指定します。例えば、以下のように指定します
options:
- “ClusterIP”
- “NodePort”
- “LoadBalancer”
valid_chars string false 入力文字列の正規表現による正しいバリデーションを指定します。
invalid_chars string false 入力文字列の正規表現による間違っているバリデーションを指定します。
subquestions []subquestion false ネストした入力項目を配列で指定します。
show_if string false
条件式がtrueの時に現在の値を表示します。
(例)show_if: "serviceType=Nodeport"
show_subquestion_
if
string false
show_subquestion_if が trueの時、または options のどれか一つ
に合致していたら subquestions を表示します。
(例)show_subquestion_if: "true"
※注意：subquestions[]には、keyとして subquestionsやshow_subquestion_if
をネストすることはできません。その他の種別は利用できます。

10. サンプル app-readme.md
9
# WordPress
[WordPress](https://wordpress.org/) is one of the most versatile open source content management systems on the market. Apublishing platform
for building blogs and websites.
This chartbootstraps a [WordPress](https://github.com/bitnami/bitnami-docker-wordpress) deployment ona [Kubernetes](http://kubernetes.io)
cluster using the [Helm](https://helm.sh) packagemanager.Thechartalso packages the [Bitnami MariaDB
chart](https://github.com/kubernetes/charts/tree/master/stable/mariadb) to provide the backend database for the WordPress application.
https://raw.githubusercontent.com/rancher/charts/master/charts/wordpress/v1.0.5/app-readme.md

11. サンプル questions.yml
10
categories:
-Blog
-CMS
questions:
-variable: defaultImage
default: "true"
description: "Usedefault Dockerimage"
label: UseDefault Image
type: boolean
show_subquestion_if: false
group: "ContainerImages"
subquestions:
-variable: image.repository
default: "bitnami/wordpress"
description: "WordPress image name"
type: string
label: WordPress Image Name
-variable: image.tag
default: "4.9.4"
description: "WordPress image tag"
type: string
label: ImageTag
-variable: mariadb.image.repository
default: "bitnami/mariadb"
description: "MariaDB image name"
type: string
label: MariaDB ImageName
-variable: mariadb.image.tag
default: "10.1.32"
description: "MariaDB image tag"
type: string
label: MariaDB ImageTag
https://github.com/rancher/charts/blob/master/charts/wordpress/v1.0.5/questions.yml
フォーム項目を以下にyaml配列で記述する
カタログリストの分類を表記する
変数名をvariable:の後に記載
ここが配列1つ
デフォルト値を記述
変数の詳細を記載
subquestions
変数のラベルを記載
変数種別
変数をまとめる
ラベルも兼ねる
defaultImageの値がfalseの場合
にsubquestions以下を表示する

12. question.yml と画面の対比
11
questions:
- variable: defaultImage
default: "true"
description: "Use default Docker image"
label: Use Default Image
type: boolean
show_subquestion_if: false
group: "Container Images“
subquestions:
・・・・・・
defaultImageの値がfalseの場合
にsubquestions以下を表示する
questions.yml
Rancher UI

13. Rancher Helmリソースの指定
12
Rancher Helmのquestions.yml でのコンテナーリソースの指定の仕方
例：GPUリソースの定義方法
1. Native HelmCharts のdeployment.yaml
https://github.com/helm/charts/blob/master/stable/tensorflow-
notebook/templates/deployment.yaml
で以下のように指定されているとする。
apiVersion: apps/v1beta2
kind: Deployment
metadata:
name: {{ template "tensorflow-notebook.fullname" . }}
labels:
app: {{ template "tensorflow-notebook.name" . }}
chart: {{ template "tensorflow-notebook.chart" . }}
release: {{ .Release.Name }}
heritage: {{ .Release.Service }}
spec:
selector:
matchLabels:
app: {{ template "tensorflow-notebook.name" . }}
release: {{ .Release.Name }}
template:
metadata:
labels:
app: {{ template "tensorflow-notebook.name" . }}
release: {{ .Release.Name }}
spec:
containers:
- name: jupyter
2. Native HelmCharts のvalues.yaml
https://github.com/helm/charts/blob/master/stable/tensorflow-
notebook/values.yaml
で以下のように指定されているとする。
# Default values for ack-tensorflow-dev.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
jupyter:
image:
repository: tensorflow/tensorflow
tag: 1.6.0-devel
pullPolicy: IfNotPresent
password: tensorflow
resources: {}
# limits:
# cpu: 100m
# memory: 128Mi
# nvidia.com/gpu: 1
# requests:
# cpu: 100m
# memory: 128Mi
# nvidia.com/gpu: 1
3. RacherHelmChartsの questions.yaml
以下のように指定する
# Default values for ack-tensorflow-dev.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
questions:
- variable: jupyter.resources.requests.nvidia.com/gpu
label: request gpu
default: 1
type: int
required: false
- variable: jupyter.resources.requests.cpu
label: request cpu
default: 100m
type: string
required: true
- variable: jupyter.resources.requests.memory
label: request memory
default: 128Mi
type: string
required: true
deployment.yaml values.yaml questions.yaml