Краткое руководство. Использование Конфигурация приложений Azure в приложениях контейнеров Azure

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

Предпосылки

• Приложение с помощью хранилища Конфигурация приложений. Если у вас нет экземпляра, создайте экземпляр с помощью краткого руководства. Создание приложения ASP.NET Core с помощью Конфигурация приложений.
• Экземпляр приложений контейнеров Azure. Если у вас нет экземпляра, создайте экземпляр с помощью портал Azure или ИНТЕРФЕЙСА командной строки.
• Docker Desktop
• Интерфейс командной строки Azure

Подключение Конфигурация приложений Azure к приложению контейнера

1. В портал Azure перейдите к экземпляру приложения-контейнера.

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

   1. На вкладке "Основные сведения" :

      • В разделе "Тип службы" выберите Конфигурация приложений

      • В разделе Конфигурация приложений выберите свое хранилище Конфигурация приложений.

        

   2. На вкладке "Проверка подлинности":

      • Выберите тип проверки подлинности управляемого удостоверения, назначаемого системой
      • Развернуть меню "Дополнительно"
      • Назначение удостоверения роли чтения данных Конфигурация приложений
      • В разделе "Сведения о конфигурации" вы найдете переменную среды с именем AZURE_APPCONFIGURATION_ENDPOINT. Щелкните значок карандаша справа и измените имя переменной среды, чтобы она соответствовала имени переменной в приложении, из которой загружается конечная точка Конфигурация приложений. Если вы создали приложение после краткого руководства ASP.NET Core, имя переменной — Endpoints:AppConfigurationэто . При изменении имени переменной замените двоеточие двойным подчеркиванием, чтобы он стал Endpoints__AppConfiguration. Если вы работаете с другим приложением, введите соответствующее имя переменной среды, а затем нажмите кнопку "Готово".

   3. Используйте значения по умолчанию для всего остального.

   При создании подключения в Endpoints__AppConfiguration контейнер ресурса приложения-контейнера добавляется переменная среды. Его значение является ссылкой на секрет приложения контейнера, конечную точку вашего хранилища Конфигурация приложений.

Создание контейнера

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

   dotnet publish -c Release -o published
   

2. Создайте файл с именем Dockerfile в каталоге, содержащий CSPROJ-файл, откройте его в текстовом редакторе и введите следующее содержимое. Dockerfile — это текстовый файл, который не имеет расширения и используется для создания образа контейнера.

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. Создайте контейнер, выполнив следующую команду.

   docker build --tag aspnetapp .
   

создадите экземпляр реестра контейнеров Azure;

Создание экземпляра службы "Реестр контейнеров Azure" (ACR). ACR позволяет создавать, хранить образы контейнеров и управлять ими.

Отправка образа в Реестр контейнеров Azure

Отправьте образ Docker в созданный ранее ACR.

1. Выполните команду az acr login, чтобы войти в реестр.

   az acr login --name myregistry
   

   Команда возвращается Login Succeeded после успешного входа.

2. Используйте тег docker, чтобы пометить соответствующие сведения о изображении.

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   Подсказка

   Чтобы просмотреть список существующих образов и тегов Docker, выполните команду docker image ls. В этом сценарии должно отображаться по крайней мере два изображения: aspnetapp и myregistry.azurecr.io/aspnetapp.

3. Используйте docker push-отправку для отправки образа в реестр контейнеров. В этом примере создается репозиторий aspnetapp в ACR, aspnetapp содержащий изображение. В приведенном ниже примере замените заполнители <login-server<image-name> и <tag> значением сервера входа ACR, именем образа и тегом изображения.

   Метод:

   docker push <login-server>/<image-name>:<tag>
   

   Пример:

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. Откройте Реестр контейнеров Azure в портал Azure и убедитесь, что в репозиториях вы можете увидеть новый репозиторий.

   

Добавление образа контейнера в приложения контейнеров Azure

Обновите приложение-контейнер, чтобы загрузить образ контейнера из ACR.

1. В портал Azure откройте экземпляр Azure Container Apps.

2. В меню слева в разделе "Приложение" выберите "Контейнеры".

3. Выберите Изменить и развернуть.

4. В разделе "Образ контейнера" щелкните имя существующего образа контейнера.

5. Обновите следующие параметры:

   Setting	Рекомендуемое значение	Description
   Источник изображения	Реестр контейнеров Azure	Выберите Реестр контейнеров Azure в качестве источника изображения.
   Authentication	Учетные данные администратора	Используйте параметр учетных данных пользователя администратора, который был включен ранее в реестре контейнеров. Если пользователь администратора не включен, но настроен на использование управляемого удостоверения, необходимо вручную ввести изображение и тег в форме.
   Registry	myregistry.azurecr.io	Выберите созданный ранее Реестр контейнеров Azure.
   Изображение	aspnetapp	Выберите созданный образ Docker и отправьте его в ACR ранее.
   Тег образа	версия 1	Выберите тег изображения из списка.

6. Выберите "Сохранить" и "Создать", чтобы развернуть обновление в приложении контейнера Azure.

Перейдите по URL-адресу приложения контейнера Azure

В портал Azure в экземпляре приложений контейнеров Azure перейдите на вкладку "Обзор" и откройте URL-адрес приложения.

Веб-страница выглядит следующим образом:

Очистите ресурсы

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

1. Войдите на портал Azure и выберитеГруппы ресурсов.
2. В поле Фильтр по имени введите название вашей группы ресурсов.
3. В списке результатов выберите имя группы ресурсов, чтобы просмотреть общие сведения.
4. Выберите команду Удалить группу ресурсов.
5. Вам предлагается подтвердить удаление группы ресурсов. Введите имя вашей группы ресурсов для подтверждения и выберите Удалить.

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

Связанный контент

В этом кратком руководстве вы сможете:

• Подключение Конфигурация приложений Azure к приложениям контейнеров Azure
• Используется Docker для создания образа контейнера из приложения ASP.NET Core с параметрами Конфигурация приложений
• Создание экземпляра Реестр контейнеров Azure
• Отправка изображения в экземпляр Реестр контейнеров Azure
• Добавлен образ контейнера в приложения контейнеров Azure
• Перейдите по URL-адресу экземпляра приложений контейнеров Azure, обновленного с параметрами, настроенными в хранилище Конфигурация приложений.

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

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