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.
Role for create and manage Envoy Proxy
ansible-galaxy install hugoprudente.envoyproxy