deploy: 75674fd

docs/how-to-guides/enbuild-helm-chart-installation-in-airgapped-kubernetes-environment/index.html

@@ -12,7 +12,7 @@
 How-to Guides</button><div class="collapse show" id=section-353abe45692fc2cda5002868689ae0c1><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/deploying-enbuild-for-local-testing/>Deploying ENBUILD for Local Testing</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/configuring-enbuild/>Configuring ENBUILD</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/deploying-enbuild-using-enbuild-cli/>Deploying ENBUILD using ENBUILD CLI</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/deploying-enbuild-using-ironbank-images/>Deploying ENBUILD Using IronBank Images</a></li><li><a class="docs-link rounded active" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/enbuild-helm-chart-installation-in-airgapped-kubernetes-environment/>ENBUILD Helm Chart Installation in Airgapped Kubernetes Environment</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/deploying-bigbang/>Deploying Bigbang</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/deploying-kubernetes/>Deploying Kubernetes</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/installing-istio/>Installing Istio</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/using-enbuild-ami/>Using ENBUILD AMI</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/exposing-enbuild-ui/>Exposing ENBUILD UI</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/install-and-configure-keycloak-for-enbuild-sso/>Install and Configure Keycloak for ENBUILD SSO</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/creting-new-catalog-template-repository/>Creting new catalog template repository</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/adding-new-catalog-item-in-enbuild/>Adding new Catalog Item in ENBUILD</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/installing-nginx-ingress/>Installing Nginx Ingress</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/how-to-guides/exporting-catalog-item-from-enbuild/>Exporting Catalog Item from ENBUILD</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-231cf4c70d866b616c21baddaeed0696 aria-expanded=false>
 Troubleshooting</button><div class=collapse id=section-231cf4c70d866b616c21baddaeed0696><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/troubleshooting/kubectl-cheat-sheet/>Kubectl Cheat Sheet</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-1fe917b01f9a3f87fa2d7d3b7643fac1 aria-expanded=false>
 FAQ</button><div class=collapse id=section-1fe917b01f9a3f87fa2d7d3b7643fac1><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/faq/frequently-asked-questions/>Frequently Asked Questions</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/faq/glossary/>Glossary</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-d95867deadfe690e40f42068d6b59df8 aria-expanded=false>
-References</button><div class=collapse id=section-d95867deadfe690e40f42068d6b59df8><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/argocd/>ArgoCD</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/platform-one-big-bang/>Platform One Big Bang</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/gitlab/>GitLab</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/helm/>Helm</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/istio/>Istio</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/k3d/>K3D</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>On this page</h3><nav id=toc><ul><li><a href=#prerequisites>Prerequisites</a></li><li><a href=#steps>Steps</a><ul><li><a href=#1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment</a></li><li><a href=#2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry</a></li><li><a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node</a></li><li><a href=#4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File</a></li><li><a href=#5-load-the-enbuild-haul-file-and-start-the-registry>5. Load the ENBUILD Haul File and Start the Registry</a></li><li><a href=#6-configure-kubernetes-to-use-the-private-registry>6. Configure Kubernetes to Use the Private Registry</a></li><li><a href=#7-create-configuration-files-for-enbuild-installation>7. Create Configuration Files for ENBUILD Installation</a></li><li><a href=#8-install-the-enbuild-helm-chart>8. Install the ENBUILD Helm Chart</a></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><h1>ENBUILD Helm Chart Installation in Airgapped Kubernetes Environment</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#prerequisites>Prerequisites</a></li><li><a href=#steps>Steps</a><ul><li><a href=#1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment</a></li><li><a href=#2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry</a></li><li><a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node</a></li><li><a href=#4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File</a></li><li><a href=#5-load-the-enbuild-haul-file-and-start-the-registry>5. Load the ENBUILD Haul File and Start the Registry</a></li><li><a href=#6-configure-kubernetes-to-use-the-private-registry>6. Configure Kubernetes to Use the Private Registry</a></li><li><a href=#7-create-configuration-files-for-enbuild-installation>7. Create Configuration Files for ENBUILD Installation</a></li><li><a href=#8-install-the-enbuild-helm-chart>8. Install the ENBUILD Helm Chart</a></li></ul></li></ul></nav></div></details></nav><h1 id=enbuild-helm-chart-installation-in-airgapped-kubernetes-environment>ENBUILD Helm Chart Installation in Airgapped Kubernetes Environment</h1><p>This document provides a step-by-step guide for deploying the ENBUILD Helm chart in a disconnected (airgapped) Kubernetes environment using an ENBUILD haul file.</p><h2 id=prerequisites>Prerequisites<a href=#prerequisites class=anchor aria-hidden=true>#</a></h2><ul><li>Kubernetes cluster (EKS, RKE2, or K3s) installed in the airgapped environment.</li><li>A micro instance or one of the nodes to act as the Hauler registry.</li><li>Access to the ENBUILD haul package (how to transfer the haul file to the airgapped environment is beyond the scope of this document).</li></ul><h2 id=steps>Steps<a href=#steps class=anchor aria-hidden=true>#</a></h2><h3 id=1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment<a href=#1-install-kubernetes-in-the-airgapped-environment class=anchor aria-hidden=true>#</a></h3><p>Install the Kubernetes environment in the client&rsquo;s disconnected environment. Follow the installation guide for the respective Kubernetes distribution:</p><ul><li><a href=https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html>EKS Installation Guide</a></li><li><a href=https://docs.rke2.io/install/>RKE2 Installation Guide</a></li><li><a href=https://docs.k3s.io/installation/>K3s Installation Guide</a></li></ul><h3 id=2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry<a href=#2-create-a-micro-instance-for-the-hauler-registry class=anchor aria-hidden=true>#</a></h3><p>Set up a micro instance in the airgapped environment to host the Hauler registry. For K3s or RKE2, this can be one of the existing nodes.</p><h3 id=3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node<a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node class=anchor aria-hidden=true>#</a></h3><p>Install the necessary binaries on the node that will act as the Hauler registry:</p><ul><li><strong>Hauler</strong>: <a href=https://docs.hauler.dev>Hauler Installation</a></li><li><strong>kubectl</strong>: <a href=https://kubernetes.io/docs/tasks/tools/>Install kubectl</a></li><li><strong>Helm</strong>: <a href=https://helm.sh/docs/intro/install/>Install Helm</a></li></ul><h3 id=4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File<a href=#4-download-the-enbuild-haul-file class=anchor aria-hidden=true>#</a></h3><p>The ENBUILD haul file is available as a <a href=https://enbuild-haul.s3.us-east-1.amazonaws.com/enbuild-0.0.20.tar.zst>public artifact</a> in the Vivsoft AWS S3 bucket. This file should be downloaded and transferred to a client-side S3 bucket (how to transfer the file is beyond the scope of this document). Once the file is available in the client’s side S3 bucket, download it on the registry server using the following command:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=cl><span class=nv>ENBUILD_HELM_CHART_VERSION</span><span class=o>=</span>0.0.20
+References</button><div class=collapse id=section-d95867deadfe690e40f42068d6b59df8><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/argocd/>ArgoCD</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/platform-one-big-bang/>Platform One Big Bang</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/gitlab/>GitLab</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/helm/>Helm</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/istio/>Istio</a></li><li><a class="docs-link rounded" href=https://enbuild-docs.vivplatform.io/docs/references/k3d/>K3D</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>On this page</h3><nav id=toc><ul><li><a href=#prerequisites>Prerequisites</a></li><li><a href=#steps>Steps</a><ul><li><a href=#1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment</a></li><li><a href=#2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry</a></li><li><a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node</a></li><li><a href=#4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File</a></li><li><a href=#5-load-the-enbuild-haul-file-and-start-the-registry>5. Load the ENBUILD Haul File and Start the Registry</a></li><li><a href=#6-configure-kubernetes-to-use-the-private-registry>6. Configure Kubernetes to Use the Private Registry</a></li><li><a href=#7-create-configuration-files-for-enbuild-installation>7. Create Configuration Files for ENBUILD Installation</a></li><li><a href=#8-install-the-enbuild-helm-chart>8. Install the ENBUILD Helm Chart</a></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><h1>ENBUILD Helm Chart Installation in Airgapped Kubernetes Environment</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#prerequisites>Prerequisites</a></li><li><a href=#steps>Steps</a><ul><li><a href=#1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment</a></li><li><a href=#2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry</a></li><li><a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node</a></li><li><a href=#4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File</a></li><li><a href=#5-load-the-enbuild-haul-file-and-start-the-registry>5. Load the ENBUILD Haul File and Start the Registry</a></li><li><a href=#6-configure-kubernetes-to-use-the-private-registry>6. Configure Kubernetes to Use the Private Registry</a></li><li><a href=#7-create-configuration-files-for-enbuild-installation>7. Create Configuration Files for ENBUILD Installation</a></li><li><a href=#8-install-the-enbuild-helm-chart>8. Install the ENBUILD Helm Chart</a></li></ul></li></ul></nav></div></details></nav><p>This document provides a step-by-step guide for deploying the ENBUILD Helm chart in a disconnected (airgapped) Kubernetes environment using an ENBUILD haul file.</p><h2 id=prerequisites>Prerequisites<a href=#prerequisites class=anchor aria-hidden=true>#</a></h2><ul><li>Kubernetes cluster (EKS, RKE2, or K3s) installed in the airgapped environment.</li><li>A micro instance or one of the nodes to act as the Hauler registry.</li><li>Access to the ENBUILD haul package (how to transfer the haul file to the airgapped environment is beyond the scope of this document).</li></ul><h2 id=steps>Steps<a href=#steps class=anchor aria-hidden=true>#</a></h2><h3 id=1-install-kubernetes-in-the-airgapped-environment>1. Install Kubernetes in the Airgapped Environment<a href=#1-install-kubernetes-in-the-airgapped-environment class=anchor aria-hidden=true>#</a></h3><p>Install the Kubernetes environment in the client&rsquo;s disconnected environment. Follow the installation guide for the respective Kubernetes distribution:</p><ul><li><a href=https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html>EKS Installation Guide</a></li><li><a href=https://docs.rke2.io/install/>RKE2 Installation Guide</a></li><li><a href=https://docs.k3s.io/installation/>K3s Installation Guide</a></li></ul><h3 id=2-create-a-micro-instance-for-the-hauler-registry>2. Create a Micro Instance for the Hauler Registry<a href=#2-create-a-micro-instance-for-the-hauler-registry class=anchor aria-hidden=true>#</a></h3><p>Set up a micro instance in the airgapped environment to host the Hauler registry. For K3s or RKE2, this can be one of the existing nodes.</p><h3 id=3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node>3. Install Hauler, kubectl, and Helm Binaries on the Registry Node<a href=#3-install-hauler-kubectl-and-helm-binaries-on-the-registry-node class=anchor aria-hidden=true>#</a></h3><p>Install the necessary binaries on the node that will act as the Hauler registry:</p><ul><li><strong>Hauler</strong>: <a href=https://docs.hauler.dev>Hauler Installation</a></li><li><strong>kubectl</strong>: <a href=https://kubernetes.io/docs/tasks/tools/>Install kubectl</a></li><li><strong>Helm</strong>: <a href=https://helm.sh/docs/intro/install/>Install Helm</a></li></ul><h3 id=4-download-the-enbuild-haul-file>4. Download the ENBUILD Haul File<a href=#4-download-the-enbuild-haul-file class=anchor aria-hidden=true>#</a></h3><p>The ENBUILD haul file is available as a <a href=https://enbuild-haul.s3.us-east-1.amazonaws.com/enbuild-0.0.20.tar.zst>public artifact</a> in the Vivsoft AWS S3 bucket. This file should be downloaded and transferred to a client-side S3 bucket (how to transfer the file is beyond the scope of this document). Once the file is available in the client’s side S3 bucket, download it on the registry server using the following command:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=cl><span class=nv>ENBUILD_HELM_CHART_VERSION</span><span class=o>=</span>0.0.20
 </span></span><span class=line><span class=cl><span class=nv>ENBUILD_HAULER_URL</span><span class=o>=</span><span class=s2>&#34;https://your-client-side-s3-bucket/enbuild-</span><span class=si>${</span><span class=nv>ENBUILD_HELM_CHART_VERSION</span><span class=si>}</span><span class=s2>.tar.zst&#34;</span>
 </span></span><span class=line><span class=cl>curl -O <span class=si>${</span><span class=nv>ENBUILD_HAULER_URL</span><span class=si>}</span>
 </span></span></code></pre></div><h3 id=5-load-the-enbuild-haul-file-and-start-the-registry>5. Load the ENBUILD Haul File and Start the Registry<a href=#5-load-the-enbuild-haul-file-and-start-the-registry class=anchor aria-hidden=true>#</a></h3><p>Once the haul file is available in the airgapped environment, load the haul file into the Hauler registry and start the registry service:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=cl>hauler store load enbuild-<span class=si>${</span><span class=nv>ENBUILD_HELM_CHART_VERSION</span><span class=si>}</span>.tar.zst