Accueil À propos Expérience Formations Certification Projets Compétences Ressources Contact
DevOps · Projet personnel · Portfolio

Portfolio — Site personnel & pipeline de génération/déploiement

Site vitrine one-page bilingue (FR/EN) généré depuis une source de vérité unique : le CV. Génération automatisée (traduction IA, sections, PDF), pipeline CI/CD Jenkins et déploiement rsync en production.

HTML/CSS JavaScript Python Bash GitLab Jenkins Docker Ansible Opencode

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é.

Page projet NocoDB
Une des pages projet (NocoDB) : la même structure est réutilisée pour chaque projet du portfolio.
Projet personnel mené en autonomie, en production sur un hébergement mutualisé (O2switch), déployé via un pipeline Jenkins.

02 Objectifs clés

Industrialiser la génération du CV et du site, puis automatiser le déploiement.

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écisionAlternative écartéeJustification
Site statique one-pageCMS (WordPress) / générateur (SSG)Zéro backend = zéro surface d'attaque, coût mutualisé, aucune mise à jour de sécurité
JavaScript vanillaReact / Vue / SPAPas d'étape de build ni de dépendance npm, un fichier lisible et léger
Source de vérité uniqueContenu dupliqué FR/EN/site maintenu à la mainUn seul point d'édition, zéro divergence entre CV, site et PDF
Traduction IA (opencode)Traduction manuelle du CV ENReproductible et rapide, avec des règles strictes de préservation
Déploiement rsyncFTP / git pull côté serveurIdempotent, --delete, exclusions cPanel scriptées
i18n maison (dictionnaire tr)Bibliothèque i18next / frameworkSans dépendance, quelques dizaines de clés suffisent
La complexité est assumée côté génération et CI, pas côté site : en production, le site reste un simple fichier statique servi par Apache.

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)
ScriptRôle
generate_cv.shOrchestrateur : check / translate / site / pdf-fr / pdf-en / all
generate_site_skills.pyRégénère #skills + synchronise contact/compteurs
generate_site_formations.pyRégénère #formations + #certifications (bloc unique)
generate_site_mobility.pyRégénère la tuile Mobilité de #contact
generate_site_projects.pySynchronise les tags des cartes projet vers les pages projet
Les sections du site (#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).

CommandeDescriptionSortie
checkValide l'intégrité du CV FR— (code 0/1)
translateTraduit FR → EN via opencodecv-vincent-dupeyron-en.html
siteRégénère les sections du sitesite/index.html
pdf-fr / pdf-enGénère les PDF (Chromium)cv/*.pdf
allEnchaîne translate → site → pdftous 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
Section Compétences générée
La section Compétences est générée automatiquement depuis le CV, avec ses icônes.

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.

PatternOùPourquoi
set -euo pipefailgenerate_cv.sh, ci/*.shÉchouer dès la première erreur, interdire les variables non définies
ROOT_DIR relatiftous les scripts BashAucun chemin absolu : exécutable depuis n'importe quel répertoire (runner CI)
Python stdlibgenerate_site_*.py, check_cv_fr.pyZéro dépendance pip, reproductible sur toute machine
clé SSH → 600 + trapdeploy / maintenance / destroySecret jamais en clair, nettoyage garanti même en cas d'erreur
rsync --delete + exclusionsdeploy_o2switch.shDéploiement idempotent, préservation des éléments cPanel
filtre anti rsync 23deploy_o2switch.shÉviter l'erreur rsync 23 en déploiement FR-only
Chromium --print-to-pdfgenerate_cv.shPDF 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
Ces patterns valent aussi en exécution locale : un même script est lancé à la main, par Ansible ou par Jenkins, avec le même comportement.

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'
                }
            }
        }
    }
}
Pipeline Jenkins
Les 7 stages du pipeline Jenkins (Stage View).
StageBrancheRôle
site-MaintenancemainChoix Deploy / Maintenance
cv-checktoutesValidation du CV (fail fast)
cv-pdf-fr / cv-pdf-entoutesGénération des PDF
site-buildtoutesRégénération des sections du site
deploymainrsync du site + CV (automatique)
destroymainSuppression du déploiement (manuel, timeout)
Le déploiement (rsync --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.

Hero en français
Page d'accueil — hero en français.
Hero en anglais
Même hero en anglais, après bascule du sélecteur de langue.
FR EN

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é.

MesureMise en œuvre
HTTPS forcéRedirection 301 + HSTS (`.htaccess`)
En-têtes de sécuritéX-Content-Type-Options, X-Frame-Options, Referrer-Policy
CacheHTML no-cache ; CSS/JS/SVG 1 jour ; images 7 jours
SecretsClés SSH dédiées côté CI, jamais de secret en clair dans le repo
Hygiène gitPDF, logs et secrets exclus via `.gitignore`
Données de contactUsage strictement professionnel (CGU) : interdiction prospection, pub, démarchage, robots, scraping
Les clés SSH de déploiement sont stockées dans Jenkins Credentials ; les PDF générés ne sont jamais versionnés.

11 Retours d'expérience

Ce que ce projet m'a appris.