VeselaHouba / f5-docker

f5-docker

Docker image built around ansible role for managing F5 boxes.

F5 role: https://gitlab.m-cloud.cz/ansible/f5

Quickstart

For impatient: This is how you run the role.

git clone https://github.com/VeselaHouba/f5-docker
cd f5-docker
./runme-docker.sh playbooks/dev.yml

This will obviously fail, because the repo config is empty. You have to create it first, but at least you know the deploy part works.

Not a bad idea to update image from time to time

docker pull jmcloud/f5-docker

Example structure

Create your local ansible configuration. Folowing basic structure is expected/tested.

.
|-- .vault_pass.txt
|-- ansible.cfg
|-- f5_partial_deploy.yml
|-- requirements.yml
|-- environments
|   |-- env01
|   |   |-- group_vars
|   |   |   |-- all
|   |   |   |   |-- default.yml
|   |   |   |   |-- f5_asm.yml
|   |   |   |   |-- f5_certificates.yml
|   |   |   |   |-- f5_irules_datagroups.yml
|   |   |   |   |-- f5_monitors.yml
|   |   |   |   |-- f5_profiles.yml
|   |   |   |   `-- f5_provider.yml
|   |   |   |-- lab
|   |   |   |   |-- f5_irules.yml
|   |   |   |   |-- f5_ltm.yml
|   |   |   |   `-- vault.yml
|   |   |   |-- preprod
|   |   |   |   |-- f5_irules.yml
|   |   |   |   |-- f5_ltm.yml
|   |   |   |   `-- vault.yml
|   |   |   `-- prod
|   |   |       |-- f5_irules.yml
|   |   |       |-- f5_ltm.yml
|   |   |       `-- vault.yml
|   |   `-- hosts
|-- files
|   |-- ASM_policies
|   |   `-- policy01.xml
|   |-- certificates
|   |   |-- cert01.crt
|   |   `-- cert01.key
|   |-- data_groups
|   |   `-- data_group01.txt
|   |-- iApps
|   |   `-- iapp01.tmpl
|   `-- iRules
|       `-- irule01.tcl
`-- playbooks
    |-- lab.yml
    |-- preprod.yml
    `-- prod.yml

Run image with your config. You can use script ./runme-docker.sh

#!/usr/bin/env bash
PARTIAL=""
if [ -f f5_partial_deploy.yml ]; then
  PARTIAL="-v $(pwd)/f5_partial_deploy.yml:/opt/ansible/f5_partial_deploy.yml"
fi
IMG=jmcloud/f5-docker
docker run \
  --rm \
  -ti \
  -v "$(pwd)/environments:/opt/ansible/environments" \
  -v "$(pwd)/files:/opt/ansible/files" \
  -v "$(pwd)/.vault_pass.txt:/opt/ansible/.vault_pass.txt" \
  -v "$(pwd)/ansible.cfg:/opt/ansible/ansible.cfg" \
  -v "$(pwd)/playbooks:/opt/ansible/playbooks" \
  "${PARTIAL}" \
  -e 'DISPLAY_SKIPPED_HOSTS' \
  -e 'ANSIBLE_DISPLAY_OK_HOSTS' \
  "${IMG}" \
  bash -c "ansible-playbook playbooks/lab.yml"

Development version

To use latest packages, you can change IMG variable to jmcloud/f5-docker:dev or to daily version. Check available docker tags on https://hub.docker.com/r/jmcloud/f5-docker/tags.

Related projects

https://gitlab.m-cloud.cz/ansible/f5

License

BSD

Author Information

Jan Michalek (michalek_at_m-cloud.cz)