Managing source clouds

Before creating migrations, you must add a source cloud. A source cloud represents an external platform (for example, a VMware vSphere deployment) from which virtual machines are migrated.

After adding a cloud, you can validate the connection to ensure that the credentials and endpoint are correct. Once a cloud is validated, its virtual machines become available for selection when creating migrations. A source cloud can be reused for multiple migrations.

Limitations

Only VMware vSphere (6.x–8.x) is supported as a source platform.

To add a source cloud

Admin panel

Go to the Compute > Migration > Clouds tab and click Add cloud.
In the Add cloud window, select the cloud type (currently, only VMware is available).
Specify the following parameters:
- A name for the cloud and optionally its description
- User account credentials for accessing the source platform
- IP address or hostname of the VMware endpoint and the port number (for example, 443)
Select Disable SSL checks to allow connections to endpoints with self-signed or untrusted certificates.
Click Add.

The cloud will appear in the list.

Command-line interface

Use the following command:

vinfra service compute maas cloud add --cloud-type <cloud_type> --name <name> --username <username> [--password]
                                      [--insecure | --secure] --vmware-host <vmware_host> [--vmware-port <vmware_port>]
                                      [--description <description>]

--cloud-type <cloud_type>: Type of the cloud to migrate from (vmware_vsphere)
--name <name>: Cloud name
--username <username>: Username for connection
--password: Read the connection password from stdin. Alternatively, set it using the MAAS_CLOUD_PASSWORD environment variable.
--insecure: Use an insecure connection
--secure: Use a secure connection
--vmware-host <vmware_host>: IP address or hostname for VMware clouds
--vmware-port <vmware_port>: Port number for VMware clouds (default: 443)
--description <description>: Cloud description

For example, to add a VMware source cloud with the IP address 10.10.10.100, run:

# vinfra service compute maas cloud add --cloud-type vmware_vsphere --name mycloud \
--username admin --password --insecure --vmware-host 10.10.10.2

Enter the VMware account password when prompted.

You can check that the cloud is successfully added in the vinfra service compute maas cloud list output:

# vinfra service compute maas cloud list
+--------------------------------------+---------+----------------+
| id                                   | name    | cloud_type     |
+--------------------------------------+---------+----------------+
| 182e8031-f04e-4012-aac1-c324433ceeb6 | mycloud | vmware_vsphere |
+--------------------------------------+---------+----------------+

To validate a source cloud

Admin panel

On the Compute > Migration > Clouds tab, select the required cloud.
On the cloud right pane, click Validate.

Command-line interface

Use the following command:

vinfra service compute maas cloud validate <cloud>

<cloud>: Cloud ID or name

For example, to validate the source cloud mycloud, run:

# vinfra service compute maas cloud validate mycloud
+---------+-------+
| Field   | Value |
+---------+-------+
| message |       |
| valid   | True  |
+---------+-------+

To list available VMs on a source cloud

Use the following command:

vinfra service compute maas cloud instance list <cloud>

<cloud>: Cloud ID or name

For example, to list all VMs on the source cloud mycloud, run:

# vinfra service compute maas cloud instance list mycloud
+--------------------------------------+--------------+-----------+
| id                                   | name         | state     |
+--------------------------------------+--------------+-----------+
| 52d1eeb0-b292-36d4-19a0-19ac27f4e854 | ubuntu_24.04 | poweredOn |
| 528ba29d-c5ba-4e28-cf4f-fc4e5cb5713d | windows_11   | poweredOn |
+--------------------------------------+--------------+-----------+

To edit a source cloud

Admin panel

On the Compute > Migration > Clouds tab, select the required cloud.
On the cloud right pane, click Edit.
In the Edit cloud window, make the required changes and click Save.

Command-line interface

Use the following command:

vinfra service compute maas cloud set --name <name> --username <username> [--password] [--insecure | --secure]
                                      [--vmware-host <vmware_host>] [--vmware-port <vmware_port>]
                                      [--description <description>] <cloud>

--name <name>: New cloud name
--username <username>: Username for connection
--password: Read the connection password from stdin. Alternatively, set it using the MAAS_CLOUD_PASSWORD environment variable.
--insecure: Use an insecure connection
--secure: Use a secure connection
--vmware-host <vmware_host>: IP address or hostname for VMware clouds
--vmware-port <vmware_port>: Port number for VMware clouds (default: 443)
--description <description>: Cloud description
<cloud>: Cloud ID or name

For example, to change the IP address of the source cloud mycloud to 10.10.10.200, run:

# vinfra service compute maas cloud set mycloud --vmware-host 10.10.10.200

To remove a source cloud

Admin panel

On the Compute > Migration > Clouds tab, select the required cloud.
On the cloud right pane, click Delete.
In the confirmation window, click Delete.

Command-line interface

Use the following command:

vinfra service compute maas cloud remove <cloud>

<cloud>: Cloud ID or name

For example, to remove the source cloud mycloud, run:

# vinfra service compute maas cloud remove mycloud