Skip to main content

GitRepository

Sources from a Git repository.

  • Group: source.toolkit.fluxcd.io
  • Version: v1

Fields

FieldLabelTypeRequiredDescription
metadata.nameNamestringYesUnique name for this GitRepository resource.
metadata.namespaceNamespacestringYesNamespace where the resource will be created.
spec.urlRepository URLstringYesGit repository URL (https://, ssh://, or git@).
spec.providerGit ProviderselectNoGit provider optimization (generic, github, azure).
spec.ref.branchBranchstringNoBranch name to track (default: main).
spec.intervalSync IntervaldurationYesHow often to check for repository changes (e.g., 1m).
spec.secretRef.nameSecret NamestringNoName of secret containing authentication credentials.
spec.suspendSuspendbooleanNoSuspend reconciliation of this repository.
spec.timeoutTimeoutdurationNoTimeout for Git operations.

Example

apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
name: example
namespace: flux-system
spec:
interval: 1m
url: https://github.com/org/repo
ref:
branch: main