env

Ansible role for configuring environment settings.

This role is designed for Ubuntu 16.04.

Installation

To install the role, run:

$ ansible-galaxy install iroquoisorg.env

Usage

Environment Variables

To set global environment variables, use the env_vars variable like this:

env_vars:
    VARIABLE: 'value'
    OTHER_VARIABLE: 'some_value'

This will update the values of the variables if needed.

PAM Environment Variables - .pam_environment

If you want to limit the visibility of your environment variables to a specific user (like www-data), use the env_pam_users option:

env_pam_users:
  - { name: "www-data", "template": "pam-environment.www-data.j2" }

For multiple users, you can do:

env_pam_users:
  - { name: "www-data", "template": "pam-environment.www-data.j2" }
  - { name: "test-user", "template": "pam-environment.test-user.j2" }

Place the environment variables inside a pam-env file in your templates folder. These will be updated with each deployment.

Default Settings

---
env_hostname: ""
env_vars: {}
env_timezone: "Etc/UTC"
env_cron_jobs: []  # Example: {job: "git status", name: "job name", user: "www-data", minute: "*", hour: "*", day: "*", weekday: "*", month: "*" }
env_hosts: []  # Example: {ip: "127.0.0.1", host: "localhost"}
env_cron_host: false
env_pam_users: []

Development

For more information about developing and testing this role, please check the development guide.