Definir as opções de configuração durante a criação do ambiente

Quando você cria um ambiente do AWS Elastic Beanstalk usando o console do Elastic Beanstalk, a EB CLI, a AWS CLI, um SDK ou a API do Elastic Beanstalk, pode especificar valores para as opções de configuração a fim de personalizar o ambiente e os recursos da AWS que são iniciados nele.

Para qualquer outro fim que não seja uma alteração de configuração isolada, é possível armazenar os arquivos de configuração localmente, em seu pacote de origem ou no Amazon S3.

Este tópico inclui procedimentos para todos os métodos de definição de opções de configuração durante a criação do ambiente.

No console do Elastic Beanstalk

Ao criar um ambiente do Elastic Beanstalk no console do Elastic Beanstalk, é possível especificar as opções de configuração usando os arquivos de configuração, as configurações salvas e os formulários no assistente Create New Environment (Criar novo ambiente).

Métodos

• Usar arquivos de configuração (.ebextensions)
• Usar uma configuração salva
• Usar o assistente de novo ambiente

Usar arquivos de configuração (.ebextensions)

Inclua os arquivos .config em seu pacote de origem do aplicativo em uma pasta chamada .ebextensions.

Para obter detalhes sobre arquivos de configuração, consulte .Ebextensions.

~/workspace/my-app-v1.zip
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- index.php
`-- styles.css

Faça upload do pacote de origem para o Elastic Beanstalk normalmente, durante a criação do ambiente.

O console do Elastic Beanstalk aplica valores recomendados a algumas opções de configuração e tem campos de formulário para outras. As opções configuradas pelo console do Elastic Beanstalk são aplicadas diretamente ao ambiente e substituem aquelas nos arquivos de configuração.

Usar uma configuração salva

Quando você cria um novo ambiente usando o console do Elastic Beanstalk, uma das primeiras etapas é escolher uma configuração. A configuração pode ser uma predefined configuration (configuração predefinida), normalmente a versão mais recente de uma Plataforma, como o PHP ou o Tomcat, ou pode ser uma saved configuration (configuração salva).

Como aplicar uma configuração salva durante a criação do ambiente (console do Elastic Beanstalk)

1. Abra o console do Elastic Beanstalk e, na lista Regions (Regiões), selecione a sua Região da AWS.

2. No painel de navegação, selecione Aplicativos e escolha o nome do aplicativo na lista.

   nota

   Se você tiver muitos aplicativos, use a barra de pesquisa para filtrar a lista de aplicativos.

3. No painel de navegação, encontre o nome do aplicativo e escolha Saved configurations (Configurações salvas).

4. Selecione a configuração salva que deseja aplicar e escolha Launch environment (Iniciar ambiente).

5. Continue no assistente para criar seu ambiente.

As configurações salvas são específicas ao aplicativo. Consulte Configurações salvas para obter detalhes sobre como criar configurações salvas.

Usar o assistente de novo ambiente

A maioria das opções de configuração padrão estão disponíveis na página Configure more options (Configurar mais opções) do Assistente de configuração de novo ambiente. Se você criar um banco de dados do Amazon RDS ou configurar uma VPC para o ambiente, as opções de configuração adicionais estarão disponíveis nas páginas desses recursos.

Como definir opções de configuração durante a criação do ambiente (console do Elastic Beanstalk)

1. Abra o console do Elastic Beanstalk e, na lista Regions (Regiões), selecione a sua Região da AWS.

2. No painel de navegação, escolha Applications (Aplicativos).

3. Selecione ou crie um aplicativo.

4. Escolha Actions (Ações) e Create environment (Criar ambiente).

5. Continue no assistente e escolha Configure more options (Configurar mais opções).

6. Escolha qualquer uma das configuration presets (predefinições da configuração) e escolha Edit (Editar) em uma ou mais das categorias de configuração para alterar um grupo de opções de configuração relacionado.

7. Ao concluir as seleções das opções, escolha Create environment (Criar ambiente).

Todas as opções que você definir no assistente de novo ambiente serão definidas diretamente no ambiente e substituirão qualquer configuração de opção nas configurações salvas ou nos arquivos de configuração (.ebextensions) que você aplicar. Você poderá remover as configurações após a criação do ambiente usando a EB CLI ou a AWS CLI para permitir que as definições nas configurações salvas ou nos arquivos de configuração sejam exibidas.

Para obter detalhes sobre o novo assistente de ambiente, consulte O assistente de criação de novo ambiente.

Uso da EB CLI

Métodos

• Usar arquivos de configuração (.ebextensions)
• Usar as configurações salvas
• Usar as opções de linha de comando

Usar arquivos de configuração (.ebextensions)

Inclua os arquivos .config na pasta do seu projeto em .ebextensions para implantá-los com o código do seu aplicativo.

Para obter detalhes sobre arquivos de configuração, consulte .Ebextensions.

~/workspace/my-app/
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- .elasticbeanstalk
|   `-- config.yml
|-- index.php
`-- styles.css

Crie seu ambiente e implante o código-fonte nele com eb create.

~/workspace/my-app$ eb create my-env

Usar as configurações salvas

Para aplicar uma configuração salva ao criar um ambiente com eb create, use a opção --cfg.

~/workspace/my-app$ eb create --cfg savedconfig

É possível armazenar a configuração salva na pasta do projeto ou no local de armazenamento do Elastic Beanstalk no Amazon S3. No exemplo anterior, a EB CLI primeiro procura um arquivo de configuração salvo chamado savedconfig.cfg.yml na pasta .elasticbeanstalk/saved_configs/. Não inclua as extensões de arquivo (.cfg.yml) ao aplicar uma configuração salva com --cfg.

~/workspace/my-app/
|-- .ebextensions
|   `-- healthcheckurl.config
|-- .elasticbeanstalk
|   |-- saved_configs
|   |   `-- savedconfig.cfg.yml
|   `-- config.yml
|-- index.php
`-- styles.css

Se a CLI do EB não encontrar a configuração localmente, ela verificará no local de armazenamento do Elastic Beanstalk no Amazon S3. Para obter detalhes sobre como criar, editar, e fazer upload das configurações salvas, consulte Configurações salvas.

Usar as opções de linha de comando

O comando eb create da EB CLI tem várias opções que você pode usar para definir as opções de configuração durante a criação do ambiente. Você pode usar essas opções para adicionar um banco de dados do RDS a seu ambiente, configurar uma VPC ou substituir os valores recomendados.

Por exemplo, a EB CLI usa o tipo de instância t2.micro por padrão. Para escolher um tipo de instância diferente, use a opção --instance_type.

$ eb create my-env --instance_type t2.medium

Para criar uma instância de banco de dados do Amazon RDS e anexá-la ao ambiente, use as opções --database.

$ eb create --database.engine postgres --database.username dbuser

Se você não inserir o nome do ambiente, a senha do banco de dados ou qualquer outro parâmetro necessário para criar o ambiente, a EB CLI solicitará que você os insira.

Consulte eb create para obter uma lista completa de opções disponíveis e exemplos de uso.

Usando o AWS CLI

Quando você usa o comando create-environment para criar um ambiente do Elastic Beanstalk com a AWS CLI, a AWS CLI não aplica nenhum valor recomendado. Todas as opções de configuração são definidas nos arquivos de configuração no pacote de origem especificado por você.

Métodos

• Usar arquivos de configuração (.ebextensions)
• Usar uma configuração salva
• Usar as opções de linha de comando

Usar arquivos de configuração (.ebextensions)

Para aplicar os arquivos de configuração a um ambiente criado com a AWS CLI, inclua-os no pacote de fonte da aplicação do qual fará upload para o Amazon S3.

Para obter detalhes sobre arquivos de configuração, consulte .Ebextensions.

~/workspace/my-app-v1.zip
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- index.php
`-- styles.css

Para fazer upload de um pacote de fonte da aplicação e criar um ambiente com a AWS CLI

1. Se você ainda não tiver um bucket do Elastic Beanstalk no Amazon S3, crie um com create-storage-location.

   $ aws elasticbeanstalk create-storage-location
   {
       "S3Bucket": "elasticbeanstalk-us-west-2-123456789012"
   }

2. Faça upload do pacote de origem da aplicação para o Amazon S3.

   $ aws s3 cp sourcebundle.zip s3://elasticbeanstalk-us-west-2-123456789012/my-app/sourcebundle.zip

3. Crie a versão do aplicativo.

   $ aws elasticbeanstalk create-application-version --application-name my-app --version-label v1 --description MyAppv1 --source-bundle S3Bucket="elasticbeanstalk-us-west-2-123456789012",S3Key="my-app/sourcebundle.zip" --auto-create-application

4. Criar o ambiente

   $ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"

Usar uma configuração salva

Para aplicar uma configuração salva a um ambiente durante a criação, use o parâmetro --template-name.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --template-name savedconfig --version-label v1

Quando você especificar uma configuração salva, não especifique também o nome da pilha da solução. As configurações salvas já especificam uma pilha da soluções, e o Elastic Beanstalk retornará um erro se você tentar usar as duas opções.

Usar as opções de linha de comando

Use o parâmetro --option-settings para especificar as opções de configuração no formato JSON.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings '[
  {
    "Namespace": "aws:elasticbeanstalk:application",
    "OptionName": "Application Healthcheck URL",
    "Value": "/health"
  }
]

Para carregar o JSON de um arquivo, use o prefixo file://.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings file://healthcheckurl.json

O Elastic Beanstalk aplica as configurações de opção especificadas com a opção --option-settings diretamente ao ambiente. Se as mesmas opções forem especificadas em uma configuração salva ou arquivo de configuração, --option-settings substituirá esses valores.