Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This tutorial details how to deploy a development environment in the ITS Private Cloud using the VSS CLI. It assumes you already have set up a VSS account with access to the REST API.

Anchor
Launch-Instance
Launch-Instance
Anchor
DeployingaDevelopmentEnvironment-Launch-Instance
DeployingaDevelopmentEnvironment-Launch-Instance
Launch Instance

Before launching the virtual machine instance we need the following items:

...

Then, all is ready to deploy a brand new virtual machine.

Anchor
Operating-system
Operating-system
Anchor
DeployingaDevelopmentEnvironment-Operating-system
DeployingaDevelopmentEnvironment-Operating-system
Operating system

Run vss-cli compute os ls to display the list of supported operating systems in the ITS Private Cloud. In order to narrow down the list to only CentOS operating systems, use the --filter-by/-f option which is structured <field_name>=<operator>,<value> and available operators are eq, ne, lt, le, gt, ge, like, in. So, to limit results to just CentOS, use the following filter:

...

Code Block
languagebash
linenumbersfalse
export OS=centos64Guest

Anchor
Network
Network
Anchor
DeployingaDevelopmentEnvironment-Network
DeployingaDevelopmentEnvironment-Network
Network

Run vss-cli compute net ls to list available network segments to your account. You must have at least VL-1584-VSS-PUBLIC which is our public network.

...

Code Block
languagebash
linenumbersfalse
export NET=dvportgroup-11052=e1000e

Anchor
Folder
Folder
Anchor
DeployingaDevelopmentEnvironment-Folder
DeployingaDevelopmentEnvironment-Folder
Folder

Logical folders can be listed by running vss-cli compute folder ls. Select the target moref folder to store the virtual machine on:

...

Code Block
languagebash
linenumbersfalse
export FOLDER=group-v6736group-v6736

Anchor
ISO-Image
ISO-Image
Anchor
DeployingaDevelopmentEnvironment-ISO-Image
DeployingaDevelopmentEnvironment-ISO-Image
ISO Image

Since this tutorial creates a virtual machine from scratch, an ISO image is required to install the operating system. Run vss-cli compute iso public ls to display available ISO images in both the VSS central store and your personal VSKEY-STOR space.

...

Code Block
languagebash
linenumbersfalse
export ISO='[vss-ISOs] Linux/CentOS/CentOS-7.0-1406-x86_64-DVD.iso'

Anchor
Deployment
Deployment
Anchor
DeployingaDevelopmentEnvironment-Deployment
DeployingaDevelopmentEnvironment-Deployment
Deployment

Run vss-cli compute vm mk shell to deploy a virtual machine without an operating system installed. Before deploying the virtual machine, display what options and arguments the shell command takes:

...

In matter of seconds, a confirmation email will be sent with the allocated IP address, if VL-1584-VSS-PUBLIC was selected.

Anchor
Manage-Request
Manage-Request
Anchor
DeployingaDevelopmentEnvironment-Manage-Request
DeployingaDevelopmentEnvironment-Manage-Request
Manage Request

If you prefer to validate the status of the request with VSS CLI, run vss-cli request new ls to display a list of your request history.

...

Code Block
languagebash
linenumbersfalse
vss-cli request new ls -s created_on=desc -c 1

  id  created_on                   updated_on                   status     vm_moref    vm_name          approval.approved    built_from
----  ---------------------------  ---------------------------  ---------  ----------  ---------------  -------------------  ------------
  78  2020-04-24 Fri 17:06:49 EDT  2020-04-24 Fri 17:06:51 EDT  PROCESSED  vm-2185     2004T-Frontend3  True                 os_install

Anchor
Access-Instance
Access-Instance
Anchor
DeployingaDevelopmentEnvironment-Access-Instance
DeployingaDevelopmentEnvironment-Access-Instance
Access Instance

Since we added the --power-on option, the virtual machine should have been powered on right after the Guest Operating System Customization task completed.

...