개요

이번 실습에서는 Cloud Build를 사용하여 제공된 코드와 Dockerfile을 기반으로 Docker 컨테이너 이미지를 빌드하고, 그런 다음 컨테이너를 Artifact Registry로 업로드합니다.

목표

이번 실습에서는 다음 작업의 실행 방법을 알아봅니다.

• Cloud Build를 사용하여 컨테이너를 빌드하고 푸시하기
• Artifact Registry를 사용하여 컨테이너를 저장하고 배포하기

실습 설정

실습 액세스하기

각 실습에서는 정해진 기간 동안 새 Google Cloud 프로젝트와 리소스 집합이 무료로 제공됩니다.

1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 팝업이 열립니다. 왼쪽에는 다음과 같은 항목이 포함된 실습 세부정보 패널이 있습니다.

   • Google Cloud 콘솔 열기 버튼
   • 남은 시간
   • 이 실습에 사용해야 하는 임시 사용자 인증 정보
   • 필요한 경우 실습 진행을 위한 기타 정보

2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

   실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

   팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

   참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.

3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

   {{{user_0.username | "Username"}}}

   실습 세부정보 패널에서도 사용자 이름을 확인할 수 있습니다.

4. 다음을 클릭합니다.

5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

   {{{user_0.password | "Password"}}}

   실습 세부정보 패널에서도 비밀번호를 확인할 수 있습니다.

6. 다음을 클릭합니다.

   중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.

7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

   • 이용약관에 동의합니다.
   • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
   • 무료 체험판을 신청하지 않습니다.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스 목록이 있는 메뉴를 보려면 왼쪽 상단의 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다.

초기 로그인 단계를 완료하면 프로젝트 대시보드가 열립니다.

Google Cloud Shell 활성화하기

Google Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉터리를 제공하며 Google Cloud에서 실행됩니다.

Google Cloud Shell을 사용하면 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

1. Cloud 콘솔의 오른쪽 상단 툴바에서 'Cloud Shell 열기' 버튼을 클릭합니다.

   

2. 계속을 클릭합니다.

환경을 프로비저닝하고 연결하는 데 몇 분 정도 소요됩니다. 연결되면 사용자가 미리 인증되어 프로젝트가 PROJECT_ID로 설정됩니다. 예:

gcloud는 Google Cloud의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 명령줄 자동 완성을 지원합니다.

• 다음 명령어를 사용하여 사용 중인 계정 이름을 나열할 수 있습니다.

gcloud auth list

출력:

Credentialed accounts: - @.com (active)

출력 예시:

Credentialed accounts: - google1623327_student@qwiklabs.net

• 다음 명령어를 사용하여 프로젝트 ID를 나열할 수 있습니다.

gcloud config list project

출력:

[core] project =

출력 예시:

[core] project = qwiklabs-gcp-44776a13dea667a6 참고: gcloud 전체 문서는 gcloud CLI 개요 가이드를 참조하세요.

작업 1. 필요한 API가 사용 설정되어 있는지 확인

1. Google Cloud 프로젝트 이름을 기록해 둡니다. 이 값은 Google Cloud 콘솔의 상단 바에 표시되며, qwiklabs-gcp-에 16진수 숫자가 붙은 형식입니다.

2. Google Cloud 콘솔의 탐색 메뉴()에서 API 및 서비스를 클릭합니다.

3. 라이브러리를 클릭합니다.

4. API 및 서비스 검색 상자에 Cloud Build를 입력합니다.

5. Cloud Build API의 결과 카드에 Cloud Build API가 사용 설정되어 있다는 메시지가 표시되지 않으면 사용 설정 버튼을 클릭합니다.

6. 뒤로 버튼을 사용하여 검색창이 있는 이전 화면으로 돌아갑니다. 검색창에 Artifact Registry를 입력합니다.

7. Google Artifact Registry API의 결과 카드에 Artifact Registry API가 사용 설정되어 있다는 메시지가 표시되지 않으면 사용 설정 버튼을 클릭합니다.

작업 2. Dockerfile과 Cloud Build로 컨테이너 빌드하기

빌드 구성 파일을 작성하여 Cloud Build에 컨테이너 빌드 시 실행해야 하는 작업을 지시할 수 있습니다. 이러한 빌드 파일을 사용하여 종속 항목을 가져오고 단위 테스트, 분석 등의 작업을 실행할 수 있습니다. 이 작업에서는 Dockerfile을 생성하여 이를 Cloud Build의 빌드 구성 스크립트로 사용합니다. 또한, 컨테이너 내 애플리케이션을 나타내는 간단한 셸 스크립트(quickstart.sh)도 생성합니다.

1. Google Cloud 콘솔 제목 표시줄에서 Cloud Shell 활성화를 클릭합니다.

2. 메시지가 표시되면 승인을 클릭합니다.

Cloud Shell이 Google Cloud 콘솔 창 하단에 열립니다.

3. nano 텍스트 편집기를 사용하여 빈 quickstart.sh 파일을 생성합니다.

nano quickstart.sh

4. quickstart.sh 파일에 다음 줄을 추가합니다.

#!/bin/sh echo "Hello, world! The time is $(date)."

5. 파일을 저장하고 Ctrl + X 키를 누른 다음 Y와 Enter 키를 눌러 nano 텍스트 편집기를 종료합니다.

6. nano 텍스트 편집기를 사용하여 빈 Dockerfile 파일을 생성합니다.

nano Dockerfile

7. 다음의 Dockerfile 명령어를 추가합니다.

FROM alpine

이 명령어는 Alpine Linux 기본 이미지를 사용하도록 빌드에 지시합니다.

8. 다음 Dockerfile 명령어를 Dockerfile 끝에 추가합니다.

COPY quickstart.sh /

이 명령어는 quickstart.sh 스크립트를 이미지의 / 디렉터리에 추가합니다.

9. 다음 Dockerfile 명령어를 Dockerfile 끝에 추가합니다.

CMD ["/quickstart.sh"]

이 명령어는 연결된 컨테이너가 생성되고 실행될 때 /quickstart.sh 스크립트를 실행하도록 이미지를 구성합니다.

이제 Dockerfile의 내용은 다음과 같습니다.

FROM alpine COPY quickstart.sh / CMD ["/quickstart.sh"]

10. 파일을 저장하고 Ctrl + X 키를 누른 다음 Y와 Enter 키를 눌러 nano 텍스트 편집기를 종료합니다.

11. Cloud Shell에서 다음 명령어를 실행하여 quickstart.sh 스크립트를 실행 가능하도록 합니다.

chmod +x quickstart.sh

12. 위치에 quickstart-docker-repo라는 새로운 Docker 저장소를 만들고 설명을 'Docker 저장소'라고 지정합니다.

gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \ --location={{{project_0.default_region | "REGION"}}} --description="Docker repository"

13. Cloud Shell에서 다음 명령어를 실행하여 Cloud Build로 Docker 컨테이너 이미지를 빌드합니다.

gcloud builds submit --tag {{{project_0.default_region | "REGION"}}}-docker.pkg.dev/${DEVSHELL_PROJECT_ID}/quickstart-docker-repo/quickstart-image:tag1

빌드가 완료되면 Docker 이미지가 빌드되어 Artifact Registry로 푸시됩니다.

14. Google Cloud 콘솔의 검색창(콘솔 창 상단에 위치)에서 Artifact Registry를 검색합니다.

참고: 검색창이 표시되지 않으면 돋보기 아이콘을 클릭하세요. 참고: 이동 시 뷰가 재설정됨이라는 팝업 메시지가 표시될 수 있습니다. 확인 버튼을 클릭하여 계속 진행합니다.

15. quickstart-docker-repo라는 이름의 저장소를 클릭합니다.

quickstart-image Docker 이미지가 목록에 표시됩니다.

작업 3. 빌드 구성 파일과 Cloud Build로 컨테이너 빌드하기

Cloud Build는 커스텀 빌드 구성 파일도 지원합니다. 이 작업에서는 YAML 형식의 커스텀 빌드 파일을 사용하여 Cloud Build로 기존 Docker 컨테이너를 통합합니다.

cloudbuild.yaml이라는 커스텀 Cloud Build 구성 파일 샘플을 만들어 보겠습니다.

1. 다음 명령어를 사용하여 nano로 cloudbuild.yaml이라는 파일을 만들고 엽니다.

nano cloudbuild.yaml

2. nano가 열리면 다음 사항을 cloudbuild.yaml 파일에 붙여넣습니다.

steps: - name: 'gcr.io/cloud-builders/docker' args: [ 'build', '-t', 'YourRegionHere-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ] images: - 'YourRegionHere-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

3. Ctrl+O 키를 누른 다음 Enter 키를 눌러 수정한 파일을 저장합니다.

4. Ctrl+X 키를 눌러 nano 텍스트 편집기를 종료합니다.

5. 아래 명령어를 실행하여 리전 변수를 설정하고 해당 값을 yaml 파일에 삽입합니다.

export REGION={{{project_0.default_region | "REGION"}}} sed -i "s/YourRegionHere/$REGION/g" cloudbuild.yaml

6. Cloud Shell에서 다음 명령어를 실행하여 cloudbuild.yaml의 내용을 확인합니다.

cat cloudbuild.yaml

다음과 같은 내용이 표시됩니다.

steps: - name: 'gcr.io/cloud-builders/docker' args: [ 'build', '-t', '{{{project_0.default_region | "REGION"}}}-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ] images: - '{{{project_0.default_region | "REGION"}}}-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

이 파일의 안내에 따라 Cloud Build가 Docker를 사용하여 현재 로컬 디렉터리의 Dockerfile 사양에 맞게 이미지를 빌드하고 gcr.io/$PROJECT_ID/quickstart-image로 태그를 지정한 다음, 이미지를 Artifact Registry로 푸시합니다. $PROJECT_ID는 Cloud Build가 연결된 프로젝트의 프로젝트 ID를 사용하여 자동으로 채우는 대체 변수입니다.

7. Cloud Shell에서 다음 명령어를 실행하여 cloudbuild.yaml을 빌드 구성 파일로 사용하는 Cloud Build를 시작합니다.

gcloud builds submit --config cloudbuild.yaml

Cloud Shell에 표시되는 빌드 출력은 전과 같아야 합니다. 빌드가 완료되면 동일한 이미지의 새 버전이 Artifact Registry로 푸시됩니다.

8. Google Cloud 콘솔의 검색창(콘솔 창 상단에 위치)에서 Artifact Registry를 검색합니다.

9. 검색 결과에서 Artifact Registry를 클릭합니다.

10. quickstart-docker-repo > quickstart-image라는 저장소를 클릭합니다.

이제 두 가지 버전의 quickstart-image가 목록에 표시됩니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. Cloud Build에서 두 개의 컨테이너 이미지 빌드하기

11. Google Cloud 콘솔의 검색창(콘솔 창 상단에 위치)에서 Cloud Build를 검색합니다.

12. 검색 결과에서 Cloud Build를 클릭합니다.

13. Cloud Build에서 기록을 클릭합니다. 목록에 두 개의 빌드가 표시됩니다.

14. 목록 상단에서 빌드의 빌드 ID를 클릭합니다. 빌드 로그를 비롯한 빌드 세부정보가 표시됩니다.

작업 4. 빌드 구성 파일과 Cloud Build로 컨테이너 빌드 및 테스트

커스텀 빌드 구성 파일의 진정한 강점은 단순히 컨테이너를 빌드하는 것 외에도 병렬로 또는 순차적으로 다른 작업을 수행하는 기능입니다. 예를 들어 새로 빌드된 컨테이너에서 테스트를 실행하고, 이를 다양한 대상으로 푸시하고, Kubernetes Engine에 배포하는 작업까지 할 수 있습니다.

이 작업에서는 간단한 예로, 빌드된 컨테이너를 테스트하고 결과를 호출 환경에 보고하는 빌드 구성 파일을 살펴보겠습니다. 첫 번째 단계는 quickstart.sh 파일을 변경하는 것입니다.

1. Cloud Shell에서 nano의 quickstart.sh를 엽니다.

   nano quickstart.sh

2. 기존 코드를 다음으로 바꿉니다.

#!/bin/sh if [ -z "$1" ] then echo "Hello, world! The time is $(date)." exit 0 else exit 1 fi

3. Ctrl+O 키를 누른 다음 Enter 키를 눌러 수정한 파일을 저장합니다.

4. Ctrl+X 키를 눌러 nano 텍스트 편집기를 종료합니다.

cloudbuild2.yaml이라는 새 커스텀 Cloud Build 구성 파일을 만듭니다. 이 파일은 Cloud Build에서 빌드한 컨테이너를 테스트하는 Cloud Build의 기능을 보여 주기 위해 약간 수정되었습니다.

1. 다음 명령어를 사용하여 nano로 cloudbuild2.yaml이라는 파일을 만들고 엽니다.

nano cloudbuild2.yaml

2. nano가 열리면 다음 사항을 cloudbuild2.yaml 파일에 붙여넣습니다.

steps: - name: 'gcr.io/cloud-builders/docker' args: [ 'build', '-t', 'YourRegionHere-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ] - name: 'YourRegionHere-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1' args: ['fail'] images: - 'YourRegionHere-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

3. Ctrl+O 키를 누른 다음 Enter 키를 눌러 수정한 파일을 저장합니다.

4. Ctrl+X 키를 눌러 nano 텍스트 편집기를 종료합니다.

5. 아래 명령어를 실행하여 리전 값을 yaml 파일에 삽입합니다.

sed -i "s/YourRegionHere/$REGION/g" cloudbuild2.yaml

6. Cloud Shell에서 다음 명령어를 실행하여 cloudbuild2.yaml의 내용을 확인합니다.

cat cloudbuild2.yaml

다음과 같은 내용이 표시됩니다.

steps: - name: 'gcr.io/cloud-builders/docker' args: [ 'build', '-t', '{{{project_0.default_region | "REGION"}}}-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ] - name: 'gcr.io/$PROJECT_ID/quickstart-image' args: ['fail'] images: - '{{{project_0.default_region | "REGION"}}}-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

이 빌드 구성 파일은 이전 작업 외에도 앞서 생성한 quickstart-image를 실행합니다. 이 작업에서는 ['fail'] 인수가 전달되면 테스트 실패를 시뮬레이션하도록 quickstart.sh 스크립트를 수정했습니다.

7. Cloud Shell에서 다음 명령어를 실행하여 cloudbuild.yaml을 빌드 구성 파일로 사용하는 Cloud Build를 시작합니다.

gcloud builds submit --config cloudbuild2.yaml

명령어 실행 후 다음과 같은 텍스트로 끝나는 출력이 표시됩니다.

출력

BUILD FAILURE: Build step failure: build step 1 "us-east1-docker.pkg.dev/qwiklabs-gcp-02-1c7ba5c697a0/quickstart-docker-repo/quickstart-image:tag1" failed: starting step container failed: Error response from daemon: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "fail": executable file not found in $PATH: unknown ERROR: (gcloud.builds.submit) build 96c4a454-be06-4010-aa7c-da57c14165f4 completed with status "FAILURE"

8. 다음 방법으로 명령어 셸이 빌드가 실패했음을 알고 있는지 확인해 보세요.

echo $?

명령어는 0이 아닌 값을 반환합니다. 이 빌드를 스크립트에 삽입했다면 스크립트가 빌드 실패에 대응했을 것입니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 빌드 구성 파일과 Cloud Build로 컨테이너 빌드 및 테스트하기

실습 종료하기

실습을 완료하면 실습 종료를 클릭합니다. Google Cloud Skills Boost에서 사용된 리소스를 자동으로 삭제하고 계정을 지웁니다.

실습 경험을 평가할 수 있습니다. 해당하는 별표 수를 선택하고 의견을 입력한 후 제출을 클릭합니다.

별점의 의미는 다음과 같습니다.

• 별표 1개 = 매우 불만족
• 별표 2개 = 불만족
• 별표 3개 = 중간
• 별표 4개 = 만족
• 별표 5개 = 매우 만족

의견을 제공하고 싶지 않다면 대화상자를 닫으면 됩니다.

의견이나 제안 또는 수정할 사항이 있다면 지원 탭을 사용하세요.

Copyright 2020 Google LLC All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.