setup gcloud
v2.1.2
setup-gcloud GitHub 작업GitHub Actions 환경에서 Google Cloud SDK를 구성합니다. Google Cloud SDK에는 gcloud 및 gsutil 바이너리가 모두 포함되어 있습니다.
또는 다른 Google Cloud GitHub Actions와 기본적으로 통합하세요.
이는 공식적으로 지원되는 Google 제품이 아니며 Google Cloud 지원 계약이 적용되지 않습니다. Google Cloud 제품의 버그를 신고하거나 기능을 요청하려면 Google Cloud 지원팀에 문의하세요.
이 작업을 수행하려면 gcloud 명령어를 실행하기 위한 Google Cloud 사용자 인증 정보가 필요합니다. 자세한 내용은 승인을 참조하세요.
이 작업은 Node 20을 사용하여 실행됩니다. 자체 호스팅 GitHub Actions 실행기를 사용하는 경우 이 버전 이상을 지원하는 실행기 버전을 사용해야 합니다.
jobs :
job_id :
# Add "id-token" with the intended permissions.
permissions :
contents : ' read '
id-token : ' write '
steps :
- id : ' auth '
uses : ' google-github-actions/auth@v2 '
with :
workload_identity_provider : ' projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider '
service_account : ' [email protected] '
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
with :
version : ' >= 363.0.0 '
- name : ' Use gcloud CLI '
run : ' gcloud info ' version : (선택사항, 기본값: latest ) 설치할 Cloud SDK( gcloud )의 버전 또는 버전 제약조건을 나타내는 문자열입니다(예 "290.0.1" 또는 ">= 197.0.1" ). 기본값은 "latest" 이며, 항상 사용 가능한 최신 Cloud SDK 버전을 다운로드하고 설치합니다.
- uses: 'google-github-actions/setup-gcloud@v2'
with:
version: '>= 416.0.0'
지정된 제약 조건과 일치하는 설치된 gcloud 버전이 없는 경우 이 GitHub 작업은 여전히 제약 조건과 일치하는 사용 가능한 최신 버전을 다운로드하여 설치합니다.
Workload Identity Federation을 통해 인증하려면 버전 363.0.0 이상이 필요합니다. 워크로드 아이덴티티 제휴에 대한 지원이 필요한 경우 다음과 같이 버전 제약조건을 지정하세요.
- uses: 'google-github-actions/setup-gcloud@v2'
with:
version: '>= 363.0.0'
gcloud 버전이 필요한 기능 및 구성요소와 일치하는지 확인하는 것은 귀하의 책임입니다.
project_id : (선택사항) Google Cloud 프로젝트의 ID입니다. 제공된 경우 기본적으로 명령어에 이 프로젝트 ID를 사용하도록 gcloud가 구성됩니다. 개별 명령은 우선순위가 높은 --project 플래그를 사용하여 프로젝트를 계속 재정의할 수 있습니다. 지정하지 않으면 작업은 다른 입력 및 환경 변수를 확인하여 "최적의" 프로젝트 ID를 찾으려고 시도합니다.
install_components : (선택사항) 설치할 추가 gcloud 구성요소 목록으로, 쉼표로 구분된 문자열 목록으로 지정됩니다.
install_components: 'alpha,cloud-datastore-emulator'
skip_install : (선택사항) gcloud 설치를 건너뛰고 대신 시스템 제공 버전을 사용합니다. 지정된 경우 version 입력이 무시됩니다.
version : 설치된 gcloud 버전입니다. setup-gcloud 작업은 Cloud SDK( gcloud )를 설치합니다. GCP에 대한 인증을 구성하려면 먼저 google-github-actions/auth 작업을 사용해야 합니다. auth 작업은 애플리케이션 기본 사용자 인증 정보를 설정한 다음 setup-gcloud 작업은 이러한 사용자 인증 정보를 참조하여 gcloud 자격 증명을 구성합니다. 다음 옵션을 통해 인증할 수 있습니다.
bq 및 gsutil 도구를 인증하려면 Cloud SDK 버전 390.0.0 이상을 사용해야 합니다.
jobs :
job_id :
# Add "id-token" with the intended permissions.
permissions :
contents : ' read '
id-token : ' write '
steps :
- id : ' auth '
uses : ' google-github-actions/auth@v2 '
with :
workload_identity_provider : ' projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider '
service_account : ' [email protected] '
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
- name : ' Use gcloud CLI '
run : ' gcloud info ' jobs :
job_id :
steps :
- id : ' auth '
uses : ' google-github-actions/auth@v2 '
with :
credentials_json : ' ${{ secrets.GCP_CREDENTIALS }} '
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
- name : ' Use gcloud CLI '
run : ' gcloud info 'Google Cloud Platform에서 호스팅되는 자체 호스팅 실행기를 사용하는 경우 실행기에 연결된 서비스 계정에서 자격 증명을 자동으로 가져옵니다. 이 시나리오에서는 google-github-actions/auth 작업을 실행할 필요가 없습니다.
jobs :
job_id :
steps :
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
- name : ' Use gcloud CLI '
run : ' gcloud info ' 여러 서비스 계정을 사용하려면 setup-gcloud 사용하기 전에 사용자 인증 정보를 업데이트하는 두 번째 인증 단계가 필요합니다.
jobs :
job_id :
# Add "id-token" with the intended permissions.
permissions :
contents : ' read '
id-token : ' write '
steps :
- id : ' auth service account 1 '
uses : ' google-github-actions/auth@v2 '
with :
workload_identity_provider : ' projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider '
service_account : ' [email protected] '
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
- name : ' Use gcloud CLI '
run : ' gcloud auth list --filter=status:ACTIVE --format="value(account)" '
# [email protected]
- id : ' auth service account 2 '
uses : ' google-github-actions/auth@v2 '
with :
credentials_json : ' ${{ secrets.GCP_CREDENTIALS }} '
- name : ' Set up Cloud SDK '
uses : ' google-github-actions/setup-gcloud@v2 '
- name : ' Use gcloud CLI '
run : ' gcloud auth list --filter=status:ACTIVE --format="value(account)" '
# [email protected] 사용 가능한 최신 주요 버전을 고정하는 것이 좋습니다.
- uses : ' google-github-actions/setup-gcloud@v2 '이 작업은 의미론적 버전 관리를 따르려고 시도하지만 우리는 궁극적으로 인간이고 때로는 실수를 합니다. 실수로 인한 주요 변경을 방지하기 위해 특정 버전에 고정할 수도 있습니다.
- uses : ' google-github-actions/[email protected] ' 그러나 버전 번호를 명시적으로 업데이트하지 않으면 자동 보안 업데이트나 새로운 기능을 얻을 수 없습니다. MAJOR 및 MAJOR.MINOR.PATCH 버전만 게시합니다. MAJOR.MINOR 에 대한 부동 별칭은 없습니다 .
