Руководство: Подключение веб-приложения к Azure App Configuration с помощью Соединителя служб

Узнайте, как подключить приложение ASP.NET Core, работающее в службе приложение Azure, к Конфигурация приложений Azure с помощью одного из следующих методов:

• Назначаемое системой управляемое удостоверение (SMI)
• Назначаемое пользователем управляемое удостоверение (UMI)
• Service principal
• Connection string

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

Prerequisites

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно . Create an account for free.
• Интерфейс командной строки Azure. Его можно использовать в Azure Cloud Shell или установить локально.
• Git

Вход в Azure

Запустите az login Azure CLI, чтобы войти в Azure.

Настройка ресурсов Azure

Начните с создания ресурсов Azure.

1. Клонируйте следующий пример репозитория:

   git clone https://github.com/Azure-Samples/serviceconnector-webapp-appconfig-dotnet.git
   

2. Разверните веб-приложение в Azure.

   Выполните следующие действия, чтобы создать Служба приложений и развернуть пример приложения. Make sure you have the subscription Contributor or Owner role.

   • Управляемое удостоверение, выдаваемое системой (рекомендуется)
   • Управляемое удостоверение, назначаемое пользователем
   • Service principal
   • Connection string

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

   # Change directory to the SMI sample
   cd serviceconnector-webapp-appconfig-dotnet\system-managed-identity
   
   # Create a web app
   
   LOCATION='eastus'
   RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
   APP_SERVICE_NAME='webapp-appconfig-smi'
   
   az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME
   

   Parameter	Description	Example
   Location	Выберите ближайшее к вам расположение. Используйте az account list-locations --output table для вывода списка расположений.	eastus
   Имя группы ресурсов	Используйте эту группу ресурсов, чтобы упорядочить все ресурсы Azure, необходимые для выполнения этого руководства.	service-connector-tutorial-rg
   Имя службы приложений	Имя службы приложений используется в качестве имени ресурса в Azure и для формирования полного доменного имени приложения в виде конечной точки сервера. Допустимые символы: A-Z, 0-9 и -. Azure добавляет случайную строку, чтобы сделать конечную точку сервера уникальной во всех Azure.	webapp-appconfig-smi

3. Создайте хранилище конфигурации приложений Azure.

   APP_CONFIG_NAME='my-app-config'
   
   az appconfig create --resource-group $RESOURCE_GROUP_NAME --name $APP_CONFIG_NAME --sku Free --location eastus
   

4. Импортируйте файл конфигурации теста в Конфигурация приложений Azure.

   • SMI
   • UMI
   • Service principal
   • Connection string

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

   1. Измените каталоги в папку ServiceConnectorSample.

   2. Import the ./sampleconfigs.json test configuration file into the App Configuration store. If you're using Cloud Shell, upload sampleconfigs.json before you run the command.

      az appconfig kv import --name $APP_CONFIG_NAME --source file --format json --path ./sampleconfigs.json --separator : --yes
      

Подключение веб-приложения к конфигурации приложений

Создайте подключение между веб-приложением и хранилищем Конфигурация приложений.

az webapp connection create appconfig --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_smi" --system-identity

az webapp connection create appconfig --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_umi" --user-identity client-id=<myIdentityClientId> subs-id=<myTestSubsId>

az webapp connection create appconfig --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_sp" --service-principal client-id=<mySPClientId>  secret=<mySPSecret>

az webapp connection create appconfig --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME --app-config $APP_CONFIG_NAME --tg $RESOURCE_GROUP_NAME --connection "app_config_cs" --secret

Проверка подключения

Чтобы проверить, работает ли подключение, перейдите к веб-приложению. Самый простой способ добраться до веб-приложения — открыть его на портале Azure. После того как веб-сайт будет запущен, вы увидите сообщение: Здравствуйте. Ваш веб-приложение Azure теперь подключено к конфигурации приложений с помощью ServiceConnector. After the website is up, you see it display: Hello. Your Azure WebApp is connected to App Configuration by ServiceConnector now.

Принцип работы

Узнайте, что Service Connector управляет в фоновом режиме для каждого типа проверки подлинности.

Дополнительные сведения см. во внутренних компонентах соединителя служб.

Test (optional)

При необходимости выполните следующие тесты:

1. Обновите значение ключа SampleApplication:Settings:Messages в хранилище Конфигурация приложений.

   az appconfig kv set --name <myAppConfigStoreName> --key SampleApplication:Settings:Messages --value hello --yes
   

2. Перейдите к веб-приложению Azure, как описано ранее, и обновите страницу. You see that the message is updated to: hello.

Очистка ресурсов

После завершения работы, если вы больше не собираетесь использовать эти ресурсы Azure, удалите их, выполнив az group delete команду. Эта команда удаляет группу ресурсов и все ресурсы в ней.

az group delete --name <myResourceGroupName> --yes

Next step