本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建与 GitHub 企业服务器的连接
<a name="connections-create-gheserver"></a>

您可以使用连接将您的 AWS 资源与第三方存储库关联。您可以使用 AWS 管理控制台 或 AWS Command Line Interface (AWS CLI) 来创建与 GitHub 企业服务器的连接。

连接仅提供对 GitHub 企业服务器帐户拥有的存储库的访问权限，该帐户在连接创建期间用于授权安装 GitHub应用程序。

开始前的准备工作：
+ 您必须已经有一个 GitHub 企业服务器实例和一个存储库。
+ 您需要是 GitHub 企业服务器实例的管理员才能创建 GitHub 应用程序和创建主机资源，如本节所示。

**重要**  
在为 GitHub 企业服务器设置主机时，会为您创建一个 Webhook 事件数据的 VPC 终端节点。如果您在 2020 年 11 月 24 日之前创建了主机，并且想要使用 VPC PrivateLink Webhook 终端节点，则必须先[删除](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html)主机，然后再[创建](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html)新主机。

**注意**  
对于使用 GitHub 企业服务器或 GitLab 自行管理的组织，您不会传递可用的主机。您要为组织中的每个连接创建一个新主机，并且必须确保在该主机的网络字段（VPC ID IDs、子网和安全组 IDs）中输入相同的信息。有关更多信息，请参阅 [已安装的提供商支持组织的连接和主机设置](troubleshooting-connections.md#troubleshooting-organization-host)。

**Topics**
+ [

# 创建与 GitHub 企业服务器（控制台）的连接
](connections-create-gheserver-console.md)
+ [

# 创建与 GitHub 企业服务器 (CLI) 的连接
](connections-create-gheserver-cli.md)

# 创建与 GitHub 企业服务器（控制台）的连接
<a name="connections-create-gheserver-console"></a>

要创建 GitHub 企业服务器连接，您需要提供 GitHub 企业服务器安装位置的信息，并使用您的 GitHub 企业凭据授权创建连接。

**注意**  
从 2024 年 7 月 1 日起，控制台将在资源 ARN `codeconnections` 中创建与的连接。带有两个服务前缀的资源将继续显示在控制台中。

**Topics**
+ [

## 创建您的 GitHub 企业服务器连接（控制台）
](#connections-create-gheserver-connection)

## 创建您的 GitHub 企业服务器连接（控制台）
<a name="connections-create-gheserver-connection"></a>

要创建与 GitHub 企业服务器的连接，请准备好服务器 URL 和 GitHub 企业凭据。<a name="proc-host-create-console-steps"></a>

**创建主机**

1. 登录并打开 AWS 开发者工具控制台，网址为[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。 AWS 管理控制台

1. 在 **Host (主机)** 选项卡上，选择 **Create host (创建主机)**。

1. 在 **Host name (产品名称)** 中，输入您要用于主机的名称。

1. 在**选择提供程序**中，选择以下选项之一：
   + **GitHub 企业服务器**
   + **GitLab 自我管理**

1. 在 **URL** 中，输入安装提供程序的基础设施的终端节点。

1. 如果您的服务器是在 Amazon VPC 中配置的，并且您想要连接 VPC，请选择 **Use a VPC (使用 VPC)**。否则，请选择 **No VPC (无 VPC)**。

1. 如果您已将实例启动到 Amazon VPC 中，并且想要连接 VPC，请选择 **Use a VPC (使用 VPC)** 并完成以下操作。

   1. 在 **VPC ID** 中，选择您的 VPC ID。确保为基础设施选择安装实例的 VPC，或选择通过 VPN 或 Direct Connect 访问实例的 VPC。

   1. 如果您配置了私有 VPC，并且您已将实例配置为使用非公有证书颁发机构执行 TLS 验证，请在 **TLS 证书**中输入证书 ID。TLS 证书值为证书的公有密钥。

1. 选择 **Create host (创建主机)**。

1. 显示主机详细信息页面后，主机状态随着主机的创建而发生变化。
**注意**  
如果您的主机设置包括 VPC 配置，请等待几分钟时间来预置主机网络组件。

   等待您的主机进入 **Pending (待处理)** 状态，然后完成安装。有关更多信息，请参阅 [设置待处理的主机](connections-host-setup.md)。  
![\[显示主机处于待处理状态的主机详细信息的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-host-pending.png)

**步骤 2：创建与 GitHub 企业服务器（控制台）的连接**

1. 登录 AWS 管理控制台 并打开开发者工具控制台，网址为[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。

1. 选择**设置 > 连接**，然后选择**创建连接**。

1. 要创建与已安装的 GitHub 企业服务器存储库的连接，请选择**GitHub 企业服务器**。

**Connect 连接到 GitHub 企业服务器**

1. 在 **Connection name (连接名称)**，输入您的连接的名称。  
![\[显示不带 VPC 的 Create host settings (创建主机设置) 页面的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-screen.png)

1. 在 **URL** 中，输入服务器的终端节点。
**注意**  
如果所提供的 URL 已用于为连接设置 GitHub企业服务器，则系统将提示您选择之前为该终端节点创建的主机资源 ARN。

1. （可选）如果您已将服务器启动到 Amazon VPC 中，并且想要连接 VPC，请选择**使用 VPC** 并完成以下操作。
**注意**  
对于使用 GitHub 企业服务器或 GitLab 自行管理的组织，您不会传递可用的主机。您要为组织中的每个连接创建一个新主机，并且必须确保在该主机的网络字段（VPC ID IDs、子网和安全组 IDs）中输入相同的信息。有关更多信息，请参阅 [已安装的提供商支持组织的连接和主机设置](troubleshooting-connections.md#troubleshooting-organization-host)。

   1. 在 **VPC ID** 中，选择您的 VPC ID。请务必为安装 GitHub 企业服务器实例的基础设施选择 VPC，或者选择可通过 VPN 或 Direct Connect 访问 GitHub企业服务器实例的 VPC。

   1. 在 **Subnet ID (子网 ID)** 下，选择 **Add (添加)**。在字段中，选择要用于主机的子网 ID。您可以选择最多 10 个子网。

      请务必为安装 GitHub 企业服务器实例的基础架构选择子网，或者选择可以通过 VPN 或 Direct Connect 访问已安装的 GitHub 企业服务器实例的子网。

   1. 在 “**安全组**” 下 IDs，选择 “**添加**”。在字段中，选择要用于主机的安全组。您最多可以选择 10 个安全组。

      请务必为安装 GitHub 企业服务器实例的基础架构选择安全组，或者选择可以通过 VPN 或 Direct Connect 访问已安装的 GitHub 企业服务器实例的安全组。

   1. 如果您配置了私有 VPC，并且已将 GitHub 企业服务器实例配置为使用非公共证书颁发机构执行 TLS 验证，请在 **TLS 证书**中输入您的证书 ID。TLS 证书值应该是证书的公有密钥。  
![\[控制台屏幕截图显示了 VPC 选项的 “创建 GitHub 企业服务器连接” 页面。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-screen-vpc.png)

1. 选择 “**连接到 GitHub 企业服务器”**。创建的连接显示为**待处理**状态。将使用您提供的服务器信息为连接创建一个主机资源。对于主机名，将使用 URL。

1.  选择**更新待处理的连接**。  
![\[控制台屏幕截图显示待处理的 GitHub 企业服务器连接页面。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-pending.png)

1. 如果出现提示，请在 GitHub 企业登录页面上使用您的 GitHub企业凭据登录。

1. 在**创建 GitHub 应用程序**页面上，为您的应用程序选择一个名称。  
![\[显示应用创建页面的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-app-name.png)

1. 在 GitHub 授权页面上，选择**授权**<app-name>。  
![\[显示应用程序授权页面的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-app-authorize.png)

1. 在应用程序安装页面上，有一条消息显示连接器应用程序已准备好安装。如果您有多个组织，系统可能会提示您选择要安装该应用程序的组织。

   选择要安装应用程序的存储库设置。选择**安装**。  
![\[显示应用程序授权页面的控制台屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-create-ghes-app-install.png)

1. 连接页面显示已创建的连接处于 **Available (可用)** 状态。

# 创建与 GitHub 企业服务器 (CLI) 的连接
<a name="connections-create-gheserver-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 来创建连接。

为此，请使用 **create-host** 和 **create-connection** 命令。

**重要**  
默认情况下，通过 AWS CLI 或创建的连接 AWS CloudFormation 处于`PENDING`状态。使用 CLI 或创建连接后 CloudFormation，使用控制台编辑连接以使其处于状态`AVAILABLE`。

**步骤 1：为 GitHub 企业服务器创建主机 (CLI)**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**create-host**命令，`--provider-endpoint`为您的连接指定`--name``--provider-type`、和。在此示例中，第三方提供程序名称为 `GitHubEnterpriseServer`，终端节点为 `my-instance.dev`。

   ```
   aws codeconnections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"
   ```

   如果成功，该命令将返回类似以下内容的主机 Amazon 资源名称（ARN）信息。

   ```
   {
       "HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
   }
   ```

   完成此步骤后，主机处于 `PENDING` 状态。

1. 使用控制台完成主机设置并将主机变为 `Available` 状态。有关更多信息，请参阅 [设置待处理的主机](connections-host-setup.md)。

**步骤 2：在控制台中设置待处理的主机**

1. 登录 AWS 管理控制台 并打开开发者工具控制台，网址为[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。

1. 使用控制台完成主机设置并将主机变为 `Available` 状态。请参阅[设置待处理的主机](connections-host-setup.md)。

**步骤 3：为 GitHub 企业服务器创建连接 (CLI)**

1. 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 AWS CLI 使用运行**create-connection**命令，`--connection-name`为您的连接指定`--host-arn`和。

   ```
   aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection
   ```

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

   ```
   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad"
   }
   ```

1. 使用控制台设置待处理的连接。有关更多信息，请参阅 [更新挂起的连接](connections-update.md)。

**步骤 4：在控制台中完成与 GitHub 企业服务器的连接**

1. 登录 AWS 管理控制台 并打开开发者工具控制台，网址为[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)。

1. 使用控制台设置待处理的连接，并将连接移到 `Available` 状态。有关更多信息，请参阅 [更新挂起的连接](connections-update.md)。