AWS App Runner não está mais aberto a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Mudança de disponibilidade do AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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á.
# Implantando uma nova versão do aplicativo no App Runner
Ao [criar um serviço](manage-create.md) 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](service-source-code.md#service-source-code.source-directory), 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.
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á.
**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](#manage-deploy.manual).
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**.
+ *API ou AWS CLI* — Em uma chamada para a [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)ação [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)ou, defina o `AutoDeploymentsEnabled` membro do [SourceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_SourceConfiguration.html)parâmetro como `False` para implantação manual ou `True` 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 a AWS CLI ou uma chamada para a API App Runner. A [Implantação manual](#manage-deploy.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](service-source-code.md#service-source-code.source-directory).
## 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 ser implantada, consulte as seções a seguir para saber como realizar uma implantação usando o console e a API.
**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](https://console.aws.amazon.com/apprunner) e, na lista **Regiões**, selecione seu Região da AWS.
1. 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**.
1. 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**.
1. 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**.
1. 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** — é a 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).](https://publicsuffix.org/) 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ção entre sites (CSRF). Para obter mais informações, consulte a página [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) na Mozilla Developer Network.
------
#### [ App Runner API or AWS CLI ]
Para implantar usando a API App Runner ou AWS CLI, chame a ação da [StartDeployment](https://docs.aws.amazon.com/apprunner/latest/api/API_StartDeployment.html)API. O único parâmetro a ser passado é o ARN do serviço. 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 começa se a chamada retornar uma resposta bem-sucedida.
------