이재홍의 언제나 최신 Kubernetes - Unit 9. Special Thanks

<Copyright />

<AdsenseTop />

**Helm으로 패키지 설치하기**

이재홍 [http://www.pyrasis.com](http://www.pyrasis.com)

## Helm으로 MySQL 설치하기

Helm을 설치했으니 이제 Helm으로 쿠버네티스 클러스터에 MySQL을 설치해보겠습니다. 참고로 Helm은 Minikube 클러스터나 kubeadm, kOps로 만든 클러스터 모두 사용 가능합니다.

참고로 Helm에서는 패키지를 차트(Chart)라고 부르는데, Helm 공식 저장소(리포지토리)는 차트들이 유지보수가 되지 않은지 오래 되었습니다. 따라서 여기서는 [https://artifacthub.io/](https://artifacthub.io/)에 올라와있는 저장소를 사용하도록 하겠습니다.

다음 명령을 입력하여 bitnami 저장소를 추가합니다.

```text
$ helm repo add bitnami https://charts.bitnami.com/bitnami
```

이제 `helm` 명령으로 MySQL을 설치해야 하는데 `helm` 명령의 기본 형식은 다음과 같습니다.

- `helm install <릴리스 이름> <옵션> <저장소 이름>/<차트 이름>`

우리가 설치할 MySQL 차트는 [https://artifacthub.io/packages/helm/bitnami/mysql](https://artifacthub.io/packages/helm/bitnami/mysql)입니다. 이 차트를 `helm install hello-mysql bitnami/mysql`과 같이 기본 설정으로 설치해도 되지만, 여기서는 각종 설정도 추가해서 설치해보겠습니다. 각 설정값(Parameter)은 [https://artifacthub.io/packages/helm/bitnami/mysql#parameters](https://artifacthub.io/packages/helm/bitnami/mysql#parameters)에 잘 나와있습니다.

```text {1}
$ helm install hello-mysql --set auth.rootPassword=hellopassword bitnami/mysql
NAME: hello-mysql
LAST DEPLOYED: Fri Dec 2 12:16:56 2022
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
CHART NAME: mysql
CHART VERSION: 9.4.4
APP VERSION: 8.0.31

** Please be patient while the chart is being deployed **

Tip:

 Watch the deployment status using the command: kubectl get pods -w --namespace default

Services:

 echo Primary: hello-mysql.default.svc.cluster.local:3306

Execute the following to get the administrator credentials:

 echo Username: root
 MYSQL_ROOT_PASSWORD=$(kubectl get secret --namespace default hello-mysql -o jsonpath="{.data.mysql-root-password}" | base64 -d)

To connect to your database:

 1. Run a pod that you can use as a client:

 kubectl run hello-mysql-client --rm --tty -i --restart='Never' --image docker.io/bitnami/mysql:8.0.31-debian-11-r10 --namespace default --env MYSQL_ROOT_PASSWORD=$MYSQL_ROOT_PASSWORD --command -- bash

 2. To connect to primary service (read/write):

 mysql -h hello-mysql.default.svc.cluster.local -uroot -p"$MYSQL_ROOT_PASSWORD"
```

- `helm install hello-mysql --set auth.rootPassword=hellopassword bitnami/mysql`
 - `helm install`: Helm 설치 명령입니다.
 - `hello-mysql`: Helm 차트를 클러스터에 설치했을 때 릴리스 이름입니다. 이후 이 이름으로 쿠버네티스의 오브젝트들이 생성됩니다.
 - `--set auth.rootPassword=hellopassword`: 각종 설정값을 설정하는 부분입니다. `--set` 뒤에 `<키>=<값>` 형식으로 설정해주면 됩니다. 여러 개를 설정할 때는 `<키>=<값>,<키>=<값>`와 같이 키와 값을 콤마(,)로 구분해줍니다. 여기서는 `auth.rootPassword=hellopassword`와 같이 root 패스워드를 설정하였습니다.
 - `bitnami/mysql`: 우리는 `bitnami` 저장소를 추가했고, `mysql` 차트를 설치할 것이므로 `bitnami/mysql`로 입력해줍니다.

MySQL 차트 설치가 끝났으니, 설치된 릴리스 목록을 출력해보겠습니다.

```text {1}
$ helm ls
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
hello-mysql default 1 2022-12-02 12:16:56.8201411 +0900 KST deployed mysql-9.4.4 8.0.31
```

릴리스 이름으로 `hello-mysql`이 설치된 것을 볼 수 있습니다.

<AdsenseContentBar />

이제 설치된 MySQL 데이터베이스에 접속해보겠습니다. 위에 나와있는 1. Run a pod that you can use as a client:에서 `$MYSQL_ROOT_PASSWORD` 부분을 `hellopassword`로 바꾸고, `-p"$MYSQL_ROOT_PASSWORD"` 부분을 `-phellopassword`으로 바꿔서 실행해봅니다. 그리고 `show databases;` 명령을 실행하여 데이터베이스 목록을 출력해봅니다.

```text {1,3,17}
$ kubectl run hello-mysql-client --rm --tty -i --restart='Never' --image docker.io/bitnami/mysql:8.0.31-debian-11-r10 --namespace default --env MYSQL_ROOT_PASSWORD=hellopassword --command -- bash
If you don't see a command prompt, try pressing enter.
I have no name!@hello-mysql-client:/$ mysql -h hello-mysql.default.svc.cluster.local -uroot -phellopassword
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 6504
Server version: 8.0.31 Source distribution

Copyright (c) 2000, 2022, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;
+--------------------+
| Database |
+--------------------+
| information_schema |
| my_database |
| mysql |
| performance_schema |
| sys |
+--------------------+
5 rows in set (0.00 sec)

mysql>
```

데이터베이스 목록이 잘 출력되는 것을 볼 수 있습니다. <kbd>Ctrl + D</kbd>를 두 번 입력하여 MySQL 클라이언트와 파드에서 빠져나옵니다.

<Alert variant="info">
<InfoSignIcon /> **컨텍스트 전환**

Helm은 현재 컨텍스트에 연결된 클러스터에 차트를 설치합니다. 먼저 `.kube/config`에 저장된 컨텍스트 목록을 확인하는 명령은 `kubectl config get-contexts`입니다.

```text
$ kubectl config get-contexts
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
* k8s.ap-northeast-2.aws.hello.com k8s.ap-northeast-2.aws.hello.com k8s.ap-northeast-2.aws.hello.com
 kubernetes-admin@kubernetes kubernetes kubernetes-admin
 minikube minikube minikube default
```

만약 `minikube` 컨텍스트로 전환하고 싶다면 `kubectl config use-context` 명령을 사용합니다.

```text
$ kubectl config use-context minikube
Switched to context "minikube".
```

이렇게 하면 Minikube 클러스터에 Helm으로 차트를 설치하게 됩니다.

</Alert>

<Alert variant="info">
<InfoSignIcon /> **릴리스 삭제**

설치된 릴리스를 삭제할 때는 `helm uninstall` 명령을 사용합니다.

```text
$ helm uninstall hello-mysql
release "hello-mysql" uninstalled
```

</Alert>

<DisqusComments />

<AdsenseBottomBox2 />

이재홍의 언제나 최신 Kubernetes - Unit 8.2 Helm으로 MySQL 설치하기

<Copyright />

<AdsenseTop />

**Helm으로 패키지 설치하기**

이재홍 [http://www.pyrasis.com](http://www.pyrasis.com)

지금까지 YAML 파일을 직접 작성하거나, YAML의 URL로 쿠버네티스 리소스를 설치했습니다. 이번에는 Helm이라는 패키지 매니저를 사용하여 쿠버네티스 리소스를 설치하는 방법을 알아보겠습니다.

## Helm 설치하기

다음 명령을 입력하여 Helm을 설치합니다.

```text:윈도우 PowerShell
choco install kubernetes-helm
```

<Alert variant="info">
<InfoSignIcon /> **choco**

choco는 윈도우용 패키지 관리 프로그램입니다. `choco install` 명령으로 다양한 프로그램들을 손쉽게 설치할 수 있습니다.

설치는 다음 명령을 실행하면 됩니다. 이때 반드시 PowerShell을 관리자 권한으로 실행해야 합니다.

- [https://chocolatey.org/install](https://chocolatey.org/install)

```powershell:PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
```

</Alert>

```text:리눅스
$ curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
$ chmod 700 get_helm.sh
$ ./get_helm.sh
```

```text:macOS
$ brew install helm
```

참고로 각 운영체제별 설치 파일은 [https://github.com/helm/helm/releases](https://github.com/helm/helm/releases)에서 받을 수 있습니다.

<DisqusComments />

<AdsenseBottomBox2 />

이재홍의 언제나 최신 Kubernetes - Unit 8. Helm으로 패키지 설치하기

<Copyright />

<AdsenseTop />

**AWS에서 EC2로 Kubernetes 클러스터 구축하기**

이재홍 [http://www.pyrasis.com](http://www.pyrasis.com)

## 인그레스와 ELB LoadBalancer 서비스 생성하기

드디어 AWS의 ELB(NLB, Network load balancer)와 연동된 서비스를 생성할 수 있게 되었습니다.

### 인그레스 컨트롤러 설치하기

인그레스를 사용하려면 먼저 인그레스 컨트롤러를 설치해야 합니다. 여기서는 Nginx 인그레스 컨트롤러를 사용하겠습니다.

다음 명령을 실행하여 AWS용 Nginx 인그레스 컨트롤러를 설치합니다.

- [https://kubernetes.github.io/ingress-nginx/deploy/#aws](https://kubernetes.github.io/ingress-nginx/deploy/#aws)

```text
$ kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.5.1/deploy/static/provider/aws/deploy.yaml
```

다음 명령을 입력하여 Nginx 인그레스 컨트롤러가 제대로 설치되었는지 확인해봅니다.

```text {3}
$ kubectl -n ingress-nginx get service
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
ingress-nginx-controller LoadBalancer 100.68.245.83 a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com 80:32325/TCP,443:31028/TCP 15m
ingress-nginx-controller-admission ClusterIP 100.68.74.143 <none> 443/TCP 15m
```

`ingress-nginx-controller`의 TYPE을 보면 `LoadBalancer`로 설정된 것을 볼 수 있고, `EXTERNAL-IP`에는 ELB(NLB)의 도메인이 표시됩니다. 즉, AWS의 로드밸런서를 통해 트래픽을 받을 수 있게 된 것입니다.

### 디플로이먼트, 서비스 생성하기

다음 내용을 `deployment.yaml` 파일로 저장합니다.

- [jHLsKubernetes/Unit07/deployment.yaml](https://github.com/pyrasis/jHLsKubernetes/blob/main/Unit07/deployment.yaml)

```yaml:deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
 name: hello-nginx
spec:
 replicas: 1
 selector:
 matchLabels:
 app: hello-nginx
 template:
 metadata:
 labels:
 app: hello-nginx
 spec:
 containers:
 - name: hello-nginx
 image: nginx:latest
 ports:
 - containerPort: 80
```

다음 명령을 실행하여 `deployment.yaml` 파일로 디플로이먼트를 생성합니다.

```text
$ kubectl create -f deployment.yaml
deployment.apps/hello-nginx created
```

이번에는 서비스를 생성합니다. 다음 내용을 `service.yaml` 파일로 저장합니다.

- [jHLsKubernetes/Unit07/service.yaml](https://github.com/pyrasis/jHLsKubernetes/blob/main/Unit07/service.yaml)

```yaml:service.yaml
apiVersion: v1
kind: Service
metadata:
 name: hello-nginx
spec:
 selector:
 app: hello-nginx
 ports:
 - protocol: TCP
 port: 80
 targetPort: 80
 type: ClusterIP
```

다음 명령을 실행하여 `service.yaml` 파일로 서비스를 생성합니다.

```text
$ kubectl create -f service.yaml
service/hello-nginx created
```

디플로이먼트와 서비스는 지금까지 만들었던 것과 같은 형식이므로 따로 설명하지 않겠습니다.

<AdsenseContentBar />

### 인그레스 만들기

#### 도메인을 구입한 경우

이제 인그레스를 만들 차례입니다. 다음 내용을 `ingress.yaml` 파일로 저장합니다. 이때 `host` 부분을 `hello.<구입한 도메인>`으로 설정해줍니다. 특히 apex 도메인(root 도메인)은 Route 53에 자동으로 레코드가 생성되지 않으므로 주의해야 합니다. 반드시 서브 도메인으로 설정해줍니다.

- [jHLsKubernetes/Unit07/ingress.yaml](https://github.com/pyrasis/jHLsKubernetes/blob/main/Unit07/ingress.yaml)

```yaml:ingress.yaml {8}
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 name: hello-nginx
spec:
 ingressClassName: nginx
 rules:
 - host: hello.<구입한 도메인>
 http:
 paths:
 - backend:
 service:
 name: hello-nginx
 port:
 number: 80
 path: /
 pathType: Prefix
```

저장이 끝났으면 인그레스를 생성합니다.

```text
$ kubectl create -f ingress.yaml
```

만약 도메인을 바꾸고 싶다면 `ingress.yaml`에서 도메인을 수정한 뒤 `kubectl apply`를 해서는 Route 53에 적용이 되지 않습니다. 이때는 인그레스를 삭제 후 다시 생성해야 합니다.

```text
$ kubectl delete -f ingress.yaml
$ kubectl create -f ingress.yaml
```

<Alert variant="info">
<InfoSignIcon /> **webhook 에러가 발생한다면?**

다음과 같이 `Internal error occurred: failed calling webhook` 에러가 발생할 수도 있습니다.

```text
error: failed to create ingress: Internal error occurred: failed calling webhook "validate.nginx.ingress.kubernetes.io": failed to call webhook: Post "https://ingress-nginx-controller-admission.ingress-nginx.svc:443/networking/v1/ingresses?timeout=10s": context deadline exceeded
```

이때는 다음 명령을 입력하여 `ingress-nginx-admission` webhook 설정을 삭제해줍니다. 지금은 이 webhook을 사용하지 않으므로 삭제해도 괜찮습니다.

```text
$ kubectl delete validatingwebhookconfiguration ingress-nginx-admission
```

삭제되었다면 다시 인그레스를 생성해봅니다.

```text
$ kubectl create -f ingress.yaml
```

</Alert>

이제 `kubectl get ingress` 명령으로 인그레스를 출력해보겠습니다.

```text {3}
$ kubectl get ingress
NAME CLASS HOSTS ADDRESS PORTS AGE
hello-nginx nginx <구입한 도메인> a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com 80 26m
```

HOSTS에 도메인으로 \<구입한 도메인\>이 설정된 것을 볼 수 있습니다. ADDRESS에는 ELB(NLB)의 도메인이 표시됩니다. 저는 `a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com`가 나왔지만, 이 도메인은 각자 다르게 나올 것입니다.

웹 브라우저를 열고 http://\<구입한 도메인\> 접속하면 Welcome to nginx!가 표시될 것입니다.

실습이 끝났으면 다음 명령을 실행하여 클러스터를 삭제합니다.

```text
$ kops delete cluster --name k8s.ap-northeast-2.aws.hello.com --yes
```

#### 도메인을 구입하지 않은 경우

이제 인그레스를 만들 차례입니다. 다음 내용을 `ingress.yaml` 파일로 저장합니다.

- [jHLsKubernetes/Unit07/ingress.yaml](https://github.com/pyrasis/jHLsKubernetes/blob/main/Unit07/ingress.yaml)

```yaml:ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 name: hello-nginx
spec:
 ingressClassName: nginx
 rules:
 - host: nginx.hello.com
 http:
 paths:
 - backend:
 service:
 name: hello-nginx
 port:
 number: 80
 path: /
 pathType: Prefix
```

저장이 끝났으면 인그레스를 생성합니다.

```text
$ kubectl create -f ingress.yaml
```

<Alert variant="info">
<InfoSignIcon /> **webhook 에러가 발생한다면?**

다음과 같이 `Internal error occurred: failed calling webhook` 에러가 발생할 수도 있습니다.

```text
error: failed to create ingress: Internal error occurred: failed calling webhook "validate.nginx.ingress.kubernetes.io": failed to call webhook: Post "https://ingress-nginx-controller-admission.ingress-nginx.svc:443/networking/v1/ingresses?timeout=10s": context deadline exceeded
```

이때는 다음 명령을 입력하여 `ingress-nginx-admission` webhook 설정을 삭제해줍니다. 지금은 이 webhook을 사용하지 않으므로 삭제해도 괜찮습니다.

```text
$ kubectl delete validatingwebhookconfiguration ingress-nginx-admission
```

삭제되었다면 다시 인그레스를 생성해봅니다.

```text
$ kubectl create -f ingress.yaml
```

</Alert>

이제 `kubectl get ingress` 명령으로 인그레스를 출력해보겠습니다.

```text {3}
$ kubectl get ingress
NAME CLASS HOSTS ADDRESS PORTS AGE
hello-nginx nginx nginx.hello.com a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com 80 26m
```

HOSTS에 도메인으로 **nginx.hello.com**이 설정된 것을 볼 수 있습니다. ADDRESS에는 ELB(NLB)의 도메인이 표시됩니다. 저는 `a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com`가 나왔지만, 이 도메인은 각자 다르게 나올 것입니다.

우리는 실제로 **hello.com** 도메인을 구입하지 않았으므로, 로컬에서 임시로 사용할 수 있도록 설정해야 합니다. 즉, **nginx.hello.com** 도메인이 ELB의 IP 주소로 연결되도록 설정하는 것입니다. 운영체제별로 설정 파일이 조금 다른데, 각자 운영체제에 맞는 파일을 수정합니다.

먼저 `ping` 명령으로 ELB(NLB)의 IP 주소를 알아냅니다.

```text:윈도우 {3}
ping a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com

Pinging a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com [3.37.156.171] with 32 bytes of data:
```

```text:리눅스 macOS {2}
$ ping a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com
PING a9d2164f4b43b43749deeb45a44e6458-1692cf8342f016af.elb.ap-northeast-2.amazonaws.com (3.37.156.171) 56(84) bytes of data.
```

IP 주소가 출력되면 <kbd>Ctrl + C</kbd>를 눌러 `ping` 명령을 종료시킵니다. 저는 IP 주소가 `3.37.156.171`로 나왔지만, ELB 도메인과 마찬가지로 각자 다르게 나올 것입니다(\<ELB의 퍼블릭 IPv4 주소\>).

리눅스, macOS는 `/etc/hosts` 파일을 수정해야 합니다. root 권한이 있어야 하므로 `sudo vim`으로 수정합니다.

```text:리눅스, macOS
$ sudo vim /etc/hosts
```

`/etc/hosts` 파일의 마지막 부분에 다음 내용을 추가한 뒤 저장합니다.

```text:/etc/hosts
<ELB의 퍼블릭 IPv4 주소> nginx.hello.com
```

윈도우는 `C:\Windows\System32\drivers\etc\hosts` 파일을 수정해야 합니다. 관리자 권한이 필요하므로, 메모장을 관리자 권한으로 실행한 뒤 파일을 엽니다.

`C:\Windows\System32\drivers\etc\hosts` 파일의 마지막 부분에 다음 내용을 추가한 뒤 저장합니다.

```text:C:\Windows\System32\drivers\etc\hosts
<ELB의 퍼블릭 IPv4 주소> nginx.hello.com
```

<Alert variant="info">
<InfoSignIcon /> **메모장에서 hosts 파일이 보이지 않는다면?**

메모장에서 hosts 파일이 보이지 않는다면, 열기 창에서 열기(O) 버튼 위의 텍스트 문서(\*.txt)를 모든 파일 (\*.\*)로 바꿔주면 됩니다.

</Alert>

웹 브라우저를 열고 [http://nginx.hello.com](http://nginx.hello.com) 접속하면 Welcome to nginx!가 표시될 것입니다.

즉, 지금까지 구축했던 Kubernetes 클러스터를 그림으로 표현하면 다음과 같은 모양이 됩니다.

{/* prettier-ignore */}
<BookImage src="/assets/images/jHLsAlwaysUpToDateKubernetes/Unit07/6.png">**그림 7-6** Kubernetes 클러스터</BookImage>

실습이 끝났으면 다음 명령을 실행하여 클러스터를 삭제합니다.

```text
$ kops delete cluster --name k8s.ap-northeast-2.aws.hello.com --yes
```

<Alert variant="danger">
<InfoSignIcon /> **EC2 비용 문제**

AWS에서 EC2, ELB를 사용할 때는 시간당 비용이 청구됩니다. 따라서 실습은 신속히 끝내는 것이 유리하며 실습이 끝나면 반드시 모든 인스턴스와 ELB(NLB)를 삭제(terminate)해야 합니다.

삭제하지 않고 그냥 잊고 있었다가는 요금 폭탄을 맞을 수 있으니 이 부분은 정말 주의해야 합니다.

</Alert>

<DisqusComments />

<AdsenseBottomBox2 />

이재홍의 언제나 최신 Kubernetes - Unit 7.4 인그레스와 ELB LoadBalancer 서비스 생성하기

<Copyright />

<AdsenseTop />

**AWS에서 EC2로 Kubernetes 클러스터 구축하기**

이재홍 [http://www.pyrasis.com](http://www.pyrasis.com)

## kOps로 클러스터 생성하기

AWS에 kOps로 Kubernetes 클러스터를 생성하는 구성도는 다음과 같습니다.

{/* prettier-ignore */}
<BookImage src="/assets/images/jHLsAlwaysUpToDateKubernetes/Unit07/5.png">**그림 7-5** kOps로 Kubernetes 클러스터 생성</BookImage>

### S3 버킷 생성하기

kOps로 클러스터를 만들기 전에 인증서와 설정 정보를 저장할 S3 버킷을 만들어야 합니다. 다음 과정으로 S3 버킷을 생성합니다.

1. AWS 콘솔 접속
2. S3으로 이동
3. **버킷 만들기** 버튼 클릭
4. 버킷 이름에 `clusters.k8s.hello.com` 입력(`clusters.k8s.hello.com`은 제가 생성했으므로 각자 다른 것을 입력합니다. 예: `clusters.k8s.hello.com-1`). 만약 도메인을 구입했다면 `clusters.k8s.<구입한 도메인>`으로 입력합니다(\<S3 버킷 이름\>).
5. AWS 리전은 **ap-northeast-2**로 설정
6. **버킷 만들기** 버튼 클릭

### EC2 키 페어 생성하기

이제 EC2 인스턴스에 접속할 키 페어를 생성할 차례입니다. 다음 과정으로 키 페어를 생성하고 다운로드합니다.

1. AWS 콘솔 접속
2. EC2로 이동
3. **키 페어** 메뉴 클릭
4. **키 페어 생성** 버튼 클릭
5. 이름에 **hello** 입력
6. 프라이빗 키 파일 형식을 **.pem** 선택
7. **키 페어 생성** 버튼 클릭

이렇게 하면 **hello.pem** 파일이 다운로드됩니다.

다음 명령을 실행하여 Private Key인 **hello.pem** 에서 Public Key **hello.pub**를 추출해냅니다.

```text:macOS, 리눅스
$ chmod 400 ./hello.pem
$ ssh-keygen -y -f ./hello.pem > hello.pub
```

```text:윈도우 PowerShell
icacls .\hello.pem /reset
icacls .\hello.pem /inheritance:r
icacls .\hello.pem /c /t /grant ${env:UserName}:F
ssh-keygen -y -f .\hello.pem | Out-File -Encoding ascii hello.pub
```

### Route 53 호스팅 영역 생성하기

kOps로 쿠버네티스 클러스터를 생성하려면 Route 53 호스팅 영역(hosted zone)이 필요합니다.

#### 도메인을 구입한 경우

도메인을 구입했다면 구입한 도메인에 대한 호스팅 영역을 생성합니다. AWS에서 도메인을 구입했다면 자동으로 생성됩니다.

1. AWS 콘솔 접속
2. Route 53으로 이동
3. **호스팅 영역** 메뉴 클릭
4. **호스팅 영역 생성** 버튼 클릭
5. 도메인 이름에 **\<구입한 도메인\>** 입력
6. **호스팅 영역 생성** 버튼 클릭

#### 도메인을 구입하지 않은 경우

도메인을 구입하지 않은 경우 프라이빗 호스팅 영역을 생성합니다.

1. AWS 콘솔 접속
2. Route 53으로 이동
3. **호스팅 영역** 메뉴 클릭
4. **호스팅 영역 생성** 버튼 클릭
5. 도메인 이름에 **hello.com** 입력
6. 유형을 **프라이빗 호스팅 영역** 선택
7. 리전을 아시아 태평양(서울) \[ap-northeast-2\] 선택
8. VPC ID는 기본 VPC 선택
9. **호스팅 영역 생성** 버튼 클릭

### YAML 파일 생성하기

kOps는 커맨드라인 옵션을 사용하여 설정을 하는 방식이지만, 설정 파일을 Git 등으로 관리할 수 있도록 YAML로 만듭니다.

#### 도메인을 구입한 경우

아래 `s3://clusters.k8s.<구입한 도메인>`은 본인이 생성한 S3 버킷의 이름으로 바꿔줍니다. 그리고 `--name`과 YAML 파일명에는 `k8s.ap-northeast-2.aws.<구입한 도메인>`을 입력합니다.

```text:macOS, 리눅스
$ export KOPS_STATE_STORE=s3://clusters.k8s.<구입한 도메인>
$ kops create cluster --name=k8s.ap-northeast-2.aws.<구입한 도메인> --cloud=aws --zones='ap-northeast-2a,ap-northeast-2b,ap-northeast-2c' --dry-run -o yaml > k8s.ap-northeast-2.aws.<구입한 도메인>.yaml
```

```text:윈도우 PowerShell
$env:KOPS_STATE_STORE="s3://clusters.k8s.<구입한 도메인>"
kops create cluster --name=k8s.ap-northeast-2.aws.<구입한 도메인> --cloud=aws --zones='ap-northeast-2a,ap-northeast-2b,ap-northeast-2c' --dry-run -o yaml > k8s.ap-northeast-2.aws.<구입한 도메인>.yaml
```

인그레스를 생성했을 때 Route 53에 레코드를 자동 생성할 수 있도록 `k8s.ap-northeast-2.aws.<구입한 도메인>.yaml` 파일을 다음과 같이 수정해줍니다. 즉, `spec` 아래에 `externalDns.watchIngress`를 `true`로 설정해줍니다.

```yaml:k8s.ap-northeast-2.aws.<구입한 도메인>.yaml {7,8}
apiVersion: kops.k8s.io/v1alpha2
kind: Cluster
metadata:
 creationTimestamp: null
 name: k8s.ap-northeast-2.aws.<구입한 도메인>
spec:
 externalDns:
 watchIngress: true
 api:
 dns: {}
 authorization:
 rbac: {}
```

#### 도메인을 구입하지 않은 경우

아래 `s3://<S3 버킷 이름>`은 본인이 생성한 S3 버킷의 이름으로 바꿔줍니다. 하지만, `--name`과 YAML 파일명에는 `k8s.ap-northeast-2.aws.hello.com`을 그대로 입력해야 합니다.

```text:macOS, 리눅스
$ export KOPS_STATE_STORE=s3://<S3 버킷 이름>
$ kops create cluster --name=k8s.ap-northeast-2.aws.hello.com --cloud=aws --zones='ap-northeast-2a,ap-northeast-2b,ap-northeast-2c' --dns private --dry-run -o yaml > k8s.ap-northeast-2.aws.hello.com.yaml
```

```text:윈도우 PowerShell
$env:KOPS_STATE_STORE="s3://<S3 버킷 이름>"
kops create cluster --name=k8s.ap-northeast-2.aws.hello.com --cloud=aws --zones='ap-northeast-2a,ap-northeast-2b,ap-northeast-2c' --dns private --dry-run -o yaml > k8s.ap-northeast-2.aws.hello.com.yaml
```

<AdsenseContentBar />

### YAML 파일로 클러스터 생성하기

이제 앞에서 만든 YAML 파일로 클러스터를 생성해보겠습니다. 먼저 다음 명령을 실행하여 S3에 클러스터 설정 및 `sshpublickey`를 적용합니다. 아직은 EC2 인스턴스가 생성되지 않습니다.

#### 도메인을 구입한 경우

```text:macOS, 리눅스
$ cat ./k8s.ap-northeast-2.aws.<구입한 도메인>.yaml | kops create -f -
$ kops create sshpublickey --name k8s.ap-northeast-2.aws.<구입한 도메인> -i hello.pub
```

```text:윈도우 PowerShell
cat .\k8s.ap-northeast-2.aws.<구입한 도메인>.yaml | kops create -f -
kops create sshpublickey --name k8s.ap-northeast-2.aws.<구입한 도메인> -i hello.pub
```

이상이 없으면 실제로 적용을 해봅니다. 이제 실제로 EC2 인스턴스가 생성됩니다.

```text
$ kops update cluster --name k8s.ap-northeast-2.aws.<구입한 도메인> --yes

*********************************************************************************

A new kops version is available: 1.25.2
Upgrading is recommended
More information: https://github.com/kubernetes/kops/blob/master/permalinks/upgrade_kops.md#1.25.2

*********************************************************************************

I1125 12:16:09.581824 9528 executor.go:111] Tasks: 0 done / 109 total; 48 can run
W1125 12:16:09.693436 9528 vfs_castore.go:379] CA private key was not found
I1125 12:16:09.699437 9528 keypair.go:225] Issuing new certificate: "etcd-manager-ca-events"
I1125 12:16:09.712633 9528 keypair.go:225] Issuing new certificate: "apiserver-aggregator-ca"
I1125 12:16:09.727296 9528 keypair.go:225] Issuing new certificate: "etcd-peers-ca-events"
I1125 12:16:09.730567 9528 keypair.go:225] Issuing new certificate: "etcd-manager-ca-main"
I1125 12:16:09.732792 9528 keypair.go:225] Issuing new certificate: "etcd-peers-ca-main"
I1125 12:16:09.733800 9528 keypair.go:225] Issuing new certificate: "etcd-clients-ca"
W1125 12:16:09.734626 9528 vfs_castore.go:379] CA private key was not found
I1125 12:16:09.757601 9528 keypair.go:225] Issuing new certificate: "kubernetes-ca"
I1125 12:16:09.765643 9528 keypair.go:225] Issuing new certificate: "service-account"
I1125 12:16:10.774088 9528 executor.go:111] Tasks: 48 done / 109 total; 23 can run
I1125 12:16:11.666874 9528 executor.go:111] Tasks: 71 done / 109 total; 30 can run
I1125 12:16:12.317385 9528 executor.go:111] Tasks: 101 done / 109 total; 4 can run
I1125 12:16:13.289549 9528 executor.go:155] No progress made, sleeping before retrying 4 task(s)
I1125 12:16:23.304076 9528 executor.go:111] Tasks: 101 done / 109 total; 4 can run
I1125 12:16:25.822231 9528 executor.go:111] Tasks: 105 done / 109 total; 4 can run
I1125 12:16:25.919122 9528 executor.go:111] Tasks: 109 done / 109 total; 0 can run
I1125 12:16:27.221437 9528 dns.go:238] Pre-creating DNS records
I1125 12:16:27.817503 9528 update_cluster.go:326] Exporting kubeconfig for cluster
kOps has set your kubectl context to k8s.ap-northeast-2.aws.<구입한 도메인>
W1125 12:16:27.845592 9528 update_cluster.go:350] Exported kubeconfig with no user authentication; use --admin, --user or --auth-plugin flags with `kops export kubeconfig`

Cluster is starting. It should be ready in a few minutes.

Suggestions:
 * validate cluster: kops validate cluster --wait 10m
 * list nodes: kubectl get nodes --show-labels
 * ssh to the master: ssh -i ~/.ssh/id_rsa ubuntu@api.k8s.ap-northeast-2.aws.<구입한 도메인>
 * the ubuntu user is specific to Ubuntu. If not using Ubuntu please use the appropriate user based on your OS.
 * read about installing addons at: https://kops.sigs.k8s.io/addons.

```

AWS 콘솔에서 EC2 인스턴스 목록을 확인해보면 마스터와 워커 노드들이 생성되고 있을 것입니다.

다음 명령을 입력하여 `~/.kube/config`에 방금 생성한 클러스터의 설정을 추가합니다.

```text
$ kops export kubeconfig --admin
```

잠시 기다리면 EC2 인스턴스가 생성되고 클러스터가 초기화됩니다. `kubectl get nodes` 명령을 입력하여 노듣 목록을 출력해봅니다.

```text {1}
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
i-01a4d885fd48acc61 Ready control-plane 4m4s v1.25.4
i-082f35a3d294a5e7d Ready node 54s v1.25.4
i-0c48a73869254c456 Ready node 37s v1.25.4
i-0e5dad97f6500d40a Ready node 51s v1.25.4
```

#### 도메인을 구입하지 않은 경우

```text:macOS, 리눅스
$ cat ./k8s.ap-northeast-2.aws.hello.com.yaml | kops create -f -
$ kops create sshpublickey --name k8s.ap-northeast-2.aws.hello.com -i hello.pub
```

```text:윈도우 PowerShell
cat .\k8s.ap-northeast-2.aws.hello.com.yaml | kops create -f -
kops create sshpublickey --name k8s.ap-northeast-2.aws.hello.com -i hello.pub
```

이상이 없으면 실제로 적용을 해봅니다. 이제 실제로 EC2 인스턴스가 생성됩니다.

```text
$ kops update cluster --name k8s.ap-northeast-2.aws.hello.com --yes

*********************************************************************************

A new kops version is available: 1.25.2
Upgrading is recommended
More information: https://github.com/kubernetes/kops/blob/master/permalinks/upgrade_kops.md#1.25.2

*********************************************************************************

I1125 12:16:09.581824 9528 executor.go:111] Tasks: 0 done / 109 total; 48 can run
W1125 12:16:09.693436 9528 vfs_castore.go:379] CA private key was not found
I1125 12:16:09.699437 9528 keypair.go:225] Issuing new certificate: "etcd-manager-ca-events"
I1125 12:16:09.712633 9528 keypair.go:225] Issuing new certificate: "apiserver-aggregator-ca"
I1125 12:16:09.727296 9528 keypair.go:225] Issuing new certificate: "etcd-peers-ca-events"
I1125 12:16:09.730567 9528 keypair.go:225] Issuing new certificate: "etcd-manager-ca-main"
I1125 12:16:09.732792 9528 keypair.go:225] Issuing new certificate: "etcd-peers-ca-main"
I1125 12:16:09.733800 9528 keypair.go:225] Issuing new certificate: "etcd-clients-ca"
W1125 12:16:09.734626 9528 vfs_castore.go:379] CA private key was not found
I1125 12:16:09.757601 9528 keypair.go:225] Issuing new certificate: "kubernetes-ca"
I1125 12:16:09.765643 9528 keypair.go:225] Issuing new certificate: "service-account"
I1125 12:16:10.774088 9528 executor.go:111] Tasks: 48 done / 109 total; 23 can run
I1125 12:16:11.666874 9528 executor.go:111] Tasks: 71 done / 109 total; 30 can run
I1125 12:16:12.317385 9528 executor.go:111] Tasks: 101 done / 109 total; 4 can run
I1125 12:16:13.289549 9528 executor.go:155] No progress made, sleeping before retrying 4 task(s)
I1125 12:16:23.304076 9528 executor.go:111] Tasks: 101 done / 109 total; 4 can run
I1125 12:16:25.822231 9528 executor.go:111] Tasks: 105 done / 109 total; 4 can run
I1125 12:16:25.919122 9528 executor.go:111] Tasks: 109 done / 109 total; 0 can run
I1125 12:16:27.221437 9528 dns.go:238] Pre-creating DNS records
I1125 12:16:27.817503 9528 update_cluster.go:326] Exporting kubeconfig for cluster
kOps has set your kubectl context to k8s.ap-northeast-2.aws.hello.com
W1125 12:16:27.845592 9528 update_cluster.go:350] Exported kubeconfig with no user authentication; use --admin, --user or --auth-plugin flags with `kops export kubeconfig`

Cluster is starting. It should be ready in a few minutes.

Suggestions:
 * validate cluster: kops validate cluster --wait 10m
 * list nodes: kubectl get nodes --show-labels
 * ssh to the master: ssh -i ~/.ssh/id_rsa ubuntu@api.k8s.ap-northeast-2.aws.hello.com
 * the ubuntu user is specific to Ubuntu. If not using Ubuntu please use the appropriate user based on your OS.
 * read about installing addons at: https://kops.sigs.k8s.io/addons.

```

AWS 콘솔에서 EC2 인스턴스 목록을 확인해보면 마스터와 워커 노드들이 생성되고 있을 것입니다.

다음 명령을 입력하여 `~/.kube/config`에 방금 생성한 클러스터의 설정을 추가합니다.

```text
$ kops export kubeconfig --admin
```

잠시 기다리면 EC2 인스턴스가 생성되고 클러스터가 초기화됩니다.

우리는 실제로 **hello.com** 도메인을 구입하지 않았으므로, 로컬에서 임시로 사용할 수 있도록 설정해야 합니다. 운영체제별로 설정 파일이 조금 다른데, 각자 운영체제에 맞는 파일을 수정합니다.

IP 주소는 클러스터의 마스터 노드 IP 주소를 사용해야 하는데, 다음과 같은 과정으로 IP 주소를 찾을 수 있습니다.

1. AWS 콘솔 접속
2. EC2로 이동
3. **인스턴스** 메뉴 클릭
4. 이름이 **master-ap-northeast-2a.masters.k8s.ap-northeast-2.aws.hello.com**인 인스턴스 클릭 클릭
5. 세부 정보에 **퍼블릭 IPv4 주소** 부분을 복사(\<마스터 노드의 퍼블릭 IPv4 주소\>)

리눅스, macOS는 `/etc/hosts` 파일을 수정해야 합니다. root 권한이 있어야 하므로 `sudo vim`으로 수정합니다.

```text:리눅스, macOS
$ sudo vim /etc/hosts
```

`/etc/hosts` 파일의 마지막 부분에 다음 내용을 추가한 뒤 저장합니다.

```text:/etc/hosts
<마스터 노드의 퍼블릭 IPv4 주소> api.k8s.ap-northeast-2.aws.hello.com
```

윈도우는 `C:\Windows\System32\drivers\etc\hosts` 파일을 수정해야 합니다. 관리자 권한이 필요하므로, 메모장을 관리자 권한으로 실행한 뒤 파일을 엽니다.

`C:\Windows\System32\drivers\etc\hosts` 파일의 마지막 부분에 다음 내용을 추가한 뒤 저장합니다.

```text:C:\Windows\System32\drivers\etc\hosts
<마스터 노드의 퍼블릭 IPv4 주소> api.k8s.ap-northeast-2.aws.hello.com
```

<Alert variant="info">
<InfoSignIcon /> **메모장에서 hosts 파일이 보이지 않는다면?**

메모장에서 hosts 파일이 보이지 않는다면, 열기 창에서 열기(O) 버튼 위의 텍스트 문서(\*.txt)를 모든 파일 (\*.\*)로 바꿔주면 됩니다.

</Alert>

`kubectl get nodes` 명령을 입력하여 노듣 목록을 출력해봅니다. 노드 4개가 완전히 생성된 뒤 Ready 상태가 될 때까지 시간이 다소 걸립니다. 노드가 일부만 보인다면 조금 더 기다렸다가 명령을 실행해봅니다.

```text {1}
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
i-01a4d885fd48acc61 Ready control-plane 4m4s v1.25.4
i-082f35a3d294a5e7d Ready node 54s v1.25.4
i-0c48a73869254c456 Ready node 37s v1.25.4
i-0e5dad97f6500d40a Ready node 51s v1.25.4
```

이렇게 kOps로 AWS에 쿠버네티스 클러스터를 생성해보았습니다. 다음 장에서는 Nginx 인그레스 컨트롤러를 설치한 뒤 로드밸런서(AWS의 ELB)에 웹 서버 디플로이먼트와 서비스를 연결하는 방법을 알아보겠습니다.

<Alert variant="info">
<InfoSignIcon /> **클러스터 삭제 방법**

여기서 더 이상 진행하지 않고 클러스터를 삭제하려면 다음 명령을 실행합니다.

```text
$ kops delete cluster --name k8s.ap-northeast-2.aws.<구입한 도메인> --yes
```

또는

```text
$ kops delete cluster --name k8s.ap-northeast-2.aws.hello.com --yes
```

</Alert>

<DisqusComments />

<AdsenseBottomBox2 />

Recent posts

Docs

Book