Conceitos do repositório de origem

Aqui estão alguns conceitos que você deve conhecer ao trabalhar com repositórios CodeCatalyst de origem.

Projetos

Um projeto representa um esforço colaborativo CodeCatalyst que apoia equipes e tarefas de desenvolvimento. Depois de ter um projeto, você pode adicionar, atualizar ou remover usuários e recursos, personalizar o painel do projeto e monitorar o progresso do trabalho da sua equipe. Você pode ter vários projetos em um espaço.

Os repositórios de origem são específicos para os projetos nos quais você os cria ou os vincula em um espaço. Você não pode compartilhar um repositório entre projetos e não pode vincular um repositório a mais de um projeto em um espaço. Os usuários com a função 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 essas funções. Para obter mais informações, consulte Concedendo acesso com funções de usuário.

Repositórios de origem

Um repositório de origem é onde você armazena com segurança o código e os 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. Você pode 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 aplicativos incluídas em seu ambiente de desenvolvimento são definidas por um devfile no repositório de origem do seu projeto. Se você não tiver um devfile em seu repositório de origem, um devfile padrão será aplicado automaticamente. O devfile 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 e 16 GiB de armazenamento persistente. RAM

Você pode optar por clonar uma ramificação existente do seu repositório de origem em seu ambiente de desenvolvimento ou pode optar por criar uma nova 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. PATsrepresentam você CodeCatalyst e você pode gerenciá-los em suas configurações de usuário. Um usuário pode ter mais de umPAT. Os tokens de acesso pessoal são exibidos apenas uma vez. Como prática recomendada, certifique-se de armazená-los 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 a senha PAT quando solicitada ao configurar sua IDE para trabalhar com um repositório Git. Para obter mais informações sobre como conectar seu IDE a um repositório baseado em Git, consulte a documentação do seu. IDE

Ramificações

Uma ramificação é um ponteiro ou referência para um commit no Git e no. CodeCatalyst Você pode usar filiais para organizar seu trabalho. Por exemplo, você pode usar ramificações para trabalhar em uma versão nova ou diferente dos arquivos sem afetar os arquivos em outras ramificações. Você pode usar ramificações 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 main. A ramificação principal é a ramificação padrão do 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 README arquivo.md, além do código de amostra, definições de fluxo de trabalho e outros recursos. Se você criar um repositório de origem sem usar um modelo, um README arquivo.md será adicionado para você como primeiro commit e uma ramificação padrão será criada para você 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 Gerenciando 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

Um commit é 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. O commit 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 do commit 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 aos commits para identificar commits específicos.

Solicitações pull

Uma pull request é a principal forma 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 pull requests para revisar as alterações no código de forma colaborativa em busca de pequenas alterações ou correções, adições de recursos importantes ou novas versões do seu software lançado. Em uma pull request, 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 individuais de código, bem como comentários sobre a pull request em geral.

dica

Enquanto você cria uma pull request, 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 pull request for criada, a diferença exibida será entre a revisão da pull request escolhida e o commit que foi a ponta da ramificação de destino quando você criou a pull request. Para obter mais informações sobre diferenças e bases de mesclagem no Git, git-merge-baseconsulte a documentação do Git.

Revisões

Uma revisão é uma versão atualizada de uma pull request. Cada push para a ramificação de origem de uma pull request cria uma revisão que contém as alterações feitas nos commits incluídos nesse push. Você pode ver as diferenças entre as revisões de um pull request, além das diferenças entre as ramificações de origem e de destino. Para obter mais informações, consulte Análise de código com pull requests na Amazon CodeCatalyst.

Fluxos de trabalho

Um fluxo de trabalho é um procedimento automatizado que descreve como criar, testar e implantar seu 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 executadas 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 visual ou o YAML editor do CodeCatalyst console.

dica

Para ver rapidamente como você pode usar fluxos de trabalho em um projeto, crie um projeto com um blueprint. Cada blueprint 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 blueprint, você 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.