Skip to content

Commit 8ae4f56

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #22640 from shuuji3/tutorials/stateful-application/cassandra
Translate tutorials/stateful-application/cassandra/ into Japanese
2 parents feffcfb + 3151f8c commit 8ae4f56

File tree

1 file changed

+261
-0
lines changed

1 file changed

+261
-0
lines changed

‎content/ja/docs/tutorials/stateful-application/cassandra.md

Lines changed: 261 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,261 @@
1+
---
2+
title: "例: StatefulSetを使用したCassandraのデプロイ"
3+
content_type: tutorial
4+
weight: 30
5+
---
6+
7+
<!-- overview -->
8+
このチュートリアルでは、[Apache Cassandra](http://cassandra.apache.org/)をKubernetes上で実行する方法を紹介します。データベースの一種であるCassandraには、データの耐久性(アプリケーションの*状態*)を提供するために永続ストレージが必要です。この例では、カスタムのCassandraのseed providerにより、Cassandraクラスターに参加した新しいCassandraインスタンスを検出できるようにします。
9+
10+
*StatefulSet*を利用すると、ステートフルなアプリケーションをKubernetesクラスターにデプロイするのが簡単になります。このチュートリアルで使われている機能のより詳しい情報は、[StatefulSet](/ja/docs/concepts/workloads/controllers/statefulset/)を参照してください。
11+
12+
{{< note >}}
13+
CassandraとKubernetesは、ともにクラスターのメンバーを表すために*ノード*という用語を使用しています。このチュートリアルでは、StatefulSetに属するPodはCassandraのノードであり、Cassandraクラスター(*ring*と呼ばれます)のメンバーでもあります。これらのPodがKubernetesクラスター内で実行されるとき、Kubernetesのコントロールプレーンは、PodをKubernetesの{{< glossary_tooltip text="Node" term_id="node" >}}上にスケジュールします。
14+
15+
Cassandraノードが開始すると、*シードリスト*を使ってring上の他のノードの検出が始まります。このチュートリアルでは、Kubernetesクラスター内に現れた新しいCassandra Podを検出するカスタムのCassandraのseed providerをデプロイします。
16+
{{< /note >}}
17+
18+
19+
## {{% heading "objectives" %}}
20+
21+
* Cassandraのheadless {{< glossary_tooltip text="Service" term_id="service" >}}を作成して検証する。
22+
* {{< glossary_tooltip term_id="StatefulSet" >}}を使用してCassandra ringを作成する。
23+
* StatefulSetを検証する。
24+
* StatefulSetを編集する。
25+
* StatefulSetと{{< glossary_tooltip text="Pod" term_id="pod" >}}を削除する。
26+
27+
28+
## {{% heading "prerequisites" %}}
29+
30+
{{< include "task-tutorial-prereqs.md" >}}
31+
32+
このチュートリアルを完了するには、{{< glossary_tooltip text="Pod" term_id="pod" >}}、{{< glossary_tooltip text="Service" term_id="service" >}}、{{< glossary_tooltip text="StatefulSet" term_id="StatefulSet" >}}の基本についてすでに知っている必要があります。
33+
34+
### Minikubeのセットアップに関する追加の設定手順
35+
36+
{{< caution >}}
37+
[Minikube](/ja/docs/getting-started-guides/minikube/)は、デフォルトでは1024MiBのメモリと1CPUに設定されます。デフォルトのリソース設定で起動したMinikubeでは、このチュートリアルの実行中にリソース不足のエラーが発生してしまいます。このエラーを回避するためにはMinikubeを次の設定で起動してください。
38+
39+
```shell
40+
minikube start --memory 5120 --cpus=4
41+
```
42+
{{< /caution >}}
43+
44+
45+
46+
<!-- lessoncontent -->
47+
## Cassandraのheadless Serviceを作成する {#creating-a-cassandra-headless-service}
48+
49+
Kubernetesでは、{{< glossary_tooltip text="Service" term_id="service" >}}は同じタスクを実行する{{< glossary_tooltip text="Pod" term_id="pod" >}}の集合を表します。
50+
51+
以下のServiceは、Cassandra Podとクラスター内のクライアント間のDNSルックアップに使われます。
52+
53+
{{< codenew file="application/cassandra/cassandra-service.yaml" >}}
54+
55+
`cassandra-service.yaml`ファイルから、Cassandra StatefulSetのすべてのメンバーをトラッキングするServiceを作成します。
56+
57+
```shell
58+
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-service.yaml
59+
```
60+
61+
62+
### 検証 (オプション) {#validating}
63+
64+
Cassandra Serviceを取得します。
65+
66+
```shell
67+
kubectl get svc cassandra
68+
```
69+
70+
結果は次のようになります。
71+
72+
```
73+
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
74+
cassandra ClusterIP None <none> 9042/TCP 45s
75+
```
76+
77+
78+
`cassandra`という名前のServiceが表示されない場合、作成に失敗しています。よくある問題のトラブルシューティングについては、[Serviceのデバッグ](/ja/docs/tasks/debug-application-cluster/debug-service/)を読んでください。
79+
80+
## StatefulSetを使ってCassandra ringを作成する
81+
82+
以下に示すStatefulSetマニフェストは、3つのPodからなるCassandra ringを作成します。
83+
84+
{{< note >}}
85+
この例ではMinikubeのデフォルトのプロビジョナーを使用しています。クラウドを使用している場合、StatefulSetを更新してください。
86+
{{< /note >}}
87+
88+
{{< codenew file="application/cassandra/cassandra-statefulset.yaml" >}}
89+
90+
`cassandra-statefulset.yaml`ファイルから、CassandraのStatefulSetを作成します。
91+
92+
```shell
93+
# cassandra-statefulset.yaml を編集せずにapplyできる場合は、このコマンドを使用してください
94+
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml
95+
```
96+
97+
クラスターに合わせて`cassandra-statefulset.yaml`を編集する必要がある場合、 https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml をダウンロードして、修正したバージョンを保存したフォルダからマニフェストを適用してください。
98+
99+
```shell
100+
# cassandra-statefulset.yaml をローカルで編集する必要がある場合、このコマンドを使用してください
101+
kubectl apply -f cassandra-statefulset.yaml
102+
```
103+
104+
105+
## CassandraのStatefulSetを検証する
106+
107+
1. CassandraのStatefulSetを取得します
108+
109+
```shell
110+
kubectl get statefulset cassandra
111+
```
112+
113+
結果は次のようになるはずです。
114+
115+
```
116+
NAME DESIRED CURRENT AGE
117+
cassandra 3 0 13s
118+
```
119+
120+
`StatefulSet`リソースがPodを順番にデプロイします。
121+
122+
1. Podを取得して順序付きの作成ステータスを確認します
123+
124+
```shell
125+
kubectl get pods -l="app=cassandra"
126+
```
127+
128+
結果は次のようになるはずです。
129+
130+
```shell
131+
NAME READY STATUS RESTARTS AGE
132+
cassandra-0 1/1 Running 0 1m
133+
cassandra-1 0/1 ContainerCreating 0 8s
134+
```
135+
136+
3つすべてのPodのデプロイには数分かかる場合があります。デプロイが完了すると、同じコマンドは次のような結果を返します。
137+
138+
```
139+
NAME READY STATUS RESTARTS AGE
140+
cassandra-0 1/1 Running 0 10m
141+
cassandra-1 1/1 Running 0 9m
142+
cassandra-2 1/1 Running 0 8m
143+
```
144+
145+
3. 1番目のPodの中でCassandraの[nodetool](https://cwiki.apache.org/confluence/display/CASSANDRA2/NodeTool)を実行して、ringのステータスを表示します。
146+
147+
```shell
148+
kubectl exec -it cassandra-0 -- nodetool status
149+
```
150+
151+
結果は次のようになるはずです。
152+
153+
```
154+
Datacenter: DC1-K8Demo
155+
======================
156+
Status=Up/Down
157+
|/ State=Normal/Leaving/Joining/Moving
158+
-- Address Load Tokens Owns (effective) Host ID Rack
159+
UN 172.17.0.5 83.57 KiB 32 74.0% e2dd09e6-d9d3-477e-96c5-45094c08db0f Rack1-K8Demo
160+
UN 172.17.0.4 101.04 KiB 32 58.8% f89d6835-3a42-4419-92b3-0e62cae1479c Rack1-K8Demo
161+
UN 172.17.0.6 84.74 KiB 32 67.1% a6a1e8c2-3dc5-4417-b1a0-26507af2aaad Rack1-K8Demo
162+
```
163+
164+
## CassandraのStatefulSetを変更する
165+
166+
`kubectl edit`を使うと、CassandraのStatefulSetのサイズを変更できます。
167+
168+
1. 次のコマンドを実行します。
169+
170+
```shell
171+
kubectl edit statefulset cassandra
172+
```
173+
174+
このコマンドを実行すると、ターミナルでエディタが起動します。変更が必要な行は`replicas`フィールドです。以下の例は、StatefulSetファイルの抜粋です。
175+
176+
```yaml
177+
# Please edit the object below. Lines beginning with a '#' will be ignored,
178+
# and an empty file will abort the edit. If an error occurs while saving this file will be
179+
# reopenedTranslate tutorials/stateful-application/cassandra/ into Japanese with the relevant failures.
180+
#
181+
apiVersion: apps/v1
182+
kind: StatefulSet
183+
metadata:
184+
creationTimestamp: 2016-08-13T18:40:58Z
185+
generation: 1
186+
labels:
187+
app: cassandra
188+
name: cassandra
189+
namespace: default
190+
resourceVersion: "323"
191+
uid: 7a219483-6185-11e6-a910-42010a8a0fc0
192+
spec:
193+
replicas: 3
194+
```
195+
196+
1. レプリカ数を4に変更し、マニフェストを保存します。
197+
198+
これで、StatefulSetが4つのPodを実行するようにスケールされました。
199+
200+
1. CassandraのStatefulSetを取得して、変更を確かめます。
201+
202+
```shell
203+
kubectl get statefulset cassandra
204+
```
205+
206+
結果は次のようになるはずです。
207+
208+
```
209+
NAME DESIRED CURRENT AGE
210+
cassandra 4 4 36m
211+
```
212+
213+
214+
215+
## {{% heading "cleanup" %}}
216+
217+
StatefulSetを削除したりスケールダウンしても、StatefulSetに関係するボリュームは削除されません。StatefulSetに関連するすべてのリソースを自動的に破棄するよりも、データの方がより貴重であるため、安全のためにこのような設定になっています。
218+
219+
{{< warning >}}
220+
ストレージクラスやreclaimポリシーによっては、*PersistentVolumeClaim*を削除すると、関連するボリュームも削除される可能性があります。PersistentVolumeClaimの削除後にもデータにアクセスできるとは決して想定しないでください。
221+
{{< /warning >}}
222+
223+
1. 次のコマンドを実行して(単一のコマンドにまとめています)、CassandraのStatefulSetに含まれるすべてのリソースを削除します。
224+
225+
```shell
226+
grace=$(kubectl get pod cassandra-0 -o=jsonpath='{.spec.terminationGracePeriodSeconds}') \
227+
&& kubectl delete statefulset -l app=cassandra \
228+
&& echo "Sleeping ${grace} seconds" 1>&2 \
229+
&& sleep $grace \
230+
&& kubectl delete persistentvolumeclaim -l app=cassandra
231+
```
232+
233+
1. 次のコマンドを実行して、CassandraをセットアップしたServiceを削除します。
234+
235+
```shell
236+
kubectl delete service -l app=cassandra
237+
```
238+
239+
## Cassandraコンテナの環境変数
240+
241+
このチュートリアルのPodでは、Googleの[コンテナレジストリ](https://cloud.google.com/container-registry/docs/)の[`gcr.io/google-samples/cassandra:v13`](https://github.com/kubernetes/examples/blob/master/cassandra/image/Dockerfile)イメージを使用しました。このDockerイメージは[debian-base](https://github.com/kubernetes/kubernetes/tree/master/build/debian-base)をベースにしており、OpenJDK 8が含まれています。
242+
243+
このイメージには、Apache Debianリポジトリの標準のCassandraインストールが含まれます。環境変数を利用すると、`cassandra.yaml`に挿入された値を変更できます。
244+
245+
| 環境変数 | デフォルト値 |
246+
| ------------------------ |:---------------: |
247+
| `CASSANDRA_CLUSTER_NAME` | `'Test Cluster'` |
248+
| `CASSANDRA_NUM_TOKENS` | `32` |
249+
| `CASSANDRA_RPC_ADDRESS` | `0.0.0.0` |
250+
251+
252+
253+
## {{% heading "whatsnext" %}}
254+
255+
256+
* [StatefulSetのスケール](/ja/docs/tasks/run-application/scale-stateful-set/)を行う方法を学ぶ。
257+
* [*KubernetesSeedProvider*](https://github.com/kubernetes/examples/blob/master/cassandra/java/src/main/java/io/k8s/cassandra/KubernetesSeedProvider.java)についてもっと学ぶ。
258+
* カスタムの[Seed Providerの設定](https://git.k8s.io/examples/cassandra/java/README.md)についてもっと学ぶ。
259+
260+
261+

0 commit comments

Comments
 (0)