Skip to content
Weik.ioUniversity
Try Weik.io

Sites and agents

Admin 3 · 3:49

A new site joins your Weik.io installation by enrolling its agent, and the agent's capabilities decide which deployments placement puts on it. Until a matching agent is online, a production deploy is refused.

Download the mp4Recorded on 2026.2

What it covers

  • A production deploy refused because no online agent matches it
  • Sites, leaf nodes and the one outward link to the hub
  • Writing a site bundle with weikio agent enrol fi-01
  • Capabilities on agents and requirements on deployments
  • The agent's page in the admin UI, with its capabilities, projects and environments under Configuration
  • Taking an agent out of placement with weikio agent drain, and back with weikio agent undrain

Commands in this video

Terminal
$ weikio deploy sandbox/hello --env production --version 0.1.0
$ weikio agent enrol fi-01 --host linux-compose --capabilities os=linux,region=fi,environment=production --projects sandbox,finance --via public
$ weikio get agents
$ weikio agent drain fi-01
$ weikio agent undrain fi-01
Transcript
  1. 0:01This video connects a new agent to the hub, so hello can also run in production.
  2. 0:10The hub is the platform's central server, with agent dev online.
  3. 0:15hello runs in the devtest environment of project sandbox, at version 0.1.0.
  4. 0:25The published address is the hub's public name.
  5. 0:30Production is protected and empty.
  6. 0:37The production deploy of hello is the next step.
  7. 0:41No online agent matches it, so the platform refuses the deploy.
  8. 0:46The error names the command that would fix it.
  9. 0:53A site is a host with an agent and a leaf node.
  10. 0:56The leaf node keeps one outward link to the hub.
  11. 0:59It links to the published address, so the site needs no inbound port.
  12. 1:04The agent at this site is fi-01.
  13. 1:11weikio agent enrol fi-01 writes the site bundle to its own folder.
  14. 1:18The bundle holds eight files, the compose file and the credentials among them.
  15. 1:24The setup step runs off camera. It installs the agent and starts it.
  16. 1:32weikio get agents lists fi-01 as online.
  17. 1:40The admin UI has the same fields in its Enrol agent dialog.
  18. 1:48A capability is a key and value pair an admin writes on an agent.
  19. 1:53The operating system an agent reports never becomes a capability.
  20. 1:57A requirement is what a deployment needs, and its environment is one of them.
  21. 2:02Placement puts it on every agent that matches,
  22. 2:05so the production deploy runs on fi-01.
  23. 2:13The agent's own page is the one to read.
  24. 2:16Its Overview names the agent, its host and its status, and the integrations it runs.
  25. 2:22Under Configuration, Placement lists what is placed here and the capabilities,
  26. 2:27projects and environments the agent serves.
  27. 2:34To take an agent out of placement, drain it.
  28. 2:39The drain confirms it,
  29. 2:40then prints what keeps running and the lines that move or stop it.
  30. 2:48Undrain clears the draining state, and the agent is back in its placement.
  31. 2:57The hub is the platform's central server.
  32. 3:00The published address is its public name.
  33. 3:02The site connects through its leaf node.
  34. 3:05The site's agent is fi-01, and the hub's is dev.
  35. 3:10hello's production deployment runs on fi-01.
  36. 3:15Environments are devtest and production.

Next in this track

Admin 4 · 3:00 Watching the whole installation Watched