p2x3yz/ansible-role-golang

Ansible role for installing the Go language SDK

Ansible Role: Go language SDK

Role to download and install the Go language SDK.

Requirements

• Ansible Core >= 2.12

• Linux Distribution

  • Debian Family

    • Debian

      • Buster (10)
      • Bullseye (11)

    • Ubuntu

      • Xenial (16.04)
      • Bionic (18.04)
      • Focal (20.04)

  • RedHat Family

    • Rocky Linux

      • 8

    • Fedora

      • 35

  • SUSE Family

    • openSUSE

      • 15.3

  • Note: other versions are likely to work but have not been tested.

Role Variables

The following variables will change the behavior of this role (default values are shown below):

# Go language SDK version number
golang_version: '1.20.4'

# Mirror to download the Go language SDK redistributable package from
golang_mirror: 'https://storage.googleapis.com/golang'

# Base installation directory the Go language SDK distribution
golang_install_dir: '/opt/go/{{ golang_version }}'

# Directory to store files downloaded for Go language SDK installation
golang_download_dir: "{{ x_ansible_download_dir | default(ansible_facts.env.HOME + '/.ansible/tmp/downloads') }}"

# Location for GOPATH environment variable
golang_gopath:

Supported Go language SDK Versions

The following versions of Go language SDK are supported without any additional configuration (for other versions follow the Advanced Configuration instructions):

• 1.20.4
• 1.20.3
• 1.20.2
• 1.20.1
• 1.20
• 1.19.9
• 1.19.8
• 1.19.7
• 1.19.6
• 1.19.5
• 1.19.4
• 1.19.3
• 1.19.2
• 1.19.1
• 1.19
• 1.18.10
• 1.18.9
• 1.18.8
• 1.18.7
• 1.18.6
• 1.18.5
• 1.18.4
• 1.18.3
• 1.18.2
• 1.18.1
• 1.18
• 1.17.13
• 1.17.12
• 1.17.11
• 1.17.10
• 1.17.9
• 1.17.8
• 1.17.7
• 1.17.6
• 1.17.5
• 1.17.4
• 1.17.3
• 1.17.2
• 1.17.1
• 1.17
• 1.16.15
• 1.16.14
• 1.16.13
• 1.16.12
• 1.16.11
• 1.16.10
• 1.16.9
• 1.16.8
• 1.16.7
• 1.16.6
• 1.16.5
• 1.16.4
• 1.16.3
• 1.16.2
• 1.16.1
• 1.16
• 1.15.15
• 1.15.14
• 1.15.13
• 1.15.12
• 1.15.11
• 1.15.10
• 1.15.9
• 1.15.8
• 1.15.7
• 1.15.6
• 1.15.5
• 1.15.4
• 1.15.3
• 1.15.2
• 1.15.1
• 1.15
• 1.14.15
• 1.14.14
• 1.14.13
• 1.14.12
• 1.14.11
• 1.14.10
• 1.14.9
• 1.14.8
• 1.14.7
• 1.14.6
• 1.14.5
• 1.14.4
• 1.14.3
• 1.14.2
• 1.14.1
• 1.14
• 1.13.15
• 1.13.14
• 1.13.13
• 1.13.12
• 1.13.11
• 1.13.10
• 1.13.9
• 1.13.8
• 1.13.7
• 1.13.6
• 1.13.5
• 1.13.4
• 1.13.3
• 1.13.2
• 1.13.1
• 1.13
• 1.12.17
• 1.12.16
• 1.12.15
• 1.12.14
• 1.12.13
• 1.12.12
• 1.12.11
• 1.12.10
• 1.12.9
• 1.12.8
• 1.12.7
• 1.12.6
• 1.12.5
• 1.12.4
• 1.12.3
• 1.12.2
• 1.12.1
• 1.12
• 1.11.13
• 1.11.12
• 1.11.11
• 1.11.10
• 1.11.9
• 1.11.8
• 1.11.7
• 1.11.6
• 1.11.5
• 1.11.4
• 1.11.3
• 1.11.2
• 1.11.1
• 1.11
• 1.10.8
• 1.10.7
• 1.10.6
• 1.10.5
• 1.10.4
• 1.10.3
• 1.10.2
• 1.10.1
• 1.10
• 1.9.6
• 1.9.5
• 1.9.4
• 1.9.3
• 1.9.2
• 1.9.1
• 1.9
• 1.8.7
• 1.8.6
• 1.8.5
• 1.8.4
• 1.8.3
• 1.8.2
• 1.8.1
• 1.8
• 1.7.4
• 1.7.3

Advanced Configuration

The following role variable is dependent on the Go language SDK version; to use a Go language SDK version not pre-configured by this role you must configure the variable below:

# SHA256 sum for the redistributable package (i.e. "go{{ golang_version }}.linux-amd64.tar.gz")
golang_redis_sha256sum: '6e3e9c949ab4695a204f74038717aa7b2689b1be94875899ac1b3fe42800ff82'

Example Playbook

- hosts: servers
  roles:
     - role: gantsign.golang
       golang_gopath: '$HOME/workspace-go'

Role Facts

This role exports the following Ansible facts for use by other roles:

• ansible_local.golang.general.version

  • e.g. 1.7.3

• ansible_local.golang.general.home

  • e.g. /opt/golang/1.7.3

More Roles From GantSign

You can find more roles from GantSign on Ansible Galaxy.

Development & Testing

This project uses the following tooling:

• Molecule for orchestrating test scenarios
• Testinfra for testing the changes on the remote
• pytest the testing framework
• Tox manages Python virtual environments for linting and testing
• pip-tools for managing dependencies

A Visual Studio Code Dev Container is provided for developing and testing this role.

License

MIT

Author Information

John Freeman

GantSign Ltd. Company No. 06109112 (registered in England)