Démarrer sur un site air-gapped

Olivares AI est prêt pour l’air-gap par conception : un binaire statique unique, un store SQLite embarqué, une validation de licence hors ligne (Ed25519), et aucun appel sortant obligatoire au démarrage — il n’y a pas de télémétrie-maison à désactiver. Ce tutoriel atteint la première valeur sur un réseau sans aucun accès internet, par l’une des deux voies honnêtes :

• Voie A — le binaire statique. L’air-gap le plus simple qui soit : transportez un seul fichier vérifié à travers la coupure et exécutez-le (avec systemd, comme dans le tutoriel nœud unique).
• Voie B — le bundle signé, pour un cluster. Transportez le bundle de release, vérifiez chaque image et le chart entièrement hors ligne, mettez en miroir dans votre registre privé par digest, et installez avec Helm.

Les mécanismes des scripts de bundle (airgap-bundle.sh, airgap-mirror.sh, vérification cosign hors ligne) sont documentés dans installer dans un environnement air-gapped — cette page est la visite de bout en bout qui les utilise.

Voie A — le binaire statique

1. Du côté connecté, compilez (ou, une fois les releases publiées, téléchargez et vérifiez) le binaire, et enregistrez son digest :

   task build
   sha256sum bin/olivares > olivares.sha256

2. Transportez les deux fichiers à travers la coupure sur votre support approuvé, et vérifiez le digest du côté déconnecté :

   sha256sum --check olivares.sha256

3. Installez et exécutez exactement comme dans le tutoriel nœud unique — unité systemd, jeton de configuration à usage unique, première organisation. Rien dans ce flux ne touche le réseau : le matériel TLS est généré localement, la licence (si vous en avez une) se valide hors ligne, et le store est le SQLite embarqué.

4. Câblez des sources qui observent les systèmes locaux — traînées de journaux pgAudit, fichiers CloudTrail livrés à l’intérieur du périmètre, flux eBPF/Tetragon. La configuration des sources est un fichier local ; aucun connecteur ne téléphone à l’extérieur à moins que vous n’en configuriez un pour atteindre quelque chose.

C’est la forme de départ recommandée pour un site déconnecté : nœud unique, SQLite, sources locales. C’est le même moteur — vous pourrez évoluer vers la voie cluster plus tard sans changer ce que vous avez appris.

Voie B — le bundle signé, pour un cluster

1. En ligne, une fois : un mainteneur compile le bundle autonome — chaque image épinglée par digest, le chart Helm empaqueté et signé, SBOM/OpenVEX/provenance rassemblés, plus la clé publique et un VERIFY.md avec la visite hors ligne exacte :

   scripts/airgap-bundle.sh --version <v> \
     --image <olivares-image-ref> \
     --chart deploy/helm/olivares \
     --cosign-key cosign.key

2. À l’intérieur de la coupure, vérifiez tout hors ligne. Vous n’avez besoin que de cosign, crane, helm et tar — la confiance vient du cosign.pub empaqueté, pas d’un quelconque journal de transparence en ligne :

   for d in images/*/; do
     cosign verify --local-image "$d" --insecure-ignore-tlog --key cosign.pub
   done
   cosign verify-blob --key cosign.pub --insecure-ignore-tlog \
     --signature chart/*.tgz.sig chart/*.tgz

3. Mettez en miroir dans votre registre privé par digest (le script ré-épingle et confirme que le digest a survécu au miroir) :

   scripts/airgap-mirror.sh --bundle olivares-airgap-<v>.tar.gz \
     --registry registry.internal:5000

4. Installez par digest, jamais par tag, puis suivez le tutoriel Kubernetes à partir du jeton de premier démarrage — c’est le même chart et le même flux :

   helm install olivares \
     oci://registry.internal:5000/charts/olivares \
     --version <chart-version> \
     --set image.repository=registry.internal:5000/olivares \
     --set image.digest=<digest-from-digests.txt>

Ce que « air-gapped » couvre honnêtement

Le control plane tourne entièrement à l’intérieur de votre périmètre — gouvernance, observation, la carte d’accès, l’audit ledger. Ce qu’il ne peut pas faire, c’est faire tourner un modèle frontière courtier hors ligne : l’inférence Claude atteint toujours l’API d’Anthropic (directement ou via Bedrock/Vertex/Foundry), parce qu’Anthropic ne publie pas les poids. Air-gapped signifie les données de votre estate et son plan de gouvernance restent à la maison ; les modèles que vous auto-hébergez véritablement peuvent être entièrement hors ligne. Voir Honnêteté & limites.

Exploitation déconnectée

• Les sauvegardes fonctionnent à l’identique (olivares dr backup — bundle chiffré, KEK local) : sauvegarde & restauration. Stockez les bundles sur des supports distincts ; la règle 3-2-1 s’applique doublement sans réseau hors site.
• La vérification du ledger est entièrement hors ligne par conception : olivares audit verify --strict avec votre clé publique épinglée — dépannage § ledger.
• La supervision est un Prometheus local scrutant /metrics ; les règles d’alerte livrées n’ont besoin de rien d’externe — supervision.
• Les mises à jour répètent la boucle transporter-vérifier-mettre en miroir avec un nouveau bundle. Le manifeste de digests (digests.txt) est votre enregistrement de exactement ce qui tourne.

Étapes suivantes

• Installer dans un environnement air-gapped — la référence bundle/miroir, y compris le statut de la variante FIPS/STIG.
• Vérifier une release — la chaîne de vérification complète que ce flux applique hors ligne.
• Durcissement de la sécurité — le reste de la posture défensive.