VSS Command Line Interface (vss-cli) v2023.2.1

By JM Lopez
3 min

VSS-CLI v2023.2.1 is available for download via Client Challenge  or GitLab (internal). Latest version includes the following improvements and bug fixes:

Improvements

compute vm mk from-file: support clone and template build process. (#602)

Description

The easiest and quickest method to deploy any virtual machine on the ITS Private Cloud is using the vss-cli deployment specification. Thanks to this Infrastructure as Code (IaC) implementation, we create declarative infrastructure that can be executed repeatedly and it will have the same result.

Usage: vss-cli compute vm mk from-file [OPTIONS] [FILE_SPEC] Create virtual machine from VSS CLI file specification. Run the following command to deploy a vm based on a VSS CLI specification template: vss-cli compute vm mk from-file -s -t shell -e vm.yaml Or from an existing vm: vss-cli compute vm get <name-or-vm_id> spec --edit vm.yaml Edit vm.yaml file and deploy as follows: vss-cli compute vm mk from-file <cli-spec>.json|yaml Options: -t, --spec-template [shell|clib|template|clone] Specification template to load and edit. -e, --edit Edit before submitting request -s, --save Save file after editing. --help Show this message and exit.

To create an empty file specification to deploy a VM from template, just execute the following command:

vss-cli compute vm mk from-file --edit --save

Once you filled out the required settings, the vss-cli will take the specification and submit a request to the API.

If another VM was going to be deployed as the previous one, just execute a similar command as follows:

vss-cli --wait compute vm mk from-file from-file-1677513149.yaml
Deploy a VM from vss-cli file specification.

compute vm set secure-boot: enable --on or disable --off secure boot (#605)

Description

UEFI secure boot is, as of March 2023, the default firmware in new virtual machines ( Read more Moving towards secure by default Virtual Machines ). This means when you create a virtual machine without specifying a firmware option value, we will use efi and secure-boot. If secure boot is not needed, the following commands are available for managing secure-boot settings.

Usage: vss-cli compute vm set VM_ID_OR_NAME secure-boot [OPTIONS] Update virtual machine boot configuration to enable secure boot. vss-cli compute vm set <name-or-vm_id> secure-boot --on vss-cli compute vm set <name-or-vm_id> secure-boot --off Options: --on / --off Enable/Disable secure boot [required] --help Show this message and exit.

UEFI and secure boot is our recommended setting.

compute vm mk from-file: clib and shell standardization. (#603)

compute vm mk from-file: default firmware set to efi. (#604)

core: upgrade pyvss from 2023.2.0 to 2023.2.1 (#606)

Bug Fixes

compute vm mk set storage-type: missing pyaload_options for scheduling (#607)

Upgrade

Remember, VSS-CLI documentation is now available in VSS-CLI and the full Change Log is available http://eis.utoronto.ca/~vss/vss-cli/changelog.html#v2023-2-1-2023-02-24. Upgrade or install VSS-CLI as follows:

# using vss-cli vss-cli upgrade # upgrade with pip pip install vss-cli --upgrade # install pip install vss-cli # Homebrew users brew upgrade vss-cli

For more information, please refer to the official documentation https://eis.utoronto.ca/~vss/vss-cli/ .

 

Related content

University of Toronto - Since 1827