Automated Installer for 3PAR Docker Volume plugin (Ansible)

These are Ansible playbooks to automate the install of the HPE 3PAR Docker Volume Plug-in for Docker for use within Kubernetes/OpenShift environments.

If you are not using Kubernetes or OpenShift, we recommend you take a look at the Quick Start guide for using the HPE 3PAR Docker Volume Plug-in in a standalone Docker environment.

NOTE: The Ansible installer only supports RHEL/CentOS. If you are using another distribution of Linux, you will need to modify the playbooks to support your application manager (apt, etc.) and the pre-requisite packages.

Getting Started

These playbooks perform the following tasks on the Master/Worker nodes as defined in the Ansible hosts file.

• Configure the Docker Services for the HPE 3PAR Docker Volume Plug-in
• Deploys a 3-node Highly Available etcd cluster
• Deploys the config files (iSCSI or FC) to support your environment
• Installs the HPE 3PAR Docker Volume Plug-in (Containerized version) for Kubernetes/OpenShift
• Deploys the HPE FlexVolume Drivers

Prerequisites:

• Install Ansible per Installation Guide
• Login to 3PAR to create known_hosts file

Note: Entries for the Master and Worker nodes should already exist within the //.ssh/known_hosts file from the OpenShift installation. If not, you will need to log into each of the Master and Worker nodes as well to prevent connection errors from Ansible.

• modify files/hpe.conf (iSCSI or FC) based on your HPE 3PAR Storage array configuration. An example can be found here: sample_hpe.conf

• Modify hosts file to define your Master/Worker nodes as well as where you want to deploy your etcd cluster

Usage

Once the prerequisites are complete, run the following command:

$ ansible-playbook -i hosts install_hpe_3par_volume_driver.yml

Once complete you will be ready to start using the HPE 3PAR Docker Volume Plug-in within Kubernetes/OpenShift.

Please refer to the Kubernetes/OpenShift section in the Usage Guide on how to create and deploy some sample SCs, PVCs, and Pods with persistent volumes using the HPE 3PAR Docker Volume Plug-in.

Known Issues

Ansible on some Linux Distros (i.e. CentOS and Ubuntu) may throw an error about missing the docker module.

TASK [run etcd container] ******************************************************************************************************************************************
fatal: [192.168.1.35]: FAILED! => {"changed": false, "msg": "Failed to import docker-py - No module named docker. Try `pip install docker-py`"}

Run:

pip install docker

---

On Ansible 2.6 and later, per ansible/ansible#42162, docker-py has been deprecated and when running the Ansible playbook, you may see the following error:

docker_container: create_host_config() got an unexpected keyword argument 'init'

docker-py is no longer supported and has been deprecated in favor of the docker module.

If docker-py is installed, run:

pip uninstall docker-py

Run:

pip install docker