Keel-Linux/keel
1
0
Fork 0
Code Issues 36 Pull requests 8 Projects Releases Packages Wiki Activity Actions

WIP: feat: the spec's cloud section and keel cloud (0046) #68

Draft
marcos-mendez wants to merge 3 commits from feat/spec-cloud-section into main
pull from: feat/spec-cloud-section
merge into: Keel-Linux:main
Conversation 1 Commits 3 Files changed 12 +330 -4
marcos-mendez commented 2026-10-02 11:02:16 -03:00 (Migrated from github.com)
Copy link

The spec gains a cloud section for Keel Cloud (handbook decision 0046, proposed in handbook#39), additive under version: 1, and keel cloud runs Keel Cloud's node agent from the keel-overlay-cloud package of Keel-Linux/keel-cloud.

  • cloud.endpoint (https only, no path), cloud.api_key (skip or a file reference), cloud.entry_secret (a file reference), cloud.set (a DNS label, required with a key), cloud.ca_file. Secrets are file references only, never generate.
  • keel only validates it; diff reports cloud: not compared. The agent writes network.overlay.wireguard.peers, which spec apply --system converges and diff compares as before.
  • keel cloud ... execs keel-cloud-node ...; without the package it says which package and exits 9.
  • 0.16.0, changelog, docs/spec.md "cloud", README.

Tests: tests/test_spec_cloud.py; the full suite passes locally at 99.8 percent. Used in the real test of keel-cloud's Phase A on the test VM (two Keel Core containers with this keel brought the overlay up through Keel Cloud).

Test plan

  • CI green
  • Merged before keel-overlay-cloud is published, which depends on keel >= 0.16.0
The spec gains a `cloud` section for Keel Cloud (handbook decision 0046, proposed in handbook#39), additive under `version: 1`, and `keel cloud` runs Keel Cloud's node agent from the `keel-overlay-cloud` package of Keel-Linux/keel-cloud. - `cloud.endpoint` (https only, no path), `cloud.api_key` (`skip` or a file reference), `cloud.entry_secret` (a file reference), `cloud.set` (a DNS label, required with a key), `cloud.ca_file`. Secrets are file references only, never `generate`. - keel only validates it; `diff` reports `cloud: not compared`. The agent writes `network.overlay.wireguard.peers`, which `spec apply --system` converges and `diff` compares as before. - `keel cloud ...` execs `keel-cloud-node ...`; without the package it says which package and exits 9. - 0.16.0, changelog, docs/spec.md "cloud", README. Tests: `tests/test_spec_cloud.py`; the full suite passes locally at 99.8 percent. Used in the real test of keel-cloud's Phase A on the test VM (two Keel Core containers with this keel brought the overlay up through Keel Cloud). ## Test plan - [ ] CI green - [ ] Merged before keel-overlay-cloud is published, which depends on keel >= 0.16.0
marcos-mendez commented 2026-10-02 11:56:08 -03:00 (Migrated from github.com)
Copy link

Paused by the maintainer (2026-10-02) until the etcd mesh (Phase 5 of tracker#46: registry, install by discovery, three nodes without Keel Cloud) is stable. Then the node-side client ships in images, small and disabled, and is enabled later through apt update and apt upgrade. Needs an independent security review before merge.

Paused by the maintainer (2026-10-02) until the etcd mesh (Phase 5 of tracker#46: registry, install by discovery, three nodes without Keel Cloud) is stable. Then the node-side client ships in images, small and disabled, and is enabled later through apt update and apt upgrade. Needs an independent security review before merge.
This pull request has changes conflicting with the target branch.
  • README.md
  • debian/changelog
  • keel/__init__.py
  • keel/cli.py
  • pyproject.toml
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/spec-cloud-section:feat/spec-cloud-section
git switch feat/spec-cloud-section
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
accessibility

Barrier affecting people with disabilities

  
bug

Something isn't working

  
documentation

Improvements or additions to documentation

  
duplicate

This issue or pull request already exists

  
enhancement

New feature or request

  
good first issue

Good for newcomers

  
help wanted

Extra attention is needed

  
invalid

This doesn't seem right

  
question

Further information is requested

  
wontfix

This will not be worked on

No labels
accessibility
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Keel-Linux/keel!68
No description provided.