Mercredi 1er avril 2020 (Modifié le Mercredi 1er avril 2020)

Snapshot vmbust 2020-03-31

suppression ocsp

mv ssl_dh_header_ocsp ssl_dh_header
dans les fichiers de configuration , fichier include ssl_dh_header;
Regénérer les certificats sans ocsp

#acme.sh --dns dns_ovh --issue --ocsp --keylength ec-384 -d 'ouestline.xyz' -d '*.ouestline.xyz'
acme.sh --dns dns_ovh --issue --keylength ec-384 -d 'ouestline.xyz' -d '*.ouestline.xyz'

node.js npm nvm yarn

Archlinux Debian , installation des paquets node.js npm nvm yarn

node.js

# dernière version
sudo apt-get install curl software-properties-common
curl -sL https://deb.nodesource.com/setup_12.x | sudo bash -
sudo apt-get install nodejs

yarn

sudo npm install yarn -g

Docusaurus

Docusaurus a été conçu dès le départ pour être facilement installé et utilisé afin de rendre votre site web rapidement opérationnel.

Installation de Docusaurus

Nous avons créé un script utile qui vous permettra de mettre en place toute l’infrastructure nécessaire :

1-Assurez-vous d’avoir installé la dernière version de Node. Nous vous recommandons également d’installer Yarn.

Version node -v : v12.16.1
Version yarn : yarn -v : 1.22.4

2-Créez un projet, s’il n’existe pas, et changez votre répertoire à la racine de ce projet.

sudo mkdir -p /srv/docusaurus
sudo chown $USER.$USER -R /srv/docusaurus
cd /srv/docusaurus

Vous créerez les documents dans ce répertoire. Le répertoire racine peut contenir d’autres fichiers. Le script d’installation de Docusaurus créera deux nouveaux répertoires : docs et website.

En général, votre site Docusaurus se trouve dans un projet GitHub existant ou nouvellement créé, mais ce n’est pas obligatoire pour utiliser Docusaurus.

3-Exécutez le script d’installation de Docusaurus : npx docusaurus-init

Si vous n’avez pas le Node 8.2+ ou si vous préférez installer Docusaurus globalement, lancez le fil global add docusaurus-init ou npm install –global docusaurus-init. Après cela, lancez docusaurus-init.

Vérification de l’installation

En plus des fichiers et des répertoires existants, votre répertoire racine contiendra désormais une structure similaire :

docusaurus
├── Dockerfile
├── docker-compose.yml
├── docs
│   ├── doc1.md
│   ├── doc2.md
│   ├── doc3.md
│   ├── exampledoc4.md
│   └── exampledoc5.md
└── website
    ├── README.md
    ├── blog
    │   ├── 2016-03-11-blog-post.md
    │   ├── 2017-04-10-blog-post-two.md
    │   ├── 2017-09-25-testing-rss.md
    │   ├── 2017-09-26-adding-rss.md
    │   └── 2017-10-24-new-version-1.0.0.md
    ├── core
    │   └── Footer.js
    ├── package.json
    ├── pages
    │   └── en
    │       ├── help.js
    │       ├── index.js
    │       └── users.js
    ├── sidebars.json
    ├── siteConfig.js
    ├── static
    │   ├── css
    │   │   └── custom.css
    │   └── img
    │       ├── favicon.ico
    │       ├── oss_logo.png
    │       ├── undraw_code_review.svg
    │       ├── undraw_monitor.svg
    │       ├── undraw_note_list.svg
    │       ├── undraw_online.svg
    │       ├── undraw_open_source.svg
    │       ├── undraw_operating_system.svg
    │       ├── undraw_react.svg
    │       ├── undraw_tweetstorm.svg
    │       └── undraw_youtube_tutorial.svg
    └── yarn.lock

Cette installation crée certains fichiers Docker qui ne sont pas nécessaires pour exécuter docusaurus. Ils peuvent être supprimés sans problème dans un souci d’économie d’espace. Pour plus d’informations sur le Docker, veuillez consulter la documentation du Docker.

Exécution du site web d’exemple

Après avoir exécuté le script d’initialisation de Docusaurus, docusaurus-init, comme décrit dans la section Installation, vous disposerez d’un site web d’exemple exécutable à utiliser comme base de votre site. A exécuter :

1- cd site web

2-Depuis le répertoire du site web, lancez le serveur web local en utilisant yarn start ou npm start.

cd /srv/docusaurus/website/
yarn start
yarn run v1.22.4
warning package.json: No license field
$ docusaurus-start
LiveReload server started on port 35729
Docusaurus server started on port 3000

3-Chargez le site d’exemple à l’adresse http://localhost:3000 s’il ne s’est pas déjà ouvert automatiquement. Si le port 3000 a déjà été pris, un autre port sera utilisé. Regardez les messages de la console pour voir lequel.

Vous devriez voir le site d’exemple chargé dans votre navigateur web. Un serveur LiveReload est également en cours d’exécution et toute modification apportée aux documents et aux fichiers du répertoire du site entraînera un rafraîchissement de la page. Une couleur de thème primaire et secondaire générée de manière aléatoire sera choisie pour vous.

image

Lancer le serveur derrière un proxy

Si vous êtes derrière un proxy d’entreprise, vous devez le désactiver pour les requêtes du serveur de développement. Cela peut être fait en utilisant la variable d’environnement NO_PROXY.

SET NO_PROXY=localhost
yarn start (or npm run start)

site doc.ouestline.xyz

Proxy nginx

/etc/nginx/conf.d/doc.ouestline.xyz.conf
server {
    listen 80;
    listen [::]:80;

    ## redirect http to https ##
    server_name doc.ouestline.xyz;
    return  301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name doc.ouestline.xyz;

    include ssl_dh_header;

        location / {
	  proxy_pass  http://localhost:3000;
        }

}

Mise à jour de votre version du Docusaurus

À tout moment après l’installation de Docusaurus, vous pouvez vérifier votre version actuelle de Docusaurus en allant dans le répertoire du site web et en tapant yarn outdated docusaurus ou npm outdated docusaurus

yarn outdated
yarn outdated v1.22.4
Done in 0.02s.

Si les commandes périmées ne produisent pas de version visible, c’est que vous êtes à jour.

Vous pouvez mettre à jour la dernière version de Docusaurus en :

yarn upgrade docusaurus --latest
yarn upgrade v1.22.4
[1/4] Resolving packages...
[2/4] Fetching packages...
[3/4] Linking dependencies...
[4/4] Rebuilding all packages...
success Saved lockfile.
success Saved 0 new dependencies.
Done in 0.05s.

ou

npm update docusaurus

Si vous constatez que vous obtenez des erreurs après votre mise à niveau, essayez soit de vider votre cache Babel (il se trouve généralement dans un répertoire temporaire), soit de lancer le serveur Docusaurus (par exemple, yarn start) avec la configuration d’environnement BABEL_DISABLE_CACHE=1