使用 AWS CLI 登入資料協助程式設定 HTTPS 連線至 Linux、macOS 或 Unix 上 AWS CodeCommit 儲存庫的步驟

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

1. 前往 Amazon Web Services 帳戶，並前往 http://aws.amazon.com Web Services 帳戶並選擇註冊。

2. 在您的 Amazon Web Services 帳戶中建立 IAM 使用者，或使用現有的使用者。請確定您擁有與該 IAM 使用者相關聯的存取金鑰 ID 和私密存取金鑰。如需詳細資訊，請參閱在您的 Amazon Web Services 帳戶中建立 IAM 使用者。

   注意

   CodeCommit 需要 AWS Key Management Service。如果您使用的是現有的 IAM 使用者，請確定沒有政策連接到明確拒絕 CodeCommit 所需的 AWS KMS 動作的使用者。如需詳細資訊，請參閱AWS KMS 和 加密。

3. 登入 AWS Management Console ，並在 https://console.aws.amazon.com/iam/：// 開啟 IAM 主控台。

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

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

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

7. 從政策清單中，選取 AWSCodeCommitPowerUser 或其他 CodeCommit 存取的受管政策。如需詳細資訊，請參閱AWS CodeCommit 的 受管政策。

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

   如需 CodeCommit 受管政策以及與其他群組和使用者共用儲存庫存取權的詳細資訊，請參閱 共用儲存庫 和 AWS CodeCommit的身分驗證與存取控制。

安裝和設定 AWS CLI

1. 在本機電腦上，下載並安裝 AWS CLI。這是從命令列與 CodeCommit 互動的先決條件。我們建議您安裝 AWS CLI 第 2 版。這是 的最新版本， AWS CLI 並支援所有最新功能。這是 唯一 AWS CLI 支援搭配 使用根帳戶、聯合存取或暫時登入資料的 版本git-remote-codecommit。

   如需詳細資訊，請參閱使用 AWS 命令列界面進行設定。

   注意

   CodeCommit 僅適用於 「第 1.7.38 版」和更新 AWS CLI 版本。根據最佳實務，請安裝 或 AWS CLI 將 升級至可用的最新版本。若要判斷 AWS CLI 您已安裝的 版本，請執行 aws --version命令。

   若要 AWS CLI 將舊版 升級至最新版本，請參閱安裝 AWS Command Line Interface。

2. 執行此命令來驗證 AWS CLI 已安裝 的 CodeCommit 命令。

   aws codecommit help

   此命令會傳回 CodeCommit 命令的清單。

3. 使用 configure命令 AWS CLI 以設定檔設定 ，如下所示：

   aws configure

   出現提示時，請指定要與 CodeCommit 搭配使用之 IAM 使用者的 AWS 存取金鑰和 AWS 私密存取金鑰。此外，請務必指定儲存 AWS 區域 庫所在的 ，例如 us-east-2。系統提示您輸入預設輸出格式時，請指定 json。例如，如果您為 IAM 使用者設定設定檔：

   AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
   AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
   Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
   Default output format [None]: Type json here, and then press Enter

   如需建立和設定設定檔以搭配 使用的詳細資訊 AWS CLI，請參閱下列內容：

   • 命名設定檔

   • 在 中使用 IAM 角色 AWS CLI

   • 設定命令

   • 使用輪換憑證連線至 AWS CodeCommit 儲存庫

   若要連線到儲存庫或其他資源 AWS 區域，您必須 AWS CLI 使用預設區域名稱重新設定 。CodeCommit 支援的預設區域名稱包括：

   • us-east-2

   • us-east-1

   • eu-west-1

   • us-west-2

   • ap-northeast-1

   • ap-southeast-1

   • ap-southeast-2

   • ap-southeast-3

   • me-central-1

   • eu-central-1

   • ap-northeast-2

   • sa-east-1

   • us-west-1

   • eu-west-2

   • ap-south-1

   • ap-south-1

   • ca-central-1

   • us-gov-west-1

   • us-gov-east-1

   • eu-north-1

   • ap-east-1

   • me-south-1

   • cn-north-1

   • cn-northwest-1

   • eu-south-1

   • ap-northeast-3

   • af-south-1

   • il-central-1

   如需 CodeCommit 和 的詳細資訊 AWS 區域，請參閱 區域和 Git 連線端點。如需 IAM、存取金鑰和私密金鑰的詳細資訊，請參閱如何取得登入資料？以及管理 IAM 使用者的存取金鑰。如需 AWS CLI 和 設定檔的詳細資訊，請參閱具名設定檔。

1. 從終端機使用 Git 執行 git config，指定使用 Git 登入資料協助程式搭配 AWS 登入資料描述檔，並啟用 Git 登入資料協助程式將路徑傳送至儲存庫：

   git config --global credential.helper '!aws codecommit credential-helper $@'
   git config --global credential.UseHttpPath true

   提示

   登入資料協助程式會使用預設 AWS 登入資料設定檔或 Amazon EC2 執行個體角色。如果您已建立登入資料設定檔以搭配 CodeCommit 使用，您可以指定要使用的 AWS 設定檔CodeCommitProfile，例如 ：

   git config --global credential.helper '!aws --profile CodeCommitProfile codecommit credential-helper $@'    

   如果描述檔名稱包含空格，請務必以引號 (") 括住名稱。

   您可以使用 --local 設定每個儲存庫的描述檔，而非使用 --global 來全體設定。

   Git 登入資料協助程式會將下列值寫入 ~/.gitconfig：

   [credential]    
       helper = !aws --profile CodeCommitProfile codecommit credential-helper $@
       UseHttpPath = true

   重要

   如果您想要在 CodeCommit 的相同本機電腦上使用不同的 IAM 使用者，則必須再次執行 git config命令並指定不同的 AWS 登入資料設定檔。

2. 執行 git config --global --edit 以確認上述值已寫入 ~/.gitconfig。如果成功，您應該會看到上述值 (除了可能已存在於 Git 全域組態檔案中的值之外)。若要結束，您通常會輸入 :q，然後按 Enter 鍵。

   如果您在設定登入資料協助程式之後遇到問題，請參閱疑難排解。

   重要

   如果您使用的是 macOS，請使用下列步驟來確保已正確設定登入資料協助程式。

3. 如果您使用的是 macOS，請使用 HTTPS 連線到 CodeCommit 儲存庫。第一次使用 HTTPS 連線至 CodeCommit 儲存庫後，後續存取會在大約 15 分鐘後失敗。macOS 上的預設 Git 版本會使用 Keychain Access 公用程式來存放登入資料。針對安全措施，為存取 CodeCommit 儲存庫而產生的密碼是暫時的，因此存放在金鑰鏈中的登入資料會在大約 15 分鐘後停止運作。為避免使用這些過期的登入資料，您必須：

   • 安裝一個依預設不使用金鑰鏈的 Git 版本。

   • 將 Keychain Access 公用程式設定為不提供 CodeCommit 儲存庫的登入資料。

   1. 開啟 Keychain Access 公用程式。(您可以使用 Finder 找到它。)

   2. 搜尋 git-codecommit.us-east-2.amazonaws.com。反白此列，開啟操作功能表或以滑鼠右鍵按一下此列，然後選擇 Get Info (取得資訊)。

   3. 選擇 Access Control (存取控制) 標籤。

   4. 在 Confirm before allowing access (允許存取之前確認) 中，選擇 git-credential-osxkeychain，然後選擇減號從清單移除它。

      注意

      從清單移除 git-credential-osxkeychain 之後，每當您執行 Git 命令時就會看到快顯訊息。選擇 Deny (拒絕) 以繼續。如果您覺得快顯帶來太多干擾，以下是一些其他選項：

      • 使用 SSH 而不是 HTTPS 連線至 CodeCommit。如需詳細資訊，請參閱針對 Linux、macOS 或 Unix 上的 SSH 連線。

      • 在 Keychain Access 公用程式中，在 的存取控制索引標籤上git-codecommit.us-east-2.amazonaws.com，選擇允許所有應用程式存取此項目 （不限制存取此項目） 選項。這可防止快顯，但登入資料最終仍會過期 (平均大約 15 分鐘)，您將會看到 403 錯誤訊息。發生這種情況時，您必須刪除金鑰鏈項目才能還原功能。

      • 如需詳細資訊，請參閱Git for macOS：我已成功設定登入資料協助程式，但現在我無法存取儲存庫 (403)。

連線至 CodeCommit 儲存庫

1. 開啟 CodeCommit 主控台，網址為 https：//https://console.aws.amazon.com/codesuite/codecommit/home。

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

3. 尋找您要從清單連接的儲存庫並加以選擇。選擇 Clone URL (複製 URL)，然後選擇複製和連線至儲存庫時要使用的通訊協定。這會將複製 URL 複製。

   • 如果您搭配 IAM 使用者使用 Git 憑證或 隨附的憑證協助程式，請複製 HTTPS URL AWS CLI。

   • 如果您是在本機電腦上使用 git-remote-codecommit 命令，請複製 HTTPS (GRC) URL。

   • 如果您搭配 IAM 使用者使用 SSH 公有/私有金鑰對，請複製 SSH URL。

   注意

   如果您看到歡迎頁面，而不是儲存庫清單，則在您登入 AWS 區域 的 中，沒有與 AWS 您的帳戶相關聯的儲存庫。要建立儲存庫，請參閱 建立 AWS CodeCommit 儲存庫 或依照 Git 和 CodeCommit 入門 教學課程中的步驟。

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

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