Skip to content

USAS - #1069

Open
HoneyBearTech wants to merge 7 commits into
linuxserver:masterfrom
HoneyBearTech:USAS
Open

USAS#1069
HoneyBearTech wants to merge 7 commits into
linuxserver:masterfrom
HoneyBearTech:USAS

Conversation

@HoneyBearTech

Copy link
Copy Markdown
Contributor

Adds USAS (https://github.com/HoneyBearTech/ubuntu-server-auto-setup), a self-hosted web UI and set of
Ansible playbooks that install Ubuntu Server on new Proxmox VE VMs unattended and apply a hardened
baseline, as an enhanced app.

  • Endpoint: GET /api/status, documented in USAS's docs/interfaces.md ("The status API"). It returns a
    short summary only: the running run's playbook, the last run's playbook and result, the inventory's
    servers still to install, and the cluster's running/total VMs. It never holds host, node, cluster or
    VM names, addresses, VM IDs, logs or secrets.
  • Auth: Authorization: Bearer . The API is off (404) until the token is made in USAS on
    the Account page, under "Status for dashboards"; the token can read this summary and nothing else.
    The config field is a password input.
  • Tile: Run / VMs / New. "Run" shows the last run's result (OK, Failed, Stopped), or "Now" with the
    playbook while a run is going. Status is "active" while a run is in progress (5 s refresh),
    otherwise 30 s. Unknown values in the answer are ignored, so the tile only ever shows its own labels.

Test plan: tested against a self-hosted USAS (v0.6.0) in linuxserver/heimdall (2.8.3). Test says
"Successfully communicated with the API" with a valid token; the tile showed "Run OK, VMs 10/11, New 2",
and "Now Install" during a provisioning run.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

2 participants