Partager via


az spring app deployment

Remarque

Cette référence fait partie de l’extension spring pour Azure CLI (version 2.56.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az spring app deployment command. En savoir plus sur les extensions.

Ce groupe de commandes est implicitement déconseillé, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Commandes pour gérer le cycle de vie des déploiements d’une application dans Azure Spring Apps. Des opérations supplémentaires sur les déploiements peuvent être effectuées au niveau de l’application avec le paramètre --deployment. par exemple, az spring app deploy --deployment <staging deployment>.

Commandes

Nom Description Type État
az spring app deployment create

Créer un déploiement intermédiaire pour l’application. Pour déployer du code ou mettre à jour le paramètre vers un déploiement existant, utilisez az spring app deploy/update --deployment <staging deployment>.

Extension Deprecated
az spring app deployment delete

Supprimer un déploiement de l’application.

Extension Deprecated
az spring app deployment generate-heap-dump

Générez un vidage de tas de votre instance d’application cible pour donner le chemin d’accès au fichier.

Extension Deprecated
az spring app deployment generate-thread-dump

Générez un vidage de thread de votre instance d’application cible pour donner le chemin d’accès au fichier.

Extension Deprecated
az spring app deployment list

Lister tous les déploiements dans une application.

Extension Deprecated
az spring app deployment show

Afficher les détails d’un déploiement.

Extension Deprecated
az spring app deployment start-jfr

Démarrez un JFR sur votre instance d’application cible pour donner le chemin d’accès au fichier.

Extension Deprecated

az spring app deployment create

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Créer un déploiement intermédiaire pour l’application. Pour déployer du code ou mettre à jour le paramètre vers un déploiement existant, utilisez az spring app deploy/update --deployment <staging deployment>.

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--disable-app-log]
                                [--disable-probe {false, true}]
                                [--disable-validation {false, true}]
                                [--enable-liveness-probe {false, true}]
                                [--enable-readiness-probe {false, true}]
                                [--enable-startup-probe {false, true}]
                                [--env]
                                [--grace-period --termination-grace-period-seconds]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                                [--scale-rule-auth --sra]
                                [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                                [--scale-rule-metadata --srm]
                                [--scale-rule-name --srn]
                                [--scale-rule-type --srt]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

Exemples

Déployez le code source dans un nouveau déploiement d’une application. Cela packera le répertoire actif, générez le fichier binaire avec Pivotal Build Service, puis déployez.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --source-path

Déployez un fichier jar prédéfini dans une application avec des options jvm et des variables d’environnement.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Déployez une image conteneur sur Docker Hub sur une application.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

Déployez une image conteneur sur un registre privé sur une application.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Paramètres obligatoires

--app

Nom de l’application.

--name -n

Nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--apms

(Niveau Entreprise uniquement) Noms APM séparés par l’espace.

--artifact-path

Déployez l’artefact prédéfini spécifié (jar, war ou netcore zip, war est en préversion publique).

--build-certificates

(Niveau Entreprise uniquement) Les noms de certificats séparés par l’espace, les certificats sont utilisés pendant la génération.

--build-env

Variables d’environnement séparées par espace au format « key[=value] ».

--builder

(Niveau Entreprise uniquement) Générer le générateur de services utilisé pour générer l’exécutable.

Propriété Valeur
Valeur par défaut: default
--config-file-patterns

(Niveau Entreprise uniquement) Modèles de fichier de configuration séparés par « , » pour décider quels modèles du service de configuration d’application seront utilisés. Utilisez « » pour effacer les configurations existantes.

--container-args

Arguments de l’image conteneur.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--container-command

Commande de l’image conteneur.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--container-image

Balise d’image conteneur.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--container-registry

Registre de l’image conteneur.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
Valeur par défaut: docker.io
--cpu

Quantité de ressources processeur. Doit être de 250m, 500m, 750m, 1250m ou un nombre de cœurs de processeur.

--custom-actuator-path

(Niveau Entreprise uniquement) Chemin d’actionneur personnalisé de l’application. Valeur par défaut « /actuator ».

--custom-actuator-port

(Niveau Entreprise uniquement) Port d’actionneur personnalisé pour l’application. Valeur par défaut 8080.

--disable-app-log

N’imprimez pas les journaux d’application lors du déploiement de l’application.

Propriété Valeur
Valeur par défaut: False
--disable-probe

Si la valeur est true, désactivez la sonde liveness et readiness.

Propriété Valeur
Valeurs acceptées: false, true
--disable-validation

Si la valeur est true, désactivez la validation jar.

Propriété Valeur
Valeurs acceptées: false, true
--enable-liveness-probe
Préversion

Si la valeur est false, désactivez la sonde liveness de l’instance d’application.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
Valeurs acceptées: false, true
--enable-readiness-probe
Préversion

Si la valeur est false, désactivez la sonde de préparation de l’instance d’application.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
Valeurs acceptées: false, true
--enable-startup-probe
Préversion

Si la valeur est false, désactivez la sonde de démarrage de l’instance d’application.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
Valeurs acceptées: false, true
--env

Variables d’environnement séparées par espace au format « key[=value] ».

--grace-period --termination-grace-period-seconds
Préversion

Durée facultative en secondes, l’instance de l’application doit s’arrêter correctement.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
--instance-count

Nombre d’instances.

--jvm-options

Chaîne contenant des options jvm, utilisez '=' au lieu de ' ' pour cet argument pour éviter l’erreur d’analyse bash, par exemple : --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Infrastructure de langage de l’image conteneur chargée. Valeurs prises en charge : « springboot », « ».

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--liveness-probe-config
Préversion

Un chemin d’accès au fichier json indique la configuration de la sonde liveness.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
--main-entry -m

Chaîne contenant le chemin d’accès à l’exécutable .NET par rapport à la racine zip.

--max-replicas

Nombre maximal de réplicas.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
Valeur par défaut: 10
--memory

Quantité de ressources mémoire. Doit être 512Mi, 1536Mi, 2560Mi, 3584Mi ou #Gi, par exemple, 1Gi, 3Gi.

--min-replicas

Nombre minimal de réplicas.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
Valeur par défaut: 1
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--readiness-probe-config
Préversion

Un chemin d’accès au fichier json indique la configuration de la sonde de préparation.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
--registry-password

Mot de passe du registre de conteneurs.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--registry-username

Nom d’utilisateur du registre de conteneurs.

Propriété Valeur
Groupe de paramètres: Custom Container Arguments
--runtime-version

Version runtime du langage utilisé.

Propriété Valeur
Valeurs acceptées: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Mettre à l’échelle les paramètres d’authentification des règles. Format <triggerParameter>=<secretRef> et séparés par espace.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

Nombre maximal de requêtes simultanées avant le scale-out. Uniquement pris en charge pour les règles de mise à l’échelle http et tcp.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
--scale-rule-metadata --srm

Mettre à l’échelle les métadonnées de règle. Mettez en forme « key[=value] » et séparés par espace.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
--scale-rule-name --srn

Nom de la règle de mise à l’échelle.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
--scale-rule-type --srt

Type de la règle d’échelle. Valeur par défaut : http.

Propriété Valeur
Groupe de paramètres: StandardGen2 Arguments
--server-version

(Niveaux standard et de base uniquement) Version du serveur Tomcat. Répertoriez toutes les versions de serveur prises en charge en exécutant az spring list-support-server-versions -o table. Cette fonctionnalité est disponible en préversion publique.

--skip-clone-settings

La création d’un déploiement intermédiaire copie automatiquement les paramètres à partir du déploiement de production.

Propriété Valeur
Valeur par défaut: False
--source-path

Déployez le dossier source spécifié. Le dossier sera emballé en tar, chargé et généré à l’aide de kpack. Valeur par défaut du dossier actif si aucune valeur n’est fournie.

Propriété Valeur
Groupe de paramètres: Source Code deploy Arguments
--startup-probe-config
Préversion

Un chemin d’accès au fichier json indique la configuration de la sonde de démarrage.

Propriété Valeur
Groupe de paramètres: App Customization Arguments
--target-module

Module enfant à déployer, requis pour plusieurs packages jar générés à partir du code source.

Propriété Valeur
Groupe de paramètres: Source Code deploy Arguments
--version

La version du déploiement reste inchangée si elle n’est pas définie.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment delete

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Supprimer un déploiement de l’application.

az spring app deployment delete --app
                                --name
                                --resource-group
                                --service
                                [--no-wait]

Paramètres obligatoires

--app

Nom de l’application.

--name -n

Nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment generate-heap-dump

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Générez un vidage de tas de votre instance d’application cible pour donner le chemin d’accès au fichier.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

Paramètres obligatoires

--app

Nom de l’application.

--app-instance

Instance d’application cible que vous souhaitez vider.

--file-path

Chemin d’accès du fichier de montage pour votre fichier de vidage.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--deployment -d

Nom d’un déploiement existant de l’application. Valeur par défaut du déploiement de production s’il n’est pas spécifié.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment generate-thread-dump

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Générez un vidage de thread de votre instance d’application cible pour donner le chemin d’accès au fichier.

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

Paramètres obligatoires

--app

Nom de l’application.

--app-instance

Instance d’application cible que vous souhaitez vider.

--file-path

Chemin d’accès du fichier de montage pour votre fichier de vidage.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--deployment -d

Nom d’un déploiement existant de l’application. Valeur par défaut du déploiement de production s’il n’est pas spécifié.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment list

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Lister tous les déploiements dans une application.

az spring app deployment list --app
                              --resource-group
                              --service

Paramètres obligatoires

--app

Nom de l’application.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment show

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Afficher les détails d’un déploiement.

az spring app deployment show --app
                              --name
                              --resource-group
                              --service

Paramètres obligatoires

--app

Nom de l’application.

--name -n

Nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az spring app deployment start-jfr

Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « spring » est déconseillé et sera supprimé dans une version ultérieure.

Démarrez un JFR sur votre instance d’application cible pour donner le chemin d’accès au fichier.

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

Paramètres obligatoires

--app

Nom de l’application.

--app-instance

Instance d’application cible que vous souhaitez vider.

--file-path

Chemin d’accès du fichier de montage pour votre fichier de vidage.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--service -s

Nom de l’instance Azure Spring Apps, vous pouvez configurer le service par défaut à l’aide de az configure --defaults spring=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--deployment -d

Nom d’un déploiement existant de l’application. Valeur par défaut du déploiement de production s’il n’est pas spécifié.

--duration

Durée de JFR.

Propriété Valeur
Valeur par défaut: 60s
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False