Java 8 と Java 11 / 17 の違い

Java 11 / 17 ランタイムに移行すると、最新の言語機能を使用するだけでなく、慣用的なコードを使用して、より移植性の高いアプリを構築できます。

移行オプションについて

ランタイム移行の労力と複雑さを軽減するため、App Engine スタンダード環境では Java 11 / 17 ランタイムで以前の多くのバンドルサービスと API にアクセスできます（Memcache など）。Java 11 / 17 アプリは、App Engine API JAR を介してバンドルサービスの API を呼び出すことができ、Java 8 ランタイムとほぼ同じ機能にアクセスできます。

以前のバンドルサービスと同様の機能を備えた Google Cloud プロダクトを使用することもできます。これらの Google Cloud プロダクトでは、慣用的な Java 用 Cloud クライアントライブラリが用意されています。Google Cloud で個別のプロダクトとして提供されないバンドルサービス（画像処理、検索、メッセージングなど）については、サードパーティプロバイダまたはその他の回避策を使用できます。

バンドルされていないサービスへの移行については、バンドルサービスからの移行をご覧ください。

ランタイム移行を実行する方法は、以前のバンドルサービスを使用するかどうかによって異なります。

バンドルサービスを使用する Java 11 / 17 への移行バンドルサービスを使用しない Java 11 / 17 への移行

App Engine API JAR を使用してバンドルサービスにアクセスします。必要に応じて、推奨の Google Cloud プロダクトまたはサードパーティサービスを使用します。

バンドルサービスを使用する Java 11 / 17 への移行	バンドルサービスを使用しない Java 11 / 17 への移行
App Engine API JAR を使用してバンドルサービスにアクセスします。	必要に応じて、推奨の Google Cloud プロダクトまたはサードパーティサービスを使用します。
アプリの構成には `appengine-web.xml` と `web.xml` を使用します。アプリで使用する機能によっては、追加の YAML ファイルの構成が必要になる場合があります。	アプリを構成するには、`app.yaml` を使用します。アプリで使用する機能によっては、追加の YAML ファイルの構成が必要になる場合があります。
アプリは Jetty 経由でデプロイされます。WAR 形式を使用してアプリをパッケージ化します。	アプリは独自のサーバーによってデプロイされます。JAR 形式を使用してアプリをパッケージ化します。既存の WAR ファイルを実行可能な JAR に変換する方法については、WAR ファイルの再パッケージ化をご覧ください。

アプリの構成には appengine-web.xml と web.xml を使用します。

アプリで使用する機能によっては、追加の YAML ファイルの構成が必要になる場合があります。

アプリを構成するには、app.yaml を使用します。

アプリで使用する機能によっては、追加の YAML ファイルの構成が必要になる場合があります。

アプリは Jetty 経由でデプロイされます。WAR 形式を使用してアプリをパッケージ化します。アプリは独自のサーバーによってデプロイされます。JAR 形式を使用してアプリをパッケージ化します。既存の WAR ファイルを実行可能な JAR に変換する方法については、WAR ファイルの再パッケージ化をご覧ください。

移行プロセスの概要

App Engine Java 11 / 17 ランタイムを使用するために、既存の App Engine Java 8 アプリとデプロイプロセス加える必要がある変更を以下に示します。

Google Cloud CLI をダウンロードします。
スタンドアロンの App Engine Maven プラグインから gcloud CLI ベースの Maven プラグインまたは gcloud CLI ベースの Gradle プラグインに移行します。
以前のバンドルサービスを使用している場合は、App Engine API JAR をインストールします。
XML ファイルを同等の yaml ファイルに移行します。

注: App Engine の以前のバンドルサービスに Java 11 / 17 を使用する場合は、appengine-web.xml ファイル（app.yaml ではなく）を維持して Java 11 / 17 アプリを構成する必要があります。

Java 8 ランタイムと Java 11 / 17 ランタイムの主な違い

App Engine スタンダード環境の Java 8 ランタイムと Java 11 / 17 ランタイムの違いの概要は次のとおりです。

	Java 8 ランタイム	Java 11 / 17 ランタイム
サーバーのデプロイ	Jetty 経由でデプロイされたサーバー	以前のバンドルサービスを使用していない場合は、サーバーを自分でデプロイする必要があります¹。
App Engine レガシーバンドルサービス	提供	提供
Java 用 Cloud クライアントライブラリの使用	○	○
言語拡張とシステムライブラリサポート	○	○
外部ネットワークへのアクセス	○	○
ファイルシステムへのアクセス	`/tmp` に対する読み取り / 書き込みアクセス権	`/tmp` に対する読み取り / 書き込みアクセス権
言語ランタイム	App Engine 用に修正済み	修正なし、オープンソースランタイム
分離メカニズム	gVisor ベースのコンテナサンドボックス	gVisor ベースのコンテナサンドボックス
ローカル開発用サーバーでのテスト	サポート対象	サポート対象
スレッドセーフ構成	`appengine-web.xml` ファイルで指定できます。	構成ファイルでは指定できません。すべてのアプリがスレッドセーフであると想定されます³。
ロギング	`java.util.logging.` `ConsoleHandler` を使用します。 `stderr` に書き込み、各レコードの後でストリームをフラッシュします。	標準 Cloud Logging ²

注:

アプリが以前のバンドルサービスを使用していない場合、PORT 環境変数（推奨）で指定されたポートまたはポート 8080 で HTTP リクエストに応答するよう構成されたウェブサーバーをパッケージ化する限り、Java 11 / 17 ランタイムで任意の Java フレームワークを実行できます。たとえば、Java 11 / 17 ランタイムでは、Spring Boot Uber JAR をそのまま実行できます。その他の例については、フレームワークの柔軟性のセクションをご覧ください。

アプリが以前のバンドルサービスを使用している場合、App Engine は Java 8 ランタイムの場合と同様に Jetty を使用してサービスをデプロイします。
Java 11 / 17 ランタイムのロギングは、Cloud Logging のロギング標準に従います。Java 11 / 17 ランタイムでは、アプリログがリクエストログにバンドルされなくなり、別のレコードに分離されます。Java 11 / 17 ランタイムにおけるログの読み取りと書き込みの詳細については、ロギングガイドをご覧ください。
Java 11 / 17 ランタイムでスレッドセーフでないアプリを構成し、レガシーバンドルサービスを使用する場合は、Java 8 で <threadsafe>false</threadsafe> を設定した場合と同様に、app.yaml ファイルまたは appengine-web.xml ファイルのいずれかに最大同時実行数を 1 に設定します。

フレームワークの柔軟性

以前のバンドルサービスを使用している場合を除き、Java 11 / 17 ランタイムには、ウェブサービスフレームワークが含まれません。つまり、サーブレットベースのフレームワーク以外のフレームワークを使用できます。以前のバンドルサービスを使用している場合、Java 11 / 17 ランタイムにより Jetty ウェブサービスフレームワークが提供されます。

Google Cloud GitHub リポジトリには、一般的な Java ウェブフレームワークを使用した hello world サンプルがあります。

XML から YAML へのファイル形式の移行

gcloud CLI は、次のファイル形式をサポートしていません。

cron.xml
datastore-index.xml
dispatch.xml
queue.xml

次の例は、xml ファイルを yaml ファイルに移行する方法を示しています。

自動的にファイルを移行する

xml ファイルを自動的に移行するには:

gcloud CLI バージョン 226.0.0 以降が必要です。最新バージョンに更新するには:
```
gcloud components update
```
移行するファイルごとに、次のいずれかのサブコマンド（cron-xml-to-yaml、datastore-indexes-xml-to-yaml、dispatch-xml-to-yaml、queue-xml-to-yaml）とファイル名を指定します。
```
gcloud beta app migrate-config queue-xml-to-yaml MY-QUEUE-XML-FILE.xml
```
本番環境にデプロイする前に、変換後のファイルを手動でダブルチェックします。

xml ファイルから yaml ファイルへの正常な変換例については、手動でファイルを移行するのタブをご覧ください。

手動でファイルを移行する

xml ファイルを yaml ファイルに手動で移行するには:

`cron.yaml`

cron オブジェクトを含む cron.yaml ファイルを作成します。このオブジェクトにはオブジェクトのリストが含まれます。以下に示すように、各オブジェクトには cron.xml ファイルの <cron> タグ属性に対応するフィールドがあります。

変換後の cron.yaml ファイル:

cron:
- url: '/recache'
  schedule: 'every 2 minutes'
  description: 'Repopulate the cache every 2 minutes'
- url: '/weeklyreport'
  schedule: 'every monday 08:30'
  target: 'version-2'
  timezone: 'America/New_York'
  description: 'Mail out a weekly report'

元の cron.xml ファイル:

<?xml version="1.0" encoding="UTF-8"?>
<cronentries>
  <cron>
    <url>/recache</url>
    <description>Repopulate the cache every 2 minutes</description>
    <schedule>every 2 minutes</schedule>
  </cron>
  <cron>
    <url>/weeklyreport</url>
    <description>Mail out a weekly report</description>
    <schedule>every monday 08:30</schedule>
    <timezone>America/New_York</timezone>
    <target>version-2</target>
  </cron>
</cronentries>

詳細については、cron.yaml リファレンスドキュメントをご覧ください。

`dispatch.yaml`

dispatch オブジェクトを含む dispatch.yaml ファイルを作成します。このオブジェクトにはオブジェクトのリストが含まれます。以下に示すように、各オブジェクトには dispatch.xml ファイルの <dispatch> タグ属性に対応するフィールドがあります。

変換後の dispatch.yaml ファイル:

dispatch:
- url: '*/favicon.ico'
  module: default
- url: 'simple-sample.uc.r.appspot.com/'
  module: default
- url: '*/mobile/*'
  module: mobile-frontend

元の dispatch.xml ファイル

<?xml version="1.0" encoding="UTF-8"?>
<dispatch-entries>
  <dispatch>
      <url>*/favicon.ico</url>
      <module>default</module>
  </dispatch>
  <dispatch>
      <url>simple-sample.uc.r.appspot.com/</url>
      <module>default</module>
  </dispatch>
  <dispatch>
      <url>*/mobile/*</url>
      <module>mobile-frontend</module>
  </dispatch>
</dispatch-entries>

詳細については、dispatch.yaml リファレンスドキュメントをご覧ください。

`index.yaml`

indexes オブジェクトを含む index.yaml ファイルを作成します。このオブジェクトにはオブジェクトのリストが含まれます。以下に示すように、各オブジェクトには datastore-indexes.xml ファイルの <datastore-index> タグ属性に対応するフィールドがあります。

変換後の index.yaml ファイル:

indexes:
- ancestor: false
  kind: Employee
  properties:
  - direction: asc
    name: lastName
  - direction: desc
    name: hireDate
- ancestor: false
  kind: Project
  properties:
  - direction: asc
    name: dueDate
  - direction: desc
    name: cost

元の datastore-index.xml ファイル:

<?xml version="1.0" encoding="utf-8"?>
<datastore-indexes
 autoGenerate="true">
   <datastore-index kind="Employee" ancestor="false">
       <property name="lastName" direction="asc" />
       <property name="hireDate" direction="desc" />
   </datastore-index>
   <datastore-index kind="Project" ancestor="false">
       <property name="dueDate" direction="asc" />
       <property name="cost" direction="desc" />
   </datastore-index>
</datastore-indexes>

詳細については、index.yaml リファレンスドキュメントをご覧ください。

`queue.yaml`

queue オブジェクトを含む queue.yaml ファイルを作成します。このオブジェクトにはオブジェクトのリストが含まれます。以下に示すように、各オブジェクトには queue.xml ファイルの <queue> タグ属性に対応するフィールドがあります。

変換後の queue.yaml ファイル:

queue:
- name: fooqueue
  mode: push
  rate: 1/s
  retry_parameters:
    task_retry_limit: 7
    task_age_limit: 2d
- name: barqueue
  mode: push
  rate: 1/s
  retry_parameters:
    min_backoff_seconds: 10
    max_backoff_seconds: 200
    max_doublings: 0

元の queue.xml ファイル:

<queue-entries>
  <queue>
    <name>fooqueue</name>
    <rate>1/s</rate>
    <retry-parameters>
      <task-retry-limit>7</task-retry-limit>
      <task-age-limit>2d</task-age-limit>
    </retry-parameters>
  </queue>
  <queue>
    <name>barqueue</name>
    <rate>1/s</rate>
    <retry-parameters>
      <min-backoff-seconds>10</min-backoff-seconds>
      <max-backoff-seconds>200</max-backoff-seconds>
      <max-doublings>0</max-doublings>
    </retry-parameters>
  </queue>
<queue-entries>