빠른 시작: 웹 앱 배포 및 데이터 저장

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 로드 밸런서 컨트롤러(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 트래픽에 대한 라우팅 규칙과 인터넷 경계 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 -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