# Create Cluster

> :::info

:::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 {#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](create-project.md)

2. Amphora image has been imported
   1. Download Amphora image: [amphora-x64-haproxy_yoga](https://s3.bigstack.co/downloads/app-image/yoga/amphora-x64-haproxy_yoga.qcow2)
   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`

```bash
    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.
```

3.  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](../downloads/cloud_image.md) 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`

```bash
    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 {#driver-setting-and-cloud-credential-creation}

1. Login Rancher with keycloak user `bigstack-k8s`.

   ![/assets/k8s/create_cluster_1.png](/assets/k8s/create_cluster_1.png)

2. Navigate to `Cluster Management`.

   ![/assets/k8s/create_cluster_2.png](/assets/k8s/create_cluster_2.png)

3. Navigate to `Drivers`.

   ![/assets/k8s/create_cluster_3.png](/assets/k8s/create_cluster_3.png)

4. Switch to `Node Drivers` tab.

   ![/assets/k8s/create_cluster_4.png](/assets/k8s/create_cluster_4.png)

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

   ![/assets/k8s/create_cluster_5.png](/assets/k8s/create_cluster_5.png)

6. Verify by its `State` being `Active`.

   ![/assets/k8s/create_cluster_6.png](/assets/k8s/create_cluster_6.png)

7. Navigate to `Cloud Credentials`.

   ![/assets/k8s/create_cluster_7.png](/assets/k8s/create_cluster_7.png)

8. On the top right corner, click `Create`.

   ![/assets/k8s/create_cluster_8.png](/assets/k8s/create_cluster_8.png)

9. Choose `OpenStack` as Cloud Credential template

   ![/assets/k8s/create_cluster_9.png](/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](/assets/k8s/create_cluster_10.png)

## Cluster creation {#cluster-creation}

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

   ![/assets/k8s/create_cluster_10.png](/assets/k8s/create_cluster_11.png)

2. Click `OpenStack`

   ![/assets/k8s/create_cluster_10.png](/assets/k8s/create_cluster_12.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](/assets/k8s/create_cluster_13.png)

4. Change Container Network to **cilium**, then click `Create`

   ![/assets/k8s/create_cluster_10.png](/assets/k8s/create_cluster_14.png)

5. Wait till Cluster State become `Active`

   ![/assets/k8s/create_cluster_10.png](/assets/k8s/create_cluster_15.png)
   ![/assets/k8s/create_cluster_10.png](/assets/k8s/create_cluster_16.png)