opendev/system-config
Code Issues Proposed changes
33773388a1
system-config/roles/openafs-client/README.rst

46 lines
1.5 KiB
ReStructuredText
Raw Normal View History

Add openafs-client role The role sets up a host as an OpenAFS client. As noted in the README, OpenAFS is not available in every distribution, or on every architecture. The goal is to provide sensible defaults but allow for flexibility. This is largely a port of the client parts of openstack-infra/puppet-openafs. This is a generic role because it will be used from Zuul jobs (wheel-builds) and in the control-plane (servers mounting AFS) Tested-By: https://review.openstack.org/589335 Needed-By: https://review.openstack.org/590636 Change-Id: Iaaa18194baca4ebd37669ea00505416ebf6c884c
2018-08-20 15:05:26 +10:00
An ansible role to configure an OpenAFS client
.. note:: This role uses system packages where available, but for
platforms or architectures where they are not available will
require external builds. Defaults will pick external
packages from OpenStack Infra builds, but you should
evaluate if this is suitable for your environment.
This role configures the host to be an `OpenAFS
<https://www.openafs.org>`__ client. Because OpenAFS is very reliant
on distribution internals, kernel versions and host architecture this
role has limited platform support. Currently supported are
* Debian family with system packages available
openafs-client: arch fixes The lookup() happens on the local host, not the remote host. ergo we were never using the Debian.aarch64.yaml file in production anyway (where bridge is x86 so includes only the x86 file). So clearly it is not necessary; as we have production ARM64 mirrors using the base file. This is OK because we build the packages in the PPA for x86 and arm64. We can drop openafs_client_apt_repo which isn't used any more. Follow-on will improve the testing of this. Change-Id: I298cdfefc813006f7f4218dd37015992556c8498
2020-06-03 12:34:34 +10:00
* Ubuntu LTS family with external 1.8 series packages
* CentOS 7 and 8 with external packages
Add openafs-client role The role sets up a host as an OpenAFS client. As noted in the README, OpenAFS is not available in every distribution, or on every architecture. The goal is to provide sensible defaults but allow for flexibility. This is largely a port of the client parts of openstack-infra/puppet-openafs. This is a generic role because it will be used from Zuul jobs (wheel-builds) and in the control-plane (servers mounting AFS) Tested-By: https://review.openstack.org/589335 Needed-By: https://review.openstack.org/590636 Change-Id: Iaaa18194baca4ebd37669ea00505416ebf6c884c
2018-08-20 15:05:26 +10:00
**Role Variables**
.. zuul:rolevar:: openafs_client_cell
:default: openstack.org
openafs-client: add option for OpenAFS cache location Our control plane servers generally have large ephemeral storage attached at /opt; for many uses this is enough space that we don't need to add extra cinder volumes for a reasonable cache (as we usually do on mirror nodes; but there we create large caches for both openafs and httpd reverse proxy whose needs exceed even what we get from ephemeral storage). Add an option to set the cache location, and use /opt for our new static01.opendev.org server. Change-Id: I16eed1734a0a7e855e27105931a131ce4dbd0793
2020-01-28 20:57:08 +11:00
The default cell.
Add openafs-client role The role sets up a host as an OpenAFS client. As noted in the README, OpenAFS is not available in every distribution, or on every architecture. The goal is to provide sensible defaults but allow for flexibility. This is largely a port of the client parts of openstack-infra/puppet-openafs. This is a generic role because it will be used from Zuul jobs (wheel-builds) and in the control-plane (servers mounting AFS) Tested-By: https://review.openstack.org/589335 Needed-By: https://review.openstack.org/590636 Change-Id: Iaaa18194baca4ebd37669ea00505416ebf6c884c
2018-08-20 15:05:26 +10:00
.. zuul:rolevar:: openafs_client_cache_size
:default: 500000
openafs-client: add option for OpenAFS cache location Our control plane servers generally have large ephemeral storage attached at /opt; for many uses this is enough space that we don't need to add extra cinder volumes for a reasonable cache (as we usually do on mirror nodes; but there we create large caches for both openafs and httpd reverse proxy whose needs exceed even what we get from ephemeral storage). Add an option to set the cache location, and use /opt for our new static01.opendev.org server. Change-Id: I16eed1734a0a7e855e27105931a131ce4dbd0793
2020-01-28 20:57:08 +11:00
The OpenAFS client cache size, in kilobytes.
.. zuul:rolevar:: openafs_client_cache_directory
:default: /var/cache/openafs
The directory to store the OpenAFS cache files.
Add openafs-client role The role sets up a host as an OpenAFS client. As noted in the README, OpenAFS is not available in every distribution, or on every architecture. The goal is to provide sensible defaults but allow for flexibility. This is largely a port of the client parts of openstack-infra/puppet-openafs. This is a generic role because it will be used from Zuul jobs (wheel-builds) and in the control-plane (servers mounting AFS) Tested-By: https://review.openstack.org/589335 Needed-By: https://review.openstack.org/590636 Change-Id: Iaaa18194baca4ebd37669ea00505416ebf6c884c
2018-08-20 15:05:26 +10:00
.. zuul:rolevar:: openafs_client_yum_repo_url
:default: ``https://tarballs.openstack.org/project-config/package-afs-centos7``
The URL to a yum/dnf repository with the OpenAFS client RPMs.
These are assumed to be created from the ``.spec`` file included in
the OpenAFS distribution.
.. zuul:rolevar:: openafs_client_yum_repo_gpg_check
:default: no
Enable or disable gpg checking for ``openafs_yum_repo_url``
Copy Permalink