開始使用:設定開發環境

瞭解如何設定建構環境,以用於應用程式開發及部署至 App Engine 標準環境中的 Java 8 執行階段。

這份指南將說明如何執行下列操作:

  • 安裝 Google Cloud CLI
  • 安裝及設定 Maven 的 App Engine 外掛程式。App Engine 也提供 GradleIntelliJ IDEAEclipse 的外掛程式,但本指南將示範 Maven 外掛程式。
  • 建立新的 App Engine 專案。
  • 授權 Cloud Build 建構及部署應用程式。

安裝需要的 SDK

  1. 如果您尚未安裝 Java SE 8 SDK,請安裝 Java SE 8 Development Kit (JDK)

  2. 安裝並初始化最新版的 gcloud CLI。

    安裝並初始化 gcloud CLI

  3. 安裝 App Engine Java 元件:

    gcloud components install app-engine-java
    
  4. 授權使用者帳戶:

    gcloud auth application-default login
    

在開發環境中設定 Maven

  1. 從 Maven 網站下載 Maven 3.5 以上版本。

  2. 在本機電腦上安裝 Maven 3.5 以上版本。

建立新的 App Engine 專案

如要建立 App Engine 應用程式:

  1. 建立新目錄。

  2. 初始化所建立目錄中的新專案:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. -Dappengine-version 設為 Java 適用的 App Engine SDK 最新版本,並將 application-id 設為Google Cloud 專案的 ID。

    2. 設定 -Djava8=true 以在 Java 8 執行階段中部署專案。

    3. -DCloudSDK_Tooling=true 設為使用 gcloud CLI 工具。

  3. 系統提示您選擇原型時,請針對 App Engine 架構原型選擇值 2。 這樣會建立包含所需目錄結構與檔案的空白專案。

  4. 系統提示輸入版本時,請按 Enter 鍵來選取預設的最新版本。

  5. 當系統提示 Define value for property 'groupId' 時,請為您的應用程式提供所需命名空間,例如 com.mycompany.myapp

  6. 當系統提示 Define value for property 'artifactId' 時,請提供專案名稱,例如 myapp

  7. 當系統提示 Define value for property 'version' 時,請接受預設值。

  8. 系統提示您 Define value for property 'package' 時,請提供您的偏好套件名稱 (或接受預設值)。產生的 Java 檔案會使用您在這裡指定的套件名稱。

  9. 系統提示您確認選擇時,請接受預設值 (Y)。

  10. 等待專案產生完畢,然後將目錄變更為新的專案目錄,例如 myapp/

  11. 將 gcloud CLI 式外掛程式新增至專案的 pom.xml 檔案。

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>2.4.4</version>
                <configuration>
                    <projectId>your-project-ID-goes-here</projectId>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. 在外掛程式設定中指定目標 Google Cloud Platform 專案 ID 與服務和版本

授予 Cloud Build 權限

部署應用程式時,App Engine 會使用 Cloud Build 將應用程式建構至容器,並將容器部署至執行階段。根據預設,Cloud Build 沒有部署 Java 8 應用程式的權限,因此您需要授予 Cloud Build 部署應用程式的權限,才能在專案中部署應用程式。系統會在應用程式的區域中建立這些版本。

後續步驟

開發環境已設定完成,您可以開始開發 Java 應用程式並將其部署至 App Engine。