VCF Architectures & Blueprints Documentation
Documentation · v1.1

Guide de la Bibliothèque

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.

01 À propos

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.

02 Chiffres & formats

639
Schémas
13
Catégories
238
Bitmap natifs
401
Vectoriels rendus
8836
Pages source
146 Mo
Total assets

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.

04 Raccourcis clavier

/Focus sur la recherche
Entrée / EspaceOuvrir la carte focus
/ Naviguer dans la vue détail
EscFermer la vue détail
Clic imageZoom 1,8× dans la vue détail

05 Stack technique

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.

06 Structure des fichiers

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.

07 Méthode d'extraction

Les 639 schémas ont été extraits du PDF source par un pipeline hybride, car la documentation VCF mélange deux types d'images.

Sources bitmap (238 schémas)

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.

Sources vectorielles (401 schémas)

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.

Post-traitement v1.1

Version 1.1 ajoute deux passes de qualité :

08 Ajouter une nouvelle version VCF

Le pipeline est versionné par PDF source. Pour publier une nouvelle version (par exemple VCF 9.2) :

  1. Placer le nouveau PDF dans le dossier d'entrée du pipeline d'extraction.
  2. Lancer le pipeline (7 batches de ~55 s chacun, ~7 min au total).
  3. Régénérer data.json depuis les métadonnées produites.
  4. Recopier les nouveaux schemas/ et thumbs/.
  5. Bumper le champ 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.

09 Accès & utilisateurs

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.

Patterns recommandés

10 Déploiement

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.

En-têtes de cache appliqués par défaut

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

11 Crédits & source

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.