https://github.com/cray-hpe/gru
A utility for reading and modifying BMCs (e.g. iLO, RMMC) using RedFish (gofish).
https://github.com/cray-hpe/gru
bmc go gofish golang hacktoberfest redfish
Last synced: 10 months ago
JSON representation
A utility for reading and modifying BMCs (e.g. iLO, RMMC) using RedFish (gofish).
- Host: GitHub
- URL: https://github.com/cray-hpe/gru
- Owner: Cray-HPE
- License: mit
- Created: 2022-09-29T08:11:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-08-13T04:05:21.000Z (12 months ago)
- Last Synced: 2025-08-13T06:18:56.403Z (12 months ago)
- Topics: bmc, go, gofish, golang, hacktoberfest, redfish
- Language: Go
- Homepage:
- Size: 6.92 MB
- Stars: 6
- Watchers: 14
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.adoc
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
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
----