80 lines
2.3 KiB
ReStructuredText
80 lines
2.3 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 or Rocky, 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.
|