

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie uma filial em AWS CodeCommit
<a name="how-to-create-branch"></a>

Você pode usar o CodeCommit console ou o AWS CLI para criar branches para seu repositório. Esta é uma maneira rápida de separar o trabalho em uma versão nova ou diferente de arquivos sem afetar o trabalho na ramificação padrão. Depois de criar uma ramificação no CodeCommit console, você deve transferir essa alteração para seu repositório local. Como alternativa, você pode criar uma ramificação localmente e, em seguida, usar o Git de um repositório local conectado ao CodeCommit repositório para enviar essa alteração. 

**Topics**
+ [Criar uma ramificação (console)](#how-to-create-branch-console)
+ [Criar uma ramificação (Git)](#how-to-create-branch-git)
+ [Criar uma ramificação (AWS CLI)](#how-to-create-branch-cli)

## Criar uma ramificação (console)
<a name="how-to-create-branch-console"></a>

Você pode usar o CodeCommit console para criar uma ramificação em um CodeCommit repositório. Da próxima vez que os usuários extraírem alterações do repositório, eles verão a nova ramificação.

1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Em **Repositories (Repositórios)**, escolha o nome do repositório onde você deseja criar uma ramificação. 

1. No painel de navegação, escolha **Branches**.

1. Escolha **Create branch**.   
![Criação de uma ramificação no CodeCommit console.](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-branches-create.png)

   Em **Branch name (Nome da ramificação)**, insira um nome para a ramificação. Em **Branch from (Ramificação de)**, escolha uma ramificação ou tag da lista ou cole um ID de confirmação. Escolha **Create branch**.

## Criar uma ramificação (Git)
<a name="how-to-create-branch-git"></a>

Siga estas etapas para usar o Git de um repositório local para criar uma ramificação em um repositório local e, em seguida, enviar essa ramificação para o repositório. CodeCommit 

Essas etapas são escritas com a suposição de que você já conectou o repositório local ao CodeCommit repositório. Para instruções, consulte [Conexão a um repositório](how-to-connect.md).

1. Crie uma ramificação em seu repositório local executando o **git checkout -b {{new-branch-name}}** comando, onde {{new-branch-name}} está o nome da nova ramificação.

   Por exemplo, o seguinte comando cria uma ramificação chamada `MyNewBranch` no repositório local:

   ```
   git checkout -b MyNewBranch
   ```

1. Para enviar a nova ramificação do repositório local para o CodeCommit repositório, execute o **git push** comando, especificando o e o. **{{remote-name}}** **{{new-branch-name}}** 

   Por exemplo, para enviar uma nova ramificação no repositório local chamada `MyNewBranch` para o CodeCommit repositório com o apelido: `origin`

   ```
   git push origin MyNewBranch
   ```

**nota**  
Se você adicionar a `-u` opção a **git push** (por exemplo,**git push -u origin main**), no futuro poderá executar **git push** sem {{remote-name}}{{branch-name}}. As informações de rastreamento upstream estão definidas. Para obter as informações de rastreamento upstream, execute **git remote show {{remote-name}}** (por exemplo, **git remote show origin**).  
Para ver uma lista de todas as ramificações de rastreamento local e remoto, execute **git branch --all**.  
Para configurar uma ramificação no repositório local conectada a uma ramificação no CodeCommit repositório, execute. **git checkout {{remote-branch-name}}**

Para obter mais opções, consulte a documentação do Git.

## Criar uma ramificação (AWS CLI)
<a name="how-to-create-branch-cli"></a>

Para usar AWS CLI comandos com CodeCommit, instale AWS CLI o. Para obter mais informações, consulte [Referência da linha de comando](cmd-ref.md). 

Siga estas etapas para usar o AWS CLI para criar uma ramificação em um CodeCommit repositório e, em seguida, enviar essa ramificação para o CodeCommit repositório. Para ver as etapas para criar uma confirmação inicial e especificar o nome da ramificação padrão para um repositório vazio, consulte [Criar a primeira confirmação para um repositório usando a AWS CLI](how-to-create-commit.md#create-first-commit).

1. Execute o comando **create-branch**, especificando:
   + O nome do CodeCommit repositório em que a ramificação é criada (com a **--repository-name** opção).
**nota**  
Para obter o nome do CodeCommit repositório, execute o comando [list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli).
   + O nome da nova ramificação (com a opção **--branch-name**).
   + O ID da confirmação para a qual a nova ramificação apontará (com a opção **--commit-id**).

   Por exemplo, para criar uma ramificação chamada `MyNewBranch` que aponte para o ID do commit `317f8570EXAMPLE` em um CodeCommit repositório chamado`MyDemoRepo`:

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

   Esse comando gerará saídas somente se houver erros.

1. Para atualizar a lista de ramificações de CodeCommit repositório disponíveis em seu repositório local com o novo nome da ramificação remota, execute. **git remote update {{remote-name}}**

   Por exemplo, para atualizar a lista de ramificações disponíveis para o CodeCommit repositório com o apelido`origin`:

   ```
   git remote update origin 
   ```
**nota**  
Como alternativa, você pode executar o seguinte **git fetch**. Você também pode visualizar todas as ramificações remotas executando **git branch --all**, mas até que você atualize a lista do repositório local, a ramificação remota que você criou não aparecerá nela.   
Para obter mais opções, consulte a documentação do Git.

1. Para configurar uma ramificação no repositório local que esteja conectada à nova ramificação no CodeCommit repositório, execute. **git checkout {{remote-branch-name}}**

**nota**  
 Para obter uma lista dos nomes dos CodeCommit repositórios e seus URLs, execute o **git remote -v** comando.