Vínculo de repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst - Amazon CodeCatalyst
Vínculo de recursos de provedores de terceiros conectadosVincular um repositório de terceiros durante a criação do projeto

O Amazon CodeCatalyst não está mais disponível para novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Como migrar do CodeCatalyst.

Vínculo de repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst

Antes de usar um repositório do GitHub, repositório Bitbucket ou repositório de projetos do GitLab, ou gerenciar um projeto do Jira, você deve conectar a origem de terceiros à qual o repositório ou projeto pertence ao espaço do CodeCatalyst. Para obter mais informações, consulte Conexão de contas do GitHub, espaços de trabalho do Bitbucket, usuários do GitLab e sites do Jira no CodeCatalyst.

Você pode usar repositórios do GitHub vinculados, repositórios do Bitbucket ou repositórios de projetos do GitLab em fluxos de trabalho, onde os eventos nos repositórios vinculados iniciam fluxos de trabalho que podem criar, testar ou implantar código, dependendo da configuração do fluxo de trabalho. Os arquivos de configuração de fluxos de trabalho que usam repositórios do GitHub ou do Bitbucket vinculados são armazenados nos repositórios vinculados. Os repositórios vinculados também podem ser usados com ambientes de desenvolvimento para criar, atualizar e excluir arquivos nos repositórios vinculados. Você pode vincular um repositório do GitHub, repositório do Bitbucket ou repositório de projetos do GitLab a um projeto do CodeCatalyst na página de detalhes dos repositórios do GitHub, dos repositórios do Bitbucket ou da extensão dos repositórios do GitLab ou na visualização Repositórios de origem em Código no próprio projeto.

Importante

Embora você possa vincular um repositório do GitHub ou do Bitbucket como Colaborador, você só pode desvincular um repositório de terceiros como Administrador do espaço ou Administrador do projeto. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

Importante

Depois de instalar uma extensão de repositório, todos os repositórios vinculados ao CodeCatalyst terão seu código indexado e armazenado no CodeCatalyst. Isso tornará o código pesquisável no CodeCatalyst. Para entender melhor a proteção de dados do seu código ao usar repositórios vinculados no CodeCatalyst, consulte Proteção de dados no Guia do usuário do Amazon CodeCatalyst.

Importante

O CodeCatalyst não comporta a detecção de alterações na ramificação padrão para repositórios vinculados. Para alterar a ramificação padrão de um repositório vinculado, primeiro você deve desvinculá-la do CodeCatalyst, alterar a ramificação padrão e vinculá-la novamente.

Como prática recomendada, sempre verifique se você tem a versão mais recente da extensão antes de vincular um repositório.

Você pode usar projetos do Jira vinculados para gerenciar problemas e vincular solicitações pull do CodeCatalyst a um problema do Jira. O status resumido de uma solicitação pull e o status dos eventos de fluxo de trabalho associados do CodeCatalyst são refletidos no problema do Jira.

Importante

Para vincular o projeto do Jira ao projeto do CodeCatalyst, você deve ser Administrador do espaço ou Administrador do projeto do CodeCatalyst.

nota

  • Um repositório do GitHub, do Bitbucket ou do projeto do GitLab só pode ser vinculado a um projeto do CodeCatalyst em um espaço.

  • Você não pode usar repositórios vazios ou arquivados do GitHub, repositórios do Bitbucket ou repositórios de projetos do GitLab com projetos do CodeCatalyst.

  • Você não pode vincular um repositório do GitHub, do Bitbucket ou do GitLab que tenha o mesmo nome de um repositório em um projeto do CodeCatalyst.

  • A extensão de Repositórios do GitHub não é compatível com os repositórios do GitHub Enterprise Server.

  • A extensão de Repositórios do Bitbucket não é compatível com os repositórios do Bitbucket Data Center.

  • A extensão de Repositórios do GitLab não é compatível com os repositórios de projetos autogerenciados do GitLab.

  • Não é possível usar os recursos Escrever descrição para mim ou Resumir comentários com repositórios vinculados. Esses recursos só estão disponíveis em solicitações pull no CodeCatalyst.

  • Um projeto do CodeCatalyst só pode ser vinculado a um projeto do Jira. Um projeto do Jira pode ser vinculado a vários projetos do CodeCatalyst.

Para vincular um repositório do GitHub, repositório do Bitbucket, repositório de projetos do GitLab ou projeto do Jira a um projeto do CodeCatalyst na página de detalhes da extensão

  1. Abra o console do CodeCatalyst em https://codecatalyst.aws/.

  2. Acesse o espaço no CodeCatalyst.

  3. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:

    1. Escolha Configurações e Extensões instaladas.

    2. Escolha o ícone Catálogo The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. no menu superior.

  4. Selecione Configurar para uma das seguintes extensões: repositórios do GitHub, repositórios do Bitbucket, repositórios do GitLab ou software Jira.

  5. Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:

    • Repositórios do GitHub: vincule um repositório do GitHub.

      1. Na guia Repositórios do GitHub vinculados, selecione Vincular repositório do GitHub.

      2. No menu suspenso Conta do GitHub, selecione a conta do GitHub que contém o repositório que você deseja vincular.

      3. No menu suspenso Repositório do GitHub, selecione o repositório que você deseja vincular a um projeto do CodeCatalyst.

        dica

        Se o nome do repositório estiver desativado, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no espaço.

      4. (Opcional) Se não for exibido um repositório do GitHub na lista de repositórios, ele pode não ter sido configurado para acesso ao repositório na aplicação Amazon CodeCatalyst no GitHub. Você pode configurar quais repositórios do GitHub podem ser usados no CodeCatalyst na conta conectada.

        1. Navegue até a conta do GitHub, selecione Configurações e escolha Aplicações.

        2. Na guia Aplicações GitHub instaladas, selecione Configurar para a aplicação Amazon CodeCatalyst.

        3. Faça o seguinte para configurar o acesso aos repositórios do GitHub que você deseja vincular no CodeCatalyst:

          • Para fornecer acesso a todos os repositórios atuais e futuros, selecione Todos os repositórios.

          • Para fornecer acesso a repositórios específicos, selecione Somente selecionar repositórios, escolha a lista suspensa Selecionar repositórios e, depois, selecione um repositório que você deseja permitir vincular no CodeCatalyst.

      5. No menu suspenso Projeto do CodeCatalyst, selecione o projeto do CodeCatalyst que você deseja vincular ao repositório do GitHub.

      6. Escolha Vincular.

      Se você não quiser mais usar um repositório do GitHub no CodeCatalyst, pode desvinculá-lo de um projeto do CodeCatalyst. Quando um repositório é desvinculado, os eventos desse repositório não iniciarão a execução do fluxo de trabalho, e você não poderá usar esse repositório com os Ambientes de Desenvolvimento do CodeCatalyst. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

    • Repositórios do Bitbucket: vincule um repositório do Bitbucket.

      1. Na guia Repositórios do Bitbucket vinculados, selecione Vincular repositório do Bitbucket.

      2. No menu suspenso Espaço de trabalho do Bitbucket, selecione o espaço de trabalho do Bitbucket que contém o repositório que você deseja vincular.

      3. No menu suspenso Repositório do Bitbucket, selecione o repositório que você deseja vincular a um projeto do CodeCatalyst.

        dica

        Se o nome do repositório estiver desativado, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no espaço.

      4. No menu suspenso Projeto do CodeCatalyst, selecione o projeto do CodeCatalyst que você deseja vincular ao repositório do Bitbucket.

      5. Escolha Vincular.

      Se você não quiser mais usar um repositório do Bitbucket no CodeCatalyst, pode desvinculá-lo de um projeto do CodeCatalyst. Quando um repositório é desvinculado, os eventos desse repositório não iniciarão a execução do fluxo de trabalho, e você não poderá usar esse repositório com os Ambientes de Desenvolvimento do CodeCatalyst. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

    • Repositórios do GitLab: vincule um repositório de projetos do GitLab.

      1. Na guia Repositórios de projetos do GitLab vinculados, selecione Vincular repositório de projetos do GitLab.

      2. No menu suspenso Usuário do GitLab, escolha o usuário do GitLab que contém o repositório do projeto que você deseja vincular.

      3. No menu suspenso do Repositório de projetos do GitLab, selecione o repositório que você deseja vincular a um projeto do CodeCatalyst.

        dica

        Se o nome do repositório estiver desativado, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no espaço.

      4. No menu suspenso Projeto do CodeCatalyst, selecione o projeto do CodeCatalyst que você deseja vincular ao repositório de projetos do GitLab.

      5. Escolha Vincular.

      Se você não quiser mais usar um repositório de projetos do GitLab no CodeCatalyst, pode desvinculá-lo de um projeto do CodeCatalyst. Quando um repositório de projetos é desvinculado, os eventos desse repositório não iniciam a execução do fluxo de trabalho e você não pode usar esse repositório com os Ambientes de Desenvolvimento do CodeCatalyst. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

    • Software Jira: vincule um projeto do Jira.

      1. Na guia Projetos do Jira vinculados, selecione Vincular projeto do Jira.

      2. No menu suspenso Site do Jira, escolha o site do Jira que contém o projeto que você deseja vincular.

      3. No menu suspenso Projeto do Jira, selecione o projeto que você deseja vincular a um projeto do CodeCatalyst.

      4. No menu suspenso Projeto do CodeCatalyst, selecione o projeto do CodeCatalyst que você deseja vincular a um projeto do Jira.

      5. Escolha Vincular.

      Depois que um projeto do Jira é vinculado a um projeto do CodeCatalyst, o acesso aos problemas do CodeCatalyst é totalmente desativado, e os Problemas no painel de navegação do CodeCatalyst são substituídos por um item de Problemas do Jira vinculado ao projeto do Jira.

      Problemas do CodeCatalyst substituídos por problemas vinculados do Jira no painel de navegação.

      Se você não quiser mais usar um projeto do Jira no CodeCatalyst, pode desvinculá-lo do projeto do CodeCatalyst. Quando um projeto do Jira é desvinculado, os problemas do Jira não ficam disponíveis no projeto do CodeCatalyst, e os Problemas do CodeCatalyst voltam a ser o provedor do problema. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

Para vincular um repositório do GitHub, repositório do Bitbucket ou repositório de projetos do GitLab a um projeto do CodeCatalyst na página de repositórios de origem em um projeto

  1. Abra o console do CodeCatalyst em https://codecatalyst.aws/.

  2. Navegue até o seu projeto no CodeCatalyst.

  3. No painel de navegação, selecione Código e, depois, selecione Repositórios de origem.

  4. Selecione Adicionar repositório e Vincular repositório.

  5. No menu suspenso Provedor do repositório, selecione um dos seguintes provedores de repositório de terceiros: GitHub, Bitbucket, GitLab.

  6. Realize um destes procedimentos, dependendo do provedor de repositório de terceiros que você selecionar para vincular:

    • Repositórios do GitHub: vincule um repositório do GitHub.

      1. No menu suspenso Conta do GitHub, selecione a conta do GitHub que contém o repositório que você deseja vincular.

      2. No menu suspenso do Repositório do GitHub, selecione o repositório do GitHub que você deseja vincular seu projeto do CodeCatalyst.

        dica

        Se o nome do repositório estiver em cinza, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no Amazon CodeCatalyst.

      3. (Opcional) Se não for exibido um repositório do GitHub na lista de repositórios, ele pode não ter sido configurado para acesso ao repositório na aplicação Amazon CodeCatalyst no GitHub. Você pode configurar quais repositórios do GitHub podem ser usados no CodeCatalyst na conta conectada.

        1. Navegue até a conta do GitHub, selecione Configurações e escolha Aplicações.

        2. Na guia Aplicações GitHub instaladas, selecione Configurar para a aplicação Amazon CodeCatalyst.

        3. Faça o seguinte para configurar o acesso aos repositórios do GitHub que você deseja vincular no CodeCatalyst:

          • Para fornecer acesso a todos os repositórios atuais e futuros, selecione Todos os repositórios.

          • Para fornecer acesso a repositórios específicos, selecione Somente selecionar repositórios, escolha a lista suspensa Selecionar repositórios e, depois, selecione um repositório que você deseja permitir vincular no CodeCatalyst.

    • Repositórios do Bitbucket: vincule um repositório do Bitbucket.

      1. No menu suspenso Espaço de trabalho do Bitbucket, selecione o espaço de trabalho do Bitbucket que contém o repositório que você deseja vincular.

      2. No menu suspenso Repositório do Bitbucket, selecione o repositório do Bitbucket que você deseja vincular seu projeto do CodeCatalyst.

        dica

        Se o nome do repositório estiver em cinza, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no Amazon CodeCatalyst.

    • Repositórios do GitLab: vincule um repositório de projetos do GitLab.

      1. No menu suspenso Usuário do GitLab, escolha o usuário do GitLab que contém o repositório do projeto que você deseja vincular.

      2. No menu suspenso Repositório de projetos do GitLab, selecione o repositório de projetos do GitLab ao qual você deseja vincular seu projeto do CodeCatalyst.

        dica

        Se o nome do repositório de projetos estiver em cinza, você não poderá vincular esse repositório porque ele já foi vinculado a outro projeto no Amazon CodeCatalyst.

  7. Escolha Vincular.

Se você não quiser mais usar um repositório do GitHub, do Bitbucket ou de projetos do GitLab no CodeCatalyst, pode desvinculá-lo de um projeto do CodeCatalyst. Quando um repositório é desvinculado, os eventos desse repositório não iniciarão a execução do fluxo de trabalho, e você não poderá usar esse repositório com os Ambientes de Desenvolvimento do CodeCatalyst. Para obter mais informações, consulte Desvincular repositórios do GitHub, repositórios do Bitbucket, repositórios de projetos do GitLab e projetos do Jira no CodeCatalyst.

Depois de vincular o repositório do GitHub, do Bitbucket ou de projetos do GitLab ao projeto do CodeCatalyst, você pode usá-lo nos fluxos de trabalho e nos ambientes de desenvolvimento do CodeCatalyst. Você também pode usar os repositórios vinculados com o Amazon Q Developer, esquemas e muito mais. Para obter mais informações, consulte Início automático da execução de um fluxo de trabalho após eventos de repositórios de terceiros e Criar um Ambiente de Desenvolvimento.

Depois de vincular o projeto do Jira ao projeto do CodeCatalyst e vincular uma solicitação pull, as atualizações do CodeCatalyst são refletidas no projeto do Jira. Para ter mais informações sobre como vincular solicitações pull a problemas do Jira, consulte Vincular problemas do Jira com solicitações pull do CodeCatalyst. Para ter mais informações sobre a visualização de eventos do CodeCatalyst no Jira, consulte Visualização de eventos do CodeCatalyst em problemas do Jira.

Você pode vincular um repositório do GitHub, do Bitbucket ou de projetos do GitLab a um novo projeto do CodeCatalyst ao criar o novo projeto do CodeCatalyst. Para obter mais informações, consulte Criar um projeto com um repositório de terceiros vinculado.