Clusters

You can use SUSE Manager to directly manage SUSE CaaS Platform clusters. Manage clusters that you have registered with SUSE Manager by navigating to Clusters  Overview in the Web UI.

1. Autoinstallation Profile

SUSE CaaS Platform 4 provides an AutoYaST profile that you can use to autoinstall a node. The profile is in the patterns-caasp-Management package.

You can use SUSE Manager to manage one or more existing SUSE CaaS Platform clusters.

Only SUSE CaaS Platform 4 is currently supported.

Before you begin, ensure you have installed your SUSE CaaS Platform cluster.

2. Elect a Management Node

To manage a SUSE CaaS Platform cluster, you need to elect a client as the management node for the cluster. The management node cannot be part of the cluster, and it must have the SUSE CaaS Platform channels associated with it before you begin. You can use a single management node for multiple clusters, as long as the clusters are all of the same kind.

Procedure: Electing a Management Node

  1. In the SUSE Manager Web UI, navigate to Systems  System List and click the name of the client to elect as the management node.

  2. Navigate to the Formulas  Configuration tab, and check the CaaSP Management Node formula.

  3. Click Save and apply the highstate.

Do not use the management node until the highstate has been completed.

List all known clusters by navigating to Clusters  Overview. This list displays all existing clusters, along with the cluster type, and which management node they are associated with. It also shows the nodes within the cluster, if the nodes are registered to SUSE Manager. For the nodes within a cluster, additional information from skuba and the Kubernetes API are shown, including the role, status, and whether any updates are available.

Procedure: Configuring the Management Node

  1. Copy the skuba configuration directory from your cluster to the management node. This is the directory that the skuba service creates after the cluster has been bootstrapped. Take a note of the new file location for adding the cluster in the SUSE Manager Web UI.

  2. Provide a way to authenticate.

There are two ways you can authenticate a SUSE CaaS Platform cluster, choose the method that best suits your environment:

  • Copy the passwordless private SSH key used to access the cluster nodes to the SUSE Manager Server, and take a note of the file location. You need the current keys and keys for any clients that you want to use in the future.

  • You can use an ssh-agent socket, and provide the path to the socket when setting up the cluster.

There are two ways of using the ssh-agent with SUSE CaaS Platform. You can use ssh-agent locally, or forward the ssh-agent to the management node from another machine:

Procedure: Using a Local ssh-agent

  1. On the management node, at the command prompt, start the ssh-agent service:

    eval $(ssh-agent)

  2. Add the SSH key:

    ssh-add <key>

  3. The socket used to access the agent is available in the $SSH_AUTH_SOCK environment variable.

Procedure: Forwarding ssh-agent to the Management Node

  1. On the system that is providing ssh-agent, at the command prompt, enable SSH forwarding, and specify the hostname of the management node:

    ssh -A <management node>

  2. The socket used to access the agent is available in the $SSH_AUTH_SOCK environment variable.

If you are using the ssh-agent method, the path of the socket changes every time a new ssh-agent` is started or a new ssh -A connection is started. The ssh-agent socket path can be updated at any time from the SUSE Manager Web UI. The socket path can also be overridden when starting any cluster action that requires SSH access.

3. Manage Clusters

To manage a cluster in SUSE Manager, add the cluster in the Web UI.

Procedure: Adding an Existing Cluster

  1. In the SUSE Manager Web UI, navigate to Clusters  Overview and click Add.

  2. Follow the prompts to provide information about your cluster, including the cluster type, and select the management node to associate.

  3. Type the path to the skuba configuration file for the cluster.

  4. Type the passwordless SSH key you want to use, or provide the path to an ssh-agent socket.

  5. Type a name, label, and description for the cluster.

  6. Click Add.

For each cluster you manage with SUSE Manager, a corresponding system group is created. By default, the system group is called Cluster <cluster_name>. Refresh the system group to update the list of nodes. Only nodes known to SUSE Manager are shown.

You can remove clusters from SUSE Manager by navigating to Clusters  Overview, unchecking the cluster to be deleted, and clicking Delete Cluster.

Deleting a cluster removes the cluster from SUSE Manager, it does not delete the cluster nodes. Workloads running on the cluster continue uninterrupted.

4. Manage Nodes

When you have the cluster created in SUSE Manager, you can manage nodes within the cluster.

Before you add a new node to the cluster, check the management node can access the node you want to add using passwordless SSH, or the ssh-agent socket you are forwarding.

You also need to ensure that the node you want to add is registered to SUSE Manager, and has a SUSE CaaS Platform channel assigned.

Before you add a node to a cluster, you might need to do some manual configuration. Check that the system is used exclusively as a SUSE CaaS Platform node, and that swap is turned off. For more information, see https://documentation.suse.com/suse-caasp/4.2/single-html/caasp-deployment/#_disabling_swap

Procedure: Adding Nodes to a Cluster

  1. In the SUSE Manager Web UI, navigate to Clusters  Overview and click Join Node.

  2. Select the nodes to add from the list of available nodes. The list of available nodes includes only nodes that are registered to SUSE Manager, are not management nodes, and are not currently part of any cluster.

  3. Follow the prompts to enter the SUSE CaaS Platform parameters for the nodes to be added.

  4. OPTIONAL: Specify a custom ssh-agent socket that is valid only for the nodes that are being added.

  5. Click Save to schedule an action to add the nodes to the SUSE CaaS Platform cluster.

Procedure: Removing Nodes from a Cluster

  1. In the SUSE Manager Web UI, navigate to Clusters  Overview, uncheck the nodes to remove, and click Remove Node.

  2. Follow the prompts to define the parameters for the nodes to be removed.

  3. OPTIONAL: Specify a custom ssh-agent socket that is valid only for the nodes that are being removed.

  4. Click Save to schedule an action to remove the nodes.

For more information about node removal, see https://documentation.suse.com/suse-caasp/4/single-html/caasp-admin/#_permanent_removal.

5. Upgrade Clusters

If the cluster has available updates, you can use SUSE Manager to schedule and manage the upgrade.

SUSE Manager upgrades all control planes first, and then upgrades the workers. For more information, see https://documentation.suse.com/suse-caasp/4.2/single-html/caasp-admin/#_cluster_updates.

Procedure: Upgrading the Cluster

  1. In the SUSE Manager Web UI, navigate to Clusters  Overview, and click the cluster to upgrade.

  2. OPTIONAL: The are no SUSE CaaS Platform parameters available for you to customize for upgrade. However, you can specify a custom ssh-agent socket that is valid only for the nodes that are being upgraded.

  3. Click Save to schedule an action to upgrade the cluster.

SUSE Manager only interacts with skuba to upgrade the cluster. Any other required action, such as configuration changes, are not issued by SUSE Manager.

For more information about upgrading, see https://www.suse.com/releasenotes/x86_64/SUSE-CAASP/4.