Rancher UIから、KuberntesのStorage とStorage Classを使う使い方です。

1. Rancher Kubernetes Storages
株式会社スタイルズ
矢野 哲朗
2018年10月18日

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

3. Rancher のストレージとは？
2
基本的にKubernetesのストレージ
RancherはそのUIをしています
PV,PVC,StorageClassが実装されています
Kubernetesなストレージなので、基本的にそのまま使えます
CloudProvider
RancherからKubernetesをデプロイする場合は、CloudProviderの指定
が必須です

4. Kubernetes のストレージおさらい
3
 https://speakerdeck.com/hhiroshell/kubernetesbiao-zhun-falsesutoreziji-neng-woosaraisiyou

5. Kubernetesでストレージを利用する方法
Volumeを直接指定してContainerにマウントする
Volumeの要件を指定して、満たすものを自動的にマウ
ントする
Volumeの要件を指定して、満たすストレージを動的に
プロビジョニングしてマウントする
4
以下の3種類

6. Volume
 コンテナにマウント可能なボリュームを定義する情報
 ストレージの実態をポイントする
5
Volume（たとえばNFSのストレージ）
ストレージの実態
マウント
Pod

7. PersistentVolume(PV)/PersistentVolumeClaim(PVC)
 PVでストレージの実態をポイントする
 PVCで必要なディスクの要件（容量／書き込み権限の有無など）を指定しておき、それをVolumeから参照
する
 PVCの要件を満たすPVが自動的に選択され、使用される
Volume PVC PV
6
Pod

8. StorageClassを使ったPVCの動的プロビジョニング
 PVCでPVの代わりにStorageClassを指定
 上記PVCをKubernetes内に作ると、StorageClassで設定されたProvisionerがストレージをプロビジョニン
グし、それが利用される
 StorageClassでは、ディスク速度やサービスレベル等のパラメータを指定
Volume PVC PV GCEPersistentDisk（例）
7
Pod
SC SP
ProvisionerStorageClass

9. 今回、作った構成
8
 Rancher ＋ Minikube ＋ NFS
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
Pod
CSI
Persistent
Volume
Claim
RBAC

10. 2つのNFSマウント方法
9
 メリット
・他のコンテナー(or Pod)からも共有できる
・通常のNFSサーバーの使い方
・他のストレージを用意するよりも楽
 デメリット
・セキュリティーなし
・どこからでもマウント可能
①通常のNFSサーバーとしてマウントする
②Storage ClassとしてNFSサーバーをマウントす
る
 メリット
・コンテナ固有のストレージとして利用可能
・Namespace(or Project)間で覗かれることはな
い
 デメリット
・NFSサーバーというよりもストレージクラスとし
ての利用

11. NFSサーバーの作り方
10
NFSサーバーの作り方は
一般的なので今回は省略します

12. 11
通常のNFSサーバーとして
マウントする
１つめの方法

13. NFS ボリュームマウントを作るのに必要なもの
12
 Rancher ＋ Minikube ＋ NFS
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
CSI
RBAC
この1つが
必要！
Provisioner
Pod
Persistent
Volume
Claim

14. ①通常のNFSサーバーとしてマウントする
13
 通常のNFS接続をコンテナー内で実施する方法
apiVersion: v1
kind: Pod
metadata:
name: welcome-nfs
spec:
containers:
- name: welcome-nfs
image: busybox
args: [/bin/sh, -c, 'tail -f
/mnt/ngs/hello.txt']
volumeMounts:
- name: nfs-example
mountPath: "/mnt/nfs"
volumes:
- name: nfs-example
nfs:
server: 10.0.40.8
path: "/nfs-example"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
• spec.volumes:
– このPodで参照可能なVolume
を定義
• spec.containers.volumeMounts:
– コンテナにマウントする
Volumeと、マウント先のパス
を指定
• Deploymentsなどで、
templatesに書くときも同様

15. manifestファイルでできるのはわかるけど
14
でも、皆さんの知りたいのは、
Rancherですよね？

16. RancherでのNFSマウントの仕方
15
 ワークロードをデプロイする
適当に名前をつける
下へスクロール

17. ボリュームを追加
16
 「ボリューム」を開いて、「ボリュームを追加▽」を押して「エフェメラルボリュームを追加」をクリックし
ます
ここをクリック

18.  エフェメラルボリュームを定義で「NFS共有」を選択
NFS共有を選択
17
「NFS共有」を選択

19. NFSサーバーの設定
18
 NFSサーバー側のパスとサーバーIPアドレスを入力してvolumesを定義
NFSサーバーのパス NFSサーバーのIPアドレス
必要に応じて変更
定義をクリック

20. コンテナー側マウント設定
19
 コンテナー内部でのマウント先を設定
コンテナー内の
マウントパス
ボリューム名を指定
後は、通常通りコンテナーを起動する

21. 20
Storage Classとして
NFSサーバーをマウントする
２つめの方法

22. Storage Classを作るのに必要なもの
21
 Rancher ＋ Minikube ＋ NFS
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
CSI
RBAC
この4つが
必要！
Provisioner
Pod
Persistent
Volume
Claim

23. nfs-provisioner-deployment.yaml
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
name: nfs-client-provisioner
spec:
replicas: 1
strategy:
type: Recreate
template:
metadata:
labels:
app: nfs-client-provisioner
spec:
serviceAccountName: nfs-client-provisioner
containers:
- name: nfs-client-provisioner
image: quay.io/external_storage/nfs-
client-provisioner:latest
volumeMounts:
- name: nfs-client-root
mountPath: /persistentvolumes
env:
- name: PROVISIONER_NAME
value: minikube.stylez.co.jp/nfs
- name: NFS_SERVER
value: 192.168.99.1
- name: NFS_PATH
value: /home/t-yano/ext/nfs
volumes:
- name: nfs-client-root
nfs:
server: 192.168.99.1
path: /home/t-yano/ext/nfs

24. nfs-storageclass.yaml
23
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: local-nfs
provisioner: minikube.stylez.co.jp/nfs
PVC作成時に指定
する名前

25. nfs-rbac.yaml
24
apiVersion: v1
kind: ServiceAccount
metadata:
name: nfs-client-provisioner
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: nfs-client-provisioner-runner
rules:
- apiGroups: [""]
resources: ["persistentvolumes"]
verbs: ["get", "list", "watch", "create",
"delete"]
- apiGroups: [""]
resources: ["persistentvolumeclaims"]
verbs: ["get", "list", "watch", "update"]
- apiGroups: ["storage.k8s.io"]
resources: ["storageclasses"]
verbs: ["get", "list", "watch"]
- apiGroups: [""]
resources: ["events"]
verbs: ["list", "watch", "create", "update",
"patch"]
- apiGroups: [""]
resources: ["endpoints"]
verbs: ["get", "list", "watch", "create",
"update", "patch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: run-nfs-client-provisioner
subjects:
- kind: ServiceAccount
name: nfs-client-provisioner
namespace: default
roleRef:
kind: ClusterRole
name: nfs-client-provisioner-runner
apiGroup: rbac.authorization.k8s.io

26. Rancherの3つのメニューレベル
25
Rancherの全
体的な設定 クラスター単位の設定
プロジェクト単位の設定
(≠ネームスペース)
グローバル クラスター プロジェクト
３つあって、それぞれ設定適用範囲が違う

27. メニューレベルに応じた設定が必要
26
グローバル クラスター プロジェクト
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
CSI
RBAC
Pod
Persistent
Volume
Claim

28. プロビジョナー
27
グローバル クラスター プロジェクト
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
CSI
RBAC
Pod
Persistent
Volume
Claim

29. そういや、Rancherカタログに
28
 Rancher カタログに nfs-provisioner ってのがあるよね？これ使えないの？
このNFSプロビジョナーは、
KubernetesホストがNFSサーバー
をマウントしている
のが前提です
これは使えず、
nfs-client-provisionerを
利用する必要があります

30. 29
NFSプロビジョナーのデプロイ
DeploymentでデプロイされるPodと思っていただいてOK
（複数ホストで使うならDaemonSetで）
クリック

31. NFSプロビジョナーのデプロイ画面
30
長い！
ので、以降分割して次ページ

32. 名前とDockerイメージ

33. 環境変数

34. ボリューム

35. ラベル& アノテーション

36. ストレージクラスの作成
35
グローバル クラスター プロジェクト
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
CSI
RBAC
Pod
Persistent
Volume
Claim

37. ストレージクラス(nfs-storageclass.yaml)
36

38. ストレージクラス(nfs-storageclass.yaml)
37
ここだけ

39. ストレージクラスのアノテーション
38

40. RBAC
39
グローバル クラスター プロジェクト
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
CSI
RBAC
Pod
Persistent
Volume
Claim

41. nfs-provisioner-rbac.yaml
40
残念ながら、nfs-provisioner-rbac のRoleは見
つけられませんでした。
namespace:default で作ったのですが、Global
メニューでは出てこない模様

42. rbacの適用
41
 kubectl で nfs-rbac.yamlを適用します
$ cat <<EOF | kubectl create -f -
apiVersion: v1
kind: ServiceAccount
metadata:
name: nfs-client-provisioner
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: nfs-client-provisioner-runner
rules:
- apiGroups: [""]
resources: ["persistentvolumes"]
verbs: ["get", "list", "watch", "create", "delete"]
- apiGroups: [""]
resources: ["persistentvolumeclaims"]
verbs: ["get", "list", "watch", "update"]
- apiGroups: ["storage.k8s.io"]
resources: ["storageclasses"]
verbs: ["get", "list", "watch"]
- apiGroups: [""]
resources: ["events"]
verbs: ["list", "watch", "create", "update", "patch"]
- apiGroups: [""]
resources: ["endpoints"]
verbs: ["get", "list", "watch", "create", "update", "patch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: run-nfs-client-provisioner
subjects:
- kind: ServiceAccount
name: nfs-client-provisioner
namespace: default
roleRef:
kind: ClusterRole
name: nfs-client-provisioner-runner
apiGroup: rbac.authorization.k8s.io
EOF

43. Podをデプロイ
42
グローバル クラスター プロジェクト
Ubuntu
Docker VirtualBox NFS
Ubuntu
Minikube
Rancher Persistent
Volume
vboxnet0NAT Network
Storage
Class
Provisioner
CSI
RBAC
Pod
Persistent
Volume
Claim

44. PodをデプロイしてPVを付けてみる
43
ここがボリュームを指定
する場所

45. 適当にPod名とイメージを指定
44

46. 新しい永続ボリュームを付けてみる
45
クリック
クリック
クリック
前頁から続く

47. PVC設定(1)名前とストレージクラスを指定
46
別ウィンドウが開く
StorageClassで作成した
local-nfsを指定

48. PVC設定(2) 容量とアクセスモードを指定
47
さらに別ウィンドウが開く
必要容量を指定

49. マウント先を指定
48

50. 起動後
49

51. マウントされているのを確認
50