cdf-orchestration-preflight

cdf-orchestration-preflight

Ce skill fait partie du catalogue officiel de skills NVIDIA, distribué via le repository nvidia/skills et installable dans Claude Code, Codex ou d'autres agents de développement. Il guide l'agent pour effectuer un audit de pré-installation complet avant tout déploiement du contrôleur Cosmos Data Factory (CDF) Orchestration.

Ce que fait ce skill

Le skill orchestre deux types de vérifications indépendantes :

• install_readiness : vérifie les prérequis locaux (Linux, outils, Python, container runtime), la configuration du repository, les credentials, l'accès Kubernetes, les StorageClasses ReadWriteMany/NFS, et la disponibilité de l'image Airflow (image pré-construite ou chemin de build local).
• run_readiness : évalue le contrôleur déployé et chaque DAG packagé, en vérifiant la disponibilité GPU (libnvcuvid.so.1 via les pods NVIDIA GPU Operator toolkit), les PVCs requis (dont shared-ffmpeg pour les modes Autonomous Vehicle Dataset Generation), et le mapping des buckets de stockage dans le secret multistorageclient-configuration-secret.

L'audit est strictement en lecture seule : il ne déploie rien, ne modifie aucune ressource cluster, et ne consigne jamais de credentials, tokens ou contenu de kubeconfig.

Périmètre et limites

Ce skill couvre exclusivement la phase de préflight. Il ne réalise pas le déploiement du contrôleur Helm (rôle du skill cdf-orchestration-setup, qui appelle ce preflight en premier), ni la création de payloads, ni le déclenchement de workflows. Toute remédiation de prérequis (installation de packages, configuration Kubernetes, GPU operator) est proposée à l'utilisateur avec affichage des commandes exactes et demande d'approbation explicite avant exécution.

Utilisation

Ce skill s'installe via le CLI skills :

npx skills add nvidia/skills --skill cdf-orchestration-preflight --agent claude-code

Une fois installé, l'agent l'active automatiquement lors de tâches liées à la vérification d'environnements CDF Orchestration. Il s'appuie sur le script scripts/preflight.py et la documentation de référence incluse dans le dossier du skill (bootstrap.md, readiness-model.md, nfs-remediation.md). Les résultats de l'audit sont présentés de façon granulaire — un environnement partiellement prêt est signalé précisément, sans être réduit à un unique pass/fail global.