gru

README

= Go Redfish Utility (`gru`)
:toc:
:toclevels: 3

image:https://github.com/Cray-HPE/gru/actions/workflows/test.yml/badge.svg[link="https://github.com/Cray-HPE/gru/actions/workflows/test.yml",title="Test status"]
image:https://github.com/Cray-HPE/gru/actions/workflows/lint.yml/badge.svg[link="https://github.com/Cray-HPE/gru/actions/workflows/lint.yml",title="Lint status"]

An asynchronous RedFish utility for interrogating and managing blade management controllers.

== Usage

[source,bash]
----
gru help
----

.Setting Credentials

* Environment Variables
+
[source,bash]
----
export USERNAME=admin
export PASSWORD=password
gru show system myserver-bmc.local
----

* Configuration File
+
[source,yaml]
----
---
username: admin
password: password
----

* Configuration file with a general username/password and exceptions (for `server10` use a different username and password)
+
[source,yaml]
----
---
username: admin
password: password
hosts:
  server10:
      username: root
      password: password
----


.Querying Servers

* Pass any number of hosts, delimited by spaces.
+
[source,bash]
----
gru show system myserver-bmc.local myotherserver-bmc.local
----
* Piping a list a space delimited list of hosts.
+
[source,bash]
----
grep -oP pattern /etc/hosts | tr -s '\n' ' ' | gru show system
----

== Development

[source,bash]
----
make gru
./gru
----