Skip to content

Admin APIs#5692

Open
gmgigi96 wants to merge 27 commits into
cs3org:devfrom
gmgigi96:feature/admin-api
Open

Admin APIs#5692
gmgigi96 wants to merge 27 commits into
cs3org:devfrom
gmgigi96:feature/admin-api

Conversation

@gmgigi96

@gmgigi96 gmgigi96 commented Jul 2, 2026

Copy link
Copy Markdown
Member

This PR adds an admin API to reva: an authenticated, audited way to look at and operate a running fleet from a single reva admin command. It is off by default and only enabled where a process is given an admin group.

The building block is a small control channel that every reva process runs beside its services. The admin reaches into a live instance through it to read state or run an operation (an invocation), resolving targets through the registry, so a command can hit one instance, all instances of a service, or the whole fleet, with the results merged.

On top of it, an operator can:

  • inspect the fleet: list services and their health, read and diff configuration, read or follow logs, trace a single request or user across services, dump goroutines, and watch an instance's in-flight request activity;
  • act on it: set a process's log level at runtime, take instances out of and back into rotation for maintenance, drive the background jobs runner (list and enqueue jobs, trigger or cancel runs), and impersonate a user.

On the same host it needs no login, it is reached over a Unix socket and authorized by the caller's OS identity; remotely, an operator first steps up to a short-lived admin token.

Jobs is the first example of the intended pattern: typed admin API methods whose implementation reuses the invoke channel underneath, fanning out to every instance for live state, or targeting one when the state is shared.

@gmgigi96 gmgigi96 changed the title Feature/admin api Admin APIs Jul 2, 2026
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from e1dadf3 to 2b0b77a Compare July 3, 2026 13:57
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from c2a3f25 to 94bd0e4 Compare July 6, 2026 15:23
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from 07c4831 to bb3b256 Compare July 8, 2026 14:57
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from 5903811 to 243cbf9 Compare July 8, 2026 15:49
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch 2 times, most recently from cefd225 to c5f6576 Compare July 13, 2026 12:40
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch 2 times, most recently from c338ac4 to 4c78d65 Compare July 13, 2026 14:48
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch 5 times, most recently from 34b2511 to 8f9cfb8 Compare July 15, 2026 10:00
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from f8911a8 to 6d5ebd1 Compare July 15, 2026 12:36
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from ed1bc61 to af4ae10 Compare July 16, 2026 09:29
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from a1b54e7 to c638117 Compare July 16, 2026 11:21
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from 96733ed to 6f79331 Compare July 17, 2026 09:53
@cs3org cs3org deleted a comment from update-docs Bot Jul 17, 2026
@gmgigi96
gmgigi96 marked this pull request as ready for review July 17, 2026 09:58
@gmgigi96
gmgigi96 force-pushed the feature/admin-api branch from 6f79331 to 6012fbb Compare July 20, 2026 14:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant