Udostępnij za pośrednictwem

az spring app deployment

  • Odwołanie

Nuta

Ta dokumentacja jest częścią rozszerzenia spring dla interfejsu wiersza polecenia platformy Azure (wersja 2.56.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az spring app deployment. Dowiedz się więcej o rozszerzeniach.

Polecenia do zarządzania cyklem życia wdrożeń aplikacji w usłudze Azure Spring Apps. Więcej operacji na wdrożeniach można wykonać na poziomie aplikacji z parametrem --deployment. np. az spring app deploy --deployment <staging deployment>.

Polecenia

Nazwa Opis Typ Stan
az spring app deployment create

Utwórz wdrożenie przejściowe dla aplikacji. Aby wdrożyć kod lub ustawienie aktualizacji do istniejącego wdrożenia, użyj az spring app deploy/update --deployment <staging deployment>.

 Rozszerzenie GA
az spring app deployment delete

Usuń wdrożenie aplikacji.

 Rozszerzenie GA
az spring app deployment generate-heap-dump

Wygeneruj zrzut stertowy wystąpienia aplikacji docelowej na daną ścieżkę pliku.

 Rozszerzenie GA
az spring app deployment generate-thread-dump

Wygeneruj zrzut wątku wystąpienia aplikacji docelowej na daną ścieżkę pliku.

 Rozszerzenie GA
az spring app deployment list

Wyświetl listę wszystkich wdrożeń w aplikacji.

 Rozszerzenie GA
az spring app deployment show

Pokaż szczegóły wdrożenia.

 Rozszerzenie GA
az spring app deployment start-jfr

Uruchom JFR w wystąpieniu aplikacji docelowej do podanej ścieżki pliku.

 Rozszerzenie GA

az spring app deployment create

Utwórz wdrożenie przejściowe dla aplikacji. Aby wdrożyć kod lub ustawienie aktualizacji do istniejącego wdrożenia, użyj 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]

Przykłady

Wdróż kod źródłowy w nowym wdrożeniu aplikacji. Spowoduje to spakowanie bieżącego katalogu, skompilowanie pliku binarnego za pomocą usługi kompilacji przestawnej, a następnie wdrożenie.

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

Wdróż wstępnie utworzony plik jar w aplikacji przy użyciu opcji jvm i zmiennych środowiskowych.

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

Wdrażanie obrazu kontenera w usłudze Docker Hub w aplikacji.

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

Wdrażanie obrazu kontenera w rejestrze prywatnym w aplikacji.

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>

Parametry wymagane

--app

Nazwa aplikacji.

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry opcjonalne

--apms

(Tylko warstwa przedsiębiorstwa) Nazwy APM rozdzielone spacjami.

--artifact-path

Wdróż określony wstępnie skompilowany artefakt (plik jar, war lub netcore zip, war jest w publicznej wersji zapoznawczej).

--build-certificates

(Tylko warstwa przedsiębiorstwa) Nazwy certyfikatów rozdzielonych spacjami, certyfikaty są używane w czasie kompilacji.

--build-env

Zmienne środowiskowe rozdzielone spacjami w formacie "key[=value]".

--builder

(Tylko warstwa przedsiębiorstwa) Kompilowanie konstruktora usługi używanego do kompilowania pliku wykonywalnego.

Domyślna wartość: default
--config-file-patterns

(Tylko warstwa przedsiębiorstwa) Wzorce plików konfiguracji rozdzielone znakami "", aby zdecydować, które wzorce usługi konfiguracji aplikacji będą używane. Użyj polecenia """, aby wyczyścić istniejące konfiguracje.

--container-args

Argumenty obrazu kontenera.

--container-command

Polecenie obrazu kontenera.

--container-image

Tag obrazu kontenera.

--container-registry

Rejestr obrazu kontenera.

Domyślna wartość: docker.io
--cpu

Ilość zasobów procesora CPU. Powinna być 250m, 500m, 750m, 1250m lub liczbą rdzeni procesora CPU.

--custom-actuator-path

(Tylko warstwa przedsiębiorstwa) Niestandardowa ścieżka siłownika dla aplikacji. Wartość domyślna to "/siłownik".

--custom-actuator-port

(Tylko warstwa przedsiębiorstwa) Niestandardowy port siłownika dla aplikacji. Wartość domyślna to 8080.

--disable-app-log

Nie drukuj dzienników aplikacji podczas wdrażania aplikacji.

Domyślna wartość: False
--disable-probe

Jeśli wartość true, wyłącz sondę gotowości i aktualności.

Dopuszczalne wartości: false, true
--disable-validation

Jeśli wartość true, wyłącz walidację pliku jar.

Dopuszczalne wartości: false, true
--enable-liveness-probe
Wersja zapoznawcza

Jeśli wartość false, wyłączy sondę aktualności wystąpienia aplikacji.

Dopuszczalne wartości: false, true
--enable-readiness-probe
Wersja zapoznawcza

Jeśli wartość false, wyłączy sondę gotowości wystąpienia aplikacji.

Dopuszczalne wartości: false, true
--enable-startup-probe
Wersja zapoznawcza

Jeśli wartość false, wyłączy sondę uruchamiania wystąpienia aplikacji.

Dopuszczalne wartości: false, true
--env

Zmienne środowiskowe rozdzielone spacjami w formacie "key[=value]".

--grace-period --termination-grace-period-seconds
Wersja zapoznawcza

Opcjonalny czas trwania w sekundach, przez który wystąpienie aplikacji musi zostać bezpiecznie zakończone.

--instance-count

Liczba wystąpień.

--jvm-options

Ciąg zawierający opcje jvm użyj ciągu "=" zamiast " dla tego argumentu, aby uniknąć błędu analizy powłoki bash, np. --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Struktura językowa przekazanego obrazu kontenera. Obsługiwane wartości: "springboot", "".

--liveness-probe-config
Wersja zapoznawcza

Ścieżka pliku JSON wskazuje konfigurację sondy liveness.

--main-entry -m

Ciąg zawierający ścieżkę do pliku wykonywalnego platformy .NET względem katalogu głównego zip.

--max-replicas

Maksymalna liczba replik.

Domyślna wartość: 10
--memory

Ilość zasobów pamięci. Powinna mieć wartość 512Mi, 1536Mi, 2560Mi, 3584Mi lub #Gi, np. 1Gi, 3Gi.

--min-replicas

Minimalna liczba replik.

Domyślna wartość: 1
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
--readiness-probe-config
Wersja zapoznawcza

Ścieżka pliku JSON wskazuje konfigurację sondy gotowości.

--registry-password

Hasło rejestru kontenerów.

--registry-username

Nazwa użytkownika rejestru kontenerów.

--runtime-version

Wersja środowiska uruchomieniowego używanego języka.

Dopuszczalne wartości: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parametry uwierzytelniania reguły skalowania. Sformatuj <triggerParameter>=<secretRef> i oddzielone spacją.

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

Maksymalna liczba współbieżnych żądań przed skalowaniem w poziomie. Obsługiwane tylko dla reguł skalowania http i tcp.

--scale-rule-metadata --srm

Metadane reguły skalowania. Formatuj wartość "key[=value]" i rozdzielaj spacją.

--scale-rule-name --srn

Nazwa reguły skalowania.

--scale-rule-type --srt

Typ reguły skalowania. Ustawienie domyślne: http.

--server-version

(Tylko warstwy Standardowa i Podstawowa) Wersja serwera Tomcat. Wyświetl listę wszystkich obsługiwanych wersji serwera, uruchamiając az spring list-support-server-versions -o table. Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

--skip-clone-settings

Tworzenie wdrożenia przejściowego spowoduje automatyczne skopiowanie ustawień z wdrożenia produkcyjnego.

Domyślna wartość: False
--source-path

Wdróż określony folder źródłowy. Folder zostanie spakowany na tar, przekazany i skompilowany przy użyciu pakietu kpack. Ustawienie domyślne bieżącego folderu, jeśli nie podano żadnej wartości.

--startup-probe-config
Wersja zapoznawcza

Ścieżka pliku JSON wskazuje konfigurację sondy uruchamiania.

--target-module

Moduł podrzędny, który ma zostać wdrożony, wymagany dla wielu pakietów jar utworzonych na podstawie kodu źródłowego.

--version

Wersja wdrożenia, zachowaj niezmienione, jeśli nie zostanie ustawiona.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment delete

Usuń wdrożenie aplikacji.

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

Parametry wymagane

--app

Nazwa aplikacji.

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry opcjonalne

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment generate-heap-dump

Wygeneruj zrzut stertowy wystąpienia aplikacji docelowej na daną ścieżkę pliku.

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

Parametry wymagane

--app

Nazwa aplikacji.

--app-instance

Docelowe wystąpienie aplikacji, które chcesz zrzucić.

--file-path

Ścieżka pliku instalacji dla pliku zrzutu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry opcjonalne

--deployment -d

Nazwa istniejącego wdrożenia aplikacji. Ustawienie domyślne wdrożenia produkcyjnego, jeśli nie zostanie określone.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment generate-thread-dump

Wygeneruj zrzut wątku wystąpienia aplikacji docelowej na daną ścieżkę pliku.

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

Parametry wymagane

--app

Nazwa aplikacji.

--app-instance

Docelowe wystąpienie aplikacji, które chcesz zrzucić.

--file-path

Ścieżka pliku instalacji dla pliku zrzutu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry opcjonalne

--deployment -d

Nazwa istniejącego wdrożenia aplikacji. Ustawienie domyślne wdrożenia produkcyjnego, jeśli nie zostanie określone.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment list

Wyświetl listę wszystkich wdrożeń w aplikacji.

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

Parametry wymagane

--app

Nazwa aplikacji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment show

Pokaż szczegóły wdrożenia.

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

Parametry wymagane

--app

Nazwa aplikacji.

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az spring app deployment start-jfr

Uruchom JFR w wystąpieniu aplikacji docelowej do podanej ścieżki pliku.

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

Parametry wymagane

--app

Nazwa aplikacji.

--app-instance

Docelowe wystąpienie aplikacji, które chcesz zrzucić.

--file-path

Ścieżka pliku instalacji dla pliku zrzutu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--service -s

Nazwa wystąpienia usługi Azure Spring Apps można skonfigurować usługę domyślną przy użyciu az configure --defaults spring=<name>.

Parametry opcjonalne

--deployment -d

Nazwa istniejącego wdrożenia aplikacji. Ustawienie domyślne wdrożenia produkcyjnego, jeśli nie zostanie określone.

--duration

Czas trwania JFR.

Domyślna wartość: 60s
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.