Cloud de Confiance용 Google Cloud CLI 설정

이 가이드에서는 Cloud de Confiance에 사용하도록 Google Cloud CLI(gcloud CLI)를 설정하는 방법을 설명합니다. gcloud CLI는 명령줄에서 Cloud de Confiance리소스를 만들고 작업을 수행할 수 있게 도와줍니다.

gcloud CLI 구성 및 사용에 대한 전반적인 내용은 Google Cloud CLI 문서를 참조하세요.

Google Cloud 설정과의 차이점

Google Cloud의 CLI 설정 및 사용에 익숙한 경우 다음에 주의하세요.

• 이 가이드에 설명된 대로 Cloud de Confiance에서 gcloud CLI를 사용하려면 몇 가지 추가적인 초기 설정이 필요합니다.
• Cloud Shell은 Cloud de Confiance에서 사용할 수 없습니다. 로컬 머신에 gcloud CLI를 설치해야 합니다.
• gcloud init를 사용하여 gcloud CLI를 한 번에 초기화하는 기능은 제공되지 않습니다.
• Cloud de Confiance에서 기능이나 제품을 사용할 수 없으면 해당 gcloud CLI 명령어와 파라미터도 사용할 수 없습니다.

시작하기 전에

Cloud de Confiance에 대한 자체 로그인 세부정보 외에도 gcloud CLI를 처음 설정하기 위해 다음이 필요합니다. 사용자가 조직 관리자가 아니면 관리자에게서 이 정보를 받아야 합니다.

• 조직의 워크로드 아이덴티티 풀 이름
• 조직의 ID 공급업체(IdP)

gcloud CLI 설치

OS별 안내에 따라 gcloud CLI를 설치합니다.

로그인 구성 파일 만들기

자신의 환경에 대한 액세스를 설정하려면 Cloud de Confiance에 사용되는 도메인과 조직에 설정된 IdP를 포함하여 gcloud CLI에 대한 JSON 구성 파일을 만들어야 합니다.

로그인 구성 파일을 만들려면 다음 안내를 따르세요.

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

  gcloud config set universe_domain s3nsapis.fr
  
  AUDIENCE=locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID
  UNIVERSE_WEB_DOMAIN="cloud.s3nscloud.fr"
  UNIVERSE_API_DOMAIN="s3nsapis.fr"
  
  gcloud iam workforce-pools create-login-config \
  $AUDIENCE \
  --universe-cloud-web-domain="$UNIVERSE_WEB_DOMAIN" \
  --universe-domain="$UNIVERSE_API_DOMAIN" \
  --output-file="wif-login-config.json"
  

  다음을 바꿉니다.

  • POOL_ID: 조직 워크로드 아이덴티티 풀의 고유 식별자입니다.
  • PROVIDER_ID: 조직의 ID 공급업체(IdP)입니다.

출력은 다음과 비슷합니다.

Created login configuration file [wif-login-config.json].

구성 파일을 만든 후에는 동일한 머신에서 로그인하는 한 이 단계를 반복할 필요가 없습니다.

gcloud CLI로 Cloud de Confiance 에 로그인

이제 Cloud de Confiance에 로그인해야 할 때마다 구성 파일을 사용할 수 있습니다.

• 명령줄에서 로그인하려면 다음 명령어를 실행합니다.

  gcloud auth login -–login-config=wif-login-config.json
  

• 애플리케이션 기본 사용자 인증 정보(ADC)(Terraform 모듈 실행에 필요)를 사용해야 하는 경우 다음 명령어를 실행합니다.

  gcloud auth application-default login --login-config=wif-login-config.json
  

로그인 세부정보로 로그인할 수 있는 웹페이지가 열립니다. 로그인한 후 문서의 남은 부분에 설명된 대로 gcloud CLI를 구성하고 사용할 수 있습니다.

(선택사항) 기본 속성 설정

gcloud CLI를 설정하면 기본 플래그 값이나 도구의 동작을 제어하는 속성에 사용할 수 있는 default라는 구성이 자동으로 제공됩니다. 선택사항이지만, gcloud CLI를 사용하기 전에 기본 프로젝트 등 일부 기본 속성을 구성하는 것이 좋습니다. 기본 속성을 설정해 두면, 명령어를 실행할 때마다 프로젝트나 기본 컴퓨팅 위치를 일일이 지정하지 않아도 되어 편리합니다.

다음 단계에서는 Google Cloud 사용자가 gcloud init으로 구성하는 것과 동일한 속성을 설정합니다.

1. 기본 프로젝트를 설정하려면 선택한 프로젝트 ID를 지정하여 다음 명령어를 실행합니다.

   gcloud config set project PROJECT_ID
   

2. Compute Engine 또는 GKE를 사용하는 경우 일부 명령어에서는 컴퓨팅 리전 또는 영역을 지정해야 합니다. 명령어 실행 시 기본 리전을 설정하려면 다음 명령어를 실행합니다.

   gcloud config set compute/region u-france-east1
   

   기본 영역을 설정하려면 다음 명령어를 실행합니다.

   gcloud config set compute/zone ZONE
   

3. 인증된 사용자를 포함하여 현재 구성의 속성을 확인하려면 다음 명령어를 실행합니다.

   gcloud config list
   

gcloud CLI 구성 관리에서 gcloud CLI 구성이 작동하는 방식과 추가 구성을 만들고 사용하는 방법을 알아볼 수 있습니다. gcloud CLI 속성 관리에서 속성 지정 방법에 대해 자세히 알아볼 수 있습니다.

(선택사항) 명령어 실행

코어 명령어를 실행하여 gcloud CLI 설치에 대한 정보를 확인합니다.

1. 사용자 인증 정보가 로컬 시스템에 저장된 계정을 나열합니다.

   gcloud auth list
   

   gcloud CLI는 사용자 인증 정보 계정 목록을 표시합니다.

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   

2. 활성 gcloud CLI 구성의 속성을 나열합니다.

   gcloud config list
   

   gcloud CLI는 속성 목록을 표시합니다.

   [core]
   account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   disable_usage_reporting = False
   project = my-project
   

3. gcloud 명령어 및 기타 주제에 대한 정보를 확인합니다.

   gcloud help
   

   예를 들어 gcloud compute instances create의 도움말을 보려면 다음 명령어를 입력합니다.

   gcloud help compute instances create
   

   gcloud CLI에서 명령어에 대한 설명, 명령어 플래그와 인수 목록, 명령어 사용 방법 예시를 포함한 도움말 항목을 표시합니다.

다음 단계

• Cloud de Confiance조직을 처음 설정하는 관리자의 경우 조직 설정에서 조직 구성 방법을 참조하세요.
• Google Cloud CLI로 수행할 수 있는 작업을 자세히 알아보려면 Google Cloud CLI 문서를 참조하세요.
• Cloud de Confiance시작하기에 대한 자세한 내용은 Cloud de Confiance시작하기를 참조하세요.