Translate

Docker

Docker est un outil qui vous permet de créer, déployer et gérer des paquets légers et autonomes qui contiennent tout ce qui est nécessaire pour exécuter une application. Il peut aider à éviter les dépendances conflictuelles et les comportements indésirables lors de l'exécution de Docusaurus.

Exécuter le serveur web local dans docker

Assurez-vous d'avoir installé docker.

Pour exécuter le serveur web local :

1. Build the docker image -- Enter the folder where you have Docusaurus installed. Exécutez build docker -t docusaurus-doc .

   Une fois la phase de construction terminée, vous pouvez vérifier que l'image existe en exécutant docker images.

   Nous incluons maintenant un Dockerfile lorsque vous installez Docusaurus.

2. Run the Docusaurus container -- To start docker run docker run --rm -p 3000:3000 docusaurus-doc

   Ceci démarrera un conteneur docker avec l'image docusaurus-doc. Pour voir plus d'informations détaillées sur les conteneurs, exécutez 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

Utiliser docker-compose

Nous pouvons également utiliser docker-compose pour configurer notre application. Cette fonctionnalité de docker vous permet d'exécuter le serveur web et tout autre service avec une seule commande.

Compose est un outil pour définir et exécuter les applications Docker multi-conteneurs. Avec Compose, vous utilisez un fichier YAML pour configurer les services de votre application. Ensuite, avec une seule commande, vous créez et démarrez tous les services de votre configuration.

L'utilisation de Compose est un processus à trois étapes :

1. Définissez l'environnement de votre application avec un Dockerfile pour qu'il puisse être reproduit n'importe où.

2. Définissez les services qui composent votre application dans docker-compose.yml afin qu'ils puissent être exécutés ensemble dans un environnement isolé.

3. Exécutez docker-compose et Compose démarre et exécute toute votre application.

Nous incluons un docker-compose.yml de base dans votre projet :

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

Pour exécuter un serveur web local avec docker-compose, exécutez docker-compose up.

Pour construire des pages HTML statiques, exécutez docker-compose run docusaurus bash -c 'yarn publish-gh-pages'