

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

# 使用 Git 登入資料從開發工具設定連線
<a name="setting-up-ide"></a>

在 IAM 主控台 AWS CodeCommit 中為 設定 Git 登入資料後，您可以將這些登入資料與支援 Git 登入資料的任何開發工具搭配使用。例如，您可以在 Visual Studio AWS Cloud9、Xcode、IntelliJ 或任何整合 Git 憑證的整合式開發環境 (IDE) 中設定 CodeCommit 儲存庫的存取權。在您設定存取權之後，您可以直接從 IDE 或其他開發工具中編輯程式碼、遞交變更及推送。

**注意**  
如果您使用聯合存取、臨時登入資料或 Web 輔助性提供者來存取 CodeCommit 儲存庫，則無法使用 Git 登入資料。建議您使用 `git-remote-codecommit` 命令設定本機電腦。不過，並非所有 IDE 皆可與 **git-remote-codecommit** 等 Git 遠端協助程式完全相容。如果您遇到問題，請參閱[對 git-remote-codecommit 和 進行故障診斷 AWS CodeCommit](troubleshooting-grc.md)。

**Topics**
+ [AWS Cloud9 與 整合 AWS CodeCommit](setting-up-ide-c9.md)
+ [將 Visual Studio 與 整合 AWS CodeCommit](setting-up-ide-vs.md)

當您的 IDE 或開發工具提示用於連線至 CodeCommit 儲存庫的使用者名稱和密碼時，請提供您在 IAM 中建立的**使用者名稱和密碼**的 Git 登入**資料**。

如需 CodeCommit 的 AWS 區域 和 端點的詳細資訊，請參閱 [區域和 Git 連線端點](regions.md)。

您的作業系統也可能提示您存放使用者名稱和密碼。例如，在 Windows 中，您需要如下所示提供 Git 登入資料：

![\[Windows 中的安全提示\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-ide-vs2.png)


如需有關為特定軟體程式或開發工具來設定 Git 登入資料的資訊，請參閱產品文件。

下面是不全面的 IDE 列表。這些連結僅用於協助您進一步了解這些工具。 AWS 不負責任何這些主題的內容。
+ [AWS Cloud9](setting-up-ide-c9.md)  
![\[在 中複製儲存庫 AWS Cloud9。\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-ide-c9-clone.png)
+ [Visual Studio](https://www.visualstudio.com/en-us/docs/git/tutorial/creatingrepo#clone-an-existing-git-repo)

  或者，安裝 AWS Toolkit for Visual Studio。如需詳細資訊，請參閱[將 Visual Studio 與 整合 AWS CodeCommit](setting-up-ide-vs.md)。  
![\[在 Visual Studio 中複製儲存庫。\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-ide-vs1.png)
+ [XCode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/xcode_guide-continuous_integration/PublishYourCodetoaSourceRepository.html)

# 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)。

# 將 Visual Studio 與 整合 AWS CodeCommit
<a name="setting-up-ide-vs"></a>

您可以使用 Visual Studio 在 CodeCommit 儲存庫中變更程式碼。現在 AWS Toolkit for Visual Studio 包含的功能可讓您在 Visual Studio 中使用 CodeCommit 更輕鬆方便。Toolkit for Visual Studio 整合旨在使用 Git 登入資料和 IAM 使用者。您可以複製現有的儲存庫、建立儲存庫、將程式碼變更遞交並推送至儲存庫等等。

**重要**  
Toolkit for Visual Studio 僅適用於在 Windows 作業系統上安裝。如果您要尋找有關使用 Visual Studio Code 的資訊，請參閱 [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)。

如果您之前已使用 Toolkit for Visual Studio，您可能已經熟悉設定 AWS 包含存取金鑰和私密金鑰的登入資料設定檔。登入資料描述檔用於 Toolkit for Visual Studio，以啟用對 AWS 服務 APIs呼叫 （例如，Amazon S3 列出儲存貯體，或 CodeCommit 列出儲存庫）。若要將程式碼提取並推送至 CodeCommit 儲存庫，您也需要 Git 登入資料。如果您沒有 Git 登入資料， Toolkit for Visual Studio 可以為您產生和套用這些登入資料。這可以節省許多時間。

若要搭配 CodeCommit 使用 Visual Studio，您需要下列項目：
+ 已為其設定一組有效登入資料 （存取金鑰和私密金鑰） 的 IAM 使用者。此 IAM 使用者也應該有：

  其中一個 CodeCommit 受管政策和套用到它的IAMSelfManageServiceSpecificCredentials受管政策。

  或

  如果 IAM 使用者已設定 Git 登入資料，則為其中一個 CodeCommit 受管政策或同等許可。

   如需詳細資訊，請參閱[AWS CodeCommit 的 受管政策](security-iam-awsmanpol.md)和[了解和取得您的安全登入資料](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)。
+ 在您 AWS Toolkit for Visual Studio 安裝 Visual Studio 的電腦上安裝的 。如需詳細資訊，請參閱[設定 AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/getting-set-up.html)。

如需 AWS Toolkit for Visual Studio 搭配 CodeCommit 使用 的詳細資訊，請參閱《 Toolkit for [Visual Studio 使用者指南》中的搭配使用 AWS CodeCommit 與 Visual Studio Team Explorer](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/using-aws-codecommit-with-team-explorer.html)。 **