Skip to main content

Working with Virtual Machines

In this section, we'll go over all the necessary steps needed to provision and manage Virtual Machines on RAIC.

Let's look at a few example commands and their output.

List available machines​

Before creating a VM, you first need to decide what machine characteristics you need as well as a few other details.

The command below offers a view of what machines are currently available through RAIC. To get more information on each SKU, view Quota page on RAIC (under Settings > Resource Quotas)

user@machine ~ % raic vm list-sku
SKU             | Location                                                                | Os Image
ogx-a100-10     | new-jersey                                                              | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-160-b  | new-jersey,frankfurt-2,sillicon-valley,bangalore                        | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-20     | new-jersey,frankfurt-2,london-2,sillicon-valley                         | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-320-b  | frankfurt-2                                                             | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-4      | new-jersey                                                              | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-40     | new-jersey,frankfurt-2,london-2,sillicon-valley,bangalore               | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a100-8      | new-jersey,london-2                                                     | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a16-128     | chicago,sillicon-valley,bangalore                                       | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
ogx-a16-16      | frankfurt-2,london-2,tokyo,chicago,sillicon-valley,bangalore            | Debian-10,Debian-11,Debian-12,Ubuntu-20.04,Ubuntu-22.04
...

Create SSH Keys​

In order to create a Virtual Machine, you first need to create an SSH key pair which will allow you to access the instance.

After creating your SSH key pair, you will use the public key to create a SSH key resource with the following command.

user@machine ~ % raic ssh create personal-key --public-key <public-key>
5272e090-a595-4d6a-8587-cfe78214739e

user@machine ~ % raic ssh list
ID                                   | Name            | Description
5272e090-a595-4d6a-8587-cfe78214739e | personal-key    |

Create Virtual Machine​

Once we have decided the machine type, location, OS image as well as created the SSH key, we are now ready to create a Virtual Machine.

The command below is an example of how to create an L40s machine

info

This will create a compute resource that will incur cost.

user@machine ~ % raic vm create test-vm --public-key-id <id> --sku ogx-l40s-48 --os-image Ubuntu-20.04 --region gravelines-4
0cc1d7ca-88df-41ba-8713-b4214bf12f0c

user@machine ~ % raic vm list
ID                                   | Name    | Status
0cc1d7ca-88df-41ba-8713-b4214bf12f0c | test-vm | Available

Manage Virtual Machine​

Once a machine is Available, you can perform administrative actions on the machine (you can read more about VM actions here)

# restart
user@machine ~ % raic vm restart 0cc1d7ca-88df-41ba-8713-b4214bf12f0c

# suspend 
user@machine ~ % raic vm suspend 0cc1d7ca-88df-41ba-8713-b4214bf12f0c

# resume (after suspend)
user@machine ~ % raic vm resume 0cc1d7ca-88df-41ba-8713-b4214bf12f0c

# delete
user@machine ~ % raic vm delete 0cc1d7ca-88df-41ba-8713-b4214bf12f0c

Contents