Configurando um serviço App Runner - AWS App Runner
Configure seu serviço usando a API App Runner ou AWS CLIConfigure seu serviço usando o console do App RunnerConfigure seu serviço usando um arquivo de configuração do App Runner

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

Ao criar um AWS App Runner serviço, 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.

Tópicos

Configure seu serviço usando a API App Runner ou AWS CLI

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, os tipos e as limitações relevantes.

  • UpdateServiceaçã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 SourceConfigurationInstanceConfiguration, e. No entantoSourceConfiguration, 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 outroImageRepository.

      Você também pode atualizar os seguintes ARNs de recursos 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 CreateServiceação. Eles não podem ser alterados após serem criados. A UpdateServiceação não inclui esses parâmetros.

    • API versus arquivo — Você pode definir o ConfigurationSource parâmetro do CodeConfigurationtipo (usado para repositórios de código-fonte como parte deSourceConfiguration) como. Repository Nesse caso, o App Runner ignora as configurações e as lê em CodeConfigurationValues um arquivo de configuração no seu repositório. Se você ConfigurationSource definir comoAPI, o App Runner obtém todas as configurações da chamada da API e ignora o arquivo de configuração, mesmo que exista um.

  • TagResourceação — Pode ser chamada após a criação do serviço para adicionar tags ao serviço ou atualizar valores de tags existentes.

  • UntagResourceaçã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 o capítulo Networking with App Runner deste guia.

Configure seu serviço usando o console do App Runner

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, as 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 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.

    Página do painel do serviço App Runner mostrando a lista de atividades

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

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

  5. 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 o capítulo Networking with App Runner deste guia.

Configure seu serviço usando um arquivo de configuração do App Runner

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 o controle do código-fonte, 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 ter mais informações, consulte Definindo as opções do serviço App Runner usando um arquivo de configuraçã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 o capítulo Networking with App Runner deste guia.