Разместить статический веб-сайт

В публичном бакете S3 вы можете:

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

Разместить статический веб-сайт

Статические сайты состоят из набора файлов (HTML, JS, графики, шрифтов), которые можно хранить в виде объектов в бакете. Сайт будет открываться по адресу публичного домена бакета или пользовательского домена, если он добавлен к бакету.

Есть два способа размещения веб-сайта:

хостинг — вы указываете главную страницу веб-сайта, которая хранится в виде объекта в публичном бакете;
веб-листинг — вместо отображения главной страницы вы включаете возвращение списка объектов в бакете и задаете свои CSS-стили.

Настроить хостинг

В бакет загрузите объект — HTML-файл, который будет главной страницей.
В панели управления в верхнем меню нажмите Продукты и выберите S3.
Перейдите в раздел Бакеты.
Откройте страницу бакета → вкладка Веб-сайт.
В блоке Веб-сайт включите тумблер.
Откройте вкладку Хостинг.
Введите путь до объекта с главной страницей с расширением .html.
Нажмите Сохранить.

Настроить веб-листинг

Если вы хотите хранить файл с CSS-стилями в бакете, загрузите его.
В панели управления в верхнем меню нажмите Продукты и выберите S3.
Перейдите в раздел Бакеты.
Откройте страницу бакета → вкладка Веб-сайт.
В блоке Веб-сайт включите тумблер.
Откройте вкладку Веб-листинг.
Введите адрес файла с CSS-стилями. Формат адреса зависит от того, где хранится файл:
- в бакете — введите путь до объекта с CSS-стилями;
- на стороннем ресурсе — введите URL-адрес файла с CSS-стилями.
Нажмите Сохранить.

Настроить страницу ошибки

Если пользователи будут обращаться к несуществующему объекту, возникнет ошибка, которую можно обрабатывать двумя способами:

возвращать другой объект из бакета;
выполнять переадресацию запроса на внешний URL.

Возвращать объект из бакета

В панели управления в верхнем меню нажмите Продукты и выберите S3.
Перейдите в раздел Бакеты.
Откройте страницу бакета → вкладка Веб-сайт.
В блоке Страница ошибки включите тумблер.
Опционально: если вы хотите, чтобы объект возвращался с кодом 200, выберите его в качестве кода ответа. По умолчанию ответ на запрос будет с кодом 400.
В поле Ресурс введите путь до объекта со страницей ошибки с расширением .html.
Нажмите Сохранить.

Выполнять переадресацию запроса

В панели управления в верхнем меню нажмите Продукты и выберите S3.
Перейдите в раздел Бакеты.
Откройте страницу бакета → вкладка Веб-сайт.
В блоке Страница ошибки включите тумблер.
Выберите код ответа 307.
В поле Ресурс введите валидный внешний URL, на который будет выполнена переадресация, если запрашиваемый объект отсутствует.
Нажмите Сохранить.

Пути до объектов

При размещении статического веб-сайта или настройке страницы ошибки потребуется ввести путь до объекта в бакете — абсолютный или относительный.

Абсолютный путь

Абсолютный путь всегда начинается с символа / и указывается в формате /<prefix>/<object_name>, где:

<prefix> — префикс (путь до объекта) — при наличии;
<object_name> — имя объекта с расширением.

Если указан абсолютный путь, при запросе объекта логика хранилища будет всегда искать его относительно корня бакета — по адресу <uuid>.selstorage.ru/<bucket_name>. Если в запросе после имени бакета есть префикс, он будет проигнорирован.

Если указать некорректный путь, объект не будет возвращен.

примечание

Например, если полный адрес объекта <uuid>.selstorage.ru/bucket/prefix/file.html, в качестве пути вы указали /prefix/file.html и запрос выполняется по адресу <uuid>.selstorage.ru/bucket/prefix/, объект будет возвращен.

Относительный путь

Относительный путь никогда не начинается с символа / и указывается в формате <prefix>/<object_name> или <object_name>, где:

<prefix>/ — опционально: префикс (путь до объекта);
<object_name> — имя объекта с расширением.

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

примечание

Например, если полный адрес объекта <uuid>.selstorage.ru/bucket/prefix/file.html, в качестве пути вы указали file.html и запрос выполняется по адресу <uuid>.selstorage.ru/bucket/prefix/, объект будет возвращен.

примечание

Например, если полный адрес объекта <uuid>.selstorage.ru/bucket/prefix/file.html, в качестве пути вы указали prefix/file.html и запрос выполняется по адресу <uuid>.selstorage.ru/bucket/prefix/, объект не будет возвращен, потому что логика хранилища будет искать объект по несуществующему адресу <uuid>.selstorage.ru/bucket/prefix/prefix/file.html.