Skip to content

Clarify how you need to configure builder for Helm air gap installs #3339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jul 2, 2025

Conversation

paigecalvert
Copy link
Contributor

@paigecalvert paigecalvert commented Jun 26, 2025

Update the Helm Air Gap Install page with a prerequisite to configure the builder key: https://deploy-preview-3339--replicated-docs.netlify.app/vendor/helm-install-airgap

Added new troubleshooting section about this builder requirement: https://deploy-preview-3339--replicated-docs.netlify.app/vendor/helm-install-troubleshooting#incomplete-list-of-required-images-in-the-helm-air-gap-instructions

Update the description of the builder key with info about how it's used to create helm air gap instructions: https://deploy-preview-3339--replicated-docs.netlify.app/reference/custom-resource-helmchart-v2#builder

Copy link

netlify bot commented Jun 26, 2025

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit 4b1987f
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6862bfa856a26d00087b68a4
😎 Deploy Preview https://deploy-preview-3339--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link

netlify bot commented Jun 26, 2025

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit 4b1987f
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6862bfa884119c0007233316
😎 Deploy Preview https://deploy-preview-3339--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels Jun 26, 2025
@paigecalvert paigecalvert marked this pull request as ready for review June 27, 2025 15:10
@paigecalvert paigecalvert requested a review from a team as a code owner June 27, 2025 15:10
@paigecalvert paigecalvert requested a review from crdant June 27, 2025 16:11

Each tab provides instructions for how to install, perform a manual update, or configure automatic updates, respectively.
* If your Helm chart's default values do not expose all the required and optional images that might be needed to install in air-gapped environments, add the Replicated HelmChart custom resource to your release and configure `builder` key. For more information, see [builder](/reference/custom-resource-helmchart-v2#builder) in _HelmChart v2_. If your default values expose all images needed for air gap installations, you do not need to configure the `builder` key.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added "If your Helm chart's default values do not expose all the required and optional images that might be needed to install in air-gapped environments..." and "If your default values expose all images needed for air gap installations, you do not need to configure the builder key." per feedback


For more information, see [Package Air Gap Bundles for Helm Charts](/vendor/helm-packaging-airgap-bundles).
The list of images is also used when you build the `.airgap` bundle for a release to support air gap installations with a Replicated installer (Embedded Cluster, KOTS, kURL). For more information about how to build `.airgap` bundles, see [Package Air Gap Bundles for Helm Charts](/vendor/helm-packaging-airgap-bundles).
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

^ Updated this description per feedback to explain how the air gap instructions are automatically available in the enterprise portal & how you have to trigger an air gap bundle build yourself

@paigecalvert paigecalvert merged commit f952f23 into main Jul 2, 2025
5 checks passed
@paigecalvert paigecalvert deleted the 125539 branch July 2, 2025 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type::docs Improvements or additions to documentation type::feature
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants