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
Nome Descrição Padrão Valores válidos

Availability Zones

As zonas de disponibilidade (AZs) são locais distintos dentro de uma região da AWS e são criadas para ficarem isoladas de falhas em outras AZs. Elas oferecem conectividade de rede de baixa latência e custo reduzido para outras ZDs 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 desaquecimento ajudam a evitar que o Amazon EC2 Auto Scaling inicie ações de escalabilidade adicionais antes que os efeitos de 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 as 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 Manual do usuário do Amazon EC2 Auto 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 (Amazon EC2) do seu ambiente.

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

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

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

DisableIMDSv1

Defina como true para desabilitar 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 do Windows, AL2 e anterior – habilite IMDSv1 e IMDSv2

  • AL2023 — habilite somente 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 par de chaves para fazer login com segurança em sua instância do EC2.

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 da instância habilita que os usuários do AWS Identity and Access Management (IAM) e os produtos da AWS tenham acesso a credenciais de segurança temporárias para fazer chamadas à API da AWS. Especifique o nome do perfil de instância ou o ARN dele.

Exemplos:

  • aws-elasticbeanstalk-ec2-role

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

nota

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

Nenhum

Nome do perfil de instância ou ARN.

ImageId

Você pode substituir a Imagem de máquina da Amazon (AMI) padrão especificando o seu próprio ID de AMI personalizado.

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 é compatível com tipos de instância Mac do Amazon EC2.

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

  • Para obter mais informações os tipos de instâncias disponíveis nas regiões, consulte Tipos de instância disponíveis no Guia do usuário do Amazon EC2 para instâncias do Linux ou tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Windows.

nota

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

Varia por conta e região.

Um tipo de instância do EC2

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

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:

  • Volumes do EBS

  • Instâncias do EC2

  • Interfaces de rede do EC2

  • Modelos de execução do AWS CloudFormation que definem um recurso

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

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 habilitado, a propagação de tags exigirá a substituição do EC2, 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 as métricas do Amazon CloudWatch sejam retornadas.

5 minute

1 minute

5 minute

SecurityGroups

Lista os grupos de segurança do Amazon EC2 para atribuir às instâncias do EC2 no grupo de Auto Scaling para definir regras de firewall para as instâncias.

É possível fornecer uma única string de valores separados por vírgulas que contém o nome de grupos de segurança do Amazon EC2 existentes ou referências aos recursos AWS::EC2::SecurityGroup criados no modelo. Os nomes de security group diferenciam letras maiúsculas de minúsculas.

Se você usar a Amazon Virtual Private Cloud (Amazon VPC) com o Elastic Beanstalk para que suas instâncias sejam executadas em uma virtual private cloud (VPC), especifique os IDs de grupos de segurança em vez de seus nomes.

elasticbeanstalk-default

SSHSourceRestriction

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

Essa string tem o seguinte formato:

protocol, fromPort, toPort, source_restriction

protocolo

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 de CIDR ou o nome de um grupo de segurança pelo qual o tráfego deve ser roteado. Para especificar um grupo de segurança a partir de outra conta (somente EC2-Classic, deve estar na mesma região), inclua o ID da conta antes do nome do grupo de segurança. Use o formato a seguir: other_account_id/security_group_name. Se você usar a Amazon Virtual Private Cloud (Amazon VPC) com o Elastic Beanstalk para que suas instâncias sejam executadas em uma virtual private cloud (VPC), especifique o ID do grupo de segurança em vez de seu nome.

Exemplo: tcp, 22, 22, 54.240.196.185/32

Exemplo: tcp, 22, 22, my-security-group

Exemplo (EC2-Classic): tcp, 22, 22, 123456789012/their-security-group

Exemplo (VPC): tcp, 22, 22, sg-903004f8

Nenhum

BlockDeviceMappings

Anexe os volumes adicionais do Amazon EBS ou volumes de armazenamento de instância em todas as instâncias no grupo de 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 volumes do Amazon EBS, você também especifique alguns ou todos os campos a seguir (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 ou io1)

  • throughput (somente para gp3)

O exemplo a seguir anexa três volumes do Amazon EBS, um volume vazio de 100 GB gp2 e um snapshot, um volume io1 vazio de 20 GB com 2.000 IOPS provisionadas, 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 (SSD magnético, de uso geral ou SSD de IOPS provisionado) a ser usado para o volume raiz do Amazon EBS anexado às instâncias do EC2 para o seu ambiente.

Varia de acordo com a plataforma.

standard para armazenamento magnético.

gp2 ou gp3 para SSD de uso geral.

io1 para SSD com IOPS provisionadas.

RootVolumeSize

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

Obrigatório se você definir RootVolumeType para SSD IOPS provisionadas.

Por exemplo, "64".

Varia por plataforma para armazenamento magnético e SSD de uso geral.

Nenhum para SSD IOPS provisionadas.

10 a 16384 GB para SSD de uso geral e SSD IOPS provisionadas.

8 a 1024 GB para magnético.

RootVolumeIOPS

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

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

Nenhum

100 para 20000 para volumes raízes SSD io1 com IOPS provisionadas.

3000 para 16000 para volumes raizes SSD gp3 de uso geral.

RootVolumeThroughput

O throughput desejado de mebibytes por segundo (MiB/s) para provisionar para o volume raiz do Amazon EBS associado à instância do EC2 de seu ambiente.

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
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 time stamp da ISO-8601 exclusivo em todas as ações de escalabilidade agendadas.

EndTime

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

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

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

Nenhum

Um time stamp da ISO-8601 exclusivo em todas as ações de escalabilidade agendadas.

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
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 instâncias do Amazon EC2 remover ao executar uma ação 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 o Amazon CloudWatch avalia as métricas do trigger. 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 instâncias do Amazon EC2 adicionar ao executar uma ação 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
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.

nota

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

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.

Atualizações contínuas com base em tempo aplicam um PauseTime entre 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.

nota

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

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 da duração de ISO8601: PT#H#M#S em que cada # é o número de horas, minutos e 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
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 é compatível com tipos de instância Mac do Amazon EC2.

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

  • Para obter mais informações os tipos de instâncias disponíveis nas regiões, consulte Tipos de instância disponíveis no Guia do usuário do Amazon EC2 para instâncias do Linux ou tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Windows.

nota

Algumas contas da AWS mais antigas podem fornecer o Elastic Beanstalk com tipos de instância padrão que não oferecem suporte a 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 ambiente e remove um ou mais tipos de instância da opção InstanceTypes, o Elastic Beanstalk encerra todas as instâncias do Amazon EC2 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.

Um a dez tipos de instância do EC2 Recomendamos pelo menos dois

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

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 hora, em US$, que você está disposto a pagar por uma instância spot. Para obter recomendações sobre opções de preço máximo para instâncias spot, consulte o Histórico de definição de preço da instância spot no Manual do usuário do Amazon EC2 para instâncias do Linux.

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

Arquiteturas permitidas

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

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

  • Arquitetura Arm Graviton 64 bits (arm64) da AWS

  • Arquitetura de 64 bits (x86_64)

  • Arquitetura de 32 bits (i386)

Para obter mais informações sobre arquitetura de processador e tipos de instância do Amazon EC2, consulte Tipos de instância do Amazon EC2.

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 iniciar recursos em uma Amazon Virtual Private Cloud (Amazon VPC) personalizada. Se você não definir configurações neste namespace, o Elastic Beanstalk executará recursos na VPC padrão.

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

VPCId

O ID da sua Amazon VPC.

Nenhum

Subnets

Os IDs da sub-rede ou sub-redes do grupo de Auto Scaling. Se você tiver várias sub-redes, especifique o valor como uma string separada por vírgulas simples de IDs de sub-redes (por exemplo, "subnet-11111111,subnet-22222222").

Nenhum

ELBSubnets

Os IDs da sub-rede ou das sub-redes do elastic load balancer. Se você tiver várias sub-redes, especifique o valor como uma string separada por vírgulas simples de IDs de sub-redes (por exemplo, "subnet-11111111,subnet-22222222").

Nenhum

ELBScheme

Especifique internal se você deseja criar um balanceador de carga interno na Amazon VPC para que a aplicação do Elastic Beanstalk não seja acessada de fora dela. Se você especificar um valor diferente de public ou internal, o Elastic Beanstalk ignorará o valor.

public

public

internal

DBSubnets

Contém os IDs de sub-redes de banco de dados. Opção usada somente se você deseja adicionar uma instância de banco de dados do Amazon RDS como parte do seu aplicativo. Se você tiver várias sub-redes, especifique o valor como uma string separada por vírgulas simples de IDs de sub-redes (por exemplo, "subnet-11111111,subnet-22222222").

Nenhum

AssociatePublicIpAddress

Especifica se é para executar instâncias com endereços IP públicos na Amazon VPC. Instâncias com endereços IP públicos não exigem dispositivo NAT para comunicação 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, o qual sempre tem uma única instância do Amazon EC2 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
Nome Descrição Padrão Valores válidos

URL de verificação de integridade do aplicativo

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 conexão TCP na porta 80 para verificar o status de integridade do aplicativo. Configure para um caminho iniciando com / para enviar uma solicitação HTTP GET para esse caminho. Você também pode incluir um protocolo (HTTP, HTTPS, TCP ou SSL) e uma porta antes do caminho para verificar a conectividade HTTPS 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:

/ (HTTP GET para caminho raiz)

/health

HTTPS:443/

HTTPS:443/health

A CLI do EB e o console 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
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 obter mais informações.

aws:elasticbeanstalk:cloudwatch:logs

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

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

StreamLogs

Especifica se é necessário criar grupos nos logs do CloudWatch Logs para logs de proxy e implantação e fazer streaming dos logs de cada instância no 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
Nome Descrição Padrão Valores válidos

HealthStreamingEnabled

Para ambientes com relatórios de integridade aprimorada habilitados, especifica se deve ser criado um grupo no CloudWatch Logs para integridade do ambiente e arquivar 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
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 no BatchSize.

nota

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

Percentage

Percentage

Fixed

BatchSize

A porcentagem ou o número fixo de instâncias do Amazon EC2 no grupo Auto Scaling para executar implantações simultaneamente. Os valores válidos variam dependendo da configuração do BatchSizeType usado.

nota

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

100

1 para 100 (Percentage).

1 a 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
Nome Descrição Padrão Valores válidos

EnvironmentType

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

LoadBalanced

SingleInstance

LoadBalanced

ServiceRole

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

Exemplos:

  • aws-elasticbeanstalk-service-role

  • custom-path/custom-role

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

nota

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

Nenhum

Nome da função do IAM, 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
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, que o Elastic Load Balancing verifica a integridade das instâncias do Amazon EC2 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 as solicitações HTTP para verificações de integridade 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 separada por vírgulas de códigos HTTP 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
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, que o Elastic Load Balancing verifica a integridade das instâncias do Amazon EC2 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 as solicitações HTTP para verificações de integridade 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 separada por vírgulas de códigos HTTP 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

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 o ambiente usar uma versão de plataforma baseada na AMI do Amazon Linux (anterior ao Amazon Linux 2), consulte Opções específicas para a plataforma para os namespaces de arquivos estáticos específicos da plataforma.

Namespace: aws:elasticbeanstalk:environment:proxy:staticfiles
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
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.

nota

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

basic

basic

enhanced

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

EnhancedHealthAuthEnabled

Permite a autorização para a API interna que o Elastic Beanstalk usa para comunicar informações de integridade aprimorada das instâncias do ambiente para o 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 instâncias do EC2 no ambiente para fazer upload de logs alternados para o Amazon S3.

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

LogPublicationControl

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

false

true

false

aws:elasticbeanstalk:managedactions

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

Namespace: aws:elasticbeanstalk:managedactions
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 em UTC.

Por exemplo, "Tue:09:00".

Nenhum

Dia e hora no

dia:hora:minuto

format.

ServiceRoleForManagedUpdates

O nome de uma função do IAM que o Elastic Beanstalk usa para executar atualizações gerenciadas de plataforma para o 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
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 versões principais.secundárias.patch. Por exemplo, a versão 2.0.8 tem uma versão principal 2, uma versão secundária 0 e uma versão de patch 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 instâncias do EC2 que falharem nas verificações de integridade.

Namespace: aws:elasticbeanstalk:monitoring
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
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 de recurso da Amazon (ARN) do tópico no qual você se inscreveu.

Nenhum

Notification Topic Name

O nome do tópico que você assinou.

Nenhum

aws:elasticbeanstalk:sqsd

Configure a fila do Amazon SQS para um ambiente de operador.

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

WorkerQueueURL

A URL da fila em que o daemon no nível de 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 do Amazon SQS. Quando você fornece um valor, pode informar o URL de uma fila padrão ou FIFO do Amazon SQS. Lembre-se de que, se você fornecer uma fila FIFO, as tarefas periódicas não serão compatíveis.

gerado automaticamente

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

HttpPath

O caminho relativo para a aplicação para a qual as mensagens HTTP POST são enviadas.

/

MimeType

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

application/json

application/json

application/x-www-form-urlencoded

application/xml

text/plain

Tipo MIME personalizado.

HttpConnections

O número máximo de conexões simultâneas para quaisquer aplicações dentro de uma instância do Amazon EC2.

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

O tempo, em segundos, em que uma mensagem recebida da fila do Amazon SQS 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

O tempo, em segundos, que o Elastic Beanstalk deve aguardar para retornar uma mensagem à fila do Amazon SQS após uma falha com erro explícito ao tentar processá-la.

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
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 daemon do AWS X-Ray para retransmitir informações de rastreamento de sua aplicação integrada ao X-Ray.

Namespace: aws:elasticbeanstalk:xray
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
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 instâncias do Amazon EC2 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

Destino no formato PROTOCOLO:PORTA/CAMINHO

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.

nota

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

false

true

false

SecurityGroups

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

Nenhum

Um ou mais IDs de security groups

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 instâncias do EC2 do seu ambiente, o Elastic Beanstalk adiciona uma regra ao security group das instâncias que permite o tráfego de entrada do security group 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 Amazon Resource Name (ARN) de um certificado SSL para vincular ao listener 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 listener usa para se comunicar com as instâncias do EC2. 80 1 para 65535
InstanceProtocol

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

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. Sugerimos que você use a opção LoadBalancerPorts do namespace aws:elb:policies. 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 listener usa para se comunicar com as instâncias do EC2. Igual a listener_port. 1 para 65535

InstanceProtocol

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

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. Sugerimos que você use a opção LoadBalancerPorts do namespace aws:elb:policies. Nenhum

SSLCertificateId

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

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

nota

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

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
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 pode ser associada somente a listeners HTTP/HTTPS. 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 política ProxyProtocolPolicyType, especifique se deseja ou não incluir o endereço IP e a porta da solicitação de origem de mensagens TCP. Essa política pode ser associada somente a listeners TCP/SSL.

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 backend que estejam usando HTTPS/SSL.

Nenhum

SSLProtocols

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

Nenhum

SSLReferencePolicy

O nome de uma política de segurança predefinida que segue as práticas recomendadas de segurança da AWS e que você deseja ativar para uma política SSLNegotiationPolicyType que define as cifras e os protocolos que são aceitos pelo balanceador de carga. Essa política pode ser associada somente a listeners HTTPS/SSL.

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
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 nome de recurso da Amazon (ARN) do certificado SSL a ser vinculado ao listener.

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

Nenhum

O ARN de um certificado armazenado no IAM ou no ACM.

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 (padrão do ELB)

O nome de uma política de segurança do balanceador de carga.

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
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 nome de recurso da Amazon (ARN) do certificado SSL a ser vinculado ao listener.

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

Nenhum

O ARN de um certificado armazenado no IAM ou no ACM.

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 (padrão do ELB)

O nome de uma política de segurança do balanceador de carga.

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

Load balancer compartilhado: o CNAME do ambiente

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
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 faz upload de logs para um diretório chamado AWSLogs no bucket que você especificar. Especifique um prefixo para colocar o diretório AWSLogs 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 instâncias do EC2 para o seu ambiente, o Elastic Beanstalk adiciona uma regra ao security group de suas instâncias que permite o tráfego de entrada do security group 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 da instância do Amazon EC2.

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

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

SharedLoadBalancer

O nome de recurso da Amazon (ARN) do balanceador de carga. 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. Não é possível alterar o ARN do balanceador de carga compartilhado 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 na região da AWS onde o ambiente está localizado.

  • Ele deve estar na mesma Amazon Virtual Private Cloud (Amazon VPC) que o 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

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

aws:rds:dbinstance

Configure uma instância de banco de dados anexada do Amazon RDS.

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

DBAllocatedStorage

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

MySQL: 5

Oracle: 10

sqlserver-se: 200

sqlserver-ex: 30

sqlserver-web: 30

MySQL: 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.large para um ambiente que não está em execução em uma Amazon VPC)

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 as Regiões e zonas de disponibilidade no Guia do usuário do Amazon Relational Database Service.

false

true

false