az spring app deployment

  • Odwołanie

Uwaga

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 .

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 polecenia az spring app deploy/update --deployment <staging deployment>.

 Numer wewnętrzny Ogólna dostępność
az spring app deployment delete

Usuń wdrożenie aplikacji.

 Numer wewnętrzny Ogólna dostępność
az spring app deployment generate-heap-dump

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

 Numer wewnętrzny Ogólna dostępność
az spring app deployment generate-thread-dump

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

 Numer wewnętrzny Ogólna dostępność
az spring app deployment list

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

 Numer wewnętrzny Ogólna dostępność
az spring app deployment show

Pokaż szczegóły wdrożenia.

 Numer wewnętrzny Ogólna dostępność
az spring app deployment start-jfr

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

 Numer wewnętrzny Ogólna dostępność

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 polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

wartość domyślna: 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.

wartość domyślna: 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.

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

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

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

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

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

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

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

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

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

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

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

wartość domyślna: 10
--memory

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

--min-replicas

Minimalna liczba replik.

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

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

wartość domyślna: 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.

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

Parametry uwierzytelniania reguły skalowania. Formatuj znak "=" i rozdzielaj 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 polecenie 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.

wartość domyślna: 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

Parametry opcjonalne

--no-wait

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

wartość domyślna: 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia az configure --defaults spring=.

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.

wartość domyślna: 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.

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

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

--subscription

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

--verbose

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