Freigeben über

az spring app deployment

  • Referenz

Anmerkung

Diese Referenz ist Teil der Spring-Erweiterung für die Azure CLI (Version 2.56.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az Spring App-Bereitstellungsbefehl Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Befehle zum Verwalten des Lebenszyklus von Bereitstellungen einer App in Azure Spring Apps. Weitere Vorgänge für Bereitstellungen können auf App-Ebene mit Parameter --deployment ausgeführt werden. z. B. az spring app deploy --deployment <staging deployment>.

Befehle

Name Beschreibung Typ Status
az spring app deployment create

Erstellen Sie eine Stagingbereitstellung für die App. Verwenden Sie az spring app deploy/update --deployment <staging deployment>, um Code oder Aktualisierungseinstellung für eine vorhandene Bereitstellung bereitzustellen.

 Erweiterung GA
az spring app deployment delete

Löschen sie eine Bereitstellung der App.

 Erweiterung GA
az spring app deployment generate-heap-dump

Generieren Sie ein Heapabbild Ihrer Ziel-App-Instanz für den angegebenen Dateipfad.

 Erweiterung GA
az spring app deployment generate-thread-dump

Generieren Sie ein Threadabbild Ihrer Ziel-App-Instanz für den angegebenen Dateipfad.

 Erweiterung GA
az spring app deployment list

Listet alle Bereitstellungen in einer App auf.

 Erweiterung GA
az spring app deployment show

Details einer Bereitstellung anzeigen.

 Erweiterung GA
az spring app deployment start-jfr

Starten Sie ein JFR für Ihre Ziel-App-Instanz, um den angegebenen Dateipfad zu erhalten.

 Erweiterung GA

az spring app deployment create

Erstellen Sie eine Stagingbereitstellung für die App. Verwenden Sie az spring app deploy/update --deployment <staging deployment>, um Code oder Aktualisierungseinstellung für eine vorhandene Bereitstellung bereitzustellen.

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]

Beispiele

Stellen Sie Quellcode für eine neue Bereitstellung einer App bereit. Dies packt das aktuelle Verzeichnis, erstellt eine Binärdatei mit dem Pivotal Build Service und stellt dann bereit.

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

Stellen Sie einen vordefinierten Jar für eine App mit jvm-Optionen und Umgebungsvariablen bereit.

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

Stellen Sie ein Containerimage auf Docker Hub in einer App bereit.

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

Stellen Sie ein Containerimage in einer privaten Registrierung für eine App bereit.

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>

Erforderliche Parameter

--app

Name der App.

--name -n

Name der Bereitstellung.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Optionale Parameter

--apms

(Nur Enterprise-Ebene) Durch Leerzeichen getrennte APM-Namen.

--artifact-path

Stellen Sie das angegebene vordefinierte Artefakt bereit (Jar, Krieg oder Netcore ZIP, Krieg befindet sich in der öffentlichen Vorschau).

--build-certificates

(Nur Enterprise-Ebene) Durch Leerzeichen getrennte Zertifikatnamen werden die Zertifikate während der Buildzeit verwendet.

--build-env

Leerzeichentrennte Umgebungsvariablen im Format "key[=value]".

--builder

(Nur Enterprise-Ebene) Builddienst-Generator, der zum Erstellen der ausführbaren Datei verwendet wird.

Standardwert: default
--config-file-patterns

(Nur Enterprise-Ebene) Konfigurieren Sie Dateimuster, die durch "," getrennt sind, um zu entscheiden, welche Muster des Anwendungskonfigurationsdiensts verwendet werden sollen. Verwenden Sie """, um vorhandene Konfigurationen zu löschen.

--container-args

Die Argumente des Containerimages.

--container-command

Der Befehl des Containerimages.

--container-image

Das Containerimage-Tag.

--container-registry

Die Registrierung des Containerimages.

Standardwert: docker.io
--cpu

CPU-Ressourcenmenge. Sollte 250m, 500m, 750m, 1250m oder anzahl der CPU-Kerne sein.

--custom-actuator-path

(Nur Enterprise-Ebene) Benutzerdefinierter Aktorpfad für die App. Der Standardwert ist "/aktuator".

--custom-actuator-port

(Nur Enterprise-Ebene) Benutzerdefinierter Aktorport für die App. Standardmäßig 8080.

--disable-app-log

Drucken Sie keine Anwendungsprotokolle, wenn Sie eine Anwendung bereitstellen.

Standardwert: False
--disable-probe

Wenn wahr, deaktivieren Sie die Liveness- und Bereitschaftssonde.

Zulässige Werte: false, true
--disable-validation

Wenn wahr, deaktivieren Sie die Jar-Überprüfung.

Zulässige Werte: false, true
--enable-liveness-probe
Vorschau

Wenn "false" lautet, wird die Liveness-Probe der App-Instanz deaktiviert.

Zulässige Werte: false, true
--enable-readiness-probe
Vorschau

Wenn "false" lautet, wird der Bereitschaftstest der App-Instanz deaktiviert.

Zulässige Werte: false, true
--enable-startup-probe
Vorschau

Wenn "false" lautet, wird die Startsonde der App-Instanz deaktiviert.

Zulässige Werte: false, true
--env

Leerzeichentrennte Umgebungsvariablen im Format "key[=value]".

--grace-period --termination-grace-period-seconds
Vorschau

Optionale Dauer in Sekunden, die die App-Instanz ordnungsgemäß beenden muss.

--instance-count

Anzahl der Instanzen.

--jvm-options

Eine Zeichenfolge mit jvm-Optionen, verwenden Sie "=" anstelle von " für dieses Argument, um bash parse error zu vermeiden, z. B.: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Sprachframework des hochgeladenen Containerimages. Unterstützte Werte: "springboot", "".

--liveness-probe-config
Vorschau

Ein JSON-Dateipfad gibt die Konfiguration der Liveness-Probe an.

--main-entry -m

Eine Zeichenfolge, die den Pfad zur ausführbaren .NET-Datei relativ zum ZIP-Stamm enthält.

--max-replicas

Die maximale Anzahl von Replikaten.

Standardwert: 10
--memory

Menge der Speicherressource. Sollte 512Mi, 1536Mi, 2560Mi, 3584Mi oder #Gi sein, z. B. 1Gi, 3Gi.

--min-replicas

Die Mindestanzahl der Replikate.

Standardwert: 1
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
--readiness-probe-config
Vorschau

Ein JSON-Dateipfad gibt die Konfiguration der Bereitschaftssonde an.

--registry-password

Das Kennwort der Containerregistrierung.

--registry-username

Der Benutzername der Containerregistrierung.

--runtime-version

Laufzeitversion der verwendeten Sprache.

Zulässige Werte: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Skalierungsregelauthentifizierungsparameter. Formatieren sie <triggerParameter>=<secretRef> und durch Leerzeichen getrennt.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

Die maximale Anzahl gleichzeitiger Anforderungen vor dem Skalieren. Wird nur für HTTP- und TCP-Skalierungsregeln unterstützt.

--scale-rule-metadata --srm

Skalierungsregelmetadaten. Formatieren Sie "key[=value]" und werden durch Leerzeichen getrennt.

--scale-rule-name --srn

Der Name der Skalierungsregel.

--scale-rule-type --srt

Der Typ der Skalierungsregel. Standard: http.

--server-version

(Nur Standard- und Standardebenen) Tomcat-Serverversion. Listet alle unterstützten Serverversionen auf, indem az spring list-support-server-versions -o tableausgeführt wird. Dieses Feature befindet sich in der öffentlichen Vorschau.

--skip-clone-settings

Beim Erstellen der Stagingbereitstellung werden einstellungen automatisch aus der Produktionsbereitstellung kopiert.

Standardwert: False
--source-path

Stellen Sie den angegebenen Quellordner bereit. Der Ordner wird in Tar verpackt, hochgeladen und mit kpack erstellt. Standardeinstellung für den aktuellen Ordner, wenn kein Wert angegeben wird.

--startup-probe-config
Vorschau

Ein JSON-Dateipfad gibt die Startsondenkonfiguration an.

--target-module

Das zu bereitstellende untergeordnete Modul ist für mehrere jar-Pakete erforderlich, die aus Quellcode erstellt wurden.

--version

Die Bereitstellungsversion bleibt unverändert, wenn sie nicht festgelegt ist.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment delete

Löschen sie eine Bereitstellung der App.

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

Erforderliche Parameter

--app

Name der App.

--name -n

Name der Bereitstellung.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Optionale Parameter

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment generate-heap-dump

Generieren Sie ein Heapabbild Ihrer Ziel-App-Instanz für den angegebenen Dateipfad.

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

Erforderliche Parameter

--app

Name der App.

--app-instance

Ziel-App-Instanz, die Sie abbilden möchten.

--file-path

Der Bereitstellungsdateipfad für die Speicherabbilddatei.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Optionale Parameter

--deployment -d

Name einer vorhandenen Bereitstellung der App. Standardeinstellung für die Produktionsbereitstellung, falls nicht angegeben.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment generate-thread-dump

Generieren Sie ein Threadabbild Ihrer Ziel-App-Instanz für den angegebenen Dateipfad.

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

Erforderliche Parameter

--app

Name der App.

--app-instance

Ziel-App-Instanz, die Sie abbilden möchten.

--file-path

Der Bereitstellungsdateipfad für die Speicherabbilddatei.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Optionale Parameter

--deployment -d

Name einer vorhandenen Bereitstellung der App. Standardeinstellung für die Produktionsbereitstellung, falls nicht angegeben.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment list

Listet alle Bereitstellungen in einer App auf.

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

Erforderliche Parameter

--app

Name der App.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment show

Details einer Bereitstellung anzeigen.

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

Erforderliche Parameter

--app

Name der App.

--name -n

Name der Bereitstellung.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az spring app deployment start-jfr

Starten Sie ein JFR für Ihre Ziel-App-Instanz, um den angegebenen Dateipfad zu erhalten.

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

Erforderliche Parameter

--app

Name der App.

--app-instance

Ziel-App-Instanz, die Sie abbilden möchten.

--file-path

Der Bereitstellungsdateipfad für die Speicherabbilddatei.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--service -s

Der Name der Azure Spring Apps-Instanz, sie können den Standarddienst mithilfe von az configure --defaults spring=<name>konfigurieren.

Optionale Parameter

--deployment -d

Name einer vorhandenen Bereitstellung der App. Standardeinstellung für die Produktionsbereitstellung, falls nicht angegeben.

--duration

Dauer von JFR.

Standardwert: 60s
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.