Goss Ansible Role

This is a simple Ansible role to install goss.

Requirements

None. The goss tool works on its own.

Install

To install directly from GitHub:

- name: goss
  src: http://github.com/vantaworks/goss.git
  scm: git
  version: master

Or, to install from Ansible Galaxy:

- name: goss
  src: vantaworks.goss
  version: master

Then run this command to install:

ansible-galaxy install -p roles -r requirements.yml -f

For more details on variables and example playbooks, see below.

Role Variables

Here are the available variables and their default values (see defaults/main.yml):

To choose whether to install or uninstall goss:

goss_state: "present"   # to install
goss_state: "absent"    # to uninstall

To override or upgrade an already-installed version:

goss_force_reinstall: True

To specify a particular version of goss to install. Recommended: Leave this blank for the latest version.

goss_version: 0.3.13

To set the URL for checking goss versions:

goss_version_url: "https://api.github.com/repos/aelsabbahy/goss/tags?per_page=300"

To choose where to download the goss binary:

goss_download_url: "https://github.com/aelsabbahy/goss/releases/download/{{ goss_version }}/goss-linux-{{ goss_arch }}"

To specify the intended architecture:

goss_arch: amd64
# options are: amd64, 386, arm

To select the installation path for goss:

goss_install_path: /usr/local/bin/goss

Dependencies

No special Ansible-Python dependencies are required. See the Requirements section above.

Example Playbooks

# Install the latest `goss` version
- name: Example Install Play 1
  hosts: goss
  roles:
    - vantaworks.goss

# Install a specific `goss` version
- name: Example Install Play 2
  hosts: goss
  vars:
    goss_version: 0.3.13
  roles:
    - vantaworks.goss

# Uninstall `goss`
- name: Example Uninstall Play
  hosts: goss
  vars:
    goss_state: "absent"
  roles:
    - vantaworks.goss

License

BSD