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 |
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
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
Nom de l’application.
Nom du déploiement.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
(Niveau Entreprise uniquement) Noms APM séparés par l’espace.
Déployez l’artefact prédéfini spécifié (jar, war ou netcore zip, war est en préversion publique).
(Niveau Entreprise uniquement) Les noms de certificats séparés par l’espace, les certificats sont utilisés pendant la génération.
Variables d’environnement séparées par espace au format « key[=value] ».
(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 |
(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.
Arguments de l’image conteneur.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
Commande de l’image conteneur.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
Balise d’image conteneur.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
Registre de l’image conteneur.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
| Valeur par défaut: | docker.io |
Quantité de ressources processeur. Doit être de 250m, 500m, 750m, 1250m ou un nombre de cœurs de processeur.
(Niveau Entreprise uniquement) Chemin d’actionneur personnalisé de l’application. Valeur par défaut « /actuator ».
(Niveau Entreprise uniquement) Port d’actionneur personnalisé pour l’application. Valeur par défaut 8080.
N’imprimez pas les journaux d’application lors du déploiement de l’application.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Si la valeur est true, désactivez la sonde liveness et readiness.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | false, true |
Si la valeur est true, désactivez la validation jar.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | false, true |
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 |
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 |
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 |
Variables d’environnement séparées par espace au format « key[=value] ».
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 |
Nombre d’instances.
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'.
Infrastructure de langage de l’image conteneur chargée. Valeurs prises en charge : « springboot », « ».
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
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 |
Chaîne contenant le chemin d’accès à l’exécutable .NET par rapport à la racine zip.
Nombre maximal de réplicas.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | StandardGen2 Arguments |
| Valeur par défaut: | 10 |
Quantité de ressources mémoire. Doit être 512Mi, 1536Mi, 2560Mi, 3584Mi ou #Gi, par exemple, 1Gi, 3Gi.
Nombre minimal de réplicas.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | StandardGen2 Arguments |
| Valeur par défaut: | 1 |
Ne pas attendre la fin de l’opération de longue durée.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
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 |
Mot de passe du registre de conteneurs.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
Nom d’utilisateur du registre de conteneurs.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Custom Container Arguments |
Version runtime du langage utilisé.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | Java_11, Java_17, Java_21, Java_8, NetCore_31 |
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 |
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 |
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 |
Nom de la règle de mise à l’échelle.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | StandardGen2 Arguments |
Type de la règle d’échelle. Valeur par défaut : http.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | StandardGen2 Arguments |
(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.
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 |
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 |
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 |
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 |
La version du déploiement reste inchangée si elle n’est pas définie.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Nom du déploiement.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
Ne pas attendre la fin de l’opération de longue durée.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Instance d’application cible que vous souhaitez vider.
Chemin d’accès du fichier de montage pour votre fichier de vidage.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Instance d’application cible que vous souhaitez vider.
Chemin d’accès du fichier de montage pour votre fichier de vidage.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Nom du déploiement.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Nom de l’application.
Instance d’application cible que vous souhaitez vider.
Chemin d’accès du fichier de montage pour votre fichier de vidage.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
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é.
Durée de JFR.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | 60s |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |