Skip to content

Package branch deployments and expose actionable diagnostics #1441

Open

Description

@privateip

Parent: Deliver Galactic Worker with Local and Fabric delivery for tenant services

Deliverable

Opt-in manifests, branch build instructions, Worker health signals and an operator runbook for dedicated and combined placement. It satisfies the packaging and diagnostics part of the "Operate and qualify the branch" phase exit.

This Task owns the Worker, Local and Fabric diagnostics and the two placement profiles. Each service Task (#1437 to #1440) ships its own service-specific diagnostics and manifest changes. This Task wires them into the profiles.

References:

  • Manifests: config/<component>/{base,rbac,serviceaccount} and config/kustomization.yaml, checked by task test:manifests.
  • Node roles and opt-ins: docs/operations/node-labels.md (galactic.datumapis.com/node=compute|edge, gateway=enabled, nat=enabled, edge=enabled).
  • Diagnostics conventions: docs/development/conventions.md "Metrics and logging", internal/plumbing/ebpf/metrics and docs/observability/.

Work items

  • Grant galactic-worker the RBAC to create and delete BGPVRFInstances, run it with hostNetwork, and mount the ownership fence directory (/var/lib/galactic-edge/ownership) and bpffs (see Unify host VRF ownership and CNI attachment observation #1434). Rename the fence directory if the profiles need a neutral path.
  • Document that router GC skips Worker-owned VPCs, so uninstalling Worker must first return those scopes (drain or release) or their host state is never reclaimed. Cover this in the uninstall and return-to-dedicated steps and their test.
  • Run Worker with hostPID and read access to /proc, which its peer-to-pod check needs (see Implement Worker reconciliation and its authenticated service API #1433 and docs/worker/contract.md), mount the caller allowlist file and the socket directory, and grant the RBAC for TokenReview and its watches.
  • Render dedicated and combined profiles with real role selectors, service opt-ins, RBAC, devices, namespace access, capabilities and XDP dispatcher configuration. Use branch-only image tags (v0.0.0-integration-galactic-worker*).
  • Verify each shipped container can program only the resources its component needs.
  • Expose per-capability readiness, owner generation, locality decision, hook coverage and failure reason through the conventions above.
  • Write a runbook for following a flow across the TAP, public NIC, internal pair and remote locator, with safe drain, uninstall and return-to-dedicated steps.

Dependencies

Blocked by #1433, #1434, #1435 and #1436. Can run in parallel with #1437 to #1440.

Acceptance

  • task test:manifests renders both profiles, and the PR attaches the rendered manifests and commands.
  • In the Build a reproducible baseline for dedicated placement #1432 topology, both profiles install from a clean state.
  • When a hook, a route and an attachment are removed one at a time, the diagnostics identify each failure.
  • After two reconciles, a restart, a drain and removal of the branch components, unrelated routes, maps and attachments are unchanged.
  • The delivering PR targets integration/galactic-worker, carries this evidence and says Fixes datum-cloud/galactic#1441. GitHub does not auto-close from a non-default base, so close this issue explicitly when the PR merges and record the PR and merged SHA.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Fields

    Priority

    None yet

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions