App Engine フレキシブル環境での Java のクイックスタート

Python |Java |Node.js |Go |Ruby |PHP |.NET

このクイックスタートでは、短いメッセージを表示する小さな App Engine アプリを作成する方法について説明します。

始める前に

このクイックスタートでは、Java SE 8 Development Kit（JDK）がインストール済みであることを前提としています。

このクイックスタートを実行してデプロイする前に、Cloud SDK をインストールして、App Engine 用に GCP プロジェクトを設定します。

Cloud SDK をダウンロードしてインストールします。
SDK をダウンロード
注: Cloud SDK がすでにインストールされている場合は、次のコマンドを実行して更新します。
```
gcloud components update
```

新しいプロジェクトを作成します。

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

プロジェクトが作成されたことを確認します。

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

プロジェクトで App Engine アプリを初期化し、そのリージョンを選択します。
```
gcloud app create --project=[YOUR_PROJECT_ID]
```
プロンプトが表示されたら、App Engine アプリケーションを配置するリージョンを選択します。

注: アプリのリージョンを設定した後で変更することはできません。
プロジェクトで課金が有効になっていることを確認します。アプリケーションを App Engine にデプロイするには、課金アカウントをプロジェクトにリンクする必要があります。

課金を有効にする

フレキシブル環境でデプロイすると、有効である間は費用が発生します。完了するごとにプロジェクトをクリーンアップして、継続的な費用が発生しないようにしてください。
次の前提条件をインストールします。
- Git をダウンロードしてインストールします。
- App Engine コンポーネントをインストールします。
```
gcloud components install app-engine-java
```
- Maven をインストールします。このクイックスタートでは、Apache Maven バージョン 3.5 以降を使用してサンプルアプリの構築、実行、デプロイを行います。Maven のインストールについては、Apache Maven および App Engine プラグインを使用するをご覧ください。

App Engine のロケーション

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

レイテンシ、可用性、耐久性の要件を満たすことが、アプリを実行するリージョンを選択する際の主な要素になります。通常は、アプリのユーザーに最も近いリージョンを選択しますが、アプリで使用されている他の GCP プロダクトやサービスのロケーションも考慮する必要があります。使用するサービスが複数のロケーションにまたがっていると、アプリのレイテンシだけでなく、料金にも影響します。

App Engine は次のリージョンで利用できます。

northamerica-northeast1（モントリオール）
us-central（アイオワ）
us-west2（ロサンゼルス）
us-east1（サウスカロライナ）
us-east4（北バージニア）
southamerica-east1（サンパウロ）
europe-west（ベルギー）
europe-west2（ロンドン）
europe-west3（フランクフルト）
europe-west6（チューリッヒ）
asia-northeast1（東京）
asia-northeast2（大阪）
asia-east2（香港）
asia-south1（ムンバイ）
australia-southeast1（シドニー）

アプリのリージョンを設定した後で変更することはできません。

App Engine アプリケーションがすでに作成されている場合は、gcloud app describe コマンドを実行するか、GCP Console の App Engine ダッシュボードを開くと、そのアプリケーションに設定されているリージョンを確認できます。App Engine アプリケーションのリージョンは http://[YOUR_PROJECT_ID].appspot.com に表示されています。

Hello World アプリをダウンロードする

Java 用のシンプルな Hello World アプリが用意されています。これを使用して、Google Cloud Platform へのアプリのデプロイをすぐに試すことができます。

Hello World サンプルアプリリポジトリのクローンをローカルマシンに作成します。
```
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
```
または、zip 形式のサンプルをダウンロードして、ファイルを抽出します。
サンプルコードが含まれているディレクトリに移動します。
```
cd java-docs-samples/flexible/helloworld
```

ローカルマシンで Hello World を実行する

Spring Boot Maven プラグインを使用して、ローカルの Tomcat ウェブサーバーを起動します。
```
mvn spring-boot:run
```
ウェブブラウザに次のアドレスを入力します。

http://localhost:8080

サンプルアプリから Hello World というメッセージがページに表示されます。ターミナルウィンドウで Ctrl+C キーを押してウェブサーバーを終了します。

Hello World を App Engine にデプロイして実行する

App Engine フレキシブル環境にアプリをデプロイするには:

helloworld ディレクトリで次のコマンドを実行して、Hello World アプリをデプロイします。
```
gcloud config set project YOUR_PROJECT_ID
mvn appengine:deploy
```
ブラウザを起動し、http://YOUR_PROJECT_ID.appspot.com にアクセスしてアプリを表示します。
```
gcloud app browse
```
ここで、YOUR_PROJECT_ID は、GCP のプロジェクト ID です。

今回、Hello World メッセージが表示されるページは、App Engine インスタンスで実行されているウェブサーバーから配信されます。

これで完了です。 App Engine フレキシブル環境に最初の Java アプリをデプロイできました。

クリーンアップの詳細については、以下の説明をご覧ください。また、活用できる次のステップへのリンクも併せてご覧ください。

クリーンアップ

課金されないようにするには、GCP プロジェクトを削除してプロジェクト内のすべてのリソースへの課金を停止します。

GCP Console で [プロジェクト] ページに移動します。
プロジェクトページに移動
プロジェクトリストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

次のステップ

プラットフォーム全体について学ぶ

App Engine アプリの開発とデプロイについて概要を把握したので、GCP の他の部分についても確認します。すでに Cloud SDK がインストールされているため、Cloud SQL、Cloud Storage、Cloud Firestore などと連携するツールの利用が可能になっています。

App Engine だけでなくプラットフォーム全体を使用するアプリの作成方法を学ぶチュートリアルについては、Bookshelf アプリの作成に関するクイックスタートをご覧ください。

App Engine フレキシブル環境について学習する

App Engine についてさらに理解を深めるためのトピックをご紹介します。

Hello World コードレビュー

Hello World は、サービスが 1 つだけ含まれ、バージョンも 1 つだけで、すべてのコードがアプリのルートディレクトリにあるという、最もシンプルな App Engine アプリです。このセクションでは、このアプリの各ファイルを詳しく説明します。

`HelloServlet.java`

HelloServlet.java ファイルでは、アプリがリクエストをリッスンする場所を記述する URL パターンを指定し、すべてのリクエストに対して「Hello World」というメッセージで応答します。

helloworld-servlet/src/main/java/com/example/appengine/gettingstartedjava/helloworld/HelloServlet.java

GitHub で表示

@SuppressWarnings("serial")
@WebServlet(name = "helloworld", value = "/")
public class HelloServlet extends HttpServlet {

  @Override
  public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
    PrintWriter out = resp.getWriter();
    out.println("Hello, world - Flex Servlet");
  }
}

`app.yaml`

app.yaml ファイルには、アプリのデプロイ構成が記述されています。

helloworld-servlet/src/main/appengine/app.yaml

GitHub で表示

runtime: java
env: flex

handlers:
- url: /.*
  script: this field is required, but ignored

runtime_config:  # Optional
  jdk: openjdk8
  server: jetty9

manual_scaling:
  instances: 1

この例では、このアプリによって使用されるランタイムを app.yaml で指定しています。また、env: flex を設定することで、このアプリがフレキシブル環境を使用することを指定しています。

Java ランタイムの機能の詳細については、Java 8 / Jetty 9.3 ランタイムをご覧ください。

`pom.xml`

Hello World には pom.xml ファイルも含まれており、ここには依存関係やビルドターゲットなどのプロジェクト情報が記述されています。

helloworld-servlet/pom.xml

GitHub で表示

<project>                               <!-- REQUIRED -->

  <modelVersion>4.0.0</modelVersion>    <!-- REQUIRED -->
  <packaging>war</packaging>            <!-- REQUIRED -->

  <groupId>com.example.flex.helloworld</groupId>
  <artifactId>helloworld-servlet</artifactId> <!-- Name of your project -->
  <version>1.0-SNAPSHOT</version>       <!-- xx.xx.xx -SNAPSHOT means development -->

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source> <!-- REQUIRED -->
    <maven.compiler.target>1.8</maven.compiler.target> <!-- REQUIRED -->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <failOnMissingWebXml>false</failOnMissingWebXml> <!-- REQUIRED -->
    <appengine.maven.plugin>1.3.2</appengine.maven.plugin>
    <jetty.maven.plugin>9.4.3.v20170317</jetty.maven.plugin>
  </properties>

  <parent>                              <!-- Get parameters and allow bulk testing -->
    <artifactId>getting-started-java</artifactId>
    <groupId>com.example</groupId>
    <version>1.0.0</version>
    <relativePath>..</relativePath>
  </parent>

  <dependencies>
    <dependency>                        <!-- REQUIRED -->
      <groupId>javax.servlet</groupId>  <!-- Java Servlet API -->
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>           <!-- Provided by the Jetty Servlet Container -->
    </dependency>
  </dependencies>

  <build>
    <!-- For hot reload of the web application when using an IDE Eclipse / IDEA -->
    <outputDirectory>${project.build.directory}/${project.build.finalName}/WEB-INF/classes</outputDirectory>

    <plugins>

      <plugin>                          <!-- Used for local debugging -->
        <groupId>org.eclipse.jetty</groupId>
        <artifactId>jetty-maven-plugin</artifactId>
        <version>${jetty.maven.plugin}</version>
      </plugin>

      <plugin>
        <groupId>com.google.cloud.tools</groupId>
        <artifactId>appengine-maven-plugin</artifactId>
        <version>${appengine.maven.plugin}</version>
        <configuration>
          <!-- deploy configuration -->
<!--
          <deploy.promote>true</deploy.promote>                           <!~~ DEFAULT value ~~>
          <deploy.stopPreviousVersion>true</deploy.stopPreviousVersion>   <!~~ DEFAULT value ~~>
 -->
        </configuration>
      </plugin>

    </plugins>
  </build>
</project>

pom.xml ファイルの詳細については、Maven のドキュメントをご覧ください。

このページは役立ちましたか？評価をお願いいたします。

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

最終更新日: 9月 13, 2019

App Engine フレキシブル環境での Java のクイックスタート

始める前に

App Engine のロケーション

Hello World アプリをダウンロードする

ローカルマシンで Hello World を実行する

Hello World を App Engine にデプロイして実行する

クリーンアップ

次のステップ

プラットフォーム全体について学ぶ

App Engine フレキシブル環境について学習する

Hello World コードレビュー

HelloServlet.java

app.yaml

pom.xml

フィードバックを送信...

`HelloServlet.java`

`app.yaml`

`pom.xml`