本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在中创建分支 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://console.aws.amazon.com/codesuite/codemmit](https://console.aws.amazon.com/codesuite/codecommit/home) /home 打开 CodeCommit 控制台。

1. 在**存储库**中，选择要在其中创建分支的存储库的名称。

1. 在导航窗格中，选择 **Branches**。

1. 选择**创建分支**。  
![在 CodeCommit 控制台中创建分支。](http://docs.aws.amazon.com/zh_cn/codecommit/latest/userguide/images/codecommit-branches-create.png)

   在**分支名称**中，输入分支的名称。在**分支来源**中，从列表中选择分支或标签，或粘贴提交 ID。选择**创建分支**。

## 创建分支 (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`到带有昵称`origin`的 CodeCommit 存储库：

   ```
   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>

要将 AWS CLI 命令与一起使用 CodeCommit，请安装 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 存储库的名称，请运行[列表存储库](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli)命令。
   + 新分支的名称（使用 **--branch-name** 选项）。
   + 新分支指向的提交的 ID（使用 **--commit-id** 选项）。

   例如，要在名为的 CodeCommit 存储库中创建一个`MyNewBranch`指向提交 ID `317f8570EXAMPLE` 的名为的分支`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**命令。