common

Documentation

Index

• Constants
• type HookDeletePolicy
  • func NewHookDeletePolicy(p string) (HookDeletePolicy, bool)
• type HookType
  • func NewHookType(t string) (HookType, bool)
• type OperationPhase
  • func (os OperationPhase) Completed() bool
  • func (os OperationPhase) Failed() bool
  • func (os OperationPhase) Running() bool
  • func (os OperationPhase) Successful() bool
• type PermissionValidator
• type ResourceSyncResult
• type ResultCode
• type SyncPhase
• type SyncWaveHook

Constants

const (
	// AnnotationSyncOptions is a comma-separated list of options for syncing
	AnnotationSyncOptions = "argocd.argoproj.io/sync-options"
	// AnnotationSyncWave indicates which wave of the sync the resource or hook should be in
	AnnotationSyncWave = "argocd.argoproj.io/sync-wave"
	// AnnotationKeyHook contains the hook type of a resource
	AnnotationKeyHook = "argocd.argoproj.io/hook"
	// AnnotationKeyHookDeletePolicy is the policy of deleting a hook
	AnnotationKeyHookDeletePolicy = "argocd.argoproj.io/hook-delete-policy"
	AnnotationDeletionApproved    = "argocd.argoproj.io/deletion-approved"

	// Sync option that disables dry run in resource is missing in the cluster
	SyncOptionSkipDryRunOnMissingResource = "SkipDryRunOnMissingResource=true"
	// Sync option that disables resource pruning
	SyncOptionDisablePrune = "Prune=false"
	// Sync option that disables resource validation
	SyncOptionsDisableValidation = "Validate=false"
	// Sync option that enables pruneLast
	SyncOptionPruneLast = "PruneLast=true"
	// Sync option that enables use of replace or create command instead of apply
	SyncOptionReplace = "Replace=true"
	// Sync option that enables use of --force flag, delete and re-create
	SyncOptionForce = "Force=true"
	// Sync option that enables use of --server-side flag instead of client-side
	SyncOptionServerSideApply = "ServerSideApply=true"
	// Sync option that disables use of --server-side flag instead of client-side
	SyncOptionDisableServerSideApply = "ServerSideApply=false"
	// Sync option that disables resource deletion
	SyncOptionDisableDeletion = "Delete=false"
	// Sync option that sync only out of sync resources
	SyncOptionApplyOutOfSyncOnly = "ApplyOutOfSyncOnly=true"
	// Sync option that requires confirmation before deleting the resource
	SyncOptionDeleteRequireConfirm = "Delete=confirm"
	// Sync option that requires confirmation before deleting the resource
	SyncOptionPruneRequireConfirm = "Prune=confirm"
)

const (
	SyncPhasePreSync  = "PreSync"
	SyncPhaseSync     = "Sync"
	SyncPhasePostSync = "PostSync"
	SyncPhaseSyncFail = "SyncFail"
)

Types

type HookDeletePolicy

type HookDeletePolicy string

const (
	HookDeletePolicyHookSucceeded      HookDeletePolicy = "HookSucceeded"
	HookDeletePolicyHookFailed         HookDeletePolicy = "HookFailed"
	HookDeletePolicyBeforeHookCreation HookDeletePolicy = "BeforeHookCreation"
)

func NewHookDeletePolicy

func NewHookDeletePolicy(p string) (HookDeletePolicy, bool)

type HookType

type HookType string

const (
	HookTypePreSync  HookType = "PreSync"
	HookTypeSync     HookType = "Sync"
	HookTypePostSync HookType = "PostSync"
	HookTypeSkip     HookType = "Skip"
	HookTypeSyncFail HookType = "SyncFail"
)

func NewHookType

func NewHookType(t string) (HookType, bool)

type OperationPhase

type OperationPhase string

const (
	OperationRunning     OperationPhase = "Running"
	OperationTerminating OperationPhase = "Terminating"
	OperationFailed      OperationPhase = "Failed"
	OperationError       OperationPhase = "Error"
	OperationSucceeded   OperationPhase = "Succeeded"
)

func (OperationPhase) Completed

func (os OperationPhase) Completed() bool

func (OperationPhase) Failed

func (os OperationPhase) Failed() bool

func (OperationPhase) Running

func (os OperationPhase) Running() bool

func (OperationPhase) Successful

func (os OperationPhase) Successful() bool

type PermissionValidator

type PermissionValidator func(un *unstructured.Unstructured, res *metav1.APIResource) error

type ResourceSyncResult

type ResourceSyncResult struct {
	// holds associated resource key
	ResourceKey kube.ResourceKey
	// holds resource version
	Version string
	// holds the execution order
	Order int
	// result code
	Status ResultCode
	// message for the last sync OR operation
	Message string
	// the type of the hook, empty for non-hook resources
	HookType HookType
	// the state of any operation associated with this resource OR hook
	// note: can contain values for non-hook resources
	HookPhase OperationPhase
	// indicates the particular phase of the sync that this is for
	SyncPhase SyncPhase
}

type ResultCode

type ResultCode string

const (
	ResultCodeSynced       ResultCode = "Synced"
	ResultCodeSyncFailed   ResultCode = "SyncFailed"
	ResultCodePruned       ResultCode = "Pruned"
	ResultCodePruneSkipped ResultCode = "PruneSkipped"
)

type SyncPhase

type SyncPhase string

type SyncWaveHook

type SyncWaveHook func(phase SyncPhase, wave int, final bool) error

SyncWaveHook is a callback function which will be invoked after each sync wave is successfully applied during a sync operation. The callback indicates which phase and wave it had just executed, and whether or not that wave was the final one.