Rancher Cluster

IONOS Cloud Docker Machine Driver is compatible with Rancher.

Installation

To install Rancher and Log in to Rancher UI, follow the first 3 steps in this Quick Manual Setup.

You will create a Docker Container with the following command:

sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher

NOTE: Please note that versions 2.8+ do not currently allow adding the IonosCloud UI extension for RKE2

To use a specific Rancher version, check the available docker images and add the corresponding tag to the command:

sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher:v2.7.5

To output the available docker containers, use:

docker ps

To follow the output logs for the running container, use:

docker logs -f container-id

Prerequisites

Your IONOS Cloud account credentials: username and password or token
A web server accessible by your browser

Installing Via The Rancher UI

After logging into Rancher UI, follow the next steps in order to install a cluster with IONOS Cloud as cloud provider, using IONOS Cloud Docker Machine Driver:

RKE1

Adding the Node Driver

Install Node Driver
- Go to Tools ➜ Drivers ➜ Node Drivers
- Click on Add New Driver button
- Enter the URLs and click Create
  - Download URL: https://github.com/ionos-cloud/docker-machine-driver/releases/download/v/docker-machine-driver--linux-amd64.tar.gz
  - Custom UI URL: https://cdn.jsdelivr.net/gh/ionos-cloud/ui-driver-ionoscloud@main/releases/v<UI_version|latest>/component.js
  - Whitelist Domains: cdn.jsdelivr.net
- Wait fot the machine driver to be downloaded and become Active
Create Node Template
- Go to Node Templates, from the drop-down menu for User Settings
- Click on Add Node Template button
- At this point, Ionoscloud should be on the list of Available Hosts. Select Ionoscloud
- Configure the IONOSCLOUD OPTIONS as you prefer and add also your password and username for IONOS Cloud account
- Give a name to the new Node Template and press Create button
Create New Rancher Cluster
- Go to Clusters
- Click on Add Cluster button
- In the Create a new Kubernetes cluster section, select Ionoscloud
- Choose the name of the new cluster, the name prefix of the node and make sure you have the Node Template you just created, in the Template section
- Customize your cluster: Single Node (by selecting all etcd, Control Plane and Worker) or Multiple Nodes
- Click on Create button
- Wait for cluster to become Active (it will take some minutes).

RKE2

Using Rancher Extensions requires Rancher v2.7.0 or above.

Install Node Driver
- connect to the machine running rancher
- create a yaml file containing the following information:
```
apiVersion: management.cattle.io/v3
kind: NodeDriver
metadata:
  annotations:
    lifecycle.cattle.io/create.node-driver-controller: "true"
    privateCredentialFields: "token,username,password,endpoint"
  name: ionoscloud 
spec:
  active: false
  addCloudCredential: false
  builtin: false
  checksum: ""
  description: ""
  displayName: ionoscloud
  externalId: ""
  uiUrl: ""
  url: <IONOS_DRIVER_URL>
```
- create the driver resource using
```
kubectl create -f <FILE>
```
- you can also add the old UI if you want to use RKE1
  - Go to Tools ➜ Drivers ➜ Node Drivers
  - Edit the Ionoscloud driver
  - Custom UI URL: https://cdn.jsdelivr.net/gh/ionos-cloud/ui-driver-ionoscloud@main/releases/v<UI_version|latest>/component.js
  - Whitelist Domains: cdn.jsdelivr.net
- Wait for the machine driver to be downloaded and become Active
- Add the ionoscloud ui extension from https://github.com/ionos-cloud/ui-extensions-ionoscloud
  - Go to Cluster Management ➜ Advanced ➜ Repositories
  - Click on Create button
  - Select Git repository as target
  - Git Repo URL: https://github.com/ionos-cloud/ui-extensions-ionoscloud
  - Git Branch: gh-pages
Create Cloud Credential
- Go to Cluster Management ➜ Cloud Credentials
- Click on Create button
- At this point, Ionoscloud should be on the list. Select Ionoscloud
Create New Rancher Cluster
- Go to Cluster Management ➜ Clusters
- Click on Create button
- In the Create section, select Ionoscloud
- Customize your cluster
- Click on Create button
- Wait for cluster to become Active (it will take some minutes).

Support

Please submit any bugs, issues or feature requests to ionos-cloud/docker-machine-driver.

PreviousRancher Machine

Last updated 1 year ago