From b29e272b51c57e817d8f89394abe2124440fa6d2 Mon Sep 17 00:00:00 2001
From: Musee Ullah <lae@lae.is>
Date: Fri, 29 Nov 2024 13:03:37 +0900
Subject: [PATCH] [docs] Add instructions for installing role from GitHub

---
 README.adoc | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/README.adoc b/README.adoc
index 7ebc864..c331d34 100644
--- a/README.adoc
+++ b/README.adoc
@@ -1,6 +1,7 @@
 :role-author: lae
 :role-name: netbox
 :role: {role-author}.{role-name}
+:role-version: 1.0.7
 :gh-name: {role-author}/ansible-role-{role-name}
 :netbox-version: 3.7.3
 = {role}
@@ -12,10 +13,6 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 
-ifdef::env-github[]
-image:https://img.shields.io/badge/role-{role}-blue?style=for-the-badge[Ansible Galaxy Role,link=https://galaxy.ansible.com/{role-author}/{role-name}]
-endif::env-github[]
-
 Deploys and configures https://github.com/netbox-community/netbox[NetBox], an IP address management (IPAM) and data center infrastructure management (DCIM) tool.
 
 This role will deploy NetBox within its own virtualenv either by release tarball or via git using uWSGI as the application server.
@@ -30,13 +27,23 @@ The main differences are:
 * Hardens the NetBox/uWSGI service (see `templates/netbox.service.j2`)
 * Will hot reload on upgrades and configuration changes
 
+To install this role, add the following to your `requirements.yml`:
+
+[source,yaml,subs="attributes"]
+----
+---
+- name: {role}
+  src: https://github.com/{gh-name}.git
+  version: v{role-version}
+----
+
 == Quickstart
 
 Provided you have Ansible installed and are using defaults:
 
 [source,bash,subs="attributes"]
 ----
-ansible-galaxy install geerlingguy.postgresql davidwittman.redis {role}
+ansible-galaxy install geerlingguy.postgresql davidwittman.redis https://github.com/{gh-name}/archive/refs/tags/v{role-version}.tar.gz,{role}
 ansible-galaxy collection install community.postgresql
 ansible-playbook -i your.server.fqdn, ~/.ansible/roles/{role}/examples/playbook_single_host_deploy.yml -K
 ----
@@ -48,7 +55,7 @@ You can also use Vagrant, if you prefer, to bring up NetBox at `localhost:8080`:
 
 [source,bash,subs="attributes"]
 ----
-ansible-galaxy install geerlingguy.postgresql davidwittman.redis {role}
+ansible-galaxy install geerlingguy.postgresql davidwittman.redis https://github.com/{gh-name}/archive/refs/tags/v{role-version}.tar.gz,{role}
 ansible-galaxy collection install community.postgresql
 cd ~/.ansible/roles/{role}/
 vagrant up