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 sua própria API, a referência AWS CodeConnections da API. 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 do recurso da Amazon (ARN) exclusivo que é usado para fazer referência à 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 um ARN de conexão 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 pessoas Serviços da AWS para fornecer conexões OAuth 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.

As conexões são de propriedade de Conta da AWS quem as cria. As conexões são identificadas por um ARN que contém um ID de conexão. O ID da conexão é um UUID que não pode ser alterado nem remapeado. Excluir e restabelecer uma conexão resulta em um novo ID de conexão e, portanto, em um novo ARN de conexão. Isso significa que os ARNs de conexão nunca são reutilizados.

Uma conexão recém-criada está em um estado Pending. Um processo de handshake de terceiros (fluxo OAuth) é necessário para concluir a configuração da conexão e para que ela se mova de Pending para um estado Available. 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 formato do ARN da conexão reflita o nome da região onde ele 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 operações de API que controlam atualizações para dados de recursos 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 onde a conexão foi criada estiver tendo problemas, isso afetará APIs que controlam dados de recursos de conexão, 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 ou CLI, 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 ou na CLI, 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 exibida com a CLI, a saída retorna o ARN do host independentemente da região da CLI 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 a CLI, o SDK ou o AWS CloudFormation

Você usa a CreateHostAPI para criar um host usando 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.

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: Criando ou atualizando uma conexão com a CLI, SDK ou AWS CloudFormation

Você usa a CreateConnectionAPI para criar uma conexão usando 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 o 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.

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

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

• Saiba mais sobre os conceitos de conexões.

• Configure os recursos necessários para começar a trabalhar com conexões.

• Comece a configurar suas primeiras conexões e conecte-as a um recurso.