Anneraud
Search K

Appearance

Exploitation et accès ​

Accès aux services ​

Les services marqués « Nécessite un VPN » sur la page d'accueil sont privés. Ils nécessitent un accès au réseau privé NetBird configuré pour l'infrastructure. La page État des services permet de consulter leur disponibilité, mais ne donne pas accès aux services privés.

MeshCentral est accessible à l'adresse parc.anneraud.fr et figure parmi les services publics. L'interface permet d'administrer à distance les appareils inscrits ; l'accès à l'interface ne signifie pas qu'un appareil est automatiquement enrôlé.

Modifier la documentation ​

Le site est construit avec VitePress. Depuis le répertoire services/website/website :

bash
npm ci
npm run docs:dev

Le serveur local affiche l'adresse à ouvrir dans un navigateur. Avant de proposer une modification, vérifier le formatage et la génération du site :

bash
npm run check

Cette commande lance Prettier en vérification puis construit le site. Pour examiner localement le résultat de production :

bash
npm run docs:build
npm run docs:preview

Les sources du site sont dans services/website/website/src. Les pages de documentation sont indexées dans src/documentation/index.md et listées dans la barre latérale de .vitepress/config.mts.

Publication ​

Le workflow GitHub Actions du site construit et publie automatiquement sur GitHub Pages après un push sur la branche main. Il peut aussi être lancé manuellement depuis l'onglet Actions du dépôt. La publication utilise le résultat de npm run docs:build ; aucun déploiement Ansible du serveur n'est nécessaire pour mettre à jour ce site.

Pour contribuer, créer une branche, exécuter npm run check, puis ouvrir une pull request vers main. Après fusion, suivre le workflow de publication dans GitHub Actions.