Implantando uma nova versão do aplicativo no App Runner

Ao criar um serviço em AWS App Runner, você configura uma fonte de aplicativo — uma imagem de contêiner ou um repositório de origem. O App Runner provisiona recursos para executar seu serviço e implanta seu aplicativo neles.

Este tópico descreve maneiras de reimplantar a fonte do aplicativo no serviço App Runner quando uma nova versão estiver disponível. Isso pode ser uma nova versão de imagem no repositório de imagens ou um novo commit no repositório de código. O App Runner fornece dois métodos de implantação em um serviço: automático e manual.

Métodos de implantação

O App Runner fornece os seguintes métodos para você controlar como as implantações de aplicativos são iniciadas.

Implantação automática

Use a implantação automática quando quiser um comportamento de integração e implantação contínuas (CI/CD) para seu serviço. O App Runner monitora alterações em seu repositório de imagens ou códigos.

Repositório de imagens — Sempre que você envia uma nova versão de imagem para seu repositório de imagens ou uma nova confirmação para seu repositório de código, o App Runner a implanta automaticamente em seu serviço sem nenhuma ação adicional de sua parte.

Repositório de código — Sempre que você envia um novo commit para seu repositório de código que faz alterações no diretório de origem, o App Runner implanta todo o repositório. Como somente as alterações no diretório de origem acionam uma implantação automática, é importante entender como a localização do diretório de origem afeta o escopo de uma implantação automatizada.

• Diretório de nível superior (raiz do repositório) — Esse é o valor padrão definido para o diretório de origem quando você cria um serviço. Se seu diretório de origem estiver definido com esse valor, isso significa que todo o repositório está dentro do diretório de origem. Portanto, todos os commits enviados para o repositório de origem acionarão uma implantação nesse caso.

• Qualquer caminho de diretório que não seja a raiz do repositório (não padrão) — Como somente as alterações enviadas ao diretório de origem acionarão uma implantação automática, quaisquer alterações enviadas ao seu repositório que não estejam no diretório de origem não acionarão uma implantação automática. Portanto, você deve usar uma implantação manual para implantar as alterações que você envia para fora do diretório de origem.

nota

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

Implantação manual

Use a implantação manual quando quiser iniciar explicitamente cada implantação em seu serviço. Você inicia uma implantação se o repositório que você configurou para seu serviço tiver uma nova versão que você deseja implantar. Para obter mais informações, consulte Implantação manual.

nota

Quando você executa uma implantação manual, o App Runner implanta a fonte do repositório completo.

Você pode configurar o método de implantação do seu serviço das seguintes maneiras:

• Console — Para um novo serviço que você está criando ou para um serviço existente, na seção Configurações de implantação da página de configuração de origem e implantação, escolha Manual ou Automático.

  

• APIou AWS CLI — Em uma chamada para a UpdateServiceação CreateServiceou, defina o AutoDeploymentsEnabled membro do SourceConfigurationparâmetro como False para implantação manual ou True para implantação automática.

Comparando implantações automáticas e manuais

As implantações automáticas e manuais produzem o mesmo resultado: os dois métodos implantam o repositório completo.

A diferença entre os dois métodos é o mecanismo de acionamento:

• As implantações manuais são acionadas por uma implantação do console, uma chamada para o AWS CLI ou uma chamada para o App API Runner. A Implantação manual seção a seguir fornece os procedimentos para isso.

• As implantações automáticas são acionadas por uma alteração no conteúdo do diretório de origem.

Implantação manual

Com a implantação manual, você precisa iniciar explicitamente cada implantação em seu serviço. Quando você tiver uma nova versão da imagem ou do código do seu aplicativo pronta para implantação, consulte as seções a seguir para saber como realizar uma implantação usando o console e API o.

nota

Quando você executa uma implantação manual, o App Runner implanta a fonte do repositório completo.

Implante uma versão do seu aplicativo usando um dos seguintes métodos:

App Runner console

Para implantar usando o console do App Runner

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 Serviços e, em seguida, escolha seu serviço App Runner.

   O console exibe o painel do serviço com uma visão geral do serviço.

   

3. Escolha Implantar.

   Resultado: a implantação da nova versão é iniciada. Na página do painel do serviço, o status do serviço muda para Operação em andamento.

4. Aguarde o término da implantação. Na página do painel do serviço, o status do serviço deve voltar para Em execução.

5. Para verificar se a implantação foi bem-sucedida, na página do painel do serviço, escolha o valor do domínio padrão — é o URL do site do seu serviço. Inspecione ou interaja com seu aplicativo web e verifique sua alteração de versão.

   nota

   Para aumentar a segurança de seus aplicativos App Runner, o domínio*.awsapprunner.com é registrado na Lista pública de sufixos (). PSL Para maior segurança, recomendamos que você use cookies com um __Host- prefixo se precisar definir cookies confidenciais no nome de domínio padrão para seus aplicativos App Runner. Essa prática ajudará a defender seu domínio contra tentativas de falsificação de solicitações entre sites ()CSRF. Para obter mais informações, consulte a página Set-Cookie na Mozilla Developer Network.

App Runner API or AWS CLI

Para implantar usando o App Runner API ou AWS CLI, chame a StartDeploymentAPIação. O único parâmetro a ser passado é seu serviçoARN. Você já configurou o local de origem do aplicativo quando criou o serviço, e o App Runner pode encontrar a nova versão. Sua implantação será iniciada se a chamada retornar uma resposta bem-sucedida.