Upgrading to v0.11.0
v0.11.0 adds config as code: a project described in one falak.yaml in its repository. It is opt-in per project, so the upgrade itself changes little. Read the notes below before you run falak-ctl update.
Update
Section titled “Update”-
Update the control plane:
Terminal window falak-ctl update --version v0.11.0The update runs the new migrations as usual.
-
Update every agent: Servers → Update all agents (see Agent upgrades).
-
Update the CLI on your machines if you want the new commands (
falak init,plan,apply…). Older CLIs keep working for everything else. See Install and log in.
Permissions and API tokens
Section titled “Permissions and API tokens”The new permissions config.view, config.apply, config.approve and config.destroy are given to the existing roles automatically when the update migrates; there is nothing to do for members.
| Permission | Roles (besides owner) |
|---|---|
config.view |
admin, developer, viewer |
config.apply |
admin, developer |
config.approve |
admin |
config.destroy |
admin |
Nothing changes until a source is enabled
Section titled “Nothing changes until a source is enabled”A project keeps working exactly as before until its config source is enabled (Project settings → Config as code, or falak config source set). For a new project, an admin lists the servers the project’s file may place units on. See the quick start.
Behaviour changes
Section titled “Behaviour changes”- Workers now have a name. Workers made in the dashboard have none and export as
worker-<n>; a file using that key adopts the worker and names it. - Dashboard edits of file-managed fields answer 422, and managed services can’t be renamed or deleted. Fields the file doesn’t set stay editable; disabling the source makes everything editable again.
- Former panel domains redirect with 308. Domains kept with
falak-ctl domain set --keep-oldnow redirect with308, so POSTs keep their method. See Change the domain.
Checklist
Section titled “Checklist”| ☐ | falak-ctl update --version v0.11.0 done |
| ☐ | Every agent updated |
| ☐ | API tokens with a list of abilities given the config.* abilities they need |
| ☐ | CLI updated where you use config as code |