01 Contexte
Un portfolio pour se présenter et démontrer un savoir-faire DevOps complet.
Le projet portfolio-vince est la génération de mon portfolio personnel d'ingénieur Virtualisation · Stockage · DevOps · Cloud. C'est un site vitrine one-page (HTML/CSS/JS) qui présente mon parcours, mes compétences, mes formations/certifications et mes projets réalisés.
Au-delà de la simple vitrine, ce projet illustre une démarche DevOps complète : une source de vérité unique, une génération automatisée, un pipeline CI/CD et un déploiement industrialisé.
- Site one-page — hero, à propos, expérience, formations, compétences, projets, contact.
- Pages projets détaillées — NocoDB, portfolio, observabilité, base de connaissance… avec une structure homogène.
- Bilingue FR/EN — sélecteur de langue intégré, persistance du choix.
02 Objectifs clés
Industrialiser la génération du CV et du site, puis automatiser le déploiement.
- Source de vérité unique : le CV FR génère la version EN, les sections du site et les PDF.
- Génération automatisée : scripts Python (stdlib) + Chromium headless + traduction IA.
- i18n FR/EN : sélecteur de langue avec re-fetch du CV au changement de langue.
- CI/CD Jenkins : validation, génération, déploiement automatique sur la branche main.
- Déploiement rsync : synchronisation avec exclusions cPanel, page de maintenance et rollback.
03 Conception & choix
Chaque choix résulte d'un arbitrage simple : simplicité, reproductibilité, coût maîtrisé.
La conception repose sur un principe directeur : garder le site simple et pousser toute la complexité côté génération et CI. Le site publié reste un ensemble de fichiers statiques servi par Apache, sans base de données ni code exécuté côté serveur.
| Décision | Alternative écartée | Justification |
|---|---|---|
| Site statique one-page | CMS (WordPress) / générateur (SSG) | Zéro backend = zéro surface d'attaque, coût mutualisé, aucune mise à jour de sécurité |
| JavaScript vanilla | React / Vue / SPA | Pas d'étape de build ni de dépendance npm, un fichier lisible et léger |
| Source de vérité unique | Contenu dupliqué FR/EN/site maintenu à la main | Un seul point d'édition, zéro divergence entre CV, site et PDF |
| Traduction IA (opencode) | Traduction manuelle du CV EN | Reproductible et rapide, avec des règles strictes de préservation |
| Déploiement rsync | FTP / git pull côté serveur | Idempotent, --delete, exclusions cPanel scriptées |
| i18n maison (dictionnaire tr) | Bibliothèque i18next / framework | Sans dépendance, quelques dizaines de clés suffisent |
04 Stack technique
Une chaîne d'outils simple, scriptable et reproductible.
Frontend
HTML/CSS/JS vanilla, charte sombre + accents bleus, animations et i18n.
Génération
Python (stdlib) + Bash : generate_cv.sh orchestre check/translate/site/pdf.
CI/CD
Jenkins Multibranch (migration depuis GitLab CI), rsync pour le déploiement.
Traduction
opencode (IA) pour la traduction FR → EN du CV.
Conteneurisation
Docker + nginx pour le test local du site (hors production).
Orchestration
Ansible (playbook generate-cv.yml) pour la génération locale rejouable.
05 Architecture
Un flux « source de vérité → artefacts » centralisé autour du CV.
cv/cv-vincent-dupeyron-fr.html ← SOURCE DE VÉRITÉ (versionnée)
│
├── [check] ci/check_cv_fr.py (validation, fail fast)
├── [translate] opencode IA ──► cv-vincent-dupeyron-en.html
├── [site] generate_site_*.py ──► site/index.html (sections)
│ ├── skills.py → #skills
│ ├── formations.py → #formations + #certifications
│ ├── mobility.py → tuile Mobilité
│ └── projects.py → tags des pages projet
└── [pdf-fr/en] Chromium headless ──► cv/*.pdf (non versionnés)
Jenkins (Multibranch) : cv-check → cv-pdf-* → site-build → deploy (main)
| Script | Rôle |
|---|---|
| generate_cv.sh | Orchestrateur : check / translate / site / pdf-fr / pdf-en / all |
| generate_site_skills.py | Régénère #skills + synchronise contact/compteurs |
| generate_site_formations.py | Régénère #formations + #certifications (bloc unique) |
| generate_site_mobility.py | Régénère la tuile Mobilité de #contact |
| generate_site_projects.py | Synchronise les tags des cartes projet vers les pages projet |
#skills, #formations, #certifications, Mobilité) sont régénérées : ne pas éditer le HTML directement — modifier la source (CV) ou le script générateur.06 Génération automatisée
Le CV FR est la source de vérité ; tout le reste est généré.
Toute modification du CV se fait uniquement dans cv-vincent-dupeyron-fr.html, puis les artefacts dérivés sont régénérés : la version anglaise (traduction IA), les sections du site (scripts Python) et les PDF (Chromium headless).
| Commande | Description | Sortie |
|---|---|---|
| check | Valide l'intégrité du CV FR | — (code 0/1) |
| translate | Traduit FR → EN via opencode | cv-vincent-dupeyron-en.html |
| site | Régénère les sections du site | site/index.html |
| pdf-fr / pdf-en | Génère les PDF (Chromium) | cv/*.pdf |
| all | Enchaîne translate → site → pdf | tous les artefacts |
# cv/generate_cv.sh — sous-commandes
case "$1" in
check) check_cv_fr ;;
translate) translate_fr_to_en ;;
pdf-fr) generate_pdf "$HTML_FR" "$PDF_FR" "FR" ;;
pdf-en) generate_pdf "$HTML_EN" "$PDF_EN" "EN" ;;
site) generate_site ;;
all)
translate_fr_to_en
generate_site
generate_pdf "$HTML_FR" "$PDF_FR" "FR"
generate_pdf "$HTML_EN" "$PDF_EN" "EN"
;;
esac
07 Points techniques
Robustesse et bonnes pratiques d'implémentation, au-delà du simple « ça marche ».
Les scripts partagent des patterns défensifs communs, appliqués dans le pipeline comme en local : échec rapide, portabilité, zéro dépendance, et secret jamais exposé en clair.
| Pattern | Où | Pourquoi |
|---|---|---|
set -euo pipefail | generate_cv.sh, ci/*.sh | Échouer dès la première erreur, interdire les variables non définies |
ROOT_DIR relatif | tous les scripts Bash | Aucun chemin absolu : exécutable depuis n'importe quel répertoire (runner CI) |
| Python stdlib | generate_site_*.py, check_cv_fr.py | Zéro dépendance pip, reproductible sur toute machine |
clé SSH → 600 + trap | deploy / maintenance / destroy | Secret jamais en clair, nettoyage garanti même en cas d'erreur |
rsync --delete + exclusions | deploy_o2switch.sh | Déploiement idempotent, préservation des éléments cPanel |
filtre anti rsync 23 | deploy_o2switch.sh | Éviter l'erreur rsync 23 en déploiement FR-only |
Chromium --print-to-pdf | generate_cv.sh | PDF identique au rendu HTML, sans interface graphique |
# ci/deploy_o2switch.sh — secret en base64, jamais en clair
cleanup_key() { [ -n "$TMP_KEY" ] && rm -f "$TMP_KEY"; }
trap cleanup_key EXIT
if [ -n "${SSH_PRIVATE_KEY:-}" ]; then
TMP_KEY="$(mktemp)"
printf '%s' "$SSH_PRIVATE_KEY" | base64 -d > "$TMP_KEY"
chmod 600 "$TMP_KEY"
fi
# ci/check_cv_fr.py — 5 contrôles « fail fast »
# 1. le fichier existe
# 2. il n'est pas vide
# 3. il contient <html> et </html>
# 4. il est parsable (html.parser)
# 5. garde-fou : le contenu attendu est présent
def fail(message):
print(f"[KO] {message}", file=sys.stderr)
return 1
08 CI/CD & Déploiement
Pipeline Jenkins Multibranch avec déploiement automatique sur la branche main.
Le pipeline a été migré de GitLab CI vers Jenkins (Jenkinsfile déclaratif, Multibranch). Chaque build valide le CV, génère les PDF et les sections du site, puis — sur la branche main — déploie le site par rsync.
pipeline {
agent { label 'vps' }
triggers { pollSCM('* * * * *') }
stages {
stage('cv-check') { steps { sh 'bash cv/generate_cv.sh check' } }
stage('cv-pdf-fr') { steps { sh 'bash cv/generate_cv.sh pdf-fr' } }
stage('cv-pdf-en') { steps { sh 'bash cv/generate_cv.sh pdf-en' } }
stage('site-build') { steps { sh 'bash cv/generate_cv.sh site' } }
stage('deploy') {
when { branch 'main' }
steps {
withCredentials([sshUserPrivateKey(
credentialsId: '',
keyFileVariable: 'O2SWITCH_KEY')]) {
sh 'SSH_KEY="$O2SWITCH_KEY" bash ci/deploy_o2switch.sh'
}
}
}
}
}
| Stage | Branche | Rôle |
|---|---|---|
| site-Maintenance | main | Choix Deploy / Maintenance |
| cv-check | toutes | Validation du CV (fail fast) |
| cv-pdf-fr / cv-pdf-en | toutes | Génération des PDF |
| site-build | toutes | Régénération des sections du site |
| deploy | main | rsync du site + CV (automatique) |
| destroy | main | Suppression du déploiement (manuel, timeout) |
--delete) préserve les éléments gérés par cPanel (cv/, .well-known/, cgi-bin/, .ftpquota).09 i18n FR/EN
Le site est bilingue : sélecteur de langue + re-fetch du CV.
Un dictionnaire tr (fr/en) relie les attributs data-i18n* du HTML aux textes traduits. Au changement de langue, setLang() met à jour les textes, le titre, les liens de téléchargement, puis loadCV() re-fetch le CV (FR ou EN) pour régénérer les sections dynamiques.
Le sélecteur FR/EN (bouton globe + drapeaux), intégré à la barre de navigation (desktop) et au menu burger (mobile).
10 Sécurité & Performance
HTTPS, en-têtes de sécurité et cache maîtrisé.
| Mesure | Mise en œuvre |
|---|---|
| HTTPS forcé | Redirection 301 + HSTS (`.htaccess`) |
| En-têtes de sécurité | X-Content-Type-Options, X-Frame-Options, Referrer-Policy |
| Cache | HTML no-cache ; CSS/JS/SVG 1 jour ; images 7 jours |
| Secrets | Clés SSH dédiées côté CI, jamais de secret en clair dans le repo |
| Hygiène git | PDF, logs et secrets exclus via `.gitignore` |
| Données de contact | Usage strictement professionnel (CGU) : interdiction prospection, pub, démarchage, robots, scraping |
11 Retours d'expérience
Ce que ce projet m'a appris.
- Concevoir un pipeline autour d'une source de vérité unique (le CV) et bien délimiter ce qui est régénéré de ce qui est maintenu à la main.
- Mettre en place un i18n complet (dictionnaire + re-fetch) sans framework, en JavaScript vanilla.
- Migrer un pipeline GitLab CI → Jenkins (Multibranch) en conservant la logique de déploiement.
- Maîtriser les enjeux de cache (CDN/navigateur) et de sécurité d'un site statique (`.htaccess`).
