rookery serve
The operations of rookery serve, on your machine.
The operations of rookery serve. Every operation of a host is one here too: on the portal with "host": "NAME" in the frame, over HTTP under /v1/hosts/NAME/controller. Only the controller's own secrets action is refused, for which the server's secrets action of the host sends the server's secrets, and endpoints.connect, which the server opens itself for resources.connect. An action's own role is asked when it runs. Each operation names the least role a caller over TCP needs: view, operate or admin.
Every operation of rookeryd is also an operation here: on the portal with "host": "NAME" in the frame, over HTTP under /v1/hosts/NAME.
| Operation | Kind | Summary |
|---|---|---|
version | call | The version of rookery serve and of its API. |
access | call | What the caller may do here. |
setup_key.check | call | Whether a setup key works, and the rookery serve it is for. |
setup_key.claim | call | Collect the server's token with a setup key. It can be asked again until the key is done. |
setup_key.done | call | End the setup key, once its user has the token. |
hosts.list | call | The saved hosts and whether each answers. |
hosts.get | call | One host: its address, and whether it answers. |
hosts.remove | call | Remove a host's profile. The host itself is left as it is. |
hosts.profile | call | A host's profile, as it is saved. |
hosts.save | call | Save a host's profile: a new host, or a changed one. A host that is not a workstation needs only its type and access. |
hosts.credentials | call | The passwords the server generated for a host's accounts. |
hosts.actions | call | What can be done to a host: the actions its controller lists, and rookery's own. |
hosts.act | call | Run one of a host's actions. One of rookery's that changes something is a job; an action of the host's controller is a session there, which a job follows unless it needs a terminal. |
installation.actions | call | What can be done to the installation as a whole, such as a roll-out over its hosts. |
installation.act | call | Run one of the installation's actions, as a job. |
keys.list | call | The SSH keys of the server's key ring, by their public halves, with the hosts that log in with each and the key that replaces it while it rotates. |
keys.add | call | Add a key to the ring: a new ed25519 key without a body, or the OpenSSH private key in the body, which may have no passphrase. The answer has its public half only. |
keys.remove | call | Remove a key from the ring. Refused for the key rookery, while a host logs in with the key, and while it rotates. |
keys.rotate | call | Replace a key on every host that takes it, as a job: a new key beside it, and on each host the new one added, a login with it checked, and the old one removed. A host that does not answer stays pending; running it again goes on from there. When none is pending the old key is deleted. |
secrets.list | call | The names of the secrets. |
secrets.set | call | Set a secret's value. |
secrets.remove | call | Remove a secret. |
secrets.rename | call | Give a global secret another name. |
registries.list | call | The registries. |
registries.save | call | Add a registry, or change one. |
registries.remove | call | Remove a registry with its stored login. |
registries.rename | call | Give a registry another name. |
registries.check | call | Whether a registry answers and takes its login. |
plugins.list | call | The plugins: those that come with rookery and the server's own. |
plugins.add | call | Install a plugin with npm from a registry or an address. |
plugins.upload | call | Install a plugin from a .tgz, as npm pack makes one, which the server keeps. |
plugins.remove | call | Remove one of the server's own plugins. |
plugins.check | call | Ask the registries the server's own plugins came from whether they have newer versions. |
plugins.update | call | Update one of the server's own plugins, or all, to the latest version of their registry, and say which hosts are behind then. |
settings.list | call | The server's settings. |
settings.set | call | Change one of the settings that are open to callers, or any for the user the server runs as. |
setup.catalogue | call | What a new host starts from, and what plugins can install on one. |
setup.generate | call | Make up a host name, or hash or make up a password. |
provisioners.list | call | What the plugins can create machines and other resources with, what each asks for and can do, and whether it can be used here. |
provisioners.types | call | The types of provisioner the plugins bring, which a provisioner is registered as. |
provisioners.get | call | A provisioner's page: what it says of itself now, such as whether its engine answers, and what it holds: rookery's resources, with what its own list says. |
provisioners.save | call | Register a provisioner under a name of its own, of a type a plugin brings, or change the settings of one that is registered. A registered one keeps its type. |
provisioners.remove | call | Forget a registered provisioner, with its settings and the secrets it keeps of its own. It is kept while it holds resources. |
provisioners.actions | call | What can be done to a provisioner: its plugin's actions, and rookery's own settings of it. |
provisioners.act | call | Run one of a provisioner's actions. One that changes something is a job, which holds the provisioner's lock; one that only reads answers at once. |
resources.list | call | What provisioners made for rookery, as rookery's records have it. Nothing is asked of the provisioners. |
resources.create | call | Create a resource with a provisioner, as a job: a host's machine, which is then set up as the host, or a kind its plugin declares, such as a deployment from a specification. |
resources.get | call | One resource, as its provisioner says it is now. One it no longer finds is missing, and its record stays. |
resources.change | call | Change a resource, as a job: other values of its kind's arguments, a new specification, other secrets. What is not given stays. |
resources.remove | call | Remove a resource with its provisioner, as a job, and forget it. A host's profile stays. |
resources.actions | call | What can be done to a resource: start, stop and change as its kind can, its plugin's actions of the kind, and removing it. |
resources.act | call | Run one of a resource's actions. One that changes something is a job of the resource, which holds its lock; one that only reads answers at once. |
resources.logs | call | What a resource wrote, as its provisioner gives it, with secrets masked: the last lines as text, or as a WebSocket those and what follows. |
resources.follow | stream | What a resource writes, as its provisioner gives it, with secrets masked: the last lines, then what follows. |
resources.connect | stream | A TCP connection to an endpoint its provisioner reported for a resource, named by the endpoint's name or its port. The server dials it first, so one that nothing answers on, or an address rookery refuses, is an error and not a stream. |
jobs.list | call | The jobs, newest first. |
jobs.get | call | One job's state. |
jobs.follow | stream | A job's output as it is produced. |
jobs.output | call | What a job wrote, by bytes or by lines. |
jobs.stop | call | Stop a running job: its programs end, a session it follows ends on its host, and its record says who stopped it. |
inbox.list | call | Messages taken in from the hosts' channels. |
inbox.follow | stream | Messages as they are taken in from the hosts. |
inbox.done | call | Mark a message as done. |
inbox.reopen | call | Mark a message as open again. |
kv.list | call | The keys of a namespace with their values. |
kv.follow | stream | Changes to a namespace of the key-value store. |
kv.get | call | One key's value and revision. |
kv.set | call | Write a key, optionally only if nobody wrote in between. |
kv.delete | call | Remove a key. |
events.follow | stream | Channel messages of chosen hosts, jobs, key-value changes and changes to hosts and resources together. The first frame sent names what to follow; each frame received says where it came from. |