oxidecomputer / oxidecomputer/omicron
fm: want PSCs to exist in the external API
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 572
- Forks
- 97
- Avg merge
- 2d 12h
- Merged PRs (30d)
- 96
Description
Presently, we have /system/hardware/sleds and /system/hardware/switches APIs for fetching and listing sleds and switches, but there is no corresponding API for power shelves/power shelf controllers. We will need such an API to give fault management the language to refer to Active Problems that impact a power shelf.
I'd want a PSC API model to include:
- The PSC's baseboard identity (
part,revision, serial`) - An immutable system-assigned UUID
- The rack UUID
- Which physical power shelf slot it's in (shelf 0/shelf 1)
This should be pretty straightforward to add, since the baseboard identity is already in the inventory along with the MGS slot it was inventoried from.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Compare the existing /system/hardware/sleds and /system/hardware/switches API models and handlers, then trace the inventory data and MGS slot for power shelf controllers. Define the PSC response with baseboard identity, UUID, rack UUID, and shelf slot; done means the external API lists and returns PSCs with those fields.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- api, backend
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 58/100