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á.

# Trabalhar com arquivos em repositórios do AWS CodeCommit
<a name="files"></a>

No CodeCommit, um arquivo é uma informação autônoma e controlada pela versão disponível para você e outros usuários do repositório e ramificação nos quais o arquivo está armazenado. Você pode organizar seus arquivos de repositório em uma estrutura de diretórios, assim como faria em um computador. Ao contrário de um computador, o CodeCommit rastreia automaticamente todas as alterações em um arquivo. Você pode comparar as versões de um arquivo e armazenar diferentes versões dele em diferentes ramificações do repositório.

Para adicionar ou editar um arquivo em um repositório, você pode usar um cliente do Git. Você também pode usar o console do CodeCommit, a AWS CLI, ou a API do CodeCommit.

![\[Uma visualização da criação de um arquivo no console do CodeCommit\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-create-file.png)


Para obter informações sobre como trabalhar com outros aspectos do seu repositório no CodeCommit, consulte [Trabalhar com repositórios](repositories.md), [Trabalhar com solicitações pull](pull-requests.md), [Como trabalhar com ramificações](branches.md), [Trabalhar com confirmações](commits.md) e [Trabalhar com preferências do usuário](user-preferences.md). 

**Topics**
+ [Procurar arquivos em um AWS CodeCommit repositório](how-to-browse.md)
+ [Criar ou adicionar um arquivo para um repositório do AWS CodeCommit](how-to-create-file.md)
+ [Editar o conteúdo de um arquivo em um AWS CodeCommit repositório](how-to-edit-file.md)

# Procurar arquivos em um AWS CodeCommit repositório
<a name="how-to-browse"></a>

Depois de se conectar a um CodeCommit repositório, você pode cloná-lo em um repositório local ou usar o CodeCommit console para pesquisar seu conteúdo. Este tópico descreve como usar o CodeCommit console para pesquisar o conteúdo de um CodeCommit repositório.

**nota**  
Para CodeCommit usuários ativos, não há cobrança pelo código de navegação no CodeCommit console. Para obter informações sobre quando podem ser aplicadas cobranças, consulte [Definição de preço](https://aws.amazon.com/codecommit/pricing/).

![\[Uma visão do conteúdo de um arquivo no CodeCommit console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-code-browse-file.png)


## Navegue em um CodeCommit repositório
<a name="how-to-browse-console"></a>

Você pode usar o CodeCommit console para revisar os arquivos contidos em um repositório ou para ler rapidamente o conteúdo de um arquivo. 

**Para navegar no conteúdo de um repositório**

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

1. Na página **Repositories (Repositórios)**, na lista de repositórios, escolha o repositório pelo qual deseja navegar. 

1.  Na visualização **Code**, navegue pelo conteúdo da ramificação padrão de seu repositório. 

   Para alterar a visualização para outra ramificação ou tag, escolha o botão seletor de visualização. Escolha um nome de ramificação ou de tag na lista suspensa ou, na caixa de filtro, insira o nome da ramificação ou da tag e escolha-o na lista.

1. Execute um destes procedimentos:
   + Para visualizar o conteúdo de um diretório, escolha-o na lista. Você pode escolher alguns diretórios na lista de navegação para retornar à visualização do diretório. Também é possível usar a seta para cima na parte superior da lista de diretórios.
   + Como visualizar o conteúdo de um arquivo, escolha-o na lista. Se o arquivo for maior do que o limite de objeto de confirmação, ele não poderá ser visualizado no console e deve ser visualizado em um repositório local. Para obter mais informações, consulte [Cotas](limits.md). Para sair da visualização do arquivo, na barra de navegação de código, escolha o diretório que deseja ver.
**nota**  
 Nem todos os arquivos binários podem ser visualizados no console. Se você escolher um arquivo binário potencialmente visualizável, será exibida uma mensagem de aviso pedindo que você confirme se deseja exibir o conteúdo. Para visualizar o arquivo, escolha **Mostrar conteúdo do arquivo**. Caso não queira ver o arquivo, na barra de navegação de código, escolha o diretório que deseja visualizar.  
Se você escolher um arquivo Markdown (.md), use os botões **Markdown renderizado** e **Origem do Markdown** para alternar entre as visualizações renderizada e de sintaxe. Para obter mais informações, consulte [Usar Markdown no console](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html).

# Criar ou adicionar um arquivo para um repositório do AWS CodeCommit
<a name="how-to-create-file"></a>

Você pode usar o console do CodeCommit, a AWS CLI ou um cliente Git para adicionar um arquivo a um repositório. Você pode fazer upload de um arquivo do computador local no repositório, ou usar o editor de códigos no console para criar o arquivo. O editor é uma maneira rápida e fácil de adicionar um arquivo simples, como um arquivo readme.md, a uma ramificação de um repositório. 

![\[Uma visualização do upload de um arquivo no console do CodeCommit\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commit-first-file.png)


**Topics**
+ [Criar ou fazer upload de um arquivo (console)](#how-to-create-file-console)
+ [Adicionar um arquivo (AWS CLI)](#how-to-create-file-cli)
+ [Adicionar um arquivo (Git)](#how-to-create-file-git)

## Criar ou fazer upload de um arquivo (console)
<a name="how-to-create-file-console"></a>

Você pode usar o console do CodeCommit para criar ou adicionar um arquivo a uma ramificação em um repositório do CodeCommit. Como parte da criação do arquivo, você pode fornecer seu nome de usuário e um endereço de e-mail. Também é possível adicionar uma mensagem de confirmação para os outros usuários saberem que você adicionou o arquivo e por qual motivo. Você também pode fazer upload de um arquivo diretamente do computador local para uma ramificação em um repositório.

**Para adicionar um arquivo a um repositório**

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

1. Em **Repositories (Repositórios)**, escolha o repositório que onde deseja adicionar um arquivo.

1. Na visualização **Code**, escolha a ramificação na qual deseja adicionar o arquivo. Por padrão, o conteúdo da ramificação padrão é mostrado quando você abre a visualização **Code**. 

   Para alterar a visualização para outra ramificação, escolha o botão seletor de visualização. Escolha um nome de ramificação na lista suspensa ou, na caixa de filtro, insira o nome da ramificação e escolha-o na lista.

1. Escolha **Add file** e, em seguida, escolha uma das seguintes opções:
   +  Para usar o editor de códigos para criar o conteúdo de um arquivo e adicioná-lo ao repositório, selecione **Create file (Criar arquivo)**.
   + Para fazer upload de um arquivo do computador local para o repositório, selecione **Upload file (Fazer upload de arquivo)**.

1. Forneça informações a outros usuários sobre quem adicionou esse arquivo ao repositório e por qual motivo. 
   + Em **Author name (Nome do autor)**, insira seu nome. Esse nome é usado como o nome do autor e do responsável pela confirmação nas informações de confirmação. Por padrão, o CodeCommit usa seu nome de usuário do IAM ou uma derivação do seu login no console como nome do autor.
   + Em **Endereço de e-mail**, insira um endereço de e-mail para que outros usuários do repositório possam entrar em contato sobre essa alteração. 
   + Em **Commit message (Confirmar mensagem)**, insira uma breve descrição. Isso é opcional, mas altamente recomendado. Caso contrário, uma mensagem de confirmação padrão será usada.

1. Execute um destes procedimentos:
   + Se você estiver fazendo upload de um arquivo, escolha o arquivo no seu computador local.
   + Se você estiver criando um arquivo, insira o conteúdo que deseja adicionar no editor de códigos e dê um nome para o arquivo.

1. Escolha **Commit changes (Confirmar alterações)**.

## Adicionar um arquivo (AWS CLI)
<a name="how-to-create-file-cli"></a>

Você pode usar a AWS CLI e o comando **put-file** para adicionar um arquivo em um repositório do CodeCommit. Você também pode usar o comando **put-file** para adicionar um diretório ou uma estrutura de caminho ao arquivo.

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

**Para adicionar um arquivo a um repositório**

1. No computador local, crie o arquivo que você deseja adicionar ao repositório do CodeCommit.

1. No terminal ou na linha de comando, execute o comando **put-file**, especificando:
   + O repositório no qual você deseja adicionar o arquivo.
   + A ramificação na qual você deseja adicionar o arquivo.
   + O ID de confirmação completo da confirmação mais recente feita nessa ramificação, também conhecido como a confirmação de ponta ou cabeça.
   + A localização atual do arquivo. A sintaxe usada para essa localização varia, dependendo do seu sistema operacional local.
   + O nome do arquivo que você deseja adicionar, incluindo o caminho onde o arquivo atualizado está armazenado no repositório, se houver.
   + O nome de usuário e e-mail a serem associados a este arquivo.
   + Uma mensagem de confirmação explicando por que você adicionou este arquivo.

   O nome de usuário, endereço de e-mail e a mensagem de confirmação são opcionais, mas ajudam outros usuários a saber quem fez a alteração e por quê. Se você não fornecer um nome de usuário, o CodeCommit usará seu nome de usuário do IAM como padrão ou uma derivação do seu login no console como nome do autor.

   Por exemplo, para adicionar um arquivo chamado *SoluçãoDeExemplo.py* a um repositório chamado *MeuRepoDemo* para uma ramificação denominada *recurso-recursodealeatorização* cuja confirmação mais recente apresenta um ID de *4c925148EXEMPLO*:

   ```
   aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I added a third randomization routine."
   ```
**nota**  
Quando você adiciona arquivos binários, use `fileb://` para especificar a localização atual do arquivo.

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
      "blobId": "2eb4af3bEXAMPLE",
      "commitId": "317f8570EXAMPLE",
      "treeId": "347a3408EXAMPLE"
   }
   ```

## Adicionar um arquivo (Git)
<a name="how-to-create-file-git"></a>

Você pode adicionar arquivos a um repositório local e enviar as alterações via push a um repositório do CodeCommit. Para obter mais informações, consulte [Começando com o Git e AWS CodeCommit](getting-started.md).

# Editar o conteúdo de um arquivo em um AWS CodeCommit repositório
<a name="how-to-edit-file"></a>

Você pode usar o CodeCommit console ou um cliente Git para editar o conteúdo de um arquivo em um CodeCommit repositório. AWS CLI

![\[Uma visão da edição de um arquivo no CodeCommit console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-edit-file.png)


**Topics**
+ [Editar um arquivo (console)](#how-to-edit-file-console)
+ [Editar ou excluir um arquivo (AWS CLI)](#how-to-edit-file-cli)
+ [Editar um arquivo (Git)](#how-to-edit-file-git)

## Editar um arquivo (console)
<a name="how-to-edit-file-console"></a>

Você pode usar o CodeCommit console para editar um arquivo que foi adicionado a uma ramificação em um CodeCommit repositório. Como parte da edição do arquivo, você pode fornecer seu nome de usuário e um endereço de e-mail. Também é possível adicionar uma mensagem de confirmação para os outros usuários saberem que você fez a alteração e por quê.

**Para editar um arquivo em um repositório**

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 repositório que onde deseja editar um arquivo. 

1. Na visualização **Code**, escolha a ramificação na qual deseja editar o arquivo. Por padrão, o conteúdo da ramificação padrão é mostrado quando você abre a visualização **Code**. 

   Para alterar a visualização para outra ramificação, escolha o botão seletor de visualização. Escolha um nome de ramificação na lista suspensa ou, na caixa de filtro, insira o nome da ramificação e escolha-o na lista.

1. Navegue pelo conteúdo da ramificação e escolha o arquivo que deseja editar. Na visualização, escolha **Edit**.
**nota**  
Se você escolher um arquivo binário, será exibida uma mensagem de aviso pedindo que você confirme se deseja exibir o conteúdo. Você não deve usar o CodeCommit console para editar arquivos binários.

1. Edite o arquivo e forneça informações a outros usuários sobre quem fez essa alteração e por qual motivo. 
   + Em **Author name (Nome do autor)**, insira seu nome. Esse nome é usado como nome do autor e nome do confirmador nas informações do commit. CodeCommit usa como padrão o nome de usuário do IAM ou uma derivação do login do console como nome do autor.
   + Em **Endereço de e-mail**, insira um endereço de e-mail para que outros usuários do repositório possam entrar em contato sobre essa alteração. 
   + Em **Commit message (Mensagem de confirmação)**, insira uma breve descrição de suas alterações.

1. Escolha **Commit changes** para salvar as alterações no arquivo e confirmar as alterações no repositório.

## Editar ou excluir um arquivo (AWS CLI)
<a name="how-to-edit-file-cli"></a>

Você pode usar o **put-file** comando AWS CLI and the para fazer alterações em um arquivo em um CodeCommit repositório. Você também pode usar o comando **put-file** para adicionar um diretório ou estrutura de caminho ao arquivo alterado, caso deseje armazenar o arquivo alterado em um local diferente do original. Se quiser excluir um arquivo completamente, você poderá usar o comando **delete-file**.

**nota**  
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). 

**Para editar um arquivo em um repositório**

1. Usando uma cópia local do arquivo, faça as alterações que deseja adicionar ao repositório do CodeCommit.

1. No terminal ou na linha de comando, execute o comando **put-file**, especificando:
   + O repositório no qual você deseja adicionar o arquivo editado.
   + A ramificação na qual você deseja adicionar o arquivo editado.
   + O ID de confirmação completo da confirmação mais recente feita nessa ramificação, também conhecido como a confirmação de ponta ou cabeça.
   + A localização atual do arquivo.
   + O nome do arquivo atualizado que você deseja adicionar, incluindo o caminho onde o arquivo atualizado está armazenado no repositório, se houver.
   + O nome de usuário e e-mail a serem associados a esta alteração.
   + Uma mensagem de confirmação que explica a alteração que você fez.

   O nome de usuário, endereço de e-mail e a mensagem de confirmação são opcionais, mas ajudam outros usuários a saber quem fez a alteração e por quê. Se você não fornecer um nome de usuário, o CodeCommit padrão é usar seu nome de usuário do IAM ou uma derivação do seu login do console.

   Por exemplo, para adicionar edições feitas em um arquivo chamado *ExampleSolution.py* a um repositório chamado *MyDemoRepo* a uma ramificação chamada *feature-randomizationfeature* cujo commit mais recente tem um ID de: *4c925148EXAMPLE*

   ```
   aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I fixed the bug Mary found."
   ```
**nota**  
Se você deseja adicionar um arquivo binário alterado, use `--file-content` com a notação `fileb://MyDirectory/MyFile.raw`.

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
      "blobId": "2eb4af3bEXAMPLE",
      "commitId": "317f8570EXAMPLE",
      "treeId": "347a3408EXAMPLE"
   }
   ```

Para excluir um arquivo, use o comando **delete-file**. Por exemplo, para excluir um arquivo nomeado *README.md* em uma ramificação chamada *main* com uma ID de confirmação mais recente ou *c5709475EXAMPLE* em um repositório chamado*MyDemoRepo*:

```
aws codecommit delete-file --repository-name MyDemoRepo --branch-name main --file-path README.md --parent-commit-id c5709475EXAMPLE
```

Se houver êxito, o comando gerará uma saída semelhante à seguinte:

```
{
  "blobId":"559b44fEXAMPLE",
  "commitId":"353cf655EXAMPLE",
  "filePath":"README.md",
  "treeId":"6bc824cEXAMPLE"
}
```

## Editar um arquivo (Git)
<a name="how-to-edit-file-git"></a>

Você pode editar arquivos em um repositório local e enviar suas alterações para um CodeCommit repositório. Para obter mais informações, consulte [Começando com o Git e AWS CodeCommit](getting-started.md).