Microsoft.AppPlatform Spring/apps/deployments

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.AppPlatform/Spring/apps/deployments, aggiungere il modello Bicep seguente.

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

Oggetti ProbeAction

Impostare la proprietà type per specificare il tipo di oggetto.

Per ExecAction, usare:

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

Per HTTPGetAction, usare:

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

Per TCPSocketAction, usare:

  type: 'TCPSocketAction'

Oggetti UserSourceInfo

Impostare la proprietà type per specificare il tipo di oggetto.

Per BuildResult, usare:

  type: 'BuildResult'
  buildResultId: 'string'

Per Contenitore, usare:

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

Per Jar, usare:

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

Per NetCoreZip, usare:

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

Per Origine, usare:

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

Valori delle proprietà

Spring/apps/deployments

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatoria)
sku Sku della risorsa di distribuzione Sku
padre In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.		 Nome simbolico per la risorsa di tipo: app
properties Proprietà della risorsa di distribuzione DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrizione Valore
active Indica se la distribuzione è attiva bool
deploymentSettings Impostazioni di distribuzione della distribuzione DeploymentSettings
source Informazioni di origine caricate della distribuzione. UserSourceInfo

DeploymentSettings

Nome Descrizione Valore
addonConfigs Raccolta di componenti aggiuntivi object
containerProbeSettings Impostazioni del probe di disponibilità e conformità dei contenitori ContainerProbeSettings
environmentVariables Raccolta di variabili di ambiente object
livenessProbe Probe periodico della livezza dell'istanza dell'app. Istanza dell'app verrà riavviata se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
readinessProbe Probe periodico dell'idoneità del servizio istanza dell'app. L'istanza dell'app verrà rimossa dagli endpoint del servizio se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
resourceRequests Quantità di risorsa richiesta per cpu e memoria necessarie. È consigliabile usare questo campo per rappresentare la CPU e la memoria necessari, la cpu del campo precedente e memoryInGB verrà deprecata in seguito. ResourceRequests
scala Ridimensionamento delle proprietà per l'istanza dell'app di Azure Spring Apps. Ridimensionamento
startupProbe StartupProbe indica che l'istanza dell'app è stata inizializzata correttamente. Se specificato, non vengono eseguiti altri probe fino a quando non viene completato correttamente. Se il probe ha esito negativo, il pod verrà riavviato, come se livenessProbe non fosse riuscito. Questa opzione può essere usata per fornire parametri probe diversi all'inizio del ciclo di vita di un'istanza dell'app, quando potrebbe richiedere molto tempo per caricare i dati o riscaldare una cache, rispetto a durante l'operazione con stato stabile. Impossibile aggiornarla. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
terminationGracePeriodSeconds La durata facoltativa in secondi dell'istanza dell'app deve terminare normalmente. Può essere ridotto nella richiesta di eliminazione. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Se questo valore è nil, verrà utilizzato invece il periodo di tolleranza predefinito. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nell'istanza dell'app vengono inviati un segnale di terminazione e il momento in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Il valore predefinito è 90 secondi. INT

ContainerProbeSettings

Nome Descrizione Valore
disableProbe Indica se disabilitare il probe di attività e conformità bool

Probe

Nome Descrizione Valore
disableProbe Indicare se il probe è disabilitato. bool (obbligatorio)
failureThreshold Errori consecutivi minimi che il probe deve essere considerato non riuscito dopo l'esito positivo. Il valore minimo è 1. INT
initialDelaySeconds Numero di secondi dopo l'avvio dell'istanza dell'app prima dell'avvio dei probe. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes INT
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore minimo è 1. INT
probeAction Azione del probe. ProbeAction
successThreshold Numero minimo di successi consecutivi per il probe da considerare riuscito dopo l'esito negativo. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. INT
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore minimo è 1. INT

ProbeAction

Nome Descrizione Valore
tipo Impostare il tipo di oggetto ExecAction
HTTPGetAction
TCPSocketAction (obbligatorio)

ExecAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'ExecAction' (obbligatorio)
. Il comando è la riga di comando da eseguire all'interno del contenitore, la directory di lavoro per il comando è radice ('/') nel file system del contenitore. Il comando non viene eseguito all'interno di una shell, quindi le istruzioni della shell tradizionali (',' e così via) non funzioneranno. Per usare una shell, è necessario chiamare in modo esplicito tale shell. Lo stato di uscita pari a 0 viene considerato attivo/integro e non zero non è integro. string[]

HttpGetAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'HTTPGetAction' (obbligatorio)
path Percorso di accesso nel server HTTP. string
scheme Schema da usare per la connessione all'host. Il valore predefinito è HTTP.

Valori di enumerazione possibili:
- "HTTP" significa che lo schema utilizzato sarà http://
- "HTTPS" significa che lo schema utilizzato sarà https://		 'HTTP'
'HTTPS'

TCPSocketAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'TCPSocketAction' (obbligatorio)

ResourceRequests

Nome Descrizione Valore
cpu CPU richiesta. 1 core può essere rappresentato da 1 o 1000m. Deve essere 500m o 1 per livello Basic e {500m, 1, 2, 3, 4} per livello Standard. string
memoria Memoria necessaria. 1 GB può essere rappresentato da 1Gi o 1024Mi. Deve essere {512Mi, 1Gi, 2Gi} per livello Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} per livello Standard. string

Scalabilità

Nome Descrizione Valore
maxReplicas Facoltativa. Numero massimo di repliche contenitore. Impostazione predefinita su 10 se non impostata. INT
minReplicas Facoltativa. Numero minimo di repliche contenitore. INT
regole Regole di ridimensionamento. ScaleRule[]

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
custom Regola di scalabilità personalizzata. CustomScaleRule
http Scalabilità basata sulle richieste HTTP. HttpScaleRule
name Nome regola di scalabilità string
tcp Scalabilità basata sulle richieste TCP. TcpScaleRule

QueueScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. INT
queueName Nome coda. string

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'istanza dell'app di Azure Spring Apps da cui eseguire il pull dei params di autenticazione. string
triggerParameter Parametro trigger che usa il segreto string

CustomScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. object
tipo Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.
 string

HttpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità http. object

TcpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità TCP. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità TCP. object

UserSourceInfo

Nome Descrizione Valore
version Versione dell'origine string
type Impostare il tipo di oggetto BuildResult
Contenitore
Vaso
NetCoreZip
Origine (obbligatorio)

BuildResultUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricata 'BuildResult' (obbligatorio)
buildResultId ID risorsa di un risultato di compilazione completato esistente nella stessa istanza spring. string

CustomContainerUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricata 'Container' (obbligatorio)
customContainer Payload del contenitore personalizzato CustomContainer

CustomContainer

Nome Descrizione Valore
args Argomenti per il punto di ingresso. Il CMD dell'immagine Docker viene usato se non viene specificato. string[]
. Matrice di punti di ingresso. Non eseguito all'interno di una shell. Se non viene specificato, viene usato ENTRYPOINT dell'immagine Docker. string[]
containerImage Immagine del contenitore personalizzato. Deve essere nel formato {repository}:{tag} senza il nome del server del Registro di sistema string
imageRegistryCredential Credenziali del Registro di sistema delle immagini ImageRegistryCredential
languageFramework Framework del linguaggio dell'immagine del contenitore caricata string
server Nome del registro che contiene l'immagine del contenitore string

ImageRegistryCredential

Nome Descrizione Valore
password Password delle credenziali del Registro di sistema delle immagini string
username Nome utente della credenziale del Registro di sistema delle immagini string

JarUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricata 'Jar' (obbligatorio)
jvmOptions Parametro JVM string
relativePath Percorso relativo della risorsa di archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file JAR string

NetCoreZipUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricata 'NetCoreZip' (obbligatorio)
netCoreMainEntryPath Percorso dell'eseguibile .NET relativo alla radice zip string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file .Net string

SourceUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'Source' (obbligatorio)
artifactSelector Selettore per l'artefatto da usare per la distribuzione per i progetti multi-modulo. Questo dovrebbe essere
percorso relativo al modulo/progetto di destinazione.		 string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file di origine string

Sku

Nome Descrizione Valore
capacità Capacità corrente della risorsa di destinazione INT
name Nome dello SKU string
Livello Livello dello SKU string

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.AppPlatform/Spring/apps/deployments, aggiungere il codice JSON seguente al modello.

{
  "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
    }
  }
}

Oggetti ProbeAction

Impostare la proprietà type per specificare il tipo di oggetto.

Per ExecAction, usare:

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

Per HTTPGetAction, usare:

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

Per TCPSocketAction, usare:

  "type": "TCPSocketAction"

Oggetti UserSourceInfo

Impostare la proprietà type per specificare il tipo di oggetto.

Per BuildResult, usare:

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

Per Contenitore, usare:

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

Per Jar, usare:

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

Per NetCoreZip, usare:

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

Per Origine, usare:

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

Valori delle proprietà

Spring/apps/deployments

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.AppPlatform/Spring/apps/deployments'
apiVersion Versione dell'API risorsa '2023-03-01-preview'
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio nei modelli di RESOURCE JSON.		 stringa (obbligatoria)
sku Sku della risorsa di distribuzione Sku
properties Proprietà della risorsa di distribuzione DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrizione Valore
active Indica se la distribuzione è attiva bool
deploymentSettings Impostazioni di distribuzione della distribuzione DeploymentSettings
source Informazioni di origine caricate della distribuzione. UserSourceInfo

DeploymentSettings

Nome Descrizione Valore
addonConfigs Raccolta di componenti aggiuntivi object
containerProbeSettings Impostazioni probe di disponibilità e conformità dei contenitori ContainerProbeSettings
environmentVariables Raccolta di variabili di ambiente object
livenessProbe Probe periodico della durata dell'istanza dell'app. L'istanza dell'app verrà riavviata se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
readinessProbe Probe periodico dell'idoneità del servizio dell'istanza dell'app. L'istanza dell'app verrà rimossa dagli endpoint di servizio se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
resourceRequests Quantità di risorse richiesta per la CPU e la memoria necessarie. È consigliabile usare questo campo per rappresentare la CPU e la memoria necessarie, la CPU del campo precedente e memoryInGB verrà deprecata in un secondo momento. ResourceRequests
scala Proprietà di ridimensionamento per l'istanza dell'app Azure Spring Apps. Ridimensionamento
startupProbe StartupProbe indica che l'istanza dell'app è stata inizializzata correttamente. Se specificato, non vengono eseguiti altri probe fino a quando non viene completato correttamente. Se il probe ha esito negativo, il pod verrà riavviato, come se livenessProbe non fosse riuscito. Questa opzione può essere usata per fornire parametri probe diversi all'inizio del ciclo di vita di un'istanza dell'app, quando potrebbe richiedere molto tempo per caricare i dati o riscaldare una cache, rispetto a durante l'operazione con stato stabile. Impossibile aggiornarla. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
terminationGracePeriodSeconds La durata facoltativa in secondi dell'istanza dell'app deve terminare normalmente. Può essere ridotto nella richiesta di eliminazione. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Se questo valore è nil, verrà utilizzato invece il periodo di tolleranza predefinito. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nell'istanza dell'app vengono inviati un segnale di terminazione e il momento in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Il valore predefinito è 90 secondi. INT

ContainerProbeSettings

Nome Descrizione Valore
disableProbe Indica se disabilitare il probe di attività e conformità bool

Probe

Nome Descrizione Valore
disableProbe Indicare se il probe è disabilitato. bool (obbligatorio)
failureThreshold Errori consecutivi minimi che il probe deve essere considerato non riuscito dopo l'esito positivo. Il valore minimo è 1. INT
initialDelaySeconds Numero di secondi dopo l'avvio dell'istanza dell'app prima dell'avvio dei probe. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes INT
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore minimo è 1. INT
probeAction Azione del probe. ProbeAction
successThreshold Numero minimo di successi consecutivi per il probe da considerare riuscito dopo l'esito negativo. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. INT
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore minimo è 1. INT

ProbeAction

Nome Descrizione Valore
tipo Impostare il tipo di oggetto ExecAction
HTTPGetAction
TCPSocketAction (obbligatorio)

ExecAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'ExecAction' (obbligatorio)
. Il comando è la riga di comando da eseguire all'interno del contenitore, la directory di lavoro per il comando è radice ('/') nel file system del contenitore. Il comando non viene eseguito all'interno di una shell, quindi le istruzioni della shell tradizionali (',' e così via) non funzioneranno. Per usare una shell, è necessario chiamare in modo esplicito tale shell. Lo stato di uscita pari a 0 viene considerato attivo/integro e non zero non è integro. string[]

HttpGetAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'HTTPGetAction' (obbligatorio)
path Percorso di accesso nel server HTTP. string
scheme Schema da usare per la connessione all'host. Impostazione predefinita su HTTP.

Valori di enumerazione possibili:
- "HTTP" significa che lo schema usato sarà http://
- "HTTPS" significa che lo schema usato sarà https://		 'HTTP'
'HTTPS'

TCPSocketAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. 'TCPSocketAction' (obbligatorio)

ResourceRequests

Nome Descrizione Valore
cpu CPU richiesta. 1 core può essere rappresentato da 1 o 1000m. Deve essere 500m o 1 per livello Basic e {500m, 1, 2, 3, 4} per livello Standard. string
memoria Memoria necessaria. 1 GB può essere rappresentato da 1Gi o 1024Mi. Deve essere {512Mi, 1Gi, 2Gi} per livello Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} per livello Standard. string

Scalabilità

Nome Descrizione Valore
maxReplicas Facoltativa. Numero massimo di repliche contenitore. Impostazione predefinita su 10 se non impostata. INT
minReplicas Facoltativa. Numero minimo di repliche contenitore. INT
regole Regole di ridimensionamento. ScaleRule[]

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
custom Regola di scalabilità personalizzata. CustomScaleRule
http Scalabilità basata sulle richieste HTTP. HttpScaleRule
name Nome regola di scalabilità string
tcp Scalabilità basata sulle richieste TCP. TcpScaleRule

QueueScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. INT
queueName Nome coda. string

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'istanza dell'app di Azure Spring Apps da cui eseguire il pull dei params di autenticazione. string
triggerParameter Parametro trigger che usa il segreto string

CustomScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. object
tipo Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.
 string

HttpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità http. object

TcpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità tcp. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità tcp. object

UserSourceInfo

Nome Descrizione Valore
version Versione dell'origine string
type Impostare il tipo di oggetto BuildResult
Contenitore
Vaso
NetCoreZip
Origine (obbligatoria)

BuildResultUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'BuildResult' (obbligatorio)
buildResultId ID risorsa di un risultato di compilazione esistente riuscito nella stessa istanza di Spring. string

CustomContainerUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'Container' (obbligatorio)
customContainer Payload del contenitore personalizzato CustomContainer

CustomContainer

Nome Descrizione Valore
args Argomenti al punto di ingresso. Il CMD dell'immagine docker viene usato se non viene fornito. string[]
. Matrice di punti di ingresso. Non eseguito all'interno di una shell. Se questa operazione non viene fornita, viene usata l'immagine docker. string[]
containerImage Immagine contenitore del contenitore personalizzato. Deve essere sotto forma di {repository}:{tag} senza il nome del server del Registro di sistema string
imageRegistryCredential Credenziali del Registro di sistema immagini ImageRegistryCredential
languageFramework Framework del linguaggio dell'immagine del contenitore caricata string
server Nome del Registro di sistema contenente l'immagine del contenitore string

ImageRegistryCredential

Nome Descrizione Valore
password Password della credenziale del Registro di sistema immagini string
username Nome utente della credenziale del Registro di sistema immagini string

JarUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'Jar' (obbligatorio)
jvmOptions Parametro JVM string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file Jar string

NetCoreZipUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'NetCoreZip' (obbligatorio)
netCoreMainEntryPath Percorso dell'eseguibile .NET relativo alla radice zip string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file .Net string

SourceUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato 'Source' (obbligatorio)
artifactSelector Selettore per l'artefatto da usare per la distribuzione per i progetti multi-modulo. Questo dovrebbe essere
percorso relativo al modulo/progetto di destinazione.		 string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file di origine string

Sku

Nome Descrizione Valore
capacità Capacità corrente della risorsa di destinazione INT
name Nome dello SKU string
Livello Livello dello SKU string

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.AppPlatform/Spring/apps/deployments, aggiungere il codice Terraform seguente al modello.

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"
    }
  })
}

Oggetti ProbeAction

Impostare la proprietà type per specificare il tipo di oggetto.

Per ExecAction, usare:

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

Per HTTPGetAction, usare:

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

Per TCPSocketAction, usare:

  type = "TCPSocketAction"

Oggetti UserSourceInfo

Impostare la proprietà type per specificare il tipo di oggetto.

Per BuildResult, usare:

  type = "BuildResult"
  buildResultId = "string"

Per Contenitore, usare:

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

Per Jar, usare:

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

Per NetCoreZip, usare:

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

Per Origine, usare:

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

Valori delle proprietà

Spring/apps/deployments

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.AppPlatform/Spring/apps/deployments@2023-03-01-preview"
name Nome della risorsa stringa (obbligatoria)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: app
sku Sku della risorsa di distribuzione Sku
properties Proprietà della risorsa di distribuzione DeploymentResourceProperties

DeploymentResourceProperties

Nome Descrizione Valore
active Indica se la distribuzione è attiva bool
deploymentSettings Impostazioni di distribuzione della distribuzione DeploymentSettings
source Informazioni sull'origine caricate della distribuzione. UserSourceInfo

DeploymentSettings

Nome Descrizione Valore
addonConfigs Raccolta di componenti aggiuntivi object
containerProbeSettings Impostazioni probe di disponibilità e conformità dei contenitori ContainerProbeSettings
environmentVariables Raccolta di variabili di ambiente object
livenessProbe Probe periodico della durata dell'istanza dell'app. L'istanza dell'app verrà riavviata se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
readinessProbe Probe periodico dell'idoneità del servizio dell'istanza dell'app. L'istanza dell'app verrà rimossa dagli endpoint di servizio se il probe ha esito negativo. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
resourceRequests Quantità di risorse richiesta per la CPU e la memoria necessarie. È consigliabile usare questo campo per rappresentare la CPU e la memoria necessarie, la CPU del campo precedente e memoryInGB verrà deprecata in un secondo momento. ResourceRequests
scala Proprietà di ridimensionamento per l'istanza dell'app Azure Spring Apps. Ridimensionamento
startupProbe StartupProbe indica che l'istanza dell'app è stata inizializzata correttamente. Se specificato, non vengono eseguiti altri probe fino a quando non viene completato correttamente. Se il probe ha esito negativo, il pod verrà riavviato, come se livenessProbe non fosse riuscito. Questa opzione può essere usata per fornire parametri probe diversi all'inizio del ciclo di vita di un'istanza dell'app, quando potrebbe richiedere molto tempo per caricare i dati o riscaldare una cache, rispetto a durante l'operazione con stato stabile. Impossibile aggiornarla. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Probe
terminationGracePeriodSeconds La durata facoltativa in secondi dell'istanza dell'app deve terminare normalmente. Può essere ridotto nella richiesta di eliminazione. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Se questo valore è nil, verrà utilizzato invece il periodo di tolleranza predefinito. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nell'istanza dell'app vengono inviati un segnale di terminazione e il momento in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Il valore predefinito è 90 secondi. INT

ContainerProbeSettings

Nome Descrizione Valore
disableProbe Indica se disabilitare il probe di attività e conformità bool

Probe

Nome Descrizione Valore
disableProbe Indicare se il probe è disabilitato. bool (obbligatorio)
failureThreshold Errori consecutivi minimi che il probe deve essere considerato non riuscito dopo l'esito positivo. Il valore minimo è 1. INT
initialDelaySeconds Numero di secondi dopo l'avvio dell'istanza dell'app prima dell'avvio dei probe. Altre informazioni: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes INT
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore minimo è 1. INT
probeAction Azione del probe. ProbeAction
successThreshold Numero minimo di successi consecutivi per il probe da considerare riuscito dopo l'esito negativo. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. INT
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore minimo è 1. INT

ProbeAction

Nome Descrizione Valore
tipo Impostare il tipo di oggetto ExecAction
HTTPGetAction
TCPSocketAction (obbligatorio)

ExecAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. "ExecAction" (obbligatorio)
. Il comando è la riga di comando da eseguire all'interno del contenitore, la directory di lavoro per il comando è radice ('/') nel file system del contenitore. Il comando non viene eseguito all'interno di una shell, quindi le istruzioni della shell tradizionali (',' e così via) non funzioneranno. Per usare una shell, è necessario chiamare in modo esplicito tale shell. Lo stato di uscita pari a 0 viene considerato attivo/integro e non zero non è integro. string[]

HttpGetAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. "HTTPGetAction" (obbligatorio)
path Percorso di accesso nel server HTTP. string
scheme Schema da usare per la connessione all'host. Il valore predefinito è HTTP.

Valori di enumerazione possibili:
- "HTTP" significa che lo schema utilizzato sarà http://
- "HTTPS" significa che lo schema utilizzato sarà https://		 "HTTP"
"HTTPS"

TCPSocketAction

Nome Descrizione Valore
tipo Tipo dell'azione da eseguire per eseguire il controllo di integrità. "TCPSocketAction" (obbligatorio)

ResourceRequests

Nome Descrizione Valore
cpu CPU richiesta. 1 core può essere rappresentato da 1 o 1000 m. Deve essere 500m o 1 per il livello Basic e {500m, 1, 2, 3, 4} per il livello Standard. string
memoria Memoria necessaria. 1 GB può essere rappresentato da 1Gi o 1024Mi. Deve essere {512Mi, 1Gi, 2Gi} per il livello Basic e {512Mi, 1Gi, 2Gi, ..., 8Gi} per il livello Standard. string

Scalabilità

Nome Descrizione Valore
maxReplicas Facoltativa. Numero massimo di repliche di contenitori. Il valore predefinito è 10 se non impostato. INT
minReplicas Facoltativa. Numero minimo di repliche del contenitore. INT
regole Regole di ridimensionamento. ScaleRule[]

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
custom Regola di scalabilità personalizzata. CustomScaleRule
http Scalabilità basata sulle richieste HTTP. HttpScaleRule
name Nome regola di scalabilità string
tcp Ridimensionamento basato sulle richieste TCP. TcpScaleRule

QueueScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. INT
queueName Nome coda. string

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'istanza dell'app di Azure Spring Apps da cui eseguire il pull dei params di autenticazione. string
triggerParameter Parametro trigger che usa il segreto string

CustomScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. object
tipo Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.
 string

HttpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità http. object

TcpScaleRule

Nome Descrizione Valore
auth Segreti di autenticazione per la regola di scalabilità tcp. ScaleRuleAuth[]
metadata Proprietà dei metadati per descrivere la regola di scalabilità tcp. object

UserSourceInfo

Nome Descrizione Valore
version Versione dell'origine string
type Impostare il tipo di oggetto BuildResult
Contenitore
Vaso
NetCoreZip
Origine (obbligatoria)

BuildResultUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato "BuildResult" (obbligatorio)
buildResultId ID risorsa di un risultato di compilazione esistente riuscito nella stessa istanza di Spring. string

CustomContainerUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato "Contenitore" (obbligatorio)
customContainer Payload del contenitore personalizzato CustomContainer

CustomContainer

Nome Descrizione Valore
args Argomenti al punto di ingresso. Il CMD dell'immagine docker viene usato se non viene fornito. string[]
. Matrice di punti di ingresso. Non eseguito all'interno di una shell. Se questa operazione non viene fornita, viene usata l'immagine docker. string[]
containerImage Immagine contenitore del contenitore personalizzato. Deve essere sotto forma di {repository}:{tag} senza il nome del server del Registro di sistema string
imageRegistryCredential Credenziali del Registro di sistema immagini ImageRegistryCredential
languageFramework Framework del linguaggio dell'immagine del contenitore caricata string
server Nome del Registro di sistema contenente l'immagine del contenitore string

ImageRegistryCredential

Nome Descrizione Valore
password Password della credenziale del Registro di sistema immagini string
username Nome utente della credenziale del Registro di sistema immagini string

JarUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato "Jar" (obbligatorio)
jvmOptions Parametro JVM string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file Jar string

NetCoreZipUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato "NetCoreZip" (obbligatorio)
netCoreMainEntryPath Percorso dell'eseguibile .NET relativo alla radice zip string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file .Net string

SourceUploadedUserSourceInfo

Nome Descrizione Valore
tipo Tipo dell'origine caricato "Source" (obbligatorio)
artifactSelector Selettore per l'artefatto da usare per la distribuzione per i progetti multi-modulo. Questo dovrebbe essere
percorso relativo al modulo/progetto di destinazione.		 string
relativePath Percorso relativo dell'archiviazione che archivia l'origine string
runtimeVersion Versione di runtime del file di origine string

Sku

Nome Descrizione Valore
capacità Capacità corrente della risorsa di destinazione INT
name Nome dello SKU string
Livello Livello dello SKU string