AWS CodeCommit教學課程 AWS Cloud9 - AWS Cloud9

AWS Cloud9 不再提供給新客戶。的現有客戶 AWS Cloud9 可繼續正常使用此服務。了解更多」

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

AWS CodeCommit教學課程 AWS Cloud9

您可以使用AWS CodeCommit教學課程來設定與中的遠端程式碼儲存庫互動的AWS Cloud9開發環境CodeCommit。CodeCommit是一項原始程式碼控制服務,您可以用來在AWS 雲端. Git 如需有關 CodeCommit 的詳細資訊,請參閱《 使用者指南》AWS CodeCommit

遵循本教學課程並建立此範例可能會導致您的AWS 帳戶. 其中包括 Amazon EC2 和CodeCommit. 等服務可能的費用。如需詳細資訊,請參閱 Amazon EC2 定價AWS CodeCommit 定價

先決條件

在您使用此範例前,請務必確認您的設定符合下列要求:

  • 您必須已有 AWS Cloud9 EC2 開發環境。本範例假設您已具備 EC2 環境,且該環境已連線到執行 Amazon Linux 或 Ubuntu Server 的 Amazon EC2 執行個體。如果您有不同類型的環境或作業系統,您可能需要依照此範例的說明來設定相關工具。如需詳細資訊,請參閱在中建立環境 AWS Cloud9

  • 您現有環境的 AWS Cloud9 IDE 已開啟。當您開啟環境時,AWS Cloud9 會在 Web 瀏覽器中開啟該環境的 IDE。如需詳細資訊,請參閱在 AWS Cloud9 中開啟環境

步驟 1:設定具有必要存取許可的 IAM 群組

假設您的AWS認證與您中的管理員使用者相關聯AWS 帳戶,而您想要使用該使用者來使用 CodeCommit Then,請跳至步驟 2:在中建立存放庫AWS CodeCommit

您可以使用 AWS Management ConsoleAWS 命令列界面 (AWS CLI) 完成此步驟。

使用主控台設定具有必要存取許可的 IAM 群組

  1. 如果您尚未登入 AWS Management Console,請現在登入。

    針對此步驟,建議您在 AWS 帳戶使用管理員使用者的憑證來登入。如果您無法執行此操作,請洽詢您的 AWS 帳戶 管理員。

  2. 開啟 IAM 主控台。方法如下:從主控台的導覽列選擇 Services (服務),然後,選擇 IAM

  3. 選擇 Groups (群組)

  4. 選擇群組的名稱。

  5. Permissions (許可) 標籤上,針對 Managed Policies (受管政策),選擇 Attach Policy (連接政策)。

  6. 在政策名稱清單中,選取下列其中一個方塊:

    • AWSCodeCommitPowerUser取此選項可存取與儲存庫相關資源CodeCommit的所有功能。不過,這不允許您刪除CodeCommit儲存庫,或建立或刪除其他儲存庫相關資源AWS 服務,例如 Amazon Events。CloudWatch

    • 選取AWSCodeCommitFullAccess以完全控制中的CodeCommit儲存庫和相關資源AWS 帳戶。這包括刪除儲存庫的能力。

    如果您在清單中未看到上述任一政策名稱,請在 Filter (篩選條件) 方塊中輸入政策名稱來顯示它們。

  7. 選擇 Attach Policy (連接政策)

若要查看這些 AWS 受管政策給予群組的存取許可清單,請參閱 AWS CodeCommit 使用者指南中的 AWS CodeCommit 的 AWS 受管 (預先定義) 政策

請直接跳到步驟 2:在 AWS CodeCommit 中建立儲存庫

使用 AWS CLI 設定具備必要存取許可的 IAM 群組

執行 IAM attach-group-policy 命令,並指定群組名稱以及描述必要存取許可的 AWS 受管政策的 Amazon Resource Name (ARN)。語法如下。

aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN

在上述命令中,將 MyGroup 取代為群組的名稱。將 POLICY_ARN 取代為 AWS 受管政策的 ARN:

  • arn:aws:iam::aws:policy/AWSCodeCommitPowerUser以存取與儲存庫相關資源CodeCommit的所有功能。不過,它不允許您刪除CodeCommit儲存庫,或建立或刪除其他儲存庫相關資源AWS 服務,例如 Amazon Events。CloudWatch

  • arn:aws:iam::aws:policy/AWSCodeCommitFullAccess以完CodeCommit全控制AWS 帳戶. 這包括刪除儲存庫的能力。

若要查看這些 AWS 受管政策給予群組的存取許可清單,請參閱 AWS CodeCommit 使用者指南中的 AWS CodeCommit 的 AWS 受管 (預先定義) 政策

步驟 2:在中建立儲存庫 CodeCommit

在此步驟中,您將使用 CodeCommit 主控台在 CodeCommit 中建立遠端程式碼儲存庫。

如果您已經有 CodeCommit 儲存庫,請直接跳到步驟 3:將環境連線至遠端儲存庫

您可以使用 AWS Management ConsoleAWS 命令列界面 (AWS CLI) 完成此步驟。

CodeCommit使用主控台建立存放庫

  1. 假設您以先前步驟的管理員使用者身分登入 AWS Management Console,而且不想要使用管理員使用者來建立儲存庫。然後,登出 AWS Management Console。

  2. 開啟 CodeCommit 主控台,網址為 https://console.aws.amazon.com/codecommit

  3. 在主控台的導覽列中,使用區域選擇器來選擇您想要建立儲存庫的 AWS 區域,例如 US East (Ohio) (美國東部 (俄亥俄))。

  4. 若顯示歡迎頁面,請選擇 Get started (開始使用)。否則,請選擇 Create repository (建立儲存庫)。

  5. Create repository (建立儲存庫) 頁面的 Repository name (儲存庫名稱) 中,輸入新儲存庫的名稱 (例如 MyDemoCloud9Repo)。如果您選擇其他名稱,請將它在此範例中皆予以取代。

  6. (選用) 針對 Description (描述),輸入關於儲存庫的描述。例如,您可以輸入:This is a demonstration repository for the AWS Cloud9 sample.

  7. 選擇 Create repository (建立儲存庫)。即會顯示 Connect to your repository (連線至儲存庫) 窗格。選擇 Close (關閉),因為您將以本主題稍後的不同方式連線至儲存庫。

請直接跳到「步驟 3:將環境連線至遠端儲存庫」。

使用中建立CodeCommit存放庫 AWS CLI

執行 AWS CodeCommit create-repository命令。指定儲存庫名稱、選用描述,以及要在其中建立儲存庫的 AWS 區域。

aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2

在上述命令中,將 us-east-2 取代為要建立儲存庫的 AWS 區域 ID。如需支援的區域清單,請參閱AWS CodeCommit中的Amazon Web Services 一般參考

如果您選擇使用其他儲存庫名稱,請將它在此範例中皆予以取代。

步驟 3:將環境連線至遠端儲存庫

在此步驟中,您可以使用 AWS Cloud9 IDE 連線至您在上一個步驟中建立或識別的CodeCommit存放庫。

注意

如果您偏好透過視覺化界面使用 Git,則可以複製遠端儲存庫。然後,您可以使用 IDE 中提供的 Git 面板功能來新增檔案。

根據您的 AWS Cloud9 開發環境類型,完成下列其中一組程序。

環境類型 遵循下列程序

EC2 環境

  1. 從 IDE 的終端機工作階段,執行下列兩個命令:

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

    如需詳細資訊,請在 AWS CodeCommit 使用者指南整合 AWS Cloud9 與 AWS CodeCommit 參閱步驟 2:在 AWS Cloud9 EC2 開發環境上設定 AWS CLI 憑證協助程式

  2. 請直接跳到本主題稍後的步驟 4:將遠端儲存庫複製到您的環境

SSH 環境

  1. 如果 Git 尚未安裝在環境中,請在 IDE 中使用終端機工作階段安裝。如需詳細資訊,請在《AWS CodeCommit 使用者指南》透過 SSH 連線與 Linux、macOS 或 Unix 的 AWS CodeCommit 儲存庫連線的設定步驟參閱步驟 2:安裝 Git

  2. 完成 AWS CodeCommit 使用者指南中的透過 SSH 連線與 Linux、macOS 或 Unix 的 AWS CodeCommit 儲存庫連線的設定步驟步驟 3:在 Linux、macOS 或 Unix 上設定憑證

    系統指示您登入 AWS Management Console 並開啟 IAM 主控台時,建議您使用 AWS 帳戶 帳戶中的 IAM 管理員使用者憑證登入。如果您無法執行此操作,請洽詢您的 AWS 帳戶 管理員。

  3. 請直接跳到本主題稍後的步驟 4:將遠端儲存庫複製到您的環境

步驟 4:將遠端儲存庫複製到您的環境

在此步驟中,您可以使用 AWS Cloud9 IDE 將中的遠端存放庫複製CodeCommit到您的環境中。

若要複製儲存庫,請執行 git clone 命令。將 CLONE_URL 取代為儲存庫的複製 URL。

git clone CLONE_URL

如果是 EC2 環境,您必須提供以 https:// 開頭的 HTTPS 複製 URL。如果是 SSH 環境,您必須提供以 ssh:// 開頭的 SSH 複製 URL。

若要取得儲存庫的完整複製 URL,請參閱 AWS CodeCommit 使用者指南中的使用 AWS CodeCommit 主控台檢視儲存庫詳細資訊

如果您的儲存庫未含任何檔案,則會顯示警告訊息,例如 You appear to have cloned an empty repository.。這是預期的情況。您稍後會解決。

步驟 5:將檔案新增至儲存庫

在此步驟中,您將在 AWS Cloud9 環境的複製儲存庫中建立三個簡單的檔案。接著,您可以將檔案新增至所複製儲存庫中的 Git 預備區域。最後,您提交暫存文件並將提交推送到中的遠程存儲庫CodeCommit。

如果複製的儲存庫中已經有檔案,表示您已完成,而且可以略過此範例的其餘部分。

將檔案新增至儲存庫
  1. 建立新檔案。在選單列上,選擇 File (檔案)、New File (新增檔案)。

  2. 將下列內容輸入至檔案中,然後選擇 File (檔案)、Save (儲存) 以在 AWS Cloud9 環境的 MyDemoCloud9Repo 目錄中將檔案儲存為 bird.txt

    bird.txt -------- Birds are a group of endothermic vertebrates, characterized by feathers, toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic rate, a four-chambered heart, and a lightweight but strong skeleton.
    注意

    若要確認您將此檔案儲存在正確的目錄,請在 Save As (另存新檔) 對話方塊中,選擇 MyDemoCloud9Repo 資料夾。然後,確保 Folder (資料夾) 顯示 /MyDemoCloud9Repo

  3. 使用以下內容建立兩個名為 insect.txtreptile.txt 的檔案。將檔案儲存在相同的 MyDemoCloud9Repo​ 目錄中。

    insect.txt ---------- Insects are a class of invertebrates within the arthropod phylum that have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen), three pairs of jointed legs, compound eyes, and one pair of antennae.
    reptile.txt ----------- Reptiles are tetrapod (four-limbed vertebrate) animals in the class Reptilia, comprising today's turtles, crocodilians, snakes, amphisbaenians, lizards, tuatara, and their extinct relatives.
  4. 在終端機中,執行 cd 命令以切換至 MyDemoCloud9Repo 目錄。

    cd MyDemoCloud9Repo
  5. 執行 git status 命令以確認檔案已成功儲存至 MyDemoCloud9Repo 目錄中。這三個檔案都會列為未追蹤檔案。

    Untracked files: (use "git add <file>..." to include in what will be committed) bird.txt insect.txt reptile.txt
  6. 執行 git add 命令將檔案新增至 Git 預備區域。

    git add --all
  7. 再次執行 git status 命令以確認檔案已成功新增至 Git 預備區域。這三個檔案現在已列為將遞交的變更。

    Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: bird.txt new file: insect.txt new file: reptile.txt
  8. 執行 git commit 命令以遞交預備檔案。

    git commit -m "Added information about birds, insects, and reptiles."
  9. CodeCommit通過運行git push命令將提交推送到您的遠程存儲庫。

    git push -u origin master
  10. 確認是否已成功推送檔案。開啟 CodeCommit 主控台 (若尚未開啟),網址為 https://console.aws.amazon.com/codecommit

  11. 在頂端導覽列中,接近右邊緣處,選擇您已建立儲存庫的 AWS 區域,例如 US East (Ohio) (美國東部 (俄亥俄))。

  12. 在「儀表板」頁面上,選擇「MyDemoCloud9Repo」。即會顯示三個檔案。

若要繼續試驗CodeCommit儲存庫,請參閱《AWS CodeCommit使用指南》中的「瀏覽存放庫內容」。

如果您是新手,Git並且不想弄亂您的CodeCommit存儲庫,請嘗試在 Try Git 網站上的示例Git存儲庫。

步驟 6:清除

若要避免在使用此範例AWS 帳戶後向您收取持續費用,請刪除CodeCommit存放庫。如需說明,請參閱 AWS CodeCommit 使用者指南中的刪除 AWS CodeCommit 儲存庫

確定也一併刪除環境。如需相關說明,請參閱刪除環境