App Engine용 Google Cloud 프로젝트 설정

Google Cloud 프로젝트에는 다른 Google Cloud 리소스뿐 아니라 App Engine 애플리케이션도 포함됩니다.

Google Cloud 콘솔, Google Cloud CLI, App Engine Admin API에서 이 주제에서 다루는 일반 작업을 비롯한 모든 관리 작업을 수행할 수 있습니다.

App Engine 가변형 환경에 앱을 배포하려면 일반적으로 먼저 다음을 만들거나 설정해야 합니다.

1. Google Cloud 프로젝트
2. App Engine 애플리케이션
3. 결제 계정

프로젝트 및 애플리케이션 만들기

새 Google Cloud 프로젝트 및 App Engine 애플리케이션을 선택하거나 생성하여 설정, 사용자 인증 정보, 앱의 메타데이터 모음을 만들고 관리할 수 있습니다.

소유자 역할만 Google Cloud 프로젝트에 App Engine 애플리케이션을 만들 수 있으며 이 애플리케이션이 있어야 다른 계정이 애플리케이션에서 태스크를 수행할 수 있습니다. 예를 들어 App Engine 배포자 역할이 있는 계정이 서비스 계정을 사용하여 앱을 배포하려면 먼저 App Engine 애플리케이션을 만들어야 합니다.

중요: 각 Google Cloud 프로젝트에는 App Engine 애플리케이션 한 개만 포함될 수 있으며 App Engine 애플리케이션이 생성된 후에는 애플리케이션 위치를 변경할 수 없습니다.

gcloud

Google Cloud CLI를 설치한 후 Google Cloud 프로젝트 소유자 역할이 있는 계정은 다음 gcloud 명령어를 실행하여 Google Cloud 프로젝트와 App Engine 애플리케이션을 만들 수 있습니다.

1. 다음 명령어를 실행하여 Google Cloud 프로젝트를 만듭니다.

   gcloud projects create PROJECT_ID

   PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

2. 다음 명령어를 실행하여 리전을 선택하고 App Engine 애플리케이션을 만듭니다.

   gcloud app create

   App Engine 위치에 대한 자세한 내용

3. Google Cloud 콘솔의 결제 페이지에서 결제를 사용 설정합니다. 자세한 내용은 결제 사용 설정을 참조하세요.

   팁:

   • 앱 배포에 gcloud app deploy 명령어를 사용하는 경우 gcloud CLI는 Google Cloud 프로젝트에 App Engine 애플리케이션이 포함되도록 하고 필요한 경우 리전을 선택하라는 메시지를 표시합니다.
   • Google Cloud 프로젝트에 App Engine 애플리케이션이 있는지 확인하려면 gcloud app describe 명령어를 실행하면 됩니다.

API

Google Cloud 프로젝트와 App Engine 애플리케이션을 프로그래매틱 방식으로 만들려면 Cloud Resource Manager API와 App Engine Admin API를 모두 사용합니다.

1. Google Cloud 프로젝트를 만들려면 새 프로젝트 만들기를 참조하세요.

2. App Engine 애플리케이션을 만들려면 App Engine 애플리케이션 만들기를 참조하세요.

3. Google Cloud 콘솔의 결제 페이지에서 결제를 사용 설정합니다. 자세한 내용은 결제 사용 설정을 참조하세요.

콘솔

결제를 사용 설정하여 Google Cloud 프로젝트 및 App Engine 애플리케이션을 만들려면 다음 안내를 따르세요.

1. App Engine 페이지로 이동합니다.

   App Engine으로 이동

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

3. 앱 만들기 페이지에서 리전 및 서비스 계정을 선택하고 결제를 사용 설정합니다.

   1. 리전을 선택하여 App Engine 애플리케이션을 배치할 위치를 지정합니다.
      App Engine 위치에 대해 자세히 알아보기
   2. ID 및 API 액세스에서 앱의 서비스 계정을 선택합니다.
   3. 결제 계정을 선택하거나 만들어 프로젝트에서 결제를 사용 설정합니다.

App Engine 애플리케이션이 생성되고 프로젝트에서 결제가 사용 설정되면 대시보드 페이지가 열립니다.

App Engine 위치

App Engine은 리전을 기반으로 합니다. 즉, 앱을 실행하는 인프라가 특정 리전에 위치해 있으며 해당 리전 내의 모든 영역에서 중복으로 사용할 수 있도록 Google이 관리합니다.

앱을 실행하는 리전을 선택하는 데 있어 중요한 기준은 지연 시간, 가용성 또는 내구성 요구사항입니다. 일반적으로 앱 사용자와 가장 가까운 리전을 선택할 수 있지만 App Engine을 사용할 수 있는 위치와 앱에서 사용하는 다른 Google Cloud 제품 및 서비스의 위치도 고려해야 합니다. 여러 위치에서 서비스를 사용하면 앱의 지연 시간과 가격 책정에 영향을 미칠 수 있습니다.

앱의 리전을 설정한 후에는 변경할 수 없습니다.

참고: App Engine 명령어 및 Google Cloud 콘솔에서 europe-west 및 us-central이라고 부르는 두 위치를 Google 문서에서는 각각 europe-west1 및 us-central1이라고 부릅니다.

App Engine 애플리케이션을 이미 만든 경우 다음 중 한 가지 방법으로 해당 리전을 볼 수 있습니다.

• gcloud app describe 명령어를 실행합니다.

• Google Cloud 콘솔에서 App Engine 대시보드를 엽니다. 이 리전은 페이지 상단 근처에 표시됩니다.

확인

결제 사용 설정

앱을 배포하려면 결제를 사용해야 합니다. 무료 할당량을 초과하지 않으면 계정에 비용이 청구되지 않습니다. 애플리케이션에 무료 할당량을 초과하는 리소스가 필요한 경우 추가 사용료가 부과됩니다.

Google Cloud 프로젝트를 만들 때 결제 계정이 있으면 해당 프로젝트에서 결제가 자동으로 사용 설정됩니다.

Google Cloud 프로젝트에서 결제를 사용 설정하려면 다음 안내를 따르세요.

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

   결제로 이동

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

3. 결제 계정이 있는지 또는 선택한 Google Cloud 프로젝트가 계정과 연결되어 있는지에 따라 결제 페이지에 다음 중 하나가 표시됩니다.

   • 선택한 Google Cloud 프로젝트에 대해 결제가 이미 사용 설정된 경우, 결제 계정의 세부정보가 나열됩니다.

   • 결제 계정이 없는 경우 결제 계정을 만들고 선택한 Google Cloud 프로젝트에 연결하라는 메시지가 표시됩니다.

   • 결제 계정이 있고 선택한 Google Cloud 프로젝트가 아직 결제 계정과 연결되어 있지 않으면 결제를 사용 설정하라는 메시지가 표시됩니다. 취소를 클릭한 후 계정 만들기를 클릭하여 새 결제 계정을 만들고 연결할 수도 있습니다.

결제를 사용 설정하면 청구 금액 한도가 없어집니다. 애플리케이션 비용을 보다 효율적으로 관리하려면 예산을 만들고 알림을 설정하면 됩니다.

결제 관리

결제 페이지를 사용하여 결제 계정을 관리합니다.

1. Google Cloud 콘솔의 결제 페이지로 이동합니다.

   결제로 이동

2. 관리할 계정을 선택하고 해당 페이지로 이동하여 다음 관리 작업을 수행합니다.

   • 개요 페이지에서 결제 계정 개요를 확인하고, 청구 금액을 결제하고, 결제 계정 관리자를 추가합니다.
   • 예산 및 알림 페이지에서 예산과 알림을 만듭니다.
   • 거래 페이지에서 거래 내역을 확인하고 인보이스를 다운로드합니다.
   • 결제 내보내기 페이지에서 결제 데이터를 BigQuery 데이터 세트로 내보냅니다.
   • 결제 설정 페이지에서 결제 계정과 연락처를 구성합니다.
   • 결제 수단 페이지에서 결제 수단을 설정합니다.

결제에 대한 자세한 내용은 가격 책정 페이지를 참조하세요.

예산 만들기 및 알림 설정

Google Cloud 프로젝트 예산을 만들면 예상하지 못한 많은 금액이 청구되는 상황을 방지하고 한 곳에서 모든 Google Cloud 청구를 모니터링할 수 있습니다. 예산 기능을 사용하면 청구 금액이 일정 금액 초과 시 결제 관리자가 이메일 알림을 받아볼 수 있습니다.

예산을 만들고 Google Cloud 프로젝트에 알림을 설정하려면 다음 안내를 따르세요.

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

   결제로 이동

2. 예산을 만들 결제 계정을 클릭합니다.

3. 예산 및 알림을 클릭한 후 예산 만들기를 클릭하여 Google Cloud 프로젝트의 예산을 만들기 시작합니다.

4. 예산 설정 섹션에서 예산을 정의한 후 다음 예산 알림 설정 섹션에서 이메일 알림을 수신할 백분율을 지정합니다.

5. 저장을 클릭하여 예산을 설정하고 Google Cloud 프로젝트에 대한 알림을 사용 설정합니다. Google Cloud 프로젝트가 여러 개이면 각 프로젝트에서 개별적으로 예산과 알림을 설정해야 합니다.

프로젝트의 프로젝트 ID 설정

일부 App Engine 표준 환경 런타임에서는 프로젝트의 app.yaml 파일에 Google Cloud 프로젝트 ID('앱 ID'라고도 함)를 지정했을 수 있습니다.

프로젝트 ID를 몇 가지 방법으로 지정할 수 있습니다.

• Google Cloud CLI를 설치할 때 gcloud init를 사용합니다. gcloud CLI의 기본 프로젝트 ID를 보려면 gcloud config list를 실행합니다.
• gcloud config set project [YOUR_PROJECT_ID] 명령어를 사용하여 gcloud CLI의 기본 프로젝트 ID를 설정합니다.
• 앱을 배포할 때 --project 플래그를 사용합니다(예: gcloud app deploy --project [YOUR_PROJECT_ID]).

자바 런타임을 사용하는 경우 IntelliJ용 Google Cloud 플러그인 또는 Eclipse용 Google Cloud 플러그인을 사용하여 배포 중에 프로젝트 ID를 지정할 수 있습니다.

애플리케이션 중지

앱의 인스턴스 실행과 요청 처리를 중지하려면 App Engine 애플리케이션을 중지합니다. 앱을 중지해도 데이터는 손실되지 않으며 구성 설정도 변경되지 않습니다. App Engine 애플리케이션을 다시 사용 설정하기만 하면 인스턴스가 시작되고 해당 앱으로 트래픽이 계속 제공됩니다.

표준 환경과 가변형 환경 모두에서 앱의 리소스가 중지되므로, 더 이상 요금이 청구되지 않습니다. 그러나 Google Cloud 프로젝트의 다른 서비스에 대한 요금은 계속 청구될 수 있습니다. 예를 들어 저장된 데이터에 대한 스토리지 요금이 청구될 수 있습니다.

앱이 요청을 처리 중인 경우에는 태스크 완료를 위해 계속 앱이 작동하며, 앱이 완전히 중지될 때까지 최대 1시간이 소요될 수 있습니다.

App Engine 애플리케이션을 중지하려면 다음 단계를 따르세요.

1. 애플리케이션 설정 페이지로 이동합니다.

   애플리케이션 설정으로 이동

2. 애플리케이션 사용 중지를 클릭하고 표시되는 메시지를 따릅니다.

앱에서 계속 요청을 처리하도록 하려면 동일한 애플리케이션 설정 페이지로 돌아간 후 애플리케이션 사용 설정을 클릭하여 App Engine 애플리케이션을 사용 설정합니다.

애플리케이션을 중지하면 처리 중인 모든 요청이 중지되지만 데이터와 상태는 유지됩니다. 이미 발생한 요금 또는 프로젝트에서 실행 중인 다른 서비스(예: Cloud SQL)에 대한 요금은 계속 청구됩니다. 프로젝트에서 사용된 모든 리소스를 해제하려면 프로젝트를 종료합니다.

프로젝트 종료

결제를 중지하고 Google Cloud 프로젝트에서 사용 중인 모든 Google Cloud 리소스를 해제하려면 해당 프로젝트를 종료합니다.

gcloud

Google Cloud CLI를 설치한 후 다음 gcloud 명령어를 실행하여 Google Cloud 프로젝트를 종료합니다.

gcloud projects delete PROJECT_ID

PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

API

Google Cloud 프로젝트를 프로그래매틱 방식으로 종료하는 방법은 Cloud Resource Manager API의 프로젝트 종료를 참조하세요.

콘솔

Google Cloud 콘솔을 사용하여 Google Cloud 프로젝트를 종료하려면 다음 안내를 따르세요.

1. 프로젝트 페이지로 이동합니다.

   프로젝트로 이동

2. 종료하려는 Google Cloud 프로젝트를 선택하고 를 클릭합니다.

Google Cloud 프로젝트 관리에 대한 자세한 내용은 Cloud Resource Manager: 프로젝트 만들기, 종료, 복원을 참조하세요.