Microsoft.AppPlatform Spring/apps/deployments 2023-12-01
- più recenti
- 2024-05-01-preview
- 2024-01-01-preview
- 2023-12-01
- 2023-11-01-preview
- 2023-09-01-preview
- 2023-07-01-preview
- 2023-05-01-preview
- 2023-03-01-preview
- 01-01-2023
- 2022-12-01
11-11-2022 -
09-09-2022 -
05-05-2022 - 2022-04-01
03-03-2022 - 01-01-2022
- 2021-09-01-preview
- 2021-06-01-preview
- 11-01-preview 2020
- 2020-07-01
Definizione di risorsa Bicep
Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.AppPlatform/Spring/apps/deployments, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2023-12-01' = {
parent: resourceSymbolicName
name: 'string'
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'
}
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 UserSourceInfo
Impostare la proprietà tipo di
Per BuildResult, usare:
{
buildResultId: 'string'
type: 'BuildResult'
}
Per Contenitore, usare:
{
customContainer: {
args: [
'string'
]
command: [
'string'
]
containerImage: 'string'
imageRegistryCredential: {
password: 'string'
username: 'string'
}
languageFramework: 'string'
server: 'string'
}
type: 'Container'
}
Per jar, usare:
{
jvmOptions: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'Jar'
}
Per NetCoreZip, usare:
{
netCoreMainEntryPath: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'NetCoreZip'
}
Per origine, usare:
{
artifactSelector: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'Source'
}
Per War, usare:
{
jvmOptions: 'string'
relativePath: 'string'
runtimeVersion: 'string'
serverVersion: 'string'
type: 'War'
}
Oggetti ProbeAction
Impostare la proprietà tipo di
Per ExecAction, usare:
{
command: [
'string'
]
type: 'ExecAction'
}
Per HTTPGetAction, usare:
{
path: 'string'
scheme: 'string'
type: 'HTTPGetAction'
}
Per TCPSocketAction, usare:
{
type: 'TCPSocketAction'
}
Valori delle proprietà
ApmReference
Nome | Descrizione | Valore |
---|---|---|
resourceId | ID risorsa di APM | stringa (obbligatorio) |
BuildResultUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
buildResultId | ID risorsa di un risultato di compilazione esistente completato nella stessa istanza spring. | corda |
digitare | Tipo dell'origine caricata | 'BuildResult' (obbligatorio) |
ContainerProbeSettings
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indica se disabilitare il probe di attività e conformità | Bool |
CustomContainer
Nome | Descrizione | Valore |
---|---|---|
argomenti | Argomenti per il punto di ingresso. Il CMD dell'immagine Docker viene usato se non viene specificato. | string[] |
comando | 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 sotto forma di <repository>:<tag> senza il nome del server del Registro di sistema | corda |
imageRegistryCredential | Credenziali del Registro di sistema delle immagini | ImageRegistryCredential |
languageFramework | Framework del linguaggio dell'immagine del contenitore caricata. Valori supportati: "springboot", "", null. | corda |
server | Nome del Registro di sistema che contiene l'immagine del contenitore | corda |
CustomContainerUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
customContainer | Payload del contenitore personalizzato | CustomContainer |
digitare | Tipo dell'origine caricata | 'Container' (obbligatorio) |
DeploymentResourceProperties
Nome | Descrizione | Valore |
---|---|---|
attivo | Indica se la distribuzione è attiva | Bool |
deploymentSettings | Impostazioni di distribuzione della distribuzione | DeploymentSettings |
fonte | Informazioni sull'origine caricate della distribuzione. | UserSourceInfo |
DeploymentSettings
Nome | Descrizione | Valore |
---|---|---|
addonConfigs | Raccolta di componenti aggiuntivi | DeploymentSettingsAddonConfigs |
apms | Raccolta di ApmReferences | ApmReference [] |
containerProbeSettings | Impostazioni del probe di disponibilità e conformità dei contenitori | ContainerProbeSettings |
environmentVariables | Raccolta di variabili di ambiente | DeploymentSettingsEnvironmentVariables |
livenessProbe | Probe periodico della durata dell'istanza dell'app. L'istanza dell'app verrà riavviata se il probe non riesce. 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 non riesce. 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 |
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 riuscisse. Può essere usato per fornire parametri di 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 costante. Non è possibile aggiornarlo. 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à invece utilizzato 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 tempo 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 |
DeploymentSettingsAddonConfigs
Nome | Descrizione | Valore |
---|
DeploymentSettingsEnvironmentVariables
Nome | Descrizione | Valore |
---|
ExecAction
Nome | Descrizione | Valore | |
---|---|---|---|
comando | 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 (' | ', ecc) non funzionerà. 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[] |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'ExecAction' (obbligatorio) |
HttpGetAction
Nome | Descrizione | Valore |
---|---|---|
sentiero | Percorso di accesso nel server HTTP. | corda |
schema | 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 verrà https:// |
'HTTP' 'HTTPS' |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'HTTPGetAction' (obbligatorio) |
ImageRegistryCredential
Nome | Descrizione | Valore |
---|---|---|
parola d’ordine | Password delle credenziali del Registro di sistema delle immagini | corda |
nome utente | Nome utente della credenziale del Registro di sistema delle immagini | corda |
JarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file JAR | corda |
digitare | Tipo dell'origine caricata | 'Jar' (obbligatorio) |
Microsoft.AppPlatform/Spring/apps/deployments
Nome | Descrizione | Valore |
---|---|---|
nome | Nome della risorsa | stringa (obbligatorio) |
genitore | 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 all'esterno della risorsa padre. |
Nome simbolico per la risorsa di tipo: Spring/apps |
proprietà | Proprietà della risorsa di distribuzione | DeploymentResourceProperties |
Sku | Sku della risorsa di distribuzione | Sku |
NetCoreZipUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
netCoreMainEntryPath | Percorso dell'eseguibile .NET relativo alla radice zip | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file .NET | corda |
digitare | Tipo dell'origine caricata | 'NetCoreZip' (obbligatorio) |
Sonda
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indicare se il probe è disabilitato. | bool (obbligatorio) |
failureThreshold | Errori consecutivi minimi per il probe da considerare 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 che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. 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 |
---|---|---|
digitare | Impostare su "ExecAction" per il tipo ExecAction. Impostare su "HTTPGetAction" per il tipo HttpGetAction. Impostare su "TCPSocketAction" per il tipo TCPSocketAction. | 'ExecAction' 'HTTPGetAction' '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. | corda |
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. | corda |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità corrente della risorsa di destinazione | Int |
nome | Nome dello SKU | corda |
livello | Livello dello SKU | corda |
SourceUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
artifactSelector | Selettore per l'artefatto da usare per la distribuzione per i progetti multimodulo. Deve trattarsi di percorso relativo al modulo/progetto di destinazione. |
corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file di origine | corda |
digitare | Tipo dell'origine caricata | 'Source' (obbligatorio) |
TCPSocketAction
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'TCPSocketAction' (obbligatorio) |
UserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
digitare | Impostare su 'BuildResult' per il tipo BuildResultUserSourceInfo. Impostare su "Contenitore" per il tipo CustomContainerUserSourceInfo. Impostare su "Jar" per il tipo JarUploadedUserSourceInfo. Impostare su "NetCoreZip" per il tipo NetCoreZipUploadedUserSourceInfo. Impostare su 'Source' per il tipo SourceUploadedUserSourceInfo. Impostare su "War" per il tipo WarUploadedUserSourceInfo. | 'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' 'War' (obbligatorio) |
Versione | Versione dell'origine | corda |
WarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file war | corda |
serverVersion | Versione del server, attualmente è supportato solo Apache Tomcat | corda |
digitare | Tipo dell'origine caricata | 'War' (obbligatorio) |
Esempi di utilizzo
Esempi di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.
Bicep File | Descrizione |
---|---|
Distribuire una semplice applicazione di microservizi di Azure Spring Apps | Questo modello distribuisce una semplice applicazione di microservizio di Azure Spring Apps da eseguire in Azure. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato 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-12-01",
"name": "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"
},
"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 UserSourceInfo
Impostare la proprietà tipo di
Per BuildResult, usare:
{
"buildResultId": "string",
"type": "BuildResult"
}
Per Contenitore, usare:
{
"customContainer": {
"args": [ "string" ],
"command": [ "string" ],
"containerImage": "string",
"imageRegistryCredential": {
"password": "string",
"username": "string"
},
"languageFramework": "string",
"server": "string"
},
"type": "Container"
}
Per jar, usare:
{
"jvmOptions": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "Jar"
}
Per NetCoreZip, usare:
{
"netCoreMainEntryPath": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "NetCoreZip"
}
Per origine, usare:
{
"artifactSelector": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "Source"
}
Per War, usare:
{
"jvmOptions": "string",
"relativePath": "string",
"runtimeVersion": "string",
"serverVersion": "string",
"type": "War"
}
Oggetti ProbeAction
Impostare la proprietà tipo di
Per ExecAction, usare:
{
"command": [ "string" ],
"type": "ExecAction"
}
Per HTTPGetAction, usare:
{
"path": "string",
"scheme": "string",
"type": "HTTPGetAction"
}
Per TCPSocketAction, usare:
{
"type": "TCPSocketAction"
}
Valori delle proprietà
ApmReference
Nome | Descrizione | Valore |
---|---|---|
resourceId | ID risorsa di APM | stringa (obbligatorio) |
BuildResultUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
buildResultId | ID risorsa di un risultato di compilazione esistente completato nella stessa istanza spring. | corda |
digitare | Tipo dell'origine caricata | 'BuildResult' (obbligatorio) |
ContainerProbeSettings
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indica se disabilitare il probe di attività e conformità | Bool |
CustomContainer
Nome | Descrizione | Valore |
---|---|---|
argomenti | Argomenti per il punto di ingresso. Il CMD dell'immagine Docker viene usato se non viene specificato. | string[] |
comando | 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 sotto forma di <repository>:<tag> senza il nome del server del Registro di sistema | corda |
imageRegistryCredential | Credenziali del Registro di sistema delle immagini | ImageRegistryCredential |
languageFramework | Framework del linguaggio dell'immagine del contenitore caricata. Valori supportati: "springboot", "", null. | corda |
server | Nome del Registro di sistema che contiene l'immagine del contenitore | corda |
CustomContainerUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
customContainer | Payload del contenitore personalizzato | CustomContainer |
digitare | Tipo dell'origine caricata | 'Container' (obbligatorio) |
DeploymentResourceProperties
Nome | Descrizione | Valore |
---|---|---|
attivo | Indica se la distribuzione è attiva | Bool |
deploymentSettings | Impostazioni di distribuzione della distribuzione | DeploymentSettings |
fonte | Informazioni sull'origine caricate della distribuzione. | UserSourceInfo |
DeploymentSettings
Nome | Descrizione | Valore |
---|---|---|
addonConfigs | Raccolta di componenti aggiuntivi | DeploymentSettingsAddonConfigs |
apms | Raccolta di ApmReferences | ApmReference [] |
containerProbeSettings | Impostazioni del probe di disponibilità e conformità dei contenitori | ContainerProbeSettings |
environmentVariables | Raccolta di variabili di ambiente | DeploymentSettingsEnvironmentVariables |
livenessProbe | Probe periodico della durata dell'istanza dell'app. L'istanza dell'app verrà riavviata se il probe non riesce. 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 non riesce. 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 |
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 riuscisse. Può essere usato per fornire parametri di 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 costante. Non è possibile aggiornarlo. 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à invece utilizzato 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 tempo 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 |
DeploymentSettingsAddonConfigs
Nome | Descrizione | Valore |
---|
DeploymentSettingsEnvironmentVariables
Nome | Descrizione | Valore |
---|
ExecAction
Nome | Descrizione | Valore | |
---|---|---|---|
comando | 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 (' | ', ecc) non funzionerà. 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[] |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'ExecAction' (obbligatorio) |
HttpGetAction
Nome | Descrizione | Valore |
---|---|---|
sentiero | Percorso di accesso nel server HTTP. | corda |
schema | 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 verrà https:// |
'HTTP' 'HTTPS' |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'HTTPGetAction' (obbligatorio) |
ImageRegistryCredential
Nome | Descrizione | Valore |
---|---|---|
parola d’ordine | Password delle credenziali del Registro di sistema delle immagini | corda |
nome utente | Nome utente della credenziale del Registro di sistema delle immagini | corda |
JarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file JAR | corda |
digitare | Tipo dell'origine caricata | 'Jar' (obbligatorio) |
Microsoft.AppPlatform/Spring/apps/deployments
Nome | Descrizione | Valore |
---|---|---|
apiVersion | Versione dell'API | '2023-12-01' |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà della risorsa di distribuzione | DeploymentResourceProperties |
Sku | Sku della risorsa di distribuzione | Sku |
digitare | Tipo di risorsa | 'Microsoft.AppPlatform/Spring/apps/deployments' |
NetCoreZipUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
netCoreMainEntryPath | Percorso dell'eseguibile .NET relativo alla radice zip | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file .NET | corda |
digitare | Tipo dell'origine caricata | 'NetCoreZip' (obbligatorio) |
Sonda
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indicare se il probe è disabilitato. | bool (obbligatorio) |
failureThreshold | Errori consecutivi minimi per il probe da considerare 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 che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. 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 |
---|---|---|
digitare | Impostare su "ExecAction" per il tipo ExecAction. Impostare su "HTTPGetAction" per il tipo HttpGetAction. Impostare su "TCPSocketAction" per il tipo TCPSocketAction. | 'ExecAction' 'HTTPGetAction' '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. | corda |
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. | corda |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità corrente della risorsa di destinazione | Int |
nome | Nome dello SKU | corda |
livello | Livello dello SKU | corda |
SourceUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
artifactSelector | Selettore per l'artefatto da usare per la distribuzione per i progetti multimodulo. Deve trattarsi di percorso relativo al modulo/progetto di destinazione. |
corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file di origine | corda |
digitare | Tipo dell'origine caricata | 'Source' (obbligatorio) |
TCPSocketAction
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'TCPSocketAction' (obbligatorio) |
UserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
digitare | Impostare su 'BuildResult' per il tipo BuildResultUserSourceInfo. Impostare su "Contenitore" per il tipo CustomContainerUserSourceInfo. Impostare su "Jar" per il tipo JarUploadedUserSourceInfo. Impostare su "NetCoreZip" per il tipo NetCoreZipUploadedUserSourceInfo. Impostare su 'Source' per il tipo SourceUploadedUserSourceInfo. Impostare su "War" per il tipo WarUploadedUserSourceInfo. | 'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' 'War' (obbligatorio) |
Versione | Versione dell'origine | corda |
WarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file war | corda |
serverVersion | Versione del server, attualmente è supportato solo Apache Tomcat | corda |
digitare | Tipo dell'origine caricata | 'War' (obbligatorio) |
Esempi di utilizzo
Modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.
Sagoma | Descrizione |
---|---|
Distribuire una semplice applicazione di microservizi di Azure Spring Apps |
Questo modello distribuisce una semplice applicazione di microservizio di Azure Spring Apps da eseguire in Azure. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa Spring/apps/deployments può essere distribuito con operazioni destinate a:
- gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato 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-12-01"
name = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
body = jsonencode({
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"
}
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 UserSourceInfo
Impostare la proprietà tipo di
Per BuildResult, usare:
{
buildResultId = "string"
type = "BuildResult"
}
Per Contenitore, usare:
{
customContainer = {
args = [
"string"
]
command = [
"string"
]
containerImage = "string"
imageRegistryCredential = {
password = "string"
username = "string"
}
languageFramework = "string"
server = "string"
}
type = "Container"
}
Per jar, usare:
{
jvmOptions = "string"
relativePath = "string"
runtimeVersion = "string"
type = "Jar"
}
Per NetCoreZip, usare:
{
netCoreMainEntryPath = "string"
relativePath = "string"
runtimeVersion = "string"
type = "NetCoreZip"
}
Per origine, usare:
{
artifactSelector = "string"
relativePath = "string"
runtimeVersion = "string"
type = "Source"
}
Per War, usare:
{
jvmOptions = "string"
relativePath = "string"
runtimeVersion = "string"
serverVersion = "string"
type = "War"
}
Oggetti ProbeAction
Impostare la proprietà tipo di
Per ExecAction, usare:
{
command = [
"string"
]
type = "ExecAction"
}
Per HTTPGetAction, usare:
{
path = "string"
scheme = "string"
type = "HTTPGetAction"
}
Per TCPSocketAction, usare:
{
type = "TCPSocketAction"
}
Valori delle proprietà
ApmReference
Nome | Descrizione | Valore |
---|---|---|
resourceId | ID risorsa di APM | stringa (obbligatorio) |
BuildResultUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
buildResultId | ID risorsa di un risultato di compilazione esistente completato nella stessa istanza spring. | corda |
digitare | Tipo dell'origine caricata | 'BuildResult' (obbligatorio) |
ContainerProbeSettings
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indica se disabilitare il probe di attività e conformità | Bool |
CustomContainer
Nome | Descrizione | Valore |
---|---|---|
argomenti | Argomenti per il punto di ingresso. Il CMD dell'immagine Docker viene usato se non viene specificato. | string[] |
comando | 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 sotto forma di <repository>:<tag> senza il nome del server del Registro di sistema | corda |
imageRegistryCredential | Credenziali del Registro di sistema delle immagini | ImageRegistryCredential |
languageFramework | Framework del linguaggio dell'immagine del contenitore caricata. Valori supportati: "springboot", "", null. | corda |
server | Nome del Registro di sistema che contiene l'immagine del contenitore | corda |
CustomContainerUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
customContainer | Payload del contenitore personalizzato | CustomContainer |
digitare | Tipo dell'origine caricata | 'Container' (obbligatorio) |
DeploymentResourceProperties
Nome | Descrizione | Valore |
---|---|---|
attivo | Indica se la distribuzione è attiva | Bool |
deploymentSettings | Impostazioni di distribuzione della distribuzione | DeploymentSettings |
fonte | Informazioni sull'origine caricate della distribuzione. | UserSourceInfo |
DeploymentSettings
Nome | Descrizione | Valore |
---|---|---|
addonConfigs | Raccolta di componenti aggiuntivi | DeploymentSettingsAddonConfigs |
apms | Raccolta di ApmReferences | ApmReference [] |
containerProbeSettings | Impostazioni del probe di disponibilità e conformità dei contenitori | ContainerProbeSettings |
environmentVariables | Raccolta di variabili di ambiente | DeploymentSettingsEnvironmentVariables |
livenessProbe | Probe periodico della durata dell'istanza dell'app. L'istanza dell'app verrà riavviata se il probe non riesce. 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 non riesce. 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 |
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 riuscisse. Può essere usato per fornire parametri di 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 costante. Non è possibile aggiornarlo. 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à invece utilizzato 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 tempo 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 |
DeploymentSettingsAddonConfigs
Nome | Descrizione | Valore |
---|
DeploymentSettingsEnvironmentVariables
Nome | Descrizione | Valore |
---|
ExecAction
Nome | Descrizione | Valore | |
---|---|---|---|
comando | 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 (' | ', ecc) non funzionerà. 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[] |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'ExecAction' (obbligatorio) |
HttpGetAction
Nome | Descrizione | Valore |
---|---|---|
sentiero | Percorso di accesso nel server HTTP. | corda |
schema | 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 verrà https:// |
'HTTP' 'HTTPS' |
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'HTTPGetAction' (obbligatorio) |
ImageRegistryCredential
Nome | Descrizione | Valore |
---|---|---|
parola d’ordine | Password delle credenziali del Registro di sistema delle immagini | corda |
nome utente | Nome utente della credenziale del Registro di sistema delle immagini | corda |
JarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file JAR | corda |
digitare | Tipo dell'origine caricata | 'Jar' (obbligatorio) |
Microsoft.AppPlatform/Spring/apps/deployments
Nome | Descrizione | Valore |
---|---|---|
nome | Nome della risorsa | stringa (obbligatorio) |
parent_id | ID della risorsa padre per questa risorsa. | ID per la risorsa di tipo: Spring/apps |
proprietà | Proprietà della risorsa di distribuzione | DeploymentResourceProperties |
Sku | Sku della risorsa di distribuzione | Sku |
digitare | Tipo di risorsa | "Microsoft.AppPlatform/Spring/apps/deployments@2023-12-01" |
NetCoreZipUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
netCoreMainEntryPath | Percorso dell'eseguibile .NET relativo alla radice zip | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file .NET | corda |
digitare | Tipo dell'origine caricata | 'NetCoreZip' (obbligatorio) |
Sonda
Nome | Descrizione | Valore |
---|---|---|
disableProbe | Indicare se il probe è disabilitato. | bool (obbligatorio) |
failureThreshold | Errori consecutivi minimi per il probe da considerare 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 che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. 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 |
---|---|---|
digitare | Impostare su "ExecAction" per il tipo ExecAction. Impostare su "HTTPGetAction" per il tipo HttpGetAction. Impostare su "TCPSocketAction" per il tipo TCPSocketAction. | 'ExecAction' 'HTTPGetAction' '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. | corda |
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. | corda |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità corrente della risorsa di destinazione | Int |
nome | Nome dello SKU | corda |
livello | Livello dello SKU | corda |
SourceUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
artifactSelector | Selettore per l'artefatto da usare per la distribuzione per i progetti multimodulo. Deve trattarsi di percorso relativo al modulo/progetto di destinazione. |
corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file di origine | corda |
digitare | Tipo dell'origine caricata | 'Source' (obbligatorio) |
TCPSocketAction
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo dell'azione da eseguire per eseguire il controllo di integrità. | 'TCPSocketAction' (obbligatorio) |
UserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
digitare | Impostare su 'BuildResult' per il tipo BuildResultUserSourceInfo. Impostare su "Contenitore" per il tipo CustomContainerUserSourceInfo. Impostare su "Jar" per il tipo JarUploadedUserSourceInfo. Impostare su "NetCoreZip" per il tipo NetCoreZipUploadedUserSourceInfo. Impostare su 'Source' per il tipo SourceUploadedUserSourceInfo. Impostare su "War" per il tipo WarUploadedUserSourceInfo. | 'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' 'War' (obbligatorio) |
Versione | Versione dell'origine | corda |
WarUploadedUserSourceInfo
Nome | Descrizione | Valore |
---|---|---|
jvmOptions | Parametro JVM | corda |
relativePath | Percorso relativo dell'archiviazione in cui è archiviata l'origine | corda |
runtimeVersion | Versione di runtime del file war | corda |
serverVersion | Versione del server, attualmente è supportato solo Apache Tomcat | corda |
digitare | Tipo dell'origine caricata | 'War' (obbligatorio) |