다음을 통해 공유

GitHub Actions를 사용하여 AKS(Azure Kubernetes Service) 노드에 자동 보안 업그레이드 적용

  • 아티클

보안 업데이트는 AKS 클러스터의 보안을 유지하고 기본 OS에 대한 최신 수정 사항을 준수하는 데 중요한 부분입니다. 이러한 업데이트는 OS 보안 수정 사항 또는 커널 업데이트를 포함합니다. 일부 업데이트는 프로세스를 완료하도록 노드를 다시 부팅해야 합니다.

이 문서에서는 GitHub Actions 및 Azure CLI를 사용하여 AKS 노드의 업데이트 프로세스를 자동화하여 자동으로 실행되는 cron 기반 업데이트 작업을 만드는 방법을 보여 줍니다.

참고 항목

또한 노드 이미지 업그레이드를 자동으로 수행하고 계획된 유지 관리를 사용하여 이러한 업그레이드를 예약할 수도 있습니다. 자세한 내용은 노드 이미지 자동 업그레이드를 참조하세요.

시작하기 전에

  • 이 문서에서는 기존 AKS 클러스터가 있다고 가정합니다. AKS 클러스터가 필요한 경우 Azure CLI, Azure PowerShell 또는 Azure Portal을 사용하여 만듭니다.
  • 또한 이 문서에서는 작업을 호스팅할 GitHub 계정과 프로필 리포지토리가 있다고 가정합니다. 리포지토리가 없으면 GitHub 사용자 이름과 동일한 이름으로 리포지토리를 만듭니다.
  • Azure CLI 2.0.59 이상 버전을 설치하고 구성해야 합니다. az --version을 실행하여 버전을 찾습니다. 설치 또는 업그레이드해야 하는 경우 Azure CLI 설치를 참조하세요.

az aks upgrade로 노드 업데이트

az aks upgrade 명령은 가동 중지 시간 없이 업데이트를 적용할 수 있는 방법을 제공합니다. 명령을 실행하면 다음 작업이 수행됩니다.

  1. 모든 클러스터 노드에 최신 업데이트를 적용합니다.
  2. 노드로 트래픽을 차단(새 워크로드 예약에 해당 노드를 사용할 수 없도록 설정)하고 트래픽을 드레이닝(기존 워크로드를 다른 노드로 이동)합니다.
  3. 노드를 다시 시작합니다.
  4. 업데이트된 노드가 트래픽을 다시 수신할 수 있도록 합니다.

다른 방법을 사용하여 노드를 업데이트하는 경우 AKS는 노드를 자동으로 다시 시작하지 않습니다.

참고 항목

--node-image-only 플래그와 함께 az aks upgrade를 실행하면 노드 이미지만 업그레이드됩니다. 플래그 없이 명령을 실행하면 노드 이미지와 Kubernetes 컨트롤 플레인 버전이 모두 업그레이드됩니다. 자세한 내용은 노드의 관리 업그레이드 문서 및 클러스터 업그레이드 문서를 참조하세요.

모든 Kubernetes 노드는 표준 Windows 또는 Linux 기반 Azure VM(Virtual Machines)에서 실행됩니다. 이러한 Linux 기반 VM은 Ubuntu 이미지를 사용하며, 해당 OS는 매일 밤 업데이트를 자동으로 확인하도록 구성됩니다.

az aks upgrade 명령을 사용하면 Azure CLI는 최신 보안 및 커널 업데이트를 통해 새 노드의 급증을 만듭니다. 이러한 새 노드는 업데이트가 완료될 때까지 앱이 예약되지 않도록 처음에는 차단됩니다. 업데이트가 완료되면 Azure는 전송 노드를 차단 및 비우고 새 노드를 차단 해제하여 예약된 모든 애플리케이션을 새 노드로 전송합니다.

이 프로세스는 Linux 기반 커널을 수동으로 업데이트하는 것보다 더 나은 방법입니다. 새 커널 업데이트를 설치하면 Linux를 다시 부팅해야 하기 때문입니다. OS를 수동으로 업데이트하는 경우에도 VM을 다시 부팅하고 모든 앱을 수동으로 통제 및 드레이닝해야 합니다.

시간이 정해진 GitHub 작업 만들기

cron은 자동화된 일정에 따라 명령 세트 또는 작업을 실행할 수 있는 유틸리티입니다. 자동화된 일정에 따라 AKS 노드를 업데이트하는 작업을 만들려면 작업을 호스트할 리포지토리가 필요합니다. GitHub Actions는 일반적으로 애플리케이션과 동일한 리포지토리에 구성되지만 어떤 리포지토리도 사용할 수 있습니다.

  1. GitHub에서 리포지토리로 이동합니다.

  2. 작업을 선택합니다.

  3. 새 워크플로>직접 워크플로 설정을 선택합니다.

  4. 15일마다 오전 3시에 실행되도록 예약 트리거를 사용하여 클러스터 노드 이미지 업그레이드라는 GitHub 작업을 만듭니다. 다음 코드를 YAML에 복사합니다.

    name: Upgrade cluster node images
on:
  schedule:
    - cron: '0 3 */15 * *'

  5. Ubuntu 에이전트에서 실행되고 Azure CLI 계정에 연결하여 노드 업그레이드 명령을 실행하는 upgrade-node라는 작업을 만듭니다. 다음 코드를 YAML의 on 키 아래에 복사합니다.

    jobs:
  upgrade-node:
    runs-on: ubuntu-latest

워크플로에서 Azure CLI 설정

  1. Marketplace에서 작업 검색 표시줄에서 Azure 로그인을 검색합니다.

  2. Azure 로그인을 선택합니다.

    첫 번째 작업을 'Azure 로그인'으로 표시하는 줄과 두 번째 작업을 'Azure Container Registry 로그인'으로 표시하는 줄을 포함하는 검색 결과

  3. 설치에서 v1.4.6과 같은 버전을 선택하고 설치 코드 조각을 복사합니다.

  4. 설치 코드 조각의 steps 키와 다음 정보를 YAML에 추가합니다.

    name: Upgrade cluster node images
on:
  schedule:
    - cron: '0 3 */15 * *'
jobs:
  upgrade-node:
    runs-on: ubuntu-latest
    steps:
      - name: Azure Login
        uses: Azure/login@v1.4.6
        with:
          creds: ${{ secrets.AZURE_CREDENTIALS }}

Azure CLI에 대한 자격 증명 만들기

  1. 새 브라우저 창에서 az ad sp create-for-rbac 명령을 사용하여 새 서비스 주체를 만듭니다. *{subscriptionID}*를 고유의 구독 ID로 바꿉니다.

    참고 항목

    이 예제에서는 구독 범위에서 Contributor 역할을 만듭니다. 사용자의 요구에 맞는 역할과 범위를 제공할 수 있습니다. 자세한 내용은 Azure 기본 제공 역할 및 Azure RBAC 범위 수준을 참조하세요.

    az ad sp create-for-rbac --role Contributor --scopes /subscriptions/{subscriptionID} -o json

    출력은 다음 출력 예와 유사해야 합니다.

    {
  "appId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "displayName": "xxxxx-xxx-xxxx-xx-xx-xx-xx-xx",
  "password": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "tenant": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

  2. 출력을 복사하고 GitHub 리포지토리로 이동합니다.

  3. 설정>비밀 및 변수>작업>새 리포지토리 비밀를 선택합니다.

  4. 이름에 AZURE_CREDENTIALS를 입력합니다.

  5. 비밀에는 서비스 주체를 만들 때 받은 출력 콘텐츠를 복사합니다.

  6. 비밀 추가를 선택합니다.

Azure CLI 명령을 실행하는 단계 만들기

  1. 워크플로 YAML이 있는 창으로 이동합니다.

  2. Marketplace에서 작업 검색 표시줄에서 Azure CLI 작업을 검색합니다.

  3. Azure CLI 작업을 선택합니다.

    Azure에서 만든 대로 첫 번째 결과가 표시된 'Azure CLI 작업'에 대한 검색 결과

  4. 설치에서 v1.0.8과 같은 버전을 선택하고 설치 코드 조각을 복사합니다.

  5. 다음 예와 유사하게 작업 콘텐츠를 *Azure Login* 단계 아래 YAML에 붙여넣습니다.

    name: Upgrade cluster node images
on:
  schedule:
    - cron: '0 3 */15 * *'
jobs:
  upgrade-node:
    runs-on: ubuntu-latest
    steps:
      - name: Azure Login
        uses: Azure/login@v1.4.6
        with:
          creds: ${{ secrets.AZURE_CREDENTIALS }}
      - name: Upgrade node images
        uses: Azure/cli@v1.0.8
        with:
          inlineScript: az aks upgrade --resource-group <resourceGroupName> --name <aksClusterName> --node-image-only --yes

    팁

    AZURE_CREDENTIALS에 대해 했던 것처럼 새 리포지토리 비밀을 만들어 명령에서 --resource-group 및 --name 매개 변수를 분리할 수 있습니다.

    이러한 매개 변수에 대한 비밀을 만드는 경우 <resourceGroupName> 및 <aksClusterName> 자리 표시자를 해당 비밀 항목으로 바꿔야 합니다. 예: ${{secrets.RESOURCE_GROUP_NAME}} 및 ${{secrets.AKS_CLUSTER_NAME}}

  6. YAML의 이름을 upgrade-node-images.yml로 바꿉니다.

  7. 변경 내용 커밋...을 선택하고 커밋 메시지를 추가한 다음 변경 내용 커밋을 선택합니다.

GitHub 작업을 수동으로 실행

workflow_dispatch라는 새 on 트리거를 추가하여 예약된 실행 외에도 워크플로를 수동으로 실행할 수 있습니다.

참고 항목

클러스터의 모든 노드 풀 대신 단일 노드 풀을 업그레이드하려면 az aks nodepool upgrade 명령에 --name 매개 변수를 추가하여 노드 풀 이름을 지정합니다. 예시:

az aks nodepool upgrade --resource-group <resourceGroupName> --cluster-name <aksClusterName> --name <nodePoolName> --node-image-only

  • on 키 아래에 workflow_dispatch 트리거를 추가합니다.

    name: Upgrade cluster node images
on:
  schedule:
    - cron: '0 3 */15 * *'
  workflow_dispatch:

    YAML은 다음 예와 유사해야 합니다.

        name: Upgrade cluster node images
    on:
      schedule:
        - cron: '0 3 */15 * *'
      workflow_dispatch:
    jobs:
      upgrade-node:
        runs-on: ubuntu-latest
        steps:
          - name: Azure Login
            uses: Azure/login@v1.4.6
            with:
              creds: ${{ secrets.AZURE_CREDENTIALS }}
          - name: Upgrade node images
            uses: Azure/cli@v1.0.8
            with:
              inlineScript: az aks upgrade -g {resourceGroupName} -n {aksClusterName} --node-image-only --yes
          # Code for upgrading one or more node pools

다음 단계

AKS 업그레이드에 대한 자세한 내용은 다음 문서 및 리소스를 참조하세요.

업그레이드 모범 사례 및 기타 고려 사항에 대한 자세한 내용은 AKS 패치 및 업그레이드 지침을 참조하세요.