AWS CodeCommit 使用 git-remote-codecommit 對 HTTPS 連線的設定步驟 - AWS CodeCommit
步驟 0：安裝 git-remote-codecommit 的先決條件步驟 1：CodeCommit 的初始組態步驟 2：安裝 git-remote-codecommit步驟 3：連線至 CodeCommit 主控台並複製儲存庫後續步驟

AWS CodeCommit 不再提供給新客戶。的現有客戶 AWS CodeCommit 可以繼續正常使用服務。進一步了解」

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

AWS CodeCommit 使用 git-remote-codecommit 對 HTTPS 連線的設定步驟

如果您想要使用根帳戶、聯合存取或臨時登入資料連線至 CodeCommit，您應該使用 設定存取git-remote-codecommit。此公用程式提供簡單的方法，可透過擴展 Git 從 CodeCommit 儲存庫推送和提取程式碼。這是支援使用聯合存取、身分提供者和臨時憑證進行連線的建議方法。若要將許可指派給聯合身分，您可以建立角色並定義角色的許可。當聯合身分進行身分驗證時，該身分會與角色建立關聯，並獲授予由角色定義的許可。如需有關聯合角色的相關資訊，請參閱《IAM 使用者指南》中的為第三方身分提供者 (聯合) 建立角色。如果您使用 IAM Identity Center，則需要設定許可集。為控制身分驗證後可以存取的內容，IAM Identity Center 將許可集與 IAM 中的角色相關聯。如需有關許可集的資訊，請參閱 AWS IAM Identity Center 使用者指南中的許可集。

您也可以git-remote-codecommit搭配 IAM 使用者使用 。git-remote-codecommit 與其他 HTTPS 連線方法不同，不需要為使用者設定 Git 登入資料。

注意

某些 IDE 不支援 git-remote-codecommit 使用的複製 URL 格式。您可能必須先將儲存庫手動複製到本機電腦，才能在偏好使用的 IDE 中使用這些儲存庫。如需詳細資訊，請參閱對 git-remote-codecommit 和 進行故障診斷 AWS CodeCommit。

這些程序的撰寫假設您擁有 Amazon Web Services 帳戶、已在 CodeCommit 中建立至少一個儲存庫，並在連線至 CodeCommit 儲存庫時使用具有受管政策的 IAM 使用者。如需如何為聯合身分使用者設定存取和其他輪換登入資料類型的相關資訊，請參閱使用輪換憑證連線至 AWS CodeCommit 儲存庫。

步驟 0：安裝 git-remote-codecommit 的先決條件

您必須先在本機電腦上安裝某些必要項目，才能使用 git-remote-codecommit。其中包含：

注意

當您在 Windows 上安裝 Python 時，請務必選擇此選項以將 Python 新增到路徑中。

git-remote-codecommit 需要 PIP 9.0.3 版或更新版本。若要檢查您的 PIP 版本，請開啟終端機或命令列，然後執行下列命令：

pip --version

您可以執行下列兩個命令，將 PIP 版本更新為最新版：

curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user

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

若要安裝 Git，我們建議使用 Git 下載等網站。

注意

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

步驟 1：CodeCommit 的初始組態

請依照下列步驟建立 IAM 使用者、使用適當的政策進行設定、取得存取金鑰和私密金鑰，以及安裝和設定 AWS CLI。

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

  1. 前往 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/：//www. 開啟 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，請參閱下列內容：

    若要連線到儲存庫或其他資源 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 和 設定檔的詳細資訊，請參閱具名設定檔。

步驟 2：安裝 git-remote-codecommit

請按照下列步驟安裝 git-remote-codecommit。

如何安裝 git-remote-codecommit

  1. 在終端機或命令列，執行下列命令：

    pip install git-remote-codecommit
    注意

    根據您的作業系統和組態，您可能需要執行此命令並提高許可，例如 sudo，或使用 --user 參數安裝到不需要特殊權限的目錄，例如您目前的使用者帳戶。例如，在執行 Linux、macOS 或 Unix 的電腦上：

    sudo pip install git-remote-codecommit

    在執行 Windows 的電腦上：

    pip install --user git-remote-codecommit

  2. 監控安裝程序，直到您看到成功訊息。

步驟 3：連線至 CodeCommit 主控台並複製儲存庫

如果管理員已將複製 URL 傳送給您，以搭配 git-remote-codecommit CodeCommit 儲存庫使用，您可以略過連線至主控台並直接複製儲存庫。

連線至 CodeCommit 儲存庫

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

  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. 在終端機或命令提示視窗中，使用 git clone 命令複製儲存庫。如果您建立具名 AWS CLI 設定檔，請使用您複製的 HTTPS git-remote-codecommit URL 和設定檔的名稱。如果您沒有指定描述檔，此命令會假定預設描述檔。在您執行此命令的目錄中，將會在該目錄的子目錄中建立本機儲存庫。例如，若要將名為 MyDemoRepo 的儲存庫複製到名為 my-demo-repo 的本機儲存庫：

    git clone codecommit://MyDemoRepo my-demo-repo

    如何使用名為 CodeCommitProfile 的描述檔來複製同一個儲存庫：

    git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo

    若要複製與設定檔中設定儲存庫 AWS 區域 不同的儲存庫，請包含 AWS 區域 名稱。例如：

    git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo

後續步驟

您已完成事前準備。依照中的步驟開始使用 CodeCommit 開始使用 CodeCommit。

若要了解如何建立和推送您的第一個遞交，請參閱 在 中建立遞交 AWS CodeCommit。如果您是初次使用 Git，您可能還需要檢閱我可以在哪裡進一步了解 Git？和Git 和 入門 AWS CodeCommit中的資訊。