Will Szumski c583922c27 Add support for infrastructure VMs
This change allows you to define additional VMs to deploy
on the seed-hypervisor.

Co-authored-by: Piotr Parczewski <piotr@stackhpc.com>
Co-authored-by: Will Szumski <will@stackhpc.com>
Co-authored-by: Mark Goddard <mark@stackhpc.com>
Story: 2008741
Task: 42095
Change-Id: I8055fc5eb0a9edadcb35767303c659922f2d07ca
2021-10-04 12:40:54 +01:00

80 lines
2.2 KiB
ReStructuredText

=======================
Infra VM Administration
=======================
Deprovisioning Infrastructure VMs
=================================
.. note::
This step will destroy the infrastructure VMs and associated data volumes.
Make sure you backup any data you want to keep.
To deprovision all VMs::
(kayobe) $ kayobe infra vm deprovision
This can be limited to a subset of the nodes using the ``--limit`` option::
(kayobe) $ kayobe infra vm deprovision --limit example-vm-1
Updating Packages
=================
It is possible to update packages on the infrastructure VMs.
Package Repositories
--------------------
If using custom DNF package repositories on CentOS, it may be necessary to
update these prior to running a package update. To do this, update the
configuration in ``${KAYOBE_CONFIG_PATH}/dnf.yml`` and run the following
command::
(kayobe) $ kayobe infra vm host configure --tags dnf
Package Update
--------------
To update one or more packages::
(kayobe) $ kayobe infra vm host package update --packages <package1>,<package2>
To update all eligible packages, use ``*``, escaping if necessary::
(kayobe) $ kayobe infra vm host package update --packages "*"
To only install updates that have been marked security related::
(kayobe) $ kayobe infra vm host package update --packages "*" --security
Note that these commands do not affect packages installed in containers, only
those installed on the host.
Kernel Updates
--------------
If the kernel has been updated, you will probably want to reboot the host
to boot into the new kernel. This can be done using a command such as the
following::
(kayobe) $ kayobe infra vm host command run --command "shutdown -r" --become
Running Commands
================
It is possible to run a command on the host::
(kayobe) $ kayobe infra vm host command run --command "<command>"
For example::
(kayobe) $ kayobe infra vm host command run --command "service docker restart"
Commands can also be run on the seed hypervisor host, if one is in use::
(kayobe) $ kayobe seed hypervisor host command run --command "<command>"
To execute the command with root privileges, add the ``--become`` argument.
Adding the ``--verbose`` argument allows the output of the command to be seen.