Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ESS::EciScalingConfiguration

Última atualização: Jun 30, 2026

Define uma configuração de dimensionamento de Elastic Container Instance (ECI) para o Auto Scaling.

Sintaxe

{
  "Type": "ALIYUN::ESS::EciScalingConfiguration",
  "Properties": {
    "ContainerGroupName": String,
    "ScalingConfigurationName": String,
    "ScalingGroupId": String,
    "SecurityGroupId": String,
    "AutoMatchImageCache": Boolean,
    "ActiveDeadlineSeconds": Integer,
    "AcrRegistryInfos": List,
    "AutoCreateEip": Boolean,
    "Containers": List,
    "Cpu": Number,
    "CpuOptionsThreadsPerCore": Integer,
    "CpuOptionsCore": Integer,
    "CostOptimization": Boolean,
    "DnsConfigSearches": List,
    "DataCachePL": String,
    "DataCacheProvisionedIops": Integer,
    "DataCacheBucket": String,
    "DnsConfigOptions": List,
    "DnsConfigNameServers": List,
    "DataCacheBurstingEnabled": Boolean,
    "DnsPolicy": String,
    "EgressBandwidth": Integer,
    "EipBandwidth": Integer,
    "EphemeralStorage": Integer,
    "HostName": String,
    "HostAliases": List,
    "IngressBandwidth": Integer,
    "ImageSnapshotId": String,
    "Ipv6AddressCount": Integer,
    "InstanceTypes": List,
    "InitContainers": List,
    "ImageRegistryCredentials": List,
    "InstanceFamilyLevel": String,
    "LoadBalancerWeight": Integer,
    "Memory": Number,
    "NtpServers": List,
    "ResourceGroupId": String,
    "RamRoleName": String,
    "RestartPolicy": String,
    "SpotPriceLimit": Number,
    "SpotStrategy": String,
    "SecurityContextSysctls": List,
    "Tags": List,
    "TerminationGracePeriodSeconds": Integer,
    "Volumes": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ContainerGroupName

String

Sim

Não

Nome da instância de contêiner elástica.

Esta propriedade também especifica o nome do grupo de contêineres.

Para configurar nomes sequenciais, utilize o seguinte formato: name_prefix(AUTO_INCREMENT)[begin_number,bits]name_suffix. A seção a seguir descreve como configurar hostnames sequenciais:

  • name_prefix: prefixo do hostname.

  • (AUTO_INCREMENT): valor fixo que define o modo de ordenação.

  • begin_number: valor inicial da sequência. Valores válidos: 0 a 999999.

  • bits: quantidade de dígitos nos valores sequenciais. Valores válidos: 1 a 6. Se o número de dígitos do campo begin_number for maior que o valor de bits, o sistema ajustará automaticamente bits para 6.

Nota

Recomenda-se definir o campo bits com um valor igual ou superior a 3. Caso contrário, o limite superior dos valores sequenciais pode ser atingido rapidamente. Se operações de scale-out ainda forem necessárias após atingir esse limite, o sistema retornará um erro e interromperá o scale-out. Nesse cenário, será necessário reconfigurar as regras de geração de hostnames.

  • name_suffix: sufixo do hostname. Este campo é opcional.

Nota

A parte [begin_number,bits] não pode conter espaços. Por padrão, os hostnames sequenciais são incrementados com base em um valor fixo. Se o Auto Scaling falhar ao iniciar uma instância de contêiner elástica em um grupo de dimensionamento durante um evento de scale-out, ele removerá essa instância do grupo e criará outra. Nessa situação, os hostnames das instâncias no grupo podem apresentar um padrão de incremento intermitente.

Por exemplo, se você especificar nginx-test-(AUTO_INCREMENT)[0,3] para esta propriedade, os nomes sequenciais das instâncias serão nginx-test-000, nginx-test-001 e nginx-test-002.

As regras para configurar nomes sequenciais em instâncias de contêiner elásticas são semelhantes às regras para instâncias do Elastic Compute Service (ECS). Para mais informações, consulte Configurar regras de nomenclatura para instâncias ECS.

ScalingConfigurationName

String

Sim

Não

Nome da configuração de dimensionamento.

O nome deve ter entre 2 e 64 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com um dígito ou uma letra.

O nome da configuração de dimensionamento deve ser único dentro do grupo de dimensionamento em uma região. Se esta propriedade não for especificada, o ID da configuração de dimensionamento será utilizado.

ScalingGroupId

String

Sim

Não

ID do grupo de dimensionamento para o qual se deseja criar a configuração de dimensionamento.

Nenhuma.

SecurityGroupId

String

Sim

Não

ID do grupo de segurança ao qual as instâncias de contêiner elásticas pertencem.

Instâncias de contêiner elásticas associadas ao mesmo grupo de segurança podem se comunicar entre si.

Se nenhum grupo de segurança for especificado, o sistema utilizará automaticamente o grupo de segurança padrão da região selecionada. Certifique-se de que as regras de entrada do grupo de segurança incluam os protocolos e portas dos contêineres a serem expostos. Caso não exista um grupo de segurança padrão na região, o sistema criará um automaticamente e adicionará os protocolos e portas especificados às regras de entrada.

AutoMatchImageCache

Boolean

Não

Sim

Indica se o cache de imagem deve ser correspondido automaticamente.

Valores válidos:

  • true

  • false

Valor padrão: false.

ActiveDeadlineSeconds

Integer

Não

Sim

Período de validade.

Unidade: segundos.

AcrRegistryInfos

List

Não

Sim

Informações sobre as instâncias do Container Registry Enterprise Edition.

Para mais detalhes, consulte a seção "Propriedades de AcrRegistryInfos" deste tópico.

AutoCreateEip

Boolean

Não

Sim

Define se endereços IP elásticos (EIPs) devem ser criados automaticamente.

Nenhuma.

Containers

List

Não

Sim

Contêineres presentes na instância de contêiner elástica.

Para mais informações, consulte Propriedades de Containers.

Cpu

Number

Não

Sim

Quantidade de vCPUs do contêiner.

Nenhuma.

CpuOptionsThreadsPerCore

Integer

Não

Sim

Número de threads por núcleo.

Esta propriedade só pode ser especificada para tipos de instância específicos. O valor 1 indica que o Hyper-Threading está desativado. Para mais informações, consulte Especificar opções de CPU.

CpuOptionsCore

Integer

Não

Sim

Quantidade de núcleos físicos de CPU.

Aplicável apenas a tipos de instância específicos. Para mais detalhes, consulte Especificar opções de CPU.

CostOptimization

Boolean

Não

Sim

Habilita ou não o recurso de Otimização de Custos.

Valores válidos:

  • true

  • false

DnsConfigSearches

List

Não

Sim

Domínios de busca dos servidores DNS (Domain Name System).

Nenhuma.

DataCachePL

String

Não

Sim

Nível de desempenho (PL) do disco em nuvem usado para armazenar caches de dados.

Recomenda-se o uso de Enterprise SSDs (ESSDs). Valores válidos para esta propriedade ao usar ESSDs:

  • PL0: Um ESSD oferece até 10.000 IOPS de leitura/gravação aleatória.

  • PL1: Um ESSD oferece até 50.000 IOPS de leitura/gravação aleatória.

  • PL2: Um ESSD oferece até 100.000 IOPS de leitura/gravação aleatória.

  • PL3: Um ESSD oferece até 1.000.000 IOPS de leitura/gravação aleatória.

DataCacheProvisionedIops

Integer

Não

Sim

IOPS provisionados de leitura/gravação do disco ESSD AutoPL.

Esta propriedade entra em vigor quando discos ESSD AutoPL são usados para armazenar caches de dados. Valores válidos: 0 a min{50000, 1000 × Capacidade - IOPS Baseline}, onde IOPS Baseline = min{1800 + 50 × Capacidade, 50000}.

DataCacheBucket

String

Não

Sim

Bucket destinado ao armazenamento de caches de dados.

Nenhuma.

DnsConfigOptions

List

Não

Sim

Opções de configuração.

Consulte a seção "Propriedades de DnsConfigOptions" neste tópico para mais informações.

DnsConfigNameServers

List

Não

Sim

Endereços IP dos servidores DNS.

Nenhuma.

DataCacheBurstingEnabled

Boolean

Não

Sim

Ativa ou não o recurso de pico de desempenho.

Esta propriedade tem efeito quando discos ESSD AutoPL são utilizados para caches de dados. Valores válidos:

  • true

  • false

DnsPolicy

String

Não

Sim

Política de DNS.

Valores válidos:

  • None: utiliza o DNS especificado em DnsConfig.

  • Default: utiliza o DNS definido pelo ambiente de execução.

EgressBandwidth

Integer

Não

Sim

Largura de banda de saída máxima.

Unidade: bytes.

EipBandwidth

Integer

Não

Sim

Largura de banda do EIP.

Valor padrão: 5. Unidade: Mbit/s.

EphemeralStorage

Integer

Não

Sim

Capacidade do armazenamento efêmero.

Por padrão, são utilizados ESSDs PL1. Unidade: GiB.

HostName

String

Não

Sim

Hostname.

Nenhuma.

HostAliases

List

Não

Sim

Mapeamento personalizado de hostname para um contêiner na instância de contêiner elástica.

Nenhuma.

IngressBandwidth

Integer

Não

Sim

Largura de banda de entrada máxima.

Unidade: bytes.

ImageSnapshotId

String

Não

Sim

ID do cache de imagem.

Nenhuma.

Ipv6AddressCount

Integer

Não

Sim

Quantidade de endereços IPv6.

Nenhuma.

InstanceTypes

List

Não

Sim

Tipos de instância ECS.

É possível especificar até cinco tipos de instância ECS. Para mais informações, consulte Especificar tipos de instância ECS para criar uma instância de contêiner elástica.

InitContainers

List

Não

Sim

Contêineres de inicialização.

Consulte a seção "Propriedades de InitContainers" deste tópico para mais detalhes.

ImageRegistryCredentials

List

Não

Sim

Informações sobre os repositórios de imagens.

Nenhuma.

InstanceFamilyLevel

String

Não

Sim

Nível da família de instâncias.

Use esta propriedade para filtrar os tipos de instância que atendem aos seus requisitos. Ela entra em vigor quando CostOptimization está definido como true. Valores válidos:

  • EntryLevel: nível de entrada (tipos de instância compartilhada). Tipos deste nível oferecem o melhor custo-benefício, mas podem não garantir desempenho computacional consistente. São adequados para cenários de negócios com baixa utilização de CPU. Para mais informações, consulte Famílias de instâncias compartilhadas.

  • EnterpriseLevel: nível empresarial. Oferecem desempenho estável e recursos dedicados, sendo ideais para cenários que exigem alta estabilidade. Consulte Visão geral das famílias de instâncias para detalhes.

  • CreditEntryLevel: nível de entrada baseado em créditos (tipos de instância com capacidade de pico). Utilizam créditos de CPU para garantir o desempenho computacional. Indicados para cenários onde a utilização da CPU é geralmente baixa, mas pode apresentar picos esporádicos. Veja Instâncias com capacidade de pico para saber mais.

LoadBalancerWeight

Integer

Não

Sim

Peso da instância de contêiner elástica atuando como servidor backend.

Valores válidos: 1 a 100.

Memory

Number

Não

Sim

Tamanho da memória do contêiner.

Nenhuma.

NtpServers

List

Não

Sim

Servidores NTP (Network Time Protocol).

Nenhuma.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

RamRoleName

String

Não

Sim

Nome da função do Resource Access Management (RAM) para a instância de contêiner elástica.

Instâncias de contêiner elásticas e instâncias ECS compartilham a mesma função RAM.

RestartPolicy

String

Não

Sim

Política de reinicialização da instância de contêiner elástica.

Valores válidos:

  • Never: A instância nunca é reiniciada.

  • Always: A instância é sempre reiniciada.

  • OnFailure: A instância é reiniciada apenas em caso de falha.

SpotPriceLimit

Number

Não

Sim

Preço máximo por hora para uma instância preemptível.

Esta propriedade é retornada somente quando SpotStrategy está definido como SpotWithPriceLimit.

SpotStrategy

String

Não

Sim

Política de preempção para a instância de contêiner elástica.

Valores válidos:

  • NoSpot: A instância é criada como uma instância regular com pagamento conforme o uso.

  • SpotWithPriceLimit: A instância é criada como preemptível com um preço máximo por hora definido pelo usuário.

  • SpotAsPriceGo: A instância é criada como preemptível e o preço do lance segue o preço de mercado no momento da compra.

SecurityContextSysctls

List

Não

Sim

Informações de sistema sobre o contexto de segurança no qual a instância de contêiner elástica executa.

Nenhuma.

Tags

List

Não

Sim

Tags da instância de contêiner elástica. As tags seguem o formato de par chave-valor.

Para mais informações, consulte Propriedades de Tags.

TerminationGracePeriodSeconds

Integer

Não

Sim

Tempo de buffer do programa.

Período de tolerância durante o qual o programa processa operações antes de ser encerrado.

Volumes

List

Não

Sim

Informações sobre os volumes.

Para mais detalhes, consulte Propriedades de Volumes.

Sintaxe de Containers

"Containers": [
  {
    "EnvironmentVars": List,
    "ReadinessProbeExecCommands": List,
    "Memory": Number,
    "ReadinessProbeTcpSocketPort": Integer,
    "Cpu": Number,
    "ReadinessProbeHttpGetPath": String,
    "ReadinessProbeHttpGetScheme": String,
    "Image": String,
    "Gpu": Integer,
    "StdinOnce": Boolean,
    "Name": String,
    "LivenessProbeHttpGetScheme": String,
    "LivenessProbeTimeoutSeconds": Integer,
    "LivenessProbeFailureThreshold": Integer,
    "LivenessProbeHttpGetPath": String,
    "VolumeMounts": List,
    "LivenessProbeInitialDelaySeconds": Integer,
    "SecurityContextRunAsUser": Integer,
    "LivenessProbeTcpSocketPort": Integer,
    "Commands": List,
    "Tty": Boolean,
    "ReadinessProbePeriodSeconds": Integer,
    "LivenessProbePeriodSeconds": Integer,
    "LivenessProbeExecCommands": List,
    "LivenessProbeSuccessThreshold": Integer,
    "ReadinessProbeSuccessThreshold": Integer,
    "ReadinessProbeInitialDelaySeconds": Integer,
    "Args": List,
    "ReadinessProbeFailureThreshold": Integer,
    "SecurityContextCapabilitiesAdd": List,
    "Ports": List,
    "ReadinessProbeHttpGetPort": Integer,
    "Stdin": Boolean,
    "WorkingDir": String,
    "ImagePullPolicy": String,
    "LivenessProbeHttpGetPort": Integer,
    "ReadinessProbeTimeoutSeconds": Integer
  }
]

Propriedades de containers

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

EnvironmentVars

List

Não

Sim

Variáveis de ambiente.

Para mais informações, consulte Propriedades de EnvironmentVars.

ReadinessProbeExecCommands

List

Não

Sim

Comandos executados no contêiner para realizar sondas de prontidão.

Nenhuma.

Memory

Number

Não

Sim

Tamanho da memória.

Nenhuma.

ReadinessProbeTcpSocketPort

Integer

Não

Sim

Porta dos sockets TCP para sondas de prontidão.

Nenhuma.

Cpu

Number

Não

Sim

Quantidade de vCPUs do contêiner.

Nenhuma.

ReadinessProbeHttpGetPath

String

Não

Sim

Caminho para o qual o sistema envia requisições HTTP GET nas sondas de prontidão.

Nenhuma.

ReadinessProbeHttpGetScheme

String

Não

Sim

Tipo de protocolo das requisições HTTP GET para sondas de prontidão.

Valores válidos:

  • HTTP

  • HTTPS

Image

String

Sim

Sim

Imagem do contêiner.

Nenhuma.

Gpu

Integer

Não

Sim

Número de GPUs utilizadas pelo contêiner.

Nenhuma.

StdinOnce

Boolean

Não

Sim

Define se o recurso de persistência de sessão está ativado.

Quando Stdin é definido como true, os fluxos de entrada padrão permanecem abertos em várias sessões de anexação.

Se StdinOnce for definido como true, os fluxos de entrada padrão serão abertos na inicialização do contêiner, permanecerão vazios até que o primeiro cliente seja anexado e continuarão abertos para receber dados até que o cliente seja desanexado. Após a desanexação do cliente, os fluxos de entrada padrão são fechados e assim permanecem até que o contêiner seja reiniciado.

Name

String

Sim

Sim

Nome personalizado do contêiner.

Nenhuma.

LivenessProbeHttpGetScheme

String

Não

Sim

Tipo de protocolo das requisições HTTP GET para sondas de atividade.

Valores válidos:

  • HTTP

  • HTTPS

LivenessProbeTimeoutSeconds

Integer

Não

Sim

Período de tempo limite de uma sonda de atividade.

Valor padrão: 1. Valor mínimo: 1. Unidade: segundos.

LivenessProbeFailureThreshold

Integer

Não

Sim

Número de falhas consecutivas necessárias em uma sonda de atividade anteriormente bem-sucedida para que ela seja considerada como falha.

Valor padrão: 3.

LivenessProbeHttpGetPath

String

Não

Sim

Caminho para o qual o sistema envia requisições HTTP GET nas sondas de atividade.

Nenhuma.

VolumeMounts

List

Não

Sim

Volumes a serem montados.

Para mais informações, consulte Propriedades de VolumeMounts.

LivenessProbeInitialDelaySeconds

Integer

Não

Sim

Intervalo entre a inicialização do contêiner e o início de uma sonda de atividade.

SecurityContextRunAsUser

Integer

Não

Sim

ID do usuário que executa o contêiner.

Nenhuma.

LivenessProbeTcpSocketPort

Integer

Não

Sim

Porta dos sockets TCP para sondas de atividade.

Nenhuma.

Commands

List

Não

Sim

Comandos de inicialização do contêiner.

É possível especificar até 20 comandos de inicialização. Cada comando pode ter até 256 caracteres.

Tty

Boolean

Não

Sim

Define se o recurso de Interação está ativado.

Valores válidos:

  • true

  • false

ReadinessProbePeriodSeconds

Integer

Não

Sim

Intervalo em que o sistema executa sondas de prontidão.

Valor padrão: 10. Valor mínimo: 1. Unidade: segundos.

LivenessProbePeriodSeconds

Integer

Não

Sim

Intervalo em que o sistema executa sondas de atividade.

Valor padrão: 10. Valor mínimo: 1. Unidade: segundos.

LivenessProbeExecCommands

List

Não

Sim

Comandos executados para realizar sondas de atividade.

Os comandos são executados dentro do contêiner.

LivenessProbeSuccessThreshold

Integer

Não

Sim

Número de sucessos consecutivos necessários em uma sonda de atividade anteriormente falha para que ela seja considerada bem-sucedida.

Valor padrão: 1. Defina o valor como 1.

ReadinessProbeSuccessThreshold

Integer

Não

Sim

Número de sucessos consecutivos necessários em uma sonda de prontidão anteriormente falha para que ela seja considerada bem-sucedida.

Valor padrão: 1. Defina o valor como 1.

ReadinessProbeInitialDelaySeconds

Integer

Não

Sim

Período de espera da operação de scale-out ou scale-in.

Valores válidos: 0 a 3600. Unidade: segundos. Valor padrão: 0.

Args

List

Não

Sim

Argumentos correspondentes aos comandos de inicialização do contêiner.

É possível especificar até 10 argumentos.

ReadinessProbeFailureThreshold

Integer

Não

Sim

Número de falhas consecutivas necessárias em uma sonda de prontidão anteriormente bem-sucedida para que ela seja considerada como falha.

Valor padrão: 3.

SecurityContextCapabilitiesAdd

List

Não

Sim

Permissões a serem concedidas aos processos no contêiner de inicialização.

Valores válidos:

  • NET_ADMIN

  • NET_RAW

Ports

List

Não

Sim

Portas e protocolos a serem expostos.

Para mais informações, consulte Propriedades de Ports.

ReadinessProbeHttpGetPort

Integer

Não

Sim

Porta das requisições HTTP GET para sondas de prontidão.

Nenhuma.

Stdin

Boolean

Não

Sim

Define se o contêiner pode alocar um buffer para fluxos de entrada padrão no runtime do contêiner.

Se você não especificar essa propriedade, ocorrerá um erro de fim de arquivo (EOF).

Valor padrão: false.

WorkingDir

String

Não

Sim

Diretório de trabalho.

Nenhuma.

ImagePullPolicy

String

Não

Sim

Política de pull de imagem.

Nenhuma.

LivenessProbeHttpGetPort

Integer

Não

Sim

Porta das requisições HTTP GET para sondas de atividade.

Nenhuma.

ReadinessProbeTimeoutSeconds

Integer

Não

Sim

Período de tempo limite de uma sonda de prontidão.

Valor padrão: 1. Valor mínimo: 1. Unidade: segundos.

Sintaxe de EnvironmentVars

"EnvironmentVars": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedades de EnvironmentVars

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Value

String

Não

Sim

Valor da variável de ambiente.

Nenhuma.

Key

String

Não

Sim

Nome da variável de ambiente.

Nenhuma.

Sintaxe de AcrRegistryInfos

"AcrRegistryInfos": [
  {
    "RegionId": String,
    "InstanceId": String,
    "Domains": List,
    "InstanceName": String
  }
]

Propriedades de AcrRegistryInfos

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

RegionId

String

Não

Sim

ID da região da instância do Container Registry Enterprise Edition.

Nenhuma.

InstanceId

String

Sim

Sim

ID da instância do Container Registry Enterprise Edition.

Nenhuma.

Domains

List

Não

Sim

Nomes de domínio da instância do Container Registry Enterprise Edition.

Nenhuma.

InstanceName

String

Não

Sim

Nome da instância do Container Registry Enterprise Edition.

Nenhuma.

Sintaxe de InitContainers

"InitContainers": [
  {
    "SecurityContextRunAsUser": Integer,
    "Memory": Number,
    "Args": List,
    "ImagePullPolicy": String,
    "Commands": List,
    "Gpu": Integer,
    "WorkingDir": String,
    "InitContainerEnvironmentVars": List,
    "SecurityContextCapabilitiesAdd": List,
    "Cpu": Number,
    "InitContainerVolumeMounts": List,
    "Image": String,
    "Name": String
  }
]

Propriedades de InitContainers

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

SecurityContextRunAsUser

Integer

Não

Sim

ID do usuário que executa o contêiner.

Nenhuma.

Memory

Number

Não

Sim

Tamanho da memória.

Nenhuma.

Args

List

Não

Sim

Argumentos correspondentes aos comandos de inicialização do contêiner.

É possível especificar até 10 argumentos.

ImagePullPolicy

String

Não

Sim

Política de pull de imagem.

Nenhuma.

Commands

List

Não

Sim

Comandos de inicialização do contêiner.

É possível especificar até 20 comandos de inicialização. Cada comando pode ter até 256 caracteres.

Gpu

Integer

Não

Sim

Número de GPUs utilizadas pelo contêiner.

Nenhuma.

WorkingDir

String

Não

Sim

Diretório de trabalho.

Nenhuma.

InitContainerEnvironmentVars

List

Não

Sim

Informações sobre as variáveis de ambiente.

Para mais informações, consulte a seção "Propriedades de InitContainerEnvironmentVars" deste tópico.

SecurityContextCapabilitiesAdd

List

Não

Sim

Permissões a serem concedidas aos processos no contêiner.

Valores válidos: NET_ADMIN e NET_RAW.

Cpu

Number

Não

Sim

Quantidade de vCPUs.

Nenhuma.

InitContainerVolumeMounts

List

Não

Sim

Volumes a serem montados.

Para mais informações, consulte a seção "Propriedades de InitContainerVolumeMounts" deste tópico.

Image

String

Sim

Sim

Imagem do contêiner.

Nenhuma.

Name

String

Sim

Sim

Nome do contêiner.

Nenhuma.

Sintaxe de VolumeMounts

"VolumeMounts": [
  {
    "ReadOnly": Boolean,
    "MountPath": String,
    "SubPath": String,
    "MountPropagation": String,
    "Name": String
  }
]

Propriedades de VolumeMounts

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ReadOnly

Boolean

Não

Sim

Define se o diretório de montagem é somente leitura.

Nenhuma.

MountPath

String

Não

Sim

Diretório de montagem.

Os dados neste diretório são sobrescritos pelos dados do volume. Tenha cuidado ao especificar esta propriedade.

SubPath

String

Não

Sim

Subdiretório do volume.

Use esta propriedade para montar subdiretórios do mesmo volume em diretórios do contêiner no pod.

MountPropagation

String

Não

Sim

Configurações de propagação de montagem do volume.

A propagação de montagem permite que volumes montados em um contêiner sejam compartilhados com outros contêineres no mesmo pod, ou até mesmo com outros pods no mesmo nó. Valores válidos:

  • None: A montagem do volume não recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios.

  • HostToCotainer: A montagem do volume recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios.

  • Bidirectional: Semelhante ao HostToCotainer. A montagem do volume recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios. Além disso, todas as montagens de volume realizadas no contêiner são propagadas de volta para o host e para todos os contêineres de todos os pods que usam o mesmo volume.

Name

String

Não

Sim

Nome do volume a ser montado.

Nenhuma.

Sintaxe de InitContainerVolumeMounts

"VolumeMounts": [
  {
    "ReadOnly": Boolean,
    "MountPath": String,
    "SubPath": String,
    "MountPropagation": String,
    "Name": String
  }
]

Propriedades de InitContainerVolumeMounts

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ReadOnly

Boolean

Não

Sim

Define se o diretório de montagem é somente leitura.

Nenhuma.

MountPath

String

Não

Sim

Diretório de montagem.

Os dados neste diretório são sobrescritos pelos dados do volume. Tenha cuidado ao especificar esta propriedade.

SubPath

String

Não

Sim

Subdiretório do volume.

Use esta propriedade para montar subdiretórios do mesmo volume em diretórios do contêiner no pod.

MountPropagation

String

Não

Sim

Configurações de propagação de montagem do volume.

A propagação de montagem permite que volumes montados em um contêiner sejam compartilhados com outros contêineres no mesmo pod, ou até mesmo com outros pods no mesmo nó. Valores válidos:

  • None: A montagem do volume não recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios.

  • HostToCotainer: A montagem do volume recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios.

  • Bidirectional: Semelhante ao HostToCotainer. A montagem do volume recebe montagens subsequentes realizadas neste volume ou em seus subdiretórios. Além disso, todas as montagens de volume realizadas no contêiner são propagadas de volta para o host e para todos os contêineres de todos os pods que usam o mesmo volume.

Name

String

Sim

Sim

Nome do volume a ser montado.

Nenhuma.

Sintaxe de InitContainerEnvironmentVars

"InitContainerEnvironmentVars": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedades de InitContainerEnvironmentVars

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Não

Sim

Nome da variável de ambiente

O nome deve ter de 1 a 128 caracteres e pode conter letras, dígitos e sublinhados (_). Não pode começar com um dígito.

Value

String

Não

Sim

Valor da variável de ambiente.

O valor pode ter até 256 caracteres.

Sintaxe de HostAliases

"HostAliases": [
  {
    "Ip": String,
    "Hostnames": List
  }
]

Propriedades de HostAliases

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Ip

String

Sim

Sim

Endereço IP.

Nenhuma.

Hostnames

List

Não

Sim

Nomes de host.

Nenhuma.

Sintaxe de DnsConfigOptions

"DnsConfigOptions": [
  {
    "Value": String,
    "Name": String
  }
]

Propriedades de DnsConfigOptions

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Value

String

Sim

Sim

Valor da opção.

Nenhuma.

Name

String

Sim

Sim

Nome da opção.

Nenhuma.

Sintaxe de SecurityContextSysctls

"SecurityContextSysctls": [
  {
    "Value": String,
    "Name": String
  }
]

Propriedades de SecurityContextSysctls

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Name

String

Sim

Sim

Nome da variável do contexto de segurança no qual a instância de contêiner elástica é executada.

Nenhuma.

Value

String

Não

Sim

Valor da variável do contexto de segurança no qual a instância de contêiner elástica é executada.

Nenhuma.

Sintaxe de ImageRegistryCredentials

"ImageRegistryCredentials": [
  {
    "UserName": String,
    "Server": String,
    "Password": String
  }
]

Propriedades de ImageRegistryCredentials

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

UserName

String

Sim

Sim

Nome de usuário do repositório de imagens.

Nenhuma.

Server

String

Sim

Sim

Endereço registrado do repositório de imagens.

Nenhuma.

Password

String

Sim

Sim

Senha do repositório de imagens.

Nenhuma.

Sintaxe de Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Sim

A chave da tag.

Nenhuma.

Value

String

Não

Sim

O valor da tag.

Nenhuma.

Sintaxe de Volumes

"Volumes": [
  {
    "HostPathVolumeType": String,
    "EmptyDirVolumeSizeLimit": String,
    "FlexVolumeFsType": String,
    "NFSVolumeServer": String,
    "DiskVolumeDiskSize": Integer,
    "ConfigFileVolumeConfigFileToPaths": List,
    "Name": String,
    "NFSVolumeReadOnly": Boolean,
    "HostPathVolumePath": String,
    "NFSVolumePath": String,
    "Type": String,
    "FlexVolumeDriver": String,
    "DiskVolumeDiskId": String,
    "ConfigFileVolumeDefaultMode": Integer,
    "FlexVolumeOptions": String,
    "EmptyDirVolumeMedium": String
  }
]

Propriedades de Volumes

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

HostPathVolumeType

String

Não

Sim

O tipo do volume hostPath.

Nenhuma.

EmptyDirVolumeSizeLimit

String

Não

Sim

O tamanho do volume emptyDir.

Nenhuma.

FlexVolumeFsType

String

Não

Sim

O tipo do sistema de arquivos a ser montado.

Nenhuma.

NFSVolumeServer

String

Não

Sim

O endereço do servidor Network File System (NFS).

Nenhuma.

DiskVolumeDiskSize

Integer

Não

Sim

O tamanho do volume de disco.

Unidade: GiB.

ConfigFileVolumeConfigFileToPaths

List

Não

Sim

Os caminhos dos volumes ConfigFile.

Para mais informações, consulte Propriedades de ConfigFileVolumeConfigFileToPaths.

Name

String

Sim

Sim

O nome do volume.

Nenhuma.

NFSVolumeReadOnly

Boolean

Não

Sim

Indica se o volume NFS é somente leitura.

Nenhuma.

HostPathVolumePath

String

Não

Sim

O caminho do volume hostPath no host.

Nenhuma.

NFSVolumePath

String

Não

Sim

O caminho do volume NFS.

Nenhuma.

Type

String

Sim

Sim

O tipo do volume.

Valores válidos:

  • EmptyDirVolume: um volume emptyDir.

  • NFSVolume: um volume NFS.

  • ConfigFileVolume: um volume ConfigFile.

  • FlexVolume: um volume montado com FlexVolume.

FlexVolumeDriver

String

Não

Sim

O nome do driver FlexVolume.

Nenhuma.

DiskVolumeDiskId

String

Não

Sim

O ID do volume de disco.

Nenhuma.

ConfigFileVolumeDefaultMode

Integer

Não

Sim

As permissões padrão no volume ConfigFile.

Nenhuma.

FlexVolumeOptions

String

Não

Sim

As opções do FlexVolume.

Cada opção é um par chave-valor no formato JSON.

Por exemplo, ao usar o FlexVolume para montar um disco em nuvem, especifique um valor para esta propriedade no formato {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"}.

EmptyDirVolumeMedium

String

Não

Sim

O meio de armazenamento do volume emptyDir.

Por padrão, esta propriedade está vazia e o sistema de arquivos do nó é utilizado. Você pode definir esta propriedade como memory. O valor memory indica que a memória será usada.

Sintaxe de ConfigFileVolumeConfigFileToPaths

"ConfigFileVolumeConfigFileToPaths": [
  {
    "Path": String,
    "Content": String,
    "Mode": Integer
  }
]

Propriedades de ConfigFileVolumeConfigFileToPaths

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Path

String

Sim

Sim

O caminho relativo do arquivo de configuração.

Nenhuma.

Content

String

Não

Sim

O conteúdo do arquivo de configuração.

Nenhuma.

Mode

Integer

Não

Sim

As permissões no diretório do volume ConfigFile.

Nenhuma.

Sintaxe de Ports

"Ports": [
  {
    "Port": Integer,
    "Protocol": String
  }
]

Propriedades de Ports

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Port

Integer

Sim

Sim

A porta.

Valores válidos: 1 a 65535.

Protocol

String

Sim

Sim

O tipo de protocolo.

Valores válidos:

  • TCP

  • UDP

Valores de retorno

Fn::GetAtt

ScalingConfigurationId: o ID da configuração de dimensionamento.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  SecurityGroupId:
    AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
    Required: true
    Type: String
    Description:
      en: |-
        The ID of the security group with which you want to associate the elastic container instance. Elastic container instances that are associated with the same security group can access each other.
        If you do not specify a security group, the system uses the default security group in the region that you selected. Make sure that the inbound rules of the security group contain the protocols and the port numbers of the containers that you want to expose. If you do not have a default security group in the region, the system creates a default security group and adds the declared container protocols and port numbers to the inbound rules of the security group.
  ContainerGroupName:
    Required: true
    Type: String
    Description:
      en: The name of the elastic container instance.
  ScalingConfigurationName:
    Required: true
    Type: String
    Description:
      en: |-
        The name of the scaling configuration. The name must be 2 to 64 characters in length and can contain letters, digits, underscores (_), hyphens (-), and periods (.). The name must start with a letter or a digit.
        The name of the scaling configuration must be unique in a region. If you do not specify this parameter, the scaling configuration ID is used.
  ScalingGroupId:
    AssociationProperty: ALIYUN::ESS::AutoScalingGroup::AutoScalingGroupId
    Required: true
    Type: String
    Description:
      en: The ID of the scaling group for which you want to create the scaling configuration.
Resources:
  EciScalingConfiguration:
    Type: ALIYUN::ESS::EciScalingConfiguration
    Properties:
      Containers:
        - LivenessProbeHttpGetPath: ''
          Name: container-1
          Image: registry-vpc.cn-shenzhen.aliyuncs.com/eci_open/nginx:1.14.2-alpine
          Memory: 0
          WorkingDir: ''
          LivenessProbeHttpGetScheme: HTTP
          ReadinessProbeHttpGetScheme: HTTP
          ReadinessProbeHttpGetPath: ''
          ImagePullPolicy: IfNotPresent
          Gpu: 0
          Cpu: 0
      SecurityGroupId:
        Ref: SecurityGroupId
      ScalingGroupId:
        Ref: ScalingGroupId
      ScalingConfigurationName:
        Ref: ScalingConfigurationName
      ContainerGroupName:
        Ref: ContainerGroupName
Outputs:
  ScalingConfigurationId:
    Description: The ID of the elastic container instance.
    Value:
      Fn::GetAtt:
        - EciScalingConfiguration
        - ScalingConfigurationId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "SecurityGroupId": {
      "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
      "Required": true,
      "Type": "String",
      "Description": {
        "en": "The ID of the security group with which you want to associate the elastic container instance. Elastic container instances that are associated with the same security group can access each other.\nIf you do not specify a security group, the system uses the default security group in the region that you selected. Make sure that the inbound rules of the security group contain the protocols and the port numbers of the containers that you want to expose. If you do not have a default security group in the region, the system creates a default security group and adds the declared container protocols and port numbers to the inbound rules of the security group."
      }
    },
    "ContainerGroupName": {
      "Required": true,
      "Type": "String",
      "Description": {
        "en": "The name of the elastic container instance."
      }
    },
    "ScalingConfigurationName": {
      "Required": true,
      "Type": "String",
      "Description": {
        "en": "The name of the scaling configuration. The name must be 2 to 64 characters in length and can contain letters, digits, underscores (_), hyphens (-), and periods (.). The name must start with a letter or a digit.\nThe name of the scaling configuration must be unique in a region. If you do not specify this parameter, the scaling configuration ID is used."
      }
    },
    "ScalingGroupId": {
      "AssociationProperty": "ALIYUN::ESS::AutoScalingGroup::AutoScalingGroupId",
      "Required": true,
      "Type": "String",
      "Description": {
        "en": "The ID of the scaling group for which you want to create the scaling configuration."
      }
    }
  },
  "Resources": {
    "EciScalingConfiguration": {
      "Type": "ALIYUN::ESS::EciScalingConfiguration",
      "Properties": {
        "Containers": [
          {
            "LivenessProbeHttpGetPath": "",
            "Name": "container-1",
            "Image": "registry-vpc.cn-shenzhen.aliyuncs.com/eci_open/nginx:1.14.2-alpine",
            "Memory": 0,
            "WorkingDir": "",
            "LivenessProbeHttpGetScheme": "HTTP",
            "ReadinessProbeHttpGetScheme": "HTTP",
            "ReadinessProbeHttpGetPath": "",
            "ImagePullPolicy": "IfNotPresent",
            "Gpu": 0,
            "Cpu": 0
          }
        ],
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "ScalingGroupId": {
          "Ref": "ScalingGroupId"
        },
        "ScalingConfigurationName": {
          "Ref": "ScalingConfigurationName"
        },
        "ContainerGroupName": {
          "Ref": "ContainerGroupName"
        }
      }
    }
  },
  "Outputs": {
    "ScalingConfigurationId": {
      "Description": "The ID of the elastic container instance.",
      "Value": {
        "Fn::GetAtt": [
          "EciScalingConfiguration",
          "ScalingConfigurationId"
        ]
      }
    }
  }
}