Merge pull request #2904 from superseb/flatcar_update

Update Flatcar requirements
This commit is contained in:
Catherine Luse
2020-12-10 14:34:10 -07:00
committed by GitHub
2 changed files with 95 additions and 28 deletions
@@ -34,27 +34,32 @@ Some distributions of Linux derived from RHEL, including Oracle Linux, may have
SUSE Linux may have a firewall that blocks all ports by default. In that situation, follow [these steps]({{<baseurl>}}/rancher/v2.x/en/installation/requirements/ports/#opening-suse-linux-ports) to open the ports needed for adding a host to a custom cluster. SUSE Linux may have a firewall that blocks all ports by default. In that situation, follow [these steps]({{<baseurl>}}/rancher/v2.x/en/installation/requirements/ports/#opening-suse-linux-ports) to open the ports needed for adding a host to a custom cluster.
### Windows Nodes ### Flatcar Container Linux Nodes
_Windows worker nodes can be used as of Rancher v2.3.0_ When [Launching Kubernetes with Rancher]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/) using Flatcar Container Linux nodes, it is required to use the following configuration in the [Cluster Config File]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/options/#cluster-config-file)
Nodes with Windows Server must run Docker Enterprise Edition. {{% tabs %}}
{{% tab "Canal"%}}
Windows nodes can be used for worker nodes only. See [Configuring Custom Clusters for Windows]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/windows-clusters/)
### Flatcar Linux Nodes
To deploy an RKE Kubernetes cluster using Flatcar Linux (flatcar-linux-stable-2605.6.0) nodes, we recommend the following configuration in the `rancher-cluster.yml`:
{{% accordion label="click to expand" %}}
```yaml ```yaml
nodes: rancher_kubernetes_engine_config:
- address: network:
internal_address: plugin: canal
user: core options:
role: [etcd, controlplane, worker] canal_flex_volume_plugin_dir: /opt/kubernetes/kubelet-plugins/volume/exec/nodeagent~uds
ssh_key_path: flannel_backend_type: vxlan
services:
kube-controller:
extra_args:
flex-volume-plugin-dir: /opt/kubernetes/kubelet-plugins/volume/exec/
```
{{% /tab %}}
{{% tab "Calico"%}}
```yaml
rancher_kubernetes_engine_config:
network: network:
plugin: calico plugin: calico
options: options:
@@ -66,9 +71,24 @@ services:
extra_args: extra_args:
flex-volume-plugin-dir: /opt/kubernetes/kubelet-plugins/volume/exec/ flex-volume-plugin-dir: /opt/kubernetes/kubelet-plugins/volume/exec/
``` ```
{{% /accordion %}} {{% /tab %}}
{{% /tabs %}}
It is also required to enable the Docker service, you can enable the Docker service using the following command:
```
systemctl enable docker.service
```
The Docker service is enabled automatically when using [Node Drivers]({{<baseurl>}}/rancher/v2.x/en/admin-settings/drivers/#node-drivers).
### Windows Nodes
_Windows worker nodes can be used as of Rancher v2.3.0_
Nodes with Windows Server must run Docker Enterprise Edition.
Windows nodes can be used for worker nodes only. See [Configuring Custom Clusters for Windows]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/windows-clusters/)
# Hardware Requirements # Hardware Requirements
+47
View File
@@ -16,6 +16,7 @@ weight: 5
- [OpenSSH version](#openssh-version) - [OpenSSH version](#openssh-version)
- [Creating a Docker Group](#creating-a-docker-group) - [Creating a Docker Group](#creating-a-docker-group)
- [Flatcar Container Linux](#flatcar-container-linux)
- [Software](#software) - [Software](#software)
- [Ports](#ports) - [Ports](#ports)
@@ -162,6 +163,52 @@ By default, Atomic hosts do not come with a Docker group. You can update the own
# chown <user> /var/run/docker.sock # chown <user> /var/run/docker.sock
``` ```
### Flatcar Container Linux
When using Flatcar Container Linux nodes, it is required to use the following configuration in the cluster configuration file:
{{% tabs %}}
{{% tab "Canal"%}}
```yaml
rancher_kubernetes_engine_config:
network:
plugin: canal
options:
canal_flex_volume_plugin_dir: /opt/kubernetes/kubelet-plugins/volume/exec/nodeagent~uds
flannel_backend_type: vxlan
services:
kube-controller:
extra_args:
flex-volume-plugin-dir: /opt/kubernetes/kubelet-plugins/volume/exec/
```
{{% /tab %}}
{{% tab "Calico"%}}
```yaml
rancher_kubernetes_engine_config:
network:
plugin: calico
options:
calico_flex_volume_plugin_dir: /opt/kubernetes/kubelet-plugins/volume/exec/nodeagent~uds
flannel_backend_type: vxlan
services:
kube-controller:
extra_args:
flex-volume-plugin-dir: /opt/kubernetes/kubelet-plugins/volume/exec/
```
{{% /tab %}}
{{% /tabs %}}
It is also required to enable the Docker service, you can enable the Docker service using the following command:
```
systemctl enable docker.service
```
## Software ## Software
This section describes the requirements for Docker, Kubernetes, and SSH. This section describes the requirements for Docker, Kubernetes, and SSH.