Mkdocs

Intallation MkDocs

Tout d'abord, il faudra installer le paquet "pip"

sudo apt install pip

Ensuite installer MkDocs

 pip install MkDocs

Après l'installation, dans votre répertoire de travail, exécutez la commande suivante pour initialiser un site :

mkdocs new mkdocspro

Ensuite placer vous dans le dossier :

cd mkdocspro

Ensuite faite cette commande pour savoir l'url du site :

mkdocs serve

Si tous est fait correctement vous devriez arriver sur une page comme celle ci !

Installation Docker par script

Sur le GitLab du département : Lien GitLab

Dans la barre de recherche taper "ansible localhost"

Cloner sur votre Vm le dépôt.

Ensuite aller dans ce dossier et faite :

 sudo ansible-galaxy install -f -r requirements.yml

  sudo sudo ansible-playbook  pb_install_docker.yml

Héberger le site avec Nginx avec un dockerfile

Créer un dépôt sur git et le cloner

Pour ce faire aller voir La mission du 24.05 !

Mettre le contenu de MkDocs dans le dépôt

Il faudra faire :

mv <nom du fichier> <la destination>

Création du Dockerfile

Il faudra créer un "Dockerfile" dans le dépôt précedemment crée

vim Dockerfile

Une fois créer il faudra insérer ceci :

FROM nginx:latest

# Copiez les fichiers générés de MkDocs dans le répertoire du serveur Nginx
COPY site /usr/share/nginx/html

# Copiez la configuration Nginx personnalisée
COPY nginx.conf /etc/nginx/conf.d/default.conf

Création du fichier conf Nginx

Il faudra crée ce fichier toujours dans le dépôt

vim nginx.conf

Une fois créer il faudra insérer ceci :

server {
    listen 80;
    server_name localhost;

    location / {
        root /usr/share/nginx/html;
        index index.html;
    }
}

Création de l'image Docker

Pour construire l'image il faudra taper cette commande :

docker build -t monsite-mkdocs .

Il vous suffira d'éxécuter le conteneur :

docker run -d -p 8080:0 monsite-mkdocs

Si tous est fait correctement vous devriez arriver sur une page comme celle ci ! Et votre site est héberger sur un docker nginx

Héberger le site avec Nginx avec docker-compose

Tout d'abord supprimer le fichier "Dockerfiles"

Ensuite dans le dépôt, il faudra créer le fichier "docker-compose.yml" et mettre ceci :

version: '3'

services:
  nginx-server:
    container_name: nginx  #Son nom
    #restart: always    #Il reste toujours allumer
    image: nginx:latest
    ports:
      - 8080:80
    volumes:
     ## - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./site:/usr/share/nginx/html

Si tous est fait correctement vous devriez arriver sur une page comme celle ci ! Et votre site est héberger sur un docker nginx en permanance

Bonus

Installer un navigateur en ligne de commande

Faite un :

sudo apt install lynx

Pour l'utiliser par exemple "Google ":

lynx https://google.com

Répondez "A" aux questions qu'il vous pose.

Et voilà vous avez un navigateur internet en ligne de commande