Merge pull request #3063 from cseader/master

Add SUSE/openSUSE to the RKE OS
2026-09-24 20:18:18 +00:00 · 2021-02-24 16:20:51 -07:00
parent 444c654064 17ead3ff7f
commit 635fe3761c
1 changed files with 96 additions and 14 deletions
@@ -5,23 +5,31 @@ weight: 5
 **In this section:** 

 <!-- TOC -->
-
 - [Operating System](#operating-system)
-    - [General Linux Requirements](#general-linux-requirements)
-    - [Red Hat Enterprise Linux (RHEL) / Oracle Linux (OL) / CentOS](#red-hat-enterprise-linux-rhel-oracle-enterprise-linux-ol-centos)
-
-        - [Using upstream Docker](#using-upstream-docker)
-        - [Using RHEL/CentOS packaged Docker](#using-rhel-centos-packaged-docker)
-    - [Notes about Atomic Nodes](#red-hat-atomic)
-
-        - [OpenSSH version](#openssh-version)
-        - [Creating a Docker Group](#creating-a-docker-group)
-    - [Flatcar Container Linux](#flatcar-container-linux)
+  - [General Linux Requirements](#general-linux-requirements)
+  - [SUSE Linux Enterprise Server (SLES) / openSUSE](#suse-linux-enterprise-server-sles--opensuse)
+    - [Using Upstream Docker](#using-upstream-docker)
+    - [Using SUSE/openSUSE packaged Docker](#using-suseopensuse-packaged-docker)
+    - [Adding the Software Repository for Docker](#adding-the-software-repository-for-docker)
+  - [openSUSE MicroOS/Kubic (Atomic)](#opensuse-microoskubic-atomic)
+    - [openSUSE MicroOS](#opensuse-microos)
+    - [openSUSE Kubic](#opensuse-kubic)
+  - [Red Hat Enterprise Linux (RHEL) / Oracle Linux (OL) / CentOS](#red-hat-enterprise-linux-rhel--oracle-linux-ol--centos)
+    - [Using upstream Docker](#using-upstream-docker-1)
+    - [Using RHEL/CentOS packaged Docker](#using-rhelcentos-packaged-docker)
+  - [Red Hat Atomic](#red-hat-atomic)
+    - [OpenSSH version](#openssh-version)
+    - [Creating a Docker Group](#creating-a-docker-group)
+  - [Flatcar Container Linux](#flatcar-container-linux)
 - [Software](#software)
+  - [OpenSSH](#openssh)
+  - [Kubernetes](#kubernetes)
+  - [Docker](#docker)
+  - [Installing Docker](#installing-docker)
+  - [Checking the Installed Docker Version](#checking-the-installed-docker-version)
 - [Ports](#ports)
-
-    - [Opening port TCP/6443 using `iptables`](#opening-port-tcp-6443-using-iptables)
-    - [Opening port TCP/6443 using `firewalld`](#opening-port-tcp-6443-using-firewalld)
+  - [Opening port TCP/6443 using `iptables`](#opening-port-tcp6443-using-iptables)
+  - [Opening port TCP/6443 using `firewalld`](#opening-port-tcp6443-using-firewalld)
 - [SSH Server Configuration](#ssh-server-configuration)

 <!-- /TOC -->
@@ -99,6 +107,80 @@ xt_tcpudp |
 net.bridge.bridge-nf-call-iptables=1
 ```

+### SUSE Linux Enterprise Server (SLES) / openSUSE
+
+If you are using SUSE Linux Enterprise Server or openSUSE follow the instructions below.  
+
+#### Using upstream Docker  
+If you are using upstream Docker, the package name is `docker-ce` or `docker-ee`. You can check the installed package by executing:
+
+```
+rpm -q docker-ce
+```
+
+When using the upstream Docker packages, please follow [Manage Docker as a non-root user](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user).
+
+#### Using SUSE/openSUSE packaged docker 
+If you are using the Docker package supplied by SUSE/openSUSE, the package name is `docker`. You can check the installed package by executing:
+
+```
+rpm -q docker
+```
+
+#### Adding the Software repository for docker 
+In SUSE Linux Enterprise Server 15 SP2 docker is found in the Containers module.  
+This module will need to be added before istalling docker.  
+
+To list available modules you can run SUSEConnect to list the extensions and the activation command  
+```
+node:~ # SUSEConnect --list-extensions
+AVAILABLE EXTENSIONS AND MODULES
+
+    Basesystem Module 15 SP2 x86_64 (Activated)
+    Deactivate with: SUSEConnect -d -p sle-module-basesystem/15.2/x86_64
+
+        Containers Module 15 SP2 x86_64
+        Activate with: SUSEConnect -p sle-module-containers/15.2/x86_64
+```
+Run this SUSEConnect command to activate the Containers module.
+```
+node:~ # SUSEConnect -p sle-module-containers/15.2/x86_64
+Registering system to registration proxy https://rmt.seader.us
+
+Updating system details on https://rmt.seader.us ...
+
+Activating sle-module-containers 15.2 x86_64 ...
+-> Adding service to system ...
+-> Installing release package ...
+
+Successfully registered system
+```
+In order to run docker cli commands with your user then you need to add this user to the `docker` group.
+It is preferred not to use the root user for this.
+
+```
+usermod -aG docker <user_name>
+```
+
+To verify that the user is correctly configured, log out of the node and login using SSH or your preferred method, and execute `docker ps`:
+
+```
+ssh user@node
+user@node:~> docker ps
+CONTAINER ID        IMAGE       COMMAND             CREATED             STATUS              PORTS               NAMES
+user@node:~>
+```
+### openSUSE MicroOS/Kubic (Atomic)  
+Consult the project pages for openSUSE MicroOS and Kubic for installation  
+#### openSUSE MicroOS  
+Designed to host container workloads with automated administration & patching. Installing openSUSE MicroOS you get a quick, small environment for deploying Containers, or any other workload that benefits from Transactional Updates. As rolling release distribution the software is always up-to-date.  
+https://microos.opensuse.org  
+#### openSUSE Kubic
+Based on MicroOS, but not a rolling release distribution. Designed with the same things in mind but also a Certified Kubernetes Distribution.   
+https://kubic.opensuse.org  
+Installation instructions:  
+https://kubic.opensuse.org/blog/2021-02-08-MicroOS-Kubic-Rancher-RKE/  
+
 ### Red Hat Enterprise Linux (RHEL) / Oracle Linux (OL) / CentOS

 If using Red Hat Enterprise Linux, Oracle Linux or CentOS, you cannot use the `root` user as [SSH user]({{<baseurl>}}/rke/latest/en/config-options/nodes/#ssh-user) due to [Bugzilla 1527565](https://bugzilla.redhat.com/show_bug.cgi?id=1527565). Please follow the instructions below how to setup Docker correctly, based on the way you installed Docker on the node.