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á.
Conceitos de repositório de origem
Aqui estão alguns conceitos que você deve conhecer ao trabalhar com repositórios CodeCatalyst de origem.
Tópicos
Projetos
Um projeto representa um esforço colaborativo CodeCatalyst que apoia equipes e tarefas de desenvolvimento. Depois que tiver um projeto, você poderá adicionar, atualizar ou remover usuários e recursos, personalizar o painel do projeto e monitorar o andamento do trabalho da equipe. Você pode ter vários projetos em um espaço.
Os repositórios de origem são específicos para os projetos onde você os cria ou os vincula em um espaço. Não é possível compartilhar um repositório entre projetos e vincular um repositório a mais de um projeto em um espaço. Os usuários com o perfil de Colaborador ou Administrador do projeto em um projeto podem interagir com os repositórios de origem associados a esse projeto de acordo com as permissões concedidas a esses perfis. Para obter mais informações, consulte Concessão de acesso com perfis de usuário.
Repositórios de origem
Em um repositório de origem, você armazena com segurança códigos e arquivos do seu projeto. Ele também armazena o histórico de versões dos seus arquivos. Por padrão, um repositório de origem é compartilhado com os outros usuários em seu CodeCatalyst projeto. É possível ter mais de um repositório de origem para um projeto. Você pode criar repositórios de origem para projetos em CodeCatalyst, ou você pode optar por vincular um repositório de origem existente hospedado por outro serviço, se esse serviço for suportado por uma extensão instalada. Por exemplo, você pode vincular um GitHub repositório a um projeto depois de instalar a extensão GitHub Repositories. Para ter mais informações, consulte Armazenando o código-fonte em repositórios para um projeto no CodeCatalyst e Início rápido: instalação de extensões, conexão de provedores e vinculação de recursos no CodeCatalyst.
Ambientes de Desenvolvimento
Um ambiente de desenvolvimento é um ambiente de desenvolvimento baseado em nuvem que você pode usar CodeCatalyst para trabalhar rapidamente no código armazenado nos repositórios de origem do seu projeto. As ferramentas do projeto e as bibliotecas de aplicações incluídas no Ambiente de Desenvolvimento são definidas por um arquivo de desenvolvimento no repositório de origem do projeto. Se você não tiver um arquivo de desenvolvimento no repositório de origem, um arquivo padrão será aplicado automaticamente. O arquivo de desenvolvimento padrão inclui ferramentas para as linguagens e estruturas de programação usadas com mais frequência. Por padrão, um Ambiente de Desenvolvimento é configurado para ter um processador de 2 núcleos, 4 GB de RAM e 16 GiB de armazenamento persistente.
Você pode optar por clonar uma ramificação existente do seu repositório de origem em seu Ambiente de Desenvolvimento ou criar uma ramificação como parte da criação do Ambiente de Desenvolvimento.
Tokens de acesso pessoal (PATs)
Um token de acesso pessoal (PAT) é semelhante a uma senha. Ele está associado à sua identidade de usuário para uso em todos os espaços e projetos em CodeCatalyst. Você usa PATs para acessar CodeCatalyst recursos que incluem ambientes de desenvolvimento integrados (IDEs) e repositórios de origem baseados em Git. PATs representam você CodeCatalyst e você pode gerenciá-los em suas configurações de usuário. Um usuário pode ter mais de um PAT. Os tokens de acesso pessoal são exibidos apenas uma vez. Como prática recomendada, armazene-os com segurança em seu computador local. Por padrão, PATs expira após um ano.
Ao trabalhar com ambientes de desenvolvimento integrados (IDEs), PATs são equivalentes a uma senha do Git. Forneça o PAT quando for solicitada uma senha ao configurar seu IDE para trabalhar com um repositório Git. Para ter mais informações sobre como conectar o IDE a um repositório baseado em Git, consulte a documentação do IDE.
Ramificações
Uma ramificação é um ponteiro ou referência para um commit no Git e no. CodeCatalyst Você pode usar ramificações para organizar seu trabalho. Por exemplo, você pode usar ramificações para trabalhar em uma versão nova ou diferente de arquivos sem afetar o trabalho em outras ramificações. Elas também podem ser usadas para desenvolver novos recursos, armazenar uma versão específica do seu projeto e muito mais. Um repositório de origem pode ter uma ramificação ou várias ramificações. Quando você cria um projeto usando um modelo, o repositório de origem criado para o projeto contém arquivos de amostra em uma ramificação chamada principal. Essa ramificação principal é a ramificação padrão do seu repositório.
Ramificações padrão
Os repositórios de origem CodeCatalyst têm uma ramificação padrão, independentemente de como você os cria. Se você optar por criar um projeto usando um modelo, o repositório de origem criado para esse projeto incluirá um arquivo README.md, além de código de exemplo, definições de fluxo de trabalho e outros recursos. Se você criar um repositório de origem sem usar um modelo, um arquivo README.md será adicionado como uma primeira confirmação e uma ramificação padrão será criada como parte da criação do repositório. Essa ramificação padrão é chamada principal. Essa ramificação padrão é aquela usada como base ou ramificação padrão em repositórios locais quando os usuários clonam o repositório. Você pode alterar qual ramificação é usada como ramificação padrão. Para obter mais informações, consulte Gerenciar a ramificação padrão de um repositório.
Você não pode excluir a ramificação padrão de um repositório de origem. Os resultados da pesquisa incluem somente os resultados da ramificação padrão.
Confirmações
Uma confirmação é uma alteração em um arquivo ou conjunto de arquivos. No CodeCatalyst console da Amazon, um commit salva suas alterações e as envia para um repositório de origem. A confirmação inclui informações sobre a alteração, incluindo a identidade do usuário que fez a alteração, a hora e a data da alteração, o título da confirmação e qualquer mensagem incluída sobre a alteração. Para obter mais informações, consulte Entendendo as mudanças no código-fonte com confirmações na Amazon CodeCatalyst.
No contexto de um repositório de origem em CodeCatalyst, os commits são instantâneos do conteúdo e das alterações no conteúdo do seu repositório. Você também pode adicionar tags Git a confirmações para identificar confirmações específicas.
Solicitações pull
Uma solicitação pull é a principal maneira pela qual você e outros usuários revisam, comentam e mesclam alterações de código de uma ramificação para outra em um repositório de origem. Você pode usar solicitações pull para revisar alterações de código de maneira colaborativa em caso de alterações ou correções relativamente pequenas, adições significativas de recursos ou novas versões do seu software lançado. Em uma solicitação pull, você pode revisar as alterações entre as ramificações de origem e de destino ou as diferenças entre as revisões dessas ramificações. Você pode adicionar comentários às alterações de linhas de código individuais, bem como comentários sobre a solicitação pull em geral.
dica
Enquanto você cria uma solicitação pull, a diferença exibida é a diferença entre a ponta da ramificação de origem e a ponta da ramificação de destino. Depois que a solicitação pull for criada, a diferença exibida será entre a revisão da solicitação pull escolhida e a confirmação que foi a ponta da ramificação de destino quando você criou a solicitação pull. Para obter mais informações sobre diferenças e bases de mesclagem no Git, git-merge-base
Revisões
Revisão é uma versão atualizada de uma solicitação pull. Cada envio para a ramificação de origem de uma solicitação pull cria uma revisão que contém as alterações feitas nas confirmações incluídas nesse envio. Você pode visualizar as diferenças entre as revisões de uma solicitação pull, além das diferenças entre as ramificações de origem e destino. Para obter mais informações, consulte Análise de código com pull requests na Amazon CodeCatalyst.
Fluxos de trabalho
Fluxo de trabalho é um procedimento automatizado que descreve como criar, testar e implantar o código como parte de um sistema de integração contínua e entrega contínua (CI/CD). Um fluxo de trabalho define uma série de etapas ou ações a serem realizadas durante a execução de um fluxo de trabalho. Um fluxo de trabalho também define os eventos, ou gatilhos, que fazem com que o fluxo de trabalho seja iniciado. Para configurar um fluxo de trabalho, você cria um arquivo de definição de fluxo de trabalho usando o editor visual ou YAML do CodeCatalyst console.
dica
Para ver rapidamente como usar fluxos de trabalho em um projeto, crie um projeto com um esquema. Cada esquema implanta um fluxo de trabalho funcional que você pode revisar, executar e experimentar.
Um repositório de origem também pode armazenar os arquivos de configuração e outras informações para fluxos de trabalho, notificações, problemas e outras informações de configuração do projeto. Os arquivos de configuração são criados e armazenados no repositório de origem quando você cria recursos que exigem arquivos de configuração ou quando você especifica o repositório como uma ação de origem para um fluxo de trabalho. Se você criar um projeto a partir de um esquema, terá arquivos de configuração já armazenados no repositório de origem criado para você como parte do projeto. Essas informações de configuração são armazenadas em uma pasta chamada .codecatalyst na ramificação padrão do seu repositório. Sempre que você cria uma ramificação da ramificação padrão, você cria uma cópia dessa pasta e de sua configuração, além de todos os outros arquivos e pastas dessa ramificação.
