定义输出构件 - Amazon CodeCatalyst

定义输出构件

按照以下说明，定义您希望 Amazon CodeCatalyst 操作输出的构件。该构件随后可供其他操作使用。

注意

并非所有操作都支持输出构件。要确定您的操作是否支持输出构件，请仔细阅读随后的可视化编辑器说明，并查看操作的输出选项卡上是否包含输出构件按钮。如果是，则支持输出构件。

Visual
使用可视化编辑器定义输出构件

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 选择您的项目。

  3. 在导航窗格中，选择 CI/CD，然后选择工作流。

  4. 选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。

  5. 选择编辑。

  6. 选择可视化。

  7. 在工作流图表中，选择将生成构件的操作。

  8. 选择输出选项卡。

  9. 在构件下，选择添加构件。

  10. 选择添加构件，然后在字段中输入信息，如下所示。

    生成构件名称

    指定操作生成的构件的名称。构件名称在工作流内必须是唯一的，并且仅限于字母数字字符（a-z、A-Z、0-9）和下划线（_）。不允许使用空格、连字符（-）和特殊字符。不能使用引号以使输出构件名称包含空格、连字符和其他特殊字符。

    有关构件的更多信息（包括示例），请参阅在操作之间共享构件和文件。

    通过构建生成的文件

    指定 CodeCatalyst 在操作输出的构件中包含的文件。这些文件由工作流操作在运行时生成，也可在您的源存储库中找到。文件路径可以位于源存储库或先前操作的构件中，并且相对于源存储库或构件根目录。您可以使用 glob 模式来指定路径。示例：

    • 要指定位于构建位置或源存储库位置根目录中的单个文件，请使用 my-file.jar。

    • 要在子目录中指定单个文件，请使用 directory/my-file.jar 或 directory/subdirectory/my-file.jar。

    • 要指定所有文件，请使用 "**/*"。** glob 模式表示匹配任意数量的子目录。

    • 要指定名为 directory 的目录中的所有文件和目录，请使用 "directory/**/*"。** glob 模式表示匹配任意数量的子目录。

    • 要指定名为 directory 的目录中的所有文件，而非其任意子目录，请使用 "directory/*"。

    注意

    如果您的文件路径包含一个或多个星号（*）或其他特殊字符，请用双引号（""）将路径括起来。有关特殊字符的更多信息，请参阅语法准则和惯例。

    有关构件的更多信息（包括示例），请参阅在操作之间共享构件和文件。

    注意

    您可能需要在文件路径中添加前缀，以指明要在哪个构件或源中查找它。有关更多信息，请参阅引用源存储库文件和在构件中引用文件。

  11. （可选）选择验证，在提交之前验证工作流的 YAML 代码。

  12. 选择提交，输入提交消息，然后再次选择提交。

YAML
使用 YAML 编辑器定义输出构件

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 选择您的项目。

  3. 在导航窗格中，选择 CI/CD，然后选择工作流。

  4. 选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。

  5. 选择编辑。

  6. 选择 YAML。

  7. 在工作流操作中，添加类似于下文的代码：

    action-name:
  Outputs:
    Artifacts:
      - Name: artifact-name
        Files:
          - file-path-1
          - file-path-2

    有关更多示例，请参阅构件示例。有关更多信息，请参阅相应操作的工作流 YAML 定义。

  8. （可选）选择验证，在提交之前验证工作流的 YAML 代码。

  9. 选择提交，输入提交消息，然后再次选择提交。