本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配 Amazon Virtual Private Cloud 使用 CodeDeploy
<a name="vpc-endpoints"></a>

如果您使用 Amazon Virtual Private Cloud (Amazon VPC) 託管 AWS 資源，您可以在 VPC 和 CodeDeploy 之間建立私有連線。您可以使用此連線，讓 CodeDeploy 與 VPC 上的資源通訊，而無需透過公有網際網路。

Amazon VPC 是一種 AWS 服務，可用來在您定義的虛擬網路中啟動 AWS 資源。您可利用 VPC 來控制您的網路設定，例如 IP 地址範圍、子網路、路由表和網路閘道。透過 VPC 端點，VPC 和 AWS 服務之間的路由由 AWS 網路處理，您可以使用 IAM 政策來控制對服務資源的存取。

若要將 VPC 連線至 CodeDeploy，請定義 CodeDeploy 的*介面 VPC 端點*。界面端點是具有私有 IP 地址的彈性網路界面，可做為目的地為支援 AWS 服務之流量的進入點。端點為 CodeDeploy 提供可靠、可擴展的連線，而不需要網際網路閘道、網路位址轉譯 (NAT) 執行個體或 VPN 連線。如需詳細資訊，請參閱《*Amazon VPC 使用者指南》*中的[什麼是 Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/)。

 介面 VPC 端點採用 AWS PrivateLink技術，這項 AWS 技術可使用具有私有 IP 地址的彈性網路介面，在 AWS 服務之間進行私有通訊。如需詳細資訊，請參閱[AWS PrivateLink](https://aws.amazon.com/privatelink/)。

下列步驟適用於 Amazon VPC 的使用者。如需詳細資訊，請參閱《*Amazon VPC 使用者指南*》中的[入門](https://docs.aws.amazon.com/vpc/latest/userguide/GetStarted.html)。

## 可用性
<a name="codecommit-interface-VPC-availability"></a>

CodeDeploy 有兩個 VPC 端點：一個用於 CodeDeploy 代理程式操作，另一個用於 CodeDeploy API 操作。下表顯示每個端點支援的 AWS 區域。

如需詳細資訊，以及 FIPS 端點的詳細資訊，請參閱[AWS CodeDeploy 端點和配額](https://docs.aws.amazon.com/general/latest/gr/codedeploy.html)。


| 區域名稱 | 區域代碼 | 代理程式端點 | API 端點 | FIPS 合規區域？ | 
| --- | --- | --- | --- | --- | 
|  美國東部 (維吉尼亞北部)  |  us-east-1  |  是  |  是  | 是 | 
|  美國東部 (俄亥俄)  |  us-east-2  |  是  |  是  | 是 | 
|  美國西部 (加利佛尼亞北部)  |  us-west-1  |  是  |  是  | 是 | 
|  美國西部 (奧勒岡)  |  us-west-2  |  是  |  是  | 是 | 
|  Africa (Cape Town)   |  af-south-1  |  是  |  否  |  | 
|  亞太地區 (香港)  |  ap-east-1  |  是  |  是  |  | 
|  亞太地區 (海德拉巴)  |  ap-south-2  |  是  |  否  |  | 
|  亞太地區 (雅加達)  |  ap-southeast-3  |  是  |  否  |  | 
|  亞太地區 (墨爾本)  |  ap-southeast-4  |  是  |  否  |  | 
|  亞太區域 (孟買)  |  ap-south-1  |  是  |  是  |  | 
|  亞太區域 (大阪)  |  ap-northeast-3  |  是  |  否  |  | 
|  亞太區域 (首爾)  |  ap-northeast-2  |  是  |  是  |  | 
|  亞太區域 (新加坡)  |  ap-southeast-1  |  是  |  是  |  | 
|  亞太區域 (雪梨)  |  ap-southeast-2  |  是  |  是  |  | 
|  亞太區域 (東京)  |  ap-northeast-1  |  是  |  是  |  | 
|  加拿大 (中部)  |  ca-central-1  |  是  |  是  |  | 
|  中國 (北京)  |  cn-north-1  |  是  |  否  |  | 
|  中國 (寧夏)  |  cn-northwest-1  |  否  |  否  |  | 
|  歐洲 (法蘭克福)   |  eu-central-1  |  是  |  是  |  | 
|  歐洲 (愛爾蘭)  |  eu-west-1  |  是  |  是  |  | 
|  歐洲 (倫敦)  |  eu-west-2  |  是  |  是  |  | 
|  歐洲 (米蘭)   |  eu-south-1  |  是  |  否  |  | 
|  Europe (Paris)   |  eu-west-3  |  是  |  是  |  | 
|  歐洲 (西班牙)  |  eu-south-2  |  是  |  否  |  | 
|  Europe (Stockholm)  |  eu-north-1  |  是  |  是  |  | 
|  歐洲 (蘇黎世)   |  eu-central-2  |  是  |  否  |  | 
|  以色列 (特拉維夫)   |  il-central-1  |  是  |  是  |  | 
|  Middle East (Bahrain)  |  me-south-1  |  是  |  是  |  | 
|  中東 (阿拉伯聯合大公國)  |  me-central-1  |  是  |  否  |  | 
|  南美洲 (聖保羅)  |  sa-east-1  |  是  |  是  |  | 
|  AWS GovCloud （美國東部）  |  us-gov-east-1  |  否  |  否  | 是 | 
|  AWS GovCloud （美國西部）  |  us-gov-west-1  |  否  |  否  | 是 | 

## 建立 CodeDeploy 的 VPC 端點
<a name="create-vpc-endpoint-for-codedeploy"></a>

若要開始將 CodeDeploy 與 VPC 搭配使用，請為 CodeDeploy 建立介面 VPC 端點。CodeDeploy 需要代理程式 Git 操作和 CodeDeploy API 操作的個別端點。根據您的商業需求，您可能需要建立多個 VPC 端點。當您為 CodeDeploy 建立 VPC 端點時，請選擇**AWS 服務**，然後在**服務名稱**中選擇下列選項：
+  **com.amazonaws.*region*.codedeploy**：如果您想要為 CodeDeploy API 操作建立 VPC 端點，請選擇此選項。例如，如果您的使用者使用 AWS CLI、CodeDeploy API 或 AWS SDKs 與 CodeDeploy 互動，例如 `CreateApplication`、 和 等操作`GetDeployment`，請選擇此選項`ListDeploymentGroups`。
+  **com.amazonaws.*region*.codedeploy-fips**：如果您想要為 FIPS 端點的 CodeDeploy API 操作建立 VPC 端點，請選擇此選項。
+  **com.amazonaws.*region*.codedeploy-commands-secure**：如果您想要為 CodeDeploy 代理程式操作建立 VPC 端點，請選擇此選項。您也需要在`true`代理程式組態檔案中`:enable_auth_policy:`將 設定為 ，並連接所需的許可。如需詳細資訊，請參閱[設定 CodeDeploy 代理程式和 IAM 許可](#vpc-codedeploy-agent-configuration)。

如果您使用 Lambda 或 ECS 部署，則只需要為 **com.amazonaws.*region*.codedeploy** 建立 VPC 端點。使用 Amazon EC2 部署的客戶需要 **com.amazonaws.*region*.codedeploy** 和 **com.amazonaws.*region*.codedeploy-commands-secure** 的 VPC 端點。

## 設定 CodeDeploy 代理程式和 IAM 許可
<a name="vpc-codedeploy-agent-configuration"></a>

若要搭配 CodeDeploy 使用 Amazon VPC 端點，您必須在 EC2 或內部部署執行個體上的代理程式組態檔案中`:enable_auth_policy:``true`將 的值設定為 。如需代理程式組態檔案的詳細資訊，請參閱 [CodeDeploy 代理程式組態參考](reference-agent-configuration.md)。

您還必須將下列 IAM 許可新增至 Amazon EC2 執行個體描述檔 （如果您使用的是 Amazon EC2 執行個體） 或 IAM 使用者或角色 （如果您使用的是內部部署執行個體）。

```
{
  "Statement": [
    {
      "Action": [
        "codedeploy-commands-secure:GetDeploymentSpecification",
        "codedeploy-commands-secure:PollHostCommand",
        "codedeploy-commands-secure:PutHostCommandAcknowledgement",
        "codedeploy-commands-secure:PutHostCommandComplete"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}
```

如需詳細資訊，請參閱 *Amazon VPC 使用者指南*中的[建立界面端點](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint.html)。