GitHub Actions를 사용하여AKS(Azure Kubernetes Service)에 컨테이너 빌드, 테스트 및 배포

GitHub Actions를 사용하면 자동화된 소프트웨어 개발 수명 주기 워크플로를 유연성 있게 빌드할 수 있습니다. 여러 Kubernetes 작업을 사용하여 GitHub Actions를 통해 ACR(Azure Container Registry)에서 AKS(Azure Kubernetes Service)로 컨테이너에 배포할 수 있습니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 계정이 없으면 무료 계정을 만듭니다.
• GitHub 계정. 없는 경우 평가판에 등록하세요.
  • GitHub Actions을 사용하는 경우 Azure와 GitHub 리포지토리 간의 통합을 구성해야 합니다. 통합을 구성하려면 GitHub Actions를 사용하여 Azure에 연결을 참조하세요.
• ACR이 연결된 기존 AKS 클러스터입니다. 없는 경우에는 AKS에서 ACR로 인증을 참조하세요.

AKS에 대한 GitHub Actions

GiHub Actions를 사용하면 GitHub 내에서 소프트웨어 개발 워크플로를 자동화할 수 있습니다. 자세한 내용은 Azure용 GitHub Actions을 참조하세요.

다음 표에는 AKS에 사용 가능한 작업이 나열되어 있습니다.

AKS와 함께 GitHub Actions 사용

예를 들어 GitHub 리포지토리에 변경 내용이 푸시될 때마다 GitHub Actions을 사용하여 AKS 클러스터에 애플리케이션을 배포할 수 있습니다. 이 예에서는 Azure Vote 애플리케이션을 사용합니다.

리포지토리 포크 및 업데이트

1. Azure Vote 리포지토리로 이동하여 포크를 선택합니다.

2. azure-vote-front 이미지에 ACR을 사용하려면 azure-vote-all-in-one-redis.yaml을 업데이트합니다. <registryName>을 레지스트리 이름으로 바꿉니다.

   ...
         containers:
         - name: azure-vote-front
           image: <registryName>.azurecr.io/azuredocs/azure-vote-front:v1
   ...
   

3. 업데이트된 azure-vote-all-in-one-redis.yaml을 리포지토리에 커밋합니다.

비밀 만들기

1. az ad sp create-for-rbac 명령을 사용하여 Contributor 역할로 리소스 그룹에 액세스할 서비스 주체를 만듭니다. <SUBSCRIPTION_ID>를 Azure 계정의 구독 ID로 바꾸고, <RESOURCE_GROUP>을 ACR이 포함된 리소스 그룹의 이름으로 바꿉니다.

   az ad sp create-for-rbac \
       --name "ghActionAzureVote" \
       --scope /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP> \
       --role Contributor \
       --json-auth
   

   출력은 다음 예제 출력과 비슷하게 됩니다.

   {
     "clientId": <clientId>,
     "clientSecret": <clientSecret>,
     "subscriptionId": <subscriptionId>,
     "tenantId": <tenantId>,
     ...
   }
   

2. GitHub 리포지토리 설정으로 이동하여 보안>비밀 및 변수>작업을 선택합니다.

3. 각 비밀에 대해 새 리포지토리 비밀를 선택하고 비밀의 이름과 값을 입력합니다.

   비밀 이름	비밀 값
   AZURE_CREDENTIALS	az ad sp create-for-rbac 명령의 전체 JSON 출력입니다.
   service_principal	<clientId>의 값
   service_principal_password	<clientSecret>의 값
   구독	<subscriptionId>의 값
   tenant	<tenantId>의 값
   사용된	레지스트리 이름입니다.
   리포지토리	azuredocs
   resource_group	리소스 그룹의 이름입니다.
   cluster_name	클러스터의 이름입니다.

비밀 만들기에 대한 자세한 내용은 암호화된 비밀를 참조하세요.

작업 파일 만들기

1. 리포지토리에서 .github/workflows/main.yml을 만들고 다음 콘텐츠를 붙여넣습니다.

   name: build_deploy_aks
   on:
     push:
       paths:
         - "azure-vote/**"
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout source code 
           uses: actions/checkout@v3
         - name: ACR build
           id: build-push-acr
           uses: azure/acr-build@v1
           with:
             service_principal: ${{ secrets.service_principal }}
             service_principal_password: ${{ secrets.service_principal_password }}
             tenant: ${{ secrets.tenant }}
             registry: ${{ secrets.registry }}
             repository: ${{ secrets.repository }}
             image:  azure-vote-front
             folder: azure-vote
             branch: master
             tag: ${{ github.sha }}
         - name: Azure login
           id: login
           uses: azure/login@v1.4.3
           with:
             creds: ${{ secrets.AZURE_CREDENTIALS }}
         - name: Set AKS context
           id: set-context
           uses: azure/aks-set-context@v3
           with:
             resource-group: '${{ secrets.resource_group }}' 
             cluster-name: '${{ secrets.cluster_name }}'
         - name: Setup kubectl
           id: install-kubectl
           uses: azure/setup-kubectl@v3
         - name: Deploy to AKS
           id: deploy-aks
           uses: Azure/k8s-deploy@v4
           with:
             namespace: 'default'
             manifests: |
                azure-vote-all-in-one-redis.yaml
             images: '${{ secrets.registry }}.azurecr.io/${{ secrets.repository }}/azure-vote-front:${{ github.sha }}'
             pull-images: false 
   

   on 섹션에는 작업을 트리거하는 이벤트가 포함됩니다. 파일 예에서는 변경 내용이 azure-vote 디렉터리에 푸시될 때 작업이 트리거됩니다.

   steps 섹션에는 각각의 고유한 작업이 포함되어 있습니다.

   1. Checkout 소스 코드는 GitHub Actions Checkout Action을 사용하여 리포지토리를 복제합니다.
   2. ACR 빌드는 Azure Container Registry 빌드 작업을 사용하여 이미지를 빌드하고 레지스트리에 업로드합니다.
   3. Azure 로그인은 Azure 로그인 작업을 사용하여 Azure 계정에 로그인합니다.
   4. AKS 컨텍스트 설정은 Azure AKS 컨텍스트 설정 작업을 사용하여 AKS 클러스터에 대한 컨텍스트를 설정합니다.
   5. Setup kubectl은 Azure AKS Setup Kubectl Action을 사용하여 실행기에 kubectl을 설치합니다.
   6. AKS에 배포는 Azure Kubernetes 배포 작업을 사용하여 애플리케이션을 Kubernetes 클러스터에 배포합니다.

2. .github/workflows/main.yml 파일을 리포지토리에 커밋합니다.

3. 작업이 작동하는지 확인하려면 다음 콘텐츠로 azure-vote/azure-vote/config_file.cfg를 업데이트합니다.

   # UI Configurations
   TITLE = 'Azure Voting App'
   VOTE1VALUE = 'Fish'
   VOTE2VALUE = 'Dogs'
   SHOWHOST = 'false'
   

4. 업데이트된 azure-vote/azure-vote/config_file.cfg을 리포지토리에 커밋합니다.

5. 리포지토리에서 작업을 선택하고 워크플로가 실행 중인지 확인합니다. 그런 다음 워크플로에 녹색 확인 표시가 있고 업데이트된 애플리케이션이 클러스터에 배포되었는지 확인합니다.

다음 단계

AKS에 대한 다음 스타터 워크플로를 검토합니다. 자세한 내용은 시작 워크플로 사용을 참조하세요.

• Azure Kubernetes Service(기본)
• Azure Kubernetes Service Helm
• Azure Kubernetes Service Kustomize
• Azure Kubernetes Service Kompose