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를 실행하여 이미지가 존재하는지 확인할 수 있습니다.

이제 Docusaurus를 설치할 때 Dockerfile이 포함됩니다.
Run the Docusaurus container -- To start docker run docker run --rm -p 3000:3000 docusaurus-doc

docusaurus-doc 이미지 docker 컨테이너가 시작될 것입니다. 컨테이너에 대한 자세한 정보를 확인하려면 다음 명령을 입력 하세요: 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를 사용하여 애플리케이션을 설정할 수도 있습니다. 이 기능은 한 번의 명령으로 웹서버와 다른 부가 서비스들을 시작할 수 있게 합니다.

Compose는 다중-컨테이너 Docker 애플리케이션을 정의하고 실행하기 위한 도구입니다. Compose는 YAML 파일을 사용하여 애플리케이션의 서비스를 구성합니다. 그렇게 하면 한번의 명령으로 당신은 모든 서비스들을 만들고 시작할 수 있습니다.

Compose를 사용하기 위한 세 단계:

Define your app’s environment with a Dockerfile so it can be reproduced anywhere.
Define the services that make up your app in docker-compose.yml so they can be run together in an isolated environment.
Run docker-compose up and Compose starts and runs your entire app.

프로젝트에는 기본적인 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

To run a local web server with docker-compose run docker-compose up.

To build static HTML pages for publishing run docker-compose run docusaurus bash -c 'yarn publish-gh-pages'