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.