ARCHIVED

ansible-role-gh

This repo is archived. I no longer plan to maintain it. You are welcome to do anything permitted by the LICENSE.

Why, see this article about NixOS vs Ansible for more details

This role installs the GitHub CLI.

gh is GitHub on the command line. It brings pull requests, issues, and other GitHub concepts to the terminal next to where you are already working with git and your code.

Requirements

This role has the github3.py pip dependency to get the latest release of the GitHub repo.

python3 -m pip install github3.py

Supported and Tested ansible_os_families:

• Ubuntu 22.04
• elementary OS 7
• Fedora 36

Pull Requests welcome!

Role Variables

A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.

---

Specify the release version to install from GitHub

# gh_version: 1.6.1 # undefined is latest release

---

Specify the archicture you which to install on: i.e. amd64, arm64, armv6, or 386 at the time of this writing.

gh_arch: "amd64" # used in remote package url

---

Dependencies

A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.

github3.py python package

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

- hosts: servers
  roles:
    - role: iancleary.gh

License

MIT

Author Information

This role was created in 2021 by Ian Cleary.

Inspiration for the structure of this repo came from Jeff Geerling.