

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

# 設定 AWS CodeCommit
<a name="setting-up"></a>

您可以登入 ， AWS 管理主控台 直接從 AWS CodeCommit [主控台上傳、新增或編輯檔案](files.md)至儲存庫。這是快速進行變更的方式。不過，如果您想要處理多個檔案、跨分支的檔案等等，請考慮設定本機電腦來使用儲存庫。設定 CodeCommit 最簡單的方法是設定 HTTPS Git 登入資料 AWS CodeCommit。此 HTTPS 身分驗證方法：
+ 使用靜態使用者名稱和密碼。
+ 適用於 CodeCommit 支援的所有作業系統。
+ 也相容於整合開發環境 (IDE) 和其他支援 Git 登入資料的開發工具。

如果您基於操作理由而不想要或無法使用 Git 登入資料，則可以使用其他方法。例如，如果您使用聯合存取、臨時登入資料或 Web 身分提供者來存取 CodeCommit 儲存庫，則無法使用 Git 登入資料。建議您使用 `git-remote-codecommit` 命令設定本機電腦。請仔細檢閱這些選項，決定最適合您的替代方法。
+ [使用 Git 登入資料設定](#setting-up-standard)
+ [使用其他方法設定](#setting-up-other)
+ [CodeCommit、Git 和其他元件的相容性](#setting-up-compat)

如需使用 CodeCommit 和 Amazon Virtual Private Cloud 的詳細資訊，請參閱 [使用 AWS CodeCommit 搭配界面 VPC 端點](codecommit-and-interface-VPC.md) 。

## 檢視和管理登入資料
<a name="setting-up-view-credentials"></a>

您可以透過我的安全登入資料，從 AWS 主控台檢視和管理 CodeCommit 登入資料。 ****

**注意**  
此選項不適用於使用聯合身分存取、暫時登入資料或 Web 身分提供者的使用者。

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)：//www. 開啟 IAM 主控台。

1. 在右上方的導覽列中，選擇您的使用者名稱，然後選擇 **Security Credentials (安全登入資料)**。

1. 選擇**AWS CodeCommit 登入**資料索引標籤。

## 使用 Git 登入資料設定
<a name="setting-up-standard"></a>

使用 HTTPS 連線和 Git 登入資料，您可以在 IAM 中產生靜態使用者名稱和密碼。然後，您會將這些登入資料用於 Git，以及任何支援 Git 使用者名稱和密碼身分驗證的第三方工具。大部分 IDE 和開發工具都支援此方法。這是搭配 CodeCommit 使用最簡單且最簡單的連線方法。
+ [對於使用 Git 登入資料的 HTTPS 使用者](setting-up-gc.md)：請依照這些指示，使用 Git 登入資料在本機電腦和 CodeCommit 儲存庫之間設定連線。
+ [用於開發工具的連線](setting-up-ide.md)：請遵循這些準則，使用 Git 登入資料在 IDE 或其他開發工具和 CodeCommit 儲存庫之間設定連線。支援 Git 登入IDEs 包括 （但不限於） Visual Studio、Xcode 和 IntelliJ。

## 使用其他方法設定
<a name="setting-up-other"></a>

您可以使用 SSH 通訊協定而非 HTTPS 來連線至 CodeCommit 儲存庫。使用 SSH 連接，您可以在本機電腦上建立 Git 和 CodeCommit 用於 SSH 身分驗證的公有和私有金鑰檔案。您可以將公有金鑰與您的 IAM 使用者建立關聯。您需要將私有金鑰存放在本機電腦。由於 SSH 需要手動建立和管理公有和私有金鑰檔案，您可能會發現 Git 登入資料更簡單且更容易與 CodeCommit 搭配使用。

與 Git 登入資料不同，根據本機電腦的作業系統而定，SSH 連線設定會有所不同。
+ [對於未使用 的 SSH 使用者 AWS CLI](setting-up-without-cli.md)：如果您已具備公有私有金鑰對，且熟悉在本機電腦上使用 SSH 連線，請遵循這些簡短指示。
+ [針對 Linux、macOS 或 Unix 上的 SSH 連線](setting-up-ssh-unixes.md)：遵循這些說明step-by-step演練，以建立公有私有金鑰對，並在 Linux、macOS 或 Unix 作業系統上設定連線。
+ [Windows 上的 SSH 連線](setting-up-ssh-windows.md)：依照這些指示，在 Windows 作業系統上逐步建立公有私有金鑰對和設定連線。

如果您要連線至 CodeCommit AWS 並使用聯合存取、身分提供者或臨時登入資料，或者您不想為 IAM 使用者設定 IAM 使用者或 Git 登入資料，您可以透過兩種方式之一設定 CodeCommit 儲存庫的連線：
+ 安裝並使用 **git-remote-codecommit** (建議使用)。
+ 安裝並使用 AWS CLI隨附的登入資料協助程式。

 這兩種方法都支援存取 CodeCommit 儲存庫，而不需要 IAM 使用者，這表示您可以使用聯合存取和臨時登入資料來連線至儲存庫。建議使用的方法是 git-remote-codecommit 公用程式。它延伸了 Git，而且可與各種 Git 版本和登入資料協助程式相容。不過，並非所有 IDE 均可支援 `git-remote-codecommit` 使用的複製 URL 格式。您可能必須先將儲存庫手動複製到本機電腦，才能在 IDE 中使用這些儲存庫。
+ 遵循[使用 git-remote-codecommit 的 AWS CodeCommit 儲存庫 HTTPS 連線設定步驟](setting-up-git-remote-codecommit.md)中的指示，在 Windows、Linux、macOS 或 Unix **git-remote-codecommit**上安裝和設定 。

中包含的登入資料協助程式 AWS CLI 允許 Git 在 Git 需要向 驗證 AWS 才能與 CodeCommit 儲存庫互動時，使用 HTTPS 和密碼編譯簽署的 IAM 使用者登入資料或 Amazon EC2 執行個體角色版本。有些作業系統和 Git 版本有自己的登入資料協助程式，但會與 AWS CLI包含的登入資料協助程式發生衝突。它們可能會導致 CodeCommit 的連線問題。
+ [對於 Linux、macOS 或 Unix 上使用 AWS CLI 登入資料協助程式的 HTTPS 連線](setting-up-https-unixes.md)：請遵循這些說明，step-by-step演練如何在 Linux、macOS 或 Unix 系統上安裝和設定登入資料協助程式。
+ [對於 Windows 上使用 AWS CLI 登入資料協助程式的 HTTPS 連線](setting-up-https-windows.md)：依照這些指示，在 Windows 系統上逐步安裝和設定登入資料協助程式。

如果您要連線到另一個 Amazon Web Services 帳戶中託管的 CodeCommit 儲存庫，您可以使用 中包含的角色、政策和登入資料協助程式來設定存取和連線 AWS CLI。
+ [使用 角色設定 AWS CodeCommit 儲存庫的跨帳戶存取權](cross-account.md)：遵循這些說明step-by-step演練，將一個 Amazon Web Services 帳戶中的跨帳戶存取設定為另一個 Amazon Web Services 帳戶中 IAM 群組中的使用者。

## CodeCommit、Git 和其他元件的相容性
<a name="setting-up-compat"></a>

當您使用 CodeCommit 時，請使用 Git。您也可以使用其他程式。下表提供關於版本相容性的最新指導。根據最佳實務，我們建議您使用 Git 和其他軟體的最新版本。


**的版本相容性資訊 AWS CodeCommit**  

| 元件 | 版本 | 
| --- | --- | 
| Git | CodeCommit 支援 Git 1.7.9 版和更新版本。Git 2.28 版支援為初始遞交設定分支名稱。我們建議您使用最新版本的 Git。 | 
| Curl | CodeCommit 需要 curl 7.33 和更新版本。不過，HTTPS 和 curl 更新 7.41.0 存在已知問題。如需詳細資訊，請參閱[疑難排解](troubleshooting.md)。 | 
| Python (僅限 git-remote-codecommit) | git-remote-codecommit 需要第 3 版和更新版本。 | 
| Pip (僅限 git-remote-codecommit) | git-remote-codecommit 需要 9.0.3 版和更新版本。 | 
| AWS CLI (git-remote-codecommit僅限 ) | 我們建議所有 CodeCommit 使用者使用最新版本的 AWS CLI 版本 2。 git-remote-codecommit需要 AWS CLI 版本 2 才能支援 AWS SSO 和需要臨時憑證的連線，例如聯合身分使用者。 | 