빌드팩으로 애플리케이션 빌드

이 가이드에서는 애플리케이션 소스 코드와 함께 빌드팩을 사용하여 컨테이너 이미지를 만드는 방법을 설명합니다. 예를 들어 빌드팩을 사용하여 Cloud Run 서비스의 소스 코드를 컨테이너 이미지에 빌드합니다.

빌드팩으로 컨테이너 이미지를 빌드하는 방법은 두 가지입니다.

• pack CLI를 사용하여 로컬에서 빌드하여 애플리케이션을 로컬에서 테스트하고 배포 전에 신속하게 변경사항의 프로토타입을 제작합니다.
• Cloud Build를 사용하여 원격으로 빌드합니다. Cloud Build를 사용해서 빌드하는 방식은 리소스 집약적인 빌드 프로세스를 포함하는 대규모 애플리케이션에 유용하고 소프트웨어 공급망 보호에도 도움이 됩니다.

로컬 빌드

pack CLI를 사용하여 애플리케이션을 컨테이너 이미지에 로컬에서 빌드합니다.

시작하기 전에

1. Docker Community Edition(CE)을 워크스테이션에 설치합니다. Docker는 pack에서 OCI 이미지 빌더로 사용됩니다.
2. Pack CLI를 설치합니다.
3. Git 소스 제어 도구를 설치하여 GitHub에서 샘플 애플리케이션을 가져옵니다.

로컬에서 애플리케이션 빌드

pack build 명령어를 사용하고 기본 빌더 --builder=gcr.io/buildpacks/builder를 지정하여 컨테이너 이미지를 로컬에서 빌드합니다.

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

IMAGE_NAME을 서비스의 컨테이너 이미지 이름으로 바꿉니다.

빌드 및 실행 이미지를 확장하여 컨테이너 이미지를 맞춤설정할 수도 있습니다.

로컬에서 샘플 애플리케이션 빌드

다음 예시는 로컬에서 샘플을 빌드하는 방법을 보여줍니다.

1. 샘플 저장소를 로컬 머신에 클론합니다.

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. 애플리케이션 샘플 코드가 포함된 디렉터리로 변경합니다.

   Go

   cd buildpack-samples/sample-go

   Java

   cd buildpack-samples/sample-java-gradle

   Node.js

   cd buildpack-samples/sample-node

   PHP

   cd buildpack-samples/sample-php

   Python

   cd buildpack-samples/sample-python

   Ruby

   cd buildpack-samples/sample-ruby

   .NET

   cd buildpack-samples/sample-dotnet

3. pack를 사용하여 샘플 애플리케이션 이미지를 빌드합니다.

   Go

   pack build --builder=gcr.io/buildpacks/builder sample-go

   Java

   pack build --builder=gcr.io/buildpacks/builder sample-java-gradle

   Node.js

   pack build --builder=gcr.io/buildpacks/builder sample-node

   PHP

   pack build --builder=gcr.io/buildpacks/builder sample-php

   Python

   pack build --builder=gcr.io/buildpacks/builder sample-python

   Ruby

   pack build --builder=gcr.io/buildpacks/builder sample-ruby

   .NET

   pack build --builder=gcr.io/buildpacks/builder sample-dotnet

4. docker를 사용하여 이미지를 실행합니다.

   Go

   docker run -p8080:8080 sample-go

   Java

   docker run -it -ePORT=8080 -p8080:8080 sample-java-gradle

   Node.js

   docker run -it -ePORT=8080 -p8080:8080 sample-node

   PHP

   docker run -it --rm -p 8080:8080 sample-php

   Python

   docker run -it -ePORT=8080 -p8080:8080 sample-python

   Ruby

   docker run -it -ePORT=8080 -p8080:8080 sample-ruby

   .NET

   docker run -it -ePORT=8080 -p8080:8080 sample-dotnet

5. localhost:8080으로 이동하여 실행 중인 애플리케이션으로 이동합니다.

원격 빌드

Cloud Build를 사용하여 각 이미지를 저장하고 배포하는 컨테이너 저장소로서 컨테이너 이미지 및 Artifact Registry에 애플리케이션을 빌드할 수 있습니다.

시작하기 전에

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. API Cloud Build and Artifact Registry 사용 설정

   API 사용 설정

5. Google Cloud CLI를 설치합니다.

6. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

7. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

8. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

9. API Cloud Build and Artifact Registry 사용 설정

   API 사용 설정

10. Google Cloud CLI를 설치합니다.

11. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

    gcloud init

이전에 이미 Google Cloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 사용할 수 있는지 확인합니다.

12. Google Cloud 프로젝트에 컨테이너 이미지 저장소에 대한 액세스 권한이 있는지 확인합니다.

    Artifact Registry의 Docker 저장소에 대한 액세스를 구성하려면 다음 안내를 따르세요.

    1. Google Cloud 프로젝트와 동일한 위치에 새 Docker 저장소를 만듭니다.

       gcloud artifacts repositories create REPO_NAME \
       --repository-format=docker \
       --location=REGION --description="DESCRIPTION"
       

       다음과 같이 바꿉니다.
       • REPO_NAME을 Docker 저장소에 선택한 이름으로 바꿉니다.
       • REGION을 Google Cloud 프로젝트 위치 또는 그와 가장 가까운 위치로 바꿉니다.
       • DESCRIPTION을 선택한 설명으로 바꿉니다.

       예를 들어 'Docker 저장소' 설명과 함께 us-west2에 docker 저장소를 만들려면 다음 명령어를 실행합니다.

       gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
       --location=us-west2 --description="Docker repository"
       

    2. 저장소가 만들어졌는지 확인합니다.

       gcloud artifacts repositories list
       

       목록에 Docker 저장소에 대해 선택한 이름이 표시됩니다.

원격으로 애플리케이션 빌드

gcloud builds submit 명령어를 사용하여 컨테이너 이미지를 빌드하고 저장소에 업로드합니다.

명령어 자체에서 컨테이너 이미지를 지정하거나 구성 파일을 사용하는 방식을 선택할 수 있습니다.

명령어로 빌드

구성 파일 없이 빌드하려면 image 플래그를 지정합니다.

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

다음과 같이 바꿉니다.

• LOCATION을 컨테이너 저장소의 리전 이름으로 바꿉니다. 예를 들면 us-west2입니다.
• PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
• REPO_NAME을 Docker 저장소의 이름으로 바꿉니다.
• IMAGE_NAME을 컨테이너 이미지 이름으로 바꿉니다.

예를 들면 다음과 같습니다.

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo/app-image

구성 파일로 빌드

구성 파일을 사용하여 이미지 저장소 구성 세부정보를 정의해서 빌드 명령어를 간소화할 수 있습니다. 구성 파일에는 YAML 파일 형식이 사용되며 pack CLI를 사용하는 빌드 단계가 포함되어야 합니다.

1. 컨테이너 이미지 저장소의 URI가 포함된 cloudbuild.yaml이라는 YAML 파일을 만듭니다.

   options:
     logging: CLOUD_LOGGING_ONLY
     pool: {}
   projectId: PROJECT_ID
   steps:
   - name: gcr.io/k8s-skaffold/pack
     entrypoint: pack
     args:
     - build
     - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
     - --builder
     - gcr.io/buildpacks/builder:latest
     - --network
     - cloudbuild
   

   다음과 같이 바꿉니다.

   • LOCATION을 컨테이너 저장소의 리전 이름으로 바꿉니다. 예: us-west2
   • PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
   • REPO_NAME을 Docker 저장소의 이름으로 바꿉니다.
   • IMAGE_NAME을 컨테이너 이미지 이름으로 바꿉니다.

2. 애플리케이션을 빌드합니다.

   cloudbuild.yaml이라는 구성 파일을 만들었으면 다음 명령어를 실행할 수 있습니다.

   gcloud builds submit .
   

   팁: 구성 파일에 고유한 이름을 사용할 경우 --config 플래그를 사용할 수 있습니다.

예시: 원격으로 샘플 애플리케이션 빌드

다음 예시는 샘플을 원격으로 빌드한 후 Artifact Registry에서 컨테이너 이미지가 저장소에 푸시되었는지 확인하는 방법을 보여줍니다.

1. 샘플 저장소를 로컬 머신에 클론합니다.

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. 애플리케이션 샘플 코드가 포함된 디렉터리로 변경합니다.

   Go

   cd buildpack-samples/sample-go

   Java

   cd buildpack-samples/sample-java-gradle

   Node.js

   cd buildpack-samples/sample-node

   PHP

   cd buildpack-samples/sample-php

   Python

   cd buildpack-samples/sample-python

   Ruby

   cd buildpack-samples/sample-ruby

   .NET

   cd buildpack-samples/sample-dotnet

3. gcloud를 사용하여 애플리케이션 소스 코드를 Cloud Build에 제출합니다.

   Go

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-go

   Java

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-java-gradle

   Node.js

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-node

   PHP

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-php

   Python

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-python

   Ruby

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-ruby

   .NET

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-dotnet

4. 샘플 애플리케이션이 성공적으로 REPO_NAME에 게시되었는지 확인합니다.

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   다음과 같이 바꿉니다.

   • LOCATION을 컨테이너 저장소의 리전 이름으로 바꿉니다. 예를 들면 us-west2입니다.
   • PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
   • REPO_NAME을 Docker 저장소의 이름으로 바꿉니다.

다음 단계

• Cloud Run에 이미지 배포
• 환경 변수 설정
• 빌드 이미지 구성
• 캐시 이미지로 빌드 속도 향상