Ansible Role: Flocker Installer

Build Status

Requirements

• Make sure Docker is installed on all Flocker agent nodes.
• You need to install the Flocker Client on the machine that runs the Ansible playbook. Certificates are created on this local machine (in flocker_local_tempdir) using flocker-ca and then sent to the nodes. For detailed instructions, check Installing the Flocker Client.
• You must provide the path to a local agent.yml Flocker file.

Role Variables

• flocker_control_service_groupname: flocker_control_service
  This is the name of an Ansible host group that includes one host, which is the node where the Flocker control service runs. The default name is flocker_control_service. Change this if your host group has a different name.

• flocker_agents_groupname: flocker_agents
  Similar to flocker_control_service_groupname, this represents the group name for Flocker agent nodes.

• flocker_agent_yml_path: ""
  The absolute path to an agent.yml file on the local Ansible machine. For help with creating this file, see Configuring the Nodes and Storage Backends here.

• flocker_cluster_name: my_flocker_cluster
  The name of the cluster. This name will be used for creating cluster certificates and will also be the directory on the local machine where copies of certificates and keys are stored.

• Warning: This folder will be deleted every time the playbook is run.

• flocker_local_tempdir: /tmp/{{ flocker_cluster_name }}
  The path to a folder for generating cluster certificates and keys. This folder isn’t cleaned up after installation but will be deleted and recreated at the start of each provisioning.

• flocker_api_cert_name: api_user
  A unique identifier for the API client.

• flocker_install_docker_plugin: True
  Set this to True to install the Flocker Plugin for Docker.

Example Playbook

---
- hosts: nodes
  user: ubuntu
  roles:
    - role: ClusterHQ.flocker

Example Command to Run

ansible-playbook -i inventory/hosts flocker_example_playbook.yml --extra-vars "flocker_agent_yml_path=/home/user/config_files/agent.yml"

Example Inventory File

[flocker_control_service]
computer1.example.com

[flocker_agents]
computer2.example.com
computer3.example.com

[nodes:children]
flocker_control_service
flocker_agents

License

MIT / BSD