Cloud Number Registry 설정

미리보기

이 제품에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

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

시작하기 전에

1. 상위 조직의 Cloud Number Registry를 관리하는 데 사용할 프로젝트를 만들거나 선택합니다. 이 목적을 위해 전용 프로젝트를 만드는 것이 좋습니다. 자세한 내용은 제한사항을 참고하세요.

   1. Google Cloud 콘솔에서 프로젝트 선택기 페이지로 이동합니다.

      프로젝트 선택기로 이동

   2. Google Cloud 프로젝트를 선택하거나 만듭니다.

      프로젝트를 선택하거나 만드는 데 필요한 역할

      • 프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
      • 프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기
      참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

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

   API 사용 설정에 필요한 역할

   API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기

   API 사용 설정하기

3. 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다.

필요한 역할

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

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

선택사항: Cloud Number Registry가 구성되어 있는지 확인

각 조직의 프로젝트 하나만 Cloud 번호 레지스트리를 구성할 수 있습니다. 조직의 모든 프로젝트에서 조직에 Cloud 번호 등록처가 이미 구성되어 있는지 확인할 수 있습니다.

콘솔

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

   Cloud Number Registry로 이동

   • 이 조직에 Cloud Number Registry가 이미 구성되어 있으면 Cloud Number Registry를 관리하는 프로젝트로 리디렉션됩니다.
   • 이 조직에 Cloud Number Registry가 구성되어 있지 않으면 관리 범위 만들기 버튼이 표시됩니다.

gcloud

gcloud alpha number-registry ipam-admin-scopes check-availability 명령어를 사용하여 조직에 Cloud Number Registry가 이미 구성되어 있는지 확인합니다.

• Cloud Number Registry가 이미 구성된 경우 응답은 UNAVAILABLE입니다.
• 기존 구성이 없으면 응답은 AVAILABLE입니다.

gcloud alpha number-registry ipam-admin-scopes check-availability \
    --scopes=SCOPE \
    --location=global

SCOPE을 관리하려는 조직(예: organizations/12345678)으로 바꿉니다.

IPAM 관리자 범위 만들기

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

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

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

콘솔

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

Cloud Number Registry로 이동

1. 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=SCOPE \
    --location=global

다음을 바꿉니다.

• SCOPE_NAME: IPAM 관리자 범위의 이름
• SCOPE: 관리하려는 조직입니다(예: organizations/12345678).

IPAM 관리자 범위 상태 보기

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

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

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

콘솔

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

   Cloud Number Registry로 이동

2. Cloud Number Registry 관리를 클릭합니다.

3. 상태는 관리 범위 상태 필드에 표시됩니다.

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 쿼리