Translate

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:

1. Build the docker image -- Enter the folder where you have Docusaurus installed. 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.

2. Run the Docusaurus container -- To start docker run 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 o 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

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:

1. Define your app’s environment with a Dockerfile so it can be reproduced anywhere.

2. Define the services that make up your app in docker-compose.yml so they can be run together in an isolated environment.

3. 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'