README
¶
workflow-plugin-infra
⚠️ Experimental — This plugin compiles and passes its unit tests but has not been validated in any active GoCodeAlone-internal production deployment. Use with caution. Please open an issue if you adopt it so we can promote it to verified status.
Release note — minEngineVersion
plugin.json declares "minEngineVersion": "0.80.14" — the first workflow release that frees the wfctl dns namespace for plugin-owned CLI dispatch while retaining the providerclient.ResourceDriver apply/create support this plugin's admin surface depends on at runtime.
What this plugin provides
Abstract infra.* module types (13 total: container_service, k8s_cluster, database, cache, vpc, load_balancer, dns, registry, api_gateway, firewall, iam_role, storage, certificate) with IaCProvider delegation. The plugin itself defines no provider-specific behavior — module instances are resolved against the host's configured IaC provider (e.g. workflow-plugin-digitalocean, workflow-plugin-cloudflare).
DNS handling (post-v1.0.0)
Per-provider DNS support lives in the respective provider plugins (workflow-plugin-{digitalocean,cloudflare,namecheap,hover,...}), each implementing infra.dns against its native SDK. Capability-scoped DNS orchestration is exposed by this plugin as a top-level wfctl command:
wfctl dns intent compile— compile domain intent JSON plus DNS portfolio exports into generatedinfra.dns/infra.dns_delegationconfig and a reportwfctl dns intent reconcile— compile, validate, and runwfctl infra plan/wfctl infra applyfor that generated configwfctl infra import-all --provider <m> --type infra.dns— bulk import every zone an account holds, via the provider'sIaCProviderEnumerator
Cross-cutting DNS policy and apply gates remain in wfctl core because wfctl infra apply owns that lifecycle hook:
wfctl dns-policy {show,set,transfer-ownership,drift}— manage the_workflow-dns-policy.<zone>TXT policy across any provider implementinginfra.dnswfctl infra apply— enforces the DNS ownership gate as a pre-action hook forinfra.dnsresources
The previous per-provider DNS adapter pages (docs/providers/*.md) and the infra.dns_record step type were removed in v1.0.0; the legacy step's peer-dispatch model was architecturally unsupported (see docs/plans/2026-05-26-dns-provider-contract-design.md).
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
workflow-plugin-infra
command
Command workflow-plugin-infra is a workflow engine external plugin that provides abstract infra.* module types with IaCProvider delegation.
|
Command workflow-plugin-infra is a workflow engine external plugin that provides abstract infra.* module types with IaCProvider delegation. |
|
Package internal implements the workflow-plugin-infra external plugin, providing abstract infra.* module types that delegate to an IaC provider, plus the infra.admin module type that serves the infrastructure management SPA.
|
Package internal implements the workflow-plugin-infra external plugin, providing abstract infra.* module types that delegate to an IaC provider, plus the infra.admin module type that serves the infrastructure management SPA. |