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

Эта статья относится к: ❎ Basic/Standard ✅ Enterprise

В этой статье показано, как использовать Application Accelerator for VMware Tanzu (App Accelerator) с планом 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.

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

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

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

az spring application-accelerator show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-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.

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

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

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

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

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

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

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

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

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

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

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-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]

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

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

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

Укажите фрагмент в своих акселераторах

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

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

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

   • Портал Azure
   • Azure CLI

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

   

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

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

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

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

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

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

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

   

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

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

   

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

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

   

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

   

Настройка ускорителей с помощью самоподписанного сертификата

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

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

1. Импортируйте сертификаты в Azure Spring Apps. Для получения дополнительной информации см. раздел "Импорт сертификата" в разделе "Использование TLS/SSL-сертификатов в вашем приложении в Azure Spring Apps".
2. Настройте сертификат для акселератора с помощью портал 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.

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

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

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

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

az spring application-accelerator delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-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. В меню выберите "Открыть акселератор приложений", чтобы открыть список акселераторов приложений. Система предложит установить расширение Tanzu Application Accelerator для Visual Studio Code, если оно не установлено.

   

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

   

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

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

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

1. Если вы включили единый вход на портале Dev Tools, при доступе к расширению вы увидите следующее сообщение: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Для получения дополнительной информации см. раздел «Настройка портала Dev Tools» в разделе «Настройка Tanzu Dev Tools в плане 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