- Add language switcher to navbar for bilingual site (FR/EN) - Remove intro page, use presentation as entry point - Add example pages to all documentation categories - Configure categories with generated-index for page listings - Update footer and homepage links to reference presentation - Enhance configuration with best practices: - Add metadata and SEO keywords - Enable RSS/Atom feeds for blog - Configure sitemap generation - Add syntax highlighting for YAML, HCL, Docker - Enable Mermaid diagram support - Configure table of contents settings - Respect user color scheme preferences - Add last update metadata to docs - Fix deprecated onBrokenMarkdownLinks configuration - Create bilingual example pages with practical code examples - Update all i18n translations for consistency This update brings the site in line with Docusaurus 3.x best practices and provides a solid foundation for documentation growth.
60 lines
1 KiB
Markdown
60 lines
1 KiB
Markdown
---
|
|
sidebar_position: 2
|
|
---
|
|
|
|
# Exemple
|
|
|
|
Ceci est une page d'exemple dans la catégorie Homelab actuel.
|
|
|
|
## Description
|
|
|
|
Cette page démontre comment documenter un service ou une configuration du homelab actuel.
|
|
|
|
## Configuration Docker Compose
|
|
|
|
Exemple de configuration d'un service :
|
|
|
|
```yaml
|
|
version: '3.8'
|
|
|
|
services:
|
|
exemple-service:
|
|
image: nginx:latest
|
|
container_name: exemple
|
|
ports:
|
|
- "8080:80"
|
|
volumes:
|
|
- ./config:/etc/nginx/conf.d
|
|
restart: unless-stopped
|
|
```
|
|
|
|
## Playbook Ansible
|
|
|
|
Exemple de déploiement avec Ansible :
|
|
|
|
```yaml
|
|
---
|
|
- name: Déployer le service exemple
|
|
hosts: homelab
|
|
become: yes
|
|
|
|
tasks:
|
|
- name: Copier le fichier docker-compose
|
|
copy:
|
|
src: docker-compose.yml
|
|
dest: /opt/exemple/docker-compose.yml
|
|
|
|
- name: Démarrer le service
|
|
command: docker-compose up -d
|
|
args:
|
|
chdir: /opt/exemple
|
|
```
|
|
|
|
## Maintenance
|
|
|
|
Points importants pour la maintenance :
|
|
|
|
- Sauvegardes régulières
|
|
- Mises à jour de l'image Docker
|
|
- Surveillance des logs
|
|
- Tests de restauration
|