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

VSS-CLI v2023.2.1 is available for download via https://pypi.org/project/vss-cli/ or GitLab (internal). Latest version includes the following improvements and bug fixes:

1 Improvements
2 Bug Fixes
- 2.1 compute vm mk set storage-type: missing pyaload_options for scheduling (#607)
3 Upgrade

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 https://eis-vss.atlassian.net/wiki/spaces/VSSPublic/blog/2023/02/27/1251901441 ). 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/ .

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

Improvements

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

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

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)