Docker · Docusaurus

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

Запуск локального веб-сервера в Docker

Убедитесь, что docker уже установлен.

Для запуска локального веб-сервера:

Build the docker image -- Enter the folder where you have Docusaurus installed. Выполните в терминале docker build -t docusaurus-doc .

Когда снимок будет создан, вы может проверить, что он существует, выполнив docker images.

Dockerfile будет добавлен в каталог проекта при установке Docusaurus.
Run the Docusaurus container -- To start docker run docker run --rm -p 3000:3000 docusaurus-doc

В результате docker создаст и запустит контейнер на основе снимка docusaurus-doc. Чтобы увидеть подробную информацию о контейнере, выполните в терминале docker ps.

To access Docusaurus from outside the docker container you must add the --host flag to the docusaurus-start command as described in: API Commands

Использование docker-compose

Также для настройки приложения можно использовать docker-compose. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.

Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.

Использование Compose происходит в три шага:

Определите окружение вашего приложения с помощью Dockerfile, после чего оно может быть воспроизведено где угодно.
Определите сервисы, которые будут включены в ваше приложение в файле docker-compose.yml, после чего они могут быть запущены вместе в изолированном окружении.
Выполните docker-compose up, чтобы Compose запустил целиком ваше приложение.

Мы добавляем файл docker-compose.yml с минимальными настройками в ваш проект:

version: '3'

services:
  docusaurus:
    build: .
    ports:
      - 3000:3000
      - 35729:35729
    volumes:
      - ./docs:/app/docs
      - ./website/blog:/app/website/blog
      - ./website/core:/app/website/core
      - ./website/i18n:/app/website/i18n
      - ./website/pages:/app/website/pages
      - ./website/static:/app/website/static
      - ./website/sidebars.json:/app/website/sidebars.json
      - ./website/siteConfig.js:/app/website/siteConfig.js
    working_dir: /app/website

Чтобы запустить локальный веб-сервер с помощью docker-compose выполните в терминале docker-compose up.

Чтобы создать статические HTML страницы для публикации, выполните docker-compose run docusaurus bash -c 'yarn publish-gh-pages'