Gerenciando conexões do App Runner

Quando você cria um serviço no AWS App Runner, você configura uma fonte de aplicativo — uma imagem de contêiner ou um repositório de origem que é armazenado com um provedor. O App Runner precisa estabelecer uma conexão autenticada e autorizada com o provedor. Em seguida, o App Runner pode ler seu repositório e implantá-lo em seu serviço. O App Runner não exige o estabelecimento de conexão quando você cria um serviço que acessa o código armazenado em seu Conta da AWS.

O App Runner mantém as informações de conexão em um recurso chamado conexão. O console do App Runner e este guia também se referem às conexões como contas conectadas. O App Runner exige um recurso de conexão quando você cria um serviço que precisa de informações de conexão de terceiros. A seguir estão algumas informações importantes sobre conexões:

• Provedores — O App Runner atualmente requer recursos de conexão com o GitHubBitbucket.

• Compartilhado — você pode usar um recurso de conexão para criar vários serviços do App Runner que usam a mesma conta de provedor de repositório.

• Gerenciamento de recursos — No App Runner, você pode criar e excluir conexões. No entanto, você não pode modificar uma conexão existente.

• Cota de recursos — Os recursos de conexão têm uma cota definida associada à sua Conta da AWS em cada Região da AWS. Se você atingir essa cota, talvez seja necessário excluir uma conexão antes de se conectar a uma nova conta de provedor. Você pode excluir uma conexão usando o console do App Runner ou API conforme descrito na seção a seguir,Gerenciar conexões. Para obter mais informações, consulte Cotas de recursos do App Runner.

Gerenciar conexões

Gerencie suas conexões do App Runner usando um dos seguintes métodos:

App Runner console

Ao usar o console do App Runner para criar um serviço, você fornece detalhes da conexão. Você não precisa criar explicitamente um recurso de conexão. No console, você pode escolher se conectar a uma GitHub conta do Bitbucket à qual você já se conectou antes ou se conectar a uma nova conta. Quando necessário, o App Runner cria um recurso de conexão para você. Para uma nova conexão, alguns provedores exigem que você conclua um handshake de autenticação antes de poder usar a conexão. O console conduz você por esse processo.

O console também tem uma página para gerenciar suas conexões existentes. Você pode concluir o handshake de autenticação de uma conexão se não tiver feito isso quando criou seu serviço. Você também pode excluir conexões que não está mais usando. O procedimento a seguir mostra como você pode gerenciar as conexões do provedor de repositório.

Para gerenciar conexões em sua conta

1. Abra o console do App Runner e, na lista Regiões, selecione seu Região da AWS.

2. No painel de navegação, escolha Contas conectadas.

   Em seguida, o console exibe uma lista de conexões do provedor de repositório na sua conta.

   

3. Agora você pode executar uma das seguintes ações com qualquer conexão na lista:

   • Abra uma conta ou organização GitHub /Bitbucket — Escolha o nome da conexão.

   • Handshake de autenticação completo — Selecione a conexão e, no menu Ações, escolha Handshake completo. O console conduz você pelo processo de handshake de autenticação.

   • Excluir conexão — Selecione a conexão e, no menu Ações, escolha Excluir. Siga as instruções no aviso de exclusão.

App Runner API or AWS CLI

Você pode usar as seguintes API ações do App Runner para gerenciar suas conexões.

• CreateConnection— Cria uma conexão com uma conta de provedor de repositório. Depois que a conexão for criada, você deverá concluir manualmente o handshake de autenticação usando o console do App Runner. Esse processo é explicado na seção anterior.

• ListConnections— Retorna uma lista de conexões do App Runner associadas à sua Conta da AWS.

• DeleteConnection— Exclui uma conexão. Talvez seja necessário excluir conexões desnecessárias se atingir a cota de conexão do seu Conta da AWS.