Хостинг статических сайтов

Хостинг статических сайтов (static site hosting) — дополнительная опция для бакета VK Object Storage, которая расширяет возможности доступа к статическому контенту. Без этой опции для получения содержания объекта используется URL, соответствующий его ключу. Хостинг статических сайтов позволяет комбинировать статический контент с правилами перенаправления, а также задавать индексную страницу (например, index.html) и страницу ошибки, возвращаемую при ошибках запроса (например, 404).

Примеры использования:

• сайт-визитка,
• личный блог,
• лендинги,
• перенаправление запросов,
• документация.

Статический сайт на основе VK Object Storage может состоять из:

• статического контента: HTML, CSS, файлы медиа (изображения, аудио, видео), документы (PDF, TXT) и другие форматы, доступные для просмотра в браузере.
• файлов сценариев (скриптов) на JavaScript, не требующих серверной обработки: раскрывающиеся меню, табы, аккордеоны и др.

После установки конфигурации, cтатический сайт доступен по адресу:

 
https://<ИМЯ_БАКЕТА>.hb-website.<ENDPOINT_HOSTNAME>/<PREFIX>

Здесь:

• <ИМЯ_БАКЕТА> — имя бакета, для которого была установлена конфигурация статического сайта;

• <ENDPOINT_HOSTNAME> — имя хоста сервиса VK Object Storage, должен соответствовать региону аккаунта:

  • hb.vkcloud-storage.ru или hb.ru-msk.vkcloud-storage.ru — домен региона Москва;
  • hb.kz-ast.vkcloud-storage.ru — домен региона Казахстан.

• <PREFIX> — префикс ключа объекта индексной страницы. Может быть пустым.

Конфигурация предоставляется в формате JSON и используется при управлении конфигурацией через AWS CLI.

Общая структура конфигурации:

 
{   "IndexDocument": {           // Индексная страница      "Suffix": "string"   },   "ErrorDocument": {           // Страница ошибки      "Key": "string"   },   "RoutingRules": [            // Правила перенаправления      {          "Condition": {              "HttpErrorCodeReturnedEquals": "string",         "KeyPrefixEquals": "string"         },         "Redirect": {             "HostName": "string",         "HttpRedirectCode": "string",         "Protocol": "http"|"https",         "ReplaceKeyPrefixWith": "string",         "ReplaceKeyWith": "string"         }      }   ...   ],    "RedirectAllRequestsTo": {   // Безусловное перенаправление всех запросов    "HostName": "string",    "Protocol": "http"|"https"    }}

IndexDocument — элемент конфигурации, который задает индексную страницу.

Совместимость IndexDocument с другими элементами конфигурации:

Параметры IndexDocument:

ErrorDocument — элемент конфигурации, который задает страницу ошибки. Используется вместе с элементом конфигурации IndexDocument, который задает индексную страницу.

Например, при открытии несуществующей страницы возникнет ошибка 404. Вместо несуществующей страницы загрузится содержание указанного объекта, например errordoc/file.html.

Совместимость ErrorDocument с другими элементами конфигурации:

Параметры ErrorDocument:

RoutingRules — элемент конфигурации, который задает правила перенаправления. Используется вместе с элементом конфигурации IndexDocument, который задает индексную страницу.

Совместимость RoutingRules с другими элементами конфигурации:

Параметры RoutingRules:

RedirectAllRequestsTo — элемент конфигурации, который задает безусловные правила перенаправления для всех запросов сайта.

Совместимость RedirectAllRequestsTo с другими элементами конфигурации:

Параметры RedirectAllRequestsTo:

Некоторые параметры несовместимы друг с другом, поэтому число их комбинаций ограничено.

• Только индексная страница IndexDocument:

   
  {    "IndexDocument": {    "Suffix": "index.html"    }}

• Индексная страница IndexDocument и страница ошибки ErrorDocument:

   
  {    "IndexDocument": {    "Suffix": "index.html"    },    "ErrorDocument": {    "Key": "error.html"    }}

• Индексная страница IndexDocument и правила перенаправления RoutingRules:

   
  {    "IndexDocument": {    "Suffix": "index.html"    },    "RoutingRules": [    {        "Condition": {        "KeyPrefixEquals": "docs/"        },        "Redirect": {        "ReplaceKeyPrefixWith": "documents/",        "HttpRedirectCode": "301"        }    }    ]}

  В приведенном примере все запросы с префиксом docs/ будут перенаправляться на documents/ и возвращать HTTP-код ответа 301.

• Индексная страница IndexDocument, страница ошибки ErrorDocument и правила перенаправления RoutingRules:

   
  {    "IndexDocument": {    "Suffix": "index.html"    },    "ErrorDocument": {    "Key": "error.html"    },    "RoutingRules": [    {        "Condition": {        "HttpErrorCodeReturnedEquals": "404"        },        "Redirect": {        "ReplaceKeyWith": "index.html",        "HttpRedirectCode": "302"        }    }    ]}

  В приведенном примере при HTTP-ошибке 404 запрос перенаправляется на index.html, при других ошибках возвращается содержимое error.html.

• Безусловное перенаправление RedirectAllRequestsTo для всех запросов:

   
  {    "RedirectAllRequestsTo": {    "HostName": "example.com",    "Protocol": "https"    }}

  В приведенном примере все запросы перенаправляются на example.com по протоколу https. В ответе всегда возвращается код 301.