Ci-dessous, les différences entre deux révisions de la page.
| Both sides previous revision Révision précédente Prochaine révision | Révision précédente Prochaine révision Both sides next revision | ||
|
si:codimd [2020/02/15 17:03] vodkra [Installation des paquets] |
si:codimd [2020/02/18 16:52] vodkra [Configuration générale du service] |
||
|---|---|---|---|
| Ligne 5: | Ligne 5: | ||
| [[https://github.com/codimd/server/blob/master/docs/setup/manual-setup.md|Manuel d'installation]] | [[https://github.com/codimd/server/blob/master/docs/setup/manual-setup.md|Manuel d'installation]] | ||
| + | [[https://demo.codimd.org|Site de démo]] | ||
| + | |||
| + | [[https://social.codimd.org/mastodon|Compte Mastodon]] | ||
| + | |||
| + | [[https://community.codimd.org/|Forum communautaire]] | ||
| + | |||
| + | ===== Connexion au conteneur ===== | ||
| + | |||
| + | Se connecter au conteneur ''codimd'': | ||
| + | |||
| + | sudo lxc-attach --name codimd | ||
| ===== Installation des paquets ===== | ===== Installation des paquets ===== | ||
| - | apt-get install nodejs sqlite yarnpkg npm npm2deb postgresql | + | ==== Paquets standards sous Debian Stretch ==== |
| + | |||
| + | apt-get install nodejs sqlite curl apt-transport-https git bzip2 | ||
| | | ||
| - | ===== Installation de l'archive de CodiMD ===== | + | ==== Paquets non-standards ==== |
| - | + | ||
| - | Récupérer l'archive ''tar.gz''de la release la plus récente sur [[https://github.com/codimd/server/releases|Github]]. | + | |
| - | FIXME Mettre instruction de détarage | + | === 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 [[https://github.com/nodesource/distributions/blob/master/README.md#debmanual|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 [[https://classic.yarnpkg.com/en/docs/install/#debian-stable|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 ===== | ===== 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 [[https://github.com/codimd/server/blob/master/docs/guides/auth/saml.md|cette page]] | ||
| FIXME Faire une conf adapté | FIXME Faire une conf adapté | ||
| - | |||
| - | ===== Mise en place du lien symbolique ===== | ||
| + | ===== Configuration de authentification LDAP ===== | ||
| + | |||
| + | Prendre [[https://github.com/codimd/server/blob/master/docs/guides/auth/ldap-AD.md|cette page]] | ||
| + | |||
| + | FIXME Faire une conf adapté | ||
| + | |||
| - | ln -s /usr/bin/yarnpkg /usr/bin/yarn | + | ===== Compilation du front-end ===== |
| + | Dans le répertoire ''server'': | ||
| + | yarn run build | ||
| ===== Lancement du serveur ===== | ===== Lancement du serveur ===== | ||
| yarn start --production | yarn start --production | ||