Manual

Deployment

Refer to Installation

Administrative Operations (Prerequisites)

Below operations are essential tasks that need to be carried out before ordinary users can make use of the cloud services.

Create one or more images

To create an image, input the image name and URL into the relevant fields, submit, and wait until its state becomes available. For local disk storage, administrators are required to manually sync the images to all compute nodes at /opt/cloudland/cache/image.

Create one or more flavors

To create a flavor, input the name, cpu, memory, disk into the relevant fields and submit.

Create one or more public subnets

When creating a public subnet, in addition to standard relevant fields such as name or CIDR, it is essential to input the VLAN number. The VLAN number is associated with public routing and enables the creation of multiple subnets with different CIDRs under the same VLAN. Moreover, the network type must be selected as public.

It is more desirable if your environment already has pre-configured VLANs. Nevertheless, if such VLANs are absent, you can create a public subnet based on a flat network by adhering to the following steps:

1. Define a number to bridge the flat network, for example br5000.
2. Edit the netplan configuration on all compute nodes to move the IP and routing etc. to the bridge.

Before the modification:

network:
  version: 2
  renderer: NetworkManager
  ethernets:
    eno1:
      dhcp4: false
    eno2:
      dhcp4: false
  bonds:
    bond0:
      interfaces:
        - eno1
        - eno2
      parameters:
        mode: 802.3ad
        mii-monitor-interval: 100
        lacp-rate: fast
        transmit-hash-policy: layer3+4
      addresses:
        - 10.9.8.230/24
      ...

After the modification:

network:
  version: 2
  renderer: NetworkManager
  ethernets:
    eno1:
      dhcp4: false
    eno2:
      dhcp4: false
  bonds:
    bond0:
      interfaces:
        - eno1
        - eno2
      parameters:
        mode: 802.3ad
        mii-monitor-interval: 100
        lacp-rate: fast
        transmit-hash-policy: layer3+4
  bridges:
    br5000:
      interfaces:
        - bond0
      addresses:
        - 10.9.8.230/24
      ...

3. Apply the network

netplan apply

Note: The network may disconnect or require a reboot for this configuration change.

4. Create the public subnet using the VLAN number defined above. Ensure that the subnet CIDR is correctly routed and does not conflict with any existing IP usage. For example, assume the network cidr is 199.180.100.80/28 and the gateway is 199.180.100.94. If the range 199.180.100.81/28 - 199.180.100.85/28 is used or reserved by a physical box, then you can input the start as 199.180.100.86 and the end as 199.180.100.83.

Ordinary User Operations

Create a key

To create a key, input the key name and public key into the relevant fields and submit. If you don't have a key yet, use the command ssh-keygen -f /path/to/your_key to generate one. Most virtual machine (VM) instances require a key for login.

Create a VPC

To create a VPC, input a VPC name and submit.

Create an internal subnet

To create a subnet, choose a VPC and input the network CIDR along with other parameters.

Launch an instance

To launch an instance, fill in the fields marked with asterisks including hostname, count, image, flavor, and primary interface. It's also important to select a suitable key for logging in to the instance after it's created.

Create a floating IP

To create a floating IP, input a name, select the instance name with primary ip address from the drop - down menu.

Use your instance and modify security group as needed

Use the command ssh -i /path/to/your_private_key username@instance_public_floating_ip to access the instance. By default, username is centos for Centos images, and ubuntu for Ubuntu images. To expose a service running in the instance publicly, click the security group ID in the security group panel and create a new rule. For example, to open port 443, set the remote IP as 0.0.0.0/0, direction as ingress, protocol as tcp, and both port min and port max to be 443.