diff --git a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/launch-kubernetes/_index.md b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/launch-kubernetes/_index.md index 28f2de5f713..cf96f997ea1 100644 --- a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/launch-kubernetes/_index.md +++ b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/launch-kubernetes/_index.md @@ -1,10 +1,12 @@ --- -title: '3. Install Kubernetes (Skip for Docker installs)' +title: '3. Install Kubernetes (RKE and K3s installs only)' weight: 300 aliases: - /rancher/v2.x/en/installation/air-gap-high-availability/install-kube --- +> Skip this section if you are installing Rancher on a single node with Docker. + This section describes how to install a Kubernetes cluster according to our [best practices for the Rancher server environment.]({{}}/rancher/v2.x/en/overview/architecture-recommendations/#environment-for-kubernetes-installations) This cluster should be dedicated to run only the Rancher server. For Rancher prior to v2.4, Rancher should be installed on an [RKE]({{}}/rke/latest/en/) (Rancher Kubernetes Engine) Kubernetes cluster. RKE is a CNCF-certified Kubernetes distribution that runs entirely within Docker containers. @@ -18,7 +20,7 @@ The steps to set up an air-gapped Kubernetes cluster depend on whether RKE or K3 {{% tabs %}} {{% tab "K3s" %}} -In this guide, we are assuming you have created your nodes in your air-gap environment and have a secure Docker private registry on your bastion server. +In this guide, we are assuming you have created your nodes in your air gapped environment and have a secure Docker private registry on your bastion server. ### Installation Outline @@ -39,6 +41,7 @@ sudo cp ./k3s-airgap-images-$ARCH.tar /var/lib/rancher/k3s/agent/images/ ### 2. Create Registry YAML Create the registries.yaml file at `/etc/rancher/k3s/registries.yaml`. This will tell K3s the necessary details to connect to your private registry. + The registries.yaml file should look like this before plugging in the necessary information: ``` @@ -58,7 +61,9 @@ configs: ca_file: ``` -Note, at this time only secure registries are supported with K3s (SSL with custom CA) +Note, at this time only secure registries are supported with K3s (SSL with custom CA). + +For more information on private registries configuration file for K3s, refer to the [K3s documentation.]({{}}/k3s/latest/en/installation/private-registry/) ### 3. Install K3s @@ -214,8 +219,4 @@ Save a copy of the following files in a secure location: See the [Troubleshooting]({{}}/rancher/v2.x/en/installation/options/troubleshooting/) page. -### Issues or errors? - -See the [Troubleshooting]({{}}/rancher/v2.x/en/installation/options/troubleshooting/) page. - ### [Next: Install Rancher](../install-rancher) diff --git a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/prepare-nodes/_index.md b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/prepare-nodes/_index.md index 7158e4b7225..e26b5b31cb5 100644 --- a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/prepare-nodes/_index.md +++ b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/prepare-nodes/_index.md @@ -79,6 +79,8 @@ For a how-to guide for setting up a DNS record to route domain traffic to an Ama Rancher supports air gap installs using a private registry. You must have your own private registry or other means of distributing Docker images to your machines. +In a later step, when you set up your K3s Kubernetes cluster, you will create a [private registries configuration file]({{}}/k3s/latest/en/installation/private-registry/) with details from this registry. + If you need help with creating a private registry, please refer to the [official Docker documentation.](https://docs.docker.com/registry/deploying/#run-an-externally-accessible-registry) {{% /tab %}} {{% tab "RKE" %}}