狠狠撸

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

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

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

カスタムカタログと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

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

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

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/)

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
最大値を指定します。

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
をネストすることはできません。その他の種別は利用できます。

サンプル 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

サンプル 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以下を表示する

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

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:
template:
metadata:
labels:
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

狠狠撸

Rancher Charts Introduction

Recommended

More Related Content

What's hot (20)

Similar to Rancher Charts Introduction (20)

More from Tetsurou Yano (20)

Rancher Charts Introduction

Editor's Notes