tripleo-ansible/tripleo_ansible/roles/tripleo-ceph-fetch-dir/README.md
John Fulton 4d38019467 Introduce ansible roles for ceph preparation
Create five ansible roles prefixed with "tripleo-ceph-" to
prepare the undercloud to run ceph-ansible. These roles were
previously embedded as tasks in tripleo-heat-templates.
ceph-ansible assumes its working directory persists and is
configured by the user manually. TripleO integration requires
that these steps be automated and these roles perform that
automation.

The roles may be used to create an ansible working directory
with inventory, a ceph-ansible fetch directory, a system uuid
map for node-specific-overrides, and runs ceph-ansible with
the required options.

Add ceph.yaml to the playbooks directory which can be used for
development of these roles with --skip-tags run_ceph_ansible.

Change-Id: I19cd58275a0b8f8f84776a98008cd9b10ceda908
2019-06-29 08:57:33 -04:00

45 lines
1.5 KiB
Markdown

Ansible Role to manage a ceph-ansible fetch directory
=====================================================
When scaling Ceph monitors, ceph-ansible uses context from the
fetch_directory to prevent new monitors from trying to bootstrap
a new Ceph cluster
This role saves the fetch_directory to either Swift or a local
directory after each ceph-ansible playbook run; and if there is
a backup of fetch directory in Swift or the specificied local
directory, restores it before each ceph-ansible playbook run.
The main.yml does not include the backup_and_clean.yml because
that should be run separately as a post task as needed by a
separate import using tasks_from.
Requirements
------------
None
Role Variables
--------------
- ceph_ansible_tarball_name: The name of the file which will contain a
tar.gz backup of the ceph-ansible fetch directory. Used for both the
local and swift backup methods. (default: 'temporary_dir.tar.gz')
- old_ceph_ansible_tarball_name: The name of the file which will be
saved in /tmp when the ceph-ansible fetch directory is downloaded
from Swift. Not used for local backups and only used for
Swift backups. (default: 'temporary_dir_old.tar.gz')
- new_ceph_ansible_tarball_name: The name of the file which will be
saved in /tmp after ceph-ansible runs and then uploaded to Swift.
Not used for local backups only only used for Swift backups.
(default: 'temporary_dir_new.tar.gz')
Dependencies
------------
- tripleo-ceph-common
- tripleo-ceph-work-dir