수동으로 빌드 시작

이 페이지에서는 gcloud 명령줄 도구 및 Cloud Build API를 사용하여 Cloud Build에서 수동으로 빌드를 시작하는 방법을 설명합니다. 수동으로 호출할 수 있는 빌드 트리거를 만들려면 수동 트리거 만들기를 참조하세요.

시작하기 전에

  • 이 가이드의 명령줄 예를 사용하려면 gcloud 명령줄 도구를 설치합니다.
  • Cloud Build 빌드 구성을 사용하여 빌드하려면 빌드 구성 파일을 사용하여 빌드합니다.
  • Dockerfile을 사용하여 빌드하려면 Dockerfile을 준비합니다.
  • 빌드에 소스 코드가 필요한 경우 소스 코드를 준비합니다.

필수 IAM 권한

IAM 역할 부여에 대한 안내는 프로젝트 구성원의 액세스 구성을 참조하세요.

빌드 실행

Console

Google Cloud Console을 사용하여 수동으로 새 빌드를 시작할 수는 없지만 이전 빌드를 다시 시도할 수는 있습니다.

이전 빌드를 재시도하려면 다음 안내를 따르세요.

  1. Google Cloud Console의 Cloud Build 섹션에서 빌드 기록 페이지를 엽니다.

    빌드 기록 페이지 열기

  2. 프로젝트를 선택하고 열기를 클릭합니다.

  3. 빌드 기록 페이지에서 다시 빌드하려는 빌드를 클릭합니다.

  4. 다시 빌드를 클릭합니다.

gcloud

Dockerfile 사용:

Dockerfile에는 Cloud Build를 사용하여 Docker 이미지를 빌드하는 데 필요한 모든 정보가 들어 있습니다.

Dockerfile을 사용하여 빌드 요청을 실행하려면 애플리케이션 코드, Dockerfile, 그 외 애셋이 포함되어 있는 디렉터리에서 다음 명령어를 실행합니다.

gcloud builds submit --tag gcr.io/project-id/image-name .

각 항목의 의미는 다음과 같습니다.

  • project-id는 Cloud 프로젝트의 이름입니다.
  • image-name은 빌드할 이미지입니다.
  • .은 소스 코드가 현재 작업 디렉터리에 있음을 나타냅니다.

빌드할 이미지의 전체 이름은 `gcr.io/project-id/image-name입니다. Container Registry에 푸시된 이미지는 레지스트리 이름 형식을 사용합니다.

gcloud builds submit 명령어:

  • .으로 지정된 현재 디렉터리에서 애플리케이션 코드, Dockerfile, 그 외 애셋을 압축합니다.
  • 파일을 Cloud Storage 버킷에 업로드합니다.
  • 업로드된 파일을 입력으로 사용하여 빌드를 시작합니다.
  • 지정된 이름을 사용하여 이미지에 태그를 지정합니다.
  • 빌드할 이미지를 Container Registry에 푸시합니다.

빌드가 진행되면 셸 또는 터미널 창에 출력이 표시됩니다. 빌드가 완료되면 다음과 비슷한 출력이 표시됩니다.

    DONE
    ---------------------------------------------------------------------------------
    ID                                    CREATE_TIME                DURATION STATUS
    $BUILD_ID                             2016-10-28T15:21:18+00:00  12S      SUCCESS

여기서 $BUILD_ID는 빌드의 고유 식별자입니다.

Cloud Build 빌드 구성 파일 사용:

빌드 구성을 사용하여 빌드를 제출하려면 다음 명령어를 실행하세요.

    gcloud builds submit --config build-config source-code

각 항목의 의미는 다음과 같습니다.

  • build-config는 빌드 구성 파일의 경로입니다.
  • source-code는 경로 또는 URL 소스 코드입니다.

Cloud 프로젝트에서 gcloud builds submit을 처음 실행하면 Cloud Build가 해당 프로젝트에서 [YOUR_PROJECT_NAME]_cloudbuild라는 Cloud Storage 버킷을 만듭니다. Cloud Build는 이 버킷을 사용하여 빌드에 사용할 수 있는 모든 소스 코드를 저장합니다. Cloud Build는 이 버킷의 콘텐츠를 자동으로 삭제하지 않습니다. 빌드에 더 이상 사용하지 않는 객체를 삭제하려면 버킷에 수명 주기 구성을 설정하거나 수동으로 객체를 삭제하면 됩니다.

다음 명령어는 Cloud Storage 버킷에 저장된 보관 소스 코드를 사용하여 cloudbuild.yaml 빌드 요청을 제출합니다.

    gcloud builds submit --config cloudbuild.yaml \
        gs://cloud-build-examples/node-docker-example.tar.gz

.를 사용하여 소스 코드가 현재 작업 디렉터리에 있음을 지정할 수 있습니다.

    gcloud builds submit --config cloudbuild.yaml .

gcloudignore: 빌드의 소스 코드를 포함하면 위의 명령어는 지정된 디렉토리에 있는 모든 파일을 Google Cloud Platform에 업로드하여 빌드합니다. 디렉터리에서 특정 파일을 제외하길 원하면 최상위 업로드 디렉터리에 .gcloudignore라는 파일을 포함시키면 됩니다. 지정된 파일은 무시됩니다. 최상위 업로드 디렉터리에 .gcloudignore 파일은 없으나 .gitignore 파일은 있으면 gcloud 도구는 .gitignore 대상 파일을 고려하는 Git 호환 .gcloudignore 파일을 생성합니다. 자세한 내용은 gcloudignore 문서를 참조하세요.

빌드에 전달할 소스 코드가 없으면 --no-source 플래그를 사용하세요. 여기서 build-config는 빌드 구성 파일의 경로입니다.

    gcloud builds submit --config build-config --no-source

API

curl을 사용하여 빌드 요청을 제출하려면 다음 안내를 따르세요.

  1. 다음 콘텐츠로 request.json라는 파일을 만듭니다.

    {
        "source": {
            "storageSource": {
                "bucket": "cloud-build-examples",
                "object": "node-docker-example.tar.gz"
            }
        },
        "steps": [{
            "name": "gcr.io/cloud-builders/docker",
            "args": [
                "build",
                "-t",
                "gcr.io/$PROJECT_ID/my-image",
                "."
            ]
        }],
        "images": [
            "gcr.io/$PROJECT_ID/my-image"
        ]
    }
    

    이 빌드 요청에서 Cloud Build는 build -t gcr.io/$PROJECT_ID/cb-demo-img . 인수를 사용하여 docker 빌드 단계를 호출합니다.

    빌드할 이미지의 전체 이름은 gcr.io/$PROJECT_ID/cb-demo-img입니다. Container Registry에 푸시된 이미지는 레지스트리 이름 형식을 사용합니다.

    빌드의 코드 소스는 압축된 tar 아카이브 node-docker-example.tar.gz에 있습니다. 파일은 cloud-build-examples라는 이름의 Cloud Storage 버킷에 저장됩니다.

  2. 다음 명령어를 실행합니다. 여기서 project-id는 클라우드 프로젝트 ID입니다.

    curl -X POST -T request.json -H "Authorization: Bearer $(gcloud config config-helper \
        --format='value(credential.access_token)')" \
        https://cloudbuild.googleapis.com/v1/projects/project-id/builds
    

    이 명령어에서 curl은 POST 호출의 request.jsonprojects.builds.create API 메서드의 builds 엔드포인트로 보냅니다.

    이 명령어는 셸 또는 터미널 창에 빌드에 대한 세부정보를 표시합니다. 출력은 JSON 응답이며 다음과 비슷하게 표시됩니다.

    {
        "name": "operations/build/$PROJECT-ID/NmZhZW...",
        "metadata": {
            "@type": "type.googleapis.com/google.devtools.cloudbuild.v1.BuildOperationMetadata",
            "build": {
                "id": $BUILD-ID,
                "status": "QUEUED",
                "source": {
                    "storageSource": {
                        "bucket": "cloud-build-examples",
                        "object": "node-docker-example.tar.gz"
                    }
                },
                "createTime": "2017-05-12T18:58:07.341526Z",
                "steps": [
                {
                    "name": "gcr.io/cloud-builders/docker",
                    "args": [
                        "build",
                        "-t",
                        "gcr.io/$PROJECT-ID/cb-demo-img",
                        "."
                    ]
                }
                ],
                "timeout": "600s",
                "images": [
                    "gcr.io/$PROJECT-ID/cb-demo-img"
                ],
                "projectId": $PROJECT-ID,
                "logsBucket": "gs://...",
                "sourceProvenance": {
                    "resolvedStorageSource": {
                        "bucket": "cloud-build-examples",
                        "object": "node-docker-example.tar.gz",
                        "generation": "..."
                    }
                },
                "logUrl": "https://console.cloud.google.com/gcr/builds/...?project=$PROJECT-ID"
            }
        }
    }
    

    JSON 응답은 Cloud Build API의 Operation 리소스를 사용하여 모델링됩니다. metadata 필드는 Build 리소스를 사용하여 모델링됩니다. QUEUED 상태는 빌드가 실행 대기 중임을 나타냅니다.

다음 단계