admin:services:wiki.chapril.org
Différences
Ci-dessous, les différences entre deux révisions de la page.
Révision précédente | |||
— | admin:services:wiki.chapril.org [2025/02/11 21:19] (Version actuelle) – claver | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
+ | [[admin:# | ||
+ | ====== Service wiki.chapril.org ====== | ||
+ | |||
+ | {{ : | ||
+ | ===== Introduction ===== | ||
+ | |||
+ | Cette documentation explique comment installer un service, en l’occurrence le wiki, sur une nouvelle machine virtuelle de l' | ||
+ | |||
+ | Ce service de wiki est basé sur Dokuwiki avec l' | ||
+ | |||
+ | Les wikis seront publics ou privés au choix. La demande de création d'un nouveau wiki se fait par demande à la liste support (wiki-support *@* chapril.org). Il faut alors choisir le nom court pour l' | ||
+ | |||
+ | Retrouvez la page de présentation du service sur le site [[https:// | ||
+ | |||
+ | Site principal Dokuwiki : [[https:// | ||
+ | Téléchargement Dokuwiki : [[https:// | ||
+ | Sources Dokuwiki : [[https:// | ||
+ | Page de l' | ||
+ | Source de l' | ||
+ | Machine virtuelle Chapril pour ce service : **wiki.cluster.chapril.org**\\ | ||
+ | Page principale du service wiki Chapril: [[https:// | ||
+ | Exemple d' | ||
+ | |||
+ | ==== Aspects techniques ==== | ||
+ | |||
+ | * Serveur web : Le serveur web est Apache2. | ||
+ | * Base de données : Il n'y pas de base de données installée. Cependant une extension de Dokuwiki permet d'en ajouter une, cela permettrait d' | ||
+ | ==== Précision sur la configuration des animaux ==== | ||
+ | |||
+ | * Extensions : L' | ||
+ | * Thèmes : Le thème proposé est le thème par défaut de Dokuwiki, les couleurs sont modifiables dans chaque wiki. Il n'est pas possible de changer de thème sans en faire la demande, il faut alors intégrer les fichiers du nouveau thème dans le dossier de l' | ||
+ | * Utilisateurs : L' | ||
+ | ===== Préparation ===== | ||
+ | |||
+ | ==== Nouvelle VM ==== | ||
+ | |||
+ | Création de la VM avec la procédure [[admin: | ||
+ | |||
+ | ==== Pré-requis ==== | ||
+ | |||
+ | Pré-requis sur la : [[https:// | ||
+ | |||
+ | ==== Apache ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Commandes d' | ||
+ | '' | ||
+ | apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip'' | ||
+ | |||
+ | ==== LVM ==== | ||
+ | |||
+ | Création d'un volume logique avec LVM, le nom de ce volume sera // | ||
+ | '' | ||
+ | mkfs -t ext4 / | ||
+ | |||
+ | Création du dossier de montage nommé // | ||
+ | < | ||
+ | '' | ||
+ | vim /etc/fstab \\ | ||
+ | < | ||
+ | / | ||
+ | mount -a '' | ||
+ | |||
+ | Vérification de ce qui a été fait précédemment : \\ | ||
+ | # lvs | ||
+ | LV | ||
+ | donnees_utilisateurs vgmain -wi-ao---- | ||
+ | rootfs | ||
+ | swap | ||
+ | tmp vgmain -wi-ao---- 284, | ||
+ | var vgmain -wi-ao---- | ||
+ | # mount |grep dev/mapper | ||
+ | / | ||
+ | / | ||
+ | / | ||
+ | / | ||
+ | |||
+ | ==== Serveur virtuel Apache ==== | ||
+ | |||
+ | Création d'un hôte virtuel en créant le fichier wiki.chapril.org.conf dans le dossier | ||
+ | '' | ||
+ | |||
+ | Avec pour contenu : \\ | ||
+ | |||
+ | ''< | ||
+ | ServerName wiki.chapril.org \\ | ||
+ | DocumentRoot "/ | ||
+ | < | ||
+ | Options +FollowSymLinks \\ | ||
+ | AllowOverride all \\ | ||
+ | Require all granted \\ | ||
+ | </ | ||
+ | CustomLog / | ||
+ | ErrorLog / | ||
+ | </ | ||
+ | '' | ||
+ | |||
+ | Activation du site \\ | ||
+ | '' | ||
+ | On recharge ensuite la configuration d' | ||
+ | '' | ||
+ | |||
+ | |||
+ | === Configuration pour affichage de l' | ||
+ | |||
+ | |||
+ | 1. créer ce fichier / | ||
+ | mettre le contenu : \\ | ||
+ | | ||
+ | ''< | ||
+ | LoadModule remoteip_module / | ||
+ | </ | ||
+ | \\ | ||
+ | < | ||
+ | RemoteIPHeader X-Forwarded-For \\ | ||
+ | RemoteIPInternalProxy 192.168.1.93 2a01: | ||
+ | LogFormat "%a %l %u %t \" | ||
+ | </ | ||
+ | '' | ||
+ | |||
+ | 2. activer la conf \\ | ||
+ | commande qui permet d' | ||
+ | '' | ||
+ | |||
+ | 3. réutiliser combined-proxy dans le fichier de conf du site | ||
+ | |||
+ | modifier le fichier / | ||
+ | |||
+ | ''< | ||
+ | ServerName xxx.chapril.org \\ | ||
+ | ServerAdmin xxx-support@chapril.org \\ | ||
+ | \\ | ||
+ | ErrorLog ${APACHE_LOG_DIR}/ | ||
+ | CustomLog ${APACHE_LOG_DIR}/ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Installation de l' | ||
+ | |||
+ | ==== Récupération et extraction ==== | ||
+ | |||
+ | Le dossier / | ||
+ | Récupération et extraction des fichiers de l' | ||
+ | '' | ||
+ | tar -xzvf dokuwiki-stable.tgz'' | ||
+ | ' | ||
+ | |||
+ | On crée un dossier pour les animaux ''/ | ||
+ | '' | ||
+ | ==== plugin farmer ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | * Méthode graphique : Pour l' | ||
+ | * Méthode manuelle : Pour la méthode manuel, les fichier de l' | ||
+ | |||
+ | Une fois l' | ||
+ | ===== Personnalisation ===== | ||
+ | |||
+ | ==== Favicon==== | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | A placer ici : ''/ | ||
+ | |||
+ | ==== Bannière Chapril ==== | ||
+ | |||
+ | La mise en place de la bannière se fait dans l' | ||
+ | Les fichiers à récupérer : header.html, | ||
+ | |||
+ | Création d'un nouveau thème à partir du thème starter. Ensuite, la mise en place de la bannière Chapril se fait en déposant les fichiers dans le dossier du thème " | ||
+ | |||
+ | ==== Pied de page ==== | ||
+ | |||
+ | ==== Texte d' | ||
+ | |||
+ | Page d' | ||
+ | Demander la création d'un wiki : \\ | ||
+ | Ecrire à (enveler les *): wiki-support *@* chapril.org et préciser : \\ | ||
+ | * le nom du wiki, par exemple : “Mon wiki sur les logiciels libres” | ||
+ | * le nom court pour l' | ||
+ | * le descriptif, par exemple : documentation de mon logiciel | ||
+ | * le wiki sera public ou privé | ||
+ | |||
+ | ===== Rapport d' | ||
+ | |||
+ | Redmine permet de créer un rapport mensuel. On indique dans un fichier de configuration le serveur et l'id à utiliser : \\ | ||
+ | ''# | ||
+ | REDMINE_BASE_URL=" | ||
+ | REDMINE_TICKET_ID=6399 \\ | ||
+ | '' | ||
+ | |||
+ | Les sources se trouve dans un dépôt sur la forge de l' | ||
+ | |||
+ | Ce dépôt est cloné sur la vm et se trouve dans / | ||
+ | |||
+ | ===== Gestion des mises à jour ===== | ||
+ | |||
+ | Un lien symbolique permet de passer d'un version à une autre. En cas d' | ||
+ | |||
+ | Exemple de création d'un lien symbolique : \\ | ||
+ | <code bash>ln -s / | ||
+ | Vérification : \\ | ||
+ | <code bash>ls -l</ | ||
+ | <code bash> | ||
+ | |||
+ | Page pour upgrade : [[https:// | ||
+ | |||
+ | Dupliquer le dossier de la version antérieur dans un dossier portant le numéro de la nouvelle version, exemple : \\ | ||
+ | <code bash>cp -Ra chapril-wiki-2024-02-06a/ | ||
+ | |||
+ | Récupérer et extraire l' | ||
+ | <code bash> | ||
+ | cd ~ | ||
+ | wget https:// | ||
+ | tar zxvf dokuwiki-stable.tgz | ||
+ | </ | ||
+ | |||
+ | Copier les fichiers de la nouvelle version sur le dossier dupliqué de l' | ||
+ | <code bash>cp -af dokuwiki-xxxx-xx-xx/ | ||
+ | |||
+ | Mettre à jour le propriétaire de tous les fichiers avec www-data \\ | ||
+ | <code bash> | ||
+ | |||
+ | Si nécessaire, | ||
+ | |||
+ | Tester la nouvelle version en changeant le lien symbolique. \\ | ||
+ | <code bash>rm public_html | ||
+ | ln -s / | ||
+ | |||
+ | ===== Configuration ===== | ||
+ | |||
+ | ==== Journaux ==== | ||
+ | |||
+ | ==== Cron ==== | ||
+ | |||
+ | ===== Utilisation, | ||
+ | |||
+ | ==== Créer un compte ==== | ||
+ | |||
+ | Pour créer un compte, on peut le faire dans l' | ||
+ | Maintenant, donner un nom et choisir le type de wiki : ouvert, public ou fermé. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === Création d'un nouvel animal, convention de nommage et lien symbolique. === | ||
+ | |||
+ | Le lien symbolique permet de suspendre facilement un animal, pour cela on supprime le lien symbolique sans toucher au dossier. | ||
+ | |||
+ | Renommage, déplacement du dossier : \\ | ||
+ | '' | ||
+ | mv 2024_monpremierwiki_01 2024/ | ||
+ | '' | ||
+ | Création du lien \\ | ||
+ | '' | ||
+ | Exemple \\ | ||
+ | '' | ||
+ | |||
+ | Suppression du lien \\ | ||
+ | '' | ||
+ | ==== Supprimer un compte ==== | ||
+ | |||
+ | Pour supprimer un compte, on peut le faire dans l' | ||
+ | administrer > Extensions supplémentaires - Élevage > Supprimer un animal \\ | ||
+ | Choisir l' | ||
+ | |||
+ | |||
+ | ==== Réception d'un courriel sur l' | ||
+ | |||
+ | Le courriel du service wiki du Chapril est wiki-support@chapril.org | ||
+ | |||
+ | Parfois, des utilisateurs écrivent à cette adresse. Voici un plan de traitement : | ||
+ | * 1) répondre en privé : | ||
+ | * expéditeur : | ||
+ | * utiliser son courriel @april.org, c'est l' | ||
+ | * éviter d' | ||
+ | * en copie : | ||
+ | * wiki-support@chapril.org | ||
+ | * contenu : | ||
+ | * dire qui l'on est. | ||
+ | |||
+ | Modèle de courriel de réponse : | ||
+ | < | ||
+ | Bonjour Ada, | ||
+ | | ||
+ | Je suis xxx, l' | ||
+ | heureux que nos services numériques libres, éthiques et loyaux puissent vous être utiles. | ||
+ | |||
+ | Normalement vous devriez avoir reçu un message de création de compte avec un nom d' | ||
+ | |||
+ | | ||
+ | |||
+ | En vous souhaitant, au nom de toute l' | ||
+ | usage de nos services libres, éthiques et loyaux. | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | </ | ||
+ | | ||
+ | |||
+ | * 2) créer un ticket : | ||
+ | * sujet : copiercollerlesujetducourrielavecescrochets | ||
+ | * description : copier/ | ||
+ | |||
+ | < | ||
+ | Le xx/xx/20xx, Ada B. a écrit sur wiki-support@chapril.org : | ||
+ | Bonjour, | ||
+ | [...] | ||
+ | </ | ||
+ | |||
+ | * ajouter en commentaire le copier/ | ||
+ | |||
+ | * 3) partager | ||
+ | * sur chapril@ : si le sujet est pertinent : par exemple, en cas de remerciements, | ||
+ | * ... | ||
+ | |||
+ | ===== Abréviations ===== | ||
+ | |||
+ | * vm : vitual machine, [[https:// | ||
+ | * lvm : logical volume management, [[https:// | ||
+ | |||
+ | [[admin:# |