Размещение статического веб-сайта в службе хранилища Azure

2025-04-03

Статический контент (HTML, CSS, JavaScript и файлы изображений) можно получать непосредственно из контейнера в учетной записи общего назначения V2 или BlockBlobStorage. Дополнительные сведения см. в статье " Размещение статических веб-сайтов в службе хранилища Azure".

В этой статье показано, как включить размещение статических веб-сайтов с помощью портала Azure, Azure CLI или PowerShell.

Включите размещение статических веб-сайтов

Размещение статических веб-сайтов — это функция, которую необходимо включить в учетной записи хранения.

Чтобы приступить к работе, войдите на портал Azure .
Найдите учетную запись хранения и выберите ее, чтобы отобразить панель обзора учетной записи.
На панели "Обзор " выберите вкладку "Возможности ". Затем выберите статический веб-сайт , чтобы отобразить страницу конфигурации для статического веб-сайта.
Выберите "Включено" , чтобы включить размещение статических веб-сайтов для учетной записи хранения.
В поле имени документа индекса укажите страницу индекса по умолчанию (например, index.html).

Страница индекса по умолчанию отображается при переходе пользователя к корню статического веб-сайта.
В поле пути к документу ошибки укажите страницу ошибок по умолчанию (например, 404.html).

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

Вы можете включить размещение статических веб-сайтов с помощью Azure CLI.

Сначала откройте Azure Cloud Shell или, если вы установили Azure CLI локально, откройте командное консольное приложение (например, Windows PowerShell).
Если ваше удостоверение личности связано с несколькими подписками, установите активную подписку для учетной записи хранения данных, в которой будет размещен статический веб-сайт.
```
az account set --subscription <subscription-id>
```
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Включите хостинг статических веб-сайтов.
```
az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
```
- Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
- Замените заполнитель <error-document-name> именем документа об ошибке, который будет отображаться пользователям, когда браузер запрашивает страницу на вашем сайте, которая не существует.
- Замените плейсхолдер <index-document-name> именем документа индекса. Этот документ обычно называется "index.html".

Вы можете включить размещение статических веб-сайтов с помощью модуля Azure PowerShell.

Откройте командное окно Windows PowerShell.
Убедитесь, что у вас есть модуль Azure PowerShell az версии 0.7 или более поздней.
```
Get-InstalledModule -Name Az -AllVersions | select Name,Version
```
Если вам необходимо выполнить установку или обновление, см. статью об установке модуля Azure PowerShell.
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
```
Connect-AzAccount
```
Если ваше удостоверение личности связано с несколькими подписками, установите активную подписку для учетной записи хранения данных, в которой будет размещен статический веб-сайт.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Получите контекст учетной записи хранения, который определяет учетную запись хранения, которую вы хотите использовать.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.
- Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
Включите хостинг статических веб-сайтов.
```
Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
```
- Замените заполнитель <error-document-name> именем документа об ошибке, который будет отображаться пользователям, когда браузер запрашивает страницу на вашем сайте, которая не существует.
- Замените плейсхолдер <index-document-name> именем документа индекса. Этот документ обычно называется "index.html".

Отправить файлы

В следующих инструкциях показано, как отправлять файлы с помощью портала Azure. Вы также можете использовать AzCopy, PowerShell, CLI или любое пользовательское приложение, которое может отправлять файлы в контейнер $web учетной записи. Пошаговое руководство по отправке файлов с помощью кода Visual Studio см. в руководстве по размещению статического веб-сайта в хранилище BLOB-объектов.

На портале Azure перейдите к учетной записи хранения, содержащей статический веб-сайт. Выберите контейнеры в области навигации слева, чтобы отобразить список контейнеров.
В области "Контейнеры " выберите контейнер $web , чтобы открыть панель обзора контейнера.
В области Обзор выберите значок Загрузить, чтобы открыть панель Загрузить объект BLOB. Затем выберите поле «Файлы» на панели «Отправка BLOB-объектов», чтобы открыть обозреватель файлов. Перейдите к файлу, который нужно отправить, выберите его, а затем нажмите кнопку "Открыть ", чтобы заполнить поле "Файлы ". При необходимости установите флажок "Перезаписать", если файлы уже существуют .
Если вы намерены отобразить содержимое файла в браузере, убедитесь, что для этого файла задан text/htmlтип контента. Чтобы проверить это, выберите имя BLOB-объекта, загруженного на предыдущем шаге, чтобы открыть панель обзора. Убедитесь, что значение задано в поле свойства CONTENT-TYPE .

Примечание.

Это свойство автоматически устанавливается на text/html для распространённых и общепризнанных расширений, таких как .html. Однако в некоторых случаях вам придется установить это самостоятельно. Если это свойство text/htmlне задано, браузер предложит пользователям скачать файл вместо отображения содержимого. Это свойство можно задать на предыдущем шаге.

Отправьте объекты в контейнер $web из исходного каталога.

В этом примере предполагается, что вы выполняете команды из сеанса Azure Cloud Shell.

az storage blob upload-batch -s <source-path> -d '$web' --account-name <storage-account-name>

Примечание.

Если браузер предложит пользователям скачать файл вместо отрисовки содержимого, можно добавить --content-type 'text/html; charset=utf-8' в команду.

Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
Замените <source-path> заполнитель на путь к расположению файлов, которые требуется загрузить.

Примечание.

Если вы используете локальную установку Azure CLI, вы можете использовать путь к любому расположению на локальном компьютере (например: C:\myFolder.

Если вы используете Azure Cloud Shell, вам придется ссылаться на общую папку, которая отображается в Cloud Shell. Это местоположение может быть общим доступом к файлам облачного ресурса или существующей общей папкой, которую вы монтируете с помощью Cloud Shell. Чтобы узнать, как это сделать, см. статью "Персистентное хранение файлов в Azure Cloud Shell".

Отправьте объекты в контейнер $web из исходного каталога.

# upload a file
set-AzStorageblobcontent -File "<path-to-file>" `
-Container `$web `
-Blob "<blob-name>" `
-Context $ctx

Примечание.

Если браузер предложит пользователям скачать файл вместо отрисовки содержимого, можно добавить -Properties @{ ContentType = "text/html; charset=utf-8";} в команду.

Замените заполнитель <path-to-file> на полный путь к файлу, который требуется загрузить (например: C:\temp\index.html).
Замените значение заполнителя <blob-name> на имя, которым вы хотите назвать получаемый большой двоичный объект — например, index.html.

Поиск URL-адреса веб-сайта

Страницы сайта можно просмотреть из браузера с помощью общедоступного URL-адреса веб-сайта.

Выберите статический веб-сайт на панели, которая отображается рядом со страницей обзора вашей учетной записи хранения. URL-адрес сайта отображается в поле первичной конечной точки .

Метрика метрик статических веб-сайтов службы хранилища Azure

Найдите общедоступный URL-адрес статического веб-сайта с помощью следующей команды:

az storage account show -n <storage-account-name> -g <resource-group-name> --query "primaryEndpoints.web" --output tsv

Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.

Найдите общедоступный URL-адрес статического веб-сайта с помощью следующей команды:

 $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>"
Write-Output $storageAccount.PrimaryEndpoints.Web

Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.
Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.

Включение метрик на страницах статических веб-сайтов

После включения метрик статистика трафика файлов в контейнере $web будет отображаться на панели мониторинга метрик.

Щелкните Метрики в разделе Монитор меню учетной записи хранилища.

Примечание.

Данные метрик создаются путем подключения к различным API метрик. На портале отображаются только члены API, используемые в течение заданного интервала времени, чтобы сосредоточиться только на элементах, возвращающих данные. Чтобы убедиться, что вы сможете выбрать необходимый элемент API, первым шагом является расширение интервала времени.
Нажмите кнопку интервала времени, выберите интервал времени и нажмите кнопку "Применить".
Выберите Blob из раскрывающегося списка пространства имен.
Затем выберите метрику исходящего трафика .
Выберите Сумма в селекторе агрегирования.
Нажмите кнопку "Добавить фильтр " и выберите имя API из селектора свойств .
Установите флажок рядом с GetWebContent в селекторе значений , чтобы заполнить отчет метрик.

Примечание.

Флажок GetWebContent отображается только в том случае, если этот элемент API использовался в заданный интервал времени. На портале отображаются только члены API, используемые в течение заданного интервала времени, чтобы сосредоточиться только на элементах, возвращающих данные. Если в этом списке не удается найти определенный член API, разверните интервал времени.