/ansible-portus

Install Portus for the ECS automation platform

Primary LanguageShellMIT LicenseMIT

Ansible Role: portus

Build Status Galaxy

Installs portus on Ubuntu 16.04 (Xenial)

Requirements

This role requires Ansible 2.6.2 or higher.

Role Variables

The role defines most of its variables in defaults/main.yml:

Example Playbook

Run with default vars:

- hosts: all
  roles:
    - role: entercloudsuite.portus
      portus_password: myportuspassword
      portus_fqdn: portus.example.com
      registry_fqdn: registry.example.com
      letsencrypt_email: sysadmins@test.com

for setting up portus follow this guide

Testing

Tests are performed using Molecule.

Install Molecule or use docker-compose run --rm molecule to run a local Docker container, based on the enterclousuite/molecule project, from where you can use molecule.

  1. Run molecule create to start the target Docker container on your local engine.
  2. Use molecule login to log in to the running container.
  3. Edit the role files.
  4. Add other required roles (external) in the molecule/default/requirements.yml file.
  5. Edit the molecule/default/playbook.yml.
  6. Define infra tests under the molecule/default/tests folder using the goos verifier.
  7. When ready, use molecule converge to run the Ansible Playbook and molecule verify to execute the test suite.
    Note that the converge process starts performing a syntax check of the role.
    Destroy the Docker container with the command molecule destroy.

To run all the steps with just one command, run molecule test.

In order to run the role targeting a VM, use the playbook_deploy.yml file for example with the following command: ansible-playbook ansible-portus/molecule/default/playbook_deploy.yml -i VM_IP_OR_FQDN, -u ubuntu --private-key private.pem.

License

MIT