Share via

Microsoft.AppPlatform Spring/apps/deployments

  • Artigo

Definição de recurso do Bicep

O tipo de recurso Spring/apps/deployments pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.AppPlatform/Spring/apps/deployments, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2023-03-01-preview' = {
  name: 'string'
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {}
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {}
      livenessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      readinessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      resourceRequests: {
        cpu: 'string'
        memory: 'string'
      }
      scale: {
        maxReplicas: int
        minReplicas: int
        rules: [
          {
            azureQueue: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              queueLength: int
              queueName: 'string'
            }
            custom: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {}
              type: 'string'
            }
            http: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {}
            }
            name: 'string'
            tcp: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {}
            }
          }
        ]
      }
      startupProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      terminationGracePeriodSeconds: int
    }
    source: {
      version: 'string'
      type: 'string'
      // For remaining properties, see UserSourceInfo objects
    }
  }
}

Objetos ProbeAction

Defina a propriedade tipo para especificar o tipo de objeto.

Para ExecAction, utilize:

  type: 'ExecAction'
  command: [
    'string'
  ]

Para HTTPGetAction, utilize:

  type: 'HTTPGetAction'
  path: 'string'
  scheme: 'string'

Para TCPSocketAction, utilize:

  type: 'TCPSocketAction'

Objetos UserSourceInfo

Defina a propriedade tipo para especificar o tipo de objeto.

Para BuildResult, utilize:

  type: 'BuildResult'
  buildResultId: 'string'

Para Contentor, utilize:

  type: 'Container'
  customContainer: {
    args: [
      'string'
    ]
    command: [
      'string'
    ]
    containerImage: 'string'
    imageRegistryCredential: {
      password: 'string'
      username: 'string'
    }
    languageFramework: 'string'
    server: 'string'
  }

Para Jar, utilize:

  type: 'Jar'
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

Para NetCoreZip, utilize:

  type: 'NetCoreZip'
  netCoreMainEntryPath: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

Para Origem, utilize:

  type: 'Source'
  artifactSelector: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

Valores de propriedade

Spring/apps/implementações

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.		 cadeia (obrigatório)
sku SKU do recurso implementação SKU
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.		 Nome simbólico para recurso do tipo: aplicações
propriedades Propriedades do recurso implementação DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrição Valor
active Indica se a Implementação está ativa bool
deploymentSettings Definições de implementação da Implementação DeploymentSettings
source Informações de origem carregadas da implementação. UserSourceInfo

DeploymentSettings

Nome Descrição Valor
addonConfigs Coleção de suplementos objeto
containerProbeSettings Definições de pesquisa de disponibilidade e disponibilidade do contentor ContainerProbeSettings
environmentVariables Coleção de variáveis de ambiente objeto
livenessProbe Pesquisa periódica do liveness da Instância da Aplicação. A Instância da Aplicação será reiniciada se a sonda falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
readinessProbe Pesquisa periódica da preparação do serviço da Instância de Aplicação. A Instância da Aplicação será removida dos pontos finais de serviço se a sonda falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
resourceRequests A quantidade de recursos pedida para a CPU e Memória necessárias. Recomenda-se que, ao utilizar este campo para representar a CPU e a Memória necessárias, o campo antigo cpu e memoryInGB serão preteridos mais tarde. ResourceRequests
scale Dimensionar propriedades para a Instância de Aplicações do Azure Spring Apps. Dimensionamento
startupProbe StartupProbe indica que a Instância da Aplicação foi inicializada com êxito. Se especificado, não serão executadas outras sondas até que esta ação seja concluída com êxito. Se esta pesquisa falhar, o Pod será reiniciado, tal como se o livenessProbe falhasse. Isto pode ser utilizado para fornecer parâmetros de pesquisa diferentes no início do ciclo de vida de uma Instância de Aplicação, quando pode demorar muito tempo a carregar dados ou a aquecer uma cache do que durante a operação de estado constante. Não é possível atualizá-lo. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
terminationGracePeriodSeconds Duração opcional em segundos a Instância da Aplicação tem de terminar corretamente. Pode ser diminuído no pedido de eliminação. O valor tem de ser um número inteiro não negativo. O valor zero indica parar imediatamente através do sinal de eliminação (sem oportunidade de encerrar). Se este valor for nulo, será utilizado o período de tolerância predefinido. O período de tolerância é a duração em segundos após os processos em execução na Instância da Aplicação serem enviados um sinal de terminação e a hora em que os processos são forçados a parar com um sinal de eliminação. Defina este valor mais longo do que o tempo de limpeza esperado para o seu processo. A predefinição é de 90 segundos. int

ContainerProbeSettings

Nome Descrição Valor
disableProbe Indica se desativa a liveness e a sonda de preparação bool

Teste

Nome Descrição Valor
disableProbe Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Falhas mínimas consecutivas para que a sonda seja considerada falhou depois de ter sido bem-sucedida. O valor mínimo é 1. int
initialDelaySeconds Número de segundos após o início da Instância da Aplicação antes de as pesquisas serem iniciadas. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds Com que frequência (em segundos) executar a sonda. O valor mínimo é 1. int
probeAction A ação da sonda. ProbeAction
successThreshold Êxitos mínimos consecutivos para que a sonda seja considerada com êxito depois de ter falhado. Tem de ser 1 para liveness e arranque. O valor mínimo é 1. int
timeoutSeconds Número de segundos após o qual a sonda excede o limite de tempo. O valor mínimo é 1. int

ProbeAction

Nome Descrição Valor
tipo Definir o tipo de objeto ExecAction
HTTPGetAction
TCPSocketAction (obrigatório)

ExecAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "ExecAction" (obrigatório)
command Comando é a linha de comandos a executar dentro do contentor, o diretório de trabalho do comando é raiz ('/') no sistema de ficheiros do contentor. O comando não é executado dentro de uma shell, pelo que as instruções de shell tradicionais (',', etc.) não funcionam. Para utilizar uma shell, tem de chamar explicitamente essa shell. O estado de saída de 0 é tratado como vivo/saudável e não está em mau estado de funcionamento. cadeia[]

HttpGetAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "HTTPGetAction" (obrigatório)
caminho Caminho para aceder no servidor HTTP. string
esquema Esquema a utilizar para ligar ao anfitrião. Predefinições para HTTP.

Valores de enum possíveis:
- "HTTP" significa que o esquema utilizado será http://
- "HTTPS" significa que o esquema utilizado será https://		 'HTTP'
"HTTPS"

TCPSocketAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "TCPSocketAction" (obrigatório)

ResourceRequests

Nome Descrição Valor
cpu CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Deve ser 500m ou 1 para o escalão Básico e {500m, 1, 2, 3, 4} para o escalão Standard. string
Memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Deve ser {512Mi, 1Gi, 2Gi} para o escalão Básico e {512Mi, 1Gi, 2Gi, ..., 8Gi} para o escalão Standard. string

Escala

Nome Descrição Valor
maxReplicas Opcional. Número máximo de réplicas de contentor. A predefinição é 10 se não estiver definida. int
minReplicas Opcional. Número mínimo de réplicas de contentor. int
regras Regras de dimensionamento. ScaleRule[]

ScaleRule

Nome Descrição Valor
azureQueue Dimensionamento baseado em Filas do Azure. QueueScaleRule
personalizadas Regra de dimensionamento personalizada. CustomScaleRule
http Dimensionamento baseado em pedidos HTTP. HttpScaleRule
name Dimensionar Nome da Regra string
tcp Dimensionamento baseado em pedidos TCP. TcpScaleRule

QueueScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento de filas. ScaleRuleAuth[]
queueLength Comprimento da fila. int
queueName Nome da fila. string

ScaleRuleAuth

Nome Descrição Valor
secretRef Nome do segredo da Instância da Aplicação do Azure Spring Apps a partir do qual pretende extrair os parâmetros de autenticação. string
triggerParameter Parâmetro de Acionador que utiliza o segredo string

CustomScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento personalizada. objeto
tipo Tipo de regra de dimensionamento personalizada
por exemplo: azure-servicebus, redis, etc.
 string

HttpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento http. objeto

TcpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento tcp. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento tcp. objeto

UserSourceInfo

Nome Descrição Valor
versão Versão da origem string
tipo Definir o tipo de objeto BuildResult
Container (Contentor)
Jar
NetCoreZip
Origem (obrigatório)

BuildResultUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "BuildResult" (obrigatório)
buildResultId ID de recurso de um resultado de compilação com êxito existente na mesma instância spring. string

CustomContainerUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Contentor" (obrigatório)
customContainer Payload de contentor personalizado CustomContainer

CustomContainer

Nome Descrição Valor
args Argumentos para o ponto de entrada. O CMD da imagem do docker é utilizado se não for fornecido. cadeia[]
command Matriz de pontos de entrada. Não executado dentro de uma shell. O ENTRYPOINT da imagem do docker é utilizado se não for fornecido. cadeia[]
containerImage Imagem de contentor do contentor personalizado. Isto deve estar na forma de {repository}:{tag} sem o nome do servidor do registo string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Arquitetura linguística da imagem de contentor carregada string
servidor O nome do registo que contém a imagem de contentor string

ImageRegistryCredential

Nome Descrição Valor
palavra-passe A palavra-passe da credencial do registo de imagens string
nome de utilizador O nome de utilizador da credencial do registo de imagens string

JarUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada 'Jar' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro Jar string

NetCoreZipUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "NetCoreZip" (obrigatório)
netCoreMainEntryPath O caminho para o executável .NET relativo à raiz zip string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro .Net string

SourceUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Origem" (obrigatório)
artifactSelector Seletor para o artefacto a ser utilizado para a implementação de projetos de vários módulos. Isto deve ser
o caminho relativo para o módulo/projeto de destino.		 string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão do runtime do ficheiro de origem string

Sku

Nome Descrição Valor
capacidade Capacidade atual do recurso de destino int
name Nome do Sku string
tier Camada do SKU string

Definição de recurso de modelo do ARM

O tipo de recurso Spring/apps/deployments pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.AppPlatform/Spring/apps/deployments, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.AppPlatform/Spring/apps/deployments",
  "apiVersion": "2023-03-01-preview",
  "name": "string",
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {},
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {},
      "livenessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "readinessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "resourceRequests": {
        "cpu": "string",
        "memory": "string"
      },
      "scale": {
        "maxReplicas": "int",
        "minReplicas": "int",
        "rules": [
          {
            "azureQueue": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "queueLength": "int",
              "queueName": "string"
            },
            "custom": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {},
              "type": "string"
            },
            "http": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {}
            },
            "name": "string",
            "tcp": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {}
            }
          }
        ]
      },
      "startupProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "terminationGracePeriodSeconds": "int"
    },
    "source": {
      "version": "string",
      "type": "string"
      // For remaining properties, see UserSourceInfo objects
    }
  }
}

Objetos ProbeAction

Defina a propriedade tipo para especificar o tipo de objeto.

Para ExecAction, utilize:

  "type": "ExecAction",
  "command": [ "string" ]

Para HTTPGetAction, utilize:

  "type": "HTTPGetAction",
  "path": "string",
  "scheme": "string"

Para TCPSocketAction, utilize:

  "type": "TCPSocketAction"

Objetos UserSourceInfo

Defina a propriedade tipo para especificar o tipo de objeto.

Para BuildResult, utilize:

  "type": "BuildResult",
  "buildResultId": "string"

Para Contentor, utilize:

  "type": "Container",
  "customContainer": {
    "args": [ "string" ],
    "command": [ "string" ],
    "containerImage": "string",
    "imageRegistryCredential": {
      "password": "string",
      "username": "string"
    },
    "languageFramework": "string",
    "server": "string"
  }

Para Jar, utilize:

  "type": "Jar",
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

Para NetCoreZip, utilize:

  "type": "NetCoreZip",
  "netCoreMainEntryPath": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

Para Origem, utilize:

  "type": "Source",
  "artifactSelector": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

Valores de propriedade

Spring/apps/implementações

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.AppPlatform/Spring/apps/deployments"
apiVersion A versão da API de recursos "2023-03-01-preview"
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON.		 cadeia (obrigatório)
sku SKU do recurso implementação SKU
propriedades Propriedades do recurso implementação DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrição Valor
active Indica se a Implementação está ativa bool
deploymentSettings Definições de implementação da Implementação DeploymentSettings
source Informações de origem carregadas da implementação. UserSourceInfo

DeploymentSettings

Nome Descrição Valor
addonConfigs Coleção de suplementos objeto
containerProbeSettings Definições da pesquisa de preparação e liveness do contentor ContainerProbeSettings
environmentVariables Coleção de variáveis de ambiente objeto
livenessProbe Sonda periódica do liveness da Instância de Aplicação. A Instância da Aplicação será reiniciada se a pesquisa falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
readinessProbe Pesquisa periódica da preparação do serviço da Instância de Aplicação. A Instância da Aplicação será removida dos pontos finais de serviço se a pesquisa falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
resourceRequests A quantidade de recursos pedida para a CPU e Memória necessárias. Recomenda-se que a utilização deste campo para representar a CPU e a Memória necessárias, a cpu de campo antiga e memoryInGB sejam preteridas mais tarde. ResourceRequests
scale Dimensionar propriedades para a Instância da Aplicação Azure Spring Apps. Dimensionamento
startupProbe StartupProbe indica que a Instância da Aplicação foi inicializada com êxito. Se for especificado, não serão executadas outras sondas até que esta ação seja concluída com êxito. Se esta sonda falhar, o Pod será reiniciado, tal como se o livenessProbe falhasse. Isto pode ser utilizado para fornecer diferentes parâmetros de pesquisa no início do ciclo de vida de uma Instância de Aplicação, quando pode demorar muito tempo a carregar dados ou a aquecer uma cache do que durante a operação de estado estável. Não é possível atualizá-lo. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
terminationGracePeriodSeconds Duração opcional em segundos a Instância da Aplicação tem de terminar corretamente. Pode ser diminuído no pedido de eliminação. O valor tem de ser um número inteiro não negativo. O valor zero indica parar imediatamente através do sinal de eliminação (sem oportunidade de encerrar). Se este valor for nulo, será utilizado o período de tolerância predefinido. O período de tolerância é a duração em segundos após os processos em execução na Instância da Aplicação serem enviados um sinal de terminação e a hora em que os processos são interrompidos à força com um sinal de eliminação. Defina este valor mais longo do que o tempo de limpeza esperado para o seu processo. A predefinição é 90 segundos. int

ContainerProbeSettings

Nome Descrição Valor
disableProbe Indica se desativa a liveness e a sonda de preparação bool

Teste

Nome Descrição Valor
disableProbe Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Falhas mínimas consecutivas para que a sonda seja considerada falhou depois de ter sido bem-sucedida. O valor mínimo é 1. int
initialDelaySeconds Número de segundos após o início da Instância da Aplicação antes de as pesquisas serem iniciadas. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds Com que frequência (em segundos) executar a sonda. O valor mínimo é 1. int
probeAction A ação da sonda. ProbeAction
successThreshold Mínimo de êxitos consecutivos para que a sonda seja considerada com êxito depois de ter falhado. Tem de ser 1 para liveness e arranque. O valor mínimo é 1. int
timeoutSeconds Número de segundos após o qual a sonda excede o limite de tempo. O valor mínimo é 1. int

ProbeAction

Nome Descrição Valor
tipo Definir o tipo de objeto ExecAction
HTTPGetAction
TCPSocketAction (obrigatório)

ExecAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "ExecAction" (obrigatório)
command Comando é a linha de comandos a executar dentro do contentor, o diretório de trabalho do comando é raiz ('/') no sistema de ficheiros do contentor. O comando não é executado dentro de uma shell, pelo que as instruções de shell tradicionais (',', etc.) não irão funcionar. Para utilizar uma shell, tem de chamar explicitamente essa shell. O estado de saída de 0 é tratado como ativo/em bom estado de funcionamento e não zero está em mau estado de funcionamento. string[]

HttpGetAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "HTTPGetAction" (obrigatório)
caminho Caminho para o acesso no servidor HTTP. string
esquema Esquema a utilizar para ligar ao anfitrião. A predefinição é HTTP.

Valores de enumeração possíveis:
- "HTTP" significa que o esquema utilizado será http://
- "HTTPS" significa que o esquema utilizado será https://		 "HTTP"
"HTTPS"

TCPSocketAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "TCPSocketAction" (obrigatório)

ResourceRequests

Nome Descrição Valor
cpu CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Deve ser 500m ou 1 para o escalão Básico e {500m, 1, 2, 3, 4} para o escalão Standard. string
Memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Deve ser {512Mi, 1Gi, 2Gi} para o escalão Básico e {512Mi, 1Gi, 2Gi, ..., 8Gi} para o escalão Standard. string

Escala

Nome Descrição Valor
maxReplicas Opcional. Número máximo de réplicas de contentor. A predefinição é 10 se não estiver definida. int
minReplicas Opcional. Número mínimo de réplicas de contentor. int
regras Regras de dimensionamento. ScaleRule[]

ScaleRule

Nome Descrição Valor
azureQueue Dimensionamento baseado em Filas do Azure. QueueScaleRule
personalizadas Regra de dimensionamento personalizada. CustomScaleRule
http Dimensionamento baseado em pedidos HTTP. HttpScaleRule
name Dimensionar Nome da Regra string
tcp Dimensionamento baseado em pedidos TCP. TcpScaleRule

QueueScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento de filas. ScaleRuleAuth[]
queueLength Comprimento da fila. int
queueName Nome da fila. string

ScaleRuleAuth

Nome Descrição Valor
secretRef Nome do segredo da Instância da Aplicação do Azure Spring Apps a partir do qual pretende extrair os parâmetros de autenticação. string
triggerParameter Parâmetro de Acionador que utiliza o segredo string

CustomScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento personalizada. objeto
tipo Tipo de regra de dimensionamento personalizado
por exemplo: azure-servicebus, redis, etc.
 string

HttpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento http. objeto

TcpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento tcp. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento tcp. objeto

UserSourceInfo

Nome Descrição Valor
versão Versão da origem string
tipo Definir o tipo de objeto BuildResult
Container (Contentor)
Jar
NetCoreZip
Origem (obrigatório)

BuildResultUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "BuildResult" (obrigatório)
buildResultId ID de recurso de um resultado de compilação com êxito existente na mesma instância spring. string

CustomContainerUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Contentor" (obrigatório)
customContainer Payload de contentor personalizado CustomContainer

CustomContainer

Nome Descrição Valor
args Argumentos para o ponto de entrada. O CMD da imagem do docker é utilizado se não for fornecido. cadeia[]
command Matriz de pontos de entrada. Não executado dentro de uma shell. O ENTRYPOINT da imagem do docker é utilizado se não for fornecido. cadeia[]
containerImage Imagem de contentor do contentor personalizado. Isto deve estar na forma de {repository}:{tag} sem o nome do servidor do registo string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Arquitetura linguística da imagem de contentor carregada string
servidor O nome do registo que contém a imagem de contentor string

ImageRegistryCredential

Nome Descrição Valor
palavra-passe A palavra-passe da credencial do registo de imagens string
nome de utilizador O nome de utilizador da credencial do registo de imagens string

JarUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada 'Jar' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro Jar string

NetCoreZipUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "NetCoreZip" (obrigatório)
netCoreMainEntryPath O caminho para o executável .NET relativo à raiz zip string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro .Net string

SourceUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Origem" (obrigatório)
artifactSelector Seletor para o artefacto a ser utilizado para a implementação de projetos de vários módulos. Isto deve ser
o caminho relativo para o módulo/projeto de destino.		 string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão do runtime do ficheiro de origem string

Sku

Nome Descrição Valor
capacidade Capacidade atual do recurso de destino int
name Nome do Sku string
tier Camada do SKU string

Definição de recurso do Terraform (fornecedor AzAPI)

O tipo de recurso Spring/apps/deployments pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.AppPlatform/Spring/apps/deployments, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AppPlatform/Spring/apps/deployments@2023-03-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {}
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {}
        livenessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        readinessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        resourceRequests = {
          cpu = "string"
          memory = "string"
        }
        scale = {
          maxReplicas = int
          minReplicas = int
          rules = [
            {
              azureQueue = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                queueLength = int
                queueName = "string"
              }
              custom = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {}
                type = "string"
              }
              http = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {}
              }
              name = "string"
              tcp = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {}
              }
            }
          ]
        }
        startupProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        terminationGracePeriodSeconds = int
      }
      source = {
        version = "string"
        type = "string"
        // For remaining properties, see UserSourceInfo objects
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Objetos ProbeAction

Defina a propriedade tipo para especificar o tipo de objeto.

Para ExecAction, utilize:

  type = "ExecAction"
  command = [
    "string"
  ]

Para HTTPGetAction, utilize:

  type = "HTTPGetAction"
  path = "string"
  scheme = "string"

Para TCPSocketAction, utilize:

  type = "TCPSocketAction"

Objetos UserSourceInfo

Defina a propriedade tipo para especificar o tipo de objeto.

Para BuildResult, utilize:

  type = "BuildResult"
  buildResultId = "string"

Para Contentor, utilize:

  type = "Container"
  customContainer = {
    args = [
      "string"
    ]
    command = [
      "string"
    ]
    containerImage = "string"
    imageRegistryCredential = {
      password = "string"
      username = "string"
    }
    languageFramework = "string"
    server = "string"
  }

Para Jar, utilize:

  type = "Jar"
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"

Para NetCoreZip, utilize:

  type = "NetCoreZip"
  netCoreMainEntryPath = "string"
  relativePath = "string"
  runtimeVersion = "string"

Para Origem, utilize:

  type = "Source"
  artifactSelector = "string"
  relativePath = "string"
  runtimeVersion = "string"

Valores de propriedade

Spring/apps/implementações

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.AppPlatform/Spring/apps/deployments@2023-03-01-preview"
name O nome do recurso cadeia (obrigatório)
parent_id O ID do recurso que é o principal para este recurso. ID para recurso do tipo: aplicações
sku SKU do recurso implementação SKU
propriedades Propriedades do recurso implementação DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrição Valor
active Indica se a Implementação está ativa bool
deploymentSettings Definições de implementação da Implementação DeploymentSettings
source Informações de origem carregadas da implementação. UserSourceInfo

DeploymentSettings

Nome Descrição Valor
addonConfigs Coleção de suplementos objeto
containerProbeSettings Definições da pesquisa de preparação e liveness do contentor ContainerProbeSettings
environmentVariables Coleção de variáveis de ambiente objeto
livenessProbe Sonda periódica do liveness da Instância de Aplicação. A Instância da Aplicação será reiniciada se a pesquisa falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
readinessProbe Pesquisa periódica da preparação do serviço da Instância de Aplicação. A Instância da Aplicação será removida dos pontos finais de serviço se a pesquisa falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
resourceRequests A quantidade de recursos pedida para a CPU e Memória necessárias. Recomenda-se que a utilização deste campo para representar a CPU e a Memória necessárias, a cpu de campo antiga e memoryInGB sejam preteridas mais tarde. ResourceRequests
scale Dimensionar propriedades para a Instância da Aplicação Azure Spring Apps. Dimensionamento
startupProbe StartupProbe indica que a Instância da Aplicação foi inicializada com êxito. Se for especificado, não serão executadas outras sondas até que esta ação seja concluída com êxito. Se esta sonda falhar, o Pod será reiniciado, tal como se o livenessProbe falhasse. Isto pode ser utilizado para fornecer diferentes parâmetros de pesquisa no início do ciclo de vida de uma Instância de Aplicação, quando pode demorar muito tempo a carregar dados ou a aquecer uma cache do que durante a operação de estado estável. Não é possível atualizá-lo. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Teste
terminationGracePeriodSeconds Duração opcional em segundos a Instância da Aplicação tem de terminar corretamente. Pode ser diminuído no pedido de eliminação. O valor tem de ser um número inteiro não negativo. O valor zero indica parar imediatamente através do sinal de eliminação (sem oportunidade de encerrar). Se este valor for nulo, será utilizado o período de tolerância predefinido. O período de tolerância é a duração em segundos após os processos em execução na Instância da Aplicação serem enviados um sinal de terminação e a hora em que os processos são interrompidos à força com um sinal de eliminação. Defina este valor mais longo do que o tempo de limpeza esperado para o seu processo. A predefinição é 90 segundos. int

ContainerProbeSettings

Nome Descrição Valor
disableProbe Indica se desativa a liveness e a sonda de preparação bool

Teste

Nome Descrição Valor
disableProbe Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Falhas mínimas consecutivas para que a sonda seja considerada falhou depois de ter sido bem-sucedida. O valor mínimo é 1. int
initialDelaySeconds Número de segundos após o início da Instância da Aplicação antes de as pesquisas serem iniciadas. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes int
periodSeconds Com que frequência (em segundos) executar a sonda. O valor mínimo é 1. int
probeAction A ação da sonda. ProbeAction
successThreshold Mínimo de êxitos consecutivos para que a sonda seja considerada com êxito depois de ter falhado. Tem de ser 1 para liveness e arranque. O valor mínimo é 1. int
timeoutSeconds Número de segundos após o qual a sonda excede o limite de tempo. O valor mínimo é 1. int

ProbeAction

Nome Descrição Valor
tipo Definir o tipo de objeto ExecAction
HTTPGetAction
TCPSocketAction (obrigatório)

ExecAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "ExecAction" (obrigatório)
command Comando é a linha de comandos a executar dentro do contentor, o diretório de trabalho do comando é raiz ('/') no sistema de ficheiros do contentor. O comando não é executado dentro de uma shell, pelo que as instruções de shell tradicionais (',', etc.) não funcionam. Para utilizar uma shell, tem de chamar explicitamente essa shell. O estado de saída de 0 é tratado como vivo/saudável e não está em mau estado de funcionamento. cadeia[]

HttpGetAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "HTTPGetAction" (obrigatório)
caminho Caminho para aceder no servidor HTTP. string
esquema Esquema a utilizar para ligar ao anfitrião. Predefinições para HTTP.

Valores de enum possíveis:
- "HTTP" significa que o esquema utilizado será http://
- "HTTPS" significa que o esquema utilizado será https://		 "HTTP"
"HTTPS"

TCPSocketAction

Nome Descrição Valor
tipo O tipo de ação a tomar para efetuar a verificação de estado de funcionamento. "TCPSocketAction" (obrigatório)

ResourceRequests

Nome Descrição Valor
cpu CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Deve ser 500m ou 1 para o escalão Básico e {500m, 1, 2, 3, 4} para o escalão Standard. string
Memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Deve ser {512Mi, 1Gi, 2Gi} para escalão Básico e {512Mi, 1Gi, 2Gi, ..., 8Gi} para o escalão Standard. string

Escala

Nome Descrição Valor
maxReplicas Opcional. Número máximo de réplicas de contentor. A predefinição é 10 se não estiver definida. int
minReplicas Opcional. Número mínimo de réplicas de contentor. int
regras Regras de dimensionamento. ScaleRule[]

ScaleRule

Nome Descrição Valor
azureQueue Dimensionamento baseado em Filas do Azure. QueueScaleRule
personalizadas Regra de dimensionamento personalizada. CustomScaleRule
http Dimensionamento baseado em pedidos HTTP. HttpScaleRule
name Dimensionar Nome da Regra string
tcp Dimensionamento baseado em pedidos TCP. TcpScaleRule

QueueScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento de filas. ScaleRuleAuth[]
queueLength Comprimento da fila. int
queueName Nome da fila. string

ScaleRuleAuth

Nome Descrição Valor
secretRef Nome do segredo da Instância da Aplicação do Azure Spring Apps a partir do qual pretende solicitar os parâmetros de autenticação. string
triggerParameter Parâmetro de Acionador que utiliza o segredo string

CustomScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento personalizada. objeto
tipo Tipo de regra de dimensionamento personalizado
por exemplo: azure-servicebus, redis, etc.
 string

HttpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento personalizado. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento http. objeto

TcpScaleRule

Nome Descrição Valor
autenticação Segredos de autenticação para a regra de dimensionamento tcp. ScaleRuleAuth[]
do IdP Propriedades de metadados para descrever a regra de dimensionamento tcp. objeto

UserSourceInfo

Nome Descrição Valor
versão Versão da origem string
tipo Definir o tipo de objeto BuildResult
Container (Contentor)
Jar
NetCoreZip
Origem (obrigatório)

BuildResultUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "BuildResult" (obrigatório)
buildResultId ID de recurso de um resultado de compilação com êxito existente na mesma instância spring. string

CustomContainerUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Contentor" (obrigatório)
customContainer Payload de contentor personalizado CustomContainer

CustomContainer

Nome Descrição Valor
args Argumentos para o ponto de entrada. O CMD da imagem do docker é utilizado se não for fornecido. cadeia[]
command Matriz de pontos de entrada. Não executado dentro de uma shell. O ENTRYPOINT da imagem do docker é utilizado se não for fornecido. cadeia[]
containerImage Imagem de contentor do contentor personalizado. Isto deve estar na forma de {repository}:{tag} sem o nome do servidor do registo string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Arquitetura linguística da imagem de contentor carregada string
servidor O nome do registo que contém a imagem de contentor string

ImageRegistryCredential

Nome Descrição Valor
palavra-passe A palavra-passe da credencial do registo de imagens string
nome de utilizador O nome de utilizador da credencial do registo de imagens string

JarUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Jar" (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro Jar string

NetCoreZipUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "NetCoreZip" (obrigatório)
netCoreMainEntryPath O caminho para o executável .NET relativo à raiz zip string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de runtime do ficheiro .Net string

SourceUploadedUserSourceInfo

Nome Descrição Valor
tipo Tipo de origem carregada "Origem" (obrigatório)
artifactSelector Seletor para o artefacto a ser utilizado para a implementação de projetos de vários módulos. Isto deve ser
o caminho relativo para o módulo/projeto de destino.		 string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão do runtime do ficheiro de origem string

Sku

Nome Descrição Valor
capacidade Capacidade atual do recurso de destino int
name Nome do Sku string
tier Camada do SKU string