Tech Blog

MacのローカルでKubernetesのコンテナを実行する

2023-02-25
KubernetesKubernetes

環境構築

Docker for Macをインストールする。

kind、kubectlをインストールする。

kind はKubernetesをローカルでテストしたりすることができるツール。

kubectl はKubernetesのコマンドラインツール。

インストール

brew install kind
brew install kubectl

確認

kind version
kubectl version --short

kindでKubernetesクラスタを作成

kind create cluster --image docker.io/kindest/node:v1.26.0

Kubernetesノードの一覧確認

kubectl get node
NAME                 STATUS   ROLES           AGE   VERSION
kind-control-plane   Ready    control-plane   22m   v1.26.0

マニフェスト

nginxコンテナを作成したクラスタにデプロイしていきます。

Deploymentリソースのマニフェスト

Kubernetesでコンテナをデプロイするにはマニフェストファイルを作成する必要がある。

myapp.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - image: docker.io/nginx:1.23
          name: nginx
          env:
            - name: MY_ENV
              valueFrom:
                secretKeyRef:
                  name: myapp-secret
                  key: MY_ENV
          volumeMounts:
            - name: myapp-config
              mountPath: /etc/nginx/templates
      volumes:
        - name: myapp-config
          configMap:
            name: myapp-config

ConfigMapリソースのマニフェストファイル

Kubernetesで設定情報を扱うにはConfigMapリソースを使う

myapp-config.yaml

kind: ConfigMap
metadata:
  name: myapp-config
data:
  default.conf.template: |
    server {
      location / {
        return 200 'Hello $MY_ENV';
        add_header Content-Type text/plain;
      }
    }

docker.io/nginxイメージには/etc/nginx/templatesに*.templateの名前で設定ファイルのテンプレートを 配置すると、テンプレートに含まれる環境変数をその値で変換し、/etc/nginx/conf.dに配置する。

ConfigMapを/etc/nginx/templatesにマウントするように変更している。

Secretリソースのマニフェストファイル

Kubernetesで秘匿情報を扱う場合はSecretリソースを使う。

Secretリソースのdataフィールドに値をBase64エンコードして設定する。

myapp-secret.yaml

apiVersion: v1
kind: Secret
metadata:
  name: myapp-secret
data:
  MY_ENV: a3ViZXJuZXRlcw==

Secretリソースのマニフェストの管理

  • パスワードのついた別の保管庫に保存する
  • Sealed Secrets などを利用してSecretリソースを暗号化する
  • External Secrets Operator などを利用して、外部のシークレットストアと連携する。

クラスタに適用する

以下のコマンドでクラスタにPodの作成、変更ができる。

kubectl apply -f myapp-config.yaml -f myapp.yaml -f myapp-secret.yaml

リソースの状況確認

Deploymentリソースの状況確認

kubectl get deployments

作成したPodを確認

kubectl get pods

podのログ確認

kubectl logs [Pod Name]

PodにHTTPでアクセスする

kubectl port-forward [Pod Name] 8080:80

別ターミナルを開いて確認すると、

Hello kubernetes が出力される。

curl -s http://127.0.0.1:8080/
Hello kubernetes

クラスタの削除

kind delete cluster