Поделиться через

az spring app deployment

  • Ссылка

Заметка

Эта ссылка является частью расширения spring для Azure CLI (версия 2.56.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az spring app deployment. Узнайте больше о расширениях.

Команды для управления жизненным циклом развертываний приложения в Azure Spring Apps. Дополнительные операции с развертываниями можно выполнять на уровне приложения с параметром --deployment. например, az spring app deploy --deployment <staging deployment>.

Команды

Имя Описание Тип Состояние
az spring app deployment create

Создайте промежуточное развертывание для приложения. Чтобы развернуть код или параметр обновления в существующем развертывании, используйте az spring app deploy/update --deployment <staging deployment>.

 Расширение ГА
az spring app deployment delete

Удаление развертывания приложения.

 Расширение ГА
az spring app deployment generate-heap-dump

Создайте дамп кучи целевого экземпляра приложения для заданного пути к файлу.

 Расширение ГА
az spring app deployment generate-thread-dump

Создайте дамп потока целевого экземпляра приложения для заданного пути к файлу.

 Расширение ГА
az spring app deployment list

Вывод списка всех развертываний в приложении.

 Расширение ГА
az spring app deployment show

Отображение сведений о развертывании.

 Расширение ГА
az spring app deployment start-jfr

Запустите JFR в целевом экземпляре приложения, чтобы получить путь к файлу.

 Расширение ГА

az spring app deployment create

Создайте промежуточное развертывание для приложения. Чтобы развернуть код или параметр обновления в существующем развертывании, используйте 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]

Примеры

Разверните исходный код в новом развертывании приложения. Это приведет к пакету текущего каталога, сборке двоичного файла с помощью службы сводной сборки и последующего развертывания.

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

Разверните предварительно созданный jar-файл в приложении с параметрами jvm и переменными среды.

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

Разверните образ контейнера в Docker Hub в приложении.

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

Разверните образ контейнера в частном реестре в приложении.

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>

Обязательные параметры

--app

Имя приложения.

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Необязательные параметры

--apms

(Только корпоративный уровень) Имена APM, разделенные пробелами.

--artifact-path

Разверните указанный предварительно созданный артефакт (jar, war или netcore zip, война находится в общедоступной предварительной версии).

--build-certificates

(Только корпоративный уровень) Имена сертификатов, разделенных пробелами, используются во время сборки.

--build-env

Переменные среды, разделенные пробелами, в формате "key[=value]".

--builder

(Только корпоративный уровень) Создание построителя служб, используемого для сборки исполняемого файла.

Default value: default
--config-file-patterns

(Только корпоративный уровень) Шаблоны файлов конфигурации, разделенные "", чтобы решить, какие шаблоны службы конфигурации приложений будут использоваться. Используйте """ для очистки существующих конфигураций.

--container-args

Аргументы образа контейнера.

--container-command

Команда образа контейнера.

--container-image

Тег образа контейнера.

--container-registry

Реестр образа контейнера.

Default value: docker.io
--cpu

Количество ресурсов ЦП. Должно быть 250 м, 500 м, 750 м, 1250 млн или число ядер ЦП.

--custom-actuator-path

(Только корпоративный уровень) Путь пользовательского актатора для приложения. Значение по умолчанию — "/actuator".

--custom-actuator-port

(Только корпоративный уровень) Пользовательский порт актатора для приложения. По умолчанию — 8080.

--disable-app-log

Не печатайте журналы приложений при развертывании приложения.

Default value: False
--disable-probe

Если значение true, отключите пробу активности и готовности.

Допустимые значения: false, true
--disable-validation

Если значение true, отключите проверку jar.

Допустимые значения: false, true
--enable-liveness-probe
Предварительный просмотр

Если значение false, отключит проверку активности экземпляра приложения.

Допустимые значения: false, true
--enable-readiness-probe
Предварительный просмотр

Если значение false, отключит проверку готовности экземпляра приложения.

Допустимые значения: false, true
--enable-startup-probe
Предварительный просмотр

Если значение false, отключит пробу запуска экземпляра приложения.

Допустимые значения: false, true
--env

Переменные среды, разделенные пробелами, в формате "key[=value]".

--grace-period --termination-grace-period-seconds
Предварительный просмотр

Необязательное время в секундах экземпляр приложения должен завершиться корректно.

--instance-count

Количество экземпляров.

--jvm-options

Строка, содержащая параметры jvm, используйте "=" вместо " для этого аргумента, чтобы избежать ошибки синтаксического анализа Bash, например: --jvm-options='-Xms1024m -Xmx2048m".

--language-framework

Языковая платформа отправленного образа контейнера. Поддерживаемые значения: Springboot, "".

--liveness-probe-config
Предварительный просмотр

Путь к файлу json указывает конфигурацию пробы активности.

--main-entry -m

Строка, содержащая путь к исполняемому файлу .NET относительно zip-файла.

--max-replicas

Максимальное количество реплик.

Default value: 10
--memory

Количество ресурсов памяти. Должно быть 512Mi, 1536Mi, 2560Mi, 3584Mi или #Gi, например 1Gi, 3Gi.

--min-replicas

Минимальное количество реплик.

Default value: 1
--no-wait

Не дождитесь завершения длительной операции.

Default value: False
--readiness-probe-config
Предварительный просмотр

Путь к файлу json указывает конфигурацию пробы готовности.

--registry-password

Пароль реестра контейнеров.

--registry-username

Имя пользователя реестра контейнеров.

--runtime-version

Версия используемого языка среды выполнения.

Допустимые значения: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Параметры проверки подлинности правила масштабирования. Формат <triggerParameter>=<secretRef> и разделенный пробелом.

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

Максимальное количество одновременных запросов перед масштабированием. Поддерживается только для правил масштабирования http и tcp.

--scale-rule-metadata --srm

Метаданные правила масштабирования. Формат "key[=value]" и разделенный пробелом.

--scale-rule-name --srn

Имя правила масштабирования.

--scale-rule-type --srt

Тип правила масштабирования. Значение по умолчанию: http.

--server-version

(Только категории "Стандартный" и "Базовый") Версия сервера Tomcat. Перечислить все поддерживаемые версии сервера, выполнив az spring list-support-server-versions -o table. Эта функция доступна в общедоступной предварительной версии.

--skip-clone-settings

Создание промежуточного развертывания автоматически копирует параметры из рабочего развертывания.

Default value: False
--source-path

Разверните указанную исходную папку. Папка будет упакована в tar, отправлена и создана с помощью kpack. По умолчанию используется текущая папка, если не указано значение.

--startup-probe-config
Предварительный просмотр

Путь к файлу json указывает конфигурацию пробы запуска.

--target-module

Дочерний модуль для развертывания, необходимый для нескольких jar-пакетов, созданных из исходного кода.

--version

Версия развертывания сохраняется без изменений, если она не задана.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment delete

Удаление развертывания приложения.

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

Обязательные параметры

--app

Имя приложения.

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Необязательные параметры

--no-wait

Не дождитесь завершения длительной операции.

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment generate-heap-dump

Создайте дамп кучи целевого экземпляра приложения для заданного пути к файлу.

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

Обязательные параметры

--app

Имя приложения.

--app-instance

Целевой экземпляр приложения, который требуется дампа.

--file-path

Путь к файлу подключения для файла дампа.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Необязательные параметры

--deployment -d

Имя существующего развертывания приложения. По умолчанию для рабочего развертывания, если он не указан.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment generate-thread-dump

Создайте дамп потока целевого экземпляра приложения для заданного пути к файлу.

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

Обязательные параметры

--app

Имя приложения.

--app-instance

Целевой экземпляр приложения, который требуется дампа.

--file-path

Путь к файлу подключения для файла дампа.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Необязательные параметры

--deployment -d

Имя существующего развертывания приложения. По умолчанию для рабочего развертывания, если он не указан.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment list

Вывод списка всех развертываний в приложении.

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

Обязательные параметры

--app

Имя приложения.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment show

Отображение сведений о развертывании.

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

Обязательные параметры

--app

Имя приложения.

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az spring app deployment start-jfr

Запустите JFR в целевом экземпляре приложения, чтобы получить путь к файлу.

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

Обязательные параметры

--app

Имя приложения.

--app-instance

Целевой экземпляр приложения, который требуется дампа.

--file-path

Путь к файлу подключения для файла дампа.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--service -s

Имя экземпляра Azure Spring Apps можно настроить службу по умолчанию с помощью az configure --defaults spring=<name>.

Необязательные параметры

--deployment -d

Имя существующего развертывания приложения. По умолчанию для рабочего развертывания, если он не указан.

--duration

Длительность JFR.

Default value: 60s
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.