자습서: Amazon EKS에 애플리케이션 배포

새 개발 환경을 시작하려면

1. https://codecatalyst.aws/에서 CodeCatalyst 콘솔을 엽니다.

2. codecatalyst-eks-project 프로젝트로 이동합니다.

3. 탐색 창에서 코드를 선택한 다음 소스 리포지토리를 선택합니다.

4. 소스 리포지토리 codecatalyst-eks-source-repository의 이름을 선택합니다.

5. 상단 근처에서 개발 환경 생성을 선택한 다음 AWS Cloud9(브라우저에서)를 선택합니다.

6. 기존 브랜치에서 작업 및 메인이 선택되어 있는지 확인한 다음 생성을 선택합니다.

   개발 환경가 새 브라우저 탭에서 시작되고 리포지토리(codecatalyst-eks-source-repository)가 복제됩니다.

kubectl을 설치 및 구성하려면

1. 개발 환경 터미널에 다음을 입력합니다.

   curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl

2. 입력:

   chmod +x ./kubectl

3. 입력:

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin

4. 입력:

   echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

5. 입력:

   kubectl version --short --client

6. 버전이 나타나는지 확인합니다.

   이제 kubectl이 설치됐습니다.

eksctl을 설치 및 구성하려면

1. 개발 환경 터미널에 다음을 입력합니다.

   curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp

2. 입력:

   sudo cp /tmp/eksctl /usr/bin

3. 입력:

   eksctl version

4. 버전이 나타나는지 확인합니다.

   이제 eksctl이 설치됐습니다.

AWS CLI이 설치되어 있는지 확인하려면

1. 개발 환경 터미널에 다음을 입력합니다.

   aws --version

2. 버전이 표시되는지 보고 AWS CLI이 설치되어 있는지 확인합니다.

   나머지 절차를 완료하여 AWS 액세스에 필요한 권한으로 AWS CLI을 구성합니다.

1. 다음과 같이 IAM Identity Center 사용자를 생성합니다.

   1. AWS Management Console에 로그인하여 https://console.aws.amazon.com/singlesignon/에서 AWS IAM Identity Center 콘솔을 엽니다.

      (IAM Identity Center에 로그인한 적이 없는 경우 활성화를 선택해야 할 수 있습니다.)

      참고

      CodeCatalyst 스페이스에 연결된 AWS 계정를 사용하여 로그인해야 합니다. 스페이스로 이동하여 AWS 계정 탭을 선택하고 연결된 계정을 확인할 수 있습니다. 자세한 내용은 스페이스 생성 섹션을 참조하십시오.

   2. 탐색 창에서 Users와 Add user를 차례대로 선택합니다.

   3. 사용자 이름에 다음을 입력합니다.

      codecatalyst-eks-user

   4. 암호에서 이 사용자와 공유할 수 있는 일회용 암호 생성을 선택합니다.

   5. 이메일 주소 및 이메일 주소 확인에 IAM Identity Center에 아직 없는 이메일 주소를 입력합니다.

   6. 이름에 다음을 입력합니다.

      codecatalyst-eks-user

   7. 성에 다음을 입력합니다.

      codecatalyst-eks-user

   8. 표시 이름에서 다음을 유지합니다.

      codecatalyst-eks-user codecatalyst-eks-user

   9. Next(다음)를 선택합니다.

   10. 그룹에 사용자 추가 페이지에서 다음을 선택합니다.

   11. 검토 및 사용자 추가 페이지에서 정보를 검토하고 사용자 추가를 선택합니다.

       일회용 암호 대화 상자가 나타납니다.

   12. 복사를 선택한 다음 로그인 정보를 텍스트 파일에 붙여넣습니다. 로그인 정보는 AWS 액세스 포털 URL, 사용자 이름 및 일회용 암호로 구성됩니다.

   13. 닫기를 선택하세요.

2. 다음과 같이 권한 세트를 생성합니다.

   1. 탐색 창에서 권한 세트를 선택한 다음 권한 세트 생성을 선택합니다.

   2. 사전 정의된 권한 세트를 선택하고 AdministratorAccess를 선택합니다. 이 정책은 모든 AWS 서비스에 대한 전체 권한을 제공합니다.

   3. Next(다음)를 선택합니다.

   4. 권한 세트 이름에서 AdministratorAccess를 제거하고 다음을 입력합니다.

      codecatalyst-eks-permission-set

   5. Next(다음)를 선택합니다.

   6. 검토 및 생성 페이지에서 정보를 검토하고 생성을 선택합니다.

3. 다음과 같이 권한 세트를 codecatalyst-eks-user에 할당합니다.

   1. 탐색 창에서 AWS 계정을 선택한 다음 현재 로그인한 AWS 계정 옆의 확인란을 선택합니다.

   2. 사용자 또는 그룹 할당을 선택합니다.

   3. 사용자 탭을 선택합니다.

   4. codecatalyst-eks-user 옆의 확인란을 선택합니다.

   5. Next(다음)를 선택합니다.

   6. codecatalyst-eks-permission-set 옆의 확인란을 선택합니다.

   7. Next(다음)를 선택합니다.

   8. 정보를 검토하고 제출을 선택합니다.

      이제 codecatalyst-eks-user 및 codecatalyst-eks-permission-set를 AWS 계정에 할당하여 함께 바인딩했습니다.

4. 다음과 같이 codecatalyst-eks-user의 액세스 키 및 세션 토큰을 가져옵니다.

   1. codecatalyst-eks-user에 대한 AWS 액세스 포털 URL과 사용자 이름 및 일회용 암호가 있는지 확인합니다. 이전에 이 정보를 텍스트 편집기에 복사했어야 합니다.

      참고

      이 정보가 없는 경우 IAM Identity Center의 codecatalyst-eks-user 세부 정보 페이지로 이동하여 암호 재설정, 일회용 암호 생성 [...]을 선택한 후 암호 재설정을 다시 선택하면 화면에 해당 정보가 표시됩니다.

   2. AWS에서 로그아웃합니다.

   3. AWS 액세스 포털 URL을 브라우저의 주소 표시줄에 붙여 넣습니다.

   4. 다음을 사용하여 로그인:

      • 사용자 이름:

        codecatalyst-eks-user

      • 암호:

        일회용 암호

   5. 새 암호 설정에서 새 암호를 입력하고 새 암호 설정을 선택합니다.

      화면에 AWS 계정 상자가 나타납니다.

   6. AWS 계정을 선택한 다음 codecatalyst-eks-user 사용자 및 권한 세트를 할당한 AWS 계정의 이름을 선택합니다.

   7. codecatalyst-eks-permission-set 옆의 명령줄 또는 프로그래밍 액세스를 선택합니다.

   8. 페이지 중간에 있는 명령을 복사합니다. 다음처럼 보일 것입니다.

      export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
      export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
      export AWS_SESSION_TOKEN="session-token"

      ...여기서 세션 토큰은 긴 무작위 문자열입니다.

5. 다음과 같이 액세스 키와 세션 토큰을 AWS CLI에 추가합니다.

   1. CodeCatalyst 개발 환경으로 돌아갑니다.

   2. 터미널 프롬프트에서 복사한 명령을 붙여넣습니다. Enter를 누릅니다.

      이제 액세스 키와 세션 토큰을 사용하여 AWS CLI를 구성했습니다. 이제 AWS CLI를 사용하여 이 자습서에 필요한 작업을 완료할 수 있습니다.

      중요

      이 자습서 중에 언제든지 다음과 유사한 메시지가 표시되는 경우:

      Unable to locate credentials. You can configure credentials by running "aws configure".

      또는 다음과 같습니다.

      ExpiredToken: The security token included in the request is expired

      ... AWS CLI 세션이 만료되었기 때문입니다. 이 경우 aws configure 명령을 실행하지 않습니다. 대신 Obtain codecatalyst-eks-user's access key and session token로 시작하는 이 절차의 4단계에 있는 지침을 사용하여 세션을 새로 고칩니다.

클러스터 생성

1. 개발 환경으로 이동합니다.

2. 클러스터 및 노드를 생성합니다.

   eksctl create cluster --name codecatalyst-eks-cluster --region us-west-2

   위치:

   • codecatalyst-eks-cluster는 클러스터에 부여하려는 이름으로 대체됩니다.

   • us-west-2를 해당 리전으로 바꿉니다.

   10~20분 후 다음과 비슷한 메시지가 나타납니다.

   EKS cluster "codecatalyst-eks-cluster" in "us-west-2" region is ready

   참고

   AWS에서 클러스터를 생성하는 동안 여러 waiting for CloudFormation stack 메시지가 표시됩니다. 이는 예상된 동작입니다.

3. 클러스터가 성공적으로 생성되었는지 확인합니다.

   kubectl cluster-info

   성공적인 클러스터 생성을 나타내는 다음과 유사한 메시지가 표시됩니다.

   Kubernetes master is running at https://long-string.gr7.us-west-2.eks.amazonaws.com
   CoreDNS is running at https://long-string.gr7.us-west-2.eks.amazonaws.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Amazon ECR에서 이미지 리포지토리를 생성하려면

1. 개발 환경으로 이동합니다.

2. Amazon ECR에 빈 리포지토리를 생성합니다.

   aws ecr create-repository --repository-name codecatalyst-eks-image-repo

   codecatalyst-eks-image-repo를 Amazon ECR 리포지토리에 부여하려는 이름으로 바꿉니다.

   이 자습서에서는 리포지토리 이름을 codecatalyst-eks-image-repo로 지정했다고 가정합니다.

3. Amazon ECR 리포지토리의 세부 정보를 표시합니다.

   aws ecr describe-repositories \
         --repository-names codecatalyst-eks-image-repo
   

4. “repositoryUri”: 값을 기록해 둡니다. 예시: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo.

   나중에 워크플로에 리포지토리를 추가할 때 필요합니다.

index.html 파일을 추가하려면

1. 개발 환경으로 이동합니다.

2. codecatalyst-eks-source-repository에서 이름이 public-html인 폴더를 생성합니다.

3. /public-html에서 다음 콘텐츠로 index.html 파일을 생성합니다.

   <html>
     <head>
       <title>Hello World</title>
       <style>
         body {
         background-color: black;
         text-align: center;
         color: white;
         font-family: Arial, Helvetica, sans-serif;
         }  
       </style>
     </head>
     <body>
       <h1>Hello, World!</h1>
     </body>
   </html>

4. 터미널 프롬프트에서 다음을 입력합니다.

   cd /projects/codecatalyst-eks-source-repository

5. 추가, 커밋 및 푸시:

   git add .
   git commit -m "add public-html/index.html"
   git push

   index.html은 public-html 폴더의 리포지토리에 추가됩니다.

Dockerfile을 추가하려면

1. codecatalyst-eks-source-repository에서 다음 콘텐츠로 Dockerfile 파일을 생성합니다.

   FROM httpd:2.4
   COPY ./public-html/index.html /usr/local/apache2/htdocs/index.html
   EXPOSE 80

   파일 확장자는 제외합니다.

   중요

   Dockerfile은 리포지토리의 루트 폴더에 있어야 합니다. 워크플로의 Docker build 명령은 해당 파일이 있을 것으로 예상합니다.

2. 추가, 커밋 및 푸시:

   git add .
   git commit -m "add Dockerfile"
   git push

   Dockerfile이 리포지토리에 추가됩니다.

deployment.yaml 파일을 추가하려면

1. codecatalyst-eks-source-repository에서 이름이 Kubernetes인 폴더를 생성합니다.

2. /Kubernetes에서 다음 콘텐츠로 deployment.yaml 파일을 생성합니다.

   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
     labels:
       app: my-app
   spec:
     type: LoadBalancer
     selector:
       app: my-app
     ports:
       - protocol: TCP
         port: 80
         targetPort: 80
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: codecatalyst-eks-container
           # The $REPOSITORY_URI and $IMAGE_TAG placeholders will be replaced by actual values supplied by the build action in your workflow
           image: $REPOSITORY_URI:$IMAGE_TAG
           ports:
           - containerPort: 80

3. 추가, 커밋 및 푸시:

   git add .
   git commit -m "add Kubernetes/deployment.yaml"
   git push

   deployment.yaml은 Kubernetes 폴더의 리포지토리에 추가됩니다.

1. 두 역할에 대한 신뢰 정책을 생성하려면

1. 개발 환경으로 이동합니다.

2. Cloud9-long-string 디렉터리에 다음 콘텐츠로 codecatalyst-eks-trust-policy.json 파일을 생성합니다.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service":  [
                      "codecatalyst-runner.amazonaws.com",
                      "codecatalyst.amazonaws.com"
                    ]
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }

2. 빌드 역할에 대한 빌드 정책을 생성하려면

• Cloud9-long-string 디렉터리에 다음 콘텐츠로 codecatalyst-eks-build-policy.json 파일을 생성합니다.

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ecr:*",
                  "ec2:*"
              ],
              "Resource": "*"
          }
      ]
  }

  참고

  역할을 처음 사용하여 워크플로 작업을 실행할 때 리소스 정책 문에서 와일드카드를 사용한 다음, 사용 가능한 리소스 이름으로 정책 범위를 좁힙니다.

  "Resource": "*"

3. 배포 정책을 생성하고 역할을 배포하려면

• Cloud9-long-string 디렉터리에 다음 콘텐츠로 codecatalyst-eks-deploy-policy.json 파일을 생성합니다.

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "eks:DescribeCluster",
                  "eks:ListClusters"
              ],
              "Resource": "*"
          }
      ]
  }

  참고

  역할을 처음 사용하여 워크플로 작업을 실행할 때 리소스 정책 문에서 와일드카드를 사용한 다음, 사용 가능한 리소스 이름으로 정책 범위를 좁힙니다.

  "Resource": "*"

4. 빌드 정책을 AWS에 추가하려면

1. 개발 환경 터미널에 다음을 입력합니다.

   cd /projects

2. 입력:

   aws iam create-policy \
       --policy-name codecatalyst-eks-build-policy \
       --policy-document file://codecatalyst-eks-build-policy.json

3. Enter를 누릅니다.

4. 명령 출력에서 와 같은 "arn": 값을 기록해 둡니다(예: arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy). 나중에 이 ARN이 필요합니다.

5. 배포 정책을 AWS에 추가하려면

1. 입력:

   aws iam create-policy \
       --policy-name codecatalyst-eks-deploy-policy \
       --policy-document file://codecatalyst-eks-deploy-policy.json

2. Enter를 누릅니다.

3. 명령 출력에서 와 같은 "arn": 값을 기록해 둡니다(예: arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy). 나중에 이 ARN이 필요합니다.

6. 빌드 역할을 생성하려면

1. 입력:

   aws iam create-role \
         --role-name codecatalyst-eks-build-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Enter를 누릅니다.

3. 입력:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-build-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy

   arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy가 앞서 언급한 빌드 정책의 ARN으로 대체되는 경우.

4. Enter를 누릅니다.

5. 터미널 프롬프트에서 다음을 입력합니다.

   aws iam get-role \
         --role-name codecatalyst-eks-build-role

6. Enter를 누릅니다.

7. 역할의 "Arn": 값을 기록해 둡니다. 예시: arn:aws:iam::111122223333:role/codecatalyst-eks-build-role. 나중에 이 ARN이 필요합니다.

7. 배포 역할을 생성하려면

1. 입력:

   aws iam create-role \
         --role-name codecatalyst-eks-deploy-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Enter를 누릅니다.

3. 입력:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-deploy-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy

   arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy가 앞서 언급한 배포 정책의 ARN으로 대체되는 경우.

4. Enter를 누릅니다.

5. 입력:

   aws iam get-role \
         --role-name codecatalyst-eks-deploy-role

6. Enter를 누릅니다.

7. 역할의 "Arn": 값을 기록해 둡니다. 예시: arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. 나중에 이 ARN이 필요합니다.

AWS 계정에 빌드 및 배포 역할을 추가하려면

1. CodeCatalyst 콘솔에서 스페이스로 이동합니다.

2. 상단에서 설정을 선택합니다.

3. 탐색 창에서 AWS 계정을 선택합니다. 계정 목록이 나타납니다.

4. Amazon CodeCatalyst 표시 이름 열에서 빌드 및 배포 역할을 생성한 AWS 계정의 표시 이름을 복사합니다. (숫자일 수 있습니다.) 워크플로를 생성할 때 나중에 이 값이 필요합니다.

5. 표시 이름을 선택합니다.

6. AWS Management Console에서 역할 관리를 선택합니다.

   Amazon CodeCatalyst 스페이스에 IAM 역할 추가 페이지가 나타납니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.

7. IAM에서 생성한 기존 역할 추가를 선택합니다.

   드롭다운 목록이 나타납니다. 목록에는 빌드 및 배포 역할, codecatalyst-runner.amazonaws.com 및 codecatalyst.amazonaws.com 서비스 위탁자가 포함된 신뢰 정책이 있는 기타 IAM 역할이 표시됩니다.

8. 드롭다운 목록에서 다음을 추가합니다.

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   참고

   The security token included in the request is invalid가 표시되면 적절한 권한이 없기 때문일 수 있습니다. 이 문제를 해결하려면 AWS에서 로그아웃하고 CodeCatalyst 스페이스를 생성할 때 사용한 AWS 계정으로 다시 로그인합니다.

9. CodeCatalyst 콘솔로 돌아가 페이지를 새로 고칩니다.

   이제 빌드 및 배포 역할이 IAM 역할 아래에 표시됩니다.

   이제 CodeCatalyst 워크플로에서 이러한 역할을 사용할 수 있습니다.

eksctl을 사용하여 Kubernetes ConfigMap 파일을 구성하려면

• 개발 환경 터미널에 다음을 입력합니다.

  eksctl create iamidentitymapping --cluster codecatalyst-eks-cluster --arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role --group system:masters --username codecatalyst-eks-deploy-role --region us-west-2

  위치:

  • codecatalyst-eks-cluster는 Amazon EKS 클러스터의 클러스터 이름으로 대체됩니다.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role은 5단계: AWS 역할 생성에서 생성한 배포 역할의 ARN으로 대체됩니다.

  • codecatalyst-eks-deploy-role(--username 옆)은 5단계: AWS 역할 생성에서 생성한 배포 역할의 이름으로 대체됩니다.

    참고

    배포 역할을 생성하지 않기로 결정한 경우 codecatalyst-eks-deploy-role을 CodeCatalystWorkflowDevelopmentRole-spaceName 역할 이름으로 바꿉니다. 이에 대한 자세한 내용은 5단계: AWS 역할 생성 섹션을 참조하세요.

  • us-west-2를 해당 리전으로 바꿉니다.

  이 명령에 대한 자세한 내용은 IAM 사용자 및 역할 관리를 참조하세요.

  다음과 비슷한 메시지가 나타납니다.

  2023-06-09 00:58:29 [ℹ]  checking arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role against entries in the auth ConfigMap
  2023-06-09 00:58:29 [ℹ]  adding identity "arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role" to auth ConfigMap

kubectl을 사용하여 Kubernetes ConfigMap 파일을 구성하려면

1. 개발 환경 터미널에 다음을 입력합니다.

   kubectl edit configmap -n kube-system aws-auth

   ConfigMap 파일이 화면에 나타납니다.

2. 빨간색 기울임꼴로 텍스트를 추가합니다.

   # Please edit the object below. Lines beginning with a '#' will be ignored,
   # and an empty file will abort the edit. If an error occurs while saving this file will be
   # reopened with the relevant failures.
   #
   apiVersion: v1
   data:
     mapRoles: |
       - groups:
         - system:bootstrappers
         - system:nodes
         rolearn: arn:aws:iam::111122223333:role/eksctl-codecatalyst-eks-cluster-n-NodeInstanceRole-16BC456ME6YR5
         username: system:node:{{EC2PrivateDNSName}}
       - groups:
         - system:masters
         rolearn: arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role
         username: codecatalyst-eks-deploy-role
     mapUsers: |
       []
   kind: ConfigMap
   metadata:
     creationTimestamp: "2023-06-08T19:04:39Z"
     managedFields:
     ...

   위치:

   • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role은 5단계: AWS 역할 생성에서 생성한 배포 역할의 ARN으로 대체됩니다.

   • codecatalyst-eks-deploy-role(username: 옆)은 5단계: AWS 역할 생성에서 생성한 배포 역할의 이름으로 대체됩니다.

     참고

     배포 역할을 생성하지 않기로 결정한 경우 codecatalyst-eks-deploy-role을 CodeCatalystWorkflowDevelopmentRole-spaceName 역할 이름으로 바꿉니다. 이에 대한 자세한 내용은 5단계: AWS 역할 생성 섹션을 참조하세요.

   자세한 내용은 Amazon EKS 사용 설명서의 클러스터에 대한 IAM 위탁자 액세스 활성화를 참조하세요.

워크플로 생성 방법

1. CodeCatalyst 콘솔로 이동합니다.

2. 프로젝트(codecatalyst-eks-project)로 이동합니다.

3. 탐색 창에서 CI/CD를 선택한 다음 워크플로를 선택합니다.

4. 워크플로 생성을 선택합니다.

5. 소스 리포지토리에서 codecatalyst-eks-source-repository를 선택합니다.

6. 브랜치에서 main을 선택합니다.

7. 생성(Create)을 선택합니다.

8. YAML 샘플 코드를 삭제합니다.

9. 다음 YAML 코드를 추가하여 새 워크플로 정의 파일을 생성합니다.

   참고

   워크플로 정의 파일에 대한 자세한 내용은 워크플로 YAML 정의 섹션을 참조하세요.

   참고

   다음 YAML 코드에서 원하는 경우 Connections: 섹션을 생략할 수 있습니다. 이 섹션을 생략하는 경우 환경의 기본 IAM 역할 필드에 지정된 역할에 6단계: CodeCatalyst에 AWS 역할 추가에 설명된 두 역할의 권한 및 신뢰 정책이 포함되어 있는지 확인해야 합니다. 기본 IAM 역할이 있는 환경 설정에 대한 자세한 내용은 환경 생성 섹션을 참조하세요.

   Name: codecatalyst-eks-workflow
   SchemaVersion: 1.0
   
   Triggers:
     - Type: PUSH
       Branches:
         - main
   Actions:
     BuildBackend:
       Identifier: aws/build@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-build-role
       Inputs:
         Sources:
           - WorkflowSource
         Variables:
           - Name: REPOSITORY_URI
             Value: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo
           - Name: IMAGE_TAG
             Value: ${WorkflowSource.CommitId}
       Configuration:
         Steps:
           #pre_build:
           - Run: echo Logging in to Amazon ECR...
           - Run: aws --version
           - Run: aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com
           #build:
           - Run: echo Build started on `date`
           - Run: echo Building the Docker image...
           - Run: docker build -t $REPOSITORY_URI:latest .
           - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
           #post_build:
           - Run: echo Build completed on `date`
           - Run: echo Pushing the Docker images...
           - Run: docker push $REPOSITORY_URI:latest
           - Run: docker push $REPOSITORY_URI:$IMAGE_TAG
           # Replace the variables in deployment.yaml
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g"
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g"
           - Run: cat Kubernetes/*
           # The output artifact will be a zip file that contains Kubernetes manifest files.
       Outputs:
         Artifacts:
           - Name: Manifests
             Files: 
               - "Kubernetes/*"
     DeployToEKS:
       DependsOn: 
         - BuildBackend
       Identifier: aws/kubernetes-deploy@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-deploy-role
       Inputs:
         Artifacts:
           - Manifests
       Configuration:
         Namespace: default
         Region: us-west-2
         Cluster: codecatalyst-eks-cluster
         Manifests: Kubernetes/

   앞의 코드에서

   • codecatalyst-eks-environment 인스턴스 두 개를 모두 사전 조건에서 생성한 환경 이름으로 바꿉니다.

   • codecatalyst-account-connection 인스턴스 두 개를 모두 계정 연결의 표시 이름으로 바꿉니다. 표시 이름은 숫자일 수 있습니다. 자세한 내용은 6단계: CodeCatalyst에 AWS 역할 추가 섹션을 참조하십시오.

   • codecatalyst-eks-build-role을 5단계: AWS 역할 생성에서 생성한 빌드 역할 이름으로 바꿉니다.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo(Value: 속성 내)를 3단계: Amazon ECR 이미지 리포지토리 생성에서 생성한 Amazon ECR 리포지토리의 URI로 바꿉니다.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com(Run: aws ecr 명령 내)을 이미지 접미사(/codecatalyst-eks-image-repo) 제외 Amazon ECR 리포지토리의 URI로 바꿉니다.

   • codecatalyst-eks-deploy-role을 5단계: AWS 역할 생성에서 생성한 배포 역할의 이름으로 바꿉니다.

   • us-west-2의 인스턴스 두 개를 AWS 리전 코드로 바꿉니다. 리전 코드 목록은 AWS 일반 참조의 리전 엔드포인트를 참조하세요.

   참고

   빌드 및 배포 역할을 생성하지 않기로 결정한 경우 codecatalyst-eks-build-role 및 codecatalyst-eks-deploy-role을 CodeCatalystWorkflowDevelopmentRole-spaceName 역할 이름으로 바꿉니다. 이에 대한 자세한 내용은 5단계: AWS 역할 생성 섹션을 참조하세요.

10. (선택 사항) 커밋하기 전에 YAML 코드가 유효한지 확인하려면 검증을 선택합니다.

11. 커밋을 선택합니다.

12. 워크플로 커밋 대화 상자에서 다음을 입력합니다.

    1. 커밋 메시지에서 텍스트를 제거하고 다음을 입력합니다.

       Add first workflow

    2. 리포지토리에서 codecatalyst-eks-source-repository를 선택합니다.

    3. 브랜치 이름에서 기본을 선택합니다.

    4. 커밋을 선택합니다.

    이제 워크플로를 생성했습니다. 워크플로 상단에 정의된 트리거로 인해 워크플로 실행이 자동으로 시작됩니다. 특히 workflow.yaml 파일을 소스 리포지토리에 커밋(및 푸시)할 때 트리거가 워크플로 실행을 시작했습니다.

진행 중인 워크플로 실행을 보려면

1. CodeCatalyst 콘솔의 탐색 창에서 CI/CD를 선택한 다음 워크플로를 선택합니다.

2. 방금 생성한 codecatalyst-eks-workflow 워크플로를 선택합니다.

3. BuildBackend를 선택하여 빌드 진행 상황을 확인합니다.

4. DeployToEKS를 선택하여 배포 진행 상황을 확인합니다.

   실행 세부 정보 보기에 대한 자세한 내용은 워크플로 실행 상태 및 세부 정보 보기를 참조하세요.

배포를 확인하려면

1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

2. 왼쪽 하단에서 로드 밸런서를 선택합니다.

3. Kubernetes 배포의 일부로 생성된 로드 밸런서를 선택합니다. 선택할 로드 밸런서가 확실하지 않은 경우 태그 탭에서 다음 태그를 찾습니다.

   • kubernetes.io/service-name

   • kubernetes.io/cluster/ekstutorialcluster

4. 올바른 로드 밸런서를 선택한 상태에서 설명 탭을 선택합니다.

5. DNS 이름 값을 복사하여 브라우저의 주소 표시줄에 붙여 넣습니다.

   “Hello World!” 웹페이지가 브라우저에 표시되며 애플리케이션을 성공적으로 배포했음을 나타냅니다.

index.html을 변경하려면

1. 개발 환경으로 이동합니다.

2. 터미널 프롬프트에서 소스 리포지토리로 변경합니다.

   cd /projects/codecatalyst-eks-source-repository

3. 최신 워크플로 변경 사항 가져오기:

   git pull

4. codecatalyst-eks-source-repository/public-html/index.html를 엽니다.

5. 14행에서 Hello, World! 텍스트를 Tutorial complete!로 변경합니다.

6. 추가, 커밋 및 푸시:

   git add .
   git commit -m "update index.html title"
   git push

   워크플로 실행이 자동으로 시작됩니다.

7. (선택 사항) 다음을 입력합니다.

   git show HEAD

   index.html 변경 사항에 대한 커밋 ID를 기록해 둡니다. 이 커밋 ID는 방금 시작한 워크플로 실행에 의해 배포될 Docker 이미지에 태그가 지정됩니다.

8. 배포 진행 상황 보기:

   1. CodeCatalyst 콘솔의 탐색 창에서 CI/CD를 선택한 다음 워크플로를 선택합니다.

   2. 최신 실행을 보려면 codecatalyst-eks-workflow를 선택합니다.

   3. BuildBackend 및 DeployToEKS를 선택하여 워크플로 실행 진행 상황을 확인합니다.

9. 다음과 같이 애플리케이션이 업데이트되었는지 확인합니다.

   1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

   2. 왼쪽 하단에서 로드 밸런서를 선택합니다.

   3. Kubernetes 배포의 일부로 생성된 로드 밸런서를 선택합니다.

   4. DNS 이름 값을 복사하여 브라우저의 주소 표시줄에 붙여 넣습니다.

      ‘자습서가 완료되었습니다!’ 웹 페이지가 브라우저에 나타나 애플리케이션의 새 버전을 성공적으로 배포했음을 나타냅니다.

10. (선택 사항)에서 Amazon ECR 콘솔로 AWS전환하고 새 Docker 이미지에 이 절차의 7단계에서 커밋 ID가 태그 지정되었는지 확인합니다.

정리하려면

1. 클러스터 삭제:

   1. 개발 환경 터미널에 다음을 입력합니다.

      eksctl delete cluster --region=us-west-2 --name=codecatalyst-eks-cluster

      위치:

      • us-west-2를 해당 리전으로 바꿉니다.

      • codecatalyst-eks-cluster는 생성한 클러스터의 이름으로 대체됩니다.

      5~10분이 지나면 AWS CloudFormation 스택, 노드 그룹(Amazon EC2) 및 로드 밸런서를 포함하되 이에 국한되지 않는 클러스터 및 관련 리소스가 삭제됩니다.

   중요

   eksctl delete cluster 명령이 작동하지 않으면 AWS 자격 증명 또는 kubectl 보안 인증 정보를 새로 고쳐야 할 수 있습니다. 어떤 자격 증명을 새로 고칠지 확실하지 않은 경우 먼저 AWS 자격 증명을 새로 고칩니다. AWS 자격 증명을 새로 고치려면 'Unable to locate credentials' 및 'ExpiredToken' 오류를 해결하려면 어떻게 해야 하나요? 섹션을 참조하세요. kubectl 자격 증명을 새로 고치려면 'Unable to connect to the server' 오류를 해결하려면 어떻게 해야 하나요? 섹션을 참조하세요.

2. AWS 콘솔에서 다음과 같이 정리합니다.

   1. Amazon ECR에서 codecatalyst-eks-image-repo를 삭제합니다.

   2. IAM Identity Center에서 다음을 삭제합니다.

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. IAM에서 다음을 삭제합니다.

      • codecatalyst-eks-build-role

      • codecatalyst-eks-deploy-role

      • codecatalyst-eks-build-policy

      • codecatalyst-eks-deploy-policy

3. CodeCatalyst 콘솔에서 다음과 같이 정리합니다.

   1. codecatalyst-eks-workflow를 삭제합니다.

   2. codecatalyst-eks-environment를 삭제합니다.

   3. codecatalyst-eks-source-repository를 삭제합니다.

   4. 개발 환경을 삭제합니다.

   5. codecatalyst-eks-project를 삭제합니다.