admin:services:faq_services
Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
| admin:services:faq_services [2020/02/29 03:36] – [Base de données du service ?] admin | admin:services:faq_services [2026/02/18 21:37] (Version actuelle) – [Dépôt Git d’un service] FAQ de la forge fhenry2 | ||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ======= FAQ Services ======= | ======= FAQ Services ======= | ||
| - | L' | + | L' |
| + | Ceux-ci peuvent être très variés d'une équipe à l' | ||
| Afin d' | Afin d' | ||
| - | Bien sûr, ces conventions sont ouvertes au changement et aux propositions d' | + | Bien sûr, ces conventions sont ouvertes au changement et aux propositions d' |
| + | Mais ça se fera de façon concertée. | ||
| + | En attendant, elles restent une référence importante pour tout déploiement d'un service dans le Chapril. | ||
| ===== EtcKeeper ? ===== | ===== EtcKeeper ? ===== | ||
| - | Le dossier | + | Le répertoire |
| + | Penser à //commiter// dès que vous y faites une modification. | ||
| - | ===== Les fichiers de conf HTTP ? ===== | + | ===== Les fichiers de configuration |
| - | Traditionnellement, | + | |
| - | Conventions techniques recommandées : | + | Traditionnellement, |
| - | | + | |
| + | Convention technique recommandée : donner le nom complet du service | ||
| Exemples : | Exemples : | ||
| + | <code bash> | ||
| + | cd / | ||
| + | ll | ||
| + | </ | ||
| < | < | ||
| - | =(^-^)=root@lamp:/ | ||
| total 44 | total 44 | ||
| -rw-r--r-- 1 root root 498 sept. 27 14:11 banner.chapril.org.conf | -rw-r--r-- 1 root root 498 sept. 27 14:11 banner.chapril.org.conf | ||
| Ligne 30: | Ligne 37: | ||
| </ | </ | ||
| - | ===== Les fichiers | + | ===== Les fichiers |
| - | + | ||
| - | L' | + | |
| + | L' | ||
| ===== Les fichiers de logs HTTP ? ===== | ===== Les fichiers de logs HTTP ? ===== | ||
| - | Traditionnellement, | + | Traditionnellement, |
| + | C'est bien. | ||
| + | Mais comme on est susceptible d' | ||
| Conventions techniques recommandées : | Conventions techniques recommandées : | ||
| - | * pour chaque site web, créer un dossier | + | * Pour chaque site Web, créer un répertoire |
| - | * nommage | + | * Nommage |
| - | * nommage | + | * Nommage |
| Exemples : | Exemples : | ||
| + | <code bash> | ||
| + | cd / | ||
| + | ll */ | ||
| + | </ | ||
| < | < | ||
| - | =(^-^)=root@lamp:/ | ||
| -rw-r----- 1 root adm 2562895 janv. 9 09:22 banner.chapril.org/ | -rw-r----- 1 root adm 2562895 janv. 9 09:22 banner.chapril.org/ | ||
| -rw-r----- 1 root adm 3692761 janv. 9 09:23 date.chapril.org/ | -rw-r----- 1 root adm 3692761 janv. 9 09:23 date.chapril.org/ | ||
| Ligne 53: | Ligne 64: | ||
| -rw-r----- 1 root adm 2105783 janv. 9 09:22 v2.chapril.org/ | -rw-r----- 1 root adm 2105783 janv. 9 09:22 v2.chapril.org/ | ||
| -rw-r----- 1 root adm 5313214 janv. 9 09:23 www.chapril.org/ | -rw-r----- 1 root adm 5313214 janv. 9 09:23 www.chapril.org/ | ||
| - | =(^-^)=root@lamp: | + | </ |
| + | <code bash> | ||
| + | cd / | ||
| + | ll */ | ||
| + | </ | ||
| + | < | ||
| -rw-r----- 1 root adm 4093 janv. 9 01:19 banner.chapril.org/ | -rw-r----- 1 root adm 4093 janv. 9 01:19 banner.chapril.org/ | ||
| -rw-r----- 1 root adm 206183 janv. 9 09:23 date.chapril.org/ | -rw-r----- 1 root adm 206183 janv. 9 09:23 date.chapril.org/ | ||
| Ligne 64: | Ligne 80: | ||
| ===== Format des logs HTTP ? ===== | ===== Format des logs HTTP ? ===== | ||
| - | Pour profiter des IP proxifiées, | + | Pour profiter des adresses |
| - | <code> | + | <file apache / |
| - | | + | # Spécifique au service foo.chapril.org |
| - | </code> | + | CustomLog ${APACHE_LOG_DIR}/ |
| + | </file> | ||
| ===== Les autres fichiers de logs ? ===== | ===== Les autres fichiers de logs ? ===== | ||
| - | Les mettre dans le dossier | + | Pour le projet '' |
| ===== Home Directory du service ? ===== | ===== Home Directory du service ? ===== | ||
| - | Tout service a son « home directory | + | Tout service |
| + | Le dossier ne sera jamais // | ||
| + | L' | ||
| Exemples : | Exemples : | ||
| + | <code bash> | ||
| + | cd /srv/ | ||
| + | ll | ||
| + | </ | ||
| < | < | ||
| - | =(^-^)=root@lamp:/ | ||
| total 16 | total 16 | ||
| drwxr-xr-x 2 root root 4096 juil. 18 23:46 bin | drwxr-xr-x 2 root root 4096 juil. 18 23:46 bin | ||
| Ligne 87: | Ligne 109: | ||
| </ | </ | ||
| - | Dans ce dossier, on trouvera notamment : | + | Dans ce répertoire, on trouvera notamment : |
| - | * un dossier | + | * Un répertoire |
| * des liens : | * des liens : | ||
| - | * www : vers le '' | + | * '' |
| - | * un vers le fichier | + | * Un vers le répertoire ''/ |
| - | * … | + | |
| + | %%*%% La variable '' | ||
| ===== Compte système du service ? ===== | ===== Compte système du service ? ===== | ||
| Ligne 98: | Ligne 121: | ||
| La création d'un utilisateur système dédié au service est optionnelle et dépend des besoins du service, de son déploiement et de son exploitation. | La création d'un utilisateur système dédié au service est optionnelle et dépend des besoins du service, de son déploiement et de son exploitation. | ||
| - | Convention : | + | Convention |
| - | * nom du compte : prendre le nom complet du service sans les points | + | * Nom du compte : prendre le nom complet du service sans les points |
| - | * type de compte : donner le type système au compte ; | + | * Type de compte : donner le type système au compte ; |
| - | * shell : assigner ''/ | + | * Shell : assigner ''/ |
| - | * home directory : / | + | * // |
| ===== Base de données du service ? ===== | ===== Base de données du service ? ===== | ||
| - | L' | + | L' |
| - | * la base : '' | + | * La base : '' |
| - | * le compte | + | * Le compte |
| Mais dans la pratique, on peut se simplifier la vie : | Mais dans la pratique, on peut se simplifier la vie : | ||
| - | * la base : '' | + | * La base : '' |
| - | * le compte : '' | + | * Le compte : '' |
| ===== Partition dédiée du service ? ===== | ===== Partition dédiée du service ? ===== | ||
| - | Dans le cas d'un service nécessitant beaucoup d' | + | Dans le cas d'un service nécessitant beaucoup d' |
| - | + | Cette partition | |
| - | Exemple : https:// | + | |
| + | Suivre [[admin: | ||
| ===== Quelle configuration SMTP ? ===== | ===== Quelle configuration SMTP ? ===== | ||
| - | L' | + | L' |
| + | Configuration à faire : '' | ||
| ===== Courriel du service ? ===== | ===== Courriel du service ? ===== | ||
| Ligne 132: | Ligne 155: | ||
| En cas de demande d' | En cas de demande d' | ||
| - | ===== Tâches | + | ===== Tâches |
| - | La sagesse unixienne recommande aux utilisateurs de passer par '' | + | La sagesse unixienne recommande aux utilisateurs de passer par '' |
| + | C'est vraiment une bonne idée. | ||
| + | Sauf que sur nos VM, nous ne sommes pas des utilisateurs mais des **adminsys**. | ||
| + | Et même si certains services tournent sous un compte Unix dédié, il s'agit d'un compte système et non d'un compte utilisateur classique. | ||
| En conséquence, | En conséquence, | ||
| - | * les tâches | + | * Les tâches |
| - | * les tâches | + | * les tâches |
| - | * le nommage doit reprendre le nom du service ('' | + | * Le nommage doit reprendre le nom du service ('' |
| - | * penser | + | * Penser |
| - | * logger la tâche cron (exemple | + | * //Logger// la tâche Cron%%**%%. |
| + | |||
| + | %%*%% Penser à bien configurer | ||
| + | |||
| + | %%**%% Exemple | ||
| Exemples de nommage : | Exemples de nommage : | ||
| + | <code bash> | ||
| + | cd / | ||
| + | ll | ||
| + | </ | ||
| < | < | ||
| - | =(^-^)=root@lamp:/ | ||
| total 16 | total 16 | ||
| -rw-r--r-- 1 root root 63 juil. 18 16:30 backup | -rw-r--r-- 1 root root 63 juil. 18 16:30 backup | ||
| Ligne 155: | Ligne 188: | ||
| Avantages : | Avantages : | ||
| - | * facilité | + | * Facilité |
| - | * historisation | + | * Historisation |
| - | * alertes | + | * Alertes |
| - | * sauvegarde | + | * Sauvegarde |
| - | * … | + | |
| - | ===== Nommage branche | + | ===== Forge de l' |
| - | Pour certains services, la personnalisation passe par la modification du code du service. Afin de suivre et pouvoir propager les modifications dans les futures versions, la mise sous Git du code est nécessaire (si ce n' | + | La forge de l' |
| - | À ce moment là, il faut créer une branche dédiée au Chapril nommée chapril-x.y.z en reprenant le numéro | + | Elle permet |
| + | * Les modifications sur un service qui ne sont pas dans la version officielle | ||
| + | * Les outils de monitoring (surveillance) et les rapports d' | ||
| - | ===== Puis-je assigner un ticket ? ===== | + | En équipe, plusieurs contributeurs peuvent faire évoluer les sources. |
| - | En tant qu' | + | %%*%% Par exemple sur Paste des modifications ont lieu par rapport |
| + | ===== Dépôt Git d’un service ===== | ||
| + | |||
| + | Un service '' | ||
| + | Ces dépôts ont pour nom '' | ||
| + | |||
| + | Un tel dépôt externalise la gestion des tickets vers [[https:// | ||
| + | Pour externaliser il suffit de paramétrer depuis la page // | ||
| + | On utilise alors un système de suivi de tickets externe avec pour adresse '' | ||
| + | L’URL de ce système sera '' | ||
| + | |||
| + | Ce dépôt peut exporter aussi son wiki pour sa documentation vers [[https:// | ||
| + | Toujours depuis la section // | ||
| + | |||
| + | Les [[https:// | ||
| + | |||
| + | ===== Nommage de branche Chapril ===== | ||
| + | |||
| + | Pour certains services, la personnalisation passe par la modification du code du service. | ||
| + | Afin de suivre et pouvoir propager les modifications dans les futures versions, la mise sous Git du code est nécessaire (si ce n'est pas déjà fait). | ||
| + | |||
| + | À ce moment là, une branche dédiée au Chapril doit être créée et nommée '' | ||
| + | |||
| + | Pour chaque version '' | ||
| + | |||
| + | Ces étiquettes doivent faciliter la mise à jour du service hébergé dans la VM via la commande '' | ||
| + | |||
| + | ===== Puis-je assigner un ticket ? ===== | ||
| + | |||
| + | En tant qu' | ||
| + | Cela reste de la communication, | ||
| + | Le mieux étant de la contacter avant. | ||
| ===== Jardinage/ | ===== Jardinage/ | ||
| - | Les tickets ne sont pas le cœur du projet. Le cœur du projet, ce sont l' | + | Les tickets ne sont pas le cœur du projet. |
| + | Le cœur du projet, ce sont l' | ||
| + | Les tickets servent à construire une image de où on en est. | ||
| + | Donc ce n'est pas la priorité mais quand même bien nécessaire pour suivre et assurer une qualité à l' | ||
| Quelques principes : | Quelques principes : | ||
| - | * un ticket non assigné est un ticket en souffrance ; | + | * Un ticket non assigné est un ticket en souffrance ; |
| - | * ne pas laisser trop longtemps les tickets en statut « Résolu » ; | + | * Ne pas laisser trop longtemps les tickets en statut « Résolu » ; |
| - | * … | + | |
| ===== Besoin d'une action infra ? ====== | ===== Besoin d'une action infra ? ====== | ||
| - | L' | + | L' |
| + | Besoin d'une action en dehors de la VM du service ? | ||
| + | Alors interpeler un membre de l' | ||
| - | ===== Module FPM vs open_basedir ? ====== | + | ===== Module FPM vs '' |
| Par simplicité, | Par simplicité, | ||
| - | |||
| ===== Réception d'un courriel sur l' | ===== Réception d'un courriel sur l' | ||
| - | Chaque service du Chapril a son courriel de support : foo-support@chapril.org. | + | Chaque service du Chapril a son courriel de support : '' |
| - | Et parfois, des utilisateurs écrivent à cette adresse. Voici un plan de traitement | + | Et parfois, des utilisateurs écrivent à cette adresse. |
| - | * 1) répondre en privé : | + | Voici un plan de traitement : |
| - | * expéditeur : | + | |
| - | * utiliser son courriel @april.org, c'est l' | + | |
| - | * éviter **absolument** d' | + | |
| - | * en copie : | + | |
| - | * foo-support@chapril.org | + | |
| - | * contenu : | + | |
| - | * dire qui l'on est : | + | |
| - | | + | |
| + | * Expéditeur : | ||
| + | * Utiliser son courriel '' | ||
| + | * Éviter **absolument** d' | ||
| + | * Copie carbone : | ||
| + | * '' | ||
| + | * Contenu : dire qui on est%%*%% ; | ||
| + | - Créer un ticket : | ||
| + | * Objet : copiercollerlesujetducourrielavecescrochets, | ||
| + | * Description : copier/ | ||
| + | * Ajouter en commentaire le copier/ | ||
| + | - Partager sur '' | ||
| - | | + | %%*%% Modèle de courriel de réponse |
| - | * sujet : « date-support : copiercollerlesujetducourriel » | + | < |
| - | * description : copier/ | + | |
| + | |||
| + | Je suis Christian Momon, l' | ||
| + | heureux que nos services numériques libres, éthiques et loyaux puissent vous être utiles. | ||
| + | | ||
| + | |||
| + | En vous souhaitant, au nom de toute l' | ||
| + | usage de nos services libres, éthiques et loyaux. | ||
| + | |||
| + | | ||
| + | |||
| + | | ||
| + | </ | ||
| + | |||
| + | %%**%% Modèle de description : | ||
| + | < | ||
| Le 20/01/2010, Laurence R. a écrit sur foo-support@chapril.org : | Le 20/01/2010, Laurence R. a écrit sur foo-support@chapril.org : | ||
| Bonjour, | Bonjour, | ||
| […] | […] | ||
| - | + | </code> | |
| - | * ajouter en commentaire le copier/coller de votre réponse | + | |
| - | | + | |
| - | | + | %%***%% Par exemple, en cas de remerciements, |
| - | * … | + | |
| + | ===== Charset des bases de données ? ====== | ||
| - | ===== Charset des bases de donneés ? ====== | + | Privilégier l' |
| + | Par exemple, avec MySQL ou MariaDB, systématiquement faire du '' | ||
| - | Privilégier l' | + | Ça permet de gérer les émojis |
| - | + | Ça permettra surtout d' | |
| - | Ça permet de gérer les émoticons | + | |
| Exemple : | Exemple : | ||
| - | < | + | < |
| CREATE DATABASE IF NOT EXISTS gitea_db DEFAULT CHARACTER SET utf8mb4 COLLATE ' | CREATE DATABASE IF NOT EXISTS gitea_db DEFAULT CHARACTER SET utf8mb4 COLLATE ' | ||
| </ | </ | ||
admin/services/faq_services.1582947377.txt.gz · Dernière modification : 2020/02/29 03:36 de admin
