Skip to content

Commit 09851d0

Browse files
committed
docs: Add info on purge-command-not-found.yml custom playbook
1 parent 1c37580 commit 09851d0

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

doc/source/configuration/release-train.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,23 @@ apt repositories. This can be done on a host-by host basis by defining the
107107
variables as host or group vars under ``etc/kayobe/inventory/host_vars`` or
108108
``etc/kayobe/inventory/group_vars``.
109109

110+
For Ubuntu-based deployments, Pulp currently `lacks support
111+
<https://github.com/pulp/pulp_deb/issues/419>`_ for certain types of content,
112+
including i18n files and command-not-found indices. This breaks APT when the
113+
``command-not-found`` package is installed:
114+
115+
.. code:: console
116+
117+
E: Failed to fetch https://pulp.example.com/pulp/content/ubuntu/jammy-security/development/dists/jammy-security/main/cnf/Commands-amd64 404 Not Found
118+
119+
The ``purge-command-not-found.yml`` custom playbook can be used to uninstall
120+
the package, prior to running any other APT commands. It may be installed as a
121+
:kayobe-doc:`pre-hook <custom-ansible-playbooks.html#hooks>` to the ``host
122+
configure`` commands. Note that if used as a hook, this playbook matches all
123+
hosts, so will run against the seed, even when running ``overcloud host
124+
configure``. Depending on the stage of deployment, some hosts may be
125+
unreachable.
126+
110127
For CentOS and Rocky Linux based systems, package manager configuration is
111128
provided by ``stackhpc_dnf_repos`` in ``etc/kayobe/dnf.yml``, which points to
112129
package repositories on the local Pulp server. To use this configuration, the

0 commit comments

Comments
 (0)