system-config/roles/openafs-client/README.rst
Ian Wienand 22c5561df3 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 21:05:27 +11:00

52 lines
1.7 KiB
ReStructuredText

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
* Ubuntu Xenial with ARM64, with external 1.8 series packages
* CentOS 7 with external packages
**Role Variables**
.. zuul:rolevar:: openafs_client_cell
:default: openstack.org
The default cell.
.. zuul:rolevar:: openafs_client_cache_size
:default: 500000
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.
.. 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``
.. zuul:rolevar:: openafs_client_apt_repo
:default: ppa:openstack-ci-core/openafs-arm64
Source string for APT repository for Debian family hosts requiring
external packages (currently ARM64)