Настройка источников развертывания для Служб приложений в Azure Stack Hub
Служба приложений в Azure Stack Hub поддерживает развертывание по запросу из поставщиков систем контроля версий. Эта функция позволяет разработчикам напрямую развертывать приложения из репозиториев систем контроля версий. Если пользователям необходимо настроить службу приложений для подключения к своим репозиториям, оператор облака должен сначала настроить интеграцию между службой приложений в Azure Stack Hub и поставщиком системы управления версиями.
Кроме локальной системы Git поддерживаются следующие поставщики систем управления версиями:
- GitHub
- Bitbucket;
- OneDrive
- ДропБокс
Просмотр источников развертывания в средстве администрирования службы приложений
Войдите на портал администрирования Azure Stack Hub с правами администратора служб.
Выберите Все службы, Служба приложений.
Выберите Конфигурация системы управления версиями. Вы можете просмотреть список всех настроенных источников развертывания.
Настройка GitHub
Для выполнения этой задачи вам потребуется учетная запись GitHub. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Войдите в GitHub, перейдите в https://www.github.com/settings/developers, а затем выберите команду Register a new application (Зарегистрировать новое приложение).
Введите имя приложения. Например, Служба приложений Azure в Azure Stack Hub.
Введите значение в поле Homepage URL (URL-адрес домашней страницы). URL-адресом домашней страницы должен быть адрес портала Azure Stack Hub. Например,
https://portal.<region>.<FQDN>. Дополнительные сведения о полном доменном имени (FQDN) Azure Stack Hub см. в разделе Пространство имен DNS для Azure Stack Hub.Введите текст в поле Application Description (Описание приложения).
Введите URL-адрес обратного вызова авторизации. В развертывании Azure Stack Hub по умолчанию используется URL-адрес в формате
https://portal.<region>.<FQDN>/TokenAuthorize.Выберите Register application (Зарегистрировать приложение). Откроется страница, на которой вы увидите значения идентификатора клиента и секрета клиента для приложения.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте идентификатор клиента и секрет клиента для GitHub в соответствующие поля ввода.
Выберите Сохранить.
Настройка Bitbucket
Для выполнения этой задачи вам потребуется учетная запись Bitbucket. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Войдите в систему Bitbucket и перейдите к разделу Integrations (Интеграция) в вашей учетной записи.
Щелкните OAuth в списке управления доступом и выберите Add consumer (Добавить потребителя).
Введите Имя для потребителя. Например, Служба приложений Azure в Azure Stack Hub.
Введите описание приложения.
Введите значение в поле Callback URL (URL-адрес обратного вызова). В развертывании Azure Stack Hub по умолчанию используется URL-адрес обратного вызова в формате
https://portal.<region>.<FQDN>/TokenAuthorize. Для успешной интеграции с Bitbucket убедитесь, что URL-адрес соответствует указанному здесь написанию символов с учетом регистра.Введите URL-адрес. Это должен быть URL-адрес портала Azure Stack Hub. Например,
https://portal.<region>.<FQDN>.В поле Permissions (Разрешения) необходимо выбрать:
- Repositories (Репозитории): Read (Чтение).
- Webhooks (Веб-перехватчики): Read and write (Чтение и запись).
Выберите Сохранить. Вы увидите новое приложение, а также Ключ и Секрет в разделе Потребители OAuth.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация управления исходным кодом.
Скопируйте и вставьте ключ для Bitbucket в поле идентификатора клиента, а секрет — в поле секрета клиента.
Выберите Сохранить.
Настройка OneDrive
Для выполнения этой задачи необходимо иметь учетную запись Майкрософт , связанную с учетной записью OneDrive. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Примечание.
Учетные записи OneDrive для бизнеса сейчас не поддерживаются.
Перейдите к https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade и войдите с учетной записью Майкрософт.
В разделе Регистрация приложений выберите "Создать регистрацию".
Введите имя для регистрации нового приложения: например, введите Служба приложений в Azure Stack Hub.
В разделе "Поддерживаемые типы учетных записей" выберите только личные учетные записи Майкрософт.
Введите URI перенаправления. Выберите платформу — Веб- и в развертывании Azure Stack Hub по умолчанию URI перенаправления находится в форме .
https://portal.<region>.<FQDN>/TokenAuthorizeВыберите Зарегистрировать.
На следующем экране вы увидите список свойств нового приложения. Сохраните идентификатор приложения (клиента) во временном расположении.
В разделе "Сертификаты и секреты" выберите "Секреты клиента" и выберите "Создать секрет клиента". Укажите описание и выберите длину срока действия для нового секрета и нажмите кнопку "Добавить".
Запишите значение нового секрета.
В разделе "Разрешения API" выберите "Добавить разрешение".
Добавьте разрешения в разделе Разрешения Microsoft Graph - Делегированные разрешения.
- Files.ReadWrite.AppFolder
- Пользователь. Читать
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация управления исходным кодом.
Скопируйте и вставьте идентификатор приложения (клиента) в поле ввода идентификатора клиента и секрета в поле ввода секрета клиента для OneDrive.
Выберите Сохранить.
Настройка Dropbox
Примечание.
Для выполнения этой задачи вам потребуется учетная запись Dropbox. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Перейдите к https://www.dropbox.com/developers/apps и войдите с учетной записью DropBox.
Выберите Создать приложение.
Выберите Dropbox API.
Установите уровень доступа App Folder (Папка приложения).
Введите Название вашего приложения.
Выберите Создать приложение. Вы увидите страницу со списком параметров приложения, включая Ключ приложения и Секрет приложения.
Убедитесь, что параметр App folder name (Имя папки приложения) имеет значение App Service on Azure Stack Hub (Служба приложений в Azure Stack Hub).
Задайте значение OAuth 2 Redirect URI (URI перенаправления OAuth 2), а затем щелкните Добавить. В развертывании Azure Stack Hub по умолчанию используется URI перенаправления в формате
https://portal.<region>.<FQDN>/TokenAuthorize.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте ключ приложения для DropBox в поле ввода идентификатора клиента, а секрет приложения — в поле секрета клиента.
Выберите Сохранить.
Внимание
Если вы перенастраиваете существующие приложения после обновления до службы приложений Azure в Azure Stack Hub 2022 H1, необходимо отозвать все токены, и конечным пользователям потребуется повторно авторизоваться с поставщиками в своих приложениях, чтобы включить синхронизацию с поставщиками систем контроля версий.
Настройка GitHub
Для выполнения этой задачи вам потребуется учетная запись GitHub. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Войдите в GitHub, перейдите в https://www.github.com/settings/developers, а затем выберите команду Register a new application (Зарегистрировать новое приложение).
Введите имя приложения. Например, Служба приложений Azure в Azure Stack Hub.
Введите значение в поле Homepage URL (URL-адрес домашней страницы). URL-адресом домашней страницы должен быть адрес портала Azure Stack Hub. Например,
https://portal.<region>.<FQDN>. Дополнительные сведения о полном доменном имени (FQDN) Azure Stack Hub см. в разделе Пространство имен DNS для Azure Stack Hub.Введите текст в поле Application Description (Описание приложения).
Введите Authorization callback URL. В развертывании Azure Stack Hub по умолчанию используется URL-адрес в формате
https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.Выберите Register application (Зарегистрировать приложение). Откроется страница, на которой вы увидите значения идентификатора клиента и секрета клиента для приложения.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте идентификатор клиента и секрет клиента для GitHub в соответствующие поля ввода.
Выберите Сохранить.
Настройка Bitbucket
Для выполнения этой задачи вам потребуется учетная запись Bitbucket. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Войдите в систему Bitbucket и перейдите к разделу Integrations (Интеграция) в вашей учетной записи.
Щелкните OAuth в списке управления доступом и выберите Add consumer (Добавить потребителя).
Введите Имя для потребителя. Например, Служба приложений Azure в Azure Stack Hub.
Введите описание приложения.
Введите значение в поле Callback URL (URL-адрес обратного вызова). В развертывании Azure Stack Hub по умолчанию используется URL-адрес обратного вызова в формате
https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. Чтобы интеграция с BitBucket прошла успешно, URL-адрес должен точно соответствовать написанию с учетом регистра, указанному здесь.Введите URL-адрес. Это должен быть URL-адрес портала Azure Stack Hub. Например,
https://portal.<region>.<FQDN>.В поле Permissions (Разрешения) необходимо выбрать:
- Репозитории: Чтение
- Webhooks: Read and write (Чтение и запись).
Выберите Сохранить. Вы увидите новое приложение, а также Ключ и Секрет в разделе Потребители OAuth.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте ключ для Bitbucket в поле идентификатора клиента, а секрет — в поле секрета клиента.
Выберите Сохранить.
Настройка OneDrive
Для выполнения этой задачи необходимо иметь учетную запись Майкрософт , связанную с учетной записью OneDrive. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Примечание.
Учетные записи OneDrive для бизнеса сейчас не поддерживаются.
Перейдите к https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade и войдите с учетной записью Майкрософт.
В разделе Регистрация приложений выберите "Создать регистрацию".
Введите имя для регистрации нового приложения: например, введите Служба приложений в Azure Stack Hub.
В разделе "Поддерживаемые типы учетных записей" выберите только личные учетные записи Майкрософт
Введите URI перенаправления. Выберите платформу — Веб- и в развертывании Azure Stack Hub по умолчанию URI перенаправления находится в форме .
https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callbackНажмите кнопку Зарегистрировать.
На следующем экране вы увидите список свойств нового приложения. Сохраните идентификатор приложения (клиента) во временном расположении.
В разделе "Сертификаты и секреты" выберите "Секреты клиента" и выберите "Создать секрет клиента". Укажите описание и выберите длину срока действия для нового секрета и нажмите кнопку "Добавить".
Запишите значение нового секрета.
В разделе "Разрешения API" выберите " Добавить разрешение"
Добавьте Разрешения Microsoft Graph - Делегированные разрешения.
- Files.ReadWrite.AppFolder
- Пользователь. Читать
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте идентификатор приложения (клиента) в поле ввода идентификатора клиента и секрета в поле ввода секрета клиента для OneDrive.
Выберите Сохранить.
Настройка Dropbox
Примечание.
Для выполнения этой задачи вам потребуется учетная запись Dropbox. Возможно, правильнее будет использовать корпоративную учетную запись, а не личную.
Перейдите к https://www.dropbox.com/developers/apps и войдите с учетной записью DropBox.
Выберите Создать приложение.
Выберите Dropbox API.
Установите уровень доступа на App Folder (Папка приложения).
Введите Название для вашего приложения.
Выберите Создать приложение. Вы увидите страницу со списком параметров приложения, включая Ключ приложения и Секрет приложения.
Убедитесь, что параметр App folder name (Имя папки приложения) имеет значение App Service on Azure Stack Hub (Служба приложений в Azure Stack Hub).
Задайте значение OAuth 2 Redirect URI (URI перенаправления OAuth 2), а затем щелкните Добавить. В развертывании Azure Stack Hub по умолчанию используется URI перенаправления в формате
https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.
На новой вкладке или в новом окне браузера войдите на портал Azure Stack Hub с правами администратора служб.
Перейдите в раздел Поставщики ресурсов и выберите элемент App Service Resource Provider Admin (Администратор поставщика ресурсов службы приложений).
Выберите Конфигурация системы управления версиями.
Скопируйте и вставьте ключ приложения для DropBox в поле ввода идентификатора клиента, а секрет приложения — в поле секрета клиента.
Выберите Сохранить.
Следующие шаги
Теперь пользователи могут использовать источники развертывания для таких операций, как непрерывное развертывание, локальное развертывание Git и синхронизация облачных папок.