자습서: 다른 프라이빗 컨테이너 레지스트리에서 기본 이미지가 업데이트될 때 컨테이너 이미지 빌드 자동화
ACR 작업은 기본 이미지 중 하나에서 OS 또는 애플리케이션 프레임워크를 패치할 때와 같이 컨테이너의 기본 이미지가 업데이트될 때 자동화되는 이미지 빌드를 지원합니다.
이 자습서에서는 컨테이너의 기본 이미지가 다른 Azure 컨테이너 레지스트리에 푸시될 때 클라우드에서 빌드를 트리거하는 ACR 작업을 만드는 방법에 대해 알아봅니다. 또한 기본 이미지가 동일한 Azure 컨테이너 레지스트리로 푸시될 때 이미지 빌드를 트리거하는 ACR 작업을 만드는 방법에 대한 자습서도 사용할 수 있습니다.
이 자습서에서:
- 기본 레지스트리에서 기본 이미지 빌드
- 기본 이미지를 추적하기 위해 다른 레지스트리에서 애플리케이션 빌드 작업 만들기
- 애플리케이션 이미지 작업을 트리거하도록 기본 이미지 업데이트
- 트리거된 작업 표시
- 업데이트된 애플리케이션 이미지 확인
필수 조건
이전 자습서 완료
이 자습서에서는 사용자가 이미 환경을 구성했고 시리즈의 처음 두 자습서의 단계를 이미 완료했다고 가정합니다.
- Azure 컨테이너 레지스트리 만들기
- 샘플 리포지토리 포크
- 샘플 리포지토리 복제
- GitHub 개인용 액세스 토큰 만들기
아직 수행하지 않은 경우 계속하기 전에 다음 자습서를 완료하세요.
자습서 - Azure Container Registry 작업을 사용하여 클라우드에 컨테이너 이미지 빌드
Azure Container Registry 작업을 사용하여 컨테이너 이미지 빌드 자동화
이전 자습서에서 만든 컨테이너 레지스트리 외에도 기본 이미지를 저장할 레지스트리를 만들어야 합니다. 원하는 경우 원래 레지스트리와 다른 위치에 두 번째 레지스트리를 만듭니다.
환경 구성
이러한 셸 환경 변수를 사용자 환경에 적합한 값으로 채웁니다. 이 단계는 반드시 필요한 것이 아니지만, 여러 줄로 된 Azure CLI 명령을 이 자습서에서 좀 더 쉽게 실행할 수 있게 합니다. 이러한 환경 변수를 채우지 않는 경우 명령 예제에 나타나는 각 값을 수동으로 바꿔야 합니다.
BASE_ACR=<base-registry-name> # The name of your Azure container registry for base images
ACR_NAME=<registry-name> # The name of your Azure container registry for application images
GIT_USER=<github-username> # Your GitHub user account name
GIT_PAT=<personal-access-token> # The PAT you generated in the second tutorial
기본 이미지 업데이트 시나리오
이 자습서에서는 기본 이미지 업데이트 시나리오를 안내합니다. 이 시나리오는 다른 레지스트리에서 애플리케이션 이미지를 만들 때 공용 프라이빗 컨테이너 레지스트리에서 기본 이미지를 관리하는 개발 워크플로를 반영하고 있습니다. 기본 이미지는 팀에서 사용하는 공통 운영 체제 및 프레임워크 또는 공통 서비스 구성 요소를 지정할 수 있습니다.
예를 들어 자체 레지스트리에서 애플리케이션 이미지를 개발하는 개발자는 공통 기본 레지스트리에서 유지 관리되는 기본 이미지 세트에 액세스할 수 있습니다. 기본 레지스트리는 다른 지역에 있거나 지리적으로 복제될 수도 있습니다.
코드 샘플에는 두 개의 Docker 파일, 즉 애플리케이션 이미지와 해당 애플리케이션에서 기본으로 지정하는 이미지가 포함되어 있습니다. 다음 섹션에서는 새 버전의 기본 이미지가 다른 Azure 컨테이너 레지스트리로 푸시될 때 애플리케이션 이미지의 빌드를 자동으로 트리거하는 ACR 작업을 만듭니다.
Dockerfile-app: 기반이 되는 Node.js 버전을 표시하는 정적 웹 페이지를 렌더링하는 작은 Node.js 웹 애플리케이션입니다. 버전 문자열이 시뮬레이션되며, 기본 이미지에 정의된
NODE_VERSION환경 변수의 내용을 표시합니다.Dockerfile-base:
Dockerfile-app에서 기본으로 지정하는 이미지. 이미지 자체는 노드 이미지를 기반으로 하며NODE_VERSION환경 변수를 포함합니다.
다음 섹션에서는 작업을 만들고, Dockerfile 기본 이미지의 NODE_VERSION 값을 업데이트한 다음, ACR 작업을 사용하여 기본 이미지를 빌드합니다. ACR 작업에서 새 기본 이미지를 레지스트리에 푸시하면 애플리케이션 이미지의 빌드가 자동으로 트리거됩니다. 필요에 따라 애플리케이션 컨테이너 이미지를 로컬로 실행하여 빌드된 이미지에 다른 버전 문자열을 표시합니다.
이 자습서의 ACR 작업은 Dockerfile에 지정된 애플리케이션 컨테이너 이미지를 빌드하고 푸시합니다. 또한 ACR 작업은 다단계 작업을 실행하고, YAML 파일을 사용하여 여러 컨테이너를 빌드하고, 푸시하고, 필요에 따라 테스트하는 단계를 정의할 수 있습니다.
기본 이미지 빌드
먼저 az acr build를 사용하여 빠른 작업 ACR 작업을 통해 기본 이미지를 빌드합니다. 시리즈의 첫 번째 자습서에서 설명한 대로 이 프로세스는 이미지를 빌드할 뿐만 아니라 빌드가 성공하면 컨테이너 레지스트리에 푸시합니다. 다음 예제에서는 이미지가 기본 이미지 레지스트리로 푸시됩니다.
az acr build --registry $BASE_ACR --image baseimages/node:15-alpine --file Dockerfile-base .
프라이빗 기본 이미지를 추적하는 작업 만들기
다음으로, az acr task create를 사용하여 애플리케이션 이미지 레지스트리에서 작업을 만들고, 관리 ID를 사용하도록 설정합니다. 관리 ID는 이후 단계에서 사용되어 작업에서 기본 이미지 레지스트리를 인증합니다.
다음 예제에서는 시스템이 할당한 ID를 사용하지만 특정 시나리오에 대해 사용자가 할당한 관리 ID를 만들고 사용하도록 설정할 수 있습니다. 자세한 내용은 Azure 관리 ID를 사용하는 ACR 작업의 레지스트리 간 인증을 참조하세요.
az acr task create \
--registry $ACR_NAME \
--name baseexample2 \
--image helloworld:{{.Run.ID}} \
--context https://github.com/$GIT_USER/acr-build-helloworld-node.git#main \
--file Dockerfile-app \
--git-access-token $GIT_PAT \
--arg REGISTRY_NAME=$BASE_ACR.azurecr.io \
--assign-identity
이 작업은 이전 자습서에서 만든 작업과 비슷합니다. 커밋이 --context에 지정된 리포지토리에 푸시될 때 ACR 작업에서 이미지 빌드를 트리거하도록 지시합니다. 이전 자습서에서 이미지를 빌드하는 데 사용한 Dockerfile에서 퍼블릭 기본 이미지(FROM node:15-alpine)를 지정하지만, 이 작업의 Dockerfile(dockerfile-app)에서는 기본 이미지 레지스트리에서 기본 이미지를 지정합니다.
FROM ${REGISTRY_NAME}/baseimages/node:15-alpine
이 구성을 통해 이 자습서의 뒷부분에서 기본 이미지의 프레임워크 패치를 쉽게 시뮬레이션할 수 있습니다.
기본 레지스트리에 ID 끌어오기 권한 부여
기본 이미지 레지스트리에서 이미지를 가져올 수 있는 작업의 관리 ID 권한을 부여하려면 먼저 az acr task show를 실행하여 ID의 서비스 주체 ID를 가져옵니다. 그런 다음, az acr show를 실행하여 기본 레지스트리의 리소스 ID를 가져옵니다.
# Get service principal ID of the task
principalID=$(az acr task show --name baseexample2 --registry $ACR_NAME --query identity.principalId --output tsv)
# Get resource ID of the base registry
baseregID=$(az acr show --name $BASE_ACR --query id --output tsv)
az role assignment create를 실행하여 관리 ID 끌어오기 권한을 레지스트리에 할당합니다.
az role assignment create \
--assignee $principalID \
--scope $baseregID --role acrpull
작업에 대상 레지스트리 자격 증명 추가
az acr task credential add를 실행하여 자격 증명을 작업에 추가합니다. --use-identity [system] 매개 변수를 전달하여 작업의 시스템이 할당한 관리 ID로 자격 증명에 액세스할 수 있음을 나타냅니다.
az acr task credential add \
--name baseexample2 \
--registry $ACR_NAME \
--login-server $BASE_ACR.azurecr.io \
--use-identity [system]
수동으로 작업 실행
az acr task run을 사용하여 작업을 수동으로 트리거하고 애플리케이션 이미지를 빌드합니다. 이 단계는 작업에서 기본 이미지에 대한 애플리케이션 이미지의 종속성을 추적하는 데 필요합니다.
az acr task run --registry $ACR_NAME --name baseexample2
작업이 완료된 후 다음의 선택적 단계를 수행하려면 실행 ID(예: "da6")를 적어 둡니다.
선택 사항: 로컬로 애플리케이션 컨테이너 실행
로컬(Cloud Shell이 아님)에서 작업 중이고 Docker가 설치되어 있는 경우, 기본 이미지를 다시 빌드하기 전에 컨테이너를 실행하여 웹 브라우저에서 렌더링된 애플리케이션을 확인합니다. Cloud Shell을 사용하는 경우 이 섹션을 건너뜁니다(Cloud Shell에서는 az acr login 또는 docker run을 지원하지 않음).
먼저 az acr login을 사용하여 컨테이너 레지스트리에 인증합니다.
az acr login --name $ACR_NAME
이제 docker run을 사용하여 컨테이너를 로컬로 실행합니다. <run-id>를 이전 단계의 출력에 있는 실행 ID(예: "da6")로 바꿉니다. 이 예에서는 컨테이너 myapp의 이름을 지정하고 컨테이너를 중지할 때 제거하도록 --rm 매개 변수가 포함됩니다.
docker run -d -p 8080:80 --name myapp --rm $ACR_NAME.azurecr.io/helloworld:<run-id>
브라우저에서 http://localhost:8080으로 이동하면 다음과 비슷하게 웹 페이지에 렌더링된 Node.js 버전 번호가 표시됩니다. 이후 단계에서 버전 문자열에 "a"를 추가하여 버전을 범프합니다.
컨테이너를 중지하고 제거하려면 다음 명령을 실행합니다.
docker stop myapp
빌드 나열
다음으로, az acr task list-runs 명령을 사용하여 ACR 작업에서 레지스트리에 대해 완료한 작업 실행을 나열합니다.
az acr task list-runs --registry $ACR_NAME --output table
이전 자습서를 완료했으면(레지스트리를 삭제하지 않은 경우) 다음과 비슷한 출력이 표시됩니다. 다음 섹션에서 기본 이미지를 업데이트한 후 출력을 비교할 수 있도록 작업 실행 횟수와 최신 RUN ID를 적어 둡니다.
az acr task list-runs --registry $ACR_NAME --output table
UN ID TASK PLATFORM STATUS TRIGGER STARTED DURATION
-------- -------------- ---------- --------- ------------ -------------------- ----------
ca12 baseexample2 linux Succeeded Manual 2020-11-21T00:00:56Z 00:00:36
ca11 baseexample1 linux Succeeded Image Update 2020-11-20T23:38:24Z 00:00:34
ca10 taskhelloworld linux Succeeded Image Update 2020-11-20T23:38:24Z 00:00:24
cay linux Succeeded Manual 2020-11-20T23:38:08Z 00:00:22
cax baseexample1 linux Succeeded Manual 2020-11-20T23:33:12Z 00:00:30
caw taskhelloworld linux Succeeded Commit 2020-11-20T23:16:07Z 00:00:29
기본 이미지 업데이트
여기서는 기본 이미지의 프레임워크 패치를 시뮬레이션합니다. Dockerfile-base를 편집하고, NODE_VERSION에 정의된 버전 번호 뒤에 "a"를 추가합니다.
ENV NODE_VERSION 15.2.1a
빠른 작업을 실행하여 수정된 기본 이미지를 빌드합니다. 출력에 있는 실행 ID를 적어 둡니다.
az acr build --registry $BASE_ACR --image baseimages/node:15-alpine --file Dockerfile-base .
빌드가 완료되고 ACR 작업에서 새 기본 이미지를 레지스트리에 푸시하면 애플리케이션 이미지의 빌드가 트리거됩니다. 새로 빌드되고 푸시된 기본 이미지를 검색해야 하므로 이전에 만든 작업에서 애플리케이션 이미지 빌드를 트리거하는 데 약간의 시간이 걸릴 수 있습니다.
업데이트된 빌드 나열
이제 기본 이미지를 업데이트했으므로 작업 실행을 다시 나열하여 이전 목록과 비교합니다. 처음에 출력이 다르지 않으면 명령을 정기적으로 실행하여 새 작업 실행이 목록에 표시되는지 확인합니다.
az acr task list-runs --registry $ACR_NAME --output table
출력은 다음과 유사합니다. 마지막으로 실행된 빌드에 대한 TRIGGER는 기본 이미지의 빠른 작업에서 작업을 시작했음을 나타내는 "Image Update"(이미지 업데이트)여야 합니다.
az acr task list-runs --registry $ACR_NAME --output table
PLATFORM STATUS TRIGGER STARTED DURATION
-------- -------------- ---------- --------- ------------ -------------------- ----------
ca13 baseexample2 linux Succeeded Image Update 2020-11-21T00:06:00Z 00:00:43
ca12 baseexample2 linux Succeeded Manual 2020-11-21T00:00:56Z 00:00:36
ca11 baseexample1 linux Succeeded Image Update 2020-11-20T23:38:24Z 00:00:34
ca10 taskhelloworld linux Succeeded Image Update 2020-11-20T23:38:24Z 00:00:24
cay linux Succeeded Manual 2020-11-20T23:38:08Z 00:00:22
cax baseexample1 linux Succeeded Manual 2020-11-20T23:33:12Z 00:00:30
caw taskhelloworld linux Succeeded Commit 2020-11-20T23:16:07Z 00:00:29
새로 빌드한 컨테이너를 실행하여 업데이트된 버전 번호를 확인하는 다음의 선택적 단계를 수행하려면 Image Update가 트리거된 빌드에 대한 RUN ID 값을 적어 둡니다(앞의 출력에서 "ca13"임).
선택 사항: 새로 빌드된 이미지 실행
로컬(Cloud Shell이 아님)에서 작업 중이고 Docker가 설치되어 있는 경우, 빌드가 완료되면 새 애플리케이션 이미지를 실행합니다. <run-id>를 이전 단계에서 얻은 RUN ID로 바꿉니다. Cloud Shell을 사용하는 경우 이 섹션을 건너뜁니다(Cloud Shell에서는 docker run을 지원하지 않음).
docker run -d -p 8081:80 --name updatedapp --rm $ACR_NAME.azurecr.io/helloworld:<run-id>
브라우저에서 http://localhost:8081로 이동하면 웹 페이지에 업데이트된 Node.js 버전 번호("a" 포함)가 표시됩니다.
중요한 것은 기본 이미지를 새 버전 번호로 업데이트했지만 마지막으로 빌드된 애플리케이션 이미지에 새 버전이 표시된다는 것입니다. ACR 작업에서 기본 이미지에 대한 변경 내용을 선택하고 애플리케이션 이미지를 자동으로 다시 빌드했습니다.
컨테이너를 중지하고 제거하려면 다음 명령을 실행합니다.
docker stop updatedapp
다음 단계
이 자습서에서는 이미지의 기본 이미지가 업데이트되었을 때 작업을 사용하여 컨테이너 이미지 빌드를 자동으로 트리거하는 방법을 알아보았습니다. 이제 다음 자습서로 이동하여 정의된 일정에 따라 작업을 트리거하는 방법을 알아봅니다.