Разворачивание сервиса NGINX-Static в D2C.io

Это руководство поможет вам развернуть сервис NGINX Static в Docker контейнере. Сервис используется в случаях, когда требуется развернуть какие-либо статические файлы (HTML, CSS, js). Например, мы используем этот сервис для разворачивания нашей документации основанной на mkdocs и я буду использовать этот пример для данного руководства. Данное руководство может быть полезно как начинающим, так и продвинутым разработчикам. 

Denis Zaripov

Product manager

Почему Docker?

Докер — это открытая платформа для разработки, доставки и эксплуатации приложений. Docker разработан для более быстрого выкладывания ваших приложений. С помощью docker вы можете отделить ваше приложение от вашей инфраструктуры и обращаться с инфраструктурой как управляемым приложением. Docker помогает выкладывать ваш код быстрее, быстрее тестировать, быстрее выкладывать приложения и уменьшить время между написанием кода и запуска кода. Docker делает это с помощью легковесной платформы контейнерной виртуализации, используя процессы и утилиты, которые помогают управлять и выкладывать ваши приложения.

В своем ядре docker позволяет запускать практически любое приложение, безопасно изолированное в контейнере. Безопасная изоляция позволяет вам запускать на одном хосте много контейнеров одновременно. Легковесная природа контейнера, который запускается без дополнительной нагрузки гипервизора, позволяет вам добиваться больше от вашего железа.

Ознакомиться с технологией и преимуществами можно в оригинальной статье Docker, либо с переводом на русский язык вступительной статьи документации.

Подготовка

Будет проще начать, если у вас уже есть подключенный сервер. 

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

Создание сервиса NGINX+Static

Для начала, потребуется открыть или создать любой проект и нажать «+Создать сервис». Вы увидите список нативно поддерживаемых сервисов, которые можно развернуть с помощью D2C. Нажимаем на плитку NGINX+Static

Создание сервиса NGINX+Static. Настройки сервиса

Name
Имя должно начинаться с буквы и содержать не более 16 символов (допускаются латинские символы и цифры). У каждого сервиса есть своё уникальное имя. Сервисы могут обращаться друг к другу по имени контейнера (например, joey-1) или по alias-именам (например,  joey). Имена сервисов также используются для создания публичных доменов таких как: [servicename]-[www].[accountID].[at].d2c.io при их обслуживании сервисами NGINX или HAProxy. Про эти сервисы у нас написаны отдельные статьи.
Version

Вы можете выбрать версию для вашего приложения из списка:

Preinstall
Если вашему приложению требуется node.js или его модули — вы можете установить их, отметив нужные вам чекбоксы.
Global dependencies

В этом поле вы можете указать комманды для установки глобальных зависимостей и модификации Docker образа вашего сервиса. Для модификации исходного кода используйте локальные зависимости (Local dependencies)

Примеры: pip installbundle installapt-get installnpm install -g

Создание сервиса NGINX+Static. Исходный код

Git

Вы можете выбрать что использовать для получения исходников приложения. Git является рекомендуемым вариантом. Если вы используете приватный репозиторий, вы должны добавить SSH ключ в ваш аккаунт (инструкции к GitHubBitBucketGitLab). Кроме SSH ключей можно также использовать Логин/Пароль, но это нерекомендуемый способ.

Download

Альтернативный метод — скачивание исходного кода с внешнего ресурса.

Протоколы: httphttpsftp (для закрытых ftp требуется указать логин/пароль).

Форматы файлов: .tar.bz2.tar.gz.tar.zip

Upload

Можно загрузить исходный код с вашего устройства.

Форматы файлов: .tar.bz2.tar.gz.tar.zip

Максимальный размер: 50MB

Создание NGINX+Static сервиса. Порты 

Это важная часть создания сервиса.

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

Доступ из Интернета (Access from the Internet) по умолчанию отключен (кроме edge сервисов). Вы можете включить доступ из интернета во время создания или редактирования сервиса. Например, если вы развернули сервис на 3000 порту — он будет доступен по адресу ip_адрес_сервера:8000.

В этом примере, я включил Доступ из Интернета для быстрого тестирования приложения. NGINX+Static не может обслуживать HTTPS, а также использовать кастомные домены. Если это вам требуется — используйте edge сервисы NGINX или HAProxy. По этим сервисам у нас есть отдельные руководства.

Создание NGINX+Cluster сервиса. Настройки приложения

Local dependencies and code’s preparation

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

Примеры: npm installcomposer installbower install, и т.д. или для подготовки: gulp buildgrunt build, и т.д.

Initial commands
Команды, которые выполняются один раз после разворачивания сервиса. Например, могут использоваться команды для наполнения или миграции базы данных. 
Environment variables

Переменные окружения для вашего приложения. Могут редактироваться после создания сервиса.

Создание NGINX+Static сервиса. Дополнительные настройки. Постоянное хранилище

Нажмите на кнопку «Show advanced settings«.

Первый блок в этом разделе — Постоянное хранилище (Persistent data volumes).

D2C разделяет приложение от данных приложения. Docker volumes используются для хранения постоянных данных. Данные хранятся локально на серверах. Данные, которые генерируются приложением должны быть добавлены в Постоянное хранилище. Все изменения вне директорий постоянного хранилища сбрасываются после рестарта/пересборки/редеплое контайнера/сервиса (Docker восстанавливает оригинальное состояние контейнера после этих действий).

Мы рекомендуем хранить пользовательские данные (user generated content) в таких облачных хранилищах как Amazon S3 или CDN. Иногда появляется необходимость поддержки старых технологий, когда данные хранятся на серверах. Для таких случаях в D2C предусмотрена синхронизация Постоянного хранилища (Volumes) между всеми контейнерами приложения. Для того чтобы включить синхронизацию необходимо отметить галочкой директории, которые нужно синхронизировать.

Создание NGINX+Static сервиса. Дополнительные настройки. Конфиги

В D2C для NGINX создается стандартный конфиг nginx.conf. Вы можете его изменить используя кнопку «Edit«. Mkdocs собирает статические файлы в директории /site по умолчанию и нам нужно указать это в root. На картинке это третья строчка.

Нажмите на кнопку “Generate new config” если требуется восстановить конфиг до стандартного.

Вы можете добавлять дополнительные конфиг файлы. Эти файлы не изменяются после рестарта/пересборки/редеплое ваших приложений. 

Нажмите «+Добавить пользовательский конфиг» и укажите полный путь к файлу.

Кнопка «Сгенерировать новый конфиг«, в этом случае, удалит всё содержимое.

Создание сервиса NGINX+Cluster. Выбор серверов

Вы можете выбрать один или несколько серверов, на которых будут развернуты одинаковые контейнеры. Необязательно выбирать несколько серверов с самого начала — масштабировать сервисы после разворачивания. Кроме этого, на этом шаге вы можете создавать сервера и выбирать те, которые ещё не в статусе «Онлайн». Контенейнеры будут развернуты после того, как сервера будут готовы.

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

Что дальше?

В следующей статье мы поговорим о:

  • Создании edge сервиса для сервисов приложений и добавлении вашего домена с бесплатным TLS сертификатом от Let’s Encrypt.for application
  • Масштабировании, балансировке, обновлении исходников, проверке логов и метрик контейнеров