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á. # Definir as opções de configuração durante a criação do ambiente Durante a criação Ao criar um AWS Elastic Beanstalk ambiente usando o console do Elastic Beanstalk, o EB AWS CLI CLI, um SDK ou a API do Elastic Beanstalk, você pode fornecer valores para as opções de configuração para personalizar seu ambiente e os recursos que são lançados nele. AWS Para qualquer outro fim que não seja uma alteração de configuração isolada, é possível [armazenar os arquivos de configuração](environment-configuration-methods-before.md) 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. **Topics** + [ ## No console do Elastic Beanstalk ](#configuration-options-during-console) + [ ## Uso da EB CLI ](#configuration-options-during-ebcli) + [ ## Usando o AWS CLI ](#configuration-options-during-awscli) ## 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)**. **Topics** + [ ### Usar arquivos de configuração (`.ebextensions`) ](#configuration-options-during-console-ebextensions) + [ ### Usar uma configuração salva ](#configuration-options-during-console-savedconfig) + [ ### Usar o assistente de novo ambiente ](#configuration-options-during-console-wizard) ### Usar arquivos de configuração (`.ebextensions`) Inclua os arquivos `.config` em seu [pacote de origem do aplicativo](applications-sourcebundle.md) em uma pasta chamada `.ebextensions`. Para obter detalhes sobre arquivos de configuração, consulte [.Ebextensions](ebextensions.md). ``` ~/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](using-features.environments.md). O console do Elastic Beanstalk aplica [valores recomendados](command-options.md#configuration-options-recommendedvalues) 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)](concepts.platforms.md), 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](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS 1. No painel de navegação, selecione **Aplicativos** e escolha o nome do aplicativo na lista. 1. No painel de navegação, encontre o nome do aplicativo e escolha **Saved configurations (Configurações salvas)**. 1. Selecione a configuração salva que deseja aplicar e escolha **Launch environment (Iniciar ambiente)**. 1. Continue no assistente para criar seu ambiente. As configurações salvas são específicas ao aplicativo. Consulte [Configurações salvas](environment-configuration-methods-before.md#configuration-options-before-savedconfig) 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](environments-create-wizard.md). 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](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS 1. No painel de navegação, escolha **Applications (Aplicativos)**. 1. Selecione ou [crie](applications.md) um aplicativo. 1. Escolha **Actions (Ações)** e **Create environment (Criar ambiente)**. 1. Continue no assistente e escolha **Configure more options (Configurar mais opções)**. 1. 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. 1. 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](environment-configuration-methods-after.md#configuration-options-after-ebcli) ou a [AWS CLI](environment-configuration-methods-after.md#configuration-options-after-awscli) 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](environments-create-wizard.md). ## Uso da EB CLI **Topics** + [ ### Usar arquivos de configuração (`.ebextensions`) ](#configuration-options-during-ebcli-ebextensions) + [ ### Usar as configurações salvas ](#configuration-options-during-ebcli-savedconfig) + [ ### Usar as opções de linha de comando ](#configuration-options-during-ebcli-params) ### 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](ebextensions.md). ``` ~/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**](eb3-create.md), 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](environment-configuration-methods-before.md#configuration-options-before-savedconfig). ### Usar as opções de linha de comando O comando **eb create** da EB CLI tem várias [opções](eb3-create.md#eb3-createoptions) 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](command-options.md#configuration-options-recommendedvalues). 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](eb3-create.md) para obter uma lista completa de opções disponíveis e exemplos de uso. ## Usando o AWS CLI [Quando você usa o `create-environment` comando para criar um ambiente do Elastic Beanstalk AWS CLI com o AWS CLI , o não aplica nenhum valor recomendado.](command-options.md#configuration-options-recommendedvalues) Todas as opções de configuração são definidas nos arquivos de configuração no pacote de origem especificado por você. **Topics** + [ ### Usar arquivos de configuração (`.ebextensions`) ](#configuration-options-during-awscli-ebextensions) + [ ### Usar uma configuração salva ](#configuration-options-during-awscli-savedconfig) + [ ### Usar as opções de linha de comando ](#configuration-options-during-awscli-params) ### Usar arquivos de configuração (`.ebextensions`) Para aplicar arquivos de configuração a um ambiente criado com o AWS CLI, inclua-os no pacote de origem do aplicativo que você carrega no Amazon S3. Para obter detalhes sobre arquivos de configuração, consulte [.Ebextensions](ebextensions.md). ``` ~/workspace/my-app-v1.zip |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- index.php `-- styles.css ``` **Para fazer o upload de um pacote de origem de aplicativos e criar um ambiente com o 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" } ``` 1. 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 ``` 1. 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 ``` 1. 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.