

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

# Configurando um serviço App Runner
<a name="manage-configure"></a>

Ao [criar um AWS App Runner serviço](manage-create.md), você define vários valores de configuração. Você pode alterar algumas dessas configurações depois de criar o serviço. Outras configurações podem ser aplicadas somente durante a criação do serviço e não podem ser alteradas posteriormente. Este tópico discute a configuração do seu serviço usando a API App Runner, o console do App Runner e um arquivo de configuração do App Runner.

**Topics**
+ [Configure seu serviço usando a API App Runner ou AWS CLI](#manage-configure.api)
+ [Configure seu serviço usando o console do App Runner](#manage-configure.console)
+ [Configure seu serviço usando um arquivo de configuração do App Runner](#manage-configure.file)
+ [Configurando a observabilidade para seu serviço](manage-configure-observability.md)
+ [Definindo as configurações do serviço usando recursos compartilháveis](manage-configure-resources.md)
+ [Configurando verificações de saúde para seu serviço](manage-configure-healthcheck.md)

## Configure seu serviço usando a API App Runner ou AWS CLI
<a name="manage-configure.api"></a>

A API define quais configurações podem ser alteradas após a criação do serviço. A lista a seguir discute as ações, tipos e limitações relevantes.
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)ação — Pode ser chamada após a criação para atualizar algumas configurações.
  + *Pode ser atualizado* — Você pode atualizar as configurações nos `HealthCheckConfiguration` parâmetros `SourceConfiguration``InstanceConfiguration`, e. No entanto`SourceConfiguration`, em, você não pode mudar seu tipo de fonte de código para imagem ou vice-versa. Você deve fornecer o mesmo parâmetro de repositório fornecido ao criar o serviço. É um `CodeRepository` ou outro`ImageRepository`.

    Você também pode atualizar os seguintes recursos ARNs de configuração separados associados ao serviço:
    + `AutoScalingConfigurationArn`
    + `VpcConnectorArn`
  + *Não pode ser atualizado* — Você não pode alterar os `EncryptionConfiguration` parâmetros `ServiceName` e que estão disponíveis na [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)ação. Eles não podem ser alterados após serem criados. A [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)ação não inclui esses parâmetros.
  + *API versus arquivo* — Você pode definir o `ConfigurationSource` parâmetro do [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)tipo (usado para repositórios de código-fonte como parte de`SourceConfiguration`) como. `Repository` Nesse caso, o App Runner ignora as configurações e as lê em `CodeConfigurationValues` um [arquivo de configuração](config-file.md) no seu repositório. Se você `ConfigurationSource` definir como`API`, o App Runner obtém todas as configurações da chamada da API e ignora o arquivo de configuração, mesmo que exista um.
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)ação — Pode ser chamada após a criação do serviço para adicionar tags ao serviço ou atualizar valores de tags existentes.
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)ação — Pode ser chamada após a criação do serviço para remover as tags do serviço.

**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](network-vpc.md#network-vpc.VPC-connector.latency) o capítulo *Networking with App Runner* deste guia.

## Configure seu serviço usando o console do App Runner
<a name="manage-configure.console"></a>

O console usa a API App Runner para aplicar atualizações de configuração. As regras de atualização impostas pela API, conforme definido na seção anterior, determinam o que você pode configurar usando o console. Algumas configurações que estavam disponíveis durante a criação do serviço não estão disponíveis para modificação posterior. Além disso, se você decidir usar um [arquivo de configuração](config-file.md), configurações adicionais ficarão ocultas no console e o App Runner as lerá a partir do arquivo.

**Para configurar seu serviço**

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**.  
![Página do painel do serviço App Runner mostrando a lista de atividades](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/console-dashboard.png)

1. Na página do painel do serviço, escolha a guia **Configuração**.

   Resultado: o console exibe as configurações atuais do seu serviço em várias seções: **Origem e implantação**, **Configurar compilação** e **Configurar serviço**.

1. Para atualizar as configurações em qualquer categoria, escolha **Editar**.

1. Na página de edição de configuração, faça as alterações desejadas e escolha **Salvar alterações**.

**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](network-vpc.md#network-vpc.VPC-connector.latency) o capítulo *Networking with App Runner* deste guia.

## Configure seu serviço usando um arquivo de configuração do App Runner
<a name="manage-configure.file"></a>

Ao criar ou atualizar um serviço do App Runner, você pode instruir o App Runner a ler algumas definições de configuração de um arquivo de configuração que você fornece como parte do seu repositório de origem. Ao fazer isso, você pode gerenciar as configurações relacionadas ao seu código-fonte sob controle de origem, junto com o próprio código. O arquivo de configuração também fornece algumas configurações avançadas que você não pode definir usando o console ou a API. Para obter mais informações, consulte [Definindo as opções do serviço App Runner usando um arquivo de configuração](config-file.md).

**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](network-vpc.md#network-vpc.VPC-connector.latency) o capítulo *Networking with App Runner* deste guia.