使用入门:设置开发环境

了解如何设置构建环境,以开发应用并将其部署到 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 开发套件 (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。