Cloud Number Registry 설정

이 페이지에서는 조직에서 Cloud Number Registry를 설정하는 방법을 설명합니다.

시작하기 전에

  1. 이 조직의 Cloud Number Registry에 사용할 프로젝트를 지정합니다.
  2. 이 가이드의 단계를 수행할 지정된 프로젝트를 선택합니다.
  3. 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다.

필요한 역할

Cloud Number Registry를 설정하고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud Number Registry IPAM 관리자 (roles/cloudnumberregistry.ipamAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

IPAM 관리자 범위 만들기

IPAM 관리자 범위를 만들면 Cloud Number Registry가 설정 작업을 실행하고 조직에서 지원되는 Compute Engine 리소스를 식별하여 기본 등록부 책에 추가합니다.

조직의 모든 리소스가 검색되는 데 최대 24시간이 걸릴 수 있습니다. IPAM 관리자 범위의 상태를 확인하여 리소스 검색이 완료되었는지 확인할 수 있습니다.

이 기본 레지스트리 북을 통해 클라우드 번호 레지스트리를 관리하거나 원하는 경우 추가 레지스트리 북을 만들어 리소스를 정리할 수 있습니다.

IPAM 관리자 범위 생성 시 오류가 발생하면 문제 해결을 참고하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Number Registry 페이지로 이동합니다.

    Cloud Number Registry로 이동

  2. 관리 탭을 클릭합니다.

  3. IPAM 관리자 범위 관리 패널에서 IPAM 관리자 범위 만들기를 클릭합니다.

IPAM 관리자 범위 생성 프로세스가 시작됩니다. 설정 진행 상황을 확인하려면 IPAM 관리 범위의 상태를 확인하세요.

gcloud

gcloud alpha number-registry ipam-admin-scopes create 명령어를 사용하여 IPAM 관리자 범위를 만듭니다.

Cloud Number Registry 설정 진행 상황을 확인하려면 IPAM 관리자 범위의 상태를 확인하세요.

gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
    --enabled-addon-platforms=COMPUTE_ENGINE \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

다음을 바꿉니다.

  • SCOPE_NAME: IPAM 관리자 범위의 이름
  • ORGANIZATION_ID: 관리하려는 조직의 ID 번호입니다.

IPAM 관리자 범위 상태 보기

설정 중에 관리자 범위는 다음 상태를 가질 수 있습니다.

  • SETUP_IN_PROGRESS: 설정이 시작되었지만 검색 프로세스가 완료되지 않았습니다. 조직의 모든 기존 리소스가 검색되는 데 최대 24시간이 걸릴 수 있습니다. 하지만 조직에서 생성된 새 리소스는 몇 분 이내에 검색됩니다.

  • READY_TO_USE: 검색 프로세스가 완료되고 Cloud Number Registry를 사용할 준비가 되었습니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Number Registry 페이지로 이동합니다.

    Cloud Number Registry로 이동

  2. 관리 탭을 클릭합니다.

  3. IPAM 관리자 범위 관리 패널에서 상태 필드를 확인합니다.

gcloud

gcloud alpha number-registry ipam-admin-scopes describe 명령어를 사용하여 IPAM 관리 범위에 관한 세부정보를 확인합니다.

gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
    --location=global

SCOPE_NAME을 IPAM 관리자 범위 이름으로 바꿉니다.

문제 해결

다음 섹션에서는 Cloud Number Registry를 설정할 때 발생할 수 있는 문제를 해결하는 방법을 설명합니다.

ALREADY_EXISTS 또는 INVALID_ARGUMENT 오류로 인해 IPAM 관리자 범위 생성이 실패함

이러한 오류 중 하나로 인해 IPAM 관리자 범위 생성이 실패하면 프로젝트에 IPAM 관리자 범위가 이미 있기 때문입니다.

  • 이 프로젝트에 이름이 동일한 IPAM 관리자 범위가 이미 있습니다.

    ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME'
already exists.

  • 이 프로젝트에 이름이 다른 IPAM 관리 범위가 이미 있습니다.

    INVALID_ARGUMENT: Violation in ipam_admin_scope.scopes: Scope
organizations/ORGANIZATION_ID is already administered by another ipam admin scope
'projects/PROJECT_ID/locations/global/ipamAdminScopes/EXISTING_SCOPE_NAME'

IPAM 관리자 범위 생성이 FAILED_PRECONDITION 오류로 인해 실패함

다음 오류 메시지와 함께 IPAM 관리 범위 생성이 실패하면 이 프로젝트가 이 조직의 Cloud Number Registry에 사용하도록 지정되지 않았음을 의미합니다.

FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope
organizations/ORGANIZATION_ID'

이 문제를 해결하려면 다음 단계를 따르세요.

  1. 다른 프로젝트에서 이 조직에 대해 Cloud Number Registry가 이미 설정되어 있는지 확인합니다.

  2. 이 조직에 Cloud Number Registry가 설정되어 있지 않은 경우 이 조직에서 Cloud Number Registry에 프로젝트가 이미 지정되어 있는지 확인합니다.

  3. 지정된 프로젝트가 없는 경우 조직 관리자에게 Cloud Number Registry와 함께 사용할 프로젝트를 지정해 달라고 요청하거나 액세스 권한을 부여해 달라고 요청하세요.

다음 단계