创建手动触发器

本页面介绍如何创建手动触发器。手动触发器可用于手动调用构建,并能够在运行构建之前在调用时替换定义的替代变量值。您还可以安排手动触发器在特定时间自动运行。

如需了解如何使用 gcloud 命令行工具或 Cloud Build API 手动启动构建,请参阅手动启动构建

准备工作

  • 启用 Cloud Build API。

    启用 API

  • 准备好源代码。

手动触发器

手动触发器允许您设置仅当在连接的代码库上调用触发器时执行的构建。假设您要创建一个流水线,用于将源代码部署到预演环境或生产环境中。您可能想要自动执行工作流,但只想手动执行构建。为了实现此目的,您可以定义手动触发器。

手动触发器允许您通过以下方式手动调用构建:

  • 使用指定的分支或标记从托管代码库提取源代码。
  • 使用每次执行构建时无需手动传入的替代参数将构建参数化。
  • 在调用构建之前,在调用时替换已定义的替代变量值。

要从本地工作目录(而非托管代码库)执行构建,或者希望无需创建触发器即可提交构建,您可以在工作目录中运行以下 gcloud 命令:

gcloud builds submit --config build-config source-code

其中:

  • build-config 是构建配置文件的路径。
  • source-code 是源代码的路径或网址。

要详细了解如何使用 gcloud 命令在本地目录中手动启动构建,请参阅手动启动构建

创建手动触发器

要创建手动触发器,请执行以下操作:

  1. 打开触发器页面

    打开“触发器”页面

  2. 从页面顶部选择您的项目,然后点击打开

  3. 点击创建触发器

  4. 输入以下触发器设置:

    • 名称:触发器的名称。
    • 说明(可选):触发器的说明。
    • 时间:选择手动调用来设置触发器,以便构建仅在手动调用触发器时运行。
    • 来源:选择要在手动运行触发器时构建的代码库。
    • 修订版本:选择要在手动运行触发器时构建的分支或标记。
      • 分支:设置一个要在此分支上构建的触发器。必须指定字面量值。目前不支持正则表达式。
      • 标记:设置一个要在此标记上构建的触发器。必须指定字面量值。目前不支持正则表达式。
    • 配置:选择位于远程代码库中的构建配置文件,或创建要用于构建的内嵌构建配置文件。

      • 类型:选择要用于构建的配置类型。
        • Cloud Build 配置文件(yaml 或 json):为您的配置使用构建配置文件。
        • Dockerfile:为您的配置使用 Dockerfile
        • Buildpack:为您的配置使用 buildpack
      • 位置:为您的配置指定位置。

        • 代码库:如果您的配置文件位于远程代码库中,请提供构建配置文件的位置、Dockerfile 目录或 buildpack 目录。如果您的构建配置类型是 Dockerfile 或 buildpack,则需要为生成的映像提供名称,还需要视情况提供构建的超时时间。提供了 Dockerfile 或 buildpack 映像名称后,您会看到您的构建将执行的 docker buildpack 命令的预览。
        • Buildpack 环境变量(可选):如果您选择了 buildpacks 作为配置类型,请点击添加软件包环境变量以指定 buildpack 环境变量和值。如需详细了解 buildpack 环境变量,请参阅环境变量
        • 内嵌:如果您选择了 Cloud Build 配置文件(yaml 或 json)作为配置选项,则可以指定内嵌构建配置。点击打开编辑器,使用 YAML 或 JSON 语法在 Google Cloud Console 中编写您的构建配置文件。点击完成以保存您的构建配置。

  5. 点击创建以创建手动触发器。

运行手动触发器

如需使用 Google Cloud Console 运行手动触发器,请执行以下操作:

  1. 打开 Google Cloud Console 中的触发器页面。

    打开“触发器”页面

  2. 在列表中找到您的触发器。

  3. 点击运行触发器

    点击运行触发器后,您将在右侧看到运行触发器窗格。如果指定了分支名称、标记名称或替代变量等字段,则可以在调用时替换这些字段。

    如果您为替代变量指定了新的变量值,请点击运行触发器以执行构建。

如需按计划手动运行触发器,请参阅安排构建时间

后续步骤