비공개 풀 만들기 및 관리

이 페이지에서는 Cloud Build 비공개 풀을 만들고, 업데이트하고, 보고, 삭제하는 방법을 설명합니다. 비공개 풀에 익숙하지 않은 경우 비공개 풀 개요를 읽어보세요.

시작하기 전에

  1. 새 Cloud 프로젝트를 만들거나 기존 프로젝트를 선택합니다. 이 프로젝트를 사용하여 비공개 풀을 만듭니다.

  2. Cloud Build API를 사용 설정합니다.

    API 사용 설정

  3. 이 가이드의 명령줄 예시를 사용하려면 Cloud SDK를 설치하고 구성합니다.

  4. [선택사항] 빌드가 Virtual Private Cloud 네트워크에서 비공개 리소스에 액세스하려면 Virtual Private Cloud 네트워크, 그리고 비공개 풀이 있는 Virtual Private Cloud 네트워크 간에 피어링 연결을 설정해야 합니다. 자세한 내용은 비공개 풀을 만들기 위한 환경 설정을 참조하세요.

새 비공개 풀 만들기

IAM 권한: 이 작업을 수행하려면 Cloud Build WorkerPool 소유자 역할이 필요합니다. 이 역할을 부여하는 방법은 Cloud Build 리소스에 대한 액세스 구성을 참조하세요.

리전별로 Cloud 프로젝트당 최대 10개의 비공개 풀을 만들 수 있습니다. 새 비공개 풀을 만들려면 다음 안내를 따르세요.

Console

  1. Google Cloud Console에서 작업자 풀 페이지를 엽니다.

    Cloud Build 작업자 풀 페이지 열기

  2. 비공개 풀을 만들 프로젝트를 선택합니다.

  3. 작업자 풀 페이지에서 만들기를 클릭합니다.

  4. 비공개 풀 만들기 측면 패널에서 다음을 수행합니다.

    1. 비공개 풀의 이름을 입력합니다. 이 값은 1~63자(영문 기준)여야 하며 유효한 문자는 /[az][0-9]-/입니다.

    2. 비공개 풀을 만들 리전을 선택합니다.

    3. 비공개 풀에 사용할 Compute Engine 머신 유형을 선택합니다.

    4. 비공개 풀의 디스크 크기를 입력합니다. 100 이상이고 1,000 이하인 값을 지정합니다. 제공되지 않으면 Cloud Build에서 디스크 크기 100을 사용합니다.

    5. Virtual Private Cloud 네트워크가 있는 Cloud 프로젝트의 프로젝트 번호를 입력합니다. 이 필드를 비워 두면 비공개 풀에서 서비스 제작자 네트워크를 사용합니다. 사용 가능한 네트워크 구성 옵션 및 영향에 대한 자세한 내용은 환경 설정하기를 참조하세요.

    6. VPC 네트워크의 이름을 입력합니다. 이 필드를 비워 두면 비공개 풀에서 서비스 제작자 네트워크를 사용합니다. 사용 가능한 네트워크 구성 옵션 및 영향에 대한 자세한 내용은 환경 설정하기를 참조하세요.

    7. 외부 IP 할당이 기본적으로 선택되어 있습니다. 이 옵션을 선택하면 비공개 풀이 공개 인터넷에 액세스할 수 있습니다.

    8. 만들기를 클릭합니다.

gcloud

작업자 풀 구성 파일을 gcloud 명령어로 전달하거나 구성 옵션을 직접 gcloud 명령어로 전달하는 두 가지 방법으로 gcloud를 사용하여 새 비공개 풀을 만들 수 있습니다.

작업자 풀 구성 파일을 gcloud 명령어에 전달하기

  1. 작업자 풀 구성 파일을 YAML 또는 JSON 형식으로 만듭니다.

  2. 다음 gcloud 명령어를 실행합니다. 여기서 WORKERPOOL_ID는 커스텀 작업자 풀의 고유 식별자, WORKERPOOL_CONFIG_FILE은 작업자 풀 구성 파일 이름, REGION은 작업자 풀을 만들 리전입니다.

    gcloud builds worker-pools create WORKERPOOL_ID --config-from-file WORKERPOOL_CONFIG_FILE --region REGION
    

    다음과 비슷한 출력이 표시됩니다.

    Created [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/private-pool].
    NAME                 CREATE_TIME                STATUS
    private-pool  2018-11-19T16:08:24+00:00  RUNNING
    

구성 옵션을 gcloud 명령어에 직접 전달:

다음 gcloud 명령어를 실행합니다.

    gcloud builds worker-pools create WORKERPOOL_ID \
        --project=WORKERPOOL_PROJECT_ID \
        --region=REGION \
        --peered-network=PEERED_NETWORK \
        --worker-machine-type=WORKERPOOL_MACHINE_TYPE \
        --worker-disk-size=WORKERPOOL_DISK_SIZE_GB \
        --no-public-egress

위 명령어의 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 비공개 풀의 고유 식별자입니다. 이 값은 1~63자(영문 기준)여야 하며 유효한 문자는 [a-zA-Z0-9_-]+입니다.
  • WORKERPOOL_PROJECT_ID: 비공개 풀을 만들려는 Cloud 프로젝트의 ID입니다.
  • REGION: 지원되는 리전 중 하나입니다.
  • PEERED_NETWORK: 서비스 제작자 네트워크에 피어링된 네트워크의 네트워크 리소스 URL입니다. PEERED_NETWORKprojects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME 형식이어야 합니다. 여기서 NETWORK_PROJECT_ID는 VPC 네트워크를 보유한 Cloud 프로젝트의 프로젝트 ID이고 NETWORK_NAME은 VPC 네트워크의 이름입니다. 값을 지정하지 않으면 Cloud Build가 서비스 제공업체 네트워크를 사용합니다.
  • WORKERPOOL_DISK_SIZE_GB: 비공개 풀에 연결된 디스크의 크기입니다. 100 이상이고 1,000 이하인 값을 지정합니다. 제공되지 않으면 Cloud Build에서 디스크 크기 100을 사용합니다. gcloud builds submit 중에 --disk-size를 사용하여 다른 디스크 크기를 지정하면 --worker-disk-size가 재정의됩니다.
  • WORKERPOOL_MACHINE_TYPE: 작업자의 머신 유형입니다. 비워 두면 Cloud Build에서 e2-standard-2의 기본값을 사용합니다. 지원되는 머신 유형 목록은 작업자 풀 구성 파일 스키마를 참조하세요. gcloud builds submit 중에 --machine-type을 사용하여 다른 머신 유형을 지정하면 --worker-machine-type이 재정의됩니다.
  • --no-public-egress: 이 플래그가 설정되면 외부 IP 주소 없이 비공개 풀이 생성됩니다. VPC 서비스 제어 경계 내에 비공개 풀을 만드는 경우 이 플래그를 설정합니다.

API

  1. 이름이 workerpool.json작업자 풀 구성 파일을 만듭니다.

  2. cURL을 사용하여 Cloud Build API를 호출합니다.

        curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
            -H "Content-Type: application/json" \
            https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/?workerPoolId=WORKERPOOL_ID -d @workerpool.json
    

    위의 명령어에서 자리표시자 값을 다음으로 바꿉니다.

    • WORKERPOOL_PROJECT_ID: 비공개 풀을 만들려는 Cloud 프로젝트의 ID입니다.
    • WORKERPOOL_ID: 비공개 풀의 ID입니다. 이 값은 1~63자(영문 기준)여야 하며 유효한 문자는 [a-zA-Z0-9_-]+입니다.
    • REGION: 작업자 풀을 만들기 위한 지원되는 리전 중 하나입니다.

VPC 서비스 제어 경계 내에 비공개 풀 만들기

VPC 서비스 제어 경계 내에 비공개 풀을 만드는 경우 VPC 서비스 제어 사용을 참조하세요.

비공개 풀 업데이트

IAM 권한: 이 작업을 수행하려면 Cloud Build WorkerPool 편집자 역할이 필요합니다. 이 역할을 부여하는 방법은 Cloud Build 리소스에 대한 액세스 구성을 참조하세요.

기존 비공개 풀의 작업자 디스크 크기와 작업자 머신 유형을 업데이트할 수 있습니다. 비공개 풀을 업데이트하려면 다음 안내를 따르세요.

Console

  1. Google Cloud Console에서 작업자 풀 페이지를 엽니다.

    Cloud Build 작업자 풀 페이지 열기

  2. 비공개 풀을 만든 프로젝트를 선택합니다.

  3. 작업자 풀 이름을 클릭합니다.

  4. 비공개 풀 수정 측면 패널에서 머신 유형 또는 디스크 크기를 업데이트합니다.

  5. 저장을 클릭합니다.

gcloud

작업자 풀 구성 파일 업데이트:

  1. 작업자 풀 구성 파일에서 변경할 필드를 업데이트합니다.

  2. 다음 명령어를 실행합니다. 여기서 WORKERPOOL_ID는 비공개 풀의 고유 식별자이고 WORKERPOOL_CONFIG_FILE은 작업자 풀 구성 파일의 이름입니다.

    gcloud builds worker-pools update WORKERPOOL_ID --config-from-file=WORKERPOOL_CONFIG_FILE
    

업데이트할 값을 gcloud builds worker-pools update 명령어에 직접 전달:

   gcloud builds worker-pools update WORKERPOOL_ID  \
    --worker-disk-size=WORKERPOOL_DISK_SIZE \
    --worker-machine-type=WORKERPOOL_MACHINE_TYPE

위 명령어의 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 기존 비공개 풀의 ID입니다. 이 값은 업데이트할 수 없습니다. 기존 작업자 풀 ID를 지정해야 합니다.
  • WORKERPOOL_DISK_SIZE: 업데이트된 디스크 크기입니다.
  • WORKERPOOL_MACHINE_TYPE: 업데이트된 머신 유형입니다.

API

  1. 작업자 풀 구성 파일에서 작업자 디스크 크기 및/또는 작업자 머신 유형을 업데이트합니다.

  2. cURL을 사용하여 Cloud Build API를 호출합니다. 여기에서 변수를 적절한 값으로 바꿉니다.

    curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID \
        -d @workerpool.json
    

    위의 명령어에서 자리표시자 값을 다음으로 바꿉니다.

    • WORKERPOOL_ID: 비공개 풀의 ID입니다.
    • WORKERPOOL_PROJECT_ID: 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.
    • REGION: 작업자 풀을 만들기 위한 지원되는 리전 중 하나입니다.

비공개 풀의 세부정보 보기

IAM 권한: 이 작업을 수행하려면 Cloud Build WorkerPool 뷰어 역할이 필요합니다. 이 역할을 부여하는 방법은 Cloud Build 리소스에 대한 액세스 구성을 참조하세요.

비공개 풀의 세부정보를 보려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 작업자 풀 페이지를 엽니다.

    Cloud Build 작업자 풀 페이지 열기

  2. 비공개 풀을 만든 프로젝트를 선택합니다.

  3. 작업자 풀 이름을 클릭합니다.

비공개 풀의 세부정보가 있는 비공개 풀 수정 측면 패널이 표시됩니다.

gcloud

비공개 풀의 ID를 모르는 경우 다음 명령어를 실행하여 비공개 풀의 세부정보를 나열합니다.

gcloud builds worker-pools list --project=WORKERPOOL_PROJECT_ID

여기서 WORKERPOOL_PROJECT_ID는 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.

다음과 비슷한 출력이 표시됩니다.

NAME                                                                  CREATE_TIME                STATUS
projects/[WORKERPOOL_PROJECT_ID]/locations/us-central1/workerPools/[WORKERPOOL_ID]      2018-11-19T16:08:24+00:00  RUNNING

비공개 풀 ID를 알고 있는 경우 다음 명령어를 실행하여 작업자 풀에 대한 세부정보를 확인합니다.

gcloud builds worker-pools describe \
    --project=WORKERPOOL_PROJECT_ID WORKERPOOL_ID

위의 명령어에서 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 비공개 풀의 ID입니다.
  • WORKERPOOL_PROJECT_ID: 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.

API

비공개 풀의 ID를 모르는 경우 다음 cURL 명령어를 실행하여 비공개 풀의 세부정보를 나열합니다. 여기서 WORKERPOOL_PROJECT_ID는 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools

비공개 풀 ID를 알고 있다면 다음 cURL 명령어를 실행하여 비공개 풀의 세부정보를 가져옵니다.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID

위 명령어의 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 비공개 풀의 ID입니다.
  • WORKERPOOL_PROJECT_ID: 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.
  • REGION: 작업자 풀을 만든 리전입니다.

작업자 풀 삭제

IAM 권한: 이 작업을 수행하려면 Cloud Build WorkerPool 소유자 역할이 필요합니다. 이 역할을 부여하는 방법은 Cloud Build 리소스에 대한 액세스 구성을 참조하세요.

비공개 풀을 삭제하려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 작업자 풀 페이지를 엽니다.

    Cloud Build 작업자 풀 페이지 열기

  2. 비공개 풀이 있는 행에서 휴지통 아이콘을 클릭합니다.

gcloud

비공개 풀을 삭제하려면 gcloud builds worker-pools delete 명령어를 실행합니다.

 gcloud builds worker-pools delete WORKERPOOL_ID \
     --project=WORKERPOOL_PROJECT_ID

위의 명령어에서 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 비공개 풀의 ID입니다.
  • WORKERPOOL_PROJECT_ID: 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.

비공개 풀이 삭제되면 다음과 비슷한 출력이 표시됩니다.

 Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[WORKERPOOL_ID].

API

cURL을 사용하여 Cloud Build API를 호출합니다.

  curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID

위 명령어의 자리표시자 값을 다음으로 바꿉니다.

  • WORKERPOOL_ID: 비공개 풀의 ID입니다.
  • WORKERPOOL_PROJECT_ID: 비공개 풀이 포함된 Cloud 프로젝트의 ID입니다.
  • REGION: 작업자 풀을 만든 리전입니다.

다음 단계