constants

package
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 4, 2026 License: MPL-2.0 Imports: 1 Imported by: 0

Documentation

Index

Constants

View Source
const DefaultAKSOIDCClientID = "80faf920-1908-4b52-b5ef-a8e7bedfc67a"

DefaultAKSOIDCClientID is the standard Azure AKS OIDC client ID used for all AKS clusters.

View Source
const DefaultAKSOIDCServerID = "6dae42f8-4368-4678-94ff-3960e28e3630"

DefaultAKSOIDCServerID is the standard Azure AKS OIDC server ID (application ID of the Microsoft-managed enterprise application "Azure Kubernetes Service AAD Server"). This is the same for all AKS clusters with AKS-managed Azure AD enabled.

View Source
const DefaultAPIServerPort = 6443

DefaultAPIServerPort is the standard Kubernetes API server port.

View Source
const DefaultAPIServerReadyTimeout = 5 * time.Minute

DefaultAPIServerReadyTimeout caps how long UpgradeNode waits for the kube-apiserver on a control-plane node to accept connections after a reboot.

View Source
const DefaultAWSLocalstackImage = "localstack/localstack:4.14.0"

renovate: datasource=docker depName=localstack/localstack

View Source
const DefaultAWSLocalstackProImage = "localstack/localstack-pro:4.14.0"

renovate: datasource=docker depName=localstack/localstack-pro

View Source
const DefaultControlPlaneCPUDedicated = 4
View Source
const DefaultControlPlaneCPUSchedulable = 8
View Source
const DefaultControlPlaneMemoryDedicated = 4
View Source
const DefaultControlPlaneMemorySchedulable = 12
View Source
const DefaultConvergeTimeout = 5 * time.Minute

DefaultConvergeTimeout bounds the best-effort convergence pass an apply/up/bootstrap runs after placing secrets: it actively nudges not-ready kustomizations and forces stalled HelmReleases, returning early once everything is Ready. It is bounded (not the full install timeout) so an unwaited apply pushes the cluster along without blocking indefinitely; --wait paths still gate on the full Wait afterward.

View Source
const DefaultDNSImage = "coredns/coredns:1.14.6"

renovate: datasource=docker depName=coredns/coredns

View Source
const DefaultFluxKustomizationForce = false
View Source
const DefaultFluxKustomizationInstallTimeout = 10 * time.Minute

DefaultFluxKustomizationInstallTimeout is the timeout for a flux system's install tier when the facet sets none; install tiers install controllers and need more headroom than plain resources.

View Source
const DefaultFluxKustomizationInterval = 1 * time.Hour

DefaultFluxKustomizationInterval is the reconciliation interval for Kustomizations. Flux content here is pinned and explicitly triggered (the notifier re-fetches sources on every apply/up/bootstrap) rather than continuously tracked, so this is an eventual-consistency backstop, not the primary propagation path. A Kustomization that genuinely wants fast, continuously-polled GitOps behavior should set its own interval override.

View Source
const DefaultFluxKustomizationPrune = true
View Source
const DefaultFluxKustomizationRetryInterval = 2 * time.Minute
View Source
const DefaultFluxKustomizationTimeout = 5 * time.Minute
View Source
const DefaultFluxKustomizationWait = true
View Source
const DefaultFluxPrimaryKustomizationInterval = 5 * time.Minute

DefaultFluxPrimaryKustomizationInterval is the reconciliation interval for a Kustomization that resolves, explicitly or by default, to the blueprint's own repository rather than a named vendor source. Unlike the Source object itself (DefaultFluxPrimaryRepositoryInterval), a Kustomization's own poll is not the propagation path: kustomize-controller reconciles dependent Kustomizations via a watch on the Source's revision, which the notifier keeps fresh on every apply/up/bootstrap regardless of this interval — so this is purely a backstop for drift correction, retrying failed reconciliations, and dependency-readiness rechecks. A short interval here mainly causes needless churn: Flux's dependency-readiness check is a point-in-time Ready read with no hysteresis, so a Kustomization on a 1m interval briefly flipping to Reconciling can cascade DependencyNotReady retries through everything that depends on it, directly or transitively.

View Source
const DefaultFluxPrimaryRepositoryInterval = 1 * time.Minute

DefaultFluxPrimaryRepositoryInterval is the reconciliation interval for the blueprint's own repository (the top-level "repository:" field) as a flux Source. Unlike a named vendor source, the primary repository is typically a live, actively-pushed branch rather than a pinned release, and a change can land there without any windsor command running (a teammate's push, a CI merge) — so flux's own Source poll is the propagation path here, not just a backstop. See DefaultFluxPrimaryKustomizationInterval for why a Kustomization that resolves to this same repository doesn't need the same cadence.

View Source
const DefaultFluxSourceInterval = 1 * time.Hour

DefaultFluxSourceInterval is the reconciliation interval for flux Sources. Same rationale as DefaultFluxKustomizationInterval: sources are pinned and explicitly re-fetched by the notifier, so this is a backstop rather than the propagation path.

View Source
const DefaultFluxSourceTimeout = 2 * time.Minute
View Source
const DefaultGitLiveReloadImage = "ghcr.io/windsorcli/git-livereload:v0.2.1"

renovate: datasource=docker depName=ghcr.io/windsorcli/git-livereload-server

View Source
const DefaultGitLiveReloadPassword = "local"
View Source
const DefaultGitLiveReloadRsyncExclude = ".windsor,.terraform,.volumes,.venv"
View Source
const DefaultGitLiveReloadRsyncInclude = "kustomize"
View Source
const DefaultGitLiveReloadRsyncProtect = "flux-system"
View Source
const DefaultGitLiveReloadUsername = "local"
View Source
const DefaultGitLiveReloadWebhookLBPort = 9292

DefaultGitLiveReloadWebhookLBPort is the LoadBalancer port for the Flux webhook receiver.

View Source
const DefaultGitLiveReloadWebhookNodePort = 30292

DefaultGitLiveReloadWebhookNodePort is the NodePort for the Flux webhook receiver (docker-desktop mode).

View Source
const DefaultGitLiveReloadWebhookPath = "/hook/5dc88e45e809fb0872b749c0969067e2c1fd142e17aed07573fad20553cc0c59"

DefaultGitLiveReloadWebhookPath is the webhook path with token. Hook path corresponds to the webhook token "abcdef123456". see: https://fluxcd.io/flux/components/notification/receivers/

View Source
const DefaultGitopsNamespace = "system-gitops"
View Source
const DefaultKubernetesReachabilityCheckTimeout = 30 * time.Second

Bounds the pre-destroy Kubernetes reachability preflight.

View Source
const DefaultKustomizationWaitMaxFailures = 5

Maximum number of consecutive failures before giving up

View Source
const DefaultKustomizationWaitPollInterval = 5 * time.Second

Poll interval for CLI WaitForKustomizations

View Source
const DefaultKustomizationWaitTotalTimeout = 10 * time.Minute

Used for aggregate CLI wait (not per-resource)

View Source
const DefaultNetworkCIDR = "10.5.0.0/16"
View Source
const DefaultNodeHealthCheckPollInterval = 10 * time.Second
View Source
const DefaultNodeHealthCheckTimeout = 5 * time.Minute
View Source
const DefaultNodeOfflineTimeout = 3 * time.Minute
View Source
const DefaultNodeUpgradeTimeout = 10 * time.Minute
View Source
const DefaultOCIBlueprintURL = "oci://ghcr.io/windsorcli/core:latest"
View Source
const DefaultTalosAPIPort = 50000
View Source
const DefaultTalosImage = "ghcr.io/siderolabs/talos:v1.13.7"

renovate: datasource=github-releases depName=siderolabs/talos

View Source
const DefaultTerraformDestroyTimeout = 30 * time.Minute

Bounds a single `terraform destroy` invocation so a hung provider call fails, not blocks forever.

View Source
const DefaultWorkerCPU = 4
View Source
const DefaultWorkerMemory = 8
View Source
const KubernetesShortTimeout = 200 * time.Millisecond
View Source
const MinimumVersion1Password = "2.15.0"
View Source
const MinimumVersionAWS = "2.0.0"
View Source
const MinimumVersionAzure = "2.50.0"
View Source
const MinimumVersionColima = "0.9.0"
View Source
const MinimumVersionDocker = "23.0.0"
View Source
const MinimumVersionKubectl = "1.27.0"
View Source
const MinimumVersionKubelogin = "0.1.7"
View Source
const MinimumVersionLima = "1.0.0"
View Source
const MinimumVersionLimaIncus = "2.0.3"

MinimumVersionLimaIncus is the minimum limactl version when using colima with platform incus. Lima 1.x can hang after "Terminal is not available"; 2.0.3+ is required for reliable colima+incus startup.

View Source
const MinimumVersionSOPS = "3.10.0"
View Source
const MinimumVersionTerraform = "1.12.2"
View Source
const RegistryDefaultHostPort = 5001
View Source
const RegistryDefaultImage = "registry:3.1.1"

renovate: datasource=docker depName=registry

Variables

View Source
var BuildDate = "unknown"

BuildDate is the RFC 3339 build timestamp, set at build time via ldflags (goreleaser's `{{ .Date }}` template). Unset in `go build` / `go install`.

View Source
var CommitSHA = "none"

CommitSHA is the git commit SHA, set at build time via ldflags

View Source
var PinnedBlueprintURL = ""

Build-time variable for pinned blueprint URL (set via ldflags)

View Source
var Version = "dev"

Version is the CLI version, set at build time via ldflags

Functions

func FluxKustomizationInterval added in v0.9.0

func FluxKustomizationInterval(isPrimarySource bool) time.Duration

FluxKustomizationInterval returns the default reconciliation interval for a Kustomization. isPrimarySource is true when the Kustomization resolves, explicitly or by falling back to the blueprint's default source, to the blueprint's own repository rather than a named vendor source (see DefaultFluxPrimaryKustomizationInterval). Blueprint-level Interval overrides take precedence over either default.

func FluxSourceInterval added in v0.9.0

func FluxSourceInterval(isPrimary bool) time.Duration

FluxSourceInterval returns the default reconciliation interval for a flux Source (GitRepository / OCIRepository). isPrimary is true for the blueprint's own repository (the top-level "repository:" field); see DefaultFluxPrimaryRepositoryInterval.

func GetEffectiveBlueprintURL added in v0.7.0

func GetEffectiveBlueprintURL() string

GetEffectiveBlueprintURL returns the pinned blueprint URL if set at build time, otherwise returns the default blueprint URL. This allows for different behavior between development builds (using :latest) and release builds (using pinned versions).

Types

type GitopsMode added in v0.9.0

type GitopsMode string

GitopsMode is accepted by ToFluxKustomization and friends for call-site stability but no longer changes reconciliation cadence: the notifier re-fetches sources on every apply/up/bootstrap regardless of mode, so pull and push need the same backstop cadence. Unknown and empty values resolve to "pull" via ParseGitopsMode.

const (
	GitopsModePull GitopsMode = "pull"
	GitopsModePush GitopsMode = "push"
)

func ParseGitopsMode added in v0.9.0

func ParseGitopsMode(s string) GitopsMode

ParseGitopsMode resolves a config string to a GitopsMode, defaulting to "pull" for empty or unrecognised values. Keeps the config surface forgiving so typos fall back to safe behaviour rather than refusing to apply.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL