App Engine 표준 환경의 Go 1.12+ 빠른 시작

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google이 할당하는 코드입니다. 기존 앱은 App Engine URL에 REGION_ID.r을 포함하는 것이 선택사항이고, 신규 앱은 모두 곧 필수가 될 예정입니다.

원활한 전환을 위해 리전 ID를 사용하도록 App Engine을 천천히 업데이트하고 있습니다. 아직 Google Cloud 프로젝트가 업데이트되지 않은 경우에는 앱의 리전 ID가 표시되지 않습니다. 기존 앱에서 ID는 선택사항이므로 기존 앱에서 리전 ID를 사용할 수 있게 되더라도 URL을 업데이트하거나 다른 변경을 수행할 필요가 없습니다.

리전 ID에 대해 자세히 알아보세요.

이 페이지는 짧은 메시지를 표시하는 기본적인 App Engine 애플리케이션 배포 방법을 보여줍니다. App Engine의 Go에 대한 더 자세한 소개는 앱 빌드를 참조하세요.

App Engine이 자신에게 적합한 컴퓨팅 옵션인가요? Google Cloud에서 애플리케이션을 호스팅하는 다른 옵션을 확인해 보세요.

비용

이 가이드의 실행에는 비용이 발생하지 않습니다. 이 샘플 앱을 실행하는 것만으로는 무료 할당량이 초과되지 않습니다.

시작하기 전에

이 빠른 시작을 실행하고 배포하기 전에 다음과 같이 Cloud SDK를 설치한 후 App Engine용 Cloud 프로젝트를 설정합니다.

  1. Cloud SDK를 다운로드하여 설치합니다.

    SDK 다운로드

    참고: Cloud SDK가 이미 설치되어 있으면 다음 명령어를 실행하여 업데이트하세요.

    gcloud components update
    
  2. 새 프로젝트를 만듭니다.

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    [YOUR_PROJECT_ID]를 프로젝트를 고유하게 식별하는 문자열로 바꿉니다. 예를 들면 my-project-24입니다.

    프로젝트가 만들어졌는지 확인합니다.

    gcloud projects describe [YOUR_PROJECT_ID]
    

    다음과 같은 프로젝트 세부정보가 표시됩니다.

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. 프로젝트로 App Engine 앱을 초기화하고 리전을 선택합니다.

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    메시지가 표시되면 App Engine 애플리케이션을 배치할 리전을 선택합니다.

  4. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 애플리케이션을 App Engine에 배포하려면 결제 계정을 프로젝트에 연결해야 합니다.

    결제 사용 설정

  5. 다음 기본 요건을 설치합니다.

    • 다음 명령어를 실행하여 Go 1.12+용 App Engine 확장 프로그램이 포함된 gcloud 구성요소를 설치합니다.

      gcloud components install app-engine-go
      

App Engine 위치

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

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

다음 리전에서 App Engine을 사용할 수 있습니다.

  • northamerica-northeast1(몬트리올)
  • us-central(아이오와)
  • us-west2(로스앤젤레스)
  • us-west3(솔트레이크시티)
  • us-west4(라스베이거스)
  • us-east1(사우스캐롤라이나)
  • us-east4(북버지니아)
  • southamerica-east1(상파울루)
  • europe-west(벨기에)
  • europe-west2(런던)
  • europe-west3(프랑크푸르트)
  • europe-west6(취리히)
  • asia-northeast1(도쿄)
  • asia-northeast2(오사카)
  • asia-northeast3(서울)
  • asia-east2(홍콩)
  • asia-south1(뭄바이)
  • australia-southeast1(시드니)

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

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

이 빠른 시작에서는 개발자에게 Go 프로그래밍 언어에 대한 지식이 있고 Go가 설치되어 있다고 가정합니다.

Hello World 앱 다운로드

간단한 Go용 Hello World 앱을 만들어 Google Cloud에 앱을 배포해 보겠습니다. 로컬 머신에 Hello World 앱을 다운로드하려면 다음 단계를 따르세요.

샘플 앱을 다운로드하고 앱 디렉터리로 이동합니다.

  1. Hello World 샘플 앱 저장소를 클론합니다.

    git clone https://github.com/GoogleCloudPlatform/golang-samples.git
    

    또는 zip 파일로 샘플을 다운로드하고 압축을 풉니다.

  2. 샘플 코드가 있는 디렉터리로 변경합니다.

    cd golang-samples/appengine/go11x/helloworld
    

App Engine에 Hello World 배포

  1. golang-samples/appengine/go11x/helloworld 디렉터리에서 다음 명령어를 실행하여 App Engine에 Hello World 앱을 배포합니다.

    gcloud app deploy
    
  2. https://PROJECT_ID.REGION_ID.r.appspot.com에서 라이브 앱을 봅니다.

    gcloud app browse
    

이제 App Engine 인스턴스에서 실행되는 웹 서버가 Hello, World! 메시지를 전달합니다.

수고하셨습니다. Go 웹 서비스를 App Engine에 배포해 보았습니다.

삭제

App Engine에 대해 계속 알아보려면 Cloud 프로젝트를 유지하고 앱 빌드를 따르세요.

또는 Cloud 프로젝트를 삭제하여 프로젝트 내에 사용된 모든 리소스에 대한 비용 청구를 중지할 수 있습니다.

  1. Cloud Console에서 리소스 관리 페이지로 이동합니다.

    리소스 관리 페이지로 이동

  2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제 를 클릭합니다.
  3. 대화상자에서 프로젝트 ID를 입력한 다음 종료를 클릭하여 프로젝트를 삭제합니다.

다음 단계

App Engine에 웹 서비스 배포를 완료했습니다. 이제 앱 빌드를 진행하여 App Engine의 Go에 대해 자세히 알아보세요.