Service Management API 시작하기

이 페이지에서는 Service Management API를 사용하도록 개발 환경을 설정하는 방법을 설명합니다. Service Management API(단순한 Google Cloud Console 웹 UI 사용과 다름)를 사용하기 위한 가장 간단하고 대부분의 사용 사례에 가장 적합한 방법은 gcloud 명령줄 인터페이스를 사용하는 것입니다. Service Management API와 달리 프로그래밍해야 하는 경우에는 제공된 클라이언트 라이브러리 중에 하나를 사용하는 것이 좋습니다. API를 실험하려면 아래의 대체 설정 안내를 따르고 curl 명령어를 사용하여 전체 애플리케이션 개발 환경을 설정하지 않고도 API를 사용할 수 있습니다.

참고: Cloud Endpoints를 사용하여 서비스를 만드는 경우에는 관련 Endpoints 빠른 시작에 따라 Cloud Endpoints용 Service Management API를 설정하고 시작하는 방법을 알아보세요.

gcloud를 사용하여 설정

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

3. Service Management API 사용 설정

   API 사용 설정

4. Google Cloud CLI를 설치합니다.

5. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

6. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

7. Service Management API 사용 설정

   API 사용 설정

8. Google Cloud CLI를 설치합니다.

9. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

API를 직접 호출하도록 설정

이 섹션에서는 curl 명령어를 사용해서 Service Management API를 실험할 수 있도록 로컬 환경을 설정하는 데 필요한 기본 단계를 설명합니다. 이는 Service Management API에서 프로그래밍해야 하는 개발자를 대상으로 합니다.

초기 설정

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
2. Google Cloud CLI를 설치합니다.

3. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

4. Google Cloud 프로젝트를 만들거나 선택합니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   • Google Cloud 프로젝트를 만듭니다.

     gcloud projects create PROJECT_ID

     PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.

   • 만든 Google Cloud 프로젝트를 선택합니다.

     gcloud config set project PROJECT_ID

     PROJECT_ID를 Google Cloud 프로젝트 이름으로 바꿉니다.

5. Service Management API를 사용 설정합니다.

   gcloud services enable servicemanagement.googleapis.com

6. Google 계정에 역할을 부여합니다. 다음 각 IAM 역할에 대해 다음 명령어를 한 번씩 실행합니다. roles/servicemanagement.admin

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

   • PROJECT_ID를 프로젝트 ID로 바꿉니다.
   • EMAIL_ADDRESS를 이메일 주소로 바꿉니다.
   • ROLE을 각 개별 역할로 바꿉니다.
7. Google Cloud CLI를 설치합니다.

8. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

9. Google Cloud 프로젝트를 만들거나 선택합니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   • Google Cloud 프로젝트를 만듭니다.

     gcloud projects create PROJECT_ID

     PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.

   • 만든 Google Cloud 프로젝트를 선택합니다.

     gcloud config set project PROJECT_ID

     PROJECT_ID를 Google Cloud 프로젝트 이름으로 바꿉니다.

10. Service Management API를 사용 설정합니다.

    gcloud services enable servicemanagement.googleapis.com

11. Google 계정에 역할을 부여합니다. 다음 각 IAM 역할에 대해 다음 명령어를 한 번씩 실행합니다. roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

    • PROJECT_ID를 프로젝트 ID로 바꿉니다.
    • EMAIL_ADDRESS를 이메일 주소로 바꿉니다.
    • ROLE을 각 개별 역할로 바꿉니다.

curl로 테스트

1. Google REST API를 호출하기 위한 간편한 셸 별칭을 정의합니다.

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. 공개적으로 액세스 가능한 서비스를 나열해 봅니다.

   $ gcurl https://servicemanagement.googleapis.com/v1/services
   

   서비스 목록이 보이면 설정에 성공한 것입니다.

다음 단계

관리형 서비스를 만드는 중이며 Cloud Endpoints를 사용 중이지 않은 경우:

1. 서비스 만들기 및 삭제에 따라 관리형 서비스를 만듭니다. 최상위 수준의 관리형 서비스 리소스가 만들어집니다.

2. 서비스 구성 관리에 따라 서비스 구성을 제출하여 서비스에서 사용되는 기능을 설명합니다.

   참고: 서비스 구성은 제출 후 바로 적용되지 않습니다. 구성 출시를 위한 3단계를 수행해야 합니다.

3. 서비스 구성 출시에 따라 서비스 구성을 배포합니다.