Criar serviços do App Runner - AWS Cloud9

O AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais

Criar serviços do App Runner

Você pode criar um serviço do App Runner no AWS Toolkit usando o AWS Explorer. Depois que você opta por criar um serviço em uma Região da AWS específica, o painel de comandos do Kit de ferramentas da AWS descreve como configurar a instância do serviço na qual a aplicação é executada.

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

    O painel de comando do AWS Toolkit é exibido.

  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 dá suporte ao GitHub como provedor de repositórios de códigos-fonte.

  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 você especificar um repositório da Amazon ECR Public Gallery, verifique se as implantações automáticas estão desativadas. O App Runner não é compatível com 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. Isso é indicado quando o ícone no cabeçalho do painel 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 no painel de comandos informar No tags found (Nenhuma etiqueta encontrada), volte uma etapa para selecionar um repositório que contenha uma imagem de contêiner marcada.

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

  4. (Opcional) Em Configure environment variables (Configurar variáveis de ambiente), especifique um arquivo que contenha as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço.

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

  6. Em Name your service (Fornecer nome ao serviço), insira um nome exclusivo e pressione Enter. O nome não pode conter espaços.

  7. Em Select instance configuration (Selecionar a configuração da instância), selecione uma combinação de unidades de CPU e memória (ambas 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, abra o menu de contexto (clique com o botão direito do mouse) e selecione 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.

  1. Para Select a connection (Selecionar uma conexão), escolha uma conexão que vincule o GitHub ao AWS. As conexões que estão disponíveis para seleção são listadas na página GitHub connections (Conexões do GitHub) no console do App Runner.

  2. Para Select a remote GitHub repository (Selecionar um repositório remoto do GitHub), escolha ou insira uma URL para o repositório remoto.

    Repositórios remotos que já estão configurados com gerenciamento de controle de fonte do AWS Cloud9 estão disponíveis para seleção. Se o repositório não estiver listado, você também poderá colar um link para o repositório.

  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 escolher Configure all settings here (Definir todas as configurações aqui), use o painel 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.

    • Comando Start: insira o comando para compilar a aplicação no ambiente do runtime da instância do serviço.

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

  6. (Opcional) Em Configure environment variables, (Configurar variáveis de ambiente), especifique um arquivo que contenha as variáveis de ambiente usadas para personalizar o comportamento na instância do serviço.

  7. Em Name your service (Fornecer nome ao serviço), insira um nome exclusivo e pressione Enter. O nome não pode conter espaços.

  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, abra o menu de contexto (clique com o botão direito do mouse) dele e selecione 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 informações de 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).