Criação de um serviço App Runner - AWS App Runner
Pré-requisitosCriar um serviço

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

Criação de um serviço App Runner

AWS App Runner automatiza a transição de uma imagem de contêiner ou de um repositório de código-fonte para um serviço web em execução que se expande automaticamente. Você aponta o App Runner para sua imagem ou código de origem, especificando apenas um pequeno número de configurações necessárias. O App Runner cria seu aplicativo, se necessário, provisiona recursos computacionais e implanta seu aplicativo para ser executado neles.

Quando você cria um serviço, o App Runner cria um recurso de serviço. Em alguns casos, talvez seja necessário fornecer um recurso de conexão. Se você usa o console do App Runner, o console cria implicitamente o recurso de conexão. Para obter mais informações sobre os tipos de recursos do App Runner, consulteRecursos do App Runner. Esses tipos de recursos têm cotas associadas à sua conta em cada um Região da AWS. Para obter mais informações, consulte Cotas de recursos do App Runner.

Há diferenças sutis no procedimento de criação de um serviço, dependendo do tipo de fonte e do provedor. Este tópico aborda diferentes procedimentos para criar esses tipos de fonte para que você possa seguir o que for adequado à sua situação. Para iniciar um procedimento básico com um exemplo de código, consulteIntrodução ao App Runner.

Pré-requisitos

Antes de criar seu serviço App Runner, certifique-se de concluir as seguintes ações:

Criar um serviço

Esta seção mostra o processo de criação dos dois tipos de serviço do App Runner: com base no código-fonte e com base em uma imagem de contêiner.

nota

Se você criar um conector VPC de tráfego de saída para um serviço, o processo de inicialização do serviço a seguir terá uma latência única. Você pode definir essa configuração para um novo serviço ao criá-lo, ou posteriormente, com uma atualização de serviço. Para obter mais informações, consulte Latência única o capítulo Networking with App Runner deste guia.

As seções a seguir mostram como criar um serviço App Runner quando sua fonte é um repositório de código no Bitbucket GitHubou no Bitbucket. Quando você usa um repositório de código, o App Runner precisa se conectar à organização ou conta do provedor. Portanto, você precisa ajudar a estabelecer essa conexão. Para obter mais informações sobre as conexões do App Runner, consulteGerenciando conexões do App Runner.

Quando você cria o serviço, o App Runner cria uma imagem do Docker que contém o código e as dependências do seu aplicativo. Em seguida, ele inicia um serviço que executa uma instância de contêiner dessa imagem.

Criação de um serviço a partir do código usando o console do App Runner

Para criar um serviço App Runner usando o console

  1. Configure seu código-fonte.

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

    2. Se Conta da AWS ainda não tiver nenhum serviço do App Runner, a página inicial do console será exibida. Escolha Criar um serviço App Runner.

      Página inicial do console do App Runner mostrando o botão criar serviço

      Se tiver serviços existentes, a página Serviços com uma lista de seus serviços será exibida. Conta da AWS Escolha Create service.

      Página de serviços do console App Runner

    3. Na página Fonte e implantação, na seção Fonte, em Tipo de repositório, escolha Repositório de código-fonte.

    4. Selecione um tipo de provedor. Escolha um GitHubou o Bitbucket.

    5. Em seguida, selecione uma conta ou organização para o provedor que você já usou antes ou escolha Adicionar novo. Em seguida, passe pelo processo de fornecer suas credenciais de repositório de código e escolher uma conta ou organização à qual se conectar.

    6. Em Repositório, selecione o repositório que contém o código do seu aplicativo.

    7. Em Branch, selecione a ramificação que você deseja implantar.

    8. Em Diretório de origem, insira o diretório no repositório de origem que armazena o código do aplicativo e os arquivos de configuração.

      nota

      Os comandos build e start são executados no diretório de origem que você especificar. O App Runner trata o caminho como absoluto a partir da raiz. Se você não especificar um valor aqui, o diretório usará como padrão a raiz do repositório.

  2. Configure suas implantações.

    1. Na seção Configurações de implantação, escolha Manual ou Automático.

      Para obter mais informações sobre métodos de implantação, consulteMétodos de implantação.

    2. Escolha Próximo.

    Configurações de origem e implantação ao criar um serviço App Runner

  3. Configure a compilação do aplicativo.

    1. Na página Configurar compilação, em Arquivo de configuração, escolha Definir todas as configurações aqui se o seu repositório não contiver um arquivo de configuração do App Runner ou Usar um arquivo de configuração se tiver.

      nota

      Um arquivo de configuração do App Runner é uma forma de manter sua configuração de compilação como parte da fonte do aplicativo. Quando você fornece um, o App Runner lê alguns valores do arquivo e não permite que você os defina no console.

    2. Forneça as seguintes configurações de compilação:

      • Tempo de execução — Escolha um tempo de execução gerenciado específico para seu aplicativo.

      • Comando de compilação — insira um comando que compila seu aplicativo a partir do código-fonte. Isso pode ser uma ferramenta específica do idioma ou um script fornecido com seu código.

      • Comando Iniciar — Insira o comando que inicia seu serviço web.

      • Porta — Insira a porta IP que seu serviço web escuta.

    3. Escolha Próximo.

    Crie configurações ao criar um serviço App Runner

  4. Configure seu serviço.

    1. Na página Configurar serviço, na seção Configurações do serviço, insira um nome de serviço.

      nota

      Todas as outras configurações de serviço são opcionais ou têm padrões fornecidos pelo console.

    2. Opcionalmente, altere ou adicione outras configurações para atender aos requisitos do seu aplicativo.

    3. Escolha Próximo.

    Configurações de serviço ao criar um serviço App Runner

  5. Na página Revisar e criar, verifique todos os detalhes inseridos e escolha Criar e implantar.

    Resultado: se o serviço for criado com êxito, o console exibirá o painel de serviços com uma visão geral do novo serviço.

    Página do painel do serviço App Runner

  6. Verifique se o serviço está em execução.

    1. Na página do painel do serviço, aguarde até que o status do serviço esteja em execução.

    2. Escolha o valor do domínio padrão. É a URL do site do seu serviço.

    3. Use seu site e verifique se ele está funcionando corretamente.

Criar um serviço a partir do código usando a API App Runner ou AWS CLI

Para criar um serviço usando a API App Runner ou AWS CLI chame a ação da CreateService API. Para obter mais informações e um exemplo, consulte CreateService. Se for a primeira vez que você está criando um serviço usando uma organização ou conta específica para um repositório de código-fonte (GitHub ou Bitbucket), comece ligando. CreateConnection Isso estabelece uma conexão entre o App Runner e a organização ou conta do provedor do repositório. Para obter mais informações sobre as conexões do App Runner, consulteGerenciando conexões do App Runner.

Se a chamada retornar uma resposta bem-sucedida com a exibição de um objeto Service"Status": "CREATING", seu serviço começará a ser criado.

Para ver um exemplo de chamada, consulte Criar um serviço de repositório de código-fonte na Referência da AWS App Runner API

As seções a seguir mostram como criar um serviço App Runner quando sua fonte é uma imagem de contêiner armazenada no Amazon ECR. O Amazon ECR é um AWS service (Serviço da AWS). Portanto, para criar um serviço baseado em uma imagem do Amazon ECR, você fornece ao App Runner uma função de acesso contendo as permissões de ação do Amazon ECR necessárias.

nota

As imagens armazenadas no Amazon ECR Public estão disponíveis publicamente. Portanto, se sua imagem estiver armazenada no Amazon ECR Public, não é necessária uma função de acesso.

Quando seu serviço está sendo criado, o App Runner inicia um serviço que executa uma instância de contêiner da imagem que você fornece. Não há fase de construção neste caso.

Para obter mais informações, consulte Serviço App Runner baseado em uma imagem de origem.

Criação de um serviço a partir de uma imagem usando o console do App Runner

Para criar um serviço App Runner usando o console

  1. Configure seu código-fonte.

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

    2. Se Conta da AWS ainda não tiver nenhum serviço do App Runner, a página inicial do console será exibida. Escolha Criar um serviço App Runner.

      Página inicial do console do App Runner mostrando o botão criar serviço

      Se tiver serviços existentes, a página Serviços com uma lista de seus serviços será exibida. Conta da AWS Escolha Create service.

      Página de serviços do console App Runner

    3. Na página Origem e implantação, na seção Fonte, em Tipo de repositório, escolha Registro de contêiner.

    4. Para Provedor, escolha o provedor em que sua imagem está armazenada:

      • Amazon ECR — Uma imagem privada armazenada no Amazon ECR.

      • Amazon ECR Public — Uma imagem publicamente legível que é armazenada no Amazon ECR Public.

    5. Em URI da imagem do contêiner, escolha Procurar.

    6. Na caixa de diálogo Selecionar imagem de contêiner do Amazon ECR, em Repositório de imagens, selecione o repositório que contém sua imagem.

    7. Em Tag de imagem, selecione a tag de imagem específica que você deseja implantar (por exemplo, a mais recente) e escolha Continuar.

    Selecionar uma imagem do Amazon ECR ao criar um serviço App Runner

  2. Configure suas implantações.

    1. Na seção Configurações de implantação, escolha Manual ou Automático.

      nota

      O App Runner não oferece suporte à implantação automática para imagens públicas do Amazon ECR e para imagens em um repositório do Amazon ECR que pertença a uma AWS conta diferente daquela em que seu serviço está.

      Para obter mais informações sobre métodos de implantação, consulteMétodos de implantação.

    2. [Provedor Amazon ECR] Para a função de acesso ao ECR, escolha uma função de serviço existente em sua conta ou escolha criar uma nova função. Se você estiver usando a implantação manual, também poderá optar por usar a função de usuário do IAM no momento da implantação.

    3. Escolha Próximo.

    Configurações de origem e implantação ao criar um serviço App Runner

  3. Configure seu serviço.

    1. Na página Configurar serviço, na seção Configurações do serviço, insira o nome do serviço e a porta IP que o site do serviço escuta.

      nota

      Todas as outras configurações de serviço são opcionais ou têm padrões fornecidos pelo console.

    2. (Opcional) Altere ou adicione outras configurações para atender às necessidades do seu aplicativo.

    3. Escolha Próximo.

    Configurações de serviço ao criar um serviço App Runner

  4. Na página Revisar e criar, verifique todos os detalhes que você inseriu e escolha Criar e implantar.

    Resultado: se o serviço for criado com êxito, o console mostrará o painel do serviço, com uma visão geral do novo serviço.

    Página do painel do serviço App Runner

  5. Verifique se o serviço está em execução.

    1. Na página do painel do serviço, aguarde até que o status do serviço esteja em execução.

    2. Escolha o valor do domínio padrão. É a URL do site do seu serviço.

    3. Use seu site e verifique se ele está funcionando corretamente.

Criar um serviço a partir de uma imagem usando a API App Runner ou AWS CLI

Para criar um serviço usando a API App Runner ou AWS CLI chame a ação da CreateServiceAPI.

A criação do serviço começa se a chamada retornar uma resposta bem-sucedida com a exibição de um objeto Service"Status": "CREATING".

Para ver um exemplo de chamada, consulte Criar um serviço de repositório de imagens de origem na Referência da AWS App Runner API