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

# 在 中建立分支 AWS CodeCommit
<a name="how-to-create-branch"></a>

您可以使用 CodeCommit 主控台或 AWS CLI 為您的儲存庫建立分支。這是要區隔新的或不同版本的檔案，而不影響預設分支中工作的快速方式。在 CodeCommit 主控台中建立分支之後，您必須將該變更提取至本機儲存庫。或者，您可以在本機建立分支，然後從連線至 CodeCommit 儲存庫的本機儲存庫使用 Git 來推送變更。

**Topics**
+ [建立分支 （主控台）](#how-to-create-branch-console)
+ [建立分支 (Git)](#how-to-create-branch-git)
+ [建立分支 (AWS CLI)](#how-to-create-branch-cli)

## 建立分支 （主控台）
<a name="how-to-create-branch-console"></a>

您可以使用 CodeCommit 主控台在 CodeCommit 儲存庫中建立分支。當使用者下一次從儲存庫提取變更之後，他們會看到新的分支。

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

1. 在 **Repositories (儲存庫)** 中，選擇您要建立分支所在儲存庫的名稱。

1. 在導覽窗格中，選擇 **Branches (分支)**。

1. 選擇 **Create branch (建立分支)**。  
![在 CodeCommit 主控台中建立分支。](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-branches-create.png)

   在 **Branch name (分支名稱)** 中，輸入分支的名稱。在 **Branch from (分支來源)** 中，從清單中選擇分支或標籤，或貼上遞交 ID。選擇 **Create branch (建立分支)**。

## 建立分支 (Git)
<a name="how-to-create-branch-git"></a>

請依照下列步驟，從本機儲存庫使用 Git 在本機儲存庫中建立分支，然後將該分支推送至 CodeCommit 儲存庫。

這些步驟的撰寫假設您已將本機儲存庫連線至 CodeCommit 儲存庫。如需說明，請參閱[連接到儲存庫](how-to-connect.md)。

1. 執行 **git checkout -b {{new-branch-name}}**命令，在本機儲存庫中建立分支，其中 {{new-branch-name}} 是新分支的名稱。

   例如，下列命令會在本機儲存庫`MyNewBranch`中建立名為 的分支：

   ```
   git checkout -b MyNewBranch
   ```

1. 若要將新的分支從本機儲存庫推送至 CodeCommit 儲存庫，請執行 **git push**命令，同時指定 **{{remote-name}}**和 **{{new-branch-name}}**。

   例如，若要使用別名 將名為 的本機儲存庫中的新分支推送`MyNewBranch`至 CodeCommit 儲存庫`origin`：

   ```
   git push origin MyNewBranch
   ```

**注意**  
如果您將 `-u` 選項新增至 **git push** (例如，**git push -u origin main**)，那麼，在未來您可以執行 **git push** 而不帶 {{remote-name}} {{branch-name}}。上游追蹤資訊即已設定。若要取得上游追蹤資訊，請執行 **git remote show {{remote-name}}** (例如，**git remote show origin**)。  
若要查看所有本機和遠端追蹤分支的清單，請執行 **git branch --all**。  
若要在連線至 CodeCommit 儲存庫中分支的本機儲存庫中設定分支，請執行 **git checkout {{remote-branch-name}}**。

如需更多選項，請參閱 Git 文件。

## 建立分支 (AWS CLI)
<a name="how-to-create-branch-cli"></a>

若要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 AWS CLI。如需詳細資訊，請參閱[命令列參考](cmd-ref.md)。

請依照下列步驟，使用 AWS CLI 在 CodeCommit 儲存庫中建立分支，然後將該分支推送至 CodeCommit 儲存庫。如需建立初始遞交並指定空白儲存庫預設分支名稱的步驟，請參閱[使用 建立儲存庫的第一個遞交 AWS CLI](how-to-create-commit.md#create-first-commit)。

1. 執行 **create-branch** 命令，並指定：
   + 建立分支的 CodeCommit 儲存庫名稱 （使用 **--repository-name**選項）。
**注意**  
若要取得 CodeCommit 儲存庫的名稱，請執行 [list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli) 命令。
   + 新分支的名稱 (使用 **--branch-name** 選項)。
   + 新分支指向的遞交 ID (使用 **--commit-id** 選項)。

   例如，若要建立名為 的分支`MyNewBranch`，在名為 的 CodeCommit 儲存庫`317f8570EXAMPLE`中指向遞交 ID`MyDemoRepo`：

   ```
   aws codecommit create-branch --repository-name MyDemoRepo --branch-name MyNewBranch --commit-id 317f8570EXAMPLE
   ```

   只有在發生錯誤時，此命令才會產生輸出。

1. 若要使用新的遠端分支名稱更新本機儲存庫中可用 CodeCommit 儲存庫分支的清單，請執行 **git remote update {{remote-name}}**。

   例如，若要使用別名 更新 CodeCommit 儲存庫的可用分支清單`origin`：

   ```
   git remote update origin 
   ```
**注意**  
或者，您也可以執行 **git fetch** 命令。您也可以執行 檢視所有遠端分支**git branch --all**，但在您更新本機儲存庫的清單之前，您建立的遠端分支不會出現在清單中。  
如需更多選項，請參閱 Git 文件。

1. 若要在連線至 CodeCommit 儲存庫中新分支的本機儲存庫中設定分支，請執行 **git checkout {{remote-branch-name}}**。

**注意**  
 若要取得 CodeCommit 儲存庫名稱及其 URLs的清單，請執行 **git remote -v**命令。