Freigeben über

az spring app deployment

  • Referenz

Hinweis

Diese Referenz ist Teil der Federerweiterung für die Azure CLI (Version 2.56.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az Spring App-Bereitstellungsbefehl zum ersten Mal ausführen. Weitere Informationen zu 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 .

Befehle

Name Beschreibung Typ Status
az spring app deployment create

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

 Erweiterung Allgemein verfügbar
az spring app deployment delete

Löscht eine Bereitstellung der App

 Erweiterung Allgemein verfügbar
az spring app deployment generate-heap-dump

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

 Erweiterung Allgemein verfügbar
az spring app deployment generate-thread-dump

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

 Erweiterung Allgemein verfügbar
az spring app deployment list

Listet alle Bereitstellungen in einer App auf

 Erweiterung Allgemein verfügbar
az spring app deployment show

Zeigt Details einer Bereitstellung an

 Erweiterung Allgemein verfügbar
az spring app deployment start-jfr

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

 Erweiterung Allgemein verfügbar

az spring app deployment create

Erstellt eine Stagingbereitstellung für die App Verwenden Sie die Verwendung 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=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

Durch Leerzeichen getrennte Umgebungsvariablen im Format „Schlüssel[=Wert]“

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

Durch Leerzeichen getrennte Umgebungsvariablen im Format „Schlüssel[=Wert]“

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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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. Format "=" 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. Auflisten aller unterstützten Serverversionen durch Ausführen az spring list-support-server-versions -o table. Dieses Feature befindet sich in der Phase 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az spring app deployment delete

Löscht 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=konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Optionale Parameter

--deployment -d

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Optionale Parameter

--deployment -d

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az spring app deployment show

Zeigt Details einer Bereitstellung an

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.