Docker
Docker는 애플리케이션을 실행하는데 필요한 모든 것을 포함한 경량의 독립 실행형 패키지를 만들고, 배포하고, 관리할 수 있도록 만드는 도구입니다. 그것은 Docusaurus를 실행할 때 의존성으로 인한 충돌 & 원하지 않는 동작을 예방할 수 있게 합니다.
Docker로 로컬 웹서버 실행하기
docker가 사전에 설치되어 있어야 합니다.
로컬 웹서버 실행하기
docker 이미지 빌드 -- Docusaurus가 설치된 폴더에서 다음 명령을 실행합니다:
docker build -t docusaurus-doc .
빌드가 완료되면, 당신은
docker images
를 실행하여 이미지가 존재하는지 확인할 수 있습니다.이제 Docusaurus를 설치할 때
Dockerfile
이 포함됩니다.Docusaurus 컨테이너 실행하기 -- 도커를 시작하려면 다음 명령을 입력하세요:
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'