학습 과정: 확장 가능한 애플리케이션 - 구성 동기화로 변경사항 중앙화

클러스터 만들기

이 시리즈의 첫 번째 튜토리얼에서는 클러스터 하나를 만들고 Cymbal Bank 애플리케이션을 클러스터에 배포했습니다. 실제 시나리오에서는 클러스터 하나만 관리할 가능성이 거의 없습니다. GKE를 사용하면 함께 관리할 수 있는 논리적 클러스터 그룹인 Fleet에서 클러스터를 그룹화할 수 있습니다. Fleet 내에서 다른 환경을 나타내거나 다른 팀에 속하는 일부 클러스터로 클러스터를 추가로 그룹화할 수 있습니다. 예를 들어 개발 클러스터, 스테이징 클러스터, 프로덕션 클러스터가 있을 수 있습니다. 대규모 조직에서는 개별 팀에 여러 환경에 맞는 자체 클러스터가 있을 수 있습니다. 즉, IT 관리자나 운영자는 수십 개의 클러스터를 관리해야 할 수도 있습니다.

이러한 모든 클러스터에 애플리케이션 또는 커스텀 정책과 같은 개별 리소스를 배포할 때 구성 동기화와 같은 GKE Enterprise 기능을 사용하면 이러한 배포를 대규모로 관리할 수 있습니다.

리소스를 여러 환경에 또는 클러스터 Fleet 전체에 배포하는 방법을 보여주기 위해 새 클러스터를 만들고 Cymbal Bank 애플리케이션을 클러스터에 배포합니다.

1. 개발 환경을 시뮬레이션하는 GKE 클러스터를 만듭니다.

   gcloud container clusters create-auto scalable-apps-dev \
     --project=PROJECT_ID \
     --region=REGION \
     --fleet-project=PROJECT_ID \
     --release-channel=rapid
   

   다음을 바꿉니다.

   • PROJECT_ID를 이전 섹션에서 만든 프로젝트의 자동 생성 ID로 바꿉니다. 프로젝트 ID는 프로젝트 이름과 다른 경우가 많습니다. 예를 들어 프로젝트가 scalable-apps일 수 있지만 프로젝트 ID는 scalable-apps-567123일 수 있습니다.
   • REGION을 클러스터를 만들 리전으로 바꿉니다(예: us-central1).

2. 라벨은 리소스를 구성하는 데 도움이 되도록 GKE 리소스에 추가하는 키-값 쌍입니다. Fleet 패키지의 경우 Fleet 멤버십 라벨을 사용하여 Fleet 패키지가 타겟팅하는 클러스터를 맞춤설정할 수 있습니다. 다른 유형의 라벨은 지원되지 않습니다.

   Fleet 멤버십에 라벨을 추가합니다.

   gcloud container fleet memberships update scalable-apps-dev \
       --update-labels=env=dev
   

   이 튜토리얼의 후반부에서 Fleet 패키지를 만들 때 이 라벨은 리소스가 이 시리즈의 첫 번째 튜토리얼의 scalable-apps 클러스터가 아닌 scalable-apps-dev 클러스터에만 배포되도록 합니다.

구성 동기화 설치

두 클러스터 모두에 구성 동기화를 설치합니다.

1. Google Cloud 콘솔에서 기능 섹션 아래의 구성 페이지로 이동합니다.

   구성으로 이동

2. add 구성 동기화 설치를 클릭합니다.
3. 수동 업그레이드를 선택한 상태를 유지합니다.
4. 버전 메뉴는 기본적으로 최신 버전의 구성 동기화로 설정됩니다. 필요한 경우 최신 버전을 선택합니다.
5. 설치 옵션에서 전체 Fleet에 구성 동기화 설치(권장)를 선택합니다.
6. 구성 동기화 설치를 클릭합니다.
7. 구성 동기화의 설정 탭에서 클러스터 목록의 상태 필드를 살펴봅니다. 몇 분 후 클러스터가 구성 동기화에 대해 올바르게 구성될 때까지 상태가 '대기 중'으로 표시됩니다. 상태가 사용 설정됨으로 변경되는 데 최대 10분이 걸릴 수 있습니다.

Cymbal Bank 배포

이 시리즈의 첫 번째 튜토리얼에서는 kubectl 명령어를 사용하여 애플리케이션 구성을 클러스터에 적용했습니다. 이 튜토리얼에서는 구성 동기화의 Fleet 패키지 기능을 사용하여 같은 구성을 새 클러스터에 배포합니다. 이후 섹션에서는 새 리소스를 Git 저장소에 추가하고 클러스터의 Fleet 전체에 배포하는 방법의 예시를 보여줍니다.

Cloud Build용 서비스 계정 설정

서비스 계정은 사용자가 아닌 애플리케이션에서 일반적으로 사용하는 특별한 종류의 계정입니다. 서비스 계정을 만들 때는 단일 특정 서비스나 태스크에 대한 서비스 계정을 만들고 서비스 계정에 세분화된 역할을 부여하는 것이 좋습니다. 이 튜토리얼에서는 서비스 계정을 만들어 Cloud Build에 Git 저장소에서 Kubernetes 리소스를 가져와 클러스터에 배포할 수 있는 권한을 부여합니다.

서비스 계정을 만들고 필요한 권한을 부여하려면 다음 단계를 완료합니다.

1. 서비스 계정을 만듭니다.

   gcloud iam service-accounts create "cymbal-bank-service-account"
   

2. 리소스 번들 게시자 역할에 대한 IAM 정책 바인딩을 추가하여 서비스 계정에 Git 저장소에서 리소스를 가져올 수 있는 권한을 부여합니다.

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:cymbal-bank-service-account@PROJECT_ID.iam.gserviceaccount.com" \
      --role='roles/configdelivery.resourceBundlePublisher'
   

   메시지가 표시되면 정책 조건으로 None을 선택합니다.

3. 로그 작성자 역할에 대한 IAM 정책 바인딩을 추가하여 서비스 계정에 로그를 작성할 수 있는 권한을 부여합니다.

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:cymbal-bank-service-account@PROJECT_ID.iam.gserviceaccount.com" \
      --role='roles/logging.logWriter'
   

   메시지가 표시되면 정책 조건으로 None을 선택합니다.

Cymbal Bank 애플리케이션의 출시 버전 만들기

Fleet 패키지를 사용하려면 배포할 저장소의 버전을 알 수 있는 시맨틱 버전 태그가 필요합니다. 저장소를 변경할 때 새 출시 버전을 만드는 것이 좋습니다. 이렇게 하면 버전 제어에 도움이 되고 필요한 경우 안정화 버전으로 쉽게 롤백할 수 있기 때문입니다.

1. Cymbal Bank의 GitHub 포크 웹브라우저 창에서 사이드바의 출시 버전 섹션 아래에 있는 새 출시 버전 만들기를 클릭합니다.

2. 태그 선택 메뉴를 선택하고 태그로 v1.0.0을 입력합니다. 새 태그 만들기를 클릭합니다.

3. 출시 버전 게시를 클릭합니다.

인증 설정

이 시리즈의 첫 번째 튜토리얼과 같이 사용자 인증을 처리할 JWT와 만든 새 클러스터의 JWT를 저장할 Kubernetes 보안 비밀을 만들어야 합니다. 클러스터마다 인증을 위한 고유한 JWT가 있는 것이 좋습니다.

1. Cloud Shell에서 JWT를 만듭니다.

   openssl genrsa -out jwtRS256.key 4096
   openssl rsa -in jwtRS256.key -outform PEM -pubout -out jwtRS256.key.pub
   

2. Kubernetes 보안 비밀을 만듭니다.

   kubectl create secret generic jwt-key --from-file=./jwtRS256.key --from-file=./jwtRS256.key.pub
   

Fleet 패키지로 Cymbal Bank 애플리케이션 배포

FleetPackage 리소스는 여러 Kubernetes 매니페스트를 클러스터 Fleet에 배포하는 선언적 API입니다.

Fleet 패키지를 만들려면 Cloud Build에 연결된 Kubernetes 리소스가 있는 저장소를 가리키는 FleetPackage 사양을 정의합니다. 그런 다음 Git에서 리소스를 가져와 Fleet 전체에 배포하는 FleetPackage 리소스를 적용합니다.

1. Cloud Shell에서 configdelivery Google Cloud CLI 명령어 기본 위치를 설정합니다. 저장소를 Cloud Build에 연결할 때와 마찬가지로 Fleet 패키지 기능이 미리보기 상태인 동안에 us-central1을 사용해야 합니다.

   gcloud config set config_delivery/location us-central1
   

2. 다음 콘텐츠로 fleetpackage-spec.yaml이라는 파일을 만듭니다.

   resourceBundleSelector:
     cloudBuildRepository:
       name: projects/PROJECT_ID/locations/us-central1/connections/cymbal-bank-connection/repositories/REPOSITORY_NAME
       tag: v1.0.0
       serviceAccount: projects/PROJECT_ID/serviceAccounts/cymbal-bank-service-account@PROJECT_ID.iam.gserviceaccount.com
       path: kubernetes-manifests
   target:
     fleet:
       project: projects/PROJECT_ID
       selector:
         matchLabels:
           env: dev
   rolloutStrategy:
     rolling:
       maxConcurrent: 1
   

   REPOSITORY_NAME을 Cloud Build 연결에 표시된 저장소 이름으로 바꿉니다.

   선택기 필드는 이전에 만든 Fleet 멤버십 라벨과 일치합니다. 이를 통해 Cymbal Bank 애플리케이션이 scalable-apps-dev 클러스터에만 배포됩니다. 첫 번째 튜토리얼의 scalable-apps 클러스터는 영향을 받지 않습니다. 다음 섹션에서는 Fleet의 모든 클러스터를 타겟팅하는 Fleet 패키지의 예시를 보여줍니다.

   출시 전략 필드는 리소스가 클러스터 전체에 배포되는 방식을 제어합니다. 이 예시에서는 클러스터 하나에만 배포하므로 이 필드로 출시 진행 방식이 변경되지는 않습니다. 하지만 클러스터가 많이 있는 경우 이 설정을 사용하면 리소스 파일이 다음 클러스터로 이동하기 전에 클러스터 하나에 모두 적용됩니다. 이를 통해 출시 진행 상황을 모니터링할 수 있습니다.

3. Fleet 패키지를 만듭니다.

   gcloud alpha container fleet packages create cymbal-bank-fleet-package \
       --source=fleetpackage-spec.yaml \
       --project=PROJECT_ID
   

4. Fleet 패키지가 생성되었는지 확인합니다.

   gcloud alpha container fleet packages list
   

   출력에 빌드 트리거 상태가 나열됩니다. 몇 초 후 MESSAGE 필드가 다음과 유사한 출력으로 업데이트됩니다.

   MESSAGES: Build status: WORKING. The release is still being built; see the build status on the following page:
   

   제공된 링크를 클릭하면 Cloud Build 작업의 스트리밍 로그를 볼 수 있습니다. Cloud Build에서 빌드 트리거를 처리하는 데 몇 분 정도 걸릴 수 있습니다.

5. 빌드 트리거가 성공적으로 완료되면 gcloud alpha container fleet packages list 출력은 다음과 비슷합니다.

   NAME: cymbal-bank-fleet-package
   STATE: ACTIVE
   CREATE_TIME: 2024-07-09T15:15:56
   ACTIVE_ROLLOUT: rollout-20240709-153621
   LAST_COMPLETED_ROLLOUT:
   MESSAGES:
   

   Fleet 패키지가 Fleet 전체에서 Kubernetes 리소스를 출시하기 시작합니다.

6. Google Cloud 콘솔의 Google Kubernetes Engine 페이지에서 scalable-apps-dev 클러스터를 선택한 후 워크로드 페이지로 이동하여 모든 GKE 클러스터에 배포 중인 워크로드의 집계된 뷰를 확인합니다.

   워크로드 페이지 열기

   Autopilot에서 리소스 요청이 충족되도록 포드를 조정하는 동안 몇 가지 오류가 표시될 수 있습니다. 몇 분 후 포드가 OK 상태로 실행되기 시작합니다.

7. Cymbal Bank 웹 인터페이스를 보려면 다음 단계를 완료합니다.

   1. Google Cloud 콘솔의 Google Kubernetes Engine 페이지에서 게이트웨이, 서비스, 인그레스 페이지로 이동합니다.

      게이트웨이, 서비스, 인그레스 페이지로 이동

   2. Cymbal Bank 인그레스를 찾으려면 '서비스' 탭을 클릭하고 frontend 서비스를 찾습니다.

   3. 198.51.100.143:80과 같은 frontend 인그레스의 엔드포인트 링크를 클릭하여 Cymbal Bank 웹 인터페이스를 엽니다.

Fleet 전체에 리소스 배포

다음으로, 새로운 마이크로서비스로 Cymbal Bank 애플리케이션을 확장하려는 시나리오를 가정해 보겠습니다. 현재의 모든 클러스터와 향후 Fleet에 추가될 모든 클러스터에 이 마이크로서비스를 배포하려고 합니다. Fleet 패키지를 사용하면 여러 클러스터에 배포하고 새 클러스터에 자동으로 배포할 수 있습니다.

Git 저장소에 새 리소스 추가

새 서비스를 애플리케이션에 추가하는 방법을 보여주기 위해 기본 nginx 배포를 만들고 클러스터에 추가합니다.

1. Cymbal Bank GitHub 포크 웹브라우저 창에서 파일 추가를 선택한 후 새 파일 만들기를 선택합니다.

2. 파일 이름을 new-resource/nginx.yaml로 지정하고 다음 콘텐츠를 붙여넣습니다.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - image: nginx:1.14.2
           name: nginx
           ports:
           - containerPort: 80
   

3. 변경사항 커밋을 클릭합니다.

4. 확인 대화상자에서 main 브랜치에 직접 커밋을 선택한 상태로 유지하고 변경사항 커밋을 클릭합니다.

5. 포크된 Cymbal Bank 저장소의 기본 페이지에 있는 사이드바에서 출시 버전을 선택합니다.

6. 페이지 상단에서 새 출시 버전 초안 작성을 선택합니다.

7. 태그 선택 메뉴를 선택하고 태그로 v1.1.0을 입력합니다. 새 태그 만들기를 클릭합니다.

8. 출시 버전 게시를 클릭합니다.

Fleet 패키지를 사용하여 클러스터에 리소스 배포

새 리소스를 배포하려면 새 Fleet 패키지를 만듭니다.

1. 이 Fleet 패키지는 선택기 필드를 포함하지 않으므로 Fleet의 모든 클러스터를 타겟팅합니다. 즉, 향후 Fleet에 추가될 클러스터에 nginx 배포가 자동으로 추가됩니다.

   Cloud Shell에서 다음 콘텐츠가 포함된 new-deployment-fleet-package.yaml 파일을 만듭니다.

   resourceBundleSelector:
     cloudBuildRepository:
       name: projects/PROJECT_ID/locations/us-central1/connections/cymbal-bank-connection/repositories/REPOSITORY_NAME
       tag: v1.1.0
       serviceAccount: projects/PROJECT_ID/serviceAccounts/cymbal-bank-service-account@PROJECT_ID.iam.gserviceaccount.com
       path: kubernetes-manifests/new-resource
   target:
     fleet:
       project: projects/PROJECT_ID
   rolloutStrategy:
     rolling:
       maxConcurrent: 1
   

2. 출시를 시작할 Fleet 패키지를 만듭니다.

   gcloud alpha container fleet packages create new-deployment-fleet-package \
       --source=new-deployment-fleet-package.yaml \
       --project=PROJECT_ID
   

3. Fleet 패키지가 생성되었는지 확인합니다.

   gcloud alpha container fleet packages list
   

   제공된 링크를 클릭하면 Cloud Build 작업의 스트리밍 로그를 볼 수 있습니다.

   Fleet 패키지가 Fleet 전체에서 Kubernetes 리소스를 출시하기 시작합니다. 출시가 시작되어 완료되는 데 몇 분 정도 걸릴 수 있습니다.

4. Google Cloud 콘솔의 Google Kubernetes Engine 페이지에서 워크로드 페이지로 이동하여 모든 GKE 클러스터에 배포되는 워크로드의 집계된 뷰를 확인합니다.

   워크로드 페이지 열기

Fleet 패키지를 사용하여 다양한 배포 전략을 계속 살펴볼 수 있습니다. 예를 들어 다양한 유형의 리소스를 포크된 저장소에 추가하고 다양한 Fleet 패키지 구성을 사용하여 배포해 볼 수 있습니다. 또한 Fleet 패키지를 사용하여 클러스터 전체에 배포된 모든 리소스를 삭제할 수 있습니다. Fleet 패키지에 대한 자세한 내용은 구성 동기화 문서의 Fleet 패키지 배포를 참조하세요.

Fleet 전체에서 리소스 삭제

리소스를 Fleet 전체에 배포할 수 있는 것처럼 Fleet 패키지를 사용하여 Fleet 전체에서 리소스를 삭제할 수 있습니다.

개별 리소스를 삭제하는 대략적인 단계는 다음과 같습니다.

1. Git 저장소에서 리소스를 삭제합니다.
2. 새 Git 출시 버전을 만들고 새 태그를 만듭니다.
3. Fleet 패키지 tag 필드를 업데이트합니다.
4. Fleet 패키지 업데이트 명령어를 실행합니다.

또는 Fleet 패키지 자체를 삭제할 수 있습니다. 그러면 Fleet 패키지에서 관리한 모든 리소스도 삭제됩니다.

예를 들어 이전 섹션의 nginx 배포를 삭제하려면 다음 명령어를 실행합니다.

gcloud alpha container fleet packages delete new-deployment-fleet-package --force