Partilhar via


Microsoft.AppPlatform Spring/apps/deployments 2024-05-01-preview

Definição de recursos do bíceps

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

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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@2024-05-01-preview' = {
  name: 'string'
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {
        {customized property}: any()
      }
      apms: [
        {
          resourceId: 'string'
        }
      ]
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {
        {customized property}: 'string'
      }
      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: {
                {customized property}: 'string'
              }
              type: 'string'
            }
            http: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
            }
            name: 'string'
            tcp: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
            }
          }
        ]
      }
      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 type para especificar o tipo de objeto.

Para ExecAction, use:

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

Para HTTPGetAction , use:

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

Para TCPSocketAction, use:

  type: 'TCPSocketAction'

Objetos UserSourceInfo

Defina a propriedade type para especificar o tipo de objeto.

Para BuildResult , use:

  type: 'BuildResult'
  buildResultId: 'string'

Para Container, use:

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

Para Jar, use:

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

Para NetCoreZip , use:

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

Para de origem, use:

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

Para War, use:

  type: 'War'
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  serverVersion: 'string'

Valores de propriedade

Primavera/aplicativos/implantações

Designação Descrição Valor
Designação O nome do recurso

Veja como definir nomes e tipos para recursos filho no Bicep.
string (obrigatório)
SKU Sku do recurso de implantação Sku
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para recurso do tipo: aplicativos
propriedades Propriedades do recurso de implantação DeploymentResourceProperties

DeploymentResourceProperties

Designação Descrição Valor
ativo Indica se a implantação está ativa Bool
deploymentSettings Configurações de implantação da implantação DeploymentSettings
fonte Informações de origem carregadas da implantação. UserSourceInfo

DeploymentSettings

Designação Descrição Valor
addonConfigs Coleção de addons DeploymentSettingsAddonConfigs
APMS Coleção de ApmReferences ApmReference[]
containerProbeSettings Configurações da sonda de prontidão e vivacidade do contêiner ContainerProbeSettings
environmentVariables Recolha de variáveis de ambiente DeploymentSettingsEnvironmentVariables
livenessSonda Teste periódico da vivacidade da instância do aplicativo. A Instância do Aplicativo será reiniciada se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
prontidãoSonda Investigação periódica da prontidão do serviço de Instância de Aplicativo. A Instância do Aplicativo será removida dos pontos de extremidade do serviço se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
resourceRequests A quantidade de recursos solicitada para CPU e memória necessárias. Recomenda-se que usando este campo para representar a CPU e a memória necessárias, a cpu de campo antigo e o memoryInGB serão preteridos posteriormente. ResourceRequests
Escala Dimensionamento de propriedades para a Instância do Aplicativo Azure Spring Apps. Escala
startupProbe StartupProbe indica que a Instância do Aplicativo foi inicializada com êxito. Se especificado, nenhum outro teste será executado até que isso seja concluído com êxito. Se esta sonda falhar, o Pod será reiniciado, como se a livenessProbe falhasse. Isso pode ser usado para fornecer parâmetros de teste diferentes no início do ciclo de vida de uma instância de aplicativo, quando pode levar muito tempo para carregar dados ou aquecer um cache, do que durante a operação em estado estacionário. Isso não pode ser atualizado. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
terminaçãoGracePeriodSeconds Duração opcional: em segundos, a Instância do Aplicativo precisa ser encerrada normalmente. Pode ser diminuído na solicitação de exclusão. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Se esse valor for nulo, o período de carência padrão será usado. O período de carência é a duração em segundos após os processos em execução na Instância do Aplicativo receberem um sinal de encerramento e o tempo em que os processos são interrompidos à força com um sinal de eliminação. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. O padrão é 90 segundos. Int

DeploymentSettingsAddonConfigs

Designação Descrição Valor
{propriedade personalizada} Para o Bicep, você pode usar a função any().

ApmReference

Designação Descrição Valor
resourceId ID do recurso do APM string (obrigatório)

ContainerProbeSettings

Designação Descrição Valor
desativarSonda Indica se a sonda de vivacidade e prontidão desativa Bool

DeploymentSettingsEnvironmentVariables

Designação Descrição Valor
{propriedade personalizada} string

Sonda

Designação Descrição Valor
desativarSonda Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O valor mínimo é 1. Int
initialDelaySeconds Número de segundos após o início da Instância do Aplicativo antes que os testes sejam iniciados. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
períodoSegundos Com que frequência (em segundos) realizar a sonda. O valor mínimo é 1. Int
probeAction A ação da sonda. ProbeAction
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. Deve ser 1 para liveness e startup. O valor mínimo é 1. Int
timeoutSegundos Número de segundos após os quais a sonda atinge o tempo limite. O valor mínimo é 1. Int

ProbeAction

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

ExecAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'ExecAction' (obrigatório)
comando Command é a linha de comando a ser executada dentro do contêiner, o diretório de trabalho para o comando é root ('/') no sistema de arquivos do contêiner. O comando não é executado dentro de um shell, então as instruções tradicionais do shell (',', etc) não funcionarão. Para usar um shell, você precisa chamar explicitamente para esse shell. O status de saída de 0 é tratado como vivo/saudável e diferente de zero não é íntegro. string[]

HttpGetAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'HTTPGetAction' (obrigatório)
caminho Caminho de acesso no servidor HTTP. string
Regime Esquema a ser usado para se conectar ao host. O padrão é HTTP.

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

TCPSocketAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'TCPSocketAction' (obrigatório)

ResourceRequests

Designação Descrição Valor
CPU CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Isso deve ser 500m ou 1 para a camada Basic e {500m, 1, 2, 3, 4} para a camada Standard. string
memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Isso deve ser {512Mi, 1Gi, 2Gi} para a camada Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} para a camada Standard. string

Escala

Designação Descrição Valor
maxRéplicas Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. Int
minRéplicas Opcional. Número mínimo de réplicas de contêiner. Int
regras Regras de dimensionamento. ScaleRule []

Regra de Escala

Designação Descrição Valor
azureQueue Escalonamento baseado em fila do Azure. QueueScaleRule
Personalizado Regra de escala personalizada. CustomScaleRule
Disponível em: Dimensionamento baseado em solicitações HTTP. HttpScaleRule
Designação Nome da regra de escala string
TCP Dimensionamento baseado em solicitações Tcp. TcpScaleRule

QueueScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala de fila. ScaleRuleAuth[]
queueLength Comprimento da fila. Int
queueName Nome da fila. string

ScaleRuleAuth

Designação Descrição Valor
secretRef Nome do segredo da Instância do Aplicativo Azure Spring Apps do qual extrair os parâmetros de autenticação. string
triggerParâmetro Parâmetro Trigger que usa o segredo string

CustomScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala personalizada. CustomScaleRuleMetadata
tipo Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc.
string

CustomScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

HttpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala http. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

TcpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala tcp. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala tcp. TcpScaleRuleMetadata

TcpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

UserSourceInfo

Designação Descrição Valor
Versão Versão da fonte string
tipo Definir o tipo de objeto BuildResult
Container
Jar
NetCoreZip
de origem
Guerra (obrigatório)

BuildResultUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'BuildResult' (obrigatório)
buildResultId ID de recurso de um resultado de compilação bem-sucedido existente na mesma instância do Spring. string

CustomContainerUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada «Contentor» (obrigatório)
customContainer Carga útil personalizada do contentor CustomContainer

Recipiente Personalizado

Designação Descrição Valor
Args Argumentos para o ponto de entrada. O CMD da imagem do docker é usado se isso não for fornecido. string[]
comando Matriz de ponto de entrada. Não executado dentro de um shell. O ENTRYPOINT da imagem do docker é usado se isso não for fornecido. string[]
containerImage Imagem de contêiner do contêiner personalizado. Isso deve ser na forma de {repository}:{tag} sem o nome do servidor do registro string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Estrutura de linguagem da imagem de contêiner carregada. Valores suportados: "springboot", "", null. string
servidor O nome do registro que contém a imagem do contêiner string

ImageRegistryCredential

Designação Descrição Valor
palavra-passe A senha da credencial de registro de imagem string
nome de utilizador O nome de usuário da credencial do registro de imagem string

JarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Jar' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão em tempo de execução do arquivo Jar string

NetCoreZipUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte 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 tempo de execução do arquivo .Net string

SourceUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Fonte' (obrigatório)
artifactSelector Seletor para o artefato a ser usado para a implantação de projetos multimódulo. 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 de tempo de execução do arquivo de origem string

WarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Guerra' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de tempo de execução do arquivo de guerra string
serverVersion Versão do servidor, atualmente apenas o Apache Tomcat é suportado string

Referência

Designação Descrição Valor
capacidade Capacidade atual do recurso de destino Int
Designação Nome do Sku string
nível Nível do Sku string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar um aplicativo de microsserviço simples do Azure Spring Apps

Implantar no Azure
Este modelo implanta um aplicativo de microsserviço simples do Azure Spring Apps para ser executado no Azure.

Definição de recurso de modelo ARM

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

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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": "2024-05-01-preview",
  "name": "string",
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {
        "{customized property}": {}
      },
      "apms": [
        {
          "resourceId": "string"
        }
      ],
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {
        "{customized property}": "string"
      },
      "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": {
                "{customized property}": "string"
              },
              "type": "string"
            },
            "http": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              }
            },
            "name": "string",
            "tcp": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              }
            }
          }
        ]
      },
      "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 type para especificar o tipo de objeto.

Para ExecAction, use:

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

Para HTTPGetAction , use:

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

Para TCPSocketAction, use:

  "type": "TCPSocketAction"

Objetos UserSourceInfo

Defina a propriedade type para especificar o tipo de objeto.

Para BuildResult , use:

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

Para Container, use:

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

Para Jar, use:

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

Para NetCoreZip , use:

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

Para de origem, use:

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

Para War, use:

  "type": "War",
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "serverVersion": "string"

Valores de propriedade

Primavera/aplicativos/implantações

Designação Descrição Valor
tipo O tipo de recurso 'Microsoft.AppPlatform/Spring/apps/deployments'
apiVersion A versão da api de recursos '2024-05-01-pré-visualização'
Designação O nome do recurso

Veja como definir nomes e tipos para recursos filho em modelos JSON ARM.
string (obrigatório)
SKU Sku do recurso de implantação Sku
propriedades Propriedades do recurso de implantação DeploymentResourceProperties

DeploymentResourceProperties

Designação Descrição Valor
ativo Indica se a implantação está ativa Bool
deploymentSettings Configurações de implantação da implantação DeploymentSettings
fonte Informações de origem carregadas da implantação. UserSourceInfo

DeploymentSettings

Designação Descrição Valor
addonConfigs Coleção de addons DeploymentSettingsAddonConfigs
APMS Coleção de ApmReferences ApmReference[]
containerProbeSettings Configurações da sonda de prontidão e vivacidade do contêiner ContainerProbeSettings
environmentVariables Recolha de variáveis de ambiente DeploymentSettingsEnvironmentVariables
livenessSonda Teste periódico da vivacidade da instância do aplicativo. A Instância do Aplicativo será reiniciada se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
prontidãoSonda Investigação periódica da prontidão do serviço de Instância de Aplicativo. A Instância do Aplicativo será removida dos pontos de extremidade do serviço se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
resourceRequests A quantidade de recursos solicitada para CPU e memória necessárias. Recomenda-se que usando este campo para representar a CPU e a memória necessárias, a cpu de campo antigo e o memoryInGB serão preteridos posteriormente. ResourceRequests
Escala Dimensionamento de propriedades para a Instância do Aplicativo Azure Spring Apps. Escala
startupProbe StartupProbe indica que a Instância do Aplicativo foi inicializada com êxito. Se especificado, nenhum outro teste será executado até que isso seja concluído com êxito. Se esta sonda falhar, o Pod será reiniciado, como se a livenessProbe falhasse. Isso pode ser usado para fornecer parâmetros de teste diferentes no início do ciclo de vida de uma instância de aplicativo, quando pode levar muito tempo para carregar dados ou aquecer um cache, do que durante a operação em estado estacionário. Isso não pode ser atualizado. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
terminaçãoGracePeriodSeconds Duração opcional: em segundos, a Instância do Aplicativo precisa ser encerrada normalmente. Pode ser diminuído na solicitação de exclusão. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Se esse valor for nulo, o período de carência padrão será usado. O período de carência é a duração em segundos após os processos em execução na Instância do Aplicativo receberem um sinal de encerramento e o tempo em que os processos são interrompidos à força com um sinal de eliminação. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. O padrão é 90 segundos. Int

DeploymentSettingsAddonConfigs

Designação Descrição Valor
{propriedade personalizada}

ApmReference

Designação Descrição Valor
resourceId ID do recurso do APM string (obrigatório)

ContainerProbeSettings

Designação Descrição Valor
desativarSonda Indica se a sonda de vivacidade e prontidão desativa Bool

DeploymentSettingsEnvironmentVariables

Designação Descrição Valor
{propriedade personalizada} string

Sonda

Designação Descrição Valor
desativarSonda Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O valor mínimo é 1. Int
initialDelaySeconds Número de segundos após o início da Instância do Aplicativo antes que os testes sejam iniciados. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
períodoSegundos Com que frequência (em segundos) realizar a sonda. O valor mínimo é 1. Int
probeAction A ação da sonda. ProbeAction
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. Deve ser 1 para liveness e startup. O valor mínimo é 1. Int
timeoutSegundos Número de segundos após os quais a sonda atinge o tempo limite. O valor mínimo é 1. Int

ProbeAction

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

ExecAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'ExecAction' (obrigatório)
comando Command é a linha de comando a ser executada dentro do contêiner, o diretório de trabalho para o comando é root ('/') no sistema de arquivos do contêiner. O comando não é executado dentro de um shell, então as instruções tradicionais do shell (',', etc) não funcionarão. Para usar um shell, você precisa chamar explicitamente para esse shell. O status de saída de 0 é tratado como vivo/saudável e diferente de zero não é íntegro. string[]

HttpGetAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'HTTPGetAction' (obrigatório)
caminho Caminho de acesso no servidor HTTP. string
Regime Esquema a ser usado para se conectar ao host. O padrão é HTTP.

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

TCPSocketAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. 'TCPSocketAction' (obrigatório)

ResourceRequests

Designação Descrição Valor
CPU CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Isso deve ser 500m ou 1 para a camada Basic e {500m, 1, 2, 3, 4} para a camada Standard. string
memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Isso deve ser {512Mi, 1Gi, 2Gi} para a camada Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} para a camada Standard. string

Escala

Designação Descrição Valor
maxRéplicas Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. Int
minRéplicas Opcional. Número mínimo de réplicas de contêiner. Int
regras Regras de dimensionamento. ScaleRule []

Regra de Escala

Designação Descrição Valor
azureQueue Escalonamento baseado em fila do Azure. QueueScaleRule
Personalizado Regra de escala personalizada. CustomScaleRule
Disponível em: Dimensionamento baseado em solicitações HTTP. HttpScaleRule
Designação Nome da regra de escala string
TCP Dimensionamento baseado em solicitações Tcp. TcpScaleRule

QueueScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala de fila. ScaleRuleAuth[]
queueLength Comprimento da fila. Int
queueName Nome da fila. string

ScaleRuleAuth

Designação Descrição Valor
secretRef Nome do segredo da Instância do Aplicativo Azure Spring Apps do qual extrair os parâmetros de autenticação. string
triggerParâmetro Parâmetro Trigger que usa o segredo string

CustomScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala personalizada. CustomScaleRuleMetadata
tipo Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc.
string

CustomScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

HttpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala http. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

TcpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala tcp. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala tcp. TcpScaleRuleMetadata

TcpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

UserSourceInfo

Designação Descrição Valor
Versão Versão da fonte string
tipo Definir o tipo de objeto BuildResult
Container
Jar
NetCoreZip
de origem
Guerra (obrigatório)

BuildResultUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'BuildResult' (obrigatório)
buildResultId ID de recurso de um resultado de compilação bem-sucedido existente na mesma instância do Spring. string

CustomContainerUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada «Contentor» (obrigatório)
customContainer Carga útil personalizada do contentor CustomContainer

Recipiente Personalizado

Designação Descrição Valor
Args Argumentos para o ponto de entrada. O CMD da imagem do docker é usado se isso não for fornecido. string[]
comando Matriz de ponto de entrada. Não executado dentro de um shell. O ENTRYPOINT da imagem do docker é usado se isso não for fornecido. string[]
containerImage Imagem de contêiner do contêiner personalizado. Isso deve ser na forma de {repository}:{tag} sem o nome do servidor do registro string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Estrutura de linguagem da imagem de contêiner carregada. Valores suportados: "springboot", "", null. string
servidor O nome do registro que contém a imagem do contêiner string

ImageRegistryCredential

Designação Descrição Valor
palavra-passe A senha da credencial de registro de imagem string
nome de utilizador O nome de usuário da credencial do registro de imagem string

JarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Jar' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão em tempo de execução do arquivo Jar string

NetCoreZipUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte 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 tempo de execução do arquivo .Net string

SourceUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Fonte' (obrigatório)
artifactSelector Seletor para o artefato a ser usado para a implantação de projetos multimódulo. 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 de tempo de execução do arquivo de origem string

WarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada 'Guerra' (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de tempo de execução do arquivo de guerra string
serverVersion Versão do servidor, atualmente apenas o Apache Tomcat é suportado string

Referência

Designação Descrição Valor
capacidade Capacidade atual do recurso de destino Int
Designação Nome do Sku string
nível Nível do Sku string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar um aplicativo de microsserviço simples do Azure Spring Apps

Implantar no Azure
Este modelo implanta um aplicativo de microsserviço simples do Azure Spring Apps para ser executado no Azure.

Definição de recursos Terraform (provedor AzAPI)

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

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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@2024-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {}
        apms = [
          {
            resourceId = "string"
          }
        ]
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {
          {customized property} = "string"
        }
        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 = {
                  {customized property} = "string"
                }
                type = "string"
              }
              http = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
              }
              name = "string"
              tcp = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
              }
            }
          ]
        }
        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 type para especificar o tipo de objeto.

Para ExecAction, use:

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

Para HTTPGetAction , use:

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

Para TCPSocketAction, use:

  type = "TCPSocketAction"

Objetos UserSourceInfo

Defina a propriedade type para especificar o tipo de objeto.

Para BuildResult , use:

  type = "BuildResult"
  buildResultId = "string"

Para Container, use:

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

Para Jar, use:

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

Para NetCoreZip , use:

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

Para de origem, use:

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

Para War, use:

  type = "War"
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"
  serverVersion = "string"

Valores de propriedade

Primavera/aplicativos/implantações

Designação Descrição Valor
tipo O tipo de recurso "Microsoft.AppPlatform/Spring/apps/deployments@2024-05-01-preview"
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: aplicativos
SKU Sku do recurso de implantação Sku
propriedades Propriedades do recurso de implantação DeploymentResourceProperties

DeploymentResourceProperties

Designação Descrição Valor
ativo Indica se a implantação está ativa Bool
deploymentSettings Configurações de implantação da implantação DeploymentSettings
fonte Informações de origem carregadas da implantação. UserSourceInfo

DeploymentSettings

Designação Descrição Valor
addonConfigs Coleção de addons DeploymentSettingsAddonConfigs
APMS Coleção de ApmReferences ApmReference[]
containerProbeSettings Configurações da sonda de prontidão e vivacidade do contêiner ContainerProbeSettings
environmentVariables Recolha de variáveis de ambiente DeploymentSettingsEnvironmentVariables
livenessSonda Teste periódico da vivacidade da instância do aplicativo. A Instância do Aplicativo será reiniciada se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
prontidãoSonda Investigação periódica da prontidão do serviço de Instância de Aplicativo. A Instância do Aplicativo será removida dos pontos de extremidade do serviço se a investigação falhar. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
resourceRequests A quantidade de recursos solicitada para CPU e memória necessárias. Recomenda-se que usando este campo para representar a CPU e a memória necessárias, a cpu de campo antigo e o memoryInGB serão preteridos posteriormente. ResourceRequests
Escala Dimensionamento de propriedades para a Instância do Aplicativo Azure Spring Apps. Escala
startupProbe StartupProbe indica que a Instância do Aplicativo foi inicializada com êxito. Se especificado, nenhum outro teste será executado até que isso seja concluído com êxito. Se esta sonda falhar, o Pod será reiniciado, como se a livenessProbe falhasse. Isso pode ser usado para fornecer parâmetros de teste diferentes no início do ciclo de vida de uma instância de aplicativo, quando pode levar muito tempo para carregar dados ou aquecer um cache, do que durante a operação em estado estacionário. Isso não pode ser atualizado. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Sonda
terminaçãoGracePeriodSeconds Duração opcional: em segundos, a Instância do Aplicativo precisa ser encerrada normalmente. Pode ser diminuído na solicitação de exclusão. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Se esse valor for nulo, o período de carência padrão será usado. O período de carência é a duração em segundos após os processos em execução na Instância do Aplicativo receberem um sinal de encerramento e o tempo em que os processos são interrompidos à força com um sinal de eliminação. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. O padrão é 90 segundos. Int

DeploymentSettingsAddonConfigs

Designação Descrição Valor
{propriedade personalizada}

ApmReference

Designação Descrição Valor
resourceId ID do recurso do APM string (obrigatório)

ContainerProbeSettings

Designação Descrição Valor
desativarSonda Indica se a sonda de vivacidade e prontidão desativa Bool

DeploymentSettingsEnvironmentVariables

Designação Descrição Valor
{propriedade personalizada} string

Sonda

Designação Descrição Valor
desativarSonda Indique se a sonda está desativada. bool (obrigatório)
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O valor mínimo é 1. Int
initialDelaySeconds Número de segundos após o início da Instância do Aplicativo antes que os testes sejam iniciados. Mais informações: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
períodoSegundos Com que frequência (em segundos) realizar a sonda. O valor mínimo é 1. Int
probeAction A ação da sonda. ProbeAction
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. Deve ser 1 para liveness e startup. O valor mínimo é 1. Int
timeoutSegundos Número de segundos após os quais a sonda atinge o tempo limite. O valor mínimo é 1. Int

ProbeAction

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

ExecAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. "ExecAction" (obrigatório)
comando Command é a linha de comando a ser executada dentro do contêiner, o diretório de trabalho para o comando é root ('/') no sistema de arquivos do contêiner. O comando não é executado dentro de um shell, então as instruções tradicionais do shell (',', etc) não funcionarão. Para usar um shell, você precisa chamar explicitamente para esse shell. O status de saída de 0 é tratado como vivo/saudável e diferente de zero não é íntegro. string[]

HttpGetAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. "HTTPGetAction" (obrigatório)
caminho Caminho de acesso no servidor HTTP. string
Regime Esquema a ser usado para se conectar ao host. O padrão é HTTP.

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

TCPSocketAction

Designação Descrição Valor
tipo O tipo de ação a ser executada para executar a verificação de integridade. "TCPSocketAction" (obrigatório)

ResourceRequests

Designação Descrição Valor
CPU CPU necessária. 1 núcleo pode ser representado por 1 ou 1000m. Isso deve ser 500m ou 1 para a camada Basic e {500m, 1, 2, 3, 4} para a camada Standard. string
memória Memória necessária. 1 GB pode ser representado por 1Gi ou 1024Mi. Isso deve ser {512Mi, 1Gi, 2Gi} para a camada Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} para a camada Standard. string

Escala

Designação Descrição Valor
maxRéplicas Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. Int
minRéplicas Opcional. Número mínimo de réplicas de contêiner. Int
regras Regras de dimensionamento. ScaleRule []

Regra de Escala

Designação Descrição Valor
azureQueue Escalonamento baseado em fila do Azure. QueueScaleRule
Personalizado Regra de escala personalizada. CustomScaleRule
Disponível em: Dimensionamento baseado em solicitações HTTP. HttpScaleRule
Designação Nome da regra de escala string
TCP Dimensionamento baseado em solicitações Tcp. TcpScaleRule

QueueScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala de fila. ScaleRuleAuth[]
queueLength Comprimento da fila. Int
queueName Nome da fila. string

ScaleRuleAuth

Designação Descrição Valor
secretRef Nome do segredo da Instância do Aplicativo Azure Spring Apps do qual extrair os parâmetros de autenticação. string
triggerParâmetro Parâmetro Trigger que usa o segredo string

CustomScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala personalizada. CustomScaleRuleMetadata
tipo Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc.
string

CustomScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

HttpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala personalizada. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala http. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

TcpScaleRule

Designação Descrição Valor
auth Segredos de autenticação para a regra de escala tcp. ScaleRuleAuth[]
metadados Propriedades de metadados para descrever a regra de escala tcp. TcpScaleRuleMetadata

TcpScaleRuleMetadata

Designação Descrição Valor
{propriedade personalizada} string

UserSourceInfo

Designação Descrição Valor
Versão Versão da fonte string
tipo Definir o tipo de objeto BuildResult
Container
Jar
NetCoreZip
de origem
Guerra (obrigatório)

BuildResultUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada "BuildResult" (obrigatório)
buildResultId ID de recurso de um resultado de compilação bem-sucedido existente na mesma instância do Spring. string

CustomContainerUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada "Contentor" (obrigatório)
customContainer Carga útil personalizada do contentor CustomContainer

Recipiente Personalizado

Designação Descrição Valor
Args Argumentos para o ponto de entrada. O CMD da imagem do docker é usado se isso não for fornecido. string[]
comando Matriz de ponto de entrada. Não executado dentro de um shell. O ENTRYPOINT da imagem do docker é usado se isso não for fornecido. string[]
containerImage Imagem de contêiner do contêiner personalizado. Isso deve ser na forma de {repository}:{tag} sem o nome do servidor do registro string
imageRegistryCredential Credencial do registo de imagens ImageRegistryCredential
languageFramework Estrutura de linguagem da imagem de contêiner carregada. Valores suportados: "springboot", "", null. string
servidor O nome do registro que contém a imagem do contêiner string

ImageRegistryCredential

Designação Descrição Valor
palavra-passe A senha da credencial de registro de imagem string
nome de utilizador O nome de usuário da credencial do registro de imagem string

JarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada "Jar" (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão em tempo de execução do arquivo Jar string

NetCoreZipUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte 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 tempo de execução do arquivo .Net string

SourceUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada "Fonte" (obrigatório)
artifactSelector Seletor para o artefato a ser usado para a implantação de projetos multimódulo. 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 de tempo de execução do arquivo de origem string

WarUploadedUserSourceInfo

Designação Descrição Valor
tipo Tipo de fonte carregada "Guerra" (obrigatório)
jvmOptions Parâmetro JVM string
relativePath Caminho relativo do armazenamento que armazena a origem string
runtimeVersion Versão de tempo de execução do arquivo de guerra string
serverVersion Versão do servidor, atualmente apenas o Apache Tomcat é suportado string

Referência

Designação Descrição Valor
capacidade Capacidade atual do recurso de destino Int
Designação Nome do Sku string
nível Nível do Sku string