Opções gerais para todos os ambientes - 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á.

Opções gerais para todos os ambientes

aws:autoscaling:asg

Configure o grupo de Auto Scaling do ambiente. Para obter mais informações, consulte Grupo do Auto Scaling para o seu ambiente do Elastic Beanstalk.

Namespace: aws:autoscaling:asg
Name (Nome) Descrição Padrão Valores válidos

Availability Zones

As zonas de disponibilidade (AZs) são locais distintos dentro de um AWS Região projetada para ser isolada de falhas em outrasAZs. Eles fornecem conectividade de rede barata e de baixa latência para outras pessoas AZs na mesma região. Escolha o número de AZs para suas instâncias.

Any

Any

Any 1

Any 2

Any 3

Cooldown

Os períodos de espera ajudam a evitar que o Amazon EC2 Auto Scaling inicie atividades adicionais de escalabilidade antes que os efeitos das atividades anteriores sejam visíveis. O período de desaquecimento é a quantidade de tempo, em segundos, após a conclusão de uma ação de escalabilidade antes que uma outra ação de escalabilidade possa ser iniciada.

360

0 para 10000

Custom Availability Zones

Defina o AZs para suas instâncias.

Nenhum

us-east-1a

us-east-1b

us-east-1c

us-east-1d

us-east-1e

eu-central-1

EnableCapacityRebalancing

Especifica se o recurso Rebalanceamento de capacidade deve ser habilitado para instâncias spot no seu grupo do Auto Scaling. Para obter mais informações, consulte Rebalanceamento de capacidade no Guia do usuário do Amazon Auto EC2 Scaling.

Essa opção só é relevante quando EnableSpot é definido como true no namespace- aws:ec2:instances e quando há pelo menos uma instância spot no grupo do Auto Scaling.

false

true

false

MinSize

O número mínimo de instâncias que você deseja no grupo de Auto Scaling.

1

1 para 10000

MaxSize

O número máximo de instâncias desejadas no grupo de Auto Scaling.

4

1 para 10000

aws:autoscaling:launchconfiguration

Configure as instâncias do Amazon Elastic Compute Cloud (AmazonEC2) para seu ambiente.

As instâncias usadas para seu ambiente são criadas usando um modelo de EC2 lançamento da Amazon ou um recurso de configuração de lançamento de grupo do Auto Scaling. As opções a seguir funcionam com ambos os tipos de recursos.

Para obter mais informações, consulte As EC2 instâncias da Amazon para seu ambiente Elastic Beanstalk. Você também pode consultar mais informações sobre o Amazon Elastic Block Store (EBS) no EBS capítulo da Amazon no Guia EC2 do usuário da Amazon.

Namespace: aws:autoscaling:launchconfiguration
Name (Nome) Descrição Padrão Valores válidos

DisableIMDSv1

Defina como true para desativar o serviço de metadados de instância versão 1 (IMDSv1).

As instâncias do seu ambiente são padronizadas da seguinte forma, com base no sistema operacional da plataforma:

  • Servidor Windows AL2 e versões anteriores — habilite IMDSv1 e IMDSv2

  • AL2023 — somente habilitar IMDSv2

Para obter mais informações, consulte Configurar o serviço de metadados de instância (Amazon Linux)

ou Configurando o serviço de metadados da instância (servidor do Windows).

false— plataformas baseadas em servidor Windows, Amazon Linux 2 e versões anteriores

true— plataformas baseadas no Amazon Linux 2023

true

false

EC2KeyName

Você pode usar um key pair para fazer login com segurança na sua EC2 instância.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

Nenhum

IamInstanceProfile

Um perfil de instância permite AWS Identity and Access Management (IAM) usuários e AWS serviços para acessar credenciais de segurança temporárias para fazer AWS APIchamadas. Especifique o nome ou o nome do perfil da instânciaARN.

Exemplos:

  • aws-elasticbeanstalk-ec2-role

  • arn:aws:iam::123456789012:instance-profile/aws-elasticbeanstalk-ec2-role

Nenhum

Nome do perfil da instância ouARN.

ImageId

Você pode substituir a Amazon Machine Image (AMI) padrão especificando sua própria ID personalizadaAMI.

Exemplo: ami-1f316660

Nenhum

InstanceType

O tipo de instância usado para executar a aplicação em um ambiente do Elastic Beanstalk.

Importante

A opção InstanceType está obsoleta. Ela foi substituída pela opção mais nova e mais eficiente InstanceTypes no namespace aws:ec2:instances. Você pode usar essa nova opção para especificar uma lista de um ou mais tipos de instância para seu ambiente. O primeiro valor nessa lista é equivalente ao valor da opção InstanceType, incluída no namespace aws:autoscaling:launchconfiguration que é descrito aqui. Recomendamos que você especifique os tipos de instância usando a nova opção. Se especificada, a nova opção tem precedência sobre a anterior. Para obter mais informações, consulte O namespace aws:ec2:instances.

Os tipos de instância disponíveis dependem das zonas de disponibilidade e da região usadas. Se você escolher uma sub-rede, a zona de disponibilidade que contém essa sub-rede determinará os tipos de instância disponíveis.

  • O Elastic Beanstalk não é EC2 compatível com os tipos de instância do Amazon Mac.

  • Para obter mais informações sobre famílias e tipos de EC2 instâncias da Amazon, consulte Tipos de instância no Guia EC2 do usuário da Amazon.

  • Para obter mais informações sobre os tipos de instância disponíveis em todas as regiões, consulte Tipos de instância disponíveis no Guia EC2 do usuário da Amazon.

Varia por conta e região.

Um tipo de EC2 instância.

Varia de acordo com a conta, região e zona de disponibilidade. Você pode obter uma lista dos tipos de EC2 instância da Amazon filtrados por esses valores. Para obter mais informações, consulte Tipos de instância disponíveis no Guia EC2 do usuário da Amazon.

LaunchTemplateTagPropagationEnabled

Defina como true para habilitar a propagação de tags de ambiente para os modelos de execução de recursos específicos provisionados para o ambiente.

O Elastic Beanstalk só pode propagar tags para modelos de execução para os seguintes recursos:

  • EBSvolumes

  • Instâncias do EC2

  • Interfaces de rede do EC2

  • AWS CloudFormation modelos de lançamento que definem um recurso

Essa restrição existe porque CloudFormation só permite tags na criação de modelos para recursos específicos. Para obter mais informações, consulte TagSpecificationno AWS CloudFormation Guia do usuário.

Importante
  • Alterar o valor dessa opção de false para true para um ambiente existente pode ser uma alteração significativa para tags já existentes.

  • Quando esse recurso estiver ativado, a propagação das tags precisará ser EC2 substituída, o que pode resultar em tempo de inatividade. É possível habilitar atualizações contínuas para aplicar alterações de configuração em lotes e evitar tempo de inatividade durante o processo de atualização. Para obter mais informações, consulte Alterações de configuração.

Para obter mais informações sobre modelos de execução, consulte:

Para obter mais informações sobre essa opção, consulte Propagação de tags para modelos de execução.

false

true

false

MonitoringInterval

O intervalo (em minutos) em que você deseja que CloudWatch as métricas da Amazon sejam retornadas.

5 minute

1 minute

5 minute

SecurityGroups

Lista o grupo EC2 de segurança da Amazon IDs a ser atribuído às EC2 instâncias no grupo Auto Scaling para definir regras de firewall para as instâncias.

Você pode fornecer uma única sequência de valores separados por vírgula que contenha grupos de EC2 segurança existentes da Amazon IDs ou referências a AWS::EC2::SecurityGroup recursos criados no modelo.

elasticbeanstalk-default

SSHSourceRestriction

Usado para bloquear o SSH acesso a um ambiente. Por exemplo, você pode bloquear o SSH acesso às EC2 instâncias para que somente um bastion host possa acessar as instâncias na sub-rede privada.

Essa string tem o seguinte formato:

protocol, fromPort, toPort, source_restriction

protocol

O protocolo para a regra de entrada.

fromPort

O número da porta inicial.

toPort

O número da porta final.

source_restriction

O intervalo Classless Inter-Domain Routing (CIDR) ou o grupo de segurança pelo qual o tráfego deve ser roteado. Especifique o grupo de segurança com o ID do grupo de segurança.

Para especificar um grupo de segurança de outra conta, inclua o AWS ID da conta antes da ID do grupo de segurança, separada por uma barra. A outra conta deve estar na mesma AWS Região. Observe a sintaxe:aws-account-id/security-group-id. Por exemplo: 123456789012/sg-99999999

Exemplos:
  • tcp, 22, 22, 54.240.196.185/32

  • tcp, 22, 22, my-security-group-id

  • tcp, 22, 22, 123456789012/their-security-group-id

Nenhum

BlockDeviceMappings

Anexe EBS volumes adicionais da Amazon ou volumes de armazenamento de instâncias em todas as instâncias do grupo Auto Scaling.

Ao mapear volumes de armazenamento de instâncias, é necessário mapear apenas o nome do dispositivo para um nome de volume. No entanto, recomendamos que, ao mapear EBS volumes da Amazon, você especifique adicionalmente alguns ou todos os seguintes campos (cada campo deve ser separado por dois pontos):

  • ID do snapshot

  • tamanho, em GB

  • excluir no encerramento (true ou false)

  • tipo de armazenamento (somente para gp3, gp2, standard, st1, sc1 ou io1)

  • IOPS(somente para gp3 ouio1)

  • throughput (somente para gp3)

O exemplo a seguir anexa três EBS volumes da Amazon, um volume gp2 em branco de 100 GB e um snapshot, um volume io1 em branco de 20 GB com 2000 IOPS provisionados e um volume de armazenamento de instâncias. ephemeral0 Vários volumes de armazenamento de instâncias podem ser anexados se o tipo de instância for compatível com ele.

/dev/sdj=:100:true:gp2,/dev/sdh=snap-51eef269,/dev/sdi=:20:true:io1:2000,/dev/sdb=ephemeral0

Nenhum

  • tamanho: deve ser entre 500 e 16384 GiB

  • throughput: deve ser entre 125 a 1000 mebibytes por segundo (MiB/s)

RootVolumeType

Tipo de volume (magnético, de uso geral SSD ou provisionado IOPSSSD) a ser usado para o EBS volume raiz da Amazon anexado às EC2 instâncias do seu ambiente.

Varia de acordo com a plataforma.

standard para armazenamento magnético.

gp2ou gp3 para uso geralSSD.

io1para provisionado IOPSSSD.

RootVolumeSize

A capacidade de armazenamento do EBS volume raiz da Amazon em GB inteiros.

Obrigatório se você RootVolumeType definir como provisionado IOPSSSD.

Por exemplo, "64".

Varia de acordo com a plataforma para armazenamento magnético e uso geralSSD.

Nenhum para provisionado IOPSSSD.

10para 16384 GB para uso geral e provisionado IOPSSSD.

8 a 1024 GB para magnético.

RootVolumeIOPS

As operações de entrada/saída desejadas por segundo (IOPS) para um volume raiz provisionado ou para um volume IOPS SSD raiz de uso geral. gp3 SSD

A proporção máxima IOPS para o tamanho do volume é de 500 para 1. Por exemplo, um volume com 3000 IOPS deve ter pelo menos 6 GiB.

Nenhum

10020000para volumes raiz provisionados IOPS SSD por io1.

300016000para volumes gp3 SSD raiz de uso geral.

RootVolumeThroughput

A taxa de transferência desejada de mebibytes por segundo (MiB/s) para provisionar o volume EBS raiz da Amazon conectado à instância do seu ambiente. EC2

nota

Essa opção só é aplicável a armazenamento do tipo gp3.

Nenhum

125 para 1000

aws:autoscaling:scheduledaction

Configure ações programadas para o grupo de Auto Scaling do ambiente. Para cada ação, especifique um opção resource_name além do nome, namespace e valor da opção para cada configuração. Consulte O namespace aws:autoscaling:scheduledaction para ver exemplos.

Namespace: aws:autoscaling:scheduledaction
Name (Nome) Descrição Padrão Valores válidos

StartTime

Para ações únicas, escolha a data e a hora para executar a ação. Para ações recorrentes, escolha quando ativar a ação.

Nenhum

Um carimbo de data/hora ISO -8601 exclusivo em todas as ações de escalonamento programadas.

EndTime

Uma data e hora no futuro (no fuso GMT horárioUTC/) em que você deseja que a ação de escalabilidade programada pare de se repetir. Se você não especificar um EndTime, a ação será recorrente de acordo com a Recurrence expressão.

Exemplo: 2015-04-28T04:07:2Z

Quando uma ação programada termina, o Amazon EC2 Auto Scaling não volta automaticamente às configurações anteriores. Configure uma segunda ação programada para retornar às definições originais, conforme necessário.

Nenhum

Um carimbo de data/hora ISO -8601 exclusivo em todas as ações de escalonamento programadas.

MaxSize

A contagem máxima de instâncias a ser aplicada quando a ação é executada.

Nenhum

0 para 10000

MinSize

A contagem mínima de instâncias a ser aplicada quando a ação é executada.

Nenhum

0 para 10000

DesiredCapacity

Defina a capacidade inicial desejada para o grupo de Auto Scaling. Depois que a ação programada for aplicada, os triggers ajustarão a capacidade desejada com base em suas configurações.

Nenhum

0 para 10000

Recurrence

A frequência com que você deseja que a ação programada ocorra. Se você não especificar uma recorrência, a ação de escalabilidade ocorrerá somente uma vez, conforme especificado pelo StartTime.

Nenhum

Uma expressão Cron.

Suspend

Configure como true para desativar uma ação recorrente programada temporariamente.

false

true

false

aws:autoscaling:trigger

Configure os triggers de escalabilidade para o grupo de Auto Scaling do ambiente.

nota

Três opções nesse namespace determinam por quanto tempo uma métrica de acionador pode permanecer além dos limites definidos antes que o acionador seja disparado. Essas opções são relacionadas da seguinte forma:

BreachDuration = Period * EvaluationPeriods

Os valores padrão para essas opções (5, 5 e 1, respectivamente) resolvem essa equação. Se você especificar valores inconsistentes, o Elastic Beanstalk poderá modificar um dos valores para que a equação ainda seja resolvida.

Namespace: aws:autoscaling:trigger
Name (Nome) Descrição Padrão Valores válidos

BreachDuration

A quantidade de tempo, em minutos, que uma métrica pode estar além do limite definido (conforme especificado no UpperThreshold e LowerThreshold) antes que o gatilho seja invocado.

5

1 para 600

LowerBreachScaleIncrement

Quantas EC2 instâncias da Amazon devem ser removidas ao realizar uma atividade de escalabilidade.

-1

LowerThreshold

Se a medida ficar abaixo desse número pela duração da violação, um gatilho é invocado.

2000000

0 para 20000000

MeasureName

A métrica usada para o acionador de Auto Scaling.

nota

HealthyHostCount, UnhealthyHostCount e TargetResponseTime são aplicáveis apenas a ambientes com um balanceador de carga dedicado. Estes não são valores de métrica válidos para ambientes configurados com um balanceador de carga compartilhado. Para obter mais informações sobre os tipos de balanceador de carga, consulte Balanceador de carga do ambiente do Elastic Beanstalk.

NetworkOut

CPUUtilization

NetworkIn

NetworkOut

DiskWriteOps

DiskReadBytes

DiskReadOps

DiskWriteBytes

Latency

RequestCount

HealthyHostCount

UnhealthyHostCount

TargetResponseTime

Period

Especifica com que frequência a Amazon CloudWatch mede as métricas do seu gatilho. O valor é o número de minutos entre dois períodos consecutivos.

5

1 para 600

EvaluationPeriods

O número de períodos de avaliação consecutivos usados para determinar se está ocorrendo uma falha.

1

1 para 600

Statistic

A estatística que o acionador deve usar, como Average.

Average

Minimum

Maximum

Sum

Average

Unit

Unidade de medição do gatilho, como Bytes.

Bytes

Seconds

Percent

Bytes

Bits

Count

Bytes/Second

Bits/Second

Count/Second

None

UpperBreachScaleIncrement

Especifica quantas EC2 instâncias da Amazon devem ser adicionadas ao realizar uma atividade de escalabilidade.

1

UpperThreshold

Se a medida ficar acima desse número pela duração da violação, um gatilho será invocado.

6000000

0 para 20000000

aws:autoscaling:updatepolicy:rollingupdate

Configure atualizações contínuas para o grupo de Auto Scaling do ambiente.

Namespace: aws:autoscaling:updatepolicy:rollingupdate
Name (Nome) Descrição Padrão Valores válidos

MaxBatchSize

O número de instâncias incluídas em cada lote da atualização contínua.

Um terço do tamanho mínimo do grupo de Auto Scaling arredondado para o próximo valor inteiro.

1 para 10000

MinInstancesInService

O número mínimo de instâncias que devem estar em serviço dentro do grupo de Auto Scaling enquanto outras instâncias são encerradas.

O tamanho mínimo do grupo de Auto Scaling ou um inferior ao tamanho máximo do grupo de Auto Scaling, qualquer que seja o número menor.

0 para 9999

RollingUpdateEnabled

Se true, ele permite atualizações contínuas para um ambiente. As atualizações contínuas são úteis quando você precisa fazer pequenas atualizações frequentes na aplicação de software do Elastic Beanstalk e quer evitar tempo de inatividade da aplicação.

A configuração desse valor para verdadeiro ativará automaticamente as opções MaxBatchSize, MinInstancesInServicee PauseTime. A definição de qualquer uma dessas opções também define automaticamente a opção de valor RollingUpdateEnabled para true. A definição dessa opção para false desativa as atualizações contínuas.

false

true

false

RollingUpdateType

Isso inclui três tipos: atualizações contínuas baseadas em tempo, atualizações contínuas baseadas em saúde e atualizações imutáveis.

As atualizações contínuas com base no tempo se aplicam PauseTime entre os lotes. Atualizações contínuas baseadas na integridade aguardam até que as novas instâncias passem nas verificações de integridade antes de mudar para o próximo lote. Atualizações imutáveis iniciam um conjunto completo de instâncias em um novo grupo de Auto Scaling.

Time

Time

Health

Immutable

PauseTime

A quantidade de tempo (em segundos, minutos ou horas) que o serviço do Elastic Beanstalk aguarda após a conclusão das atualizações para um lote de instâncias e antes que ele prossiga para o próximo lote.

Calculado automaticamente com base no tipo de instância e contêiner.

PT0S* (0 segundos) a PT1H (1 hora)

Timeout

O tempo máximo de espera (em minutos ou horas) para que todas as instâncias em um lote de instâncias passem pelas verificações de integridade antes de cancelar a atualização.

PT30M (30 minutos)

PT5M* (5 minutos) a PT1H (1 hora)

* Formato de duração ISO86 01: PT#H#M#S onde cada # é o número de horas, minutos e/ou segundos, respectivamente.

aws:ec2:instances

Configure as instâncias do seu ambiente, incluindo opções de spot. Este namespace complementa aws:autoscaling:launchconfiguration e aws:autoscaling:asg.

Para obter mais informações, consulte Grupo do Auto Scaling para o seu ambiente do Elastic Beanstalk.

Namespace: aws:ec2:instances
Name (Nome) Descrição Padrão Valores válidos

EnableSpot

Habilite solicitações de instância spot para seu ambiente. Quando false, algumas opções neste namespace não entram em vigor.

false

true

false

InstanceTypes

Uma lista separada por vírgulas dos tipos de instância que você deseja que o ambiente use (por exemplo, t2.micro,t3.micro).

Quando as instâncias Spot não estão ativadas (EnableSpot é false), apenas o primeiro tipo de instância na lista é usado.

O primeiro tipo de instância na lista nesta opção é equivalente ao valor da opção InstanceType no namespace aws:autoscaling:launchconfiguration. Não recomendamos usar essa última opção porque ela está obsoleta. Se você especificar ambos, o primeiro tipo de instância na lista na opção InstanceTypes será usado e InstanceType será ignorado.

Os tipos de instância disponíveis dependem das zonas de disponibilidade e da região usadas. Se você escolher uma sub-rede, a zona de disponibilidade que contém essa sub-rede determinará os tipos de instância disponíveis.

  • O Elastic Beanstalk não é EC2 compatível com os tipos de instância do Amazon Mac.

  • Para obter mais informações sobre famílias e tipos de EC2 instâncias da Amazon, consulte Tipos de instância no Guia EC2 do usuário da Amazon.

  • Para obter mais informações sobre os tipos de instância disponíveis em todas as regiões, consulte Tipos de instância disponíveis no Guia EC2 do usuário da Amazon.

nota

Alguns mais velhos AWS as contas podem fornecer ao Elastic Beanstalk tipos de instância padrão que não suportam instâncias spot (por exemplo, t1.micro). Se você ativar solicitações de instância Spot e receber um erro sobre um tipo de instância que não é compatível com Spot, configure tipos de instância que garantam essa compatibilidade. Para escolher os tipos de instância spot, use o Spot Instance Advisor.

Quando você atualiza a configuração do seu ambiente e remove um ou mais tipos de instância da InstanceTypes opção, o Elastic Beanstalk encerra EC2 todas as instâncias da Amazon em execução em qualquer um dos tipos de instância removidos. O grupo d Auto Scaling do seu ambiente executa novas instâncias, conforme necessário, para completar a capacidade desejada, usando os tipos de instância especificados atuais.

Uma lista de dois tipos de instância.

Varia por conta e região.

De um a quarenta tipos de EC2 instância. Recomendamos pelo menos dois

Varia de acordo com a conta, região e zona de disponibilidade. Você pode obter uma lista dos tipos de EC2 instância da Amazon filtrados por esses valores. Para obter mais informações, consulte Tipos de instância disponíveis no Guia EC2 do usuário da Amazon.

Os tipos de instância devem fazer parte da mesma arquitetura (arm64, x86_64, i386).

SupportedArchitectures também faz parte desse namespace. Se você fornecer valores para SupportedArchitectures, o(s) valor(es) inserido(s) para InstanceTypes deve(m) pertencer a uma, e apenas uma, arquitetura que você fornece para SupportedArchitectures.

SpotFleetOnDemandBase

O número mínimo de instâncias sob demanda que o grupo de Auto Scaling provisiona antes de considerar as instâncias spot à medida que o ambiente é dimensionado.

Esta opção é relevante somente quando EnableSpot é true.

0

0 para a opção MaxSize no namespace aws:autoscaling:asg

SpotFleetOnDemandAboveBasePercentage

O percentual de instâncias sob demanda como parte da capacidade adicional que o grupo de Auto Scaling provisiona além das instâncias SpotOnDemandBase.

Esta opção é relevante somente quando EnableSpot é true.

0 para um ambiente de instância única

70 para um ambiente com balanceamento de carga

0 para 100

SpotMaxPrice

O preço máximo por unidade de hora, emUSD, que você está disposto a pagar por uma Instância Spot. Para recomendações sobre as opções de preço máximo para instâncias spot, consulte o histórico de preços de instâncias spot no Guia EC2 do usuário da Amazon.

Esta opção é relevante somente quando EnableSpot é true.

Preço sob demanda, para cada tipo de instância. O valor da opção neste caso é null.

0.001 para 20.0

null

SupportedArchitectures

Uma lista separada por vírgulas dos tipos de arquitetura de EC2 instância que você usará em seu ambiente.

O Elastic Beanstalk é compatível com tipos de instância baseados nas seguintes arquiteturas de processador:

  • AWS Arquitetura Arm Graviton de 64 bits (arm64)

  • Arquitetura de 64 bits (x86_64)

  • Arquitetura de 32 bits (i386)

Para obter mais informações sobre a arquitetura do processador e os tipos de EC2 instância da Amazon, consulteTipos de EC2 instância da Amazon.

Nenhum

arm64

x86_64

i386

nota

A arquitetura de 32 bits i386 não é compatível com a maioria das plataformas do Elastic Beanstalk. Recomendamos que você escolha os tipos de arquitetura x86_64 ou arm64 em vez disso.

aws:ec2:vpc

Configure seu ambiente para lançar recursos em uma Amazon Virtual Private Cloud (AmazonVPC) personalizada. Se você não definir as configurações nesse namespace, o Elastic Beanstalk iniciará recursos no padrão. VPC

Namespace: aws:ec2:vpc
Name (Nome) Descrição Padrão Valores válidos

VPCId

O ID da sua AmazonVPC.

Nenhum

Subnets

A IDs da sub-rede ou sub-redes do grupo Auto Scaling. Se você tiver várias sub-redes, especifique o valor como uma única sequência de caracteres de sub-rede separada por vírgula IDs (por exemplo,). "subnet-11111111,subnet-22222222"

Nenhum

ELBSubnets

A IDs da sub-rede ou sub-redes do balanceador de carga elástico. Se você tiver várias sub-redes, especifique o valor como uma única sequência de caracteres de sub-rede separada por vírgula IDs (por exemplo,). "subnet-11111111,subnet-22222222"

Nenhum

ELBScheme

Especifique internal se você deseja criar um balanceador de carga interno em sua Amazon VPC para que seu aplicativo Elastic Beanstalk não possa ser acessado de fora da Amazon. VPC Se você especificar um valor diferente de public ou internal, o Elastic Beanstalk ignorará o valor.

public

public

internal

DBSubnets

Contém as sub-redes IDs do banco de dados. Isso só é usado se você quiser adicionar uma RDS instância de banco de dados da Amazon como parte do seu aplicativo. Se você tiver várias sub-redes, especifique o valor como uma única sequência de caracteres de sub-rede separada por vírgula IDs (por exemplo,). "subnet-11111111,subnet-22222222"

Nenhum

AssociatePublicIpAddress

Especifica se você deseja iniciar instâncias com endereços IP públicos em sua AmazonVPC. Instâncias com endereços IP públicos não exigem que um NAT dispositivo se comunique com a Internet. Você deve definir o valor como true para incluir o balanceador de carga e as instâncias em uma única sub-rede pública.

Essa opção não tem efeito em um ambiente de instância única, que sempre tem uma única EC2 instância da Amazon com um endereço IP elástico. A opção é relevante para ambientes escaláveis e com balanceamento de carga.

Nenhum

true

false

aws:elasticbeanstalk:application

Configure um caminho de verificação de integridade para seu aplicativo. Para obter mais informações, consulte Relatórios de integridade básica.

Namespace: aws:elasticbeanstalk:application
Name (Nome) Descrição Padrão Valores válidos

Verificação de integridade do aplicativo URL

O caminho para o qual as solicitações de verificação de integridade são enviadas. Se esse caminho não estiver definido, o balanceador de carga tentará fazer uma TCP conexão na porta 80 para verificar o status de integridade do seu aplicativo. Defina um caminho começando com / para enviar uma HTTP GET solicitação para esse caminho. Você também pode incluir um protocolo (HTTP,, HTTPSTCP, ouSSL) e uma porta antes do caminho para verificar a HTTPS conectividade ou usar uma porta não padrão.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

Nenhum

Os valores válidos são:

/(HTTPGETpara o caminho raiz)

/health

HTTPS:443/

HTTPS:443/health

O console do EB CLI e do Elastic Beanstalk aplicam os valores recomendados para as opções anteriores. Se quiser usar arquivos de configuração para definir a mesma coisa, você precisa remover essas configurações. Para mais detalhes, consulte Valores recomendados.

aws:elasticbeanstalk:application:environment

Configure propriedades do ambiente para seu aplicativo.

Namespace: aws:elasticbeanstalk:application:environment
Name (Nome) Descrição Padrão Valores válidos

Qualquer nome de variável de ambiente.

Passe em pares de chave-valor.

Nenhum

Qualquer valor de variável de ambiente.

Consulte Propriedades de ambientes e outras configurações de software Para mais informações.

aws:elasticbeanstalk:cloudwatch:logs

Configure o streaming de logs de instâncias para seu aplicativo.

Namespace: aws:elasticbeanstalk:cloudwatch:logs
Name (Nome) Descrição Padrão Valores válidos

StreamLogs

Especifica se você deve criar grupos em CloudWatch Logs para registros de proxy e implantação e transmitir registros de cada instância em seu ambiente.

false

true

false

DeleteOnTerminate

Especifica se os grupos de log devem ser excluídos quando o ambiente é encerrado. Se for false, os logs serão mantidos por RetentionInDays dias.

false

true

false

RetentionInDays

O número de dias que os eventos de log serão mantidos antes que expirem.

7

1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 3653

aws:elasticbeanstalk:cloudwatch:logs:health

Configure o streaming de logs de integridade do ambiente para seu aplicativo.

Namespace: aws:elasticbeanstalk:cloudwatch:logs:health
Name (Nome) Descrição Padrão Valores válidos

HealthStreamingEnabled

Para ambientes com relatórios de integridade aprimorados habilitados, especifica se é necessário criar um grupo no CloudWatch Logs para a integridade do ambiente e arquivar os dados de integridade do ambiente do Elastic Beanstalk. Para obter informações sobre como habilitar a integridade avançada, visite aws:elasticbeanstalk:healthreporting:system.

false

true

false

DeleteOnTerminate

Especifica se o grupo de logs deve ser excluído quando o ambiente for encerrado. Se false, os dados de integridade são mantidos por RetentionInDays dias.

false

true

false

RetentionInDays

O número de dias para manter os dados de integridade arquivados antes expirem.

7

1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 3653

aws:elasticbeanstalk:command

Configure a política de implantação para o código do aplicativo. Para obter mais informações, consulte Políticas e configurações de implantação.

Namespace: aws:elasticbeanstalk:command
Name (Nome) Descrição Padrão Valores válidos

DeploymentPolicy

Escolha uma política de implantação para implantações de versões do aplicativo.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

AllAtOnce

AllAtOnce

Rolling

RollingWithAdditionalBatch

Immutable

TrafficSplitting

Timeout

A quantidade de tempo, em segundos, para aguardar uma instância para concluir a execução de comandos.

O Elastic Beanstalk adiciona internamente 240 segundos (quatro minutos) ao valor Timeout. Por exemplo, o tempo limite efetivo por padrão é 840 segundos (600 + 240) ou 14 minutos.

600

1 para 3600

BatchSizeType

O tipo de número especificado em BatchSize.

Percentage

Percentage

Fixed

BatchSize

A porcentagem ou o número fixo de EC2 instâncias da Amazon no grupo Auto Scaling nas quais realizar implantações simultaneamente. Os valores válidos variam de acordo com a BatchSizeTypeconfiguração usada.

100

1 para 100 (Percentage).

1para aws:autoscaling:asg:: () MaxSize Fixed

IgnoreHealthCheck

Não cancele uma implantação devido a reprovação nas verificações de integridade.

false

true

false

aws:elasticbeanstalk:environment

Configure a arquitetura e a função de serviço de seu ambiente.

Namespace: aws:elasticbeanstalk:environment
Name (Nome) Descrição Padrão Valores válidos

EnvironmentType

Defina como SingleInstance para iniciar uma EC2 instância sem balanceador de carga.

LoadBalanced

SingleInstance

LoadBalanced

ServiceRole

O nome de uma IAM função que o Elastic Beanstalk usa para gerenciar recursos para o ambiente. Especifique um nome de função (opcionalmente prefixado com um caminho personalizado) ou seu. ARN

Exemplos:

  • aws-elasticbeanstalk-service-role

  • custom-path/custom-role

  • arn:aws:iam::123456789012:role/aws-elasticbeanstalk-service-role

Nenhum

IAMnome da função, caminho/nome ou ARN

LoadBalancerType

O tipo de balanceador de carga para o seu ambiente. Para obter mais informações, consulte Balanceador de carga do ambiente do Elastic Beanstalk.

classic

classic

application

network

LoadBalancerIsShared

Especifica se o balanceador de carga do ambiente é dedicado ou compartilhado. Essa opção só pode ser definida para um Application Load Balancer. Ela não pode ser alterada após a criação do ambiente.

Se false, o ambiente terá seu próprio balanceador de carga dedicado, criado e gerenciado pelo Elastic Beanstalk. Se true, o ambiente usará um balanceador de carga compartilhado, criado por você e especificado na opção SharedLoadBalancer do namespace aws:elbv2:loadbalancer.

false

true

false

aws:elasticbeanstalk:environment:process:default

Configure o processo padrão de seu ambiente.

Namespace: aws:elasticbeanstalk:environment:process:default
Name (Nome) Descrição Padrão Valores válidos

DeregistrationDelay

A quantidade de tempo, em segundos, para aguardar a conclusão das solicitações ativas antes de cancelar o registro.

20

0 para 3600

HealthCheckInterval

O intervalo de tempo, em segundos, em que o Elastic Load Balancing verifica a integridade das EC2 instâncias da Amazon do seu aplicativo.

Com Classic ou Application Load Balancer: 15

Com Network Load Balancer: 30

Com Classic ou Application Load Balancer: 5 a 300

Com Network Load Balancer: 10, 30

HealthCheckPath

O caminho para o qual HTTP as solicitações de verificações de saúde são enviadas.

/

Um caminho roteável.

HealthCheckTimeout

A quantidade de tempo, em segundos, para aguardar uma resposta durante uma verificação de integridade.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

5

1 para 60

HealthyThresholdCount

O número de solicitações consecutivas bem-sucedidas antes de o Elastic Load Balancing alterar o status de integridade da instância.

Com Classic ou Application Load Balancer: 3

Com Network Load Balancer: 5

2 para 10

MatcherHTTPCode

Uma lista de HTTP códigos separados por vírgulas que indicam que uma instância está íntegra.

Essa opção só é aplicável a ambientes com um Network ou Application Load Balancer.

200

Com Application Load Balancer: 200 a 499

Com Network Load Balancer: 200 a 399

Port

Porta que o processo escuta.

80

1 para 65535

Protocol

O protocolo que o processo usa.

Com Application Load Balancer, você só pode definir essa opção como HTTP ou HTTPS.

Com Network Load Balancer, você só pode definir essa opção como TCP.

Com Classic ou Application Load Balancer: HTTP

Com Network Load Balancer: TCP

TCP

HTTP

HTTPS

StickinessEnabled

Defina como verdadeiro para ativar sticky sessions.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

'false'

'false'

'true'

StickinessLBCookieDuration

A duração, em segundos, do cookie de sessão do sticky.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

86400 (um dia)

1 para 604800

StickinessType

Defina como lb_cookie para usar cookies nas sticky sessions.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

lb_cookie

lb_cookie

UnhealthyThresholdCount

Solicitações consecutivas sem êxito antes de o Elastic Load Balancing alterar o status de integridade da instância.

5

2 para 10

aws:elasticbeanstalk:environment:process:process_name

Configure processos adicionais para o seu ambiente.

Namespace: aws:elasticbeanstalk:environment:process:process_name
Name (Nome) Descrição Padrão Valores válidos

DeregistrationDelay

A quantidade de tempo, em segundos, para aguardar a conclusão das solicitações ativas antes de cancelar o registro.

20

0 para 3600

HealthCheckInterval

O intervalo, em segundos, em que o Elastic Load Balancing verifica a integridade das EC2 instâncias da Amazon para seu aplicativo.

Com Classic ou Application Load Balancer: 15

Com Network Load Balancer: 30

Com Classic ou Application Load Balancer: 5 a 300

Com Network Load Balancer: 10, 30

HealthCheckPath

O caminho para o qual HTTP as solicitações de verificações de saúde são enviadas.

/

Um caminho roteável.

HealthCheckTimeout

A quantidade de tempo, em segundos, para aguardar uma resposta durante uma verificação de integridade.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

5

1 para 60

HealthyThresholdCount

O número de solicitações consecutivas bem-sucedidas antes de o Elastic Load Balancing alterar o status de integridade da instância.

Com Classic ou Application Load Balancer: 3

Com Network Load Balancer: 5

2 para 10

MatcherHTTPCode

Uma lista de HTTP códigos separados por vírgulas que indica que uma instância está íntegra.

Essa opção só é aplicável a ambientes com um Network ou Application Load Balancer.

200

Com Application Load Balancer: 200 a 499

Com Network Load Balancer: 200 a 399

Port

A porta que o processo escuta.

80

1 para 65535

Protocol

O protocolo que o processo usa.

Com Application Load Balancer, você só pode definir essa opção como HTTP ou HTTPS.

Com Network Load Balancer, você só pode definir essa opção como TCP.

Com Classic ou Application Load Balancer: HTTP

Com Network Load Balancer: TCP

TCP

HTTP

HTTPS

StickinessEnabled

Defina como verdadeiro para ativar sticky sessions.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

'false'

'false'

'true'

StickinessLBCookieDuration

A duração, em segundos, do cookie de sessão do sticky.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

86400 (um dia)

1 para 604800

StickinessType

Defina como lb_cookie para usar cookies nas sticky sessions.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

lb_cookie

lb_cookie

UnhealthyThresholdCount

Solicitações consecutivas sem êxito antes de o Elastic Load Balancing alterar o status de integridade da instância.

5

2 para 10

aws:elasticbeanstalk:environment:proxy:staticfiles

Você pode usar o namespace a seguir para configurar o servidor de proxy para atender arquivos estáticos. Quando o servidor de proxy recebe uma solicitação para um arquivo no caminho especificado, ele atende o arquivo diretamente em vez de rotear solicitação para seu aplicativo. Isso reduz o número de solicitações que seu aplicativo deve processar.

Mapeie um caminho fornecido pelo servidor de proxy para uma pasta no código-fonte que contenha ativos estáticos. Cada opção definida neste namespace mapeia um caminho diferente.

nota

Esse namespace se aplica a ramificações da plataforma baseadas no Amazon Linux 2 e versões posteriores. Se seu ambiente usa uma versão de plataforma baseada no Amazon Linux AMI (anterior ao Amazon Linux 2), consulte os namespaces de arquivos Opções específicas para a plataforma estáticos específicos da plataforma.

Namespace: aws:elasticbeanstalk:environment:proxy:staticfiles
Name (Nome) Valor

O caminho no qual o servidor proxy serve os arquivos. Inicie o valor com /.

Por exemplo, especifique /images para servir arquivos em subdomain.eleasticbeanstalk.com/images.

O nome da pasta que contém os arquivos.

Por exemplo, especifique staticimages para servir arquivos de uma pasta denominada staticimages no nível mais alto do seu pacote de origem.

aws:elasticbeanstalk:healthreporting:system

Configure relatórios de integridade aprimorados para o seu ambiente.

Namespace: aws:elasticbeanstalk:healthreporting:system
Name (Nome) Descrição Padrão Valores válidos

SystemType

O sistema de relatórios de integridade (básicos ou aprimorados). Os relatórios de integridade aprimorados requerem uma função de serviço e uma versão da plataforma versão 2 ou mais nova.

basic

basic

enhanced

ConfigDocument Um JSON documento que descreve as métricas do ambiente e da instância para publicar CloudWatch. Nenhum

EnhancedHealthAuthEnabled

Permite a autorização interna API que o Elastic Beanstalk usa para comunicar informações aprimoradas de saúde das instâncias do seu ambiente ao serviço do Elastic Beanstalk.

Para obter mais informações, consulte Funções de integridade aperfeiçoada.

nota

Essa opção só é aplicável a relatórios de integridade aprimorados (como quando SystemType está definido como enhanced).

true

true

false

HealthCheckSuccessThreshold

Reduz o limite para que as instâncias passem nas verificações de integridade.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

Ok

Ok

Warning

Degraded

Severe

aws:elasticbeanstalk:hostmanager

Configure as EC2 instâncias em seu ambiente para fazer upload de logs rotacionados para o Amazon S3.

Namespace: aws:elasticbeanstalk:hostmanager
Name (Nome) Descrição Padrão Valores válidos

LogPublicationControl

Copie os arquivos de log das EC2 instâncias da Amazon do seu aplicativo para o bucket do Amazon S3 que está associado ao seu aplicativo.

false

true

false

aws:elasticbeanstalk:managedactions

Configure as atualizações gerenciadas da plataforma para o ambiente.

Namespace: aws:elasticbeanstalk:managedactions
Name (Nome) Descrição Padrão Valores válidos

ManagedActionsEnabled

Ative as atualizações gerenciadas da Plataforma.

Ao definir essa opção para true, também é necessário especificar PreferredStartTime e UpdateLevel.

false

true

false

PreferredStartTime

Configure uma janela de manutenção para ações gerenciadas emUTC.

Por exemplo, "Tue:09:00".

Nenhum

Dia e hora no

day:hour:minute

format.

ServiceRoleForManagedUpdates

O nome de uma IAM função que o Elastic Beanstalk usa para realizar atualizações gerenciadas da plataforma para seu ambiente.

É possível usar a mesma função especificada para a opção ServiceRole do namespace aws:elasticbeanstalk:environment ou a função vinculada ao serviço de atualizações gerenciadas da conta. No último caso, se a conta ainda não tiver uma função vinculada ao serviço de atualizações gerenciadas, o Elastic Beanstalk a criará.

Nenhum

Igual a ServiceRole

ou

AWSServiceRoleForElasticBeanstalkManagedUpdates

aws:elasticbeanstalk:managedactions:platformupdate

Configure as atualizações gerenciadas da plataforma para o ambiente.

Namespace: aws:elasticbeanstalk:managedactions:platformupdate
Name (Nome) Descrição Padrão Valores válidos

UpdateLevel

O nível mais alto de atualização a aplicar com atualizações gerenciadas da plataforma. As plataformas são versionadas major.minor.patch. Por exemplo, 2.0.8 tem uma versão principal de 2, uma versão secundária de 0 e uma versão de patch de 8.

Nenhum

patch somente para atualizações de versão de patch.

minor para atualizações de versão secundária e de patch.

InstanceRefreshEnabled

Ative substituição de instância semanal.

Isso requer que ManagedActionsEnabled seja definido como true.

false

true

false

aws:elasticbeanstalk:monitoring

Configure seu ambiente para encerrar EC2 instâncias que falham nas verificações de integridade.

Namespace: aws:elasticbeanstalk:monitoring
Name (Nome) Descrição Padrão Valores válidos

Automatically Terminate Unhealthy Instances

Encerre uma instância se ela falhar nas verificações de integridade.

nota

Essa opção só é compatível com ambientes legados. Ela determina a integridade de uma instância com base em poder acessá-la e em outras métricas com base em instâncias.

O Elastic Beanstalk não fornece uma maneira de encerrar instâncias automaticamente com base na integridade da aplicação.

true

true

false

aws:elasticbeanstalk:sns:topics

Configure as notificações de seu ambiente.

Namespace: aws:elasticbeanstalk:sns:topics
Name (Nome) Descrição Padrão Valores válidos

Notification Endpoint

O endpoint em que você deseja ser notificado sobre eventos importantes que afetam a aplicação.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

Nenhum

Notification Protocol

O protocolo usado para enviar notificações ao endpoint.

email

http

https

email

email-json

sqs

Notification Topic ARN

O nome do recurso da Amazon (ARN) para o tópico em que você se inscreveu.

Nenhum

Notification Topic Name

O nome do tópico que você assinou.

Nenhum

aws:elasticbeanstalk:sqsd

Configure a SQS fila da Amazon para um ambiente de trabalho.

Namespace: aws:elasticbeanstalk:sqsd
Name (Nome) Descrição Padrão Valores válidos

WorkerQueueURL

A URL da fila da qual o daemon na camada do ambiente de trabalho lê as mensagens.

nota

Quando você não especifica um valor, a fila que o Elastic Beanstalk cria automaticamente é uma fila padrão da Amazon. SQS Ao fornecer um valor, você pode fornecer uma fila padrão ou uma SQS fila FIFOda Amazon. URL Lembre-se de que, se você fornecer uma FIFO fila, as tarefas periódicas não serão suportadas.

gerado automaticamente

Se você não especificar um valor, o Elastic Beanstalk criará automaticamente uma fila.

HttpPath

O caminho relativo para o aplicativo para o qual as HTTP POST mensagens são enviadas.

/

MimeType

O MIME tipo da mensagem que é enviada na HTTP POST solicitação.

application/json

application/json

application/x-www-form-urlencoded

application/xml

text/plain

MIMETipo personalizado.

HttpConnections

O número máximo de conexões simultâneas com qualquer aplicativo que esteja dentro de uma EC2 instância da Amazon.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

50

1 para 100

ConnectTimeout

O tempo, em segundos, a aguardar por conexões bem-sucedidas com um aplicativo.

5

1 para 60

InactivityTimeout

O tempo, em segundos, a aguardar por uma resposta para uma conexão existente com um aplicativo.

A mensagem é reprocessada até que o daemon receba uma resposta 200 (OK) do aplicativo no nível do ambiente de operador ou RetentionPeriod expire.

299

1 para 36000

VisibilityTimeout

A quantidade de tempo, em segundos, em que uma mensagem recebida da SQS fila da Amazon fica bloqueada para processamento. Após o término do tempo configurado, a mensagem ficará novamente visível na fila para qualquer outro daemon ler.

300

0 para 43200

ErrorVisibilityTimeout

A quantidade de tempo, em segundos, que decorre antes que o Elastic Beanstalk retorne uma mensagem para a fila da SQS Amazon após uma tentativa de processamento falhar com um erro explícito.

2 segundos

0 a 43200 segundos

RetentionPeriod

A quantidade de tempo, em segundos, em que uma mensagem é válida e é ativamente processada.

345600

60 para 1209600

MaxRetries

O número máximo de vezes em que o Elastic Beanstalk tenta enviar a mensagem à aplicação Web que vai processá-la antes de movê-la para a dead-letter queue.

10

1 para 100

aws:elasticbeanstalk:trafficsplitting

Configure implantações de divisão de tráfego para o ambiente.

Esse namespace se aplica quando você define a opção DeploymentPolicy do namespace aws:elasticbeanstalk:command como TrafficSplitting. Para obter mais informações sobre políticas de implantação, consulte Políticas e configurações de implantação.

Namespace: aws:elasticbeanstalk:trafficsplitting
Name (Nome) Descrição Padrão Valores válidos

NewVersionPercent

A porcentagem inicial de tráfego de entrada do cliente que o Elastic Beanstalk desloca para instâncias de ambiente executando a nova versão da aplicação que está sendo implantada.

10

1 para 100

EvaluationTime

O período, em minutos, que o Elastic Beanstalk aguarda após uma implantação íntegra inicial antes de prosseguir para deslocar todo o tráfego de entrada de cliente para a nova versão da aplicação que está sendo implantada.

5

3 para 600

aws:elasticbeanstalk:xray

Execute o AWS X-Ray daemon para retransmitir informações de rastreamento do seu aplicativo integrado X-Ray.

Namespace: aws:elasticbeanstalk:xray
Name (Nome) Descrição Padrão Valores válidos

XRayEnabled

Defina como true para executar o daemon do X-Ray nas instâncias do ambiente.

false

true

false

aws:elb:healthcheck

Configure as verificações de integridade de um Classic Load Balancer.

Namespace: aws:elb:healthcheck
Name (Nome) Descrição Padrão Valores válidos

HealthyThreshold

O número de solicitações consecutivas bem-sucedidas antes de o Elastic Load Balancing alterar o status de integridade da instância.

3

2 para 10

Interval

O intervalo em que o Elastic Load Balancing verifica a integridade das EC2 instâncias da Amazon do seu aplicativo.

10

5 para 300

Timeout

A quantidade de tempo, em segundos, que o Elastic Load Balancing aguardará por uma resposta antes de considerar a instância não responsiva.

5

2 para 60

UnhealthyThreshold

Solicitações consecutivas sem êxito antes de o Elastic Load Balancing alterar o status de integridade da instância.

5

2 para 10

(obsoleto) Target

O destino em uma instância de back-end para a qual as verificações de integridade são enviadas. Em vez dessa opção, use Application Healthcheck URL no namespace aws:elasticbeanstalk:application.

TCP:80

Alvo no formato PROTOCOL:PORT/PATH

aws:elb:loadbalancer

Configure o Classic Load Balancer do ambiente.

Várias das opções neste namespace foram substituídas por opções específicas do listener no namespace aws:elb:listener. Como essas opções que não são mais suportadas, você só pode configurar dois listeners (um seguro e um inseguro) em portas padrão.

Namespace: aws:elb:loadbalancer
Name (Nome) Descrição Padrão Valores válidos

CrossZone

Configure o balanceador de carga para rotear o tráfego uniformemente em todas as instâncias em todas as zonas de disponibilidade, em vez de apenas dentro de cada região.

false

true

false

SecurityGroups

Atribua um ou mais grupos de segurança que você criou ao balanceador de carga.

Nenhum

Um ou mais grupos de segurançaIDs.

ManagedSecurityGroup

Atribua um security group existente ao balanceador de carga do seu ambiente, em vez de criar um novo. Para usar essa configuração, atualize a configuração SecurityGroups neste namespace para incluir a ID do security group e remova a ID do grupo de segurança criada automaticamente, se uma foi criada.

Para permitir o tráfego do balanceador de carga para as EC2 instâncias do seu ambiente, o Elastic Beanstalk adiciona uma regra ao grupo de segurança das instâncias que permite o tráfego de entrada do grupo de segurança gerenciado.

Nenhum Um ID de security group.

(obsoleto) LoadBalancerHTTPPort

Porta de escuta do listener não seguro.

80

OFF

80

(obsoleto) LoadBalancerPortProtocol

O protocolo para usar no listener não seguro.

HTTP

HTTP

TCP

(obsoleto) LoadBalancerHTTPSPort

A p\orta de escuta do listener seguro.

OFF

OFF

443

8443

(obsoleto) LoadBalancerSSLPortProtocol

O protocolo para usar no listener seguro.

HTTPS

HTTPS

SSL

(obsoleto) SSLCertificateId

O nome de recurso da Amazon (ARN) de um SSL certificado a ser vinculado ao ouvinte seguro.

Nenhum

aws:elb:listener

Configure o listener padrão (porta 80) em um Classic Load Balancer.

Namespace: aws:elb:listener
Name (Nome) Descrição Padrão Valores válidos
ListenerProtocol O protocolo usado pelo listener. HTTP HTTP TCP
InstancePort A porta que esse ouvinte usa para se comunicar com as EC2 instâncias. 80 1 para 65535
InstanceProtocol

O protocolo que esse ouvinte usa para se comunicar com as EC2 instâncias.

Deve estar na mesma camada de protocolo de internet que ListenerProtocol. Também deve ter o mesmo nível de segurança que qualquer outro listener usando o mesmo InstancePort que esse listener.

Por exemplo, se ListenerProtocol for HTTPS (camada de aplicação, usando uma conexão segura), você poderá definir InstanceProtocol como HTTP (também na camada de aplicação, usando uma conexão não segura). Se, além disso, você definir InstancePort como 80, precisará definir InstanceProtocol como HTTP em todos os outros listeners, com InstancePort definido como 80.

HTTP quando ListenerProtocol é HTTP

TCP quando ListenerProtocol é TCP

HTTP ou HTTPS quando ListenerProtocol é HTTP ou HTTPS

TCP ou SSL quando ListenerProtocol é TCP ou SSL

PolicyNames Uma lista separada por vírgulas de nomes de políticas para aplicar à porta desse listener. Em vez disso, recomendamos que você use a LoadBalancerPorts opção do aws:elb:policies namespace. Nenhum
ListenerEnabled Especifica se esse listener está ativado. Se você especificar false, o listener não será incluído no balanceador de carga. true

true

false

aws:elb:listener:listener_port

Configure listeners adicionais em um Classic Load Balancer.

Namespace: aws:elb:listener:listener_port
Name (Nome) Descrição Padrão Valores válidos

ListenerProtocol

O protocolo usado pelo listener. HTTP HTTP HTTPS TCP SSL

InstancePort

A porta que esse ouvinte usa para se comunicar com as EC2 instâncias. O mesmo que listener_port. 1 para 65535

InstanceProtocol

O protocolo que esse ouvinte usa para se comunicar com as EC2 instâncias.

Deve estar na mesma camada de protocolo de internet que ListenerProtocol. Também deve ter o mesmo nível de segurança que qualquer outro listener usando o mesmo InstancePort que esse listener.

Por exemplo, se ListenerProtocol for HTTPS (camada de aplicação, usando uma conexão segura), você poderá definir InstanceProtocol como HTTP (também na camada de aplicação, usando uma conexão não segura). Se, além disso, você definir InstancePort como 80, precisará definir InstanceProtocol como HTTP em todos os outros listeners, com InstancePort definido como 80.

HTTP quando ListenerProtocol é HTTP ou HTTPS

TCP quando ListenerProtocol é TCP ou SSL

HTTP ou HTTPS quando ListenerProtocol é HTTP ou HTTPS

TCP ou SSL quando ListenerProtocol é TCP ou SSL

PolicyNames

Uma lista separada por vírgulas de nomes de políticas para aplicar à porta desse listener. Em vez disso, sugerimos que você use a LoadBalancerPorts opção do aws:elb:policies namespace. Nenhum

SSLCertificateId

O nome de recurso da Amazon (ARN) de um SSL certificado a ser vinculado ao ouvinte.

Nenhum

ListenerEnabled

Especifica se esse listener está ativado. Se você especificar false, o listener não será incluído no balanceador de carga. true se qualquer outra opção estiver definida. false, se for o contrário. true false

aws:elb:policies

Modifique o padrão global de perdurabilidade e as políticas globais de um Classic Load Balancer.

Namespace: aws:elb:policies
Name (Nome) Descrição Padrão Valores válidos

ConnectionDrainingEnabled

Especifica se o balanceador de carga mantém as conexões existentes com a instâncias que deixaram de ser íntegras ou tiveram o registro cancelado para concluir as solicitações em andamento.

false

true

false

ConnectionDrainingTimeout

O número máximo de segundos que o balanceador de carga mantém conexões existentes com uma instância durante a drenagem da conexão antes de forçar o fechamento das conexões.

nota

Se você usar o console do Elastic Beanstalk para criar um ambiente, não será possível definir essa opção em um arquivo de configuração. O console e substitui essa opção por um valor recomendado.

20

1 para 3600

ConnectionSettingIdleTimeout

A quantidade de tempo, em segundos, que o balanceador de carga aguarda que todos os dados sejam enviados ou recebidos pela conexão. Se nenhum dado tiver sido enviado ou recebido após esse período, o balanceador de carga fechará a conexão.

60

1 para 3600

LoadBalancerPorts

Uma lista separada por vírgulas das portas do listener em que a política padrão (AWSEB-ELB-StickinessPolicy) se aplica.

Nenhum Você pode usar :all para indicar todas as portas do listener

Stickiness Cookie Expiration

O tempo, em segundos, pelo qual cada cookie é válido. Usa a política padrão (AWSEB-ELB-StickinessPolicy).

0

0 para 1000000

Stickiness Policy

Vincula a sessão do usuário a uma determinada instância do servidor, para que todas as solicitações desse usuário durante a sessão sejam enviadas para a mesma instância do servidor. Usa a política padrão (AWSEB-ELB-StickinessPolicy).

false

true false

aws:elb:policies:policy_name

Crie políticas adicionais de balanceador de carga para um Classic Load Balancer.

Namespace: aws:elb:policies:policy_name
Name (Nome) Descrição Padrão Valores válidos

CookieName

O nome do cookie gerado pelo aplicativo que controla os tempos de vida da sessão de uma política AppCookieStickinessPolicyType. Essa política só pode ser associada aHTTP/HTTPSlisteners. Nenhum

InstancePorts

Uma lista separada por vírgulas das portas de instâncias em que a política aplica.

Nenhum Uma lista de portas, ou :all

LoadBalancerPorts

Uma lista separada por vírgulas das portas de listeners em que a política aplica.

Nenhum Uma lista de portas, ou :all

ProxyProtocol

Para uma ProxyProtocolPolicyType política, especifica se o endereço IP e a porta da solicitação de origem das mensagens devem ser incluídas. TCP Essa política só pode ser associada aTCP/SSLlisteners.

Nenhum true false

PublicKey

O conteúdo de uma chave pública para uma política PublicKeyPolicyType a ser utilizada na autenticação do servidor ou servidores de backend. Esta política não pode ser aplicada diretamente a servidores de backend ou listeners. Ela deve fazer parte de uma política de BackendServerAuthenticationPolicyType.

Nenhum

PublicKeyPolicyNames

Uma lista separada por vírgulas de nomes de políticas (com base em políticas PublicKeyPolicyType) para uma política BackendServerAuthenticationPolicyType que controla a autenticação em um ou mais servidores de backend. Essa política só pode ser associada a servidores de back-end que estejam usandoHTTPS/SSL.

Nenhum

SSLProtocols

Uma lista separada por vírgulas de SSL protocolos a serem habilitados para uma SSLNegotiationPolicyType política que define as cifras e os protocolos aceitos pelo balanceador de carga. Essa política só pode ser associada aHTTPS/SSLlisteners.

Nenhum

SSLReferencePolicy

O nome de uma política de segurança predefinida que segue AWS melhores práticas de segurança e que você deseja ativar para uma SSLNegotiationPolicyType política que define as cifras e protocolos que são aceitos pelo balanceador de carga. Essa política só pode ser associada aHTTPS/SSLlisteners.

Nenhum

Stickiness Cookie Expiration

O tempo, em segundos, pelo qual cada cookie é válido.

0

0 para 1000000

Stickiness Policy

Vincula a sessão do usuário a uma determinada instância do servidor, para que todas as solicitações desse usuário durante a sessão sejam enviadas para a mesma instância do servidor.

false

true false

aws:elbv2:listener:default

Configure o listener padrão (porta 80) em um Application Load Balancer ou um Network Load Balancer.

Esse namespace não se aplica a um ambiente que usa um balanceador de carga compartilhado. Os balanceadores de carga compartilhados não têm um listener padrão.

Namespace: aws:elbv2:listener:default
Name (Nome) Descrição Padrão Valores válidos

DefaultProcess

O nome do processo ao qual encaminhar o tráfego quando nenhuma regra se aplica.

default

Um nome de processo.

ListenerEnabled

Defina como false para desativar o listener. Você pode usar essa opção para desativar o listener padrão na porta 80.

true

true

false

Protocol

Protocolo de tráfego a processar.

Com Application Load Balancer: HTTP

Com Network Load Balancer: TCP

Com Application Load Balancer: HTTP, HTTPS

Com Network Load Balancer: TCP

Rules

A lista de regras que se aplicam ao listener

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum

Uma lista separada por vírgulas de nomes de regras.

SSLCertificateArns

O Amazon Resource Name (ARN) do SSL certificado a ser vinculado ao ouvinte.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum

O ARN de um certificado armazenado em IAM ouACM.

SSLPolicy

Especifique uma política de segurança para aplicar ao listener.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum (ELBpadrão)

O nome de uma política de segurança do load balancer.

aws:elbv2:listener:listener_port

Configure listeners adicionais em um Application Load Balancer ou um Network Load Balancer.

nota

Para um Application Load Balancer compartilhado, você pode especificar apenas a opção Rule. As outras opções não são aplicáveis aos balanceadores de carga compartilhados.

Namespace: aws:elbv2:listener:listener_port
Name (Nome) Descrição Padrão Valores válidos

DefaultProcess

O nome do processo ao qual encaminhar o tráfego quando não houver regras correspondentes.

default

Um nome de processo.

ListenerEnabled

Defina como false para desativar o listener. Você pode usar essa opção para desativar o listener padrão na porta 80.

true

true

false

Protocol

Protocolo de tráfego a processar.

Com Application Load Balancer: HTTP

Com Network Load Balancer: TCP

Com Application Load Balancer: HTTP, HTTPS

Com Network Load Balancer: TCP

Rules

Lista de regras que se aplicam ao listener

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Se o ambiente usar um Application Load Balancer compartilhado e você não especificar essa opção para nenhum listener, o Elastic Beanstalk associará automaticamente a regra default a um listener de porta 80.

Nenhum

Uma lista separada por vírgulas de nomes de regras.

SSLCertificateArns

O Amazon Resource Name (ARN) do SSL certificado a ser vinculado ao ouvinte.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum

O ARN de um certificado armazenado em IAM ouACM.

SSLPolicy

Especifique uma política de segurança para aplicar ao listener.

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum (ELBpadrão)

O nome de uma política de segurança do load balancer.

aws:elbv2:listenerrule:rule_name

Defina regras de listener para um Application Load Balancer. Se uma solicitação corresponder aos nomes ou caminhos do host em uma regra, o balanceador de carga a encaminhará para o processo especificado. Para usar uma regra, adicione-a a um listener com a opção Rules no namespace aws:elbv2:listener:listener_port.

nota

Este namespace não é aplicável a ambientes com um Network Load Balancer.

Namespace: aws:elbv2:listenerrule:rule_name
Name (Nome) Descrição Padrão Valores válidos

HostHeaders

Uma lista de nomes de host para corresponder. Por exemplo, my.example.com.

Load balancer dedicado: nenhum

Balanceador de carga compartilhado: o ambiente CNAME

Cada nome pode conter até 128 caracteres. Um padrão pode incluir letras maiúsculas e minúsculas, números, hífens (–) e até três caracteres curinga (* corresponde a zero ou mais caracteres; ? corresponde a exatamente um caractere). Você pode listar mais de um nome, cada um separado por uma vírgula. O Application Load Balancer é compatível com até cinco regras HostHeader e PathPattern combinadas.

Para obter mais informações, consulte Condições de host no Guia do Usuário para o Application Load Balancers.

PathPatterns

Os padrões de caminho a serem adotados (por exemplo, /img/*).

Essa opção só é aplicável a ambientes com um Application Load Balancer.

Nenhum

Cada padrão pode conter até 128 caracteres. Um padrão pode incluir letras maiúsculas e minúsculas, números, hífens (–) e até três caracteres curinga (* corresponde a zero ou mais caracteres; ? corresponde a exatamente um caractere). É possível adicionar vários padrões de caminho separados por vírgulas. O Application Load Balancer é compatível com até cinco regras HostHeader e PathPattern combinadas.

Para obter mais informações, consulte as Condições de caminho no Guia do Usuário para Application Load Balancers.

Priority

A precedência dessa regra quando há várias regras correspondentes. O menor número tem precedência. Duas regras não podem ter a mesma prioridade.

Com um balanceador de carga compartilhado, o Elastic Beanstalk trata as prioridades de regras como relativas em ambientes de compartilhamento e as mapeia para prioridades absolutas durante a criação.

1

1 para 1000

Process

O nome do processo ao qual encaminhar o tráfego quando essa regra corresponde à solicitação.

default

Um nome de processo.

aws:elbv2:loadbalancer

Configure um Application Load Balancer.

Para um balanceador de carga compartilhado, somente as opções SharedLoadBalancer e SecurityGroups são válidas.

nota

Este namespace não é aplicável a ambientes com um Network Load Balancer.

Namespace: aws:elbv2:loadbalancer
Name (Nome) Descrição Padrão Valores válidos

AccessLogsS3Bucket

O bucket do Amazon S3 no qual os logs de acesso são armazenados. O bucket deve estar na mesma região que o ambiente e permitir acesso de gravação ao balanceador de carga.

Nenhum

Nome de um bucket.

AccessLogsS3Enabled

Habilite o acesso ao armazenamento de logs.

false

true

false

AccessLogsS3Prefix

O prefixo para prefixar nomes de logs de acesso. Por padrão, o balanceador de carga carrega os registros em um diretório chamado AWSLogs no bucket que você especificar. Especifique um prefixo para colocar o AWSLogs diretório dentro de outro diretório.

Nenhum

IdleTimeout

A quantidade de tempo, em segundos, para aguardar a conclusão de uma solicitação antes de fechar conexões com o cliente e a instância.

Nenhum

1 para 3600

ManagedSecurityGroup

Atribua um grupo de segurança existente ao balanceador de carga do ambiente em vez de criar um novo. Para usar essa configuração, atualize a definição SecurityGroups neste namespace para incluir o ID do security group e remover o ID do security group criado automaticamente, se houver um.

Para permitir o tráfego do balanceador de carga para as EC2 instâncias do seu ambiente, o Elastic Beanstalk adiciona uma regra ao grupo de segurança de suas instâncias que permite o tráfego de entrada do grupo de segurança gerenciado.

O security group que o Elastic Beanstalks cria para o balanceador de carga.

Um ID de security group.

SecurityGroups

Lista de security groups para anexar ao balanceador de carga.

Para um balanceador de carga compartilhado, se você não especificar esse valor, o Elastic Beanstalk verificará se um grupo de segurança existente que ele gerencia já está conectado ao balanceador de carga. Se um não estiver conectado ao balanceador de carga, o Elastic Beanstalk cria um security group e o anexará ao balanceador de carga. O Elastic Beanstalk exclui esse grupo de segurança quando o último ambiente que compartilha o balanceador de carga é encerrado.

Os grupos de segurança do balanceador de carga são usados para configurar a regra de entrada do grupo de segurança de EC2 instâncias da Amazon.

O grupo de segurança que o Elastic Beanstalk cria para o balanceador de carga.

Lista separada por vírgulas do grupo de segurança. IDs

SharedLoadBalancer

O Amazon Resource Name (ARN) de um balanceador de carga compartilhado. Essa opção é relevante apenas para um Application Load Balancer. Ela é necessária quando a opção LoadBalancerIsShared do namespace aws:elasticbeanstalk:environment está definida como true. Você não pode alterar o balanceador de carga compartilhado ARN após a criação do ambiente.

Critérios para um valor válido:

  • Ele deve ser um balanceador de carga ativo e válido no AWS Região onde o ambiente está localizado.

  • Ele deve estar na mesma Amazon Virtual Private Cloud (AmazonVPC) do ambiente.

  • Ele não pode ser um balanceador de carga criado pelo Elastic Beanstalk como balanceador de carga dedicado para outro ambiente. Você pode identificar esses balanceadores de carga dedicados usando o prefixo awseb-.

Exemplo:

arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc

Nenhum

ARNde um balanceador de carga válido que atenda a todos os critérios descritos aqui.

aws:rds:dbinstance

Configure uma instância de RDS banco de dados Amazon conectada.

Namespace: aws:rds:dbinstance
Name (Nome) Descrição Padrão Valores válidos

DBAllocatedStorage

O tamanho de armazenamento do banco de dados alocado, especificado em gigabytes.

MeuSQL: 5

Oracle: 10

sqlserver-se: 200

sqlserver-ex: 30

sqlserver-web: 30

MeuSQL: 5 - 1024

Oracle: 10-1024

sqlserver: não pode ser modificado

DBDeletionPolicy

Especifica se é necessário reter, excluir ou fazer um snapshot da instância de banco de dados quando um ambiente é terminado.

Essa opção funciona em conjunto com HasCoupledDatabase, também uma opção desse namespace.

Atenção

A exclusão de uma instância de banco de dados resulta em perda de dados permanente.

Delete

Delete

Retain

Snapshot

DBEngine

O nome do mecanismo de banco de dados a utilizar nessa instância.

mysql

mysql

oracle-se1

sqlserver-ex

sqlserver-web

sqlserver-se

postgres

DBEngineVersion

O número da versão do mecanismo de banco de dados.

5.5

DBInstanceClass

O tipo de instância de banco de dados.

db.t2.micro

(db.m1.largepara um ambiente que não funciona em uma AmazonVPC)

Para obter mais informações, consulte Classe de instância do banco de dados no Guia do usuário do Amazon Relational Database Service.

DBPassword

O nome da senha mestra do usuário para a instância de banco de dados.

Nenhum

DBSnapshotIdentifier

O identificador para restaurar o DB snapshot.

Nenhum

DBUser

O nome do usuário mestre da instância do banco de dados.

ebroot

HasCoupledDatabase

Especifica se uma instância de banco de dados está acoplada ao ambiente. Se definida como true, o Elastic Beanstalk cria uma nova instância de banco de dados acoplada ao seu ambiente. Se definida como false, o Elastic Beanstalk inicia o desacoplamento da instância de banco de dados do seu ambiente.

Essa opção funciona em conjunto com DBDeletionPolicy, também uma opção desse namespace.

nota

Nota: se você voltar esse valor para true após desacoplar o banco de dados anterior, o Elastic Beanstalk cria um novo banco de dados com as configurações de banco de dados anteriores. No entanto, para manter a segurança do seu ambiente, ele não retém as configurações existentes de DBUser e DBPassword. Você precisa especificar DBUser e DBPassword novamente.

false

true

false

MultiAZDatabase

Especifica se a implantação Multi-AZ de uma instância de banco de dados precisa ser criada. Para obter mais informações sobre implantações Multi-AZ com o Amazon Relational Database Service (RDS), consulte Regiões e zonas de disponibilidade no Guia do usuário do Amazon Relational Database Service.

false

true

false