O que são conexões? - Console do Developer Tools
O que posso fazer com as conexões?Para quais provedores de terceiros posso criar conexões?O que Serviços da AWS se integra às conexões?Como funcionam as conexões?O que devo fazer para começar a usar conexões?

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á.

O que são conexões?

Você pode usar o recurso de conexões no console do Developer Tools para conectar AWS recursos, como AWS CodePipeline repositórios de código externos. Esse recurso tem o seu próprioAPI, a AWS CodeConnections APIreferência. Cada conexão é um recurso que você pode fornecer aos AWS serviços para se conectarem a um repositório de terceiros, como BitBucket. Por exemplo, você pode adicionar a conexão para CodePipeline que ela acione seu pipeline quando uma alteração de código for feita em seu repositório de código de terceiros. Cada conexão é nomeada e associada a um nome de recurso exclusivo da Amazon (ARN) que é usado para referenciar a conexão.

Importante

O nome do serviço AWS CodeStar Connections foi renomeado. Os recursos criados com as conexões codestar-stars do namespace anterior ainda serão suportados.

O que posso fazer com as conexões?

Você pode usar conexões para integrar recursos de provedores de terceiros com seus recursos da AWS em ferramentas de desenvolvedor, como:

  • Conecte-se a um provedor terceirizado, como o Bitbucket, e use a conexão de terceiros como uma integração de origem com seus AWS recursos, como CodePipeline.

  • Gerencie uniformemente o acesso à sua conexão em todos os seus recursos ao CodeBuild criar projetos, CodeDeploy aplicativos e pipelines CodePipeline para seu provedor terceirizado.

  • Use uma conexão ARN em seus modelos de pilha para CodeBuild criar projetos, CodeDeploy aplicativos e pipelines CodePipeline, sem a necessidade de referenciar segredos ou parâmetros armazenados.

Para quais provedores de terceiros posso criar conexões?

As conexões podem associar seus AWS recursos aos seguintes repositórios de terceiros:

  • Bitbucket Cloud

  • GitHub.com

  • GitHub Nuvem corporativa

  • GitHub Servidor corporativo

  • GitLab.com

    Importante

    O suporte de conexões GitLab inclui a versão 15.x e posterior.

  • GitLab instalação autogerenciada (para Enterprise Edition ou Community Edition)

Para obter uma visão geral do fluxo de trabalho de conexões, consulte Fluxo de trabalho para criar ou atualizar conexões.

As etapas para criar conexões para um tipo de provedor de nuvem GitHub, como, são diferentes das etapas para um tipo de provedor instalado, como GitHub Enterprise Server. Para obter as etapas de alto nível para criar uma conexão por tipo de provedor, consulte Trabalhar com conexões.

nota

Para usar conexões na Europa (Milão) Região da AWS, você deve:

  1. Instalar uma aplicação específica da região.

  2. Habilitar a região.

Essa aplicação específica da região é compatível com conexões na região Europa (Milão). Ela é publicada no site do provedor externo e é separada da aplicação existente que permite conexões para outras regiões. Ao instalar essa aplicação, você autoriza provedores externos a compartilhar seus dados somente com o serviço dessa região, mas pode revogar as permissões a qualquer momento ao desinstalá-la.

O serviço não processará nem armazenará seus dados, a menos que você habilite a região. Ao habilitar essa região, você concede ao nosso serviço permissões para processar e armazenar seus dados.

Mesmo que a região não esteja habilitada, provedores externos ainda poderão compartilhar seus dados com nosso serviço se a aplicação específica da região permanecer instalada. Portanto, desinstale a aplicação depois de desabilitar a região. Para obter mais informações, consulte Habilitar uma região.

O que Serviços da AWS se integra às conexões?

Você pode usar conexões para integrar seu repositório de terceiros a outros Serviços da AWS. Para visualizar as integrações de serviços para conexões, consulte Integrações de produtos e serviços ao AWS CodeConnections.

Como funcionam as conexões?

Antes de criar uma conexão, você deve primeiro instalar ou fornecer acesso à aplicação de autenticação da AWS em sua conta de terceiros. Depois que uma conexão é instalada, ela pode ser atualizada para usar essa instalação. Ao criar uma conexão, você deve fornecer acesso ao recurso da AWS em sua conta de terceiros. Isso permite que a conexão acesse conteúdo, como repositórios de origem, na conta de terceiros, em nome de seus AWS recursos. Em seguida, você pode compartilhar essa conexão com outras Serviços da AWS pessoas para fornecer OAuth conexões seguras entre os recursos.

Se você quiser criar uma conexão com um tipo de provedor instalado, como o GitHub Enterprise Server, primeiro crie um recurso de host usando AWS Management Console o.

Diagrama mostrando as conexões entre AWS recursos e um repositório de terceiros usando a conexãoARNs.

As conexões são de propriedade de Conta da AWS quem as cria. As conexões são identificadas por um ARN contendo um ID de conexão. A ID da conexão não pode ser alterada nem remapeada. UUID Excluir e restabelecer uma conexão resulta em uma nova ID de conexão e, portanto, em uma nova conexão. ARN Isso significa que as conexões nunca ARNs são reutilizadas.

Uma conexão recém-criada está em um estado Pending. É necessário um processo de handshake (OAuthfluxo) de terceiros para concluir a configuração da conexão e para que ela passe Pending para um Available estado. Depois que isso for concluído, uma conexão é Available e pode ser usada com AWS serviços, como CodePipeline.

Um host recém-criado está em um estado Pending. Um processo de registro de terceiros (fluxo OAuth) é necessário para concluir a configuração do host e para que ela se mova de Pending para um estado Available. Depois que isso for concluído, um host será Available e poderá ser usado para conexões com tipos de provedores instalados.

Para obter uma visão geral do fluxo de trabalho de conexões, consulte Fluxo de trabalho para criar ou atualizar conexões. Consulte uma visão geral do fluxo de trabalho de criação de host para provedores instalados em Fluxo de trabalho para criar ou atualizar um host. Para obter as etapas de alto nível para criar uma conexão por tipo de provedor, consulte Trabalhar com conexões.

Recursos globais em AWS CodeConnections

Conexões são recursos globais, o que significa que o recurso é replicado em todas as Regiões da AWS.

Embora o ARN formato da conexão reflita o nome da região em que foi criado, o recurso não está restrito a nenhuma região. A região onde o recurso de conexão foi criado é a região onde as atualizações de dados de recursos de conexão são controladas. Exemplos de API operações que controlam atualizações nos dados do recurso de conexão incluem criar uma conexão, atualizar uma instalação, excluir uma conexão ou marcar uma conexão.

Recursos de host para conexões não são recursos disponíveis globalmente. Use recursos de host somente na região em que eles foram criados.

  • Você só precisa criar uma conexão uma vez; depois, você pode usá-la em qualquer Região da AWS.

  • Se a região em que a conexão foi criada estiver com problemas, APIs isso afetará os dados do recurso de conexão de controle, mas você ainda poderá usar a conexão com êxito em todas as outras regiões.

  • Quando você lista recursos de conexão no console ouCLI, a lista mostra todos os recursos de conexão associados à sua conta em todas as regiões.

  • Quando você lista os recursos do host no console ouCLI, a lista mostra os recursos do host associados à sua conta somente na região selecionada.

  • Quando uma conexão com um recurso de host associado é listada ou visualizada com oCLI, a saída retorna o host, ARN independentemente da CLI região configurada.

Fluxo de trabalho para criar ou atualizar um host

Ao criar uma conexão com um provedor instalado, primeiro crie um host.

Os hosts podem ter os seguintes estados:

  • Pending: um host pending foi criado e deve ser configurado (movido para available) antes de poder ser usado.

  • Available: você pode usar ou passar um host available para sua conexão.

Fluxo de trabalho: criar ou atualizar um host com oCLI,SDK, ou AWS CloudFormation

Você usa o CreateHostAPIpara criar um host usando o AWS Command Line Interface (AWS CLI)SDK, ou AWS CloudFormation. Após ser criado, o host fica em um estado pending. Conclua o processo usando a opção Configurar no console.

Fluxo de trabalho: criar ou atualizar um host com o console

Se você estiver criando uma conexão com um tipo de provedor instalado, como GitHub Enterprise Server ou GitLab autogerenciado, primeiro crie um host. Se você estiver se conectando a um tipo de provedor de nuvem, como Bitbucket, ignore a criação do host e continue criando uma conexão.

Use o console para configurar o host e alterar seu status de pending para available.

Diagrama mostrando o fluxo de trabalho de criação de uma conexão com o provedor de terceiros.

Fluxo de trabalho para criar ou atualizar conexões

Ao criar uma conexão, você também cria ou usa uma instalação existente para o handshake de autenticação com o provedor de terceiros.

As conexões podem ter um dos seguintes status:

  • Pending: uma conexão pending é uma conexão que deve ser concluída (movida para available) antes que possa ser usada.

  • Available: você pode usar ou passar uma conexão available para outros recursos e usuários na sua conta.

  • Error: uma conexão que tem um estado error é repetida automaticamente. Ela não poderá ser usada até se tornar available.

Fluxo de trabalho: criar ou atualizar uma conexão com oCLI,SDK, ou AWS CloudFormation

Você usa o CreateConnectionAPIpara criar uma conexão usando o AWS Command Line Interface (AWS CLI)SDK, ou AWS CloudFormation. Após ser criada, a conexão está em um estado pending. Você deve então concluir o processo usando a opção Set up pending connection (Configurar conexão pendente do console. O console solicita que você crie uma instalação ou use uma instalação existente para a conexão. Em seguida, use o console para concluir o handshake e mover a conexão para um estado available escolhendo Complete connection (Concluir conexão) no console.

Fluxo de trabalho: criação ou atualização de uma conexão com o console

Se você estiver criando uma conexão com um tipo de provedor instalado, como GitHub Enterprise Server, primeiro crie um host. Se você estiver se conectando a um tipo de provedor de nuvem, como Bitbucket, ignore a criação do host e continue criando uma conexão.

Para criar ou atualizar uma conexão usando o console, use a página de ação de CodePipeline edição no console para escolher seu provedor terceirizado. O console solicita que você crie uma instalação ou use uma instalação existente para a conexão e, em seguida, use o console para criar a conexão. O console conclui o handshake e move a conexão de pending automaticamente para um estado available.

Diagrama mostrando o fluxo de trabalho de criação de uma conexão com o provedor de terceiros.

O que devo fazer para começar a usar conexões?

Para começar, veja alguns tópicos úteis para revisar: