diff --git a/doc/source/afs.rst b/doc/source/afs.rst index 9d23c3fcfb..1bb4293c12 100644 --- a/doc/source/afs.rst +++ b/doc/source/afs.rst @@ -34,6 +34,7 @@ At a Glance * :git_file:`playbooks/service-mirror-update.yaml` :Projects: * http://openafs.org/ + * http://opendev.org/opendev/infra-openafs-deb :Bugs: * http://bugs.launchpad.net/openstack-ci * `http://rt.central.org/...SNIPPED... `_ @@ -720,3 +721,29 @@ that only A (IPv4 address) records are used in the SRV data. Since OpenAFS lacks support for IPv6, avoid entering corresponding AAAA (IPv6 address) records for these so that it won't cause fallback delays for other v6-supporting AFS client implementations. + +Custom Packages +--------------- + +We run custom built packages (typically so that we have access to +bugfixes faster than appear in Ubuntu). The packages are in the +`openstack-ci-core` PPA on launchpad. + +The deb configuration files are contained in the +`opendev/infra-openafs-deb` repo. Changes to that repo cause the +packages to be built in the check and gate pipeline for build +verification, and the promote pipeline uploads the package definition +to the PPA for launchpad to build. + +This repo has a branch for each target to build. To create a new +operating system target, make a new branch. + +To update the contents of a branch, the `debian/*` files may need to +be updated by copying from the upstream debian package. The +`make-orig.sh` script should be updated to point to new upstream +version archives. + +Push a change to the appropriate target branch, merge it, and check on +the launchpad PPA to verify that it built correctly. If launchpad was +unable to build the package, you may need to fix it and increment the +revision number to trigger a new build.