Ceci est une ancienne révision du document !

CodiMD

Connexion au conteneur

Se connecter au conteneur codimd:

sudo lxc-attach --name codimd

Installation des paquets

Paquets standards sous Debian Stretch

apt-get install nodejs sqlite curl apt-transport-https git bzip2

Paquets non-standards

NPM

il faut utiliser les backports:

apt-get -t stretch-backport install nodejs  npm

NodeJs

La version 8.5 ou supérieure étant requise, il passer par une installation manuelle en s’inspirant de cette page:

curl -sSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | apt-key add -
VERSION=node_13.x # Désignation de la version de NodeJS, ici la dernière au moment de l'écriture de ce wiki
DISTRO=stretch
echo "deb https://deb.nodesource.com/$VERSION $DISTRO main" >> /etc/apt/sources.list.d/nodesource.list
echo "deb-src https://deb.nodesource.com/$VERSION $DISTRO main" >> tee -a /etc/apt/sources.list.d/nodesource.list
apt-get update
apt-get install nodejs

Yarn

D'après cette procédure du projet yarn:

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" >> /etc/apt/sources.list.d/yarn.list
apt update && apt install yarn

Création de l'utilisateur CodiMD

Lancer la commande de création d'utilisateur codimd avec son répertoire /opt/codimd

useradd -m -d /opt/codimd/ -s /bin/bash codimd

Se connecter comme utilisateur codimd

Rester dans la session de l'utilisateur codimd pour la suite:

su - codimd

Récupération du dépôt git

Récupérer le dépôt git sous le répertoire /opt/codimd/

git clone https://github.com/codimd/server.git

Installation des dépendances par yarn

Aller dans le dossier server pour lancer l'installation de ces dépendances:

cd server
bin/setup

Configuration générale du service

Modifier le bloc production du fichier config.json

  "production": {
      "domain": "codimd.parinux.org",
      "allowEmailRegister": false,
      "protocolUseSSL": true,

Configuration de l'accès à la base de donnée

Création de l'utilisateur sur Postgres

Se connecter au conteneur postgres et faire la création de l'utilisateur codimd:

su - postgres
createuser --pwprompt codimd # Attention à définir son mot de passe ensuite!
createdb -O codimd codimd

Configuration du service

Sur le conteneur codimd, modifier le bloc db comme suit:

      "db": {
          "password": "<Mot de passe>",
          "database": "codimd",
          "host": "<Nom ou IP de la BDD>",
          "port": "5432",
          "dialect": "postgres"

Configuration de authentification SAML

Prendre cette page

Faire une conf adapté

Configuration de authentification LDAP

Prendre cette page

Faire une conf adapté

Compilation du front-end

Dans le répertoire server:

yarn run build

Lancement du serveur

yarn start --production