|
|
|
@@ -6,34 +6,31 @@ weight: 30
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
{{% capture overview %}}
|
|
|
|
|
이 튜토리얼은 네이티브 클라우드 [카산드라](http://cassandra.apache.org/)를 쿠버네티스에서 배포하는 방법을 소개한다. 이 예제에서 커스텀 카산드라 *시드 제공자(SeedProvider)* 는 카산드라가 클러스터에 조인한 새 카산드라 노드를 발견할 수 있게 한다.
|
|
|
|
|
이 튜토리얼은 쿠버네티스에서 [아파치 카산드라](http://cassandra.apache.org/)를 실행하는 방법을 소개한다. 데이터베이스인 카산드라는 데이터 내구성을 제공하기 위해 퍼시스턴트 스토리지가 필요하다(애플리케이션 _상태_). 이 예제에서 사용자 지정 카산드라 시드 공급자는 카산드라가 클러스터에 가입할 때 카산드라가 인스턴스를 검색할 수 있도록 한다.
|
|
|
|
|
|
|
|
|
|
*스테이트풀셋* 은 상태있는 애플리케이션을 클러스터 환경에서 쉽게 배포할 수 있게 한다. 이 튜토리얼에서 이용할 기능의 자세한 정보는 [*스테이트풀셋*](/ko/docs/concepts/workloads/controllers/statefulset/) 문서를 참조하자.
|
|
|
|
|
*스테이트풀셋* 은 상태있는 애플리케이션을 쿠버네티스 클러스터에 쉽게 배포할 수 있게 한다. 이 튜토리얼에서 이용할 기능의 자세한 정보는 [스테이트풀셋](/ko/docs/concepts/workloads/controllers/statefulset/)을 참조한다.
|
|
|
|
|
|
|
|
|
|
**도커에서 카산드라**
|
|
|
|
|
{{< note >}}
|
|
|
|
|
카산드라와 쿠버네티스는 클러스터 맴버라는 의미로 _노드_ 라는 용어를 사용한다. 이
|
|
|
|
|
튜토리얼에서 스테이트풀셋에 속하는 파드는 카산드라 노드이며 카산드라
|
|
|
|
|
클로스터의 맴버(_링_ 이라 함)이다. 해당 파드가 쿠버네티스 클러스터에서 실행될 때,
|
|
|
|
|
쿠버네티스 컨트롤 플레인은 해당 파드를 쿠버네티스
|
|
|
|
|
{{< glossary_tooltip text="노드" term_id="node" >}}에 스케줄 한다.
|
|
|
|
|
|
|
|
|
|
이 튜토리얼의 *파드* 는 구글의 [컨테이너 레지스트리](https://cloud.google.com/container-registry/docs/)에
|
|
|
|
|
[`gcr.io/google-samples/cassandra:v13`](https://github.com/kubernetes/examples/blob/master/cassandra/image/Dockerfile) 이미지를 이용한다.
|
|
|
|
|
이 도커 이미지는 [debian-base](https://github.com/kubernetes/kubernetes/tree/master/build/debian-base)에
|
|
|
|
|
기반하였고 OpenJDK 8을 포함한다.
|
|
|
|
|
|
|
|
|
|
이 이미지는 아파치 데비안 리포의 표준 카산드라 설치본을 포함한다.
|
|
|
|
|
환경변수를 이용하여 `cassandra.yaml`에 삽입된 값을 바꿀 수 있다.
|
|
|
|
|
|
|
|
|
|
| 환경 변수 | 기본값 |
|
|
|
|
|
| ------------- |:-------------: |
|
|
|
|
|
| `CASSANDRA_CLUSTER_NAME` | `'Test Cluster'` |
|
|
|
|
|
| `CASSANDRA_NUM_TOKENS` | `32` |
|
|
|
|
|
| `CASSANDRA_RPC_ADDRESS` | `0.0.0.0` |
|
|
|
|
|
카산드라 노드가 시작되면 _시드 목록_ 을 사용해서 링에 있는 다른 노드 검색을 위한
|
|
|
|
|
위한 부트스트랩을 한다.
|
|
|
|
|
이 튜토리얼에는 데이터베이스가 쿠버네티스 클러스터 내부에 나타날 때 새로운 카산드라
|
|
|
|
|
파드를 검색할 수 있는 사용자 지정 카산드라 시드 공급자를 배포한다.
|
|
|
|
|
{{< /note >}}
|
|
|
|
|
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture objectives %}}
|
|
|
|
|
* 카산드라 헤드리스 [*서비스*](/ko/docs/concepts/services-networking/service/)를 생성하고 검증한다.
|
|
|
|
|
* [스테이트풀셋](/ko/docs/concepts/workloads/controllers/statefulset/)을 이용하여 카산드라 링을 생성한다.
|
|
|
|
|
* [스테이트풀셋](/ko/docs/concepts/workloads/controllers/statefulset/)을 검증한다.
|
|
|
|
|
* [스테이트풀셋](/ko/docs/concepts/workloads/controllers/statefulset/)을 수정한다.
|
|
|
|
|
* [스테이트풀셋](/ko/docs/concepts/workloads/controllers/statefulset/)과 포함된 [파드](/ko/docs/concepts/workloads/pods/pod/)를 삭제한다.
|
|
|
|
|
* 카산드라 헤드리스 {{< glossary_tooltip text="Service" term_id="service" >}}를 생성하고 검증한다.
|
|
|
|
|
* {{< glossary_tooltip term_id="StatefulSet" >}}을 이용하여 카산드라 링을 생성한다.
|
|
|
|
|
* 스테이트풀셋을 검증한다.
|
|
|
|
|
* 스테이트풀셋을 수정한다.
|
|
|
|
|
* 스테이트풀셋과 포함된 {{< glossary_tooltip text="파드" term_id="pod" >}}를 삭제한다.
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture prerequisites %}}
|
|
|
|
@@ -53,7 +50,7 @@ weight: 30
|
|
|
|
|
### 추가적인 Minikube 설정 요령
|
|
|
|
|
|
|
|
|
|
{{< caution >}}
|
|
|
|
|
[Minikube](/docs/getting-started-guides/minikube/)는 1024MB 메모리와 1개 CPU가 기본 설정이다. 이 튜토리얼에서 Minikube를 기본 리소스 설정으로 실행하면 리소스 부족 오류가 발생한다. 이런 오류를 피하려면 Minikube를 다음 설정으로 실행하자.
|
|
|
|
|
[Minikube](/docs/getting-started-guides/minikube/)는 1024MiB 메모리와 1개 CPU가 기본 설정이다. 이 튜토리얼에서 Minikube를 기본 리소스 설정으로 실행하면 리소스 부족 오류가 발생한다. 이런 오류를 피하려면 Minikube를 다음 설정으로 실행하자.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
minikube start --memory 5120 --cpus=4
|
|
|
|
@@ -63,22 +60,22 @@ minikube start --memory 5120 --cpus=4
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture lessoncontent %}}
|
|
|
|
|
## 카산드라 헤드리스 서비스 생성하기
|
|
|
|
|
## 카산드라를 위한 헤드리스 서비스 생성하기 {#creating-a-cassandra-headless-service}
|
|
|
|
|
|
|
|
|
|
쿠버네티스 [서비스](/ko/docs/concepts/services-networking/service/)는 동일 작업을 수행하는 [파드](/ko/docs/concepts/workloads/pods/pod/)의 집합을 기술한다.
|
|
|
|
|
쿠버네티스 에서 {{< glossary_tooltip text="서비스" term_id="service" >}}는 동일 작업을 수행하는 {{< glossary_tooltip text="파드" term_id="pod" >}}의 집합을 기술한다.
|
|
|
|
|
|
|
|
|
|
다음의 `서비스`는 쿠버네티스 클러스터에서 카산드라 파드와 클라이언트 간에 DNS 찾아보기 용도로 사용한다.
|
|
|
|
|
다음의 서비스는 클러스터에서 카산드라 파드와 클라이언트 간에 DNS 찾아보기 용도로 사용한다.
|
|
|
|
|
|
|
|
|
|
{{< codenew file="application/cassandra/cassandra-service.yaml" >}}
|
|
|
|
|
|
|
|
|
|
1. 다운로드 받은 매니페스트 파일 디렉터리에 터미널 윈도우를 열자.
|
|
|
|
|
1. `cassandra-service.yaml` 파일에서 카산드라 스테이트풀셋 노드를 모두 추적하는 서비스를 생성한다.
|
|
|
|
|
`cassandra-service.yaml` 파일에서 카산드라 스테이트풀셋 노드를 모두 추적하는 서비스를 생성한다.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-service.yaml
|
|
|
|
|
```
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-service.yaml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 검증하기 (선택)
|
|
|
|
|
|
|
|
|
|
### 검증하기(선택) {#validating}
|
|
|
|
|
|
|
|
|
|
카산드라 서비스 살펴보기
|
|
|
|
|
|
|
|
|
@@ -105,12 +102,21 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
|
|
|
|
|
{{< codenew file="application/cassandra/cassandra-statefulset.yaml" >}}
|
|
|
|
|
|
|
|
|
|
1. 필요하면 스테이트풀셋 갱신
|
|
|
|
|
1. `cassandra-statefulset.yaml` 파일로 카산드라 스테이트풀셋 생성
|
|
|
|
|
`cassandra-statefulset.yaml` 파일로 카산드라 스테이트풀셋 생성
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
# cassandra-statefulset.yaml을 수정하지 않은 경우에 이것을 사용한다.
|
|
|
|
|
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
클러스터에 맞게 `cassandra-statefulset.yaml` 를 수정해야 하는 경우 다음을 다운로드 한 다음
|
|
|
|
|
수정된 버전을 저장한 폴더에서 해당 매니페스트를 적용한다.
|
|
|
|
|
https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml
|
|
|
|
|
```shell
|
|
|
|
|
# cassandra-statefulset.yaml을 로컬에서 수정한 경우에 사용한다.
|
|
|
|
|
kubectl apply -f cassandra-statefulset.yaml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 카산드라 스테이트풀셋 검증하기
|
|
|
|
|
|
|
|
|
@@ -120,7 +126,7 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
kubectl get statefulset cassandra
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
응답은 다음과 같다.
|
|
|
|
|
응답은 다음과 유사하다.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
NAME DESIRED CURRENT AGE
|
|
|
|
@@ -135,7 +141,7 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
kubectl get pods -l="app=cassandra"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
응답은 다음과 같다.
|
|
|
|
|
응답은 다음과 유사하다.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
NAME READY STATUS RESTARTS AGE
|
|
|
|
@@ -143,7 +149,8 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
cassandra-1 0/1 ContainerCreating 0 8s
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
모든 3개 파드가 배포되기까지 몇 분이 소요될 수 있다. 배포 후에는 같은 명령은 다음같이 응답한다.
|
|
|
|
|
모든 3개 파드가 배포되기까지 몇 분이 소요될 수 있다. 배포 후, 동일 명령은 다음과 유사하게
|
|
|
|
|
응답한다.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
NAME READY STATUS RESTARTS AGE
|
|
|
|
@@ -152,7 +159,8 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
cassandra-2 1/1 Running 0 8m
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
3. 링의 상태를 보여주는 카산드라 [nodetool](https://wiki.apache.org/cassandra/NodeTool)을 실행하자.
|
|
|
|
|
3. 첫 번째 파드 내부에 링의 상태를 보여주는 카산드라
|
|
|
|
|
[nodetool](https://cwiki.apache.org/confluence/display/CASSANDRA2/NodeTool)을 실행하자.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl exec -it cassandra-0 -- nodetool status
|
|
|
|
@@ -181,14 +189,14 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
kubectl edit statefulset cassandra
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
이 명령은 터미널에서 편집기를 연다. 변경해야할 행은 `replicas` 필드이다. 다음 예제는 `StatefulSet` 파일에서 발췌했다.
|
|
|
|
|
이 명령은 터미널에서 편집기를 연다. 변경해야할 행은 `replicas` 필드이다. 다음 예제는 스테이트풀셋 파일에서 발췌했다.
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
# Please edit the object below. Lines beginning with a '#' will be ignored,
|
|
|
|
|
# and an empty file will abort the edit. If an error occurs while saving this file will be
|
|
|
|
|
# reopened with the relevant failures.
|
|
|
|
|
#
|
|
|
|
|
apiVersion: apps/v1 # for versions before 1.9.0 use apps/v1beta2
|
|
|
|
|
apiVersion: apps/v1
|
|
|
|
|
kind: StatefulSet
|
|
|
|
|
metadata:
|
|
|
|
|
creationTimestamp: 2016-08-13T18:40:58Z
|
|
|
|
@@ -205,7 +213,7 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
|
|
|
|
|
1. 레플리카 개수를 4로 바꾸고, 매니페스트를 저장한다.
|
|
|
|
|
|
|
|
|
|
The `StatefulSet` now contains 4 Pods.
|
|
|
|
|
스테이트풀셋은 4개의 파드를 실행하기 위해 스케일 한다.
|
|
|
|
|
|
|
|
|
|
1. 검증하기 위해 카산드라 스테이트풀셋을 살펴보자
|
|
|
|
|
|
|
|
|
@@ -213,7 +221,7 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
kubectl get statefulset cassandra
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
결과는 다음과 같다.
|
|
|
|
|
결과는 다음과 유사하다.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
NAME DESIRED CURRENT AGE
|
|
|
|
@@ -229,22 +237,39 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
스토리지 클래스와 리클레임 정책에 따라 *퍼시스턴스볼륨클레임* 을 삭제하면 그와 연관된 볼륨도 삭제될 수 있다. 볼륨 요청이 삭제되어도 데이터를 접근할 수 있다고 절대로 가정하지 말자.
|
|
|
|
|
{{< /warning >}}
|
|
|
|
|
|
|
|
|
|
1. 다음 명령어(한 줄로 연결된)를 실행하여 카산드라 `스테이트풀셋`을 모두 제거하자.
|
|
|
|
|
1. 다음 명령어(한 줄로 연결된)를 실행하여 카산드라 스테이트풀셋을 모두 제거하자.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
grace=$(kubectl get po cassandra-0 -o=jsonpath='{.spec.terminationGracePeriodSeconds}') \
|
|
|
|
|
grace=$(kubectl get pod cassandra-0 -o=jsonpath='{.spec.terminationGracePeriodSeconds}') \
|
|
|
|
|
&& kubectl delete statefulset -l app=cassandra \
|
|
|
|
|
&& echo "Sleeping $grace" \
|
|
|
|
|
&& echo "Sleeping ${grace} seconds" 1>&2 \
|
|
|
|
|
&& sleep $grace \
|
|
|
|
|
&& kubectl delete pvc -l app=cassandra
|
|
|
|
|
&& kubectl delete persistentvolumeclaim -l app=cassandra
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
1. 다음 명령어를 실행하여 카산드라 서비스를 제거하자.
|
|
|
|
|
1. 다음 명령어를 실행하여 카산드라에 대해 설정한 서비스를 제거하자.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl delete service -l app=cassandra
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 카산드라 컨테이너 환경 변수
|
|
|
|
|
|
|
|
|
|
이 튜토리얼의 *파드* 는 구글의 [컨테이너 레지스트리](https://cloud.google.com/container-registry/docs/)에
|
|
|
|
|
[`gcr.io/google-samples/cassandra:v13`](https://github.com/kubernetes/examples/blob/master/cassandra/image/Dockerfile) 이미지를 이용한다.
|
|
|
|
|
이 도커 이미지는 [debian-base](https://github.com/kubernetes/kubernetes/tree/master/build/debian-base)에
|
|
|
|
|
기반하였고 OpenJDK 8을 포함한다.
|
|
|
|
|
|
|
|
|
|
이 이미지는 아파치 데비안 리포의 표준 카산드라 설치본을 포함한다.
|
|
|
|
|
환경변수를 이용하여 `cassandra.yaml`에 삽입된 값을 바꿀 수 있다.
|
|
|
|
|
|
|
|
|
|
| 환경 변수 | 기본값 |
|
|
|
|
|
| ------------- |:-------------: |
|
|
|
|
|
| `CASSANDRA_CLUSTER_NAME` | `'Test Cluster'` |
|
|
|
|
|
| `CASSANDRA_NUM_TOKENS` | `32` |
|
|
|
|
|
| `CASSANDRA_RPC_ADDRESS` | `0.0.0.0` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture whatsnext %}}
|
|
|
|
@@ -254,4 +279,3 @@ cassandra ClusterIP None <none> 9042/TCP 45s
|
|
|
|
|
* 커스텀 [시드 제공자 설정](https://git.k8s.io/examples/cassandra/java/README.md)를 살펴본다.
|
|
|
|
|
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
June Yi