Skip to content

docs: Add info on purge-command-not-found.yml custom playbook #784

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 15, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions doc/source/configuration/release-train.rst
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,23 @@ apt repositories. This can be done on a host-by host basis by defining the
variables as host or group vars under ``etc/kayobe/inventory/host_vars`` or
``etc/kayobe/inventory/group_vars``.

For Ubuntu-based deployments, Pulp currently `lacks support
<https://github.com/pulp/pulp_deb/issues/419>`_ for certain types of content,
including i18n files and command-not-found indices. This breaks APT when the
``command-not-found`` package is installed:

.. code:: console

E: Failed to fetch https://pulp.example.com/pulp/content/ubuntu/jammy-security/development/dists/jammy-security/main/cnf/Commands-amd64 404 Not Found

The ``purge-command-not-found.yml`` custom playbook can be used to uninstall
the package, prior to running any other APT commands. It may be installed as a
:kayobe-doc:`pre-hook <custom-ansible-playbooks.html#hooks>` to the ``host
configure`` commands. Note that if used as a hook, this playbook matches all
hosts, so will run against the seed, even when running ``overcloud host
configure``. Depending on the stage of deployment, some hosts may be
unreachable.

For CentOS and Rocky Linux based systems, package manager configuration is
provided by ``stackhpc_dnf_repos`` in ``etc/kayobe/dnf.yml``, which points to
package repositories on the local Pulp server. To use this configuration, the
Expand Down