Skip to main content
Version: 3.0

Create Cluster

info

USB storage devices are blocked by default. If accessing USB devices is needed, please set the tuning option cubesys.probeusb to true using CLI > tuning > configure after logging in as admin.

Prerequisite​

info

User bigstack-k8s, project bigstack-k8s will be used during this demontration.

  1. A project for Kubernetes has been created, and the user's Kubernetes permissions have been set to Administrator. See Create project for Kubernetes

  2. Amphora image has been imported

    1. Download Amphora image: amphora-x64-haproxy_yoga
    2. Use scp to upload the downloaded image to the Glance image directory /mnt/cephfs/glance
      1. From a computer with management access to your cluster VIP: scp amphora-x64-haproxy_yoga.qcow2 root@<cluster-vip>:/mnt/cephfs/glance/
    3. Login to the admin shell
    4. Run the following command to import the load balancer image: image import_lb
    cc1> image import_lb
1: usb
2: local
Enter index: 2
1: amphora-x64-haproxy-yoga.qcow2
Enter index: 1
Importing...
[16:25:04] Converting image to RAW format ...
(100.00/100%)
[16:25:11] Creating image amphora-x64-haproxy ...
[=============================>] 100%
aa93010b-eb36-4357-b1cf-fea46958908f
[16:26:07] Finished creating image amphora-x64-haproxy
Importing complete. It is safe to remove the local image file.
  1. A Linux image has been imported and is ready for use in deployments.
info

For the purposes of this demonstration, we will use the ubuntu2404.qcow2 image as the base system image.

  1. Visit the CubeCOS Downloads page to obtain a supported image (e.g., ubuntu2404.qcow2).
  2. Use scp to transfer the image to the Glance image store: /mnt/cephfs/glance
    1. Run this command from a workstation or jump host with network access to the cluster VIP.: scp ubuntu2404.qcow2 root@<cluster-vip>:/mnt/cephfs/glance/
  3. Log into the admin shell
  4. Run the following command to import the load balancer image: image import
    cc1> image import
1: usb
2: local
Enter index: 2
1: amphora-x64-haproxy-yoga.qcow2
2: ubuntu2404.qcow2
Enter index: 2
Specify image name: ubuntu_2404
Select domain:
1: default
Enter index: 1
Select tenant:
1: admin
2: bigstack-k8s
Enter index: 1
Bootable image or volume:
1: glance-images
2: cinder-volumes
Enter index: 1
Visibility:
1: public
2: private
Enter index: 1
Importing...
[16:29:57] Converting image to RAW format ...
(100.00/100%)
[16:30:09] Creating image ubuntu_2404 ...
[=============================>] 100%
ebfa199b-12d2-4a7c-8a8e-aef452f71750
[16:31:39] Finished creating image ubuntu_2404
Importing ubuntu_2404 complete. It is safe to remove the local image file.

Driver setting and cloud credential creation​

  1. Login Rancher with keycloak user bigstack-k8s.

    /assets/k8s/create_cluster_1.png

  2. Navigate to Cluster Management.

    /assets/k8s/create_cluster_2.png

  3. Navigate to Drivers.

    /assets/k8s/create_cluster_3.png

  4. Switch to Node Drivers tab.

    /assets/k8s/create_cluster_4.png

  5. Select OpenStack and choose Active from its action options.

    /assets/k8s/create_cluster_5.png

  6. Verify by its State being Active.

    /assets/k8s/create_cluster_6.png

  7. Navigate to Cloud Credentials.

    /assets/k8s/create_cluster_7.png

  8. On the top right corner, click Create.

    /assets/k8s/create_cluster_8.png

  9. Choose OpenStack as Cloud Credential template

    /assets/k8s/create_cluster_9.png

  10. Fill in user name as Cloud Credential Name, along with user password as value of key - password, click Create to proceed.

    /assets/k8s/create_cluster_10.png

Cluster creation​

  1. Go back to home page of Rancher and click Create

    /assets/k8s/create_cluster_10.png

  2. Click OpenStack

    /assets/k8s/create_cluster_10.png

  3. For this creation, following cluster information is required

    • Cluster Name (any)
    • OpenStack active timeout (200)
    • OpenStack authentication URL http://<CUBECOS-VIP>:5000/v3
    • OpenStack endpointType (publicURL)
    • OpenStack flavor name to use for the instance (recommended t2.medium or above)
    • Openstack image name (ubuntu_2404)
    • Disable TLS credential checking
    • OpenStack version of IP address assigned for the machine (4)
    • OpenStack network id the machine will be connected on (private-k8s from project bigstack-k8s)
    • OpenStack comma separated security groups for the machine (default, default-k8s)
    • OpenStack SSH port (22)
    • OpenStack SSH user (ubuntu)
    • OpenStack tenant id (ID for project bigstack-k8s)
    • OpenStack user-id (ID for user bigstack-k8s)

    /assets/k8s/create_cluster_10.png

  4. Change Container Network to cilium, then click Create

    /assets/k8s/create_cluster_10.png

  5. Wait till Cluster State become Active

    /assets/k8s/create_cluster_10.png /assets/k8s/create_cluster_10.png