IoT 기기용 다중 아키텍처 컨테이너 이미지 빌드

빌드 파이프라인 만들기

Terraform 템플릿 파일 terraform/main.tf는 이 튜토리얼용으로 생성된 리소스를 정의합니다. 해당 설명자와 함께 Terraform을 실행하여 다음 Google Cloud 리소스를 만듭니다.

• 컨테이너 이미지 설명자 및 Cloud Build 빌드 구성 파일을 저장할 Cloud Source Repositories 코드 저장소
• Cloud Build가 각 소스 코드 변경사항에 메시지를 게시하는 Pub/Sub 주제
• 다중 아키텍처 컨테이너 이미지를 빌드하는 Cloud Build 빌드
• 컨테이너 이미지를 저장할 Container Registry 저장소

Cloud Shell에서 다음을 수행합니다.

1. Terraform 작업 디렉터리를 초기화하려면 terraform init 명령어를 실행합니다.

   cd terraform
   terraform init
   

2. (선택사항) Terraform이 적용할 변경사항을 검토하려면 terraform plan 명령어를 실행합니다.

   terraform plan
   

   출력은 Terraform이 Google Cloud 환경에서 리소스를 프로비저닝하기 위해 수행해야 하는 모든 작업의 목록입니다. 모든 작업의 요약은 다음과 비슷합니다.

   Plan: 8 to add, 0 to change, 0 to destroy.
   

   총 추가 작업 수는 8개이며 변경사항 및 삭제는 없습니다.

3. terraform apply 명령어를 실행하여 Google Cloud 프로젝트에서 리소스를 만듭니다.

   terraform apply
   

4. 명령어를 계속 실행하려면 yes을 입력합니다.

Cloud Source Repositories로 소스 파일 푸시

빌드 파이프라인이 빌드를 실행하려면 Dockerfile 및 Cloud Build 구성 파일을 Cloud Source Repositories 소스 코드 저장소에 저장해야 합니다.

1. Cloud Shell에서 소스 저장소를 클론합니다.

   cd $HOME
   gcloud source repos clone cross-build
   

2. Dockerfile 및 Cloud Build 구성 파일을 소스 코드 저장소에 복사합니다.

   cp -r "$HOME"/solutions-build-multi-architecture-images-tutorial/terraform/cloud-build/. "$HOME"/cross-build
   

3. 소스 코드 저장소에 파일을 커밋하고 푸시합니다.

   cd "$HOME"/cross-build
   git add .
   git commit -m "Initial commit"
   git push
   

결과 검사

Cloud Build 작업이 실행 중이고 완료된 후에는 Cloud Build 빌드 기록 페이지에서 각 빌드 단계의 실행을 검사할 수 있습니다.

Cloud Build 빌드

다음 그림과 같이 빌드 기록 페이지에서 빌드 단계의 개요와 각 단계를 실행하는 데 소요된 시간을 확인할 수 있습니다.

빌드 단계를 열면 해당 단계의 출력이 표시됩니다. 예를 들어 앞의 다이어그램에서 buildx check 단계의 빌드 세부정보는 플랫폼이 지원하는 다양한 타겟 플랫폼 아키텍처를 보여줍니다.

12 Name:      mybuilder0
13 Endpoint:  unix:///var/run/docker.sock
14 Status:    running
15 Platforms: linux/amd64, linux/arm64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6

네 번째 단계의 빌드 세부정보에는 각 타겟 아키텍처의 빌드 출력이 표시됩니다.

#8 0.268 I am running on linux/amd64, building for linux/amd64
#12 0.628 I am running on linux/amd64, building for linux/arm/v7
#10 0.279 I am running on linux/amd64, building for linux/arm/v6
#14 0.252 I am running on linux/amd64, building for linux/arm64

Container Registry의 이미지 매니페스트

빌드가 완료되면 다음 그림과 같이 Cloud 콘솔의 Container Registry 이미지 페이지에서 이미지 매니페스트를 검사할 수 있습니다.

저장소 목록에서 테스트 저장소를 열면 다음 그림과 같이 테스트 저장소에 속한 모든 컨테이너 이미지 버전이 표시됩니다.

최신 태그가 지정된 이미지를 열어 다음 그림과 같이 다이제스트 세부정보 페이지를 열 수 있습니다.

다이제스트 세부정보 페이지에서 매니페스트 섹션을 펼치고 다음 예시와 같이 빌드에서 만든 모든 대상 아키텍처가 파일에 표시되어 있는지 확인할 수 있습니다.

{
  "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
  "schemaVersion": 2,
  "manifests": [
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:839024acb1038509e3bc66f3744857840951d0d512be54fd6670ea1e8babdcb6",
        "size": 735,
        "platform": {
           "architecture": "amd64",
           "os": "linux"
        }
     },
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:33489767c29efb805e446a61d91cc55e042d3cfadcd186d9a1c8698f2f12309d",
        "size": 735,
        "platform": {
           "architecture": "arm64",
           "os": "linux"
        }
     },
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:f1958815778ca8c83d324bad3fc68a9e3e9d5ea48b5bb27a8aca7d8da20cf8d4",
        "size": 735,
        "platform": {
           "architecture": "arm",
           "os": "linux",
           "variant": "v7"
        }
     }
  ]
}

Cloud Shell에서 직접 이미지 매니페스트를 볼 수도 있습니다.

• Cloud Shell에서 이미지 매니페스트를 표시합니다.

  DOCKER_CLI_EXPERIMENTAL=enabled docker manifest inspect gcr.io/"${DEVSHELL_PROJECT_ID}"/test:latest
  

  출력은 다이제스트 세부정보 페이지에서 펼칠 수 있는 매니페스트 파일과 동일합니다.

빌드 파이프라인에서 지속적 배포 구성

새 하드웨어 아키텍처의 컨테이너 이미지를 빌드하려면 새 대상 아키텍처를 추가하여 빌드 구성 파일을 수정합니다. Cloud Source Repositories의 소스 저장소에 변경사항을 커밋하고 푸시하면 Cloud Build가 새 빌드를 시작합니다. 빌드는 새로 추가된 하드웨어 아키텍처에 대한 지원을 포함하여 새 버전의 다중 아키텍처 컨테이너 이미지를 생성합니다.

1. Cloud Shell에서 빌드 구성 파일에 새 대상 플랫폼을 추가합니다.

   cd "$HOME"/cross-build
   sed -i -e 's/linux\/arm\/v7/linux\/arm\/v7,linux\/386/g' build-docker-image-trigger.yaml
   

2. 변경사항을 소스 코드 저장소에 커밋하고 푸시합니다.

   git add .
   git commit -m "add a new target platform"
   git push
   

3. 최신 매니페스트를 확인하여 새 대상 플랫폼이 최신 컨테이너 이미지의 일부인지 확인합니다.

   DOCKER_CLI_EXPERIMENTAL=enabled docker manifest inspect gcr.io/${DEVSHELL_PROJECT_ID}/test:latest
   

4. 새로 추가된 대상 플랫폼이 다음 출력과 비슷한 매니페스트 파일에 있는지 확인합니다.

   {
     "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
     "schemaVersion": 2,
     "manifests": [
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:bc80d063fccb4c370df9b505cbf4f8a814a366d99644de09ebee98af2ef0ff63",
           "size": 735,
           "platform": {
              "architecture": "amd64",
              "os": "linux"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:be10e4f01f529149815ebad7eb09edaa84ebef5b7d70d51f7d1acb5ceb1f61cd",
           "size": 735,
           "platform": {
              "architecture": "arm64",
              "os": "linux"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:f6ba5d5d3bc1ea0177e669517ea15a0d4fb97c06c7eca338afa43734d87af779",
           "size": 735,
           "platform": {
              "architecture": "arm",
              "os": "linux",
              "variant": "v7"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:a3c34621cca10974026f8ad0782af78539cd7bb0ebfa0082a27b2c3ed4418ca0",
           "size": 735,
           "platform": {
              "architecture": "386",
              "os": "linux"
           }
        }
     ]
   }