OpenStack Operations
=========

Perform various common OpenStack operations by calling this role with an action and appropriate variables.

Requirements
------------

None

Role Variables
--------------

**General Variables**

| Name              | Default Value       | Description          |
|-------------------|---------------------|----------------------|
| `operations_task` | `skip` | Task file to include and run. See `tasks/` for available options. |

**Variables used for cleaning up Docker**

| Name              | Default Value       | Description          |
|-------------------|---------------------|----------------------|
| `operations_docker_bin` | `docker` | Path to `docker` binary. |
| `operations_docker_cleanup` | [see `defaults/main.yml`] | Filters used to determine which items will be removed. Uses Docker filter syntax. See Docker guides for [images](https://docs.docker.com/engine/reference/commandline/images/#filtering), [containers](https://docs.docker.com/engine/reference/commandline/ps/#filtering), and [volumes](https://docs.docker.com/engine/reference/commandline/volume_ls/#filtering) for filter options. |

**Variables for fetching logs**

| Name              | Default Value       | Description          |
|-------------------|---------------------|----------------------|
| `operations_log_destination` | `{{ playbook_dir }}` | Path where logs will be stored when fetched from remote systems. |

**Variables for restarting services**

| Name              | Default Value       | Description          |
|-------------------|---------------------|----------------------|
| `operations_service_names` | `[]` | List of services to restart on target systems. |

Dependencies
------------

None

Example Playbook
----------------

    - hosts: all
      tasks:
        - name: Restart a service
          import_role:
            name: openstack-operations
          vars:
            operations_task: restart_service
            operations_service_list:
              - docker
              - keystone
              - mariadb

        - name: Cleanup unused Docker images
          import_role:
            name: openstack-operations
          vars:
            operations_task: cleanup_images

        - name: Fetch logs
          import_role:
            name: openstack-operations
          vars:
            operations_task: fetch_logs

        - name: List running services
          import_role:
            name: list_services
          vars:
            operations_task: fetch_logs

License
-------

Apache 2.0