GitHub 连接

1. 登录 CodePipeline 控制台。

2. 选择下列选项之一。

   • 选择创建管道。按照创建管道 中的步骤操作，完成第一个屏幕，然后选择下一步。在 “来源” 页面的 “源提供者” 下，选择 GitHub （通过 GitHub 应用程序）。

   • 选择编辑现有管道。选择编辑，然后选择编辑阶段。选择添加或编辑您的源操作。在编辑操作页面的操作名称下，输入您的操作的名称。在操作提供者中，选择 GitHub （通过 GitHub应用程序）。

3. 请执行以下操作之一：

   • 在 “连接” 下，如果您尚未创建与提供商的连接，请选择 “连接到” GitHub。继续执行步骤 2：创建与的连接 GitHub。

   • 在连接下，如果您已创建到提供程序的连接，请选择该连接。继续执行步骤 3：保存连接的源操作。

要创建与的连接 GitHub

1. 在 “GitHub 连接设置” 下，您的连接名称显示在 “连接名称” 中。选择 “连接到” GitHub。此时将显示访问请求页面。

2. 选择 “为 Amazon 连接器授权” GitHub。连接页面将显示并显示 “GitHub 应用程序” 字段。

   

3. 在 “GitHub 应用程序” 下，选择应用程序安装或选择 “安装新应用程序” 来创建一个。

   您可以为与特定提供程序的所有连接安装一个应用程序。如果您已经安装了 GitHub 应用程序 Amazon 连接器，请选择它并跳过此步骤。

   注意

   如果要创建用户访问令牌，请确保已经为 GitHub 应用程序安装了 Conn Amazon ector，然后将 “应用程序安装” 字段留空。 CodeConnections 将使用用户访问令牌进行连接。

4. 在 “安装 Amazon 连接器 GitHub” 页面上，选择要在其中安装应用程序的帐户。

   注意

   您只需为每个 GitHub 账户安装一次该应用程序。如果您之前已安装了应用程序，则可以选择配置，继续进入应用程序安装的修改页面，也可以使用后退按钮返回到控制台。

5. 在 “安装 Amazon 连接器 GitHub” 页面上，保留默认值，然后选择 “安装”。

6. 在 “Connect t o GitHub” 页面上，新安装的连接 ID 显示在 “GitHub 应用程序” 中。选择连接。

保存您的 GitHub 源代码操作

1. 在存储库名称中，选择第三方存储库的名称。

2. 如果您的操作是操作，则可以在 Pip elin e 触发器下添加触发器。 CodeConnections 要配置管道触发器配置并选择性使用触发器进行筛选，请参阅添加带有代码推送或拉取请求事件类型的触发器中的更多详细信息。

3. 在输出构件格式中，您必须为构件选择格式。

   • 要使用默认方法存储 GitHub 操作的输出对象，请选择CodePipeline 默认。该操作访问存储库中的文件，并将工件 GitHub 存储在管道工件存储区的 ZIP 文件中。

   • 要存储包含存储库的 URL 引用的 JSON 文件，以便下游操作可以直接执行 Git 命令，请选择完全克隆。此选项只能由 CodeBuild 下游操作使用。

     如果选择此选项，则需要更新 CodeBuild 项目服务角色的权限，如所示添加连接 Bitbucket、 GitHub、En GitHub terprise Server 或 GitLab .com 的 CodeBuild GitClone 权限。如需查看教程以了解如何使用完整克隆选项，请参阅教程：使用带有 GitHub 管道源的完整克隆。

4. 在向导上选择下一步，或者在编辑操作页面上选择保存。

创建连接

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 Amazon CLI 使用运行create-connection命令，--connection-name为您的连接指定--provider-type和。在此示例中，第三方提供方名称为 GitHub，指定的连接名称为 MyConnection。

   aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

   如果成功，该命令将返回类似以下内容的连接 ARN 信息。

   {
       "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }

2. 使用控制台完成连接。有关更多信息，请参阅更新挂起的连接。

3. 管道默认会在向连接源存储库推送代码时检测更改。要配置手动发布或 Git 标签管道触发器配置，请执行以下操作之一：

   • 要将管道触发器配置为仅通过手动发布启动，请在配置中添加以下行：

     "DetectChanges": "false",

   • 要配置管道触发器配置以使用触发器进行筛选，请参阅添加带有代码推送或拉取请求事件类型的触发器中的更多详细信息。例如，以下内容添加到管道 JSON 定义的管道级别。在此示例中，release-v0 和 release-v1 是要包含的 Git 标签，release-v2 是要排除的 Git 标签。

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]