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


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

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

Эта статья относится к:❌ 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, вам также потребуется выполнить следующие предварительные требования:

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

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

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

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

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

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

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

    Снимок экрана: портал Azure, на котором показана вкладка параметров VMware Tanzu с выделенным флажком

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

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

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

Акселератор приложений позволяет создавать новые проекты из файлов в репозиториях 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, на котором показана страница

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

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

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

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

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

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

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

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

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

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

Снимок экрана: портал Azure вкладка

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

Портал 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-адрес акселератора приложений, чтобы просмотреть опубликованные акселераторы на портале средств разработки:

Снимок экрана: портал Azure, на котором показана страница

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

Снимок экрана: страница средств разработки VMware Tanzu для Акселераторов приложений Azure Spring Apps.

Примечание.

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

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

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

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

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

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

    Снимок экрана: портал Azure, на котором показаны настраиваемые акселераторы типа

  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.

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

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

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

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

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

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

    Снимок экрана: портал Azure, на котором показана страница

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

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

    Снимок экрана: страница средств разработки VMware Tanzu для Azure Spring Apps Generate Accelerators, в котором показан раздел

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

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

    Снимок экрана: страница

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

    Снимок экрана: средства разработки VMware Tanzu для Azure Spring Apps, на котором показана область действий задач.

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

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

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

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

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

Снимок экрана: портал Azure, на котором показана панель

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

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

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

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

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

Снимок экрана: портал Azure, на котором показана панель настраиваемых акселераторов с выделенной кнопкой

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

Снимок экрана или портал Azure, на котором показана панель настраиваемых акселераторов с выделенным параметром контекстного меню сертификата синхронизации.

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

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

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

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

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

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

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

    Снимок экрана: портал Azure, на котором показана область

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

Использование акселератора приложений в 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, если оно не установлено.

    Снимок экрана: расширение VS Code с параметром Open Application Accelerator для экземпляра службы.

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

    Снимок экрана: VS Code, в котором показан список расширений Акселератора приложений.

Примечание.

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

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

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

    Снимок экрана: 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 перенаправления в мобильные и классические приложения в конфигурациях платформы.

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