VSS Command Line Interface (vss-cli) v2022.5.0
- JM Lopez
Analytics
VSS-CLI v2022.5.0 is available for download via PyPI or GitLab. Latest version includes the following improvements and bug fixes:
Bug Fixes
compute vm get console: throws AttributeError exception. (#519)
Improvements
core: update pyvss to 2022.5.0. (#520)
compute vm mk from-clib: option --additional-params allows setting PropertyParams and DeploymentOptionParams via input files in yaml or json. (#518)
Description
Deploying OVA/OVF and customizing the resulting vm using vApp or OVF settings via the vss-cli has finally become available. For instance, deploying a Cisco-ASAV instance and customizing both PropertyParams and DeploymentParams can be done as simple as creating a yaml file with the following:
DeploymentOptionParams:
selected_key: 1Core2GBv5
PropertyParams:
Password: WarningPlainText
Username: username
ClientIPv4: 0.0.0.0
ClientIPv4Mask: 0.0.0.0
DHCP: 'True'
DNSServerIPv4: 0.0.0.0
FWMode: transparent
HAActiveIPv4: 0.0.0.0
HARole: Standalone
HAStandbyIPv4: 0.0.0.0
HASubnetIPv4: 0.0.0.0
HTTPEnable: 'True'
Hostname: hostname
ManagementIPv4: 0.0.0.0,
ManagementIPv4DefaultGateway: 0.0.0.0,
ManagementIPv4Subnet: 0.0.0.0
ManagementStandbyIPv4: 0.0.0.0
RESTEnable: 'True'
RouteDefault: Default Route
SCHProxyDest: ''
SSHEnable: 'True'
SSHIPv4: 0.0.0.0
SSHIPv4Mask: 0.0.0.0
SmartLicIdToken: ''And then submitting a new vm request via the following command:
vss-cli compute vm mk from-clib --source Cisco-ASAV-9.16.2.3 \
--additional-params additional_params.yaml --vss-service N/A \
--folder Folder --description "Testing deployment with add params" \
--client VSS --os otherLinux --net PUBLIC
Both PropertyParams and DeploymentParams will be set upon VM deployment.
compute vm mk from-file: support clib deployments (#521)
Description
Just like the compute vm mk from-clib command, the from-file command can take a “VSS-CLI Config Spec for ContentLibrary deployment” which can be obtained by executing the following command:
vss-cli compute vm mk from-file -t clib --save --editOnce executed, the default editor will be launched with a pre-defined file template and can be customized to later be saved and executed.
The file name pattern is from-file-[unix_time].yaml
The section of interest is the following which introduces additional_parameters and/or cloud_init in the deployment specification:
With this, the deployment command can be significantly simplified by just calling:
Upgrade
Remember, VSS-CLI documentation is now available in VSS-CLI and the full Change Log is available here. Upgrade or install VSS-CLI as follows:
For more information, please refer to the official documentation site.
Related content
University of Toronto - Since 1827