How To: Create VM with ssh access (sys-admin nomination required)

Prerequisites

The user has to be registered in the IAM system for INFN-Cloud https://iam.cloud.infn.it/. Only registered users can login into the INFN-Cloud dashboard https://my.cloud.infn.it.

User responsabilities

Important

The solution described in this guide consists on instantiation of a Virtual Machine instantiated on INFN-CLOUD infrastructure. The instantiation of a VM comes with the responsibility of maintaining it and all the services it hosts.

Please read the INFN Cloud AUP in order to understand the responsabilities you have in managing this service.

Selection of the Deployment type

Note

If you belong to multiple projects, aka multiple IAM-groups, after login into the dashboard, from the upper right corner, select the one to be used for the deployment you intend to perform. Not all solutions are available for all projects. The resources used for the deployment will be accounted to the respective project, and impact on their available quota. See figure below.

../_images/howto1_01.png

Once selected the project choose the “Virtual Machine” button from the list of solutions available for your group:

../_images/howto1_1.png

Figure 1: Use-cases panel in the Dashboard

A menu is made available, as in the figure below:

../_images/howto1_2.png

Figure 2: Select type of VM to deploy

The first choice gives the possibility to deploy a simple VM with a certain amnount of resources, expresed in terms of CPU and RAM, accessible via ssh. The second one is similar with the difference that it gives also the possibility to attach to the VM an additional disk with a specified size.

Select the one you are interested in and follow the corresponding section below in order to understand what parameters need to be set for eash use case.

Deploy a VM with no additional storage

The parameters to be used for the creation of the VM are splitted in two pages: “Configuration” and “Advanced”. Some of them are mandatory, you need to specify their value before moving to the “Advanced” tab.

Configuration

Figure 3: VM configuration parameters

Figure 3: VM configuration parameters

You need to specify:

  • Deployment description:
    • a human readable name for the deployment (max 19 characters).
    • this is a mandatory field.
  • service_ports:
    • Service ports to be open on the new VM. Only the ssh port (22) is opened by default.
      • you have to specify one port, list of ports or range of ports per line
      • multiple lines are allowed

Important

INFN Cloud has a clearly defined list of open ports (see_reference in the Networking section). The opening of any port that is not present in the above mentioned list must be formally requested through the INFN Cloud ServiceDesk

Figure 4: Open Ports configuraton

Figure 4: Open Ports configuraton

  • Flavor:
    • resources needed in terms of CPUs and RAM for the new VM
Figure 5: Flavor selection.

Figure 5: Flavor selection.

  • Operating system to be installed. Possible values are Ubuntu 18.04 and 20.4, and CentOS 7
Figure 6: Operating system selection.

Figure 6: Operating system selection.

Advanced configuration

In this section you can

  • Set deployment creation timeout (minutes)
    • amount of time to wait until the deployment should be considered failed
  • Do not delete the deployment in case of failure
    • in case further debbugging is needed
  • The automatic (default) or manual scheduling, allowing the user to perform the delpoyment by:
    • taking advantage of the PaaS Orchestrator scheduling capabilities (the recommended way), or
    • performing a direct submission towards one of the providers available, to be selected from the dropdown menu
  • send, or not, a confirmation email when deployment is complete
Figure 7: Advanced configuration tab

Figure 7: Advanced configuration tab.

Deploy a VM with block storage

This use case allows the deployment of a simple VM with an additional disk space attached.

As in the previous use case, the parameters are splitted in two pages: “Configuration” and “Advanced”, you cannot pass to the “Advanced” tab without filling all the mandatory information present in the “Configuration” tab.

Configuration

Figure 8: VM configuration parameters

Figure 8: VM configuration parameters

You need to specify:

  • Deployment description:
    • a human readable name for the deployment (max 19 characters).
    • this is a mandatory field.
  • ports
    • Service ports to be open on the new VM. Only the ssh port (22) is opened by default.
      • you have to specify one port, list of ports or range of ports per line
      • multiple lines are allowed

Important

INFN Cloud has a clearly defined list of open ports (see_reference in the Networking section). The opening of any port that is not present in the above mentioned list must be formally requested through the INFN Cloud ServiceDesk

Figure 9: List of ports to be opened

Figure 9: List of ports to be opened

  • mountpoint and volume_size
    • local directory where to mount the volume and the desired size, in GB, of the volume to be created. Maximum size allowd is 200GB.
Figure 10: Mount point and storage size configuraton

Figure 10: Mount point and storage size configuraton

  • Flavor:
    • resources needed in terms of CPUs and RAM for the new VM
Figure 11: Flavor selection.

Figure 11: Flavor selection.

  • Operating system to be installed. Possible values are Ubuntu 18.04 and 20.4, and CentOS 7
Figure 12: Operating system selection.

Figure 12: Operating system selection.

Advanced configuration

In this section you can

  • Set deployment creation timeout (minutes)
    • amount of time to wait until the deployment should be considered failed
  • Do not delete the deployment in case of failure
    • in case further debbugging is needed
  • The automatic (default) or manual scheduling, allowing the user to perform the delpoyment by:
    • taking advantage of the PaaS Orchestrator scheduling capabilities (the recommended way), or
    • performing a direct submission towards one of the providers available, to be selected from the dropdown menu
  • send, or not, a confirmation email when deployment is complete
Figure 13: Advanced configuration tab

Figure 13: Advanced configuration tab.

Deployment results

To check the status of the deployment and its details select the “Deployments” button. You’ll find there the list of all your deployment as shown below.

Figure 14: list of user deployments
Figure 14: list of user deployments

Figure 14: list of user deployments.

For each deployment the button “Action” (fig. 15) allows you

Figure 15: Available actions for each deployment

Figure 15: Available actions for each deployment

  • to get the details of deployment: overview info, input values and output values, once the deployment finishes (see fig.5)
  • to show the TOSCA template of the deployment
  • to retrieve the deployment log file that contains error messages in case of failure
  • to request additional ports to be opened
  • to show the details and the ssh private keys of the VMs created
  • to lock it
  • to delete the VM

Clicking on the deployment uuid you can see its details:

  • Overview of the cluster - where you can find information on the location of your deployment
  • The Input Values you give to create the VM
  • The Output Values you can use to access to the VM; user to use for accessing the VM, and its public key.
Figure 16: deployment output values.

Figure 16: deployment output values.