Монтирование Azure Storage как локального сетевого ресурса - Azure App Service

Azure Storage — это решение облачного хранилища Майкрософт для современных сценариев хранения данных. Azure Storage предлагает высокодоступное, масштабируемое, устойчивое и безопасное хранилище для объектов данных в облаке. В этом руководстве показано, как подключить файлы Azure Storage в качестве сетевого ресурса в Windows коде (неподконтейнерном) в приложении Azure App Service.

Azure Storage поддерживает общие папки Azure Files и Premium Files Shares для службы приложений. Azure Storage не является хранилищем по умолчанию для службы приложений. Плата взимается отдельно. Вы также можете настроить хранилище Azure в шаблоне ARM.

Преимущества настраиваемого хранилища включают:

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

Для кода Windows поддерживаются следующие функции:

Защищенный доступ к учетным записям хранения с помощью хранилища ключей, частных конечных точек и конечных точек службы (при использовании интеграции виртуальной сети).
Azure Files (чтение и запись).
До пяти точек подключения для каждого приложения.
Подключите общие папки Azure Storage с помощью /mounts/<path-name>.

Ниже приведены три варианта подключения хранилища Azure к приложению:

Вариант крепления	Использование
Основной	Выберите этот параметр при подключении хранилища с помощью портала Azure. Вы можете использовать базовый параметр, если учетная запись хранения не использует конечные точки службы service endpoints, частные конечные точки или Azure Key Vault. В этом случае портал получает и сохраняет ключ доступа для вас.
Ключ доступа	Если вы планируете подключить хранилище с помощью Azure CLI, необходимо получить ключ доступа. Выберите этот параметр, если учетная запись хранения не использует конечные точки службы , private endpoints или Azure Key Vault.
Хранилище ключей	Также используйте этот параметр при планировании подключения хранилища с помощью Azure CLI, для которого требуется ключ доступа. Выберите этот параметр при использовании Azure Key Vault для безопасного хранения и получения ключей доступа. Azure Key Vault имеет преимущества хранения секретов приложений централизованно и безопасно с возможностью мониторинга, администрирования и интеграции с другими службами Azure, такими как Azure App Service.

Prerequisites

Limitations

Брандмауэр хранилища поддерживается только через частные конечные точки и конечные точки службы при использовании интеграции виртуальной сети.
Azure BLOB-объекты не поддерживаются при настройке подключений хранилища Azure для приложений кода Windows, развернутых в Службе приложений.
Доступ FTP/FTPS к подключенному хранилищу не поддерживается. Используйте Azure Storage Explorer.
Сопоставление /mounts, mounts/name1/name2, /и /mounts/name.ext/ с настраиваемым хранилищем не поддерживается. Вы можете использовать только /mounts/pathname для монтирования настраиваемого хранилища к веб-приложению.
Подключения хранилища не включаются в резервные копии. Следуйте рекомендациям по резервному копированию учетных записей Azure Storage.
При интеграции виртуальной сети с приложением подключенный диск использует RFC1918 IP-адрес, а не IP-адрес из виртуальной сети.

Подготовка к монтажу

Дополнительные шаги не требуются, так как портал получает и сохраняет ключ доступа для вас.

Прежде чем подключить хранилище с помощью доступа к Key Vault, необходимо получить секрет Key Vault и добавить его в качестве параметра в вашем приложении.

На портале Azure перейдите к Key Vault. Выберите Объекты>Секреты. Скопируйте секретный идентификатор в буфер обмена.
Вернитесь к приложению и следуйте ссылке на хранилище ключей , чтобы создать параметр приложения с помощью секретного идентификатора.

Пример значения параметра приложения: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Теперь вы готовы использовать Key Vault для доступа к учетной записи хранения.

Подключение хранилища к коду Windows

Чтобы подключить хранилище к Windows коду с помощью портала Azure:

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Path mappings, а затем выберите Новое подключение хранилища Azure.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Basic, если учетная запись хранения не использует приватные конечные точки или Azure Key Vault. В противном случае нажмите кнопку "Дополнительно".
Учетные записи хранения	Azure Storage учетная запись. Он должен содержать общую папку Azure Files.
Имя общего ресурса	Общий доступ к файлам для подключения.
Доступ к хранилищу	Выберите ссылку на Key Vault для Azure Key Vault. В противном случае выберите входные данные вручную.
Ключ доступа (только расширенный)	Ключ доступа для учетной записи хранения.
Путь монтирования	Каталог в вашей службе приложений, который вы хотите монтировать. Поддерживается только /mounts/pathname.
Параметры приложения	Выберите настройку приложения с секретом в Azure Key Vault.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Path mappings, а затем выберите Новое подключение хранилища Azure.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Дополнительно.
Учетные записи хранения	Azure Storage учетная запись.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Azure BLOB-объекты поддерживают только доступ для чтения.
Контейнер хранилища или имя общего ресурса	Для подключения к общей папке или контейнеру BLOB-объектов.
Доступ к хранилищу	Выберите ручной ввод.
Ключ доступа	Введите ключ доступа для учетной записи хранения.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Path mappings, а затем выберите Новое подключение хранилища Azure.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Basic, если учетная запись хранилища не использует конечные точки service endpoints, private endpoints или Azure Key Vault. В противном случае нажмите кнопку "Дополнительно".
Учетные записи хранения	Azure Storage учетная запись.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Azure BLOB-объекты поддерживают только доступ для чтения.
Контейнер хранилища или имя общего ресурса	Для подключения к общей папке или контейнеру BLOB-объектов.
Доступ к хранилищу	Выберите ссылку на хранилище ключей.
Параметры приложения	Выберите существующую настройку приложения с секретом Azure Key Vault.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При проверке параметры подключения хранилища также применяются к слотам развертывания.

Чтобы получить доступ к подключенному хранилищу, предоставьте вашему приложению доступ к Key Vault.

Используйте команду az webapp config storage-account add. Рассмотрим пример.

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

Убедитесь, что хранилище подключено, выполнив следующую команду:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Примечание

При добавлении, изменении или удалении подключения хранилища приложение перезапускается.

Лучшие практики

Azure Storage можно настроить как виртуальный каталог для обслуживания статического содержимого. Чтобы настроить виртуальный каталог, в левой области навигации> выберите"Конфигурация параметров". Затем выберите сопоставления пути, а затем — новое виртуальное приложение или каталог. Установите Физический путь на путь монтирования, определенный на подключении хранилища Azure.
Чтобы избежать проблем с задержкой, поместите приложение и учетную запись Azure Storage в том же регионе. Если вы предоставляете доступ из IP-адресов службы приложений в конфигурации брандмауэра Azure Storage если приложение и учетная запись Azure Storage находятся в одном регионе, эти ограничения IP-адресов не учитываются.
В учетной записи Azure Storage избегайте регенерации ключа доступа, используемой для подключения хранилища в приложении. Учетная запись хранения содержит два ключа. службы Azure App хранят ключ учетной записи хранения Azure. Используйте пошаговый подход, чтобы убедиться, что подключение хранилища остается доступным для приложения во время генерации ключей. Например, предположим, что вы использовали ключ 1 для настройки подключения хранилища в приложении:
1. Повторно создайте ключ2.
2. В конфигурации подключения хранилища обновите ключ доступа, чтобы использовать повторно созданный ключ key2.
3. Перегенерируйте ключ1.
Если удалить учетную запись Azure Storage, контейнер или общий доступ, удалите соответствующую конфигурацию подключения хранилища в приложении, чтобы избежать возможных сценариев ошибок.
Подключенная Azure Storage учетная запись может иметь уровень производительности "Стандартный" или "Премиум". В зависимости от требований к емкости и пропускной способности приложения выберите соответствующий уровень производительности для учетной записи хранения. См. целевые показатели масштабируемости и производительности файлов.
Если приложение масштабируется до нескольких экземпляров, все экземпляры подключаются к одной подключенной учетной записи Azure Storage. Чтобы избежать узких мест производительности и проблем с пропускной способностью, выберите соответствующий уровень производительности для учетной записи хранения.
Не рекомендуется использовать подключения хранилища для локальных баз данных, таких как SQLite, или для других приложений и компонентов, использующих дескрипторы файлов и блокировки.
Если вы инициируете отказ хранилища при монтировании учетной записи хранения к приложению, монтирование не активируется, до тех пор пока приложение не будет перезапущено или пока монтирование хранилища не будет удалено и добавлено снова.
Убедитесь, что порт 445 открыт при использовании Azure Files с интеграцией виртуальной сети. Кроме того, убедитесь, что для параметра WEBSITE_CONTENTOVERVNET приложения задано значение 1.
Подключенная Azure Storage учетная запись может иметь уровень производительности "Стандартный" или "Премиум". В зависимости от требований к емкости и пропускной способности приложения выберите соответствующий уровень производительности для учетной записи хранения. См. целевые показатели масштабируемости и производительности файлов.

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

Переносите .NET приложения в Azure App Service

Azure Storage — это решение облачного хранилища Майкрософт для современных сценариев хранения данных. Azure Storage предлагает высокодоступное, масштабируемое, устойчивое и безопасное хранилище для объектов данных в облаке. В этом руководстве показано, как подключить файлы Azure Storage как сетевую папку в контейнере Windows в службе приложений.

Azure Storage поддерживает общие папки Azure Files и Premium Files . Azure Storage не является хранилищем по умолчанию для службы приложений. Плата взимается отдельно. Вы также можете настроить хранилище Azure в шаблоне ARM.

Преимущества настраиваемого хранилища включают:

Настройте постоянное хранилище для приложения Службы приложений и управляйте хранилищем отдельно.
Сделайте статический контент, например видео и изображения, доступными для приложения службы приложений.
Записывать файлы журналов приложений или архивировать старые журналы приложений в файловые доли Azure.
Совместное использование содержимого между несколькими приложениями или другими Azure службами.
Подключите Azure Storage в контейнере Windows, включая изолированный. Дополнительные сведения см. в разделе "Среда службы приложений" версии 3.

Для контейнеров Windows поддерживаются следующие функции:

Защищенный доступ к учетным записям хранения с помощью хранилища ключей, частных конечных точек и конечных точек служб при использовании интеграции виртуальной сети.
Azure Files (чтение и запись).
До пяти точек подключения для каждого приложения.
Назначение букв диска (от C: до Z:).

Ниже приведены три варианта подключения хранилища Azure к приложению:

Вариант крепления	Использование
Основной	Выберите этот параметр при подключении хранилища с помощью портала Azure. Вы можете использовать базовый параметр, если учетная запись хранения не использует конечные точки службы service endpoints, частные конечные точки или Azure Key Vault. В этом случае портал получает и сохраняет ключ доступа для вас.
Ключ доступа	Если вы планируете подключить хранилище с помощью Azure CLI, необходимо получить ключ доступа. Выберите этот параметр, если учетная запись хранения не использует конечные точки службы service endpoints, частные конечные точки или Azure Key Vault.
Хранилище ключей	Также используйте этот параметр при планировании подключения хранилища с помощью Azure CLI, для которой требуется ключ доступа. Выберите этот параметр при использовании Azure Key Vault для безопасного хранения и получения ключей доступа. Azure Key Vault имеет преимущества хранения секретов приложений централизованно и безопасно с возможностью мониторинга, администрирования и интеграции с другими службами Azure, такими как Azure App Service.

Prerequisites

Limitations

Azure Blob не поддерживаются.
Брандмауэр хранилища поддерживается только через частные конечные точки и конечные точки службы при использовании интеграции виртуальной сети.
Доступ FTP/FTPS к подключенному хранилищу не поддерживается (используйте Azure Storage Explorer).
Сопоставление [C-Z]:\, [C-Z]:\home, /и /home с пользовательским настроенным хранилищем не поддерживается.
Точки монтирования хранилища не сохраняются при резервном копировании вашего приложения. Следуйте рекомендациям по резервному копированию учетных записей Azure Storage.
При интеграции виртуальной сети с приложением подключенный диск использует RFC1918 IP-адрес, а не IP-адрес из виртуальной сети.

Подготовка к монтажу

Дополнительные шаги не требуются, так как портал получает и сохраняет ключ доступа для вас.

Прежде чем подключить хранилище, используя доступ к Key Vault, необходимо получить секрет Key Vault и добавить его в качестве параметра в вашем приложении.

На портале Azure перейдите к Key Vault. Выберите Объекты>Секреты. Скопируйте секретный идентификатор в буфер обмена.
Вернитесь к приложению и следуйте ссылке на хранилище ключей , чтобы создать параметр приложения с помощью секретного идентификатора.

Пример значения параметра приложения: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Теперь вы готовы использовать Key Vault для доступа к учетной записи хранения.

Подключение хранилища к контейнеру Windows

Чтобы подключить хранилище к контейнеру Windows с помощью портала Azure:

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

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Базовый.
Учетные записи хранения	учетная запись Azure Storage Он должен содержать общую папку Azure Files.
Имя ресурса	Общий доступ к файлам для подключения.
Путь монтирования	Каталог внутри контейнера Windows, который требуется смонтировать. Не используйте корневой каталог ([C-Z]: или /домашний каталог ([C-Z]:\home или /home).
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

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

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Дополнительно.
Учетные записи хранения	учетная запись Azure Storage. Он должен содержать общую папку Azure Files.
Имя сетевого ресурса	Общий доступ к файлам для подключения.
Ключ доступа (только расширенный)	Ключ доступа для учетной записи хранения.
Путь монтирования	Каталог внутри контейнера Windows, который требуется монтировать. Не используйте корневой каталог ([C-Z]: или /домашний каталог ([C-Z]:\home или /home).
Параметры приложения	Выберите параметр приложения с секретом из Azure Key Vault.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

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

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Если учетная запись хранения не использует конечные точки службы , private endpoints или Azure Key Vault выберите Basic. В противном случае нажмите кнопку "Дополнительно".
Учетные записи хранения	учетная запись Azure Storage.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Azure BLOB-объекты поддерживают только доступ только для чтения.
Контейнер хранилища или имя общего доступа	Для подключения к общей папке или контейнеру BLOB-объектов.
Доступ к хранилищу	Выберите ссылку на хранилище ключей.
Параметры приложения	Выберите существующий параметр приложения, настроенный с помощью секрета Azure Key Vault.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

Чтобы получить доступ к подключению хранилища, предоставьте вашему приложению доступ к Key Vault.

Используйте команду az webapp config storage-account add. Рассмотрим пример.

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

Задайте --storage-type значение AzureFiles для контейнеров Windows.
Формат mount-path-directory как /path/to/dir или [C-Z]:\path\to\dir.

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

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Примечание

Добавление, редактирование или удаление подключения хранилища перезапускает приложение.

Лучшие практики

Чтобы избежать проблем с задержкой, поместите приложение и учетную запись Azure Storage в одном регионе. Если вы предоставляете доступ из IP-адресов службы приложений в конфигурации брандмауэра Azure Storage если приложение и учетная запись Azure Storage находятся в одном регионе, эти ограничения IP-адресов не учитываются.
В учетной записи Azure Storage избегайте регенерации ключа доступа, используемой для подключения хранилища в приложении. Учетная запись хранения содержит два ключа. Azure App Service хранит ключ учетной записи хранения Azure. Используйте пошаговый подход, чтобы убедиться, что подключение хранилища остается доступным для приложения во время генерации ключей. Например, предположим, что вы использовали ключ 1 для настройки подключения хранилища в приложении:
1. Повторно создайте ключ2.
2. В конфигурации подключения хранилища обновите ключ доступа, чтобы использовать повторно созданный ключ key2.
3. Перегенерируйте ключ1.
Если удалить учетную запись Azure Storage, контейнер или общий доступ, удалите соответствующую конфигурацию подключения хранилища в приложении, чтобы избежать возможных сценариев ошибок.
Подключенная Azure Storage учетная запись может иметь уровень производительности "Стандартный" или "Премиум". В зависимости от требований к емкости и пропускной способности приложения выберите соответствующий уровень производительности для учетной записи хранения. См. целевые показатели масштабируемости и производительности файлов.
Если приложение масштабируется до нескольких экземпляров, все экземпляры подключаются к одной подключенной учетной записи Azure Storage. Чтобы избежать узких мест производительности и проблем с пропускной способностью, выберите соответствующий уровень производительности для учетной записи хранения.
Не используйте подключения хранилища для локальных баз данных, таких как SQLite, или для других приложений и компонентов, использующих дескрипторы и блокировки файлов.
Убедитесь, что порт 445 открыт при использовании Azure Files с интеграцией виртуальной сети.
Если вы инициируете отказ хранилища при монтировании учетной записи хранения к приложению, монтирование не активируется, до тех пор пока приложение не будет перезапущено или пока монтирование хранилища не будет удалено и добавлено снова.

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

Переносите пользовательское программное обеспечение в Azure App Service, используя пользовательский контейнер

Примечание

поддержка NFS теперь доступна для App Service on Linux.

В этом руководстве показано, как подключить Azure Storage как сетевую папку в встроенном контейнере Linux или пользовательском контейнере Linux в службе приложений. Azure Storage — это решение облачного хранилища Майкрософт для современных сценариев хранения данных. Azure Storage предлагает высокодоступное, масштабируемое, устойчивое и безопасное хранилище для объектов данных в облаке. Azure Storage не является хранилищем по умолчанию для службы приложений. Плата взимается отдельно. Вы также можете настроить хранилище Azure в шаблоне ARM.

Преимущества настраиваемого хранилища включают:

Настройте постоянное хранилище для приложения Службы приложений и управляйте хранилищем отдельно.
Сделайте статический контент, например видео и изображения, доступными для приложения службы приложений.
Записывать файлы журналов приложений или архивировать старые журналы приложений в файловые доли Azure.
Совместное использование содержимого между несколькими приложениями или другими Azure службами.
Поддерживает Azure Files NFS и Azure Files SMB.
Поддерживает объекты BLOB в Azure (только для чтения).
Поддерживает до пяти точек подключения для каждого приложения.

Ограничения настраиваемого хранилища включают:

Брандмауэр хранилища поддерживается только через конечные точки службы и частные конечные точки при использовании интеграции виртуальной сети.
Доступ FTP/FTPS к пользовательскому подключенному хранилищу не поддерживается. Используйте Azure Storage Explorer.
Ключи общего доступа учетной записи хранения являются единственным средством проверки подлинности, которые поддерживаются. Entra ID и роли RBAC не поддерживаются.
поддержка Azure CLI, Azure PowerShell и Azure SDK доступна в предварительной версии.
Сопоставление / или /home с пользовательски смонтированным хранилищем не поддерживается.
Не сопоставляйте подключение хранилища с /tmp или его подкаталогами. Это действие может привести к истечении времени ожидания во время запуска приложения.
Azure Storage не поддерживается в сценариях Docker Compose.
Подключения хранилища не включаются в резервные копии. Следуйте рекомендациям по резервному копированию учетных записей Azure Storage.
Поддержка NFS доступна только для App Service on Linux. NFS не поддерживается для Windows-кода и Windows-контейнеров. Веб-приложение и учетная запись хранения должны быть настроены в одной виртуальной сети для NFS. Учетная запись хранения, используемая для файлового ресурса, должна иметь уровень производительности Premium и хранилище файлов в качестве типа аккаунта. Azure Key Vault неприменимо при использовании протокола NFS.
При интеграции виртуальной сети с приложением подключенный диск использует RFC1918 IP-адрес, а не IP-адрес из виртуальной сети.

Варианты крепления

Необходимо подключить хранилище к приложению. Ниже приведены три варианта подключения для хранилища Azure:

Вариант крепления	Использование
Основной	Выберите этот параметр, чтобы подключить хранилище с помощью портала Azure. Вы можете использовать базовый параметр, если учетная запись хранения не использует конечные точки службы service endpoints, частные конечные точки или Azure Key Vault. В этом случае портал получает и сохраняет ключ доступа для вас.
Ключ доступа	Если вы планируете подключить хранилище с помощью Azure CLI, необходимо получить ключ доступа. Выберите этот параметр, если учетная запись хранения не использует конечные точки службы service endpoints, частные конечные точки или Azure Key Vault.
Хранилище ключей	Также используйте этот параметр при планировании подключения хранилища с помощью Azure CLI, для которой требуется ключ доступа. Выберите этот параметр при использовании Azure Key Vault для безопасного хранения ключей доступа и получения ключей доступа. Azure Key Vault имеет преимущества хранения секретов приложений централизованно и безопасно с возможностью мониторинга, администрирования и интеграции с другими службами Azure, такими как Azure App Service.

Prerequisites

Существующее приложение App Service on Linux.
Учетная запись Azure Storage.
Файловое хранилище и каталог Azure.

Подготовка к монтажу

Дополнительные шаги не требуются, так как портал получает и сохраняет ключ доступа для вас.

Прежде чем подключить хранилище с помощью доступа к Key Vault, необходимо получить секрет Key Vault и добавить его как параметр в настройках вашего приложения.

На портале Azure перейдите к Key Vault. Выберите Объекты>Секреты. Скопируйте секретный идентификатор в буфер обмена.
Вернитесь в приложение, следуйте ссылке на хранилище ключей , чтобы создать параметр приложения с помощью секретного идентификатора.

Пример значения параметра приложения: @Microsoft.KeyVault(SecretUri=https://mykeyvault.vault.azure.net/secrets/mykeyvaultsecret/aaaaaaaa0b0b1c1c2d2d333333333333)

Теперь вы готовы использовать Key Vault для доступа к учетной записи хранения.

Подключение хранилища к контейнеру Linux

Способ подключения хранилища зависит от параметра доступа к хранилищу и использования портала или Azure CLI.

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Path mappings, а затем выберите Новое подключение хранилища Azure.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Basic, если учетная запись хранения не использует конечные точки сервиса service endpoints, private endpoints, или Azure Key Vault. В противном случае нажмите кнопку "Дополнительно".
Учетные записи хранения	Azure Storage учетная запись.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Azure BLOB-объекты поддерживают доступ только для чтения.
Контейнер хранилища или имя общего ресурса	Для подключения к общей папке или контейнеру BLOB-объектов.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При проверке параметры подключения хранилища также применяются к слотам развертывания.

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Сопоставления путей, а затем выберите Новое подключение к Azure Storage.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Дополнительно.
Учетные записи хранения	учетная запись хранилища Azure.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Объекты BLOB в Azure поддерживают только доступ для чтения.
Контейнер хранилища или имя общего ресурса	Для подключения к общей папке или контейнеру BLOB-объектов.
Доступ к хранилищу	Выберите ручной ввод.
Ключ доступа	Введите ключ доступа для учетной записи хранения.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

На портале Azure перейдите к приложению.
В областинавигации> слева выберите "Конфигурация параметров". Выберите Path mappings, а затем выберите Новое подключение хранилища Azure.

Настройте точку монтирования хранилища в соответствии со следующей таблицей. По завершении выберите ОК.

Настройка	Описание
Имя	Имя конфигурации подключения. Не используйте пробелы.
Варианты конфигурации	Выберите Дополнительно.
Учетные записи хранения	Учетная запись Azure Storage.
Тип хранилища	Выберите тип на основе хранилища, которое требуется подключить. Azure BLOB-объекты поддерживают только доступ для чтения.
Контейнер хранилища или имя общего ресурса	Для подключения к общей папке или контейнеру BLOB-объектов.
Доступ к хранилищу	Выберите ссылку на хранилище ключей.
Параметры приложения	Выберите существующий параметр приложения, настроенный с помощью секрета Azure Key Vault.
Путь монтирования	Каталог внутри контейнера Linux для подключения к Azure Storage. Не используйте / или /home.
Параметр слота развертывания	При выборе параметры подключения хранилища также применяются к слотам развертывания.

Чтобы получить доступ к подключенному хранилищу, предоставьте вашему приложению доступ к Key Vault.

Используйте команду az webapp config storage-account add. Рассмотрим пример.

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

--storage-type может быть AzureBlob или AzureFiles. AzureBlob доступен только для чтения.
--mount-path — это каталог в контейнере Linux для подключения к Azure Storage. Не используйте /корневой каталог.

Убедитесь, что хранилище подключено, выполнив следующую команду:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

Примечание

Добавление, редактирование или удаление подключения хранилища перезапускает приложение.

Проверка подключенного хранилища

Чтобы убедиться, что Azure Storage успешно подключено для приложения:

Откройте сеанс SSH в контейнере.
В терминале SSH выполните следующую команду:
```
df –h 
```
Проверьте, подключен ли общий ресурс хранилища. Если он отсутствует, возникла проблема с подключением разделяемого хранилища.
Проверьте задержку или общую доступность подключения хранилища с помощью следующей команды:
```
tcpping Storageaccount.file.core.windows.net 
```

Проверка работоспособности монтажа хранилища и автоматическое восстановление

Azure App Service включает встроенный механизм проверки работоспособности, чтобы обеспечить доступность и реагирование подключенных томов Azure Storage (файлов Azure или BLOB-объектов Azure). Эта система помогает предотвратить зависание приложений, вызванных устаревшими или отключенными подключениями к хранилищу.

Как работает диагностика состояния

Периодический тест ввода-вывода
Служба приложений периодически выполняет операции ввода-вывода файлов в файле маркера с именем __lastCheckTime.txt.
- Расположение: Подкаталог LogFiles в рамках подключенного пути (например, /mount/path/LogFiles/__lastCheckTime.txt).
- Поведение:
  - Предпринята попытка выполнить операцию чтения файла.
  - Файл не должен существовать— "файл не найден" рассматривается как успешная проверка.
Периодичность
По умолчанию проверка выполняется каждые 5 секунд .
Обработка сбоев
- Каждая неудачная или вышедшая по тайм-ауту проверка увеличивает счетчик неудачных пингов.
- Если сбои превышают заданное пороговое значение:
  - Azure Files: 18 неудачных pings
  - Azure BLOB: 15 неудачных пингов
- Подключение помечается сбоем, а служба приложений автоматически перезапускает приложение для восстановления подключения к общей папке.

Настройка с помощью параметров приложения

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

Тип хранилища	Название настройки	Значение по умолчанию	Описание
Azure Files	`WEBSITE_BYOS_FILES_HEALTH_CHECK_FREQUENCY`	`5`	Интервал в секундах между проверками работоспособности.
Azure Files	`WEBSITE_BYOS_FILES_MAX_FAILED_PINGS`	`18`	Число последовательных сбоев перед маркировкой тома как неисправного.
Azure Files	`WEBSITE_BYOS_FILES_AUTO_RECOVERY_ENABLED`	`true`	Установите `false` в это значение, чтобы отключить логику автоматического восстановления.
Blob Azure	`WEBSITE_BYOS_BLOB_HEALTH_CHECK_FREQUENCY`	`5`	Интервал в секундах между проверками работоспособности.
Blob Azure	`WEBSITE_BYOS_BLOB_MAX_FAILED_PINGS`	`15`	Число последовательных сбоев перед маркировкой тома как неисправного.
Blob Azure	`WEBSITE_BYOS_BLOB_AUTO_RECOVERY_ENABLED`	`true`	Установите `false` в это значение, чтобы отключить логику автоматического восстановления.
Blob Azure	`WEBSITE_BYOS_BLOB_DIRECT_IO`	`false`	При включении все транзакции будут запрашивать удаленное хранилище напрямую, а кэширование будет обходить. Этот параметр применяется на уровне приложения и поэтому влияет на все BLOB-ресурсы, подключенные к приложению.

Примечания.

Автоматическое восстановление помогает предотвратить длительные зависания приложения, вызванные неответственными путями хранения.
Не отключайте автоматическое восстановление, если не устраните неполадки с определенным поведением подключения.

Лучшие практики

Производительность

Чтобы избежать проблем с задержкой, поместите приложение и учетную запись Azure Storage в одном регионе. Если вы предоставляете доступ из IP-адресов службы приложений в конфигурации брандмауэра Azure Storage если приложение и учетная запись Azure Storage находятся в одном регионе, эти ограничения IP-адресов не учитываются.
Подключенная Azure Storage учетная запись может иметь уровень производительности "Стандартный" или "Премиум". В зависимости от требований к емкости и пропускной способности приложения выберите соответствующий уровень производительности для учетной записи хранения. См. целевые показатели масштабируемости и производительности, соответствующие типу хранилища: файлы и объекты.
Если приложение масштабируется до нескольких экземпляров, все экземпляры подключаются к одной подключенной учетной записи Azure Storage. Чтобы избежать узких мест производительности и проблем с пропускной способностью, выберите соответствующий уровень производительности для учетной записи хранения.

Безопасность

В учетной записи Azure Storage избегайте регенерации ключа доступа, используемой для подключения хранилища в приложении. Учетная запись хранения содержит два ключа. службы Azure App хранят ключ учетной записи хранения Azure. Используйте пошаговый подход, чтобы убедиться, что подключение хранилища остается доступным для приложения во время генерации ключей. Например, предположим, что вы использовали ключ 1 для настройки подключения хранилища в приложении:
1. Повторно создайте ключ2.
2. В конфигурации подключения хранилища обновите ключ доступа, чтобы использовать повторно созданный ключ key2.
3. Перегенерируйте ключ1.

Конфигурация

Если вам нужно использовать файловую систему в режиме реального времени, где при подключении хранилища необходимо быстро изменять, добавлять или удалять файлы, используйте Azure Files в качестве типа хранилища. Если файлы являются статическими и не ожидают их изменения, используйте Azure BLOB-объект.

Устранение неисправностей

Каталог подключения в пользовательском контейнере должен быть пустым. Любое содержимое, хранящееся по этому пути, удаляется при подключении Azure Storage, если указать каталог в разделе /home, например. При переносе файлов для существующего приложения создайте резервную копию приложения и его содержимого перед началом работы.
При подключении NFS-ресурса необходимо убедиться, что в учетной записи хранилища отключена опция "Требуется защищенная передача". Служба приложений не поддерживает подключение общих папок NFS при включении этого параметра. В нем используются порты 2049 и интеграция виртуальной сети и частные конечные точки в качестве меры безопасности.
Если удалить учетную запись Azure Storage, контейнер или общий доступ, удалите соответствующую конфигурацию подключения хранилища в приложении, чтобы избежать возможных сценариев ошибок.
Не используйте подключения хранилища для локальных баз данных, таких как SQLite, или для других приложений и компонентов, использующих дескрипторы и блокировки файлов.
Убедитесь, что при использовании интеграции виртуальной сети открыты следующие порты: Azure Files: 80 и 445. Azure BLOB-объекты: 80 и 443.
Если вы инициируете отказ хранилища при монтировании учетной записи хранения к приложению, монтирование не активируется, до тех пор пока приложение не будет перезапущено или пока монтирование хранилища не будет удалено и добавлено снова.

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

Установите Azure Storage как локальную общую папку в службе приложений Azure

Prerequisites

Limitations

Подготовка к монтажу

Подключение хранилища к коду Windows

Лучшие практики

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

Prerequisites

Limitations

Подготовка к монтажу

Подключение хранилища к контейнеру Windows

Лучшие практики

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

Варианты крепления

Prerequisites

Подготовка к монтажу

Подключение хранилища к контейнеру Linux

Проверка подключенного хранилища

Проверка работоспособности монтажа хранилища и автоматическое восстановление

Как работает диагностика состояния

Настройка с помощью параметров приложения

Примечания.

Лучшие практики

Производительность

Безопасность

Конфигурация

Устранение неисправностей

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

Обратная связь

Дополнительные ресурсы