Docker
Docker é uma ferramenta que lhe permite criar, implantar e gerenciar pacotes leves que contém todo o necessário para executar uma aplicação. Isto pode nos ajudar a evitar conflitos de dependências e comportamentos indesejados ao executar o Docusaurus.
Rode o servidor dentro do docker localmente
Certifique-se que você já instalou o Docker.
Para rodar o servidor local:
Construa a imagem do Docker -- Navegue até a pasta onde você instalou o Docusaurus. Depois, execute
docker build -t docusaurus-doc .
Assim que o processo for concluído, você poderá verificar se a imagem existe usando o comando
docker images
.Agora, incluímos um
Dockerfile
quando você instala o Docusaurus.Rode o contêiner do Docusaurus -- Para iniciar o Docker, use o comando
docker run --rm -p 3000:3000 docusaurus-doc
Isso iniciará um contêiner do Docker com a imagem
docusaurus-doc
. Para ver informações detalhadas do contêiner, use odocker ps
.
Usando o docker-composer
Também é possível usar o docker-compose
para configurar a nossa aplicação. Esta funcionalidade do Docker permite que você rode o servidor web e quaisquer serviços adicionais com um único comando.
Compose é uma ferramenta para definir e executar aplicações em vários serviços do Docker. Com a Compose, você usa um arquivo YAML para configurar os serviços do seu aplicativo. Em seguida, com um único comando, você cria e inicia todos os serviços a partir de sua configuração.
Usar Compor é um processo de três passos:
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.
We include a basic docker-compose.yml
in your project:
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'