Использование ускорителя приложений VMware Tanzu с планом Azure Spring Apps Enterprise

Примечание.

Azure Spring Apps — это новое название службы Azure Spring Cloud. Старое название будет еще некоторое время встречаться в наших материалах, пока мы не обновим ресурсы, такие как снимки экрана, видео и схемы.

Эта статья относится к:❌ Basic/Standard ✔️ Enterprise

В этой статье показано, как использовать акселератор приложений для VMware Tanzu (Акселератор приложений) с планом Azure Spring Apps Enterprise для начальной загрузки приложений с возможностью обнаружения и повторения.

Акселератор приложений помогает загрузить разработку приложений и развернуть их в обнаруживаемом и повторяемом способе. С помощью Акселератора приложений можно создавать проекты на основе опубликованных проектов акселератора. Дополнительные сведения см. в статье "Акселератор приложений для VMware Tanzu " в документации по VMware.

Необходимые компоненты

• Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.

• Изучите и выполните требования, перечисленные в разделе "Требования" плана Enterprise в Azure Marketplace.

• Azure CLI с расширением Azure Spring Apps. Используйте следующую команду, чтобы удалить предыдущие версии и установить последнее расширение. Если вы ранее установили spring-cloud расширение, удалите его, чтобы избежать несоответствий конфигурации и версий.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Чтобы использовать акселератор приложений в VS Code, вам также потребуется выполнить следующие предварительные требования:

  • Visual Studio Code
  • Расширение Azure Spring Apps для Visual Studio Code

Включение акселератора приложений

Акселератор приложений можно включить при подготовке экземпляра плана Azure Spring Apps Enterprise. Если у вас уже есть ресурс плана Azure Spring Apps Enterprise, см . раздел "Управление акселератором приложений" в существующем разделе экземпляра плана enterprise, чтобы включить его.

Акселератор приложений можно включить с помощью портал Azure или Azure CLI.

Портал Azure

Выполните следующие действия, чтобы включить акселератор приложений с помощью портал Azure:

1. Откройте портал Azure.

2. На вкладке "Основные сведения" выберите уровень Enterprise в разделе "Цены " и укажите необходимые сведения. Затем нажмите кнопку Далее: параметры VMware Tanzu.

3. На вкладке параметров VMware Tanzu выберите "Включить акселератор приложений".

   

4. Укажите другие параметры и нажмите кнопку "Проверить" и "Создать".

5. На вкладке "Проверка создания" убедитесь, что для включения акселератора приложений и включения портала средств разработки задано значение "Да". Выберите "Создать", чтобы создать экземпляр плана Enterprise.

Azure CLI

Выполните следующие действия, чтобы подготовить экземпляр службы Azure Spring Apps с включенным акселератором приложений с помощью Azure CLI.

1. Войдите в Azure CLI и выберите активную подписку, выполнив следующую команду:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. Используйте следующую команду, чтобы принять юридические условия и заявления о конфиденциальности для плана Azure Spring Apps Enterprise. Этот шаг необходим, только если подписка никогда не использовалась для создания экземпляра плана Enterprise.

   az provider register --namespace Microsoft.SaaS
   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

3. Выберите расположение. Расположение должно поддерживать план Azure Spring Apps Enterprise. Дополнительные сведения см. в статье Часто задаваемые вопросы о Приложениях Azure Spring.

4. Выполните следующую команду, чтобы создать группу ресурсов.

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   Дополнительные сведения о группах ресурсов см. в статье "Что такое Azure Resource Manager?"

5. Подготовьте имя для экземпляра службы Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.

6. Используйте следующую команду, чтобы создать экземпляр службы Azure Spring Apps с включенным акселератором приложений:

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise \
       --enable-application-accelerator
   

Мониторинг акселератора приложений

Акселератор приложений позволяет создавать новые проекты из файлов в репозиториях Git. В следующей таблице описаны компоненты акселератора приложений:

Наименование компонента	Число экземпляров	Количество виртуальных ЦП на экземпляр	Объем памяти на экземпляр	Description
accelerator-server	2	0.4 core	0.5Gi	Служит API, используемый порталом средств разработки для перечисления доступных акселераторов и параметров.
accelerator-engine	1	1 ядро	3Gi	Обрабатывает входные значения и файлы (извлекаемые из моментального снимка репозитория Git) и применяет динамические преобразования для создания проектов.
accelerator-controller	1	0.2 core	0.25Gi	Согласовывает ресурсы акселератора приложений.
source-controller	1	0.2 core	0.25Gi	Регистрирует контроллер для согласования ImageRepositories ресурсов, MavenArtifacts используемых акселератором приложений.
flux-source-controller	1	0.2 core	0.25Gi	Регистрирует контроллер для согласования GithubRepository ресурсов, используемых акселератором приложений. Поддерживает управление источниками репозитория Git для Акселератора приложений.

Вы можете увидеть запущенные экземпляры и использование ресурсов всех компонентов с помощью портал Azure и Azure CLI.

Портал Azure

Состояние акселератора приложений можно просмотреть на странице инструментов разработчика портал Azure, как показано на следующем снимке экрана:

Azure CLI

Используйте следующую команду в Azure CLI для просмотра акселератора приложений.

az spring application-accelerator show \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Настройка средств разработки для доступа к акселератору приложений

Чтобы получить доступ к акселератору приложений, необходимо настроить средства разработки Tanzu. Дополнительные сведения см. в статье "Настройка средств разработки Tanzu" в плане Azure Spring Apps Enterprise.

Использование акселератора приложений для загрузки новых проектов

Чтобы использовать акселератор приложений для загрузки новых проектов, необходимо получить разрешения на управление акселераторами. Затем можно управлять предопределенными акселераторами или собственными акселераторами.

Получение разрешений на управление акселераторами

Для управления акселераторами требуются следующие разрешения:

• Чтение. Получение предопределенного акселератора Azure Spring Apps
• Другое. Отключение предопределенного акселератора Azure Spring Apps
• Другое. Включение предопределенного акселератора Azure Spring Apps
• Запись: создание или обновление настраиваемого акселератора Microsoft Azure Spring Apps
• Чтение. Получение настраиваемого акселератора Azure Spring Apps

Дополнительные сведения см. в статье "Использование разрешений в Azure Spring Apps".

Управление предопределенными акселераторами

Вы можете начать с нескольких предопределенных акселераторов для загрузки новых проектов. Вы можете отключить или включить встроенные акселераторы в соответствии с собственными предпочтениями.

Вы можете управлять предопределенными акселераторами с помощью портал Azure или Azure CLI.

Портал Azure

Встроенные акселераторы можно просмотреть на вкладке портал Azure "Акселераторы", как показано на следующем снимке экрана:

Azure CLI

Используйте следующую команду в Azure CLI для просмотра списка встроенных акселераторов:

az spring application-accelerator predefined-accelerator list \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Используйте следующую команду, чтобы отключить встроенный предопределенный акселератор:

az spring application-accelerator predefined-accelerator disable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Используйте следующую команду, чтобы включить встроенный предопределенный акселератор:

az spring application-accelerator predefined-accelerator enable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Управление собственными акселераторами

Помимо использования предопределенных акселераторов, можно создавать собственные акселераторы. Вы можете использовать любой репозиторий Git в Azure Devops, GitHub, GitLab или BitBucket.

Чтобы создать и сохранить собственные акселераторы, выполните следующие действия.

Сначала создайте файл с именем accelerator.yaml в корневом каталоге репозитория Git.

Файл accelerator.yaml можно использовать для объявления входных параметров, которые пользователи заполняют с помощью формы в пользовательском интерфейсе. Эти значения параметров управляют обработкой обработчиком шаблонов перед возвратом zippped выходных файлов. Если вы не включаете файл accelerator.yaml , репозиторий по-прежнему работает в качестве акселератора, но файлы передаются пользователям без изменений. Дополнительные сведения см. в разделе "Создание файла accelerator.yaml".

Затем опубликуйте новый акселератор.

После создания файла accelerator.yaml можно создать акселератор. Затем его можно просмотреть на странице портал Azure или акселератора приложений на портале средств разработки. Вы можете опубликовать новый акселератор с помощью портал Azure или Azure CLI.

Портал Azure

Чтобы создать собственный акселератор, откройте раздел "Ускорители" и выберите "Добавить акселератор" в разделе "Настраиваемые акселераторы".

Azure CLI

Используйте следующую команду, чтобы создать собственный акселератор в Azure CLI:

az spring application-accelerator customized-accelerator create \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

В следующей таблице описаны настраиваемые поля акселератора.

Портал	CLI	Description	Обязательно/Необязательно
Имя	name	Уникальное имя акселератора. Имя не может измениться после его создания.	Обязательное поле
Description	display-name	Более длинное описание акселератора.	Необязательно
URL-адрес значка	icon-url	URL-адрес изображения для представления акселератора в пользовательском интерфейсе.	Необязательно
Теги	accelerator-tags	Массив строк, определяющих атрибуты акселератора, который можно использовать в поиске в пользовательском интерфейсе.	Необязательно
URL-адрес Git	git-url	URL-адрес репозитория источника акселератора Git. URL-адрес может быть АДРЕСом HTTP/S или SSH. Синтаксис scp-like не поддерживается для адресов SSH (например, user@example.com:repository.git). Вместо этого допустимый формат URL-адреса.ssh://user@example.com:22/repository.git	Обязательное поле
Интервал Git	git-interval-in-seconds	Интервал, с которым проверка обновлений репозитория. Если это не указано, интервал по умолчанию по умолчанию — 10 минут. Существует также интервал обновления (в настоящее время 10 секунд), прежде чем акселераторы могут отображаться в пользовательском интерфейсе. Может быть задержка в 10 секунд, прежде чем изменения отражаются в пользовательском интерфейсе.	Необязательно
Ветвь Git	git-branch	Ветвь Git для проверка и отслеживания изменений. Следует указать только ветвь Git, фиксацию Git или тег Git.	Необязательно
Фиксация Git	git-commit	Git фиксирует SHA для проверка. Следует указать только ветвь Git, фиксацию Git или тег Git.	Необязательно
Тег Git	git-tag	Тег фиксации Git для проверка. Следует указать только ветвь Git, фиксацию Git или тег Git.	Необязательно
Вложенный путь Git	git-sub-path	Путь к папке в репозитории Git, который следует рассматривать как корень акселератора или фрагмента.	Необязательно
Тип проверки подлинности	N/A	Тип проверки подлинности исходного репозитория акселератора. Тип может иметь значение Public, Basic auth или SSH.	Обязательное поле
Имя пользователя	username	Имя пользователя для доступа к исходному репозиторию акселератора, тип проверки подлинности которого имеет тип Basic authпроверки подлинности.	Требуется при использовании типа Basic authпроверки подлинности.
Маркер доступа password/Personal	password	Пароль для доступа к исходному репозиторию акселератора, тип проверки подлинности которого равен Basic auth.	Требуется при использовании типа Basic authпроверки подлинности.
Закрытый ключ	private-key	Закрытый ключ для доступа к исходному репозиторию акселератора, тип проверки подлинности которого — SSH. Поддерживается только закрытый ключ OpenSSH.	Требуется SSHпри использовании типа проверки подлинности.
Ключ узла	host-key	Ключ узла для доступа к исходному репозиторию акселератора, тип проверки подлинности которого равен SSH.	Требуется при использовании типа SSHпроверки подлинности.
Алгоритм ключа узла	host-key-algorithm	Алгоритм ключа узла для доступа к исходному репозиторию акселератора, тип проверки подлинности которого равен SSH. Может иметь значение ecdsa-sha2-nistp256 или ssh-rsa.	Требуется SSHпри использовании типа проверки подлинности.
Имя сертификата ЦС	ca-cert-name	Имя сертификата ЦС для доступа к исходному репозиторию акселератора с самозаверяющий сертификатом, типом проверки подлинности которого является Public или Basic auth.	Требуется, когда самозаверяющий сертификат используется для URL-адреса репозитория Git.
Тип	type	Тип настраиваемого акселератора. Тип может быть Accelerator или Fragment. Значение по умолчанию — Accelerator.	Необязательно

Чтобы просмотреть все опубликованные акселераторы, см. раздел "Акселераторы приложений" на странице "Средства разработчика". Выберите URL-адрес акселератора приложений, чтобы просмотреть опубликованные акселераторы на портале средств разработки:

Чтобы просмотреть недавно опубликованный акселератор, обновите портал средств разработки.

Примечание.

Для обновления каталога и добавления записи для нового акселератора может потребоваться несколько секунд. Интервал обновления настраивается как git-interval при создании акселератора. После изменения акселератора также требуется время, чтобы отразиться на портале средств разработки. Рекомендуется изменить git-interval скорость проверки после применения изменений в репозитории Git.

Ссылка на фрагмент в собственных акселераторах

Написание и обслуживание акселераторов может стать повторяющимся и подробным по мере добавления новых акселераторов. Некоторые люди создают новые проекты путем копирования существующих и внесения изменений, но этот процесс может быть мучен и подвержен ошибкам. Чтобы упростить создание и обслуживание акселераторов, Application Accelerator поддерживает функцию с именем Composition, которая позволяет повторно использовать части акселератора, называемые фрагментами.

Чтобы ссылаться на фрагмент в акселераторе, выполните следующие действия.

1. Опубликуйте новый акселератор типа Fragment с помощью портал Azure или Azure CLI.

   Портал Azure

   Чтобы создать акселератор фрагментов, откройте раздел "Ускорители", выберите "Добавить акселератор" в разделе "Настраиваемые акселераторы" и выберите "Фрагмент".

   

   Azure CLI

   Используйте следующую команду, чтобы создать настраиваемый акселератор типа Fragment:

   az spring application-accelerator customized-accelerator create \
       --resource-group <resource-group-name> \
       --service <service-instance-name> \
       --name <fragment-accelerator-name> \
       --display-name <display-name> \
       --type Fragment \
       [--git-sub-path <sub project path>] \
       --git-url <git-repo-URL>
   

2. Измените файл accelerator.yaml в проекте акселератора. imports Используйте инструкцию в accelerator разделе и InvokeFragment инструкцию engine в разделе, чтобы ссылаться на фрагмент в акселераторе, как показано в следующем примере:

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. Синхронизация изменений с помощью портала средств разработки.

   Чтобы отразить изменения на портале средств разработки, можно указать значение для поля интервала Git настраиваемого акселератора. Значение интервала Git указывает, как часто системные проверка для обновлений в репозитории Git.

4. Синхронизация изменений с настроенным акселератором на портал Azure с помощью портал Azure или Azure CLI.

   Портал Azure

   В следующем списке показаны два способа синхронизации изменений:

   • Создайте или обновите настраиваемый акселератор.
   • Откройте раздел "Акселераторы" и выберите "Синхронизировать сертификат".

   Azure CLI

   Используйте следующую команду, чтобы синхронизировать изменения для акселератора:

   az spring application-accelerator customized-accelerator sync-cert \
       --name <customized-accelerator-name> \
       --service <service-instance-name> \
       --resource-group <resource-group-name>
   

Дополнительные сведения см. в разделе "Использование фрагментов в акселераторе приложений" в документации по VMware.

Использование акселераторов для загрузки нового проекта

Чтобы запустить новый проект с помощью акселераторов, выполните следующие действия.

1. На странице "Средства разработчика" выберите URL-адрес акселератора приложений, чтобы открыть портал средств разработки.

   

2. На портале средств разработки выберите акселератор.

3. Укажите входные параметры в разделе "Настройка акселератора" страницы "Создать акселераторы".

   

4. Выберите "ПРОСМОТР ФАЙЛА" , чтобы просмотреть структуру проекта и исходный код.

   

5. Выберите "Проверка" и " Создать", чтобы просмотреть указанные параметры, а затем нажмите кнопку "Создать акселератор".

   

6. Затем можно просмотреть или скачать проект в виде ZIP-файла.

   

Настройка акселераторов с помощью самозаверяющего сертификата

При настройке частного репозитория Git и включении HTTPS с самозаверяющий сертификат необходимо настроить имя сертификата ЦС для проверки сертификата клиента из акселератора в репозиторий Git.

Чтобы настроить акселераторы с самозаверяющий сертификат, выполните следующие действия.

1. Импортируйте сертификаты в Azure Spring Apps. Дополнительные сведения см . в разделе "Импорт сертификата " в разделе "Использование TLS/SSL-сертификатов" в приложении в Azure Spring Apps.
2. Настройте сертификат для акселератора с помощью портал Azure или Azure CLI.

Портал Azure

Чтобы настроить сертификат для акселератора, откройте раздел "Ускорители" и выберите "Добавить акселератор" в разделе "Настраиваемые акселераторы". Затем выберите сертификат из раскрывающегося списка.

Azure CLI

Используйте следующую команду, чтобы настроить сертификат для акселератора:

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

Ротация сертификатов

По истечении срока действия сертификатов необходимо повернуть сертификаты в Spring Cloud Apps, выполнив следующие действия.

1. Создайте новые сертификаты из доверенного ЦС.
2. Импортируйте сертификаты в Azure Spring Apps. Дополнительные сведения см . в разделе "Импорт сертификата " в разделе "Использование TLS/SSL-сертификатов" в приложении в Azure Spring Apps.
3. Синхронизируйте сертификаты с помощью портал Azure или Azure CLI.

Ускорители не будут автоматически использовать последний сертификат. Необходимо синхронизировать один или все сертификаты с помощью портал Azure или Azure CLI.

Портал Azure

Чтобы синхронизировать сертификаты для всех акселераторов, откройте раздел "Ускорители " и выберите "Синхронизировать сертификат", как показано на следующем снимке экрана:

Чтобы синхронизировать сертификат для одного акселератора, откройте раздел "Ускорители" и выберите "Синхронизировать сертификат " в контекстном меню акселератора, как показано на следующем снимке экрана:

Azure CLI

Используйте следующую команду для синхронизации сертификатов для акселератора:

az spring application-accelerator customized-accelerator sync-cert \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Управление акселератором приложений в существующем экземпляре плана enterprise

Вы можете включить акселератор приложений в существующем экземпляре плана Azure Spring Apps Enterprise с помощью портал Azure или Azure CLI.

Портал Azure

Если общедоступная конечная точка средств разработки уже предоставлена, вы можете включить акселератор приложений, а затем нажмите клавиши CTRL+F5, чтобы отключить кэш браузера, чтобы просмотреть его на портале средств разработки.

Выполните следующие действия, чтобы включить акселератор приложений в существующем экземпляре плана Azure Spring Apps Enterprise с помощью портал Azure:

1. Перейдите к ресурсу службы и выберите "Средства разработчика".

2. Выберите " Управление средствами".

3. Выберите "Включить акселератор приложений" и нажмите кнопку "Применить".

   

Вы можете просмотреть, включена или отключена ли акселератор приложений на странице средств разработчика.

Azure CLI

Используйте следующую команду, чтобы включить акселератор приложений для экземпляра службы Azure Spring Apps с помощью Azure CLI:

az spring application-accelerator create \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Используйте следующую команду, чтобы отключить акселератор приложений для экземпляра службы Azure Spring Apps:

az spring application-accelerator delete \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Чтобы получить доступ к порталу средств разработки, убедитесь, что он включен с назначенной общедоступной конечной точкой. Используйте следующую команду, чтобы включить портал средств разработки:

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

Использование акселератора приложений в VS Code

Вы можете загрузить проект из любого акселератора приложений в экземпляре службы плана Azure Spring Apps Enterprise непосредственно в VS Code.

Просмотр списка акселераторов приложений

Чтобы просмотреть список акселераторов приложений в экземпляре службы плана Azure Spring Apps Enterprise, выполните следующие действия.

1. В Visual Studio Code откройте расширение Azure Spring Apps и войдите в учетную запись Azure.

2. Разверните нужный экземпляр службы и щелкните правой кнопкой мыши, чтобы выбрать экземпляр службы.

3. В меню выберите "Открыть акселератор приложений", чтобы открыть список акселераторов приложений. Система предложит установить расширение Visual Studio Code для ускорителя приложений Tanzu, если оно не установлено.

   

4. Выберите любой акселератор для загрузки проекта.

   

Примечание.

При использовании расширения при возникновении проблем, которые не удается устранить, выйдите из учетной записи из расширения.

Устранение неполадок с акселератором приложений

Если вы попытаетесь открыть акселератор приложений для экземпляра службы, который не включил акселератор приложений или предоставил общедоступную конечную точку, вы увидите следующее сообщение об ошибке: Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible

Чтобы включить акселератор приложений и предоставить общедоступные конечные точки, выполните следующие действия. Дополнительные сведения см. в разделе "Управление акселератором приложений" в существующем экземпляре плана Enterprise.

1. Если вы включили единый вход на портале средств разработки, вы увидите следующее сообщение при доступе к расширению. The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Дополнительные сведения см. в разделе "Настройка средств разработки" раздела "Настройка средств разработки" в разделе "Настройка средств разработки Tanzu" в плане Azure Spring Apps Enterprise.

2. Выберите "Разрешить", выберите "Открыть", а затем снова нажмите кнопку "Открыть", чтобы открыть список расширений VS Code.

   

Иногда может появиться сообщение об ошибке, аналогичное следующему примеру: AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

Чтобы устранить эту проблему, добавьте URI vscode://VMware.tanzu-app-accelerator перенаправления в соответствующий поставщик удостоверений (IdP). В идентификаторе Microsoft Entra перейдите в меню проверки подлинности и добавьте URI перенаправления в мобильные и классические приложения в конфигурациях платформы.

Следующие шаги

• Azure Spring Apps