Partager via

az spring app deployment

  • Référence

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 commande de déploiement d’application az spring. En savoir plus sur les extensions.

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 .

Commandes

Nom Description Type Statut
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 GA
az spring app deployment delete

Supprimer un déploiement de l’application.

 Extension GA
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 GA
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 GA
az spring app deployment list

Lister tous les déploiements dans une application.

 Extension GA
az spring app deployment show

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

 Extension GA
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 GA

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

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]
                                [--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]
                                [--scale-rule-http-concurrency]
                                [--scale-rule-metadata]
                                [--scale-rule-name]
                                [--scale-rule-type]
                                [--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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres facultatifs

--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 des espaces au format « clé[= valeur] ».

--builder

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

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.

--container-command

Commande de l’image conteneur.

--container-image

Balise d’image conteneur.

--container-registry

Registre de l’image conteneur.

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.

valeur par défaut: False
--disable-probe

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

valeurs acceptées: false, true
--disable-validation

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

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.

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.

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.

valeurs acceptées: false, true
--env

Variables d’environnement séparées par des espaces au format « clé[= valeur] ».

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

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

--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 », « ».

--liveness-probe-config
Préversion

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

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

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.

valeur par défaut: 1
--no-wait

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

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.

--registry-password

Mot de passe du registre de conteneurs.

--registry-username

Nom d’utilisateur du registre de conteneurs.

--runtime-version

Version runtime du langage utilisé.

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 « = » et séparé par espace.

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

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

--scale-rule-name --srn

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

--scale-rule-type --srt

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

--server-version

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

--skip-clone-settings

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

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.

--startup-probe-config
Préversion

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

--target-module

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

--version

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az spring app deployment delete

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres facultatifs

--no-wait

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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.

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres facultatifs

--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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.

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres facultatifs

--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az spring app deployment list

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az spring app deployment show

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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.

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 en utilisant az configure --defaults group=<name>.

--service -s

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

Paramètres facultatifs

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

valeur par défaut: 60s
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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