밴쿠버 코로노의 개발일지

Helm repository에서 chart를 download 할 수 있는데 2가지 타입으로 할 수 있다. 

1. Helm chart로 다운로드 하기 

2. Kubernetes manifest file(Yaml) 파일로 다운로드 하기 

1. Helm chart로 다운로드 하기 

간단한 예로, Consul chart를 다운로드 해보겠다. 우선 Hashicorp Helm repository를 등록한다. 

$ helm repo add hashicorp https://helm.releases.hashicorp.com

`helm pull` 명령어를 통해서 Chart를 다운로드 한다. 

// 가장 최신 차트가 다운로드 된다. 
$ helm pull hashicorp/consul

// 다운로드와 동시에 압축해제를 할 때 사용
$ helm pull hashicorp/consul --untar

2. Kubernetes manifest 파일로 다운로드 하기

이 경우에는 helm template 명령어를 사용한다. Manifest 파일로 다운로드 할 경우 values.yaml 파일을 넣어주면 내가 원하는 값으로 생성이 가능하다. 그렇지 않으면 Default 값으로 생성된다. 

values.yaml

client:
  enabled: true

server:
  replicas: 1
  bootstrapExpect: 1
  disruptionBudget:
    maxUnavailable: 0

$ helm template consul hashicorp/consul -f values.yaml --namespace default --version 0.40.0 > consul.yaml

위와 같이 실행하면 consul.yaml에 모든 Manifest가 추가되어 생성되게 된다. 

k8s persistent volume을 셋팅하다 보면 Terminating state 에서 stuck 되는 경우가 많다. 

NAME         CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS        CLAIM               STORAGECLASS            REASON   AGE
jenkins-pv   5Gi        RWO            Retain           Terminating   default/redis-pvc   default-local-storage            25m

이럴 경우 아래와 같으 명령어로 쉽게 해결이 가능하다.

$ kubectl patch pv jenkins-pv -p '{"metadata":{"finalizers":null}}'

$ helm install -f values.yaml my-release bitnami/redis​

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

현재 구현하고 있는 Service의 경우 Redis를 사용해야 하기 때문에 Redis는 local에 설치하였다. 

요즘 추세가 Kubernetes operator를 사용하여 설치하지만 Local Kubernetes를 이용해야 하고, Service type을 NodePort를 사용하여 IDE에서 테스트를 하고 싶었기 때문에 Helm chart를 이용하고 싶었다. 그리고 Github에 values.yaml를 저장해두면 설정 파일의 버전을 관리할 수 있으니 이 방법을 택했다. 

현재 가장 잘 관리되고 있는 redis의 Helm chart는 bitnami에서 관리되는 Chart 이다. 아래 경로를 참조하기 바란다. 

https://github.com/bitnami/charts/tree/master/bitnami/redis

모든 설치방법과 상세한 옵션은 위의 사이트에 자세하게 나와 있지만 간단하게 master 1개와 replica 1개를 설치하는 방법을 공유하고자 한다. 이 또한 나의 기억을 유지하기 위한 방법이므로... ㅎㅎ

Helm Repository 등록

bitnami의 chart를 사용하기 위해서는 우선 Helm repository를 등록해야 한다. 

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

Installation

변경된 values.yaml과 함께 설치를 하기 위해서는 `-f` 옵션을 이용한다. `my-release` 부분은 원하는 배포명을 입력하면 된다. 

$ helm install -f values.yaml my-release bitnami/redis

Uninstallation

$ helm delete my-release

변경한 Configuration in values.yaml

1. Service 변경

NodePort 30379를 open 하였다. 

service:
    type: NodePort
    port: 6379
    nodePort: 30379
    externalTrafficPolicy: Cluster

2. Replica count 변경

리소스 문제가 있으므로 replica count 는 1로 설정하였다. 

replica:
    replicaCount: 1

3. Persistence Volume 설정

Local 환경의 Volume은 yaml 파일로 우선 생성한 후 연결하였다. 개발용으로 많은 데이터를 저장하지 않을 것이기 때문에 1Gi 로 셋팅하였다. 

persistence:
    existingClaim: "redis-pvc"

Persistence Volume chart

아래 저장소의 Helm chart로 volume을 설치하였다. 

저장소 Link : https://github.com/coolexplorer/k8s-charts/tree/main/charts/volumes/charts/redis-vol

1인 개발을 위해서 환경을 꾸밀 때에는 많은 제약이 있다. 여유 자금이 많아서 서버를 사놓고 VM을 여러 개 설치하여 사용할 수 있겠지만, 난 가난한 가장으로 그러한 환경을 꾸밀 수가 없었다. 사실 현재 밴쿠버에서 유학생으로 있고 집도 좁아서 서버를 설치해 둘 공간도 없긴 하다. 그래서 최근 사양이 좋은 Laptop을 구매하였고 어떻게 개발환경을 꾸밀까 고민을 했었다. 

kubernetes를 local로 설치할 경우 다양한 방법이 있다. Linux machine일 경우에는 더 많은 tool들을 사용할 수 있지만, 난 macOS 환경이라 제약이 좀 있었다. 

대표적으로 모든 OS 환경에 사용할 수 있는 것이 minikube, kind, k3d, docker desktop kubernetes 등이 있다. 

이 중 k3d, kind는 내 Github에 설치 방법을 간단하게 정리해 둔 것이 있다. 

1. k3d 설치 방법 (https://github.com/coolexplorer/k8s-charts/tree/main/k8s/k3d)

2. kind 설치 방법 (https://github.com/coolexplorer/k8s-charts/tree/main/k8s/kind)

위 두가지 툴의 특징은 node를 docker container로 생성하고 그 노드들을 사용하여 cluster 환경을 구축할 수 있다. 

하지만 랩탑의 적은 사용으로 굳이 여러 노드를 설치할 필요가 없다고 생각하여, 개발 초반에는 간단한 툴을 사용하고자 했다. 

그래서 선택한 것이 Docker desktop 이다.

Docker desktop 설치

mac이나 windows os 환경에서 docker를 사용하기 위해서는 보통 Docker desktop을 이용한다. UI가 제공되기 때문에 Configuration 변경이나 현재 상태 등을 확인하기 좋기 때문이다. 

이 Docker desktop의 설치는 아래 경로에서 가능하다.

https://www.docker.com/get-started

Docker desktop을 설치하고 Run을 시키면 아래와 같은 U를 확인할 수 있다.

Kubernetes 실행

Kubernetes 설치가 아니라 실행이라고 적었다. 사실 이 툴을 이용하여 kubernetes를 설치하는 것이 아니라 실행해야 한다고 하는게 맞을 것 같다. 그만큼 간단하다는 얘기이다. 

Settings 메뉴로 들어가면 Kubernetes Menu가 보인다. 클릭해보자. 

처음은 `Enable Kubernetes` 가 Check되어 있지 않다. 그것을 체크를 해주고 설치를 하면 몇 분 후에 설치가 완료된다. 

현재 나의 환경에는 v1.22.4가 설치되어 있다. 

Kubernetes에 접근하기

kubernetes를 설치하고 나면 이제 이 cluster 환경에 접근이 가능해야 한다. 기본적으로 kubernetes의 authentication 정보는 `~/.kube/config` 에 저장이 된다. Docker desktop은 현재 PC를 master node로 하여 설치되므로, 설치가 완료되면 auth 정보가 해당 파일에 자동으로 저장된다. 너무 쉽다. 

하지만 cluster 환경에 접근은 authentication으로만은 불가능하다. 기본적인 접근은 `kubectl`이라고 하는 Command Line Interface를 통해서 수행한다. 가장 기본이고 가장 많이 사용하는 것이므로 꼭 기억하자. 

kubectl 설치하기

내 환경이 mac이므로 이것을 기준으로 설명하겠다. 나머지는 공식문서 Link로 대신한다. 

공식문서 : https://kubernetes.io/docs/tasks/tools/

Mac에서 설치방법 중에서도 가장 간단한 Homebrew로 진행하자.

$ brew install kubectl

설치가 완료되면 아래과 같은 명령어로 Cluster 정보를 확인해보면 된다. 

$ kubectl cluster-info

Kubernetes control plane is running at https://kubernetes.docker.internal:6443
CoreDNS is running at https://kubernetes.docker.internal:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'

오늘은 나의 개발환경의 가장 기본이 되는 kubernetes 설치에 대해서 확인해 보았다.