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

# AWS Cloud9 與 整合 AWS CodeCommit
<a name="setting-up-ide-c9"></a>

您可以使用 AWS Cloud9 在 CodeCommit 儲存庫中進行程式碼變更。 AWS Cloud9 包含一組工具，可用來編寫程式碼和建置、執行、測試、偵錯和發行軟體。您可以從 AWS Cloud9 EC2 開發環境複製現有的儲存庫、建立儲存庫、遞交程式碼變更並推送至儲存庫等等。 AWS Cloud9 EC2 開發環境通常已預先設定 AWS CLI、Amazon EC2 角色和 Git，因此在大多數情況下，您可以執行幾個簡單的命令，並開始與儲存庫互動。

若要 AWS Cloud9 搭配 CodeCommit 使用 ，您需要下列項目：
+ 在 Amazon Linux 上執行的 An AWS Cloud9 EC2 開發環境。
+ IDE AWS Cloud9 在 Web 瀏覽器中開啟。
+ 具有其中一個 CodeCommit 受管政策和其中一個套用到它的 AWS Cloud9 受管政策的 IAM 使用者。

  如需詳細資訊，請參閱[AWS CodeCommit 的 受管政策](security-iam-awsmanpol.md)和[了解和取得您的安全登入資料](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)。
**注意**  
本主題說明設定與 CodeCommit 的整合 AWS Cloud9 ，以及從網際網路的一般存取。您可以在隔離 AWS Cloud9 的環境中設定 CodeCommit 和 的存取權，但這需要額外的步驟。如需詳細資訊，請參閱：  
[使用 AWS CodeCommit 搭配界面 VPC 端點](codecommit-and-interface-VPC.md)
[使用 存取無輸入 Amazon EC2 執行個體 AWS Systems Manager](https://docs.aws.amazon.com/cloud9/latest/user-guide/ec2-ssm.html)
[使用共享環境](https://docs.aws.amazon.com/cloud9/latest/user-guide/share-environment.html)
[與其他 帳戶共用您的 VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html)
[部落格文章：隔離您 AWS Cloud9 環境的網路存取](https://aws.amazon.com/blogs/security/isolating-network-access-to-your-aws-cloud9-environments/)

**Topics**
+ [步驟 1：建立 AWS Cloud9 開發環境](#setting-up-ide-c9-connect)
+ [步驟 2：在您的 AWS Cloud9 EC2 開發環境中設定 AWS CLI 登入資料協助程式](#setting-up-ide-c9-credentials)
+ [步驟 3：將 CodeCommit 儲存庫複製到您的 AWS Cloud9 EC2 開發環境](#setting-up-ide-c9-checkout)
+ [後續步驟](#setting-up-ide-c9-next)

## 步驟 1：建立 AWS Cloud9 開發環境
<a name="setting-up-ide-c9-connect"></a>

AWS Cloud9 在 Amazon EC2 執行個體上託管您的開發環境。這是最簡單的整合方式，因為您可以使用執行個體的 AWS 受管臨時憑證來連線至 CodeCommit 儲存庫。如果您想要改為使用自己的伺服器，請參閱 [AWS Cloud9 使用者指南](https://docs.aws.amazon.com/cloud9/latest/user-guide/)。

**建立 AWS Cloud9 環境**

1. 以您已設定的 IAM 使用者 AWS 身分登入 ， AWS Cloud9 並開啟 主控台。

1. 在 AWS Cloud9 主控台中，選擇**建立環境**。

1. 在 **Step 1: Name environment (步驟 1：命名環境)** 中，輸入環境的名稱和選用描述，然後選擇 **Next step (下一步驟)**。

1. 在 **Step 2: Configure Settings (步驟 2：進行設定)** 中設定環境，如下所示：
   + 在 **Environment type (環境類型)** 中，選擇 **Create a new instance for environment (EC2) (為環境建立新的執行個體 (EC2))**。
   + 在 **Instance type (執行個體類型)** 中，為您的開發環境選擇適當的執行個體類型。例如，如果您只是探索服務，您可以選擇預設值 t2.micro。如果您想要將此環境用於開發工作，請選擇較大的執行個體類型。
   + 接受其他預設設定，除非您有理由選擇其他設定 （例如，您的組織使用特定 VPC，或您的 Amazon Web Services 帳戶未設定任何 VPCs)，然後選擇**下一步**。

1. 在 **Step 3: Review (步驟 3：檢閱)** 中，檢閱您的設定。如需進行任何變更，請選擇 **Previous step (上一步)**。否則，請選擇 **Create environment (建立環境)**。

   建立環境後，首次連接此環境需要幾分鐘的時間。如果似乎需要很長時間，請參閱*AWS Cloud9 《 使用者指南*》中的[故障診斷](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html)。

1. 連接到環境後，請在終端機視窗執行 **git --version** 命令，以檢查 Git 是否已安裝，而且是支援的版本。

   如果 Git 未安裝或不是支援的版本，請安裝支援的版本。CodeCommit 支援 Git 1.7.9 版和更新版本。Git 2.28 版支援為初始遞交設定分支名稱。我們建議您使用最新版本的 Git。若要安裝 Git，我們建議使用 [Git Downloads](http://git-scm.com/downloads) 等網站。
**提示**  
根據環境的作業系統而定，您或許可以使用 **yum** 命令搭配 **sudo** 選項來安裝更新，包括 Git。例如，管理命令序列可能類似於下列三個命令：  

   ```
   sudo yum -y update
   sudo yum -y install git
   git --version
   ```

    

1. 執行 **git config** 命令，以設定要與 Git 遞交相關聯的使用者名稱和電子郵件。例如：

   ```
       git config --global user.name "Mary Major"
       git config --global user.email mary.major@example.com
   ```

## 步驟 2：在您的 AWS Cloud9 EC2 開發環境中設定 AWS CLI 登入資料協助程式
<a name="setting-up-ide-c9-credentials"></a>

建立 AWS Cloud9 環境之後，您可以設定 AWS CLI 登入資料協助程式，以管理連線至 CodeCommit 儲存庫的登入資料。開發環境隨附與您的 AWS Cloud9 IAM 使用者相關聯的 AWS 受管臨時憑證。您可以將這些登入資料與 AWS CLI 登入資料協助程式搭配使用。

1. 開啟終端機視窗，並執行下列命令來驗證 AWS CLI 已安裝：

   ```
   aws --version
   ```

   如果成功，這個命令會傳回目前已安裝的 AWS CLI版本。若要 AWS CLI 將舊版 升級至最新版本，請參閱[安裝 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。

1. 在終端機，執行下列命令來設定 HTTPS 連線的 AWS CLI 登入資料協助程式：

   ```
   git config --global credential.helper '!aws codecommit credential-helper $@'
   git config --global credential.UseHttpPath true
   ```
**提示**  
登入資料協助程式會針對您的開發環境使用預設 Amazon EC2 執行個體角色。如果您想要使用開發環境連線至 CodeCommit 中未託管的儲存庫，請設定這些儲存庫的 SSH 連線，或設定本機`.gitconfig`檔案，以在連線至其他儲存庫時使用替代的登入資料管理系統。如需詳細資訊，請參閱 Git 網站上的 [Git Tools - Credential Storage](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)。

## 步驟 3：將 CodeCommit 儲存庫複製到您的 AWS Cloud9 EC2 開發環境
<a name="setting-up-ide-c9-checkout"></a>

設定 AWS CLI 登入資料協助程式之後，您可以將 CodeCommit 儲存庫複製到其中。然後，您就可以開始使用程式碼。

1. 在終端機，執行 **git clone** 命令，並針對您想要複製的儲存庫，指定其 HTTPS 複製 URL。例如，如果您想要在美國東部 （俄亥俄） 區域中複製名為 MyDemoRepo 的儲存庫，您可以輸入：

   ```
   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
   ```
**提示**  
您可以在 CodeCommit 主控台中選擇複製 URL，尋找儲存庫的**複製 URL**。

1. 當複製完成時，在側邊導覽中展開儲存庫的資料夾，然後選擇您要開啟來編輯的檔案。或者，選擇 **File (檔案)**，然後選擇 **New File (新增檔案)** 以建立檔案。

1. 完成編輯或建立檔案時，請在終端機視窗中，切換到已複製的儲存庫所在的目錄，然後遞交並推送您的變更。例如，如果您新增的檔案名為 *MyFile.py*：

   ```
   cd MyDemoRepo
   git commit -a MyFile.py
   git commit -m "Added a new file with some code improvements"
   git push
   ```

## 後續步驟
<a name="setting-up-ide-c9-next"></a>

如需詳細資訊，請參閱 [AWS Cloud9 使用者指南](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)和 [CodeCommit 範例 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-codecommit.html)。如需搭配 CodeCommit 使用 Git 的詳細資訊，請參閱 [Git 和 入門 AWS CodeCommit](getting-started.md)。