Personalização avançada de ambiente com arquivos de configuração (.ebextensions) - AWS Elastic Beanstalk

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

Personalização avançada de ambiente com arquivos de configuração (.ebextensions)

Você pode adicionar arquivos de AWS Elastic Beanstalk configuração (.ebextensions) ao código-fonte do seu aplicativo web para configurar seu ambiente e personalizar os AWS recursos que ele contém. Os arquivos de configuração são documentos no formato YAML ou JSON com uma extensão de .config arquivo que você coloca em uma pasta chamada .ebextensions e implanta no pacote de origem do aplicativo.

exemplo
.ebextensions/ .config network-load-balancer

Este exemplo facilita uma alteração de configuração. Ele modifica uma opção de configuração para definir o tipo de balanceador de carga do ambiente como Network Load Balancer.

option_settings:
  aws:elasticbeanstalk:environment:
    LoadBalancerType: network

Recomendamos usar o YAML para seus arquivos de configuração, pois é mais legível do que o JSON. YAML é compatível com comentários, comandos de várias linhas, várias alternativas para usar aspas e muito mais. No entanto, é possível fazer qualquer alteração de configuração em arquivos de configuração do Elastic Beanstalk de forma idêntica usando YAML ou JSON.

Dica

Quando você estiver desenvolvendo ou testando novos arquivos de configuração, inicie um ambiente limpo executando o aplicativo padrão e implante nele. Arquivos de configuração formatados incorretamente causarão falha irrecuperável do início de um novo ambiente.

A seção option_settings de um arquivo de configuração define valores para as opções de configuração. As opções de configuração permitem que você configure seu ambiente do Elastic Beanstalk AWS , os recursos nele contidos e o software que executa seu aplicativo. Os arquivos de configuração são apenas uma das várias maneiras de definir as opções de configuração.

A Resourcesseção permite que você personalize ainda mais os recursos no ambiente do seu aplicativo e defina AWS recursos adicionais além da funcionalidade fornecida pelas opções de configuração. Você pode adicionar e configurar qualquer recurso suportado pelo AWS CloudFormation, que o Elastic Beanstalk usa para criar ambientes.

As outras seções do arquivo de configuração (packages, sources, files, users, groups, commands, container_commandse services) permitem configurar as instâncias do EC2 que são iniciadas no ambiente. Sempre que um servidor é iniciado no ambiente, o Elastic Beanstalk executa as operações definidas nessas seções para preparar o sistema operacional e o sistema de armazenamento para a aplicação.

Para obter exemplos de .ebextensions usados com frequência, consulte os Arquivos de configuração do repositório do Elastic Beanstalk.

Requisitos

  • Localização — O Elastic Beanstalk .ebextensions processará todas as pastas presentes na sua implantação. No entanto, recomendamos que você coloque todos os seus arquivos de configuração em uma única pasta, chamada.ebextensions, na raiz do pacote de origem. Pastas que começam com um ponto podem ser ocultas por navegadores de arquivos, portanto, certifique-se de que a pasta é adicionada quando você criar seu pacote de origem. Para ter mais informações, consulte Criar um pacote de origem do aplicativo.

  • Nomenclatura: os arquivos de configuração devem ter a extensão de arquivo .config.

  • Formatação: os arquivos de configuração devem ser compatíveis com as especificações de YAML ou JSON.

    Ao usar o YAML, sempre use espaços para recuar as chaves em diferentes níveis de aninhamento. Para obter mais informações sobre YAML, consulte YAML Ain't Markup Language (YAML™) versão 1.1.

  • Exclusividade: use cada chave somente uma vez em cada arquivo de configuração.

    Aviso

    Se você usar uma chave (por exemplo, option_settings) duas vezes no mesmo arquivo de configuração, uma das seções será descartada. Combine seções duplicadas em uma única seção ou coloque-as em arquivos de configuração separados.

O processo de implantação varia ligeiramente, dependendo do cliente que você usa para gerenciar seus ambientes. Para detalhes, consulte estas seções:

Tópicos