A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
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á.
# Gerenciando arquivos de código-fonte na Amazon CodeCatalyst
Na Amazon CodeCatalyst, um arquivo é uma informação independente e controlada por versão disponível para você e outros usuários do repositório de origem e da ramificação em que o arquivo está armazenado. Você pode organizar os arquivos do repositório com uma estrutura de diretórios. CodeCatalystrastreia automaticamente todas as alterações confirmadas em um arquivo. Você pode armazenar diferentes versões dele em diferentes ramificações do repositório.
Para adicionar ou editar vários arquivos em um repositório de origem, use um cliente Git, um Ambiente de Desenvolvimento ou um ambiente de desenvolvimento integrado (IDE). Para adicionar ou editar um único arquivo, você pode usar o CodeCatalyst console.
**Topics**
+ [Criar ou adicionar um arquivo](source-files-create.md)
+ [Visualizar um arquivo](source-files-view.md)
+ [Visualizar o histórico de alterações em um arquivo](source-files-view-history.md)
+ [Edição de um arquivo](source-files-edit.md)
+ [Renomear ou excluir um arquivo](source-files-delete.md)
# Criar ou adicionar um arquivo
Para criar e adicionar arquivos a um repositório de origem, você pode usar o CodeCatalyst console da Amazon, um ambiente de desenvolvimento, um ambiente de desenvolvimento integrado (IDE) conectado ou um cliente Git. O CodeCatalyst console inclui um editor de código para criar arquivos. Esse editor é uma forma conveniente de criar ou editar um arquivo simples, como um arquivo README.md, em uma ramificação em um repositório. Ao trabalhar em mais de um arquivo, pense em [criar um Ambiente de Desenvolvimento](devenvironment-create.md).
**Como criar um Ambiente de Desenvolvimento em um repositório de origem**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. No painel de navegação, selecione **Código** e, depois, selecione **Repositórios de origem**.
1. Selecione o repositório de origem em que você deseja trabalhar no código.
1. Escolha **Criar ambiente de desenvolvimento**.
1. Selecione um IDE compatível no menu suspenso. Consulte [Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento](devenvironment-create.md#devenvironment-supported-ide) para obter mais informações.
1. Execute um destes procedimentos:
+ Selecione **Trabalhar na ramificação existente** e, depois, escolha uma ramificação no menu suspenso **Ramificação existente**.
+ Selecione **Trabalhar em uma nova ramificação**, insira um nome de ramificação no campo **Nome da ramificação** e escolha uma ramificação a partir da qual criar a nova ramificação no menu **Criar ramificação**.
1. Opcionalmente, adicione um nome para o Ambiente de Desenvolvimento ou edite sua configuração.
1. Escolha **Criar**.
**Para criar um arquivo no CodeCatalyst console**
1. Navegue até o projeto onde você deseja criar um arquivo. Para ter mais informações sobre como navegar até um repositório, consulte [Visualizar um repositório de origem](source-repositories-view.md).
1. Selecione o nome do repositório na lista de repositórios de origem do projeto. No painel de navegação, também é possível selecionar **Código** e escolher **Repositórios de origem**.
Selecione o repositório no qual você deseja criar o arquivo.
1. (Opcional) Escolha a ramificação onde você deseja criar o arquivo, se quiser criar o arquivo em uma ramificação diferente da ramificação padrão.
1. Selecione **Criar arquivo**.
1. Insira o nome do arquivo em **Nome do arquivo**. Adicione o conteúdo do arquivo no editor.
**dica**
Se você quiser criar o arquivo em uma subpasta ou subdiretório da raiz da ramificação, inclua essa estrutura como parte do nome do arquivo.
Quando estiver satisfeito com suas alterações, selecione **Confirmar**.
1. Em **Nome do arquivo**, revise o nome do arquivo e faça as alterações que desejar nele. Também é possível selecionar a ramificação onde você deseja criar o arquivo na lista de ramificações disponíveis em **Ramificação**. Em **Mensagem de confirmação**, opcionalmente, insira uma descrição breve, mas informativa, do motivo pelo qual você fez essa alteração. Isso será exibido como as informações básicas da confirmação que adiciona o arquivo ao repositório de origem.
1. Selecione **Confirmar** para confirmar e enviar o arquivo para o repositório de origem.
Você também pode adicionar arquivos a um repositório de origem clonando-o em seu computador local e usando um cliente Git ou um ambiente de desenvolvimento integrado (IDE) conectado para enviar seus arquivos e alterações.
**nota**
Se quiser adicionar um submódulo do Git, você deve usar um cliente Git ou um Ambiente de Desenvolvimento e executar o comando **git submodule add**. Você não pode adicionar ou visualizar submódulos do Git no CodeCatalyst console nem visualizar as diferenças nos submódulos do Git nas pull requests. Para ter mais informações sobre os submódulos do Git, consulte a [documentação do Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).
**Como adicionar um arquivo usando um cliente Git ou um ambiente de desenvolvimento integrado (IDE) conectado**
1. Clone o repositório de origem para o computador local. Para obter mais informações, consulte [Clonar um repositório de origem](source-repositories-clone.md).
1. Crie arquivos ou copie arquivos no seu repositório local.
1. Crie e envie uma confirmação seguindo um destes procedimentos:
+ Se você estiver usando um cliente Git, no terminal ou na linha de comando, execute o comando **git add**, especificando os nomes dos arquivos que você deseja adicionar. Como alternativa, para adicionar todos os arquivos adicionados ou alterados, execute o comando **git add** seguido por um ponto único ou duplo para indicar se você deseja incluir todas as alterações no nível do diretório atual (ponto único) ou todas as alterações no diretório atual e em todos os subdiretórios (ponto duplo). Para confirmar as alterações, execute o comando **git commit -m** e forneça uma mensagem de confirmação. Para enviar suas alterações para o repositório de origem CodeCatalyst, execute**git push**. Para ter mais informações sobre os comandos Git, consulte a documentação e [Comandos do Git para ramificações](source-branches-git.md).
+ Se você estiver usando um Ambiente de Desenvolvimento ou um IDE, crie e adicione arquivos no IDE e, depois, confirme e envie suas alterações. Para ter mais informações, consulte [Escreva e modifique o código com Dev Environments em CodeCatalystEscrever e modificar código com ambientes de desenvolvimento](devenvironment.md) ou a documentação do IDE.
# Visualizar um arquivo
Você pode visualizar os arquivos em seu repositório de origem no CodeCatalyst console da Amazon. Você pode visualizar os arquivos na ramificação padrão e em qualquer outra ramificação. O conteúdo do arquivo pode variar dependendo da ramificação que você escolher visualizar.
**Para visualizar arquivos no CodeCatalyst console**
1. Navegue até o projeto onde você deseja visualizar arquivos. Para obter mais informações, consulte [Visualizar um repositório de origem](source-repositories-view.md).
1.
Selecione o nome do repositório na lista de repositórios de origem do projeto. No painel de navegação, também é possível selecionar **Código** e escolher **Repositórios de origem**.
Selecione o repositório onde você deseja visualizar os arquivos.
1. Uma lista de arquivos e pastas é exibida para a ramificação padrão. Os arquivos são indicados por um ícone de papel, enquanto as pastas são indicadas por um ícone de pasta.
1. Faça o seguinte:
+ Para visualizar arquivos e pastas em uma ramificação diferente, selecione-a na lista de ramificações.
+ Para expandir uma pasta, selecione-a na lista.
1. Para visualizar o conteúdo de um arquivo específico, selecione-o na lista. O conteúdo do arquivo será exibido na ramificação. Para visualizar o conteúdo do arquivo em uma ramificação diferente, escolha a ramificação desejada no seletor de ramificações.
**dica**
Ao visualizar o conteúdo de um arquivo, você pode selecionar arquivos adicionais para visualizar em **Visualizar arquivos**. Para editar um arquivo, selecione **Editar**.
Você pode visualizar vários arquivos no console. Você também pode visualizar arquivos clonados em seu computador local usando um cliente Git ou um ambiente de desenvolvimento integrado (IDE). Para ter mais informações, consulte a documentação do cliente Git ou IDE.
**nota**
Você não pode visualizar os submódulos do Git no console. CodeCatalyst Para ter mais informações sobre os submódulos do Git, consulte a [documentação do Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).
# Visualizar o histórico de alterações em um arquivo
Você pode ver o histórico de alterações em um arquivo no seu repositório de origem no CodeCatalyst console da Amazon. Isso pode ajudá-lo a entender as alterações feitas no arquivo por várias confirmações na ramificação em que você optou por visualizar o histórico do arquivo. Por exemplo, se você visualizar o histórico de alterações no arquivo **readme.md** na ramificação **main** do repositório de origem, verá uma lista de confirmações que incluíram alterações nesse arquivo nessa ramificação.
**nota**
Você não pode visualizar o histórico de um arquivo em um repositório vinculado no CodeCatalyst console.
# Para ver o histórico de um arquivo no CodeCatalyst console
1. Navegue até o projeto onde você deseja visualizar o histórico de um arquivo. Para obter mais informações, consulte [Visualizar um repositório de origem](source-repositories-view.md).
1. Selecione o nome do repositório na lista de repositórios de origem do projeto. No painel de navegação, também é possível selecionar **Código** e escolher **Repositórios de origem**.
1. Selecione o repositório onde você deseja visualizar o histórico de um arquivo. Selecione a ramificação onde deseja visualizar o histórico do arquivo e selecione o arquivo na lista. Selecione **Visualizar histórico**.
1. Revise a lista de confirmações que incluíram alterações nesse arquivo na ramificação especificada. Para visualizar os detalhes das alterações incluídas em uma confirmação específica, escolha a mensagem de confirmação dessa confirmação na lista. As diferenças entre essa confirmação e sua confirmação principal são exibidas.
1. Para revisar o histórico de alterações no arquivo em outra ramificação, use o seletor de ramificação para alterar as visualizações dessa ramificação, selecione o arquivo na lista de arquivos e selecione **Visualizar histórico**.
**nota**
Você não pode ver o histórico de alterações nos submódulos do Git no console. CodeCatalyst Para ter mais informações sobre os submódulos do Git, consulte a [documentação do Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).
# Edição de um arquivo
Você pode editar arquivos individuais no CodeCatalyst console da Amazon. Para editar vários arquivos ao mesmo tempo, crie um Ambiente de Desenvolvimento ou clone o repositório e faça suas alterações usando um cliente Git ou um ambiente de desenvolvimento integrado (IDE). Para ter mais informações, consulte [Escreva e modifique o código com Dev Environments em CodeCatalystEscrever e modificar código com ambientes de desenvolvimento](devenvironment.md) ou [Clonar um repositório de origem](source-repositories-clone.md).
**Para editar um arquivo no CodeCatalyst console**
1. Navegue até o projeto onde você deseja editar um arquivo. Para ter mais informações sobre como navegar até um repositório, consulte [Visualizar um repositório de origem](source-repositories-view.md).
1. Selecione o repositório onde você deseja editar o arquivo. Selecione **Visualizar ramificações** e, depois, selecione a ramificação em que de você deseja trabalhar. Escolha o arquivo na lista de arquivos e pastas dessa ramificação.
O conteúdo do arquivo é exibido.
1. Escolha **Editar**.
1. No editor, edite o conteúdo do arquivo e selecione **Confirmar**. Opcionalmente, em **Confirmar alterações**, adicione mais informações sobre a alteração na **mensagem de confirmação**. Quando estiver satisfeito com suas alterações, selecione **Confirmar**.
# Renomear ou excluir um arquivo
Você pode renomear ou excluir arquivos em um Ambiente de Desenvolvimento, localmente em seu computador ou em um ambiente de desenvolvimento integrado (IDE). Depois de renomear ou excluir os arquivos, confirme e envie essas alterações para o repositório de origem. Você não pode renomear ou excluir arquivos no CodeCatalyst console da Amazon.