Criar serviços do App Runner - AWS Kit de ferramentas para VS Code

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

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 IAM permissões relevantes e confirmar o repositório de origem 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. Em Selecionar um tipo de localização do código-fonte, escolha ECRRepositório.

    Se você escolher ECR, você especifica 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.

  1. Em Selecionar ou inserir um repositório de imagens, escolha ou entre no repositório URL de imagens que é mantido pelo seu registro ECR privado da Amazon ou pela Amazon ECR Public Gallery.

    nota

    Se você especificar um repositório da Amazon ECR Public Gallery, certifique-se de que as implantações automáticas estejam desativadas porque o App Runner não suporta implantações automáticas para uma imagem em um repositório público. 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 ECR privado da Amazon, precisará da função de ECR acesso AppRunnerECRAccessRole, que permite que o App Runner acesse imagens do Amazon Elastic Container Registry (AmazonECR) em sua conta. Escolha o ícone “+” no cabeçalho da paleta de comandos para criar automaticamente essa função. (Não é necessária uma função de acesso se sua imagem estiver armazenada no Amazon ECR Public, onde as imagens estão disponíveis publicamente.)

  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. Em Selecionar configuração da instância, escolha uma combinação de CPU unidades e memória em GB para sua instância de serviço.

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

  8. Depois que seu serviço começar a ser executado, clique com o botão direito nele e escolha Copiar serviço URL.

  9. Para acessar seu aplicativo implantado, cole a cópia URL na barra de endereço do seu navegador.

  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 um 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. Em Selecionar configuração da instância, escolha uma combinação de CPU unidades e memória em GB para sua instância de serviço.

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

  9. Depois que seu serviço começar a ser executado, clique com o botão direito nele e escolha Copiar serviço URL.

  10. Para acessar seu aplicativo implantado, cole a cópia URL na barra de endereço do seu navegador.

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