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

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

設定 AWS CodeCommit 儲存庫連線的最簡單方法是在 IAM 主控台中設定 CodeCommit 的 Git 登入資料，然後將這些登入資料用於 HTTPS 連線。您也可以將這些相同的登入資料與任何第三方工具或支援使用靜態使用者名稱和密碼進行 HTTPS 身分驗證的整合式開發環境 (IDE) 搭配使用。如需範例，請參閱 [用於開發工具的連線](setting-up-ide.md)。

**注意**  
如果您先前已將本機電腦設定為使用 CodeCommit 的登入資料協助程式，您必須先編輯 .gitconfig 檔案，從檔案中移除登入資料協助程式資訊，才能使用 Git 登入資料。如果您的本機電腦正在執行 macOS，您可能需要從 Keychain Access 清除快取的憑證。

## 步驟 1：CodeCommit 的初始組態
<a name="setting-up-gc-account"></a>

請依照下列步驟設定 Amazon Web Services 帳戶、建立 IAM 使用者，以及設定 CodeCommit 的存取權。

**建立和設定 IAM 使用者以存取 CodeCommit**

1. 前往 https：//[http://aws.amazon.com](https://aws.amazon.com/) 並選擇**註冊**來建立 Amazon Web Services 帳戶。

1. 在您的 Amazon Web Services 帳戶中建立 IAM 使用者，或使用現有的使用者。請確定您擁有與該 IAM 使用者相關聯的存取金鑰 ID 和私密存取金鑰。如需詳細資訊，請參閱[在您的 Amazon Web Services 帳戶中建立 IAM 使用者](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html)。
**注意**  
CodeCommit 需要 AWS Key Management Service。如果您使用的是現有的 IAM 使用者，請確定沒有政策連接到明確拒絕 CodeCommit 所需的 AWS KMS 動作的使用者。如需詳細資訊，請參閱[AWS KMS 和 加密](encryption.md)。

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

1. 在 IAM 主控台的導覽窗格中，選擇**使用者**，然後選擇您要為 CodeCommit 存取設定的 IAM 使用者。

1. 在 **Permissions (許可)** 標籤上，選擇 **Add Permissions (新增許可)**。

1. 在 **Grant permissions (授予許可)** 中，選擇 **Attach existing policies directly (直接連接現有政策)**。

1. 從政策清單中，選取 **AWSCodeCommitPowerUser** 或其他 CodeCommit 存取的受管政策。如需詳細資訊，請參閱[AWS CodeCommit 的 受管政策](security-iam-awsmanpol.md)。

   選取要連接的政策之後，請選擇**下一步：檢閱**以檢閱要連接到 IAM 使用者的政策清單。如果清單正確，請選擇 **Add permissions (新增許可)**。

    如需 CodeCommit 受管政策以及與其他群組和使用者共用儲存庫存取權的詳細資訊，請參閱 [共用儲存庫](how-to-share-repository.md)和 [的身分驗證和存取控制 AWS CodeCommit](auth-and-access-control.md)。

如果您想要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 AWS CLI。我們建議您建立設定檔，以 AWS CLI 搭配 CodeCommit 使用 。如需詳細資訊，請參閱[命令列參考](cmd-ref.md)和[使用具名設定檔](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-using-profiles)。

## 步驟 2：安裝 Git
<a name="setting-up-gc-install-git"></a>

若要使用 CodeCommit 儲存庫中的檔案、遞交和其他資訊，您必須在本機電腦上安裝 Git。CodeCommit 支援 Git 1.7.9 版和更新版本。Git 2.28 版支援為初始遞交設定分支名稱。我們建議您使用最新版本的 Git。

若要安裝 Git，我們建議使用 [Git Downloads](http://git-scm.com/downloads) 等網站。

**注意**  
Git 是一個不斷發展、定期更新的平台。有時，功能變更可能會影響其使用 CodeCommit 的方式。如果您遇到 Git 和 CodeCommit 特定版本的問題，請檢閱 中的資訊[疑難排解](troubleshooting.md)。

## 步驟 3：為與 CodeCommit 的 HTTPS 連線建立 Git 登入資料
<a name="setting-up-gc-iam"></a>

安裝 Git 之後，請在 IAM 中為您的 IAM 使用者建立 Git 登入資料。

**設定 CodeCommit 的 HTTPS Git 登入資料**

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

   請務必以將建立和使用 Git 登入資料連線至 CodeCommit 的 IAM 使用者身分登入。

1. 在 IAM 主控台的導覽窗格中，選擇**使用者**，然後從使用者清單中選擇您的 IAM 使用者。
**注意**  
您可以在我的安全登入資料中直接檢視和管理 CodeCommit 登入資料。 ****如需詳細資訊，請參閱[檢視和管理登入資料](setting-up.md#setting-up-view-credentials)。

1. 在使用者詳細資訊頁面上，選擇**安全登入**資料索引標籤，然後在 **HTTPS Git 登入 AWS CodeCommit**資料中選擇**產生**。  
![\[在 IAM 主控台中產生 Git 登入資料\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-iam-gc1.png)
**注意**  
您無法為 Git 憑證選擇自己的使用者名稱或密碼。如需詳細資訊，請參閱[使用 Git 登入資料和 HTTPS 搭配 CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#git-credentials-code-commit)。

1. 複製 IAM 為您產生的使用者名稱和密碼，方法是顯示、複製此資訊，然後將此資訊貼到本機電腦上的安全檔案中，或選擇**下載登入**資料，將此資訊下載為 .CSV 檔案。您需要此資訊才能連線至 CodeCommit。  
![\[從 IAM 主控台下載 Git 登入資料\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-iam-gc2.png)

   儲存您的登入資料之後，選擇 **Close (關閉)**。
**重要**  
這是您儲存使用者名稱和密碼的唯一機會。如果您不儲存它們，您可以從 IAM 主控台複製使用者名稱，但無法查詢密碼。您必須重設密碼，然後儲存密碼。

## 步驟 4：連線至 CodeCommit 主控台並複製儲存庫
<a name="setting-up-gc-connect-console"></a>

如果管理員已將 CodeCommit 儲存庫的名稱和連線詳細資訊傳送給您，您可以略過此步驟並直接複製儲存庫。

**連線至 CodeCommit 儲存庫**

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在區域選擇器中，選擇建立儲存庫 AWS 區域 的 。儲存庫專屬於 AWS 區域。如需詳細資訊，請參閱[區域和 Git 連線端點](regions.md)。

1. 尋找您要從清單連接的儲存庫並加以選擇。選擇 **Clone URL (複製 URL)**，然後選擇複製和連線至儲存庫時要使用的通訊協定。這會將複製 URL 複製。
   + 如果您使用 Git 登入資料搭配 IAM 使用者或 隨附的登入資料協助程式，請複製 HTTPS URL AWS CLI。
   + 如果您是在本機電腦上使用 **git-remote-codecommit** 命令，請複製 HTTPS (GRC) URL。
   + 如果您搭配 IAM 使用者使用 SSH 公有/私有金鑰對，請複製 SSH URL。
**注意**  
 如果您看到**歡迎**頁面，而不是儲存庫清單，則在您登入 AWS 區域 的 中，沒有與 AWS 您的帳戶相關聯的儲存庫。要建立儲存庫，請參閱 [建立 AWS CodeCommit 儲存庫](how-to-create-repository.md) 或依照 [Git 和 CodeCommit 入門](getting-started.md) 教學課程中的步驟。

1. 開啟終端機、命令列或 Git shell。使用您複製的 HTTPS 複製 URL，執行 **git clone** 命令來複製儲存庫。例如，若要將名為 *MyDemoRepo* 的儲存庫複製到美國東部 （俄亥俄） 區域中名為 *my-demo-repo* 的本機儲存庫：

   ```
   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```

   第一次連接時，系統會提示您提供儲存庫的使用者名稱和密碼。根據本機電腦的組態，此提示可能來自作業系統的登入資料管理系統、您 Git 版本的登入資料管理員公用程式 （例如 Git for Windows 中包含的 Git 登入資料管理員）、IDE 或 Git 本身。在 IAM 中輸入為 Git 登入資料產生的使用者名稱和密碼 （您在 中建立的登入資料[步驟 3：為與 CodeCommit 的 HTTPS 連線建立 Git 登入資料](#setting-up-gc-iam))。根據您的作業系統和其他軟體而定，此資訊可能儲存在登入資料存放區或登入資料管理公用程式中。若是如此，除非您變更密碼、停用 Git 登入資料，或刪除 IAM 中的 Git 登入資料，否則不應再次提示您。

   如果本機電腦上沒有設定登入資料存放區或登入資料管理公用程式，您可以安裝此工具。如需 Git 和如何管理登入資料的詳細資訊，請參閱 Git 文件中的[登入資料儲存](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)。

   如需詳細資訊，請參閱[透過複製儲存庫來連線至 CodeCommit 儲存庫](how-to-connect.md#how-to-connect-http)及[建立遞交](how-to-create-commit.md)。

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

您已完成事前準備。依照中的步驟[開始使用 CodeCommit ](getting-started-cc.md)開始使用 CodeCommit。

若要了解如何建立和推送您的第一個遞交，請參閱 [在 中建立遞交 AWS CodeCommit](how-to-create-commit.md)。如果您是初次使用 Git，您可能還需要檢閱[我可以在哪裡進一步了解 Git？](welcome.md#welcome-get-started-with-git)和[Git 和 入門 AWS CodeCommit](getting-started.md)中的資訊。