クイックスタート: ウェブアプリケーションをデプロイしてデータを保存する

cluster-config.yaml ファイルを作成して、次の内容を貼り付けます。region-code を、us-east-1 などの有効なリージョンに置き換えます。

次に出力例を示します。

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: web-quickstart
  region: region-code

managedNodeGroups:
  - name: eks-mng
    instanceType: t3.medium
    desiredCapacity: 2

iam:
  withOIDC: true
  serviceAccounts:
  - metadata:
      name: aws-load-balancer-controller
      namespace: kube-system
    wellKnownPolicies:
      awsLoadBalancerController: true

addons:
  - name: aws-ebs-csi-driver
    wellKnownPolicies: # Adds an IAM service account
      ebsCSIController: true

cloudWatch:
 clusterLogging:
   enableTypes: ["*"]
   logRetentionInDays: 30

Amazon EKS クラスターを作成し、cluster-config.yaml を指定します。

eksctl create cluster -f cluster-config.yaml

完了すると、以下のようなレスポンス出力が表示されます。

2024-07-04 21:47:53 [✔]  EKS cluster "web-quickstart" in "region-code" region is ready

Amazon EKS クラスターの CLUSTER_REGION 環境変数を設定します。region-code のサンプル値を置き換えます。

export CLUSTER_REGION=region-code
            

Amazon EKS クラスターの CLUSTER_VPC 環境変数を設定します。

export CLUSTER_VPC=$(aws eks describe-cluster --name web-quickstart --region $CLUSTER_REGION --query "cluster.resourcesVpcConfig.vpcId" --output text)

Helm を使用して、Amazon EKS チャートリポジトリを Helm に追加します。

helm repo add eks https://aws.github.io/eks-charts

リポジトリを更新して、Helm がチャートの最新バージョンを認識していることを確認します。

helm repo update eks

次の Helm コマンドを実行して、カスタムリソース定義 (CRD) と AWS Load Balancer Controller (AWS LBC) のメインコントローラーを同時にインストールします。CRD のインストールをスキップするには、--skip-crds フラグを渡します。これは、CRD が既にインストールされている場合や、特定のバージョンの互換性が必要な場合、あるいはアクセスコントロールとカスタマイズのニーズが厳しい環境において便利です。

helm install aws-load-balancer-controller eks/aws-load-balancer-controller \
    --namespace kube-system \
    --set clusterName=web-quickstart \
    --set serviceAccount.create=false \
    --set region=${CLUSTER_REGION} \
    --set vpcId=${CLUSTER_VPC} \
    --set serviceAccount.name=aws-load-balancer-controller

以下のようなレスポンス出力が表示されます。

NAME: aws-load-balancer-controller
LAST DEPLOYED: Wed July 3 19:43:12 2024
NAMESPACE: kube-system
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
AWS Load Balancer controller installed!

--save-config フラグを付けて game-2048 という Kubernetes 名前空間を作成します。

kubectl create namespace game-2048 --save-config

以下のようなレスポンス出力が表示されます。

namespace/game-2048 created

2048 ゲームサンプルアプリケーションをデプロイします。

kubectl apply -n game-2048 -f https://raw.githubusercontent.com/kubernetes-sigs/aws-load-balancer-controller/v2.8.0/docs/examples/2048/2048_full.yaml

このマニフェストは、game-2048 名前空間の Kubernetes デプロイ、サービス、およびイングレスをセットアップし、クラスター内で game-2048 アプリケーションをデプロイして公開するために必要なリソースを作成します。これには、ポート 80 でのデプロイを公開する service-2048 という名前のサービスの作成と、受信 HTTP トラフィックのルーティングルールと internet-facing Application Load Balancer (ALB) の注釈を定義する ingress-2048 という名前のイングレスリソースの作成が含まれます。以下のようなレスポンス出力が表示されます。

namespace/game-2048 configured
deployment.apps/deployment-2048 created
service/service-2048 created
ingress.networking.k8s.io/ingress-2048 created

次のコマンドを実行して、game-2048 名前空間のイングレスリソースを取得します。

kubectl get ingress -n game-2048

以下のようなレスポンス出力が表示されます。

NAME           CLASS   HOSTS   ADDRESS                                                                    PORTS   AGE
ingress-2048   alb     *       k8s-game2048-ingress2-eb379a0f83-378466616.region-code.elb.amazonaws.com   80      31s

Application Load Balancer (ALB) がプロビジョニングされるまで数分待ってから、次のステップを開始する必要があります。

ウェブブラウザを開き、前のステップの ADDRESS を入力してウェブアプリケーションにアクセスします。例:

k8s-game2048-ingress2-eb379a0f83-378466616.region-code.elb.amazonaws.com

ブラウザに 2048 ゲームが表示されるはずです。プレイしてください!

EBS CSI ドライバーのストレージクラスを作成します。

kubectl apply -n game-2048 -f https://raw.githubusercontent.com/kubernetes-sigs/aws-ebs-csi-driver/master/examples/kubernetes/dynamic-provisioning/manifests/storageclass.yaml

ゲームデータのストレージをリクエストするには、永続ボリュームのクレーム (PVC) を作成します。ebs-pvc.yaml という名前のファイルを作成し、そのファイルに以下の内容を追加します。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: game-data-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: ebs-sc

PVC をクラスターに適用します。

kubectl apply -f ebs-pvc.yaml

以下のようなレスポンス出力が表示されます。

persistentvolumeclaim/game-data-pvc created

次に、データの保存にこの PVC を使用するように 2048 ゲームデプロイを更新する必要があります。次のデプロイは、ゲームデータの保存に PVC を使用するように設定されています。ebs-deployment.yaml という名前のファイルを作成し、そのファイルに以下の内容を追加します。

apiVersion: apps/v1
kind: Deployment
metadata:
  namespace: game-2048
  name: deployment-2048
spec:
  replicas: 3  # Adjust the number of replicas as needed
  selector:
    matchLabels:
      app.kubernetes.io/name: app-2048
  template:
    metadata:
      labels:
        app.kubernetes.io/name: app-2048
    spec:
      containers:
        - name: app-2048
          image: public.ecr.aws/l6m2t8p7/docker-2048:latest
          imagePullPolicy: Always
          ports:
            - containerPort: 80
          volumeMounts:
            - name: game-data
              mountPath: /var/lib/2048
      volumes:
        - name: game-data
          persistentVolumeClaim:
            claimName: game-data-pvc

更新されたデプロイを適用します。

kubectl apply -f ebs-deployment.yaml

以下のようなレスポンス出力が表示されます。

deployment.apps/deployment-2048 configured