639 schémas d'architecture extraits de la documentation officielle VMware Cloud Foundation 9.1, classifiés, catalogués et rendus searchables — dans la meilleure qualité d'image que le document source permet.
La VCF Architectures & Blueprints Library indexe visuellement chaque schéma, diagramme et blueprint publié dans la documentation officielle VMware Cloud Foundation 9.1 — une référence technique de 8 836 pages produite par VMware by Broadcom.
Un architecte cloud, un SRE ou un ingénieur avant-vente sait souvent qu'il existe un diagramme quelque part pour le sujet qu'il traite, mais le PDF est difficile à parcourir. Cette bibliothèque aplatit tout le document en un index visuel unique, conserve la meilleure résolution disponible et ajoute recherche et filtres par catégorie.
Chaque schéma est lié à sa page dans le PDF source. Cette bibliothèque complète la documentation officielle, elle ne la remplace pas.
Les schémas sont stockés en JPEG progressif (qualité 88 pour les diagrammes vectoriels rendus, 90 pour les bitmaps natifs). Chaque schéma a une miniature (max 500 px, ~25 Ko) pour la grille, et une version haute définition servie à la demande depuis la vue détail.
| / | Focus sur la recherche |
| Entrée / Espace | Ouvrir la carte focus |
| ← / → | Naviguer dans la vue détail |
| Esc | Fermer la vue détail |
| Clic image | Zoom 1,8× dans la vue détail |
L'application est délibérément zero-framework, zero-build. Elle est hébergeable sur n'importe quel serveur statique, fonctionne hors-ligne une fois chargée, et reste maintenable sans dérive de dépendances JavaScript.
data.json (~365 Ko) qui indexe les 639 schémas avec leurs métadonnées et l'arbre hiérarchique.schemas/ (haute définition) et thumbs/ (miniatures).arch.vcfninja.cloud/
├── index.html # UI principale
├── docs.html # cette page
├── data.json # métadonnées (639 schémas + hiérarchie)
├── assets/
│ ├── app.css # design system + composants
│ ├── app.js # logique (recherche, filtres, modal)
│ └── logo.svg # cube isométrique
├── schemas/ # 639 JPEG haute définition (~129 Mo)
│ └── fig_pXXXX_nXXXX.jpg
└── thumbs/ # 639 miniatures 500 px (~17 Mo)
└── fig_pXXXX_nXXXX_t.jpg
Chaque schéma suit la convention de nommage fig_p{page}_n{figure}.jpg, où page est la page dans le PDF source et figure le numéro de figure dans les légendes originales.
Les 639 schémas ont été extraits du PDF source par un pipeline hybride, car la documentation VCF mélange deux types d'images.
Les captures d'écran, diagrammes d'architecture exportés et copies d'écran tierces sont embarqués comme XObjects raster natifs. Le pipeline parse le content stream de chaque page, matche les noms d'XObject utilisés aux images embarquées, et extrait la plus grande à sa résolution native (souvent 3 000 à 4 800 px sur le grand côté). Le JPEG ou PNG natif est ré-encodé en JPEG progressif qualité 90.
Les diagrammes dessinés directement en PDF (depuis le rendu DITA d'Apache FOP) sont vectoriels — ils n'apparaissent pas dans l'extraction raster. Pour eux, le pipeline rasterise la page à 200 DPI, découpe la zone sous la légende Figure N:, puis auto-crop les marges blanches. Le résultat reste net car la source est vectorielle.
Version 1.1 ajoute deux passes de qualité :
Le pipeline est versionné par PDF source. Pour publier une nouvelle version (par exemple VCF 9.2) :
data.json depuis les métadonnées produites.schemas/ et thumbs/.meta.app_version dans data.json.Plusieurs versions peuvent cohabiter sous des préfixes d'URL tels que arch.vcfninja.cloud/9.1/, arch.vcfninja.cloud/9.2/, avec un sélecteur de version dans le topbar.
Comme le pipeline lit la table des matières du PDF pour construire l'arbre de classification, les catégories se réorganisent automatiquement lorsque VMware restructure la documentation — pas de re-tagging manuel.
La version 1.1 est en accès libre, sans login — le contenu dérive de documentation VMware publique, et la recherche est côté client. Ajouter de l'authentification ne nécessite pas de réécrire l'app ; une couche edge devant le hosting statique suffit.
data.json en base de données légère (Supabase, D1, SQLite via LiteFS) et d'ajouter une page admin.Le package est prêt pour Rocky Linux 9 (comme le projet VCF Decision Library) avec un script d'installation clé en main.
# Depuis le poste local
scp vcfninja-arch.tar.gz root@arch.vcfninja.cloud:/tmp/
# Sur le serveur Rocky 9
ssh root@arch.vcfninja.cloud
cd /tmp && tar xzf vcfninja-arch.tar.gz
sudo bash /tmp/vcfninja-arch/deploy/install.sh
sudo certbot --nginx -d arch.vcfninja.cloud
Le script gère : installation nginx / certbot / rsync, déploiement des fichiers, permissions, contextes SELinux, firewalld et rechargement du service. Idempotent : peut être ré-exécuté pour les mises à jour.
schemas/* Cache-Control: public, max-age=31536000, immutable
thumbs/* Cache-Control: public, max-age=31536000, immutable
assets/* Cache-Control: public, max-age=604800
data.json Cache-Control: public, max-age=3600
*.html Cache-Control: no-cache
Tous les schémas sont extraits de la documentation VMware Cloud Foundation 9.1 publiée par VMware by Broadcom. Le copyright des diagrammes appartient aux auteurs originaux. Cette bibliothèque les reproduit à des fins de référence et de navigation croisée ; consultez toujours la documentation officielle pour du contenu faisant autorité.
Charte graphique alignée sur VCF Decision Library. Pipeline d'extraction et intégration réalisés pour vcfninja.cloud.