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á.
# Adicione funcionalidade a projetos com extensões no CodeCatalyst
A Amazon CodeCatalyst inclui extensões que ajudam você a adicionar funcionalidades e integrar-se com produtos externos CodeCatalyst. Com extensões do CodeCatalyst catálogo, as equipes podem personalizar suas experiências no CodeCatalyst.
**Topics**
+ [Extensões de terceiros disponíveis](#extensions-types)
+ [Conceitos de extensões](extensions-concepts.md)
+ [Início rápido: instalação de extensões, conexão de provedores e vinculação de recursos no CodeCatalyst](extensions-quickstart.md)
+ [Instalação de uma extensão em um espaço](install-extension.md)
+ [Desinstalação de uma extensão em um espaço](uninstall-extension.md)
+ [Conectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst](extensions-connect.md)
+ [Desconectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst](extensions-disconnect.md)
+ [Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst](extensions-link.md)
+ [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md)
+ [Visualizando repositórios de terceiros e pesquisando problemas do Jira no CodeCatalyst](extensions-view-search.md)
+ [Início automático da execução de um fluxo de trabalho após eventos de repositórios de terceiros](extensions-workflow-repositories.md)
+ [Restrição do acesso ao IP com provedores de repositório de terceiros](extensions-restrict-ip-access.md)
+ [Bloqueio de mesclagens de terceiros quando os fluxos de trabalho falham](extensions-block-merges.md)
+ [Vinculando problemas do Jira a CodeCatalyst pull requests](link-jira-issues-pull-requests.md)
+ [Visualizando CodeCatalyst eventos em edições do Jira](view-codecatalyst-events-jira.md)
## Extensões de terceiros disponíveis
Você pode adicionar uma funcionalidade específica ao seu CodeCatalyst projeto, dependendo da extensão com a qual escolher integrar os recursos.
### Integrando GitHub repositórios em CodeCatalyst
GitHub é um serviço baseado em nuvem que ajuda os desenvolvedores a armazenar e gerenciar seus códigos. A extensão **GitHub repositories** permite que você use GitHub repositórios vinculados em projetos da Amazon CodeCatalyst . Você também pode vincular GitHub repositórios ao criar um novo CodeCatalyst projeto. Para obter mais informações, consulte [Criar um projeto com um repositório de terceiros vinculado](projects-create.md#projects-create-3p-repo).
**nota**
Você não pode usar GitHub repositórios vazios ou arquivados com CodeCatalyst projetos.
A extensão **GitHub repositories** não é compatível com os repositórios do GitHub Enterprise Server.
Depois de instalar e configurar a extensão **GitHub dos repositórios**, você poderá:
+ Visualize seus GitHub repositórios na lista de repositórios de origem em CodeCatalyst
+ Armazene e gerencie arquivos de definição de fluxo de trabalho em seus GitHub repositórios
+ Crie, leia, atualize e exclua arquivos armazenados em GitHub repositórios vinculados a partir de ambientes de CodeCatalyst desenvolvimento
+ Armazene e indexe arquivos dos GitHub repositórios vinculados no CodeCatalyst
+ Crie CodeCatalyst projetos com repositórios existentes de contas conectadas GitHub
+ Crie um GitHub repositório com código gerado por um blueprint ao criar um projeto com um blueprint ou adicionar um blueprint
+ O CodeCatalyst fluxo de trabalho Start é executado automaticamente quando o código é enviado para GitHub repositórios vinculados ou quando as pull requests são criadas, modificadas ou fechadas em repositórios vinculados GitHub
+ Use arquivos de origem GitHub do repositório vinculado em CodeCatalyst fluxos de trabalho
+ Leia e execute GitHub ações em CodeCatalyst fluxos de trabalho
+ Envie os status CodeCatalyst de execução do fluxo de trabalho para GitHub repositórios vinculados e bloqueie as mesclagens de GitHub pull request com base nos status de confirmação
### Integrando repositórios do Bitbucket em CodeCatalyst
O Bitbucket é um serviço baseado em nuvem que ajuda os desenvolvedores a armazenar e gerenciar o código. A extensão **de repositórios do Bitbucket** permite que você use repositórios vinculados do Bitbucket em projetos da Amazon. CodeCatalyst Você também pode vincular repositórios do Bitbucket ao criar um novo CodeCatalyst projeto. Para obter mais informações, consulte [Criar um projeto com um repositório de terceiros vinculado](projects-create.md#projects-create-3p-repo).
**nota**
Você não pode usar repositórios do Bitbucket vazios ou arquivados com projetos. CodeCatalyst
A extensão de **Repositórios do Bitbucket** não é compatível com os repositórios do Bitbucket Data Center.
Depois de instalar e configurar a extensão de **Repositórios do Bitbucket**, você poderá:
+ Visualize seus repositórios do Bitbucket na lista de repositórios de origem em CodeCatalyst
+ Armazenar e gerenciar arquivos de definição de fluxo de trabalho nos repositórios do Bitbucket.
+ Crie, leia, atualize e exclua arquivos armazenados em repositórios vinculados do Bitbucket a partir CodeCatalyst de ambientes de desenvolvimento
+ Crie CodeCatalyst projetos com repositórios existentes de contas Bitbucket conectadas
+ Armazene e indexe arquivos dos repositórios vinculados do Bitbucket no CodeCatalyst
+ Criar um repositório do Bitbucket com código gerado por um esquema ao criar um projeto com um esquema ou adicionar um esquema
+ O CodeCatalyst fluxo de trabalho Start é executado automaticamente quando o código é enviado para repositórios vinculados do Bitbucket ou quando as pull requests são criadas, modificadas ou fechadas em repositórios vinculados do Bitbucket
+ Use seus arquivos de origem do repositório Bitbucket vinculado em fluxos de trabalho CodeCatalyst
+ Envie os status CodeCatalyst de execução do fluxo de trabalho para repositórios vinculados do Bitbucket e bloqueie as mesclagens de pull request do Bitbucket com base nos status de confirmação
### Integrando GitLab repositórios em CodeCatalyst
GitLab é um serviço baseado em nuvem que ajuda os desenvolvedores a armazenar e gerenciar seus códigos. A extensão **GitLab repositories** permite que você use repositórios de GitLab projetos vinculados em projetos da Amazon CodeCatalyst . Você também pode vincular repositórios de GitLab projetos ao criar um novo CodeCatalyst projeto. Para obter mais informações, consulte [Criar um projeto com um repositório de terceiros vinculado](projects-create.md#projects-create-3p-repo).
**nota**
Você não pode usar repositórios de projetos vazios ou arquivados com GitLab CodeCatalyst projetos.
A extensão de **GitLab repositórios** não é compatível com repositórios GitLab autogerenciados.
Depois de instalar e configurar a extensão **GitLab dos repositórios**, você poderá:
+ Visualize os repositórios GitLab do seu projeto na lista de repositórios de origem em CodeCatalyst
+ Armazene e gerencie arquivos de definição de fluxo de trabalho nos repositórios GitLab do seu projeto.
+ Crie, leia, atualize e exclua arquivos armazenados em repositórios de GitLab projetos vinculados a partir de ambientes de CodeCatalyst desenvolvimento
+ Crie CodeCatalyst projetos com repositórios existentes de usuários conectados GitLab
+ Armazene e indexe arquivos dos repositórios de GitLab projetos vinculados no CodeCatalyst
+ Crie um repositório de GitLab projetos com código gerado por um blueprint ao criar um projeto com um blueprint ou adicionar um blueprint
+ O CodeCatalyst fluxo de trabalho Start é executado automaticamente quando o código é enviado para repositórios de GitLab projetos vinculados ou quando as pull requests são criadas, modificadas ou fechadas em repositórios de GitLab projetos vinculados
+ Use os arquivos de origem GitLab do repositório de projetos vinculado em CodeCatalyst fluxos de trabalho
+ Envie status CodeCatalyst de execução do fluxo de trabalho para repositórios de GitLab projetos vinculados e bloqueie solicitações de GitLab mesclagem com base nos status de confirmação
### Integrando problemas do Jira no CodeCatalyst
O Jira é uma aplicação de software que ajuda as equipes de desenvolvimento Agile a planejar, atribuir, rastrear, gerar relatórios e gerenciar o trabalho. A extensão do **Jira Software** permite que você use projetos do Jira em projetos da Amazon CodeCatalyst .
**nota**
CodeCatalyst só é compatível com o **Jira Software Cloud**.
Depois de instalar e configurar a extensão do **Jira Software** para um CodeCatalyst projeto da Amazon, você poderá:
+ Acesse projetos do Jira CodeCatalyst vinculando-os a projetos CodeCatalyst
+ Atualize os problemas do Jira com CodeCatalyst pull requests
+ Visualize o status e as execuções do fluxo de trabalho de CodeCatalyst pull requests vinculados em problemas do Jira
# Conceitos de extensões
Aqui estão alguns conceitos e termos que você deve conhecer ao trabalhar com extensões no CodeCatalyst.
## Extensões
Uma *extensão* é um complemento que você pode instalar em seu CodeCatalyst espaço para adicionar novas funcionalidades aos seus projetos e integrá-lo a serviços externos. CodeCatalyst As extensões podem ser pesquisadas e instaladas a partir do CodeCatalyst catálogo.
## CodeCatalyst catálogo
O CodeCatalyst catálogo é uma lista centralizada de todas as extensões disponíveis em CodeCatalyst. Você pode navegar no CodeCatalyst catálogo para encontrar extensões que podem melhorar as experiências da sua equipe em áreas CodeCatalyst como fonte, fluxos de trabalho e muito mais.
## Conexão e vínculo
Dependendo dos recursos de terceiros que você deseja usar ou gerenciar, você precisa conectar sua GitHub conta, o espaço de trabalho do Bitbucket ou o projeto do Jira. Em seguida, você precisa vincular seu GitHub repositório, repositório Bitbucket ou projeto Jira ao seu projeto. CodeCatalyst
+ **GitHub repositórios**: Conecte a GitHub conta e, em seguida, vincule os GitHub repositórios.
+ **Repositórios do Bitbucket**: conecte o espaço de trabalho do Bitbucket e, depois, vincule os repositórios do Bitbucket.
+ **GitLab repositórios**: Conecte o GitLab usuário e, em seguida, vincule os repositórios GitLab do projeto.
+ **Software Jira**: conecte o site do Jira e, depois, vincule os projetos do Jira.
# Início rápido: instalação de extensões, conexão de provedores e vinculação de recursos no CodeCatalyst
Este tutorial apresenta um passo a passo das três tarefas abaixo:
1. **Instale os **GitHub repositórios**, repositórios do **Bitbucket, **GitLab repositórios**** ou a extensão do Jira Software.** Você é solicitado em um site externo a se conectar e CodeCatalyst fornecer acesso aos seus recursos de terceiros, o que é feito como parte da próxima etapa.
**Importante**
Para instalar os **GitHub repositórios, os repositórios** do **Bitbucket, os GitLab ** **repositórios** ou a extensão do **Jira Software** no seu CodeCatalyst espaço, você deve estar conectado com uma conta que tenha a função de **administrador do espaço no espaço**.
1. Conecte sua GitHub conta, espaço de trabalho do Bitbucket, GitLab usuário ou site do Jira a. CodeCatalyst
**Importante**
**Para conectar sua GitHub conta, espaço de trabalho do Bitbucket, GitLab usuário ou site do Jira ao seu CodeCatalyst espaço, você deve ser o administrador da fonte terceirizada e o administrador do Space. CodeCatalyst **
**Importante**
Depois de instalar uma extensão de repositório, todos os repositórios aos quais você vincular CodeCatalyst terão seu código indexado e armazenado. CodeCatalyst Isso tornará o código pesquisável em CodeCatalyst. Para entender melhor a proteção de dados do seu código ao usar repositórios vinculados CodeCatalyst, consulte [Proteção de dados](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html) no *Guia do CodeCatalyst usuário da Amazon*.
**nota**
Se você estiver usando uma conexão com uma GitHub conta, deverá criar uma conexão pessoal para estabelecer um mapeamento de identidade entre sua CodeCatalyst identidade e sua GitHub identidade. Para obter mais informações, consulte [Conexões pessoais](concepts.md#personal-connection-concept) e [Acessando GitHub recursos com conexões pessoais](ipa-settings-connections.md).
1. Vincule seu GitHub repositório, repositório Bitbucket, repositório de projetos ou GitLab projeto Jira ao seu projeto. CodeCatalyst
**Importante**
****Embora você possa vincular um GitHub repositório, um repositório do Bitbucket ou um repositório GitLab do projeto como **colaborador, você só pode desvincular um repositório de terceiros como administrador do Space ou** administrador do projeto.**** Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
Para vincular seu projeto do Jira ao seu CodeCatalyst projeto, você deve ser administrador do CodeCatalyst **Space ou administrador CodeCatalyst ** **do projeto**.
**Importante**
CodeCatalyst não suporta 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, você deve primeiro desvinculá-la CodeCatalyst, alterar a ramificação padrão e depois vinculá-la novamente. Para obter mais informações, consulte [Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst](extensions-link.md).
Como prática recomendada, sempre verifique se você tem a versão mais recente da extensão antes de vincular um repositório.
**nota**
Um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto só pode ser vinculado a um CodeCatalyst projeto em um espaço.
Você não pode usar repositórios vazios ou arquivados, GitHub repositórios Bitbucket ou repositórios de projetos com GitLab projetos. CodeCatalyst
Você não pode vincular um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto que tenha o mesmo nome de um repositório em um projeto. CodeCatalyst
A extensão de **GitHub repositórios** 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 **GitLab repositories** não é compatível com repositórios de projetos GitLab autogerenciados.
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 pull requests em CodeCatalyst.
Um CodeCatalyst projeto só pode ser vinculado a um projeto do Jira. Um projeto do Jira pode ser vinculado a vários CodeCatalyst projetos.
Você também pode instalar os **GitHub repositórios, repositórios** do **Bitbucket, extensão de **GitLab repositórios****, conectar-se à sua GitHub conta, espaço de trabalho do Bitbucket ou GitLab usuário e vincular repositórios de terceiros ao criar um novo projeto. CodeCatalyst Para obter mais informações, consulte [Criar um projeto com um repositório de terceiros vinculado](projects-create.md#projects-create-3p-repo).
**Topics**
+ [Etapa 1: instalar uma extensão de terceiros do CodeCatalyst catálogo](#extensions-quickstart-install)
+ [Etapa 2: Conecte seu provedor terceirizado ao seu CodeCatalyst espaço](#extensions-github-extension-get-started-connect)
+ [Etapa 3: vincular seus recursos de terceiros ao seu CodeCatalyst projeto](#extensions-quickstart-link)
+ [Próximas etapas](#extensions-quickstart-next-steps)
## Etapa 1: instalar uma extensão de terceiros do CodeCatalyst catálogo
A primeira etapa para usar recursos de terceiros CodeCatalyst é instalar a extensão de **GitHub repositórios** do catálogo. CodeCatalyst Para instalar a extensão, execute as etapas a seguir, escolhendo a extensão para os recursos de terceiros que você deseja usar. **GitHub repositórios**, repositórios do **Bitbucket e repositórios** permitem que você use **GitLab repositórios**, repositórios do Bitbucket ou GitHub repositórios de projetos em. GitLab CodeCatalyst **O Jira Software** permite que você gerencie problemas do Jira no. CodeCatalyst
**Para instalar uma extensão do CodeCatalyst catálogo**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Navegue até o CodeCatalyst CodeCatalyst catálogo escolhendo o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior. **Você pode pesquisar **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou o **GitLab Jira Software**.** Também é possível filtrar extensões com base em categorias.
1. (Opcional) Para ver mais detalhes sobre a extensão, como as permissões que ela terá, escolha o nome da extensão.
1. Escolha **Instalar**. Revise as permissões exigidas pela extensão e, se quiser continuar, escolha **Instalar** novamente.
Depois de instalar a extensão, você será direcionado para a página de detalhes da extensão. Dependendo da extensão instalada, você pode visualizar e gerenciar provedores conectados e recursos vinculados.
## Etapa 2: Conecte seu provedor terceirizado ao seu CodeCatalyst espaço
**Depois de instalar os **GitHub repositórios, os repositórios** do **Bitbucket, GitLab os repositórios** ou a extensão do **Jira Software**, a próxima etapa é conectar sua GitHub conta, espaço de trabalho do Bitbucket, repositório do GitLab projeto ou site do Jira ao seu espaço.** CodeCatalyst
**Para conectar sua GitHub conta, espaço de trabalho do Bitbucket ou site do Jira ao CodeCatalyst**
+ Faça o seguinte, dependendo da extensão de terceiros que você instalou:
+ **GitHub repositórios**: conecte-se a uma GitHub conta.
1. Na guia ** GitHub Contas conectadas**, escolha **Conectar GitHub conta** para acessar o site externo GitHub.
1. Faça login na sua GitHub conta usando suas GitHub credenciais e, em seguida, escolha a conta na qual você deseja instalar a Amazon CodeCatalyst.
**dica**
Se você já conectou uma GitHub conta ao espaço, não será solicitado que você reautorize. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de uma GitHub organização, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas uma GitHub organização. Configure a aplicação para o acesso ao repositório que você deseja permitir e selecione **Salvar**. Se o botão **Salvar** não estiver ativo, faça uma alteração na configuração e tente novamente.
1. Escolha se você deseja permitir o acesso CodeCatalyst a todos os repositórios atuais e futuros ou escolha os GitHub repositórios específicos nos quais deseja usar. CodeCatalyst A opção padrão é incluir todos os GitHub repositórios na GitHub conta, incluindo repositórios futuros que serão acessados pelo. CodeCatalyst
1. Revise as permissões concedidas e CodeCatalyst, em seguida, escolha **Instalar**.
Depois de conectar sua GitHub conta CodeCatalyst, você será direcionado para a página de detalhes da extensão de **GitHub repositórios**, onde poderá visualizar e gerenciar GitHub contas conectadas e GitHub repositórios vinculados.
+ **Repositórios do Bitbucket**: conecte a um espaço de trabalho do Bitbucket.
1. Na guia **Espaços de trabalho do Bitbucket conectados**, selecione **Conectar espaço de trabalho do Bitbucket** para acessar o site externo do Bitbucket.
1. Faça login no seu espaço de trabalho do Bitbucket usando suas credenciais do Bitbucket e revise as permissões concedidas a. CodeCatalyst
1. **No menu suspenso **Autorizar para espaço de trabalho**, escolha o espaço de trabalho do Bitbucket ao qual você deseja fornecer CodeCatalyst acesso e, em seguida, escolha Conceder acesso.**
**dica**
Se você já conectou um espaço de trabalho do Bitbucket ao espaço, não poderá dar uma nova autorização. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de um espaço de trabalho do Bitbucket, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas um espaço de trabalho do Bitbucket. Configure a aplicação para a qual você deseja permitir o acesso ao espaço de trabalho e selecione **Conceder acesso**. Se o botão **Conceder acesso** não estiver ativo, faça uma alteração na configuração e tente novamente.
Depois de conectar seu espaço de trabalho do Bitbucket ao CodeCatalyst, você será direcionado para a página de detalhes da extensão **de repositórios do Bitbucket**, onde poderá visualizar e gerenciar espaços de trabalho do Bitbucket conectados e repositórios vinculados do Bitbucket.
+ **GitLab repositórios**: conecte-se a um GitLab usuário.
1. Escolha **Connect GitLab user** para acessar o site externo GitLab.
1. Faça login com seu GitLab usuário usando suas GitLab credenciais e revise as permissões concedidas a. CodeCatalyst
**dica**
Se você já conectou um GitLab usuário ao espaço, não será solicitado que você reautorize. Em vez disso, você será direcionado de volta ao CodeCatalyst console.
1. Escolha **Autorizar AWS conector para GitLab**.
Depois de conectar seu GitLab usuário ao CodeCatalyst, você será direcionado para a página de detalhes da extensão de **GitLab repositórios**, onde poderá visualizar e gerenciar repositórios de GitLab usuários e GitLab projetos vinculados.
+ **Software Jira**: conecte um site do Jira.
1. Na guia **Sites do Jira conectados**, selecione **Conectar site do Jira** para acessar o site externo do Atlassian Marketplace.
1. Escolha **Adquira agora** para começar a instalar CodeCatalyst no seu site do Jira.
**nota**
Se você instalou anteriormente CodeCatalyst em seu site do Jira, você será notificado. Selecione **Começar** para ir para a etapa final.
1. Dependendo do perfil, faça o seguinte:
1. **Se você for administrador do site do Jira, no menu suspenso do site, escolha o site do Jira para instalar o CodeCatalyst aplicativo e, em seguida, escolha Instalar aplicativo.**
**nota**
Se você tiver um site do Jira, essa etapa não aparecerá e você será automaticamente direcionado para a próxima etapa.
1.
1. **Se você não for administrador do Jira, no menu suspenso do site, escolha o site do Jira para instalar o CodeCatalyst aplicativo e, em seguida, escolha Solicitar aplicativo.** Para ter mais informações sobre como instalar aplicações do Jira, consulte [Quem pode instalar aplicações?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps).
1. Insira o motivo pelo qual você precisa instalar CodeCatalyst no campo de texto de entrada ou mantenha o texto padrão e escolha **Enviar solicitação**.
1. Revise as ações executadas CodeCatalyst quando o aplicativo é instalado e escolha **Obter agora**.
1. Depois que o aplicativo for instalado, escolha **Retornar CodeCatalyst para** para retornar CodeCatalyst a.
Depois de conectar seu site do Jira ao CodeCatalyst, você pode ver o site conectado na guia **Sites conectados do Jira** da página de detalhes da extensão do **Jira Software**.
## Etapa 3: vincular seus recursos de terceiros ao seu CodeCatalyst projeto
A terceira e última etapa para usar seus GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos ou gerenciar problemas do Jira CodeCatalyst é vinculá-los ao CodeCatalyst projeto no qual você deseja usá-los.
**Para vincular um GitHub repositório, repositório Bitbucket, repositório de projetos ou GitLab projeto do Jira a um CodeCatalyst projeto na página de detalhes da extensão**
+ Faça o seguinte, dependendo da extensão de terceiros que você instalou e do provedor conectado:
+ **GitHub repositórios**: vincule um GitHub repositório.
1. Na guia ** GitHub Repositórios vinculados**, escolha **Vincular GitHub repositório**.
1. No menu suspenso da **GitHub conta**, escolha a GitHub conta que contém o repositório que você deseja vincular.
1. Na lista suspensa do **GitHub repositório**, escolha o repositório que você deseja vincular a um projeto. 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.
1. (Opcional) Se você não vê um GitHub repositório na lista de repositórios, ele pode não ter sido configurado para acesso ao repositório no aplicativo da Amazon CodeCatalyst em. GitHub Você pode configurar quais GitHub repositórios podem ser usados CodeCatalyst na conta conectada.
1. Navegue até sua [GitHub](https://github.com/)conta, escolha **Configurações** e, em seguida, escolha **Aplicativos**.
1. Na guia ** GitHub Aplicativos instalados**, escolha **Configurar** para o CodeCatalyst aplicativo Amazon.
1. Siga um destes procedimentos para configurar o acesso aos GitHub repositórios aos quais você deseja vincular: 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, escolha **Somente selecionar repositórios**, escolha a lista suspensa **Selecionar repositórios** e, em seguida, escolha um repositório ao qual você deseja permitir a vinculação. CodeCatalyst
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o GitHub repositório.
1. Escolha **Vincular**.
Se você não quiser mais usar um GitHub repositório no CodeCatalyst, você pode desvinculá-lo de um CodeCatalyst projeto. 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 ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **Repositórios do Bitbucket**: vincule um repositório do Bitbucket.
1. Na guia **Repositórios do Bitbucket vinculados**, selecione **Vincular 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.
1. No menu suspenso do **repositório Bitbucket**, escolha o repositório que você deseja vincular a um projeto. 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.
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o repositório do Bitbucket.
1. Escolha **Vincular**.
Se você não quiser mais usar um repositório do Bitbucket no CodeCatalyst, você pode desvinculá-lo de um projeto. 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 ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **GitLab repositórios**: vincule um repositório GitLab do projeto.
1. Na guia **Repositórios de GitLab projetos vinculados**, escolha **Vincular repositório GitLab do projeto**.
1. No menu suspenso **GitLab do usuário**, escolha o GitLab usuário que contém o repositório que você deseja vincular.
1. Na lista suspensa do **repositório do GitLab projeto**, escolha o repositório que você deseja vincular a um projeto. 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.
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o repositório do GitLab projeto.
1. Escolha **Vincular**.
Se você não quiser mais usar um repositório de GitLab projetos no CodeCatalyst, você pode desvinculá-lo de um CodeCatalyst projeto. Quando um repositório do projeto é desvinculado, os eventos desse repositório do projeto não iniciarão as execuções do fluxo de trabalho e você não poderá usar esse repositório do projeto com ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **Software Jira**: vincule um projeto do Jira.
1. Na guia **Projetos do Jira vinculados**, selecione **Vincular projeto do Jira**.
1. No menu suspenso **Site do Jira**, escolha o site do Jira que contém o projeto que você deseja vincular.
1. No menu suspenso do **projeto do Jira**, escolha o projeto que você deseja vincular a um projeto. CodeCatalyst
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto que você deseja vincular a um projeto do Jira.
1. Escolha **Vincular**.
Depois que um projeto do Jira é vinculado a um CodeCatalyst projeto, o acesso aos CodeCatalyst problemas é totalmente desativado e os **problemas** no painel de CodeCatalyst navegação serão substituídos por um item de **problemas do Jira** vinculado ao projeto Jira.
![\[CodeCatalyst problemas substituídos por problemas vinculados do Jira no painel de navegação.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
Se você não quiser mais usar um projeto do Jira no CodeCatalyst, você pode desvinculá-lo do seu CodeCatalyst projeto. Quando um projeto do Jira é desvinculado, os problemas do Jira não estarão disponíveis no CodeCatalyst projeto e os CodeCatalyst **problemas** voltarão a ser o fornecedor do problema. Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
**Você também pode vincular seu GitHub repositório, repositório Bitbucket ou repositório de projetos a um GitLab projeto a partir dos repositórios **Source** no Code.** Para obter mais informações, consulte [Vínculo de recursos de provedores de terceiros conectados](extensions-link.md#extensions-link-resources).
## Próximas etapas
Depois de instalar os **GitHub repositórios, os** **repositórios do Bitbucket** ou a extensão de **GitLab repositórios**, conectar seu provedor de recursos e vincular seus repositórios de terceiros aos seus CodeCatalyst projetos, você pode usá-lo em fluxos de trabalho e ambientes de desenvolvimento. CodeCatalyst Você também pode criar repositórios de terceiros na GitHub conta conectada, no espaço de trabalho do Bitbucket ou no GitLab usuário com código gerado a partir de um blueprint. 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](extensions-workflow-repositories.md) e [Criar um Ambiente de Desenvolvimento](devenvironment-create.md).
Depois de instalar a extensão do **Jira Software**, conectar seu site do Jira, vincular seus projetos do Jira ao seu CodeCatalyst projeto e vincular uma pull request, as atualizações do Jira CodeCatalyst são refletidas no seu projeto do Jira. Para ter mais informações sobre como vincular solicitações pull a problemas do Jira, consulte [Vinculando problemas do Jira a CodeCatalyst pull requests](link-jira-issues-pull-requests.md). Para obter mais informações sobre a visualização de CodeCatalyst eventos no Jira, consulte[Visualizando CodeCatalyst eventos em edições do Jira](view-codecatalyst-events-jira.md).
# Instalação de uma extensão em um espaço
Você pode instalar extensões para o seu CodeCatalyst espaço que adicionam funcionalidade aos projetos nesse espaço. Você pode visualizar o CodeCatalyst catálogo escolhendo o ícone **Catálogo**![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png). Para saber mais sobre as extensões e suas funcionalidades, consulte [Extensões de terceiros disponíveis](extensions.md#extensions-types).
**Importante**
Para instalar uma extensão, você deve estar conectado com uma conta que tenha o perfil de **Administrador do espaço** no espaço.
**Importante**
Depois de instalar uma extensão de repositório, todos os repositórios vinculados CodeCatalyst terão seu código indexado e armazenado. CodeCatalyst Isso tornará o código pesquisável em CodeCatalyst. Para entender melhor a proteção de dados do seu código ao usar repositórios vinculados CodeCatalyst, consulte [Proteção de dados](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html) no *Guia do CodeCatalyst usuário da Amazon*.
**Para instalar uma extensão do CodeCatalyst catálogo**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Navegue até o CodeCatalyst catálogo escolhendo o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior. **Você pode pesquisar **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou o **GitLab Jira Software**.** Também é possível filtrar extensões com base em categorias.
1. (Opcional) Escolha o nome da extensão para ver mais detalhes sobre a extensão, como as permissões que ela terá.
1. Escolha **Instalar**. Revise as permissões exigidas pela extensão e, se quiser continuar, escolha **Instalar** novamente.
Depois de instalar uma extensão, você verá a página de detalhes da extensão instalada. Percorra as guias para ter mais informações sobre a extensão. Na página de detalhes, você também executará configurações adicionais da extensão, se necessário.
# Desinstalação de uma extensão em um espaço
Você pode desinstalar extensões que foram instaladas anteriormente em seu CodeCatalyst espaço. A desinstalação de uma extensão pode remover recursos relacionados a essa extensão do seu CodeCatalyst espaço ou projetos.
**Importante**
Para desinstalar uma extensão, você deve estar conectado com uma conta que tenha o perfil de **administrador do espaço** no espaço.
**Para desinstalar uma extensão do seu CodeCatalyst espaço**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:
1. Escolha **Configurações** e **Extensões instaladas**.
1. Escolha o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior.
1. Selecione **Configurar** na extensão que deseja desinstalar.
1. Selecione **Desinstalar** na página de detalhes da extensão.
1. Revise as informações na caixa de diálogo **Desinstalar extensão**. Siga as instruções e selecione **Desinstalar** para desinstalar a extensão.
# Conectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst
Para usar um GitHub repositório, repositório Bitbucket ou repositório de GitLab projetos ou gerenciar um projeto do Jira no CodeCatalyst, você deve primeiro conectar sua fonte terceirizada ao seu espaço. CodeCatalyst Para saber mais sobre as extensões e suas funcionalidades, consulte [Extensões de terceiros disponíveis](extensions.md#extensions-types).
**Importante**
**Para conectar sua GitHub conta, espaço de trabalho do Bitbucket, GitLab usuário ou site do Jira ao seu CodeCatalyst espaço, você deve ser o administrador da fonte terceirizada e o administrador do Space. CodeCatalyst **
**nota**
Se você estiver usando uma conexão com uma GitHub conta, deverá criar uma conexão pessoal para estabelecer o mapeamento de identidade entre sua CodeCatalyst identidade e sua GitHub identidade. Para obter mais informações, consulte [Conexões pessoais](concepts.md#personal-connection-concept) e [Acessando GitHub recursos com conexões pessoais](ipa-settings-connections.md).
**Para conectar sua GitHub conta, espaço de trabalho do Bitbucket, GitLab usuário ou site do Jira ao CodeCatalyst**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:
1. Escolha **Configurações** e **Extensões instaladas**.
1. Escolha o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior.
1. **Escolha **Configurar** para uma das seguintes extensões que você deseja configurar: **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou **GitLab Jira Software**.**
1. Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:
+ **GitHub repositórios**: conecte-se a uma GitHub conta.
1. Na guia ** GitHub Contas conectadas**, escolha **Conectar GitHub conta** para acessar o site externo GitHub.
1. Faça login na sua GitHub conta usando suas GitHub credenciais e, em seguida, escolha a conta na qual você deseja instalar a Amazon CodeCatalyst.
**dica**
Se você já conectou uma GitHub conta ao espaço, não será solicitado que você reautorize. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de um GitHub espaço, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas um GitHub espaço. Configure a aplicação para o acesso ao repositório que você deseja permitir e selecione **Salvar**. Se o botão **Salvar** não estiver ativo, faça uma alteração na configuração e tente novamente.
1. Escolha se você deseja permitir o acesso CodeCatalyst a todos os repositórios atuais e futuros ou escolha os GitHub repositórios específicos nos quais deseja usar. CodeCatalyst A opção padrão é incluir todos os GitHub repositórios na GitHub conta, incluindo repositórios futuros que serão acessados pelo. CodeCatalyst
1. Revise as permissões concedidas e CodeCatalyst, em seguida, escolha **Instalar**.
Depois de conectar sua GitHub conta CodeCatalyst, você será direcionado para a página de detalhes da extensão de **GitHub repositórios**, onde poderá visualizar e gerenciar GitHub contas conectadas e GitHub repositórios vinculados.
+ **Repositórios do Bitbucket**: conecte a um espaço de trabalho do Bitbucket.
1. Na guia **Espaços de trabalho do Bitbucket conectados**, selecione **Conectar espaço de trabalho do Bitbucket** para acessar o site externo do Bitbucket.
1. Faça login no seu espaço de trabalho do Bitbucket usando suas credenciais do Bitbucket e revise as permissões concedidas a. CodeCatalyst
1. **No menu suspenso **Autorizar para espaço de trabalho**, escolha o espaço de trabalho do Bitbucket ao qual você deseja fornecer CodeCatalyst acesso e, em seguida, escolha Conceder acesso.**
**dica**
Se você já conectou um espaço de trabalho do Bitbucket ao espaço, não poderá dar uma nova autorização. Em vez disso, você verá uma caixa de diálogo perguntando onde você gostaria de instalar a extensão se você for membro ou colaborador em mais de um espaço de trabalho do Bitbucket, ou a página de configuração do CodeCatalyst aplicativo Amazon se você pertencer a apenas um espaço de trabalho do Bitbucket. Configure a aplicação para a qual você deseja permitir o acesso ao espaço de trabalho e selecione **Conceder acesso**. Se o botão **Conceder acesso** não estiver ativo, faça uma alteração na configuração e tente novamente.
Depois de conectar seu espaço de trabalho do Bitbucket ao CodeCatalyst, você será direcionado para a página de detalhes da extensão **de repositórios do Bitbucket**, onde poderá visualizar e gerenciar espaços de trabalho do Bitbucket conectados e repositórios vinculados do Bitbucket.
+ **GitLab repositórios**: conecte-se a um GitLab usuário.
1. Escolha **Connect GitLab user** para acessar o site externo GitLab.
1. Faça login com seu GitLab usuário usando suas GitLab credenciais e revise as permissões concedidas a. CodeCatalyst
**dica**
Se você já conectou um GitLab usuário ao espaço, não será solicitado que você reautorize. Em vez disso, você será direcionado de volta ao CodeCatalyst console.
1. Escolha **Autorizar AWS conector para GitLab**.
Depois de conectar seu GitLab usuário ao CodeCatalyst, você será direcionado para a página de detalhes da extensão de **GitLab repositórios**, onde poderá visualizar e gerenciar repositórios de GitLab usuários e GitLab projetos vinculados.
+ **Software Jira**: conecte um site do Jira.
1. Na guia **Sites do Jira conectados**, selecione **Conectar site do Jira** para acessar o site externo do Atlassian Marketplace.
1. Escolha **Adquira agora** para começar a instalar CodeCatalyst no seu site do Jira.
**nota**
Se você instalou anteriormente CodeCatalyst em seu site do Jira, você será notificado. Selecione **Começar** para ir para a etapa final.
1. Dependendo do perfil, faça o seguinte:
1. **Se você for administrador do site do Jira, no menu suspenso do site, escolha o site do Jira para instalar o CodeCatalyst aplicativo e, em seguida, escolha Instalar aplicativo.**
**nota**
Se você tiver um site do Jira, essa etapa não aparecerá e você será automaticamente direcionado para a próxima etapa.
1.
1. **Se você não for administrador do Jira, no menu suspenso do site, escolha o site do Jira para instalar o CodeCatalyst aplicativo e, em seguida, escolha Solicitar aplicativo.** Para ter mais informações sobre como instalar aplicações do Jira, consulte [Quem pode instalar aplicações?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps).
1. Insira o motivo pelo qual você precisa instalar CodeCatalyst no campo de texto de entrada ou mantenha o texto padrão e escolha **Enviar solicitação**.
1. Revise as ações executadas CodeCatalyst quando o aplicativo é instalado e escolha **Obter agora**.
1. Depois que o aplicativo for instalado, escolha **Retornar CodeCatalyst para** para retornar CodeCatalyst a.
Depois de conectar seu site do Jira ao CodeCatalyst, você pode ver o site conectado na guia **Sites conectados do Jira** da página de detalhes da extensão do **Jira Software**.
Se você não quiser mais usar GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos, nem gerenciar problemas do Jira no CodeCatalyst, você pode desconectar sua fonte terceirizada. Quando uma GitHub conta, espaço de trabalho do Bitbucket ou GitLab usuário é desconectado, os eventos nos repositórios de terceiros não iniciarão a execução do fluxo de trabalho e você não poderá usar esses repositórios com ambientes de desenvolvimento. CodeCatalyst Quando um site do Jira é desconectado, os problemas do Jira dos projetos do site não estarão disponíveis nos CodeCatalyst projetos, e os CodeCatalyst **problemas** voltarão a ser o fornecedor do problema. Para obter mais informações, consulte [Desconectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst](extensions-disconnect.md).
# Desconectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst
Se você não quiser mais usar GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos, nem gerenciar problemas do Jira no CodeCatalyst, você pode desconectar sua fonte terceirizada. Depois que uma GitHub conta, espaço de trabalho do Bitbucket ou GitLab usuário for desconectado, os eventos nos repositórios não iniciarão a execução do fluxo de trabalho e você não poderá usar esses repositórios com ambientes de desenvolvimento. CodeCatalyst Quando um site do Jira é desconectado, os problemas do Jira dos projetos do site não estarão disponíveis nos CodeCatalyst projetos, e os CodeCatalyst **problemas** voltarão a ser o fornecedor do problema.
**nota**
Para desconectar uma GitHub conta, primeiro você deve desvincular todos os GitHub repositórios vinculados dessa conta.
Para desconectar um espaço de trabalho do Bitbucket, você deve primeiro desvincular todos os repositórios vinculados do Bitbucket desse espaço de trabalho.
Para desconectar um GitLab usuário, primeiro você deve desvincular todos os repositórios de GitLab projetos vinculados desse espaço de trabalho.
Para desconectar um site do Jira, você deve primeiro desvincular todos os projetos do Jira vinculados dessa conta.
Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
**Para desconectar um GitHub projeto, espaço de trabalho do Bitbucket, GitLab usuário ou site do Jira**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:
1. Escolha **Configurações** e **Extensões instaladas**.
1. Escolha o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior.
1. **Escolha **Configurar** para uma das seguintes extensões que você deseja configurar: **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou **GitLab Jira Software**.**
1. Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:
+ **GitHub repositórios**: desconecte-se de uma conta. GitHub
Na guia ** GitHub Contas conectadas**, escolha a GitHub conta que você deseja desconectar e, em seguida, escolha **Desconectar GitHub ** conta.
+ **Repositórios do Bitbucket**: desconecte de um espaço de trabalho do Bitbucket.
Na guia **Espaços de trabalho do Bitbucket conectados**, escolha o espaço de trabalho do Bitbucket que você deseja desconectar e, em seguida, selecione **Desconectar espaço de trabalho do Bitbucket**.
+ **GitLab repositórios**: desconecte-se de um usuário. GitLab
Na guia ** GitLab Usuários conectados**, escolha o GitLab usuário que você deseja desconectar e, em seguida, escolha **Desconectar GitLab ** usuário.
+ **Software Jira**: desconectar de um site do Jira.
Na guia **Sites do Jira conectados**, escolha o site do Jira que você deseja desconectar e, em seguida, selecione **Desconectar site do Jira**.
1. Na caixa de diálogo **Desconectar**, analise os efeitos da desconexão da conta.
1. Digite **desconectar** no campo de entrada de texto e selecione **Desconectar**.
# Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst
Antes de usar um GitHub repositório, repositório Bitbucket ou repositório de projetos, ou gerenciar um GitLab projeto do Jira, você deve conectar a fonte terceirizada à qual o repositório ou projeto pertence ao seu espaço. CodeCatalyst Para obter mais informações, consulte [Conectando GitHub contas, espaços de trabalho do Bitbucket, GitLab usuários e sites do Jira CodeCatalyst](extensions-connect.md).
Você pode usar repositórios vinculados, GitHub repositórios do Bitbucket ou repositórios de GitLab projetos 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 do fluxo de trabalho para fluxos de trabalho que usam repositórios vinculados GitHub ou do Bitbucket 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 GitHub repositório, repositório do Bitbucket ou repositório do GitLab projeto a um CodeCatalyst projeto na página de detalhes dos repositórios, dos **GitHub repositórios** do **Bitbucket ou da extensão dos repositórios**, ou na visualização de **GitLab repositórios** de **origem em Código** no próprio projeto.**
**Importante**
**Embora você possa vincular um repositório GitHub ou do Bitbucket como **colaborador, você só pode desvincular um repositório de terceiros como administrador do Space ou** **administrador do projeto**.** Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
**Importante**
Depois de instalar uma extensão de repositório, todos os repositórios aos quais você vincular CodeCatalyst terão seu código indexado e armazenado. CodeCatalyst Isso tornará o código pesquisável em CodeCatalyst. Para entender melhor a proteção de dados do seu código ao usar repositórios vinculados CodeCatalyst, consulte [Proteção de dados](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html) no *Guia do CodeCatalyst usuário da Amazon*.
**Importante**
CodeCatalyst não suporta 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, você deve primeiro desvinculá-la CodeCatalyst, alterar a ramificação padrão e depois 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 vinculados do Jira para gerenciar problemas e vincular CodeCatalyst pull requests a um problema do Jira. O status resumido de uma pull request e o status dos eventos de CodeCatalyst fluxo de trabalho associados são refletidos em seu problema com o Jira.
**Importante**
Para vincular seu projeto do Jira ao seu CodeCatalyst projeto, você deve ser administrador do CodeCatalyst **Space ou administrador CodeCatalyst ** **do projeto**.
**nota**
Um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto só pode ser vinculado a um CodeCatalyst projeto em um espaço.
Você não pode usar repositórios vazios ou arquivados, GitHub repositórios Bitbucket ou repositórios de projetos com GitLab projetos. CodeCatalyst
Você não pode vincular um GitHub repositório, repositório Bitbucket ou GitLab repositório que tenha o mesmo nome de um repositório em um projeto. CodeCatalyst
A extensão de **GitHub repositórios** 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 **GitLab repositories** não é compatível com repositórios de projetos GitLab autogerenciados.
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 pull requests em CodeCatalyst.
Um CodeCatalyst projeto só pode ser vinculado a um projeto do Jira. Um projeto do Jira pode ser vinculado a vários CodeCatalyst projetos.
**Topics**
+ [Vínculo de recursos de provedores de terceiros conectados](#extensions-link-resources)
+ [Vinculando um repositório de terceiros durante CodeCatalyst a criação do projeto](#extensions-link-repositories-creation)
## Vínculo de recursos de provedores de terceiros conectados
**Para vincular um GitHub repositório, repositório Bitbucket, repositório de projetos ou GitLab projeto do Jira a um CodeCatalyst projeto na página de detalhes da extensão**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:
1. Escolha **Configurações** e **Extensões instaladas**.
1. Escolha o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior.
1. **Escolha **Configurar** para uma das seguintes extensões: **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou **GitLab Jira Software**.**
1. Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:
+ **GitHub repositórios**: vincule um GitHub repositório.
1. Na guia ** GitHub Repositórios vinculados**, escolha **Vincular GitHub repositório**.
1. No menu suspenso da **GitHub conta**, escolha a GitHub conta que contém o repositório que você deseja vincular.
1. Na lista suspensa do **GitHub repositório**, escolha o repositório que você deseja vincular a um projeto. 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.
1. (Opcional) Se você não vê um GitHub repositório na lista de repositórios, ele pode não ter sido configurado para acesso ao repositório no aplicativo da Amazon CodeCatalyst em. GitHub Você pode configurar quais GitHub repositórios podem ser usados CodeCatalyst na conta conectada.
1. Navegue até sua [GitHub](https://github.com/)conta, escolha **Configurações** e, em seguida, escolha **Aplicativos**.
1. Na guia ** GitHub Aplicativos instalados**, escolha **Configurar** para o CodeCatalyst aplicativo Amazon.
1. Siga um destes procedimentos para configurar o acesso aos GitHub repositórios aos quais você deseja vincular: 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, escolha **Somente selecionar repositórios**, escolha a lista suspensa **Selecionar repositórios** e, em seguida, escolha um repositório ao qual você deseja permitir a vinculação. CodeCatalyst
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o GitHub repositório.
1. Escolha **Vincular**.
Se você não quiser mais usar um GitHub repositório no CodeCatalyst, você pode desvinculá-lo de um CodeCatalyst projeto. 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 ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **Repositórios do Bitbucket**: vincule um repositório do Bitbucket.
1. Na guia **Repositórios do Bitbucket vinculados**, selecione **Vincular 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.
1. No menu suspenso do **repositório Bitbucket**, escolha o repositório que você deseja vincular a um projeto. 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.
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o repositório do Bitbucket.
1. Escolha **Vincular**.
Se você não quiser mais usar um repositório do Bitbucket no CodeCatalyst, você pode desvinculá-lo de um projeto. 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 ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **GitLab repositórios**: vincule um repositório GitLab do projeto.
1. Na guia **Repositórios de GitLab projetos vinculados**, escolha **Vincular repositório GitLab do projeto**.
1. No menu suspenso do **GitLab usuário**, escolha o GitLab usuário que contém o repositório do projeto que você deseja vincular.
1. Na lista suspensa do **repositório do GitLab projeto**, escolha o repositório que você deseja vincular a um projeto. 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.
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto ao qual você deseja vincular o repositório do GitLab projeto.
1. Escolha **Vincular**.
Se você não quiser mais usar um repositório de GitLab projetos no CodeCatalyst, você pode desvinculá-lo de um CodeCatalyst projeto. Quando um repositório do projeto é desvinculado, os eventos desse repositório do projeto não iniciarão as execuções do fluxo de trabalho e você não poderá usar esse repositório do projeto com ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
+ **Software Jira**: vincule um projeto do Jira.
1. Na guia **Projetos do Jira vinculados**, selecione **Vincular projeto do Jira**.
1. No menu suspenso **Site do Jira**, escolha o site do Jira que contém o projeto que você deseja vincular.
1. No menu suspenso do **projeto do Jira**, escolha o projeto que você deseja vincular a um projeto. CodeCatalyst
1. No menu suspenso do **CodeCatalyst projeto**, escolha o CodeCatalyst projeto que você deseja vincular a um projeto do Jira.
1. Escolha **Vincular**.
Depois que um projeto do Jira é vinculado a um CodeCatalyst projeto, o acesso aos CodeCatalyst problemas é totalmente desativado e os **problemas** no painel de CodeCatalyst navegação serão substituídos por um item de **problemas do Jira** vinculado ao projeto Jira.
![\[CodeCatalyst problemas substituídos por problemas vinculados do Jira no painel de navegação.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
Se você não quiser mais usar um projeto do Jira no CodeCatalyst, você pode desvinculá-lo do seu CodeCatalyst projeto. Quando um projeto do Jira é desvinculado, os problemas do Jira não estarão disponíveis no CodeCatalyst projeto e os CodeCatalyst **problemas** voltarão a ser o fornecedor do problema. Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
**Para vincular um GitHub repositório, repositório Bitbucket ou repositório de projeto a um GitLab projeto a partir da página de repositórios de origem em um CodeCatalyst projeto**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. No painel de navegação, selecione **Código** e, depois, selecione **Repositórios de origem**.
1. Selecione **Adicionar repositório** e **Vincular repositório**.
1. **No menu suspenso **Provedor do repositório**, escolha um dos seguintes provedores de repositório terceirizados: **GitHub**, Bitbucket,. **GitLab****
1. Realize um destes procedimentos, dependendo do provedor de repositório de terceiros que você selecionar para vincular:
+ **GitHub repositórios**: vincule um GitHub repositório.
1. No menu suspenso da **GitHub conta**, escolha a GitHub conta que contém o repositório que você deseja vincular.
1. No menu suspenso do **GitHub repositório**, escolha o GitHub repositório ao qual você deseja vincular seu projeto. 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 na Amazon. CodeCatalyst
1. (Opcional) Se você não vê um GitHub repositório na lista de repositórios, ele pode não ter sido configurado para acesso ao repositório no aplicativo da Amazon CodeCatalyst em. GitHub Você pode configurar quais GitHub repositórios podem ser usados CodeCatalyst na conta conectada.
1. Navegue até sua [GitHub](https://github.com/)conta, escolha **Configurações** e, em seguida, escolha **Aplicativos**.
1. Na guia ** GitHub Aplicativos instalados**, escolha **Configurar** para o CodeCatalyst aplicativo Amazon.
1. Siga um destes procedimentos para configurar o acesso aos GitHub repositórios aos quais você deseja vincular: 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, escolha **Somente selecionar repositórios**, escolha a lista suspensa **Selecionar repositórios** e, em seguida, escolha um repositório ao qual você deseja permitir a vinculação. 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.
1. No menu suspenso do **repositório do Bitbucket**, escolha o repositório do Bitbucket ao qual você deseja vincular seu projeto. 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 na Amazon. CodeCatalyst
+ **GitLab repositórios**: vincule um repositório GitLab do projeto.
1. No menu suspenso **GitLab do usuário**, escolha o GitLab usuário que contém o repositório do projeto que você deseja vincular.
1. No menu suspenso do **repositório do GitLab projeto**, escolha o repositório do GitLab projeto ao qual você deseja vincular seu projeto. CodeCatalyst
**dica**
Se o nome do repositório do projeto estiver em cinza, você não poderá vincular esse repositório do projeto porque ele já foi vinculado a outro projeto na Amazon. CodeCatalyst
1. Escolha **Vincular**.
Se você não quiser mais usar um GitHub repositório, um repositório Bitbucket ou um repositório de GitLab projetos no CodeCatalyst, você pode desvinculá-lo de um projeto. 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 ambientes de desenvolvimento. CodeCatalyst Para obter mais informações, consulte [Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst](extensions-unlink.md).
Depois de vincular seu GitHub repositório, repositório Bitbucket ou repositório de projetos ao seu GitLab CodeCatalyst projeto, você pode usá-lo em CodeCatalyst fluxos de trabalho e ambientes de desenvolvimento. 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](extensions-workflow-repositories.md) e [Criar um Ambiente de Desenvolvimento](devenvironment-create.md).
Depois de vincular seu projeto do Jira ao seu CodeCatalyst projeto e vincular uma pull request, as atualizações do Jira CodeCatalyst são refletidas no seu projeto do Jira. Para ter mais informações sobre como vincular solicitações pull a problemas do Jira, consulte [Vinculando problemas do Jira a CodeCatalyst pull requests](link-jira-issues-pull-requests.md). Para obter mais informações sobre a visualização de CodeCatalyst eventos no Jira, consulte[Visualizando CodeCatalyst eventos em edições do Jira](view-codecatalyst-events-jira.md).
## Vinculando um repositório de terceiros durante CodeCatalyst a criação do projeto
Você pode vincular um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto a um novo projeto ao criar o novo CodeCatalyst projeto. CodeCatalyst Para obter mais informações, consulte [Criar um projeto com um repositório de terceiros vinculado](projects-create.md#projects-create-3p-repo).
# Desvincular repositórios, GitHub repositórios do Bitbucket, repositórios de projetos e GitLab projetos do Jira no CodeCatalyst
Se você não quiser mais usar um GitHub repositório, repositório Bitbucket ou repositório de projetos, nem gerenciar um GitLab projeto do Jira no CodeCatalyst, você pode desvincular o repositório ou o projeto do seu projeto. CodeCatalyst
Desvincular um GitHub repositório, repositório do Bitbucket ou repositório GitLab do projeto não exclui o repositório nem faz alterações nele. Isso não exclui nenhum arquivo de configuração do fluxo de trabalho armazenado nesse repositório vinculado. No entanto, depois de desvincular um GitHub repositório, repositório do Bitbucket ou repositório GitLab do projeto, os eventos desse repositório não iniciarão mais a execução do fluxo de trabalho e você não poderá usar o repositório com ambientes de desenvolvimento. **Você pode desvincular um GitHub repositório, repositório do Bitbucket ou repositório do GitLab projeto de um CodeCatalyst projeto na página de detalhes dos repositórios, dos **GitHub repositórios** do **Bitbucket ou da extensão dos repositórios**, ou na visualização de **GitLab repositórios** de **origem no Código** no próprio projeto.**
Desvincular um projeto do Jira não exclui o projeto, incluindo itens de planejamento ou informações de desenvolvimento, nem faz alterações nele. No entanto, depois de desvincular um projeto do Jira, os problemas do Jira do projeto não estarão mais disponíveis para vinculação ao CodeCatalyst projeto, e CodeCatalyst **Issues** voltará a ser o provedor do problema.
**Importante**
****Para desvincular seu GitHub repositório, repositório Bitbucket ou repositório de projetos do Gitlab do seu projeto, você deve ser o administrador do Space ou o administrador do CodeCatalyst projeto.****
**Para desvincular um GitHub repositório, repositório Bitbucket, repositório de GitLab projeto ou projeto Jira em um CodeCatalyst projeto da página de detalhes da extensão**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço.
1. Para ver uma lista das extensões instaladas em seu espaço, faça o seguinte:
1. Escolha **Configurações** e **Extensões instaladas**.
1. Escolha o ícone **Catálogo** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) no menu superior.
1. **Escolha **Configurar** para uma das seguintes extensões que você deseja configurar: **GitHub repositórios, repositórios** **Bitbucket, repositórios** ou **GitLab Jira Software**.**
1. Faça o seguinte, dependendo da extensão de terceiros que você decidiu configurar:
+ **GitHub repositórios**: desvincule um GitHub repositório.
**Na guia **GitHub repositórios, escolha o GitHub repositório** que você deseja desvincular e, em seguida, escolha Desvincular repositório. GitHub **
+ **Repositórios do Bitbucket**: desvincule um repositório do Bitbucket.
Na guia **Repositórios do Bitbucket**, escolha o repositório do Bitbucket que você deseja desvincular e, depois, selecione **Desvincular repositório do Bitbucket**.
+ **GitLab repositórios**: desvincule um repositório de GitLab projeto.
Na guia **Repositórios do GitLab projeto, escolha o repositório** do GitLab projeto que você deseja desvincular e, em seguida, escolha ** GitLab Desvincular** repositório do projeto.
+ **Software Jira**: desvincule um projeto do Jira.
Na guia **Projetos do Jira**, escolha o projeto do Jira que você deseja desvincular e, depois, selecione **Desvincular projeto do Jira**.
1. Na caixa de diálogo **Desvincular**, revise os efeitos da desvinculação do repositório.
1. Insira **desvincular** no campo de entrada de texto e selecione **Desvincular**.
**Para desvincular um GitHub repositório, repositório Bitbucket ou repositório de projeto em um GitLab CodeCatalyst projeto da página de repositórios de origem**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. No painel de navegação, selecione **Código** e, depois, selecione **Repositórios de origem**.
1. Escolha o botão de opção do repositório que você deseja desvincular e, depois, selecione **Desvincular repositório**.
1. Revise as informações na caixa de diálogo. Siga as instruções e selecione **Desvincular** para desvincular o repositório.
# Visualizando repositórios de terceiros e pesquisando problemas do Jira no CodeCatalyst
Depois de vincular GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos, você pode visualizá-los CodeCatalyst para confirmar e configurar os recursos. Você também pode pesquisar problemas vinculados do Jira em CodeCatalyst.
**Topics**
+ [Visualizando repositórios de terceiros no CodeCatalyst](#extensions-view-repositories)
+ [Pesquisando problemas com o Jira no CodeCatalyst](#extensions-search-issues)
## Visualizando repositórios de terceiros no CodeCatalyst
**Você pode visualizar os repositórios vinculados, GitHub os repositórios do Bitbucket ou os repositórios GitLab do projeto na lista de repositórios de origem do seu projeto ou na página de detalhes dos repositórios, **GitHub repositórios** do **Bitbucket ou da extensão dos repositórios**. GitLab ** Escolhê-los na lista de repositórios não os abre em CodeCatalyst. Em vez disso, eles abrem no provedor de repositórios terceirizado, onde é possível visualizar e trabalhar no código no repositório vinculado.
**Para visualizar repositórios vinculados, GitHub repositórios do Bitbucket ou GitLab repositórios de projetos no CodeCatalyst**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. No painel de navegação, selecione **Código** e, depois, selecione **Repositórios de origem**.
**Para visualizar repositórios vinculados, GitHub repositórios do Bitbucket ou repositórios de GitLab projetos na página de detalhes da extensão**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço e escolha a guia **Extensões instaladas**.
1. Dependendo dos repositórios de terceiros que deseja visualizar, realize uma das seguintes ações:
+ Em **GitHub repositórios**, escolha **Configurar** e, em seguida, escolha ** GitHub Repositórios vinculados** para visualizar todos os GitHub repositórios conectados aos CodeCatalyst projetos em seu espaço. CodeCatalyst
+ Nos **repositórios do Bitbucket**, escolha **Configurar** e, em seguida, escolha Repositórios **vinculados do Bitbucket para visualizar todos os repositórios** do Bitbucket conectados aos projetos em seu espaço. CodeCatalyst CodeCatalyst
+ Em **GitLab repositórios**, escolha **Configurar** e, em seguida, escolha **Repositórios de GitLab projetos vinculados** para visualizar todos os repositórios de GitLab projetos conectados aos CodeCatalyst projetos em seu espaço. CodeCatalyst
Os GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos vinculados ao seu CodeCatalyst projeto são mostrados na lista. Escolha o GitHub repositório, o repositório do Bitbucket ou o repositório GitLab do projeto para visualizar e editar arquivos no provedor de repositórios terceirizado.
**nota**
Se um fluxo de trabalho usar um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto em uma ação de origem, as alterações feitas no fluxo de trabalho YAML no editor visual ou no editor YAML em CodeCatalyst serão automaticamente confirmadas e enviadas para o repositório de terceiros.
## Pesquisando problemas com o Jira no CodeCatalyst
Depois de vincular um projeto do Jira, você pode pesquisar problemas no projeto vinculado do Jira usando a barra de pesquisa CodeCatalyst global. Você também pode pesquisar problemas do Jira CodeCatalyst enquanto vincula os problemas a partir de uma pull request. Para obter mais informações sobre como vincular problemas do Jira a uma CodeCatalyst pull request, consulte. [Vinculando problemas do Jira a CodeCatalyst pull requests](link-jira-issues-pull-requests.md)
**Como procurar problemas do Jira em projetos vinculados do Jira**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. Na barra de pesquisa global, pesquise problemas em um projeto vinculado do Jira ou problemas do Jira que você deseja vincular a uma solicitação pull.
# Início automático da execução de um fluxo de trabalho após eventos de repositórios de terceiros
Você pode usar um GitHub repositório vinculado, um repositório do Bitbucket ou um repositório GitLab do projeto como fonte para um fluxo de trabalho, no qual as alterações em uma ramificação especificada em um GitHub repositório vinculado, repositório do Bitbucket ou repositório do GitLab projeto iniciam automaticamente a execução do fluxo 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](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors) do CodeCatalyst console.
**dica**
Para ver rapidamente como usar fluxos de trabalho em um projeto, [crie um projeto com um esquema](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template). Cada esquema implanta um fluxo de trabalho funcional que você pode revisar, executar e experimentar.
Quando você configura um fluxo de trabalho para usar um GitHub repositório vinculado, repositório do Bitbucket ou repositório GitLab do projeto, o arquivo de configuração do fluxo de trabalho é armazenado nesse GitHub repositório, repositório do Bitbucket ou repositório do projeto. GitLab A configuração do fluxo de trabalho é um arquivo YAML que define o nome, os gatilhos, os recursos, os artefatos e as ações do fluxo de trabalho. Para ter mais informações sobre o arquivo de configuração do fluxo de trabalho, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md).
O arquivo de configuração do fluxo de trabalho deve estar no `./codecatalyst/workflows/` diretório do seu GitHub repositório, repositório Bitbucket ou GitLab repositório do projeto.
Você pode usar o editor de fluxo de trabalho para criar e configurar fluxos de trabalho. Para obter mais informações, consulte [Conceitos básicos de fluxos de trabalho](workflows-getting-started.md) e [Conectar repositórios de origem aos fluxos de trabalho](workflows-sources.md).
## Adição de gatilhos para iniciar a execução do fluxo de trabalho
Você pode configurar um CodeCatalyst fluxo de trabalho para iniciar automaticamente uma execução quando o código for enviado para a ramificação especificada do seu repositório GitHub ou do Bitbucket. Para iniciar a execução automática de um fluxo de trabalho, adicione um gatilho à seção `Triggers` do arquivo de configuração do fluxo de trabalho.
### Exemplo: um simples gatilho de envio de código
O exemplo a seguir mostra um gatilho que inicia a execução de um fluxo de trabalho sempre que o código é enviado para qualquer ramificação no seu repositório de origem.
```
Triggers:
- Type: PUSH
```
### Exemplo: um simples gatilho de solicitação pull
O exemplo a seguir mostra um gatilho que inicia a execução de um fluxo de trabalho sempre que uma solicitação pull é criada em qualquer ramificação no seu repositório de origem.
```
Triggers:
- Type: PULLREQUEST
Events:
- OPEN
```
Para obter mais informações, consulte [Início da execução automática de um fluxo de trabalho usando gatilhos](workflows-add-trigger.md).
# Restrição do acesso ao IP com provedores de repositório de terceiros
Você pode restringir o acesso aos seus GitHub repositórios, repositórios do Bitbucket ou repositórios de GitLab projetos com base em endereços IP definindo regras ou configurações. Faça isso por meio das configurações ou dos recursos de controle de acesso do provedor de terceiros.
Dependendo do provedor de repositório de terceiros que você está usando, observe o seguinte:
+ A extensão de CodeCatalyst **GitHub repositórios** da Amazon é compatível com as [restrições de acesso IP do GitHub Enterprise Cloud](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization). Ao configurar uma organização do GitHub Enterprise Cloud para restringir o acesso a endereços IP específicos, você também pode [permitir que GitHub os aplicativos configurem a lista de permissões, que permitirá](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) CodeCatalyst registrar seus endereços IP automaticamente com GitHub. Como alternativa, você pode [adicionar manualmente os endereços CodeCatalyst IP](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address).
+ A extensão CodeCatalyst **de repositórios Amazon Bitbucket** é compatível com as restrições de acesso do [Bitbucket Cloud Premium](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/). Ao configurar um espaço de trabalho do Bitbucket Cloud Premium para restringir o acesso a endereços IP específicos, você também pode [adicionar endereços IP ou blocos de rede para um conjunto de endereços IP a uma lista de permissões](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/#Allowlisting-IP-addresses).
+ A extensão de CodeCatalyst **GitLab repositórios** da Amazon é compatível com [restrições GitLab de endereço IP](https://docs.gitlab.com/ee/administration/reporting/ip_addr_restrictions.html). Ao configurar um grupo GitLab Premium ou Ultimate para restringir o acesso a endereços IP específicos, você também pode [adicionar endereços IP ou blocos de rede para um conjunto de endereços IP a uma lista de permissões](https://docs.gitlab.com/ee/user/group/access_and_permissions.html).
Se os endereços CodeCatalyst IP não estiverem na lista de permissões de um repositório de terceiros, o CodeCatalyst aplicativo da Amazon não poderá acessar seus repositórios de terceiros. Para obter mais informações, consulte [Endereços IP usados pela extensão de repositórios de terceiros](#codecatalyst-ip-address).
## Endereços IP usados pela extensão de repositórios de terceiros
Os seguintes endereços IP são usados pelas extensões de terceiros para acessar seus recursos de terceiros:
+ **GitHub repositórios**:
```
us-west-2
52.32.242.246
54.148.176.49
35.164.118.94
eu-west-1
34.241.64.10
34.246.255.80
3.248.38.7
```
+ **Repositórios e GitLab repositórios do Bitbucket****:**
```
us-west-2
35.160.210.199
54.71.206.108
54.71.36.205
eu-west-1
34.242.64.82
52.18.37.201
54.77.75.62
```
# Bloqueio de mesclagens de terceiros quando os fluxos de trabalho falham
Depois de vincular um repositório GitHub ou do Bitbucket a CodeCatalyst, você pode adicionar CodeCatalyst fluxos de trabalho para pull requests. Da mesma forma, depois de vincular um repositório de GitLab projetos, CodeCatalyst você pode adicionar CodeCatalyst fluxos de trabalho para solicitações de mesclagem. Uma ou mais execuções de fluxo de trabalho podem ocorrer em uma confirmação específica, e o status de execução de cada fluxo de trabalho em também CodeCatalyst é refletido como parte do status de confirmação em GitHub, Bitbucket ou GitLab. Quando uma nova confirmação é enviada, os novos [status de execução](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-view-run.html#workflows-view-run-status) do fluxo de trabalho são refletidos no GitHub Bitbucket ou GitLab para essa nova confirmação. Se você executar um fluxo de trabalho novamente para uma confirmação, o novo status de execução do fluxo de trabalho substituirá o status anterior dessa confirmação e do fluxo de trabalho.
Você pode definir regras de proteção de ramificações no Bitbucket GitHub ou no Bitbucket para bloquear uma mesclagem de pull request ou GitLab para bloquear uma solicitação de mesclagem quando a confirmação mais recente tiver um status de falha na execução do fluxo de trabalho. Com as regras de proteção de ramificações, o status da confirmação mais recente afeta a capacidade de mesclar uma pull request no GitHub Bitbucket ou. GitLab Para saber mais sobre fluxos de trabalho, consulte [Executar um fluxo de trabalho](workflows-working-runs.md) e [Início da execução automática de um fluxo de trabalho usando gatilhos](workflows-add-trigger.md).
Dependendo do provedor de repositório terceirizado que você está usando, veja o seguinte:
+ **GitHub repositórios**: GitHub documentação [sobre verificações de status](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks) e [Sobre filiais protegidas](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches).
+ **Repositórios do Bitbucket**: documentação do Bitbucket para [Uso de permissões de ramificação](https://confluence.atlassian.com/bitbucketserver/using-branch-permissions-776639807.html) e [Assumir o controle com permissões de ramificação no Bitbucket Cloud](https://bitbucket.org/blog/take-control-with-branch-restrictions).
+ **GitLab repositórios**: GitLab documentação para [mesclagem automática](https://docs.gitlab.com/ee/user/project/merge_requests/auto_merge.html) e ramificações [protegidas](https://docs.gitlab.com/ee/user/project/protected_branches.html).
# Vinculando problemas do Jira a CodeCatalyst pull requests
Você pode vincular pull requests criadas em um repositório de CodeCatalyst origem aos problemas do Jira. Depois de vincular um problema do Jira, o problema é exibido como uma propriedade da solicitação pull. Como resultado, eventos de solicitação pull, eventos de fluxo de trabalho e eventos de implantação são enviados para o Jira e adicionados ao problema do Jira. As solicitações pull podem ser vinculadas a um ou mais problemas do Jira. Você só pode vincular pull requests que estão em um repositório de CodeCatalyst origem, não aquelas em um repositório de terceiros, como. GitHub Antes de vincular problemas do Jira a uma pull request, seu projeto do Jira deve estar vinculado ao CodeCatalyst projeto. Para obter mais informações sobre como vincular um projeto do Jira a um CodeCatalyst projeto, consulte. [Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst](extensions-link.md)
**nota**
Você não pode criar uma pull request sem um repositório de origem com duas ramificações em seu CodeCatalyst projeto. Para obter mais informações sobre pull requests, consulte Como [trabalhar com pull requests em CodeCatalyst](source-pull-requests.md).
**Para vincular problemas do Jira a uma CodeCatalyst pull request**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. No painel de navegação, selecione **Código** e **Solicitações pull**.
1. Selecione **Criar solicitação pull** para inserir os detalhes da solicitação pull.
1. No menu suspenso **Repositório de origem**, escolha o repositório de origem ao qual você deseja vincular uma solicitação pull.
1. No menu suspenso **Ramificação de origem**, escolha a ramificação que contém as alterações que você deseja revisar.
1. No menu suspenso **Ramificação de destino**, escolha a ramificação na qual você deseja mesclar as alterações revisadas.
1. No campo de entrada de texto **Título da solicitação pull**, insira o título das suas solicitações pull.
1. Selecione **Vincular problemas** para o campo **Problemas do Jira - *opcional***, escolha o menu suspenso e pesquise os problemas do Jira que você deseja adicionar do projeto vinculado do Jira.
1. Selecione os problemas do Jira que você deseja adicionar à solicitação pull.
1. Selecione **Criar** para criar a solicitação pull.
Depois de vincular os problemas do Jira a uma CodeCatalyst pull request, um resumo da pull request fica disponível. O resumo inclui execuções do fluxo de trabalho, problemas vinculados, revisores obrigatórios, revisores opcionais e o autor.
**nota**
As informações de **Destinatário e Criado** **por** associadas à edição do Jira não estão disponíveis em. CodeCatalyst
Depois de vincular uma pull request, o CodeCatalyst projeto sincronizado e o projeto Jira permitem que as atualizações sejam refletidas em seu projeto do CodeCatalyst Jira. O status da solicitação pull vinculada e todos os eventos do fluxo de trabalho relacionados à solicitação pull aparecerão no problema do Jira ao visualizá-lo no Jira. Para obter mais informações sobre a visualização de CodeCatalyst eventos no Jira, consulte[Visualizando CodeCatalyst eventos em edições do Jira](view-codecatalyst-events-jira.md).
# Visualizando CodeCatalyst eventos em edições do Jira
Se seus CodeCatalyst projetos e projetos do Jira estiverem vinculados, o status resumido da pull request e o status dos eventos de CodeCatalyst fluxo de trabalho associados serão refletidos em seu problema no Jira. Por exemplo, se você fechar ou mesclar uma pull request CodeCatalyst, a atualização de status será refletida no problema do Jira. CodeCatalyst CI/CD os eventos do fluxo de trabalho relacionados a uma CodeCatalyst pull request são sincronizados, portanto, uma execução bem-sucedida do fluxo de trabalho também seria enviada para o problema do Jira.
**Para visualizar CodeCatalyst eventos em uma edição do Jira**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst projeto.
1. No painel de CodeCatalyst navegação, escolha **Código**, escolha **Pull requests** e, em seguida, escolha a pull request com o problema do Jira que você deseja visualizar em seu projeto do Jira.
1. No painel **Informações adicionais**, selecione o problema do Jira que você deseja visualizar no seu projeto do Jira.
1. No painel **Detalhes** do projeto Jira, selecione a **solicitação pull** listada para **Desenvolvimento** para ver os detalhes da solicitação pull.
1. (Opcional) Para ver as versões mais recentes, selecione a guia **Compilações**.
1. (Opcional) Para ver o status de desenvolvimento, selecione a guia **Implantações.**