Criar serviços do App Runner

Você pode criar um serviço do App Runner no kit de ferramentas para VS Code usando o AWS Explorer e a Paleta de comandos do VS Code. Depois de escolher criar um serviço em uma AWS região específica, as etapas numeradas fornecidas pela Paleta de Comandos orientam você pelo processo de configuração da instância de serviço em que seu aplicativo é executado.

Antes de criar um serviço do App Runner, verifique se você atendeu aos pré-requisitos. Isso inclui fornecer as permissões relevantes do IAM e confirmar o repositório-fonte específico que você deseja implantar.

Para criar um serviço do App Runner

1. Abra o AWS Explorer, se ele ainda não estiver aberto.

2. Clique com o botão direito do mouse no nó do App Runner e escolha Create Service (Criar serviço).

   A paleta de comandos é exibida.

3. Para Select a source code location type (Selecionar um tipo de localização de código-fonte), escolha ECR ou Repository (Repositório).

   Se escolher ECR, você especificará uma imagem de contêiner em um repositório mantido pelo Amazon Elastic Container Registry. Se escolher Repository (Repositório), você especificará um repositório de códigos-fonte mantido por um provedor de repositórios compatível. Atualmente, o App Runner oferece suporte GitHubcomo provedor de repositório de código-fonte.

Implantar do ECR

1. Para Select or enter an image repository (Selecionar ou inserir um repositório de imagens), escolha ou insira a URL do repositório de imagens mantido pelo registro privado do Amazon ECR ou pela Amazon ECR Public Gallery.

   nota

   Se especificar um repositório da Amazon ECR Public Gallery, verifique se as implantações automáticas estão desativadas, porque o App Runner não dá suporte a implantações automáticas de imagens de um repositório público do ECR.

   As implantações automáticas são desativadas por padrão, e isso é indicado quando o ícone no cabeçalho da paleta de comandos está cruzado por uma linha diagonal. Se você escolher ativar implantações automáticas, uma mensagem informará que essa opção pode gerar custos adicionais.

2. Se a etapa da paleta de comandos informar que Nenhuma tag foi encontrada, será necessário voltar uma etapa para selecionar um repositório que contenha uma imagem de contêiner marcada.

3. Se você estiver usando um registro privado do Amazon ECR, precisará da função de acesso ECR, AppRunnerECR AccessRole, que permite que o App Runner acesse imagens do Amazon Elastic Container Registry (Amazon ECR) em sua conta. Escolha o ícone “+” no cabeçalho da paleta de comandos para criar automaticamente essa função. (Uma função de acesso não será necessária se a imagem estiver armazenada no Amazon ECR público, onde as imagens estão disponíveis ao público.)

4. Para Port (Porta), insira a porta IP usada pelo serviço (porta 8000, por exemplo).

5. Para Configure environment variables, (Configurar variáveis de ambiente), você pode especificar um arquivo que contém as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço. Ou pode ignorar essa etapa.

6. Para Name your service (Dar nome ao serviço), insira um nome exclusivo sem espaços e pressione Enter.

7. Para Select instance configuration (Selecionar a configuração da instância), escolha uma combinação de unidades de CPU e memória em GB para a instância do serviço.

   Quando o serviço está sendo criado, o status é alterado de Creating (Sendo criado) para Running (Em execução).

8. Depois que o serviço começar a ser executado, clique com o botão direito do mouse e escolha Copy Service URL (Copiar URL do serviço).

9. Para acessar a aplicação implantada, cole a URL copiada na barra de endereços do navegador da Web.

Implantar de um repositório remoto

1. Em Selecionar uma conexão, escolha uma conexão GitHub vinculada AWS a. As conexões que estão disponíveis para seleção estão listadas na página de GitHub conexões no console do App Runner.

2. Em Selecionar um GitHub repositório remoto, escolha ou insira uma URL para o repositório remoto.

   Repositórios remotos que já estão configurados com o gerenciamento de controle de origem (SCM) do Visual Studio Code estão disponíveis para seleção. Você também pode colar um link para o repositório se ele não estiver listado.

3. Para Select a branch (Selecionar uma ramificação), escolha qual ramificação Git do código-fonte você deseja implantar.

4. Para Choose configuration source (Escolher fonte de configuração), especifique como você deseja definir a configuração de tempo de execução.

   Se escolher Use configuration file (Usar arquivo de configuração), a instância do serviço será definida pelas configurações do arquivo de configuração apprunner.yaml. Esse arquivo está no diretório raiz do repositório da aplicação.

   Se você escolher Defina todas as configurações aqui, use a paleta de comandos para especificar o seguinte:

   • Runtime (Tempo de execução): escolha Python 3 ou Nodejs 12.

   • Build command (Comando Build): insira o comando para compilar a aplicação no ambiente do tempo de execução da instância do serviço.

   • Start command (Comando Start): insira o comando para compilar a aplicação no ambiente do tempo de execução da instância do serviço.

5. Para Port (Porta), insira a porta IP usada pelo serviço (porta 8000, por exemplo).

6. Para Configure environment variables, (Configurar variáveis de ambiente), você pode especificar um arquivo que contém as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço. Ou pode ignorar essa etapa.

7. Para Name your service (Dar nome ao serviço), insira um nome exclusivo sem espaços e pressione Enter.

8. Para Select instance configuration (Selecionar a configuração da instância), escolha uma combinação de unidades de CPU e memória em GB para a instância do serviço.

   Quando o serviço está sendo criado, o status é alterado de Creating (Sendo criado) para Running (Em execução).

9. Depois que o serviço começar a ser executado, clique com o botão direito do mouse e escolha Copy Service URL (Copiar URL do serviço).

10. Para acessar a aplicação implantada, cole o URL copiado na barra de endereços do navegador da web.

nota

Se a tentativa de criar um serviço do App Runner falhar, o serviço exibirá um status de Create failed (Falha na criação) no AWS Explorer. Para obter dicas para a solução de problemas, consulte When service creation fails (Quando a criação do serviço falha) no App Runner Developer Guide (Guia do desenvolvedor do App Runner).