hugoprudente.envoyproxy

Ansible Envoy Proxy Role

Envoy Proxy is a strong proxy tool for cloud applications. It is an official project in the CNCF and works well with tools like Jagger for tracking and Prometheus for monitoring.

This Ansible role helps users install and set up the basics of Envoy Proxy on virtual machines and physical servers as an alternative to standard proxies and load balancers.

Note that this role does NOT include deeper configuration details of Envoy Proxy, which require more advanced Ansible tools.

Requirements

Ansible

  • This role is made and tested with current versions of Ansible. Older versions may not work.
  • For installation instructions, visit the Ansible website.

Molecule

  • Molecule 3.x is used for testing this role.
  • Find installation guides at the Molecule website.

Ansible Galaxy

Install the latest version of this role by running:

ansible-galaxy install hugoprudente.envoyproxy

Git

To get the latest version from GitHub, run:

git clone https://github.com/hugoprudente/ansible-role-envoyproxy.git hugoprudente.envoyproxy

inside your roles/ directory.

Supported Platforms

The Envoy Proxy role currently supports:

CentOS:
- 8
Ubuntu:
- focal (20.04)
Debian:
- duster (10)

Role Variables

This role includes several variables. You can see their descriptions and default values in the defaults/main/ folder:

Name Description
main.yml Variables for Envoy Proxy installation
systemd.yml Variables for Systemd installation
logrotate.yml Variables for Logrotate installation
cluster.yml Variables for Cluster installation

Preset variable descriptions can be found in the vars/ folder:

Name Description
main.yml List of supported Envoy Proxy platforms and modules

Example Playbooks

Examples of working playbooks are available in the molecule/ folder:

Name Description
default/converge.yml Install a basic version of Envoy Proxy
container/converge.yml Install a container version of Envoy Proxy
source/converge.yml Install Envoy Proxy from source
cluster/converge.yml Install a clustered version of Envoy Proxy
custom/converge.yml Install a specific version of Envoy Proxy with log rotation and systemd

License

This project is licensed under the Apache License, Version 2.0.

Author Information

Created by Hugo Prudente.

Installa
ansible-galaxy install hugoprudente.envoyproxy
Licenza
apache-2.0
Download
165
Proprietario
Dev/Ops [SysAdmin & Software Engineer] from Brazil to Ireland