Galileo On-Prem Air-Gap Setup
Prerequisites
- Obtain the CSE-provided release image manifest, exact chart archives,
galileoctl artifact, and any offline Wizard/Luna model bundles.
- Run the canonical Stack preflight first and retain its private, bundle-bound
rendered-image and rendered-endpoint evidence; static archive IDs or a
caller-authored endpoint list are not accepted as runtime proof.
- Configure that connected seed render with the final digest-pinned internal
mirror references before the registry contains them. The air-gap assembler
maps each rendered mirror digest back to a distinct CSE/vendor source archive;
it never treats source and mirror names as interchangeable.
- For every optional child classified
standalone, run its read-only preflight
with both --image-evidence-file and --endpoint-evidence-file, and retain
the exact immutable child bundle.
- Use a connected staging host for acquisition/scanning and an isolated transfer
path into a registry reachable by the cluster.
- Resolve every image to an immutable OCI digest and collect every target
architecture. Tag-only inventories are not completion evidence.
- Allocate approximately 50–60 GB or the release-specific measured total in the
private registry and transfer area.
Workflow Overview
+-- CSE manifest --+ -> +-- Pull/scan/digest/arch --+ -> +-- Verify transfer bundle --+
-> +-- Registry handoff --+
-> +-- No-egress proof --+
When to Activate
- Prepare a first Galileo install or upgrade with no cluster internet access.
- Audit private-registry completeness, architecture, digest, or scan evidence.
- Transfer Galileo charts, images, CLI, models, hooks, and test dependencies.
- Verify that rendered runtime endpoints do not require public egress.
- Diagnose
ImagePullBackOff, missing bootstrap images, or mutable tag drift.
Required Intake
Ask for the Galileo instance console URL and record the exact value, for example
https://console.demo-v2.galileocloud.io/. Pass it with
--galileo-console-url; this records the intended deployment without contacting
the instance.
Collect the release ID, target architectures, private registry, exact artifacts
and SHA-256 values, digest-resolved image/OCI mappings, image use classification,
scan attestations, model archives, exact Stack/child endpoint evidence, internal allowlist,
transfer medium policy, and CSE approval. Keep registry credentials outside this
skill and supply them only within the approved operator-controlled push session.
Supply-Chain Rules
- Require local regular current-user-owned single-link artifacts. Reject
symlinks, hardlinks, special files, unsafe permissions, path traversal,
duplicate archive members, PAX path overrides, oversized expansion, and
digest drift.
- Require every image to have a source reference, source digest, mirror
reference, expected mirror digest, OCI archive, architectures, and one or
more uses:
runtime, init, hook, job, test, or model.
- Reject
latest, tag-only proof, source/mirror digest mismatch, missing target
architectures, source/mirror role collapse (including the same registry
authority), and any chart-discovered image absent from the CSE manifest.
Scan attestations must be canonical duplicate-free JSON and bind the exact
vendor source subject plus digest with a real boolean pass result.
- Include
galileoctl, sequencing kubectl, database bootstrap clients,
migration/hook/test images, Agent Control, Luna backend/UI/training/data-gen,
Wizard/Triton and offline models whenever enabled.
- Classify Agent Control and Luna as
disabled, umbrella, or standalone.
Stack evidence owns umbrella images; every standalone child requires its own
canonical evidence. Require exact union equality—no extras or omissions.
Seed evidence must equal manifest mirror refs, while acquisition
provenance remains in source; require mirror_digest == source_digest.
Derive architectures only from descriptor/config platform pairs whose exact
Linux OS, architecture, and optional variant agree through a digest-, size-,
and media-type-closed OCI graph. Reject missing, duplicate, unknown,
mismatched, or unreferenced OCI evidence.
- Keep archive verification and registry push separate.
--push-registry is a
permanent fail-closed sentinel. Hand the exact digest inventory and CSE
approval to an operator-controlled session that rejects tag overwrite.
- Never auto-upload artifacts, rewrite charts, create pull Secrets, or touch
Kubernetes. Hand the verified contract to the stack/service skills.
- A no-egress pass requires the exact union of target/chart/input/render-bound
Stack and standalone-child host-only endpoint evidence to be internal. The
verifier also independently scans embedded non-secret values and chart
templates and rejects unexplained findings. It must
block public registries, Let’s Encrypt, SendGrid, Sentry/Logz, central feature
flags, public model APIs, telemetry, and package repositories.
Host-only observations do not prove endpoint rewrites. Until Stack emits
galileo-on-prem-stack-endpoint-rewrite-evidence/v1, no-egress completion
fails as endpoint_rewrite_evidence_missing.
- Offline model archives remain transfer artifacts, not runtime proof. Until
Stack emits
galileo-on-prem-stack-model-artifact-evidence/v1 binding the
exact archive checksum to rendered mounts/config and checksum-verifier
behavior, model completion fails as stack_model_evidence_missing.
- Reject Helm
lookup, tpl, root .Files, .Capabilities, .Release,
random/UUID/clock, environment, DNS, crypto, and indirect root access
recursively in the parent chart and packaged dependencies; those constructs
make exact offline render/image/endpoint evidence impossible to prove.
Read reference.md, manifest-contract.md,
registry-and-transfer.md, and
source-ledger.md before approving a transfer.
Commands
bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh --help
bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \
--render --spec ./air-gap.local.yaml \
--galileo-console-url "https://console.demo-v2.galileocloud.io/" \
--output-dir ./galileo-on-prem-rendered/air-gap
bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \
--verify --bundle ./galileo-on-prem-rendered/air-gap \
--galileo-console-url "https://console.demo-v2.galileocloud.io/"
Registry push is an explicit non-mutating handoff sentinel:
bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \
--push-registry
The sentinel fails before reading a bundle, credential, approval, or result
path. The verified bundle metadata is the handoff packet for the external
Galileo/CSE operator session.
Completion Gate
Completion requires exact hashes for every transfer artifact, safe archive
structure, all chart inventory images classified, all target architectures in
every image, passing scan attestations, verified source/mirror digest equality,
operator-supplied post-push registry inspection, and unapproved_endpoints=[]
plus no open evidence gates in the no-egress report. It also requires the exact Stack-plus-standalone-child image
union and the Stack seed/final equality gate. Static verification does not claim
a deployment or GPU test.
Troubleshooting
| Symptom |
Cause |
Resolution |
| Image inventory mismatch |
Init/hook/test/bootstrap image omitted |
Regenerate inventory from the exact charts and CSE manifest |
| Architecture failure |
Archive lacks a node architecture |
Acquire the correct multi-arch image or constrain scheduling |
| Digest failure |
Tag moved or transfer was altered |
Re-pull by digest and recreate the OCI archive |
| Push blocked |
Registry writes are handoff-only without an entitled live fixture |
Use the exact bundle/digests in a CSE-reviewed operator session; reject tag overwrite |
| Model evidence blocked |
Stack lacks rendered model mount/config/checksum-verifier proof |
Keep stack_model_evidence_missing open until the versioned Stack evidence exists |
| Endpoint closure blocked |
Host-only evidence cannot bind source-to-mirror scheme/port rewrites |
Keep endpoint_rewrite_evidence_missing open until the versioned Stack evidence exists |
| No-egress failure |
Runtime still names a public endpoint |
Disable the feature or provide an approved internal endpoint |
| Unsafe archive |
Traversal, links, duplicates, PAX override, or expansion limit |
Reject it and obtain a clean vendor artifact |
1---2name: galileo-on-prem-air-gap-setup3description: >-4 Build and verify a digest-bound Galileo On-Prem air-gap supply-chain bundle5 covering Helm charts, galileoctl, every ordinary/init/hook/job/test image,6 OCI archives, model bundles, architectures, private-registry mappings,7 scanning evidence, and no-egress endpoints, while surfacing explicit8 model/runtime and endpoint-rewrite evidence gates. Use when preparing,9 transferring, mirroring, upgrading, or auditing Galileo for an offline Kubernetes cluster.10compatibility: "No direct Splunk Platform runtime dependency. This workflow can be used alongside Splunk Cloud Platform 10.5.2605 through its documented external APIs or handoffs."11metadata:12 source: https://skillmd.com/skills/chambear2809/galileo-on-prem-air-gap-setup13 splunk_cloud_10_5: "not-applicable"14 compatibility_verified: "2026-08-20"15---1617# Galileo On-Prem Air-Gap Setup1819## Prerequisites2021- Obtain the CSE-provided release image manifest, exact chart archives,22 `galileoctl` artifact, and any offline Wizard/Luna model bundles.23- Run the canonical Stack preflight first and retain its private, bundle-bound24 rendered-image and rendered-endpoint evidence; static archive IDs or a25 caller-authored endpoint list are not accepted as runtime proof.26- Configure that connected seed render with the final digest-pinned internal27 mirror references before the registry contains them. The air-gap assembler28 maps each rendered mirror digest back to a distinct CSE/vendor source archive;29 it never treats source and mirror names as interchangeable.30- For every optional child classified `standalone`, run its read-only preflight31 with both `--image-evidence-file` and `--endpoint-evidence-file`, and retain32 the exact immutable child bundle.33- Use a connected staging host for acquisition/scanning and an isolated transfer34 path into a registry reachable by the cluster.35- Resolve every image to an immutable OCI digest and collect every target36 architecture. Tag-only inventories are not completion evidence.37- Allocate approximately 50–60 GB or the release-specific measured total in the38 private registry and transfer area.3940## Workflow Overview4142```text43+-- CSE manifest --+ -> +-- Pull/scan/digest/arch --+ -> +-- Verify transfer bundle --+44 -> +-- Registry handoff --+45 -> +-- No-egress proof --+46```4748## When to Activate4950- Prepare a first Galileo install or upgrade with no cluster internet access.51- Audit private-registry completeness, architecture, digest, or scan evidence.52- Transfer Galileo charts, images, CLI, models, hooks, and test dependencies.53- Verify that rendered runtime endpoints do not require public egress.54- Diagnose `ImagePullBackOff`, missing bootstrap images, or mutable tag drift.5556## Required Intake5758Ask for the Galileo instance console URL and record the exact value, for example59`https://console.demo-v2.galileocloud.io/`. Pass it with60`--galileo-console-url`; this records the intended deployment without contacting61the instance.6263Collect the release ID, target architectures, private registry, exact artifacts64and SHA-256 values, digest-resolved image/OCI mappings, image use classification,65scan attestations, model archives, exact Stack/child endpoint evidence, internal allowlist,66transfer medium policy, and CSE approval. Keep registry credentials outside this67skill and supply them only within the approved operator-controlled push session.6869## Supply-Chain Rules70711. Require local regular current-user-owned single-link artifacts. Reject72 symlinks, hardlinks, special files, unsafe permissions, path traversal,73 duplicate archive members, PAX path overrides, oversized expansion, and74 digest drift.752. Require every image to have a source reference, source digest, mirror76 reference, expected mirror digest, OCI archive, architectures, and one or77 more uses: `runtime`, `init`, `hook`, `job`, `test`, or `model`.783. Reject `latest`, tag-only proof, source/mirror digest mismatch, missing target79 architectures, source/mirror role collapse (including the same registry80 authority), and any chart-discovered image absent from the CSE manifest.81 Scan attestations must be canonical duplicate-free JSON and bind the exact82 vendor source subject plus digest with a real boolean pass result.834. Include `galileoctl`, sequencing `kubectl`, database bootstrap clients,84 migration/hook/test images, Agent Control, Luna backend/UI/training/data-gen,85 Wizard/Triton and offline models whenever enabled.865. Classify Agent Control and Luna as `disabled`, `umbrella`, or `standalone`.87 Stack evidence owns umbrella images; every standalone child requires its own88 canonical evidence. Require exact union equality—no extras or omissions.89 Seed evidence must equal manifest `mirror` refs, while acquisition90 provenance remains in `source`; require `mirror_digest == source_digest`.91 Derive architectures only from descriptor/config platform pairs whose exact92 Linux OS, architecture, and optional variant agree through a digest-, size-,93 and media-type-closed OCI graph. Reject missing, duplicate, unknown,94 mismatched, or unreferenced OCI evidence.956. Keep archive verification and registry push separate. `--push-registry` is a96 permanent fail-closed sentinel. Hand the exact digest inventory and CSE97 approval to an operator-controlled session that rejects tag overwrite.987. Never auto-upload artifacts, rewrite charts, create pull Secrets, or touch99 Kubernetes. Hand the verified contract to the stack/service skills.1008. A no-egress pass requires the exact union of target/chart/input/render-bound101 Stack and standalone-child host-only endpoint evidence to be internal. The102 verifier also independently scans embedded non-secret values and chart103 templates and rejects unexplained findings. It must104 block public registries, Let’s Encrypt, SendGrid, Sentry/Logz, central feature105 flags, public model APIs, telemetry, and package repositories.106 Host-only observations do not prove endpoint rewrites. Until Stack emits107 `galileo-on-prem-stack-endpoint-rewrite-evidence/v1`, no-egress completion108 fails as `endpoint_rewrite_evidence_missing`.1099. Offline model archives remain transfer artifacts, not runtime proof. Until110 Stack emits `galileo-on-prem-stack-model-artifact-evidence/v1` binding the111 exact archive checksum to rendered mounts/config and checksum-verifier112 behavior, model completion fails as `stack_model_evidence_missing`.11310. Reject Helm `lookup`, `tpl`, root `.Files`, `.Capabilities`, `.Release`,114 random/UUID/clock, environment, DNS, crypto, and indirect root access115 recursively in the parent chart and packaged dependencies; those constructs116 make exact offline render/image/endpoint evidence impossible to prove.117118Read [reference.md](reference.md), [manifest-contract.md](references/manifest-contract.md),119[registry-and-transfer.md](references/registry-and-transfer.md), and120[source-ledger.md](references/source-ledger.md) before approving a transfer.121122## Commands123124```bash125bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh --help126```127128```bash129bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \130 --render --spec ./air-gap.local.yaml \131 --galileo-console-url "https://console.demo-v2.galileocloud.io/" \132 --output-dir ./galileo-on-prem-rendered/air-gap133```134135```bash136bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \137 --verify --bundle ./galileo-on-prem-rendered/air-gap \138 --galileo-console-url "https://console.demo-v2.galileocloud.io/"139```140141Registry push is an explicit non-mutating handoff sentinel:142143```bash144bash skills/galileo-on-prem-air-gap-setup/scripts/setup.sh \145 --push-registry146```147148The sentinel fails before reading a bundle, credential, approval, or result149path. The verified bundle metadata is the handoff packet for the external150Galileo/CSE operator session.151152## Completion Gate153154Completion requires exact hashes for every transfer artifact, safe archive155structure, all chart inventory images classified, all target architectures in156every image, passing scan attestations, verified source/mirror digest equality,157operator-supplied post-push registry inspection, and `unapproved_endpoints=[]`158plus no open evidence gates in the no-egress report. It also requires the exact Stack-plus-standalone-child image159union and the Stack seed/final equality gate. Static verification does not claim160a deployment or GPU test.161162## Troubleshooting163164| Symptom | Cause | Resolution |165|---|---|---|166| Image inventory mismatch | Init/hook/test/bootstrap image omitted | Regenerate inventory from the exact charts and CSE manifest |167| Architecture failure | Archive lacks a node architecture | Acquire the correct multi-arch image or constrain scheduling |168| Digest failure | Tag moved or transfer was altered | Re-pull by digest and recreate the OCI archive |169| Push blocked | Registry writes are handoff-only without an entitled live fixture | Use the exact bundle/digests in a CSE-reviewed operator session; reject tag overwrite |170| Model evidence blocked | Stack lacks rendered model mount/config/checksum-verifier proof | Keep `stack_model_evidence_missing` open until the versioned Stack evidence exists |171| Endpoint closure blocked | Host-only evidence cannot bind source-to-mirror scheme/port rewrites | Keep `endpoint_rewrite_evidence_missing` open until the versioned Stack evidence exists |172| No-egress failure | Runtime still names a public endpoint | Disable the feature or provide an approved internal endpoint |173| Unsafe archive | Traversal, links, duplicates, PAX override, or expansion limit | Reject it and obtain a clean vendor artifact |