Ansible Collection for Kubernetes - plopoyop.kubernetes

Description

This Ansible collection provides a set of roles to install and configure various tools on a Kubernetes cluster using their helm charts. The goal is to simplify and automate the deployment of these tools using Ansible.

Contents

This collection includes multiple Ansible roles designed to install and configure essential tools for a Kubernetes cluster. Each role is designed to be as configurable as possible while providing default settings tailored to my specific usage.

Disclaimer

The roles provided in this collection are developed based on my usage of the tools and my specific needs. While configuration options are available to adjust their behavior, not all possible options are necessarily supported.

Before using this collection in production, ensure that the default configurations meet your needs and adjust them if necessary.

Prerequisites

• Ansible >= 2.9
• A running Kubernetes cluster
• Administrator access to cluster nodes (if required for certain installations)

Installation

To install this collection, use the following command:

ansible-galaxy collection install plopoyop.kubernetes

Usage

You can call the roles from this collection in your Ansible playbooks as follows:

- name: Install a tool on Kubernetes
  hosts: localhost
  roles:
    - role: plopoyop.kubernetes.role_name
      vars:
        config_option: value

Collection content

List of Roles and Helm Chart Versions

Role Name	Helm Chart Version	README Link
metallb	v0.14.9	View README
traefik_helm_version: v34.5.0	View README
cert_manager	v0.17.1	View README
mongodb community operator	v0.12.1	View README

Customization

Each role exposes variables to adjust the configuration of the installed tools. Refer to each role's documentation for available variables.

Plugins

This collection includes custom plugins to extend Ansible’s functionality.

read_local_tfstate

Description: This plugin allows you to get variables from multiple local terraform tfstates with a ansible_vars output.

Configuration via Environment Variables

Variable Name	Description	Example Value
ANSIBLE_VARS_ENABLED	Ansible env var of which vars plugins are envabled	host_group_vars,plopoyop.kubernetes.read_local_tfstate
TF_STATES_PATHS	Local path for tfstate	$PWD/terraform/terraform.tfstate,$PWD/terraform2/terraform.tfstate

To set these variables, you can use:

export ANSIBLE_VARS_ENABLED="host_group_vars,plopoyop.kubernetes.read_local_tfstate"
export TF_STATES_PATHS="$PWD/terraform/terraform.tfstate"

read_s3_tfstate

Description: This plugin allows you to get variables from multiple tfstates stored on S3 with a ansible_vars output.

Configuration via Environment Variables

Variable Name	Description	Example Value
TF_BACKEND_BUCKET_NAME	Name of the S3 bucket	tfstates
AWS_ENDPOINT_URL	S3 endpoint to use	s3.amazonaws.com
AWS_REGION	S3 region	us-east-1
AWS_ACCESS_KEY_ID	Access key Id	your access key id
AWS_SECRET_ACCESS_KEY	Secret Access Key	your secret access key
TF_TARGET	Path to tfstate files in the bucket	prod/terraform.tfstate,dev/terraform.tfstate

To set these variables, you can use:

TF_BACKEND_BUCKET_NAME="tfstates"
AWS_REGION="us-east-1"
AWS_ACCESS_KEY_ID="accesskeyid"
AWS_SECRET_ACCESS_KEY="secretaccesskey"
TF_TARGET="prod/terraform.tfstate,dev/terraform.tfstate"

Contributions

Contributions are welcome! Feel free to open issues or submit pull requests to improve the roles and add new features.

Tools

Devenv.sh is used to make

License

This collection is distributed under the Mozilla Public License Version 2.0 license.