Metadata-Version: 2.4
Name: vigietools
Version: 0.0.2
Summary: OpenStack OPS API tools
Home-page: https://www.openstack.org/
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: keystoneauth1
Requires-Dist: oslo.config
Requires-Dist: oslo.log
Requires-Dist: openstacksdk
Requires-Dist: paramiko
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: requires-dist
Dynamic: summary

# About

This project is a collection of OpenStack OPS tools.

# More in details

This package contains tools useful for OpenStack cloud administrators. In
include things like:

  * Validating a compute host before putting it into service.
  * More to come.

It can be used either on the command line, using /usr/bin/vgt, or as a
Python module, called by a higher level thing.

# Example usage for validating a compute:

```
vgt validate-compute \
	--image-name debian-image \
	--flavor-name cpu2-ram6-disk0 \
	--network-name ext-net1 \
	--host cluster1-compute-2.example.com \
	--keep-enabled
```

Once done validating multiple compute node, one can:

```
vgt validate-cleanup
```

This will:
- create an aggreagte "hosts-to-validate"
- add the trait: CUSTOM_COMPUTE_TO_VALIDATE
- Make this trait required for that aggregate
- add the trait to the compute
- create a new "vgt" project and user
- create a bootable volume
- add the trait:CUSTOM_COMPUTE_TO_VALIDATE as required on that volume
- boot a VM from that volume
- make sure it is possible to ssh the newly created VM

After validate-compute the compute node trait is removed.

validate-cleanup deletes the aggregate and custom trait.

