クイックスタート: App Engine スタンダード環境で Go 1.12+ アプリを作成する

App Engine スタンダード環境で Go 1.12+ アプリを作成する

リージョン ID

REGION_ID は、アプリの作成時に選択したリージョンに基づいて Google が割り当てる省略形のコードです。一部のリージョン ID は、一般的に使用されている国や州のコードと類似しているように見える場合がありますが、このコードは国または州に対応するものではありません。2020 年 2 月以降に作成されたアプリの場合、REGION_ID.r が App Engine の URL に含まれています。この日付より前に作成されたアプリの場合、URL のリージョン ID は省略可能です。

詳しくは、リージョン ID をご覧ください。

このページでは、短いメッセージを表示する基本的な App Engine アプリケーションをデプロイする方法を説明します。App Engine での Go の概要については、アプリの作成をご覧ください。

App Engine が最適なコンピューティング オプションかどうか不明な場合は、Google Cloud 上でアプリケーションをホストするためのその他の方法をご覧ください。

費用

このガイドの実行に伴う費用はありません。このサンプルアプリを実行するだけなら、無料の割り当てを超過することはありません。

始める前に

  1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  3. Google Cloud プロジェクトで課金が有効になっていることを確認します

  4. Cloud Build API を有効にします。

    API を有効にする

  5. Google Cloud CLI をインストールします。
  6. gcloud CLI を初期化するには:

    gcloud init
  7. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  8. Google Cloud プロジェクトで課金が有効になっていることを確認します

  9. Cloud Build API を有効にします。

    API を有効にする

  10. Google Cloud CLI をインストールします。
  11. gcloud CLI を初期化するには:

    gcloud init

追加の前提条件

  1. プロジェクトで App Engine アプリを初期化し、そのリージョンを選択します。

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    表示された指示に従って、App Engine アプリケーションを配置するリージョンを選択します。

  2. 次の前提条件をインストールします。

    • 次のコマンドを実行して、Go 1.12+ 用の App Engine 拡張機能を含む gcloud コンポーネントをインストールします。

      gcloud components install app-engine-go
      

App Engine のロケーション

App Engine はリージョナルです。つまり、アプリを実行するインフラストラクチャは特定のリージョンに配置され、そのリージョン内のすべてのゾーンで冗長的に利用できるように Google が管理しています。

レイテンシ、可用性、耐久性の要件を満たすことが、アプリを実行するリージョンを選択する際の主な要素になります。一般的には、アプリのユーザーに最も近いリージョンを選択できますが、App Engine が使用可能なロケーションと、アプリが使用するその他の Google Cloud プロダクトおよびサービスのロケーションを考慮する必要があります。使用するサービスが複数のロケーションにまたがっていると、アプリのレイテンシだけでなく、料金にも影響する可能性があります。

設定したアプリのリージョンは変更できません。

すでに 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 ディレクトリから次のコマンドを実行し、Hello World アプリを App Engine にデプロイします。

    gcloud app deploy
    
  2. https://PROJECT_ID.REGION_ID.r.appspot.com で公開されているライブアプリを表示します。

    gcloud app browse
    

Hello, World! メッセージが、App Engine インスタンス上で実行されているウェブサーバーによって配信されます。

これで完了です。App Engine に Go ウェブサービスが正常にデプロイされました。

クリーンアップ

App Engine の学習を続ける場合は、Cloud プロジェクトを維持し、アプリのビルドの手順を進めてください。

あるいは、Cloud プロジェクトを削除して、そのプロジェクト内のすべてのリソースへの課金を停止することもできます。

  1. Google Cloud コンソールで、[リソースの管理] ページに移動します。

    [リソースの管理] に移動

  2. プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
  3. ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

次のステップ

App Engine にウェブサービスをデプロイすることができました。次にアプリの作成を参照して、App Engine での Go のさらに詳しい手順を理解しましょう。