rancher
/
fleet-docs
mirror of https://github.com/rancher/fleet-docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
fleet-docs/docs/ref-crds.md

30 KiB
Raw Blame History

Custom Resources

Sub Resources

GitRepo

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec GitRepoSpec false
status GitRepoStatus false

Back to Custom Resources

GitRepoDisplay

Field Description Scheme Required
readyBundleDeployments string false
state string false
message string false
error bool false

Back to Custom Resources

GitRepoResource

Field Description Scheme Required
apiVersion string false
kind string false
type string false
id string false
namespace string false
name string false
incompleteState bool false
state string false
error bool false
transitioning bool false
message string false
perClusterState []ResourcePerClusterState false

Back to Custom Resources

GitRepoResourceCounts

Field Description Scheme Required
ready int true
desiredReady int true
waitApplied int true
modified int true
orphaned int true
missing int true
unknown int true
notReady int true

Back to Custom Resources

GitRepoRestriction

Field Description Scheme Required
metadata metav1.ObjectMeta false
defaultServiceAccount string false
allowedServiceAccounts []string false
allowedRepoPatterns []string false
defaultClientSecretName string false
allowedClientSecretNames []string false
allowedTargetNamespaces []string false

Back to Custom Resources

GitRepoSpec

Field Description Scheme Required
repo Repo is a URL to a git repo to clone and index string false
branch Branch The git branch to follow string false
revision Revision A specific commit or tag to operate on string false
targetNamespace Ensure that all resources are created in this namespace Any cluster scoped resource will be rejected if this is set Additionally this namespace will be created on demand string false
clientSecretName ClientSecretName is the client secret to be used to connect to the repo It is expected the secret be of type "kubernetes.io/basic-auth" or "kubernetes.io/ssh-auth". string false
helmSecretName HelmSecretName contains the auth secret for private helm repository string false
caBundle CABundle is a PEM encoded CA bundle which will be used to validate the repo's certificate. []byte false
insecureSkipTLSVerify InsecureSkipTLSverify will use insecure HTTPS to clone the repo. bool false
paths Paths is the directories relative to the git repo root that contain resources to be applied. Path globbing is support, for example ["charts/*"] will match all folders as a subdirectory of charts/ If empty, "/" is the default []string false
paused Paused this cause changes in Git to not be propagated down to the clusters but instead mark resources as OutOfSync bool false
serviceAccount ServiceAccount used in the downstream cluster for deployment string false
targets Targets is a list of target this repo will deploy to []GitTarget false
pollingInterval PollingInterval is how often to check git for new updates *metav1.Duration false
forceSyncGeneration Increment this number to force a redeployment of contents from Git int64 false
imageScanInterval ImageScanInterval is the interval of syncing scanned images and writing back to git repo *metav1.Duration false
imageScanCommit Commit specifies how to commit to the git repo when new image is scanned and write back to git repo CommitSpec false

Back to Custom Resources

GitRepoStatus

Field Description Scheme Required
observedGeneration int64 true
commit string false
readyClusters int true
desiredReadyClusters int true
gitJobStatus string false
summary BundleSummary false
display GitRepoDisplay false
conditions []genericcondition.GenericCondition false
resources []GitRepoResource false
resourceCounts GitRepoResourceCounts false
resourceErrors []string false
lastSyncedImageScanTime metav1.Time false

Back to Custom Resources

GitTarget

Field Description Scheme Required
name string false
clusterName string false
clusterSelector *metav1.LabelSelector false
clusterGroup string false
clusterGroupSelector *metav1.LabelSelector false

Back to Custom Resources

ResourcePerClusterState

Field Description Scheme Required
state string false
error bool false
transitioning bool false
message string false
patch *GenericMap false
clusterId string false

Back to Custom Resources

Bundle

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec BundleSpec true
status BundleStatus true

Back to Custom Resources

BundleDeployment

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec BundleDeploymentSpec false
status BundleDeploymentStatus false

Back to Custom Resources

BundleDeploymentDisplay

Field Description Scheme Required
deployed string false
monitored string false
state string false

Back to Custom Resources

BundleDeploymentOptions

Field Description Scheme Required
defaultNamespace string false
namespace string false
kustomize *KustomizeOptions false
helm *HelmOptions false
serviceAccount string false
forceSyncGeneration int64 false
yaml *YAMLOptions false
diff *DiffOptions false

Back to Custom Resources

BundleDeploymentSpec

Field Description Scheme Required
stagedOptions BundleDeploymentOptions false
stagedDeploymentID string false
options BundleDeploymentOptions false
deploymentID string false
dependsOn []BundleRef false

Back to Custom Resources

BundleDeploymentStatus

Field Description Scheme Required
conditions []genericcondition.GenericCondition false
appliedDeploymentID string false
release string false
ready bool false
nonModified bool false
nonReadyStatus []NonReadyStatus false
modifiedStatus []ModifiedStatus false
display BundleDeploymentDisplay false
syncGeneration *int64 false

Back to Custom Resources

BundleDisplay

Field Description Scheme Required
readyClusters string false
state string false

Back to Custom Resources

BundleNamespaceMapping

Field Description Scheme Required
metadata metav1.ObjectMeta false
bundleSelector *metav1.LabelSelector false
namespaceSelector *metav1.LabelSelector false

Back to Custom Resources

BundleRef

Field Description Scheme Required
name string false
selector *metav1.LabelSelector false

Back to Custom Resources

BundleResource

Field Description Scheme Required
name string false
content string false
encoding string false

Back to Custom Resources

BundleSpec

Field Description Scheme Required
BundleDeploymentOptions BundleDeploymentOptions false
paused bool false
rolloutStrategy *RolloutStrategy false
resources []BundleResource false
targets []BundleTarget false
targetRestrictions []BundleTargetRestriction false
dependsOn []BundleRef false

Back to Custom Resources

BundleStatus

Field Description Scheme Required
conditions []genericcondition.GenericCondition false
summary BundleSummary false
newlyCreated int false
unavailable int true
unavailablePartitions int true
maxUnavailable int true
maxUnavailablePartitions int true
maxNew int false
partitions []PartitionStatus false
display BundleDisplay false
resourceKey []ResourceKey false
observedGeneration int64 true

Back to Custom Resources

BundleSummary

Field Description Scheme Required
notReady int false
waitApplied int false
errApplied int false
outOfSync int false
modified int false
ready int true
pending int false
desiredReady int true
nonReadyResources []NonReadyResource false

Back to Custom Resources

BundleTarget

Field Description Scheme Required
BundleDeploymentOptions BundleDeploymentOptions false
name string false
clusterName string false
clusterSelector *metav1.LabelSelector false
clusterGroup string false
clusterGroupSelector *metav1.LabelSelector false

Back to Custom Resources

BundleTargetRestriction

Field Description Scheme Required
name string false
clusterName string false
clusterSelector *metav1.LabelSelector false
clusterGroup string false
clusterGroupSelector *metav1.LabelSelector false

Back to Custom Resources

ComparePatch

Field Description Scheme Required
kind string false
apiVersion string false
namespace string false
name string false
operations []Operation false
jsonPointers []string false

Back to Custom Resources

ConfigMapKeySelector

Field Description Scheme Required
namespace string false
key string false

Back to Custom Resources

Content

Field Description Scheme Required
metadata metav1.ObjectMeta false
content []byte false

Back to Custom Resources

DiffOptions

Field Description Scheme Required
comparePatches []ComparePatch false

Back to Custom Resources

HelmOptions

Field Description Scheme Required
chart string false
repo string false
releaseName string false
version string false
timeoutSeconds int false
values *GenericMap false
valuesFrom []ValuesFrom false
force bool false
takeOwnership bool false
maxHistory int false
valuesFiles []string false
atomic Atomic sets the --atomic flag when Helm is performing an upgrade bool false

Back to Custom Resources

KustomizeOptions

Field Description Scheme Required
dir string false

Back to Custom Resources

LocalObjectReference

Field Description Scheme Required
name string true

Back to Custom Resources

ModifiedStatus

Field Description Scheme Required
kind string false
apiVersion string false
namespace string false
name string false
missing bool false
delete bool false
patch string false

Back to Custom Resources

NonReadyResource

Field Description Scheme Required
name string false
bundleState BundleState false
message string false
modifiedStatus []ModifiedStatus false
nonReadyStatus []NonReadyStatus false

Back to Custom Resources

NonReadyStatus

Field Description Scheme Required
uid types.UID false
kind string false
apiVersion string false
namespace string false
name string false
summary summary.Summary false

Back to Custom Resources

Operation

Field Description Scheme Required
op string false
path string false
value string false

Back to Custom Resources

Partition

Field Description Scheme Required
name string false
maxUnavailable *intstr.IntOrString false
clusterName string false
clusterSelector *metav1.LabelSelector false
clusterGroup string false
clusterGroupSelector *metav1.LabelSelector false

Back to Custom Resources

PartitionStatus

Field Description Scheme Required
name string false
count int false
maxUnavailable int false
unavailable int false
summary BundleSummary false

Back to Custom Resources

ResourceKey

Field Description Scheme Required
kind string false
apiVersion string false
namespace string false
name string false

Back to Custom Resources

RolloutStrategy

Field Description Scheme Required
maxUnavailable *intstr.IntOrString false
maxUnavailablePartitions *intstr.IntOrString false
autoPartitionSize *intstr.IntOrString false
partitions []Partition false

Back to Custom Resources

SecretKeySelector

Field Description Scheme Required
namespace string false
key string false

Back to Custom Resources

ValuesFrom

Define helm values that can come from configmap, secret or external. Credit: 0cfea875b5/pkg/apis/helm.fluxcd.io/v1/types_helmrelease.go (L439)

Field Description Scheme Required
configMapKeyRef The reference to a config map with release values. *ConfigMapKeySelector false
secretKeyRef The reference to a secret with release values. *SecretKeySelector false

Back to Custom Resources

YAMLOptions

Field Description Scheme Required
overlays []string false

Back to Custom Resources

AlphabeticalPolicy

AlphabeticalPolicy specifices a alphabetical ordering policy.

Field Description Scheme Required
order Order specifies the sorting order of the tags. Given the letters of the alphabet as tags, ascending order would select Z, and descending order would select A. string false

Back to Custom Resources

CommitSpec

CommitSpec specifies how to commit changes to the git repository

Field Description Scheme Required
authorName AuthorName gives the name to provide when making a commit string true
authorEmail AuthorEmail gives the email to provide when making a commit string true
messageTemplate MessageTemplate provides a template for the commit message, into which will be interpolated the details of the change made. string false

Back to Custom Resources

ImagePolicyChoice

ImagePolicyChoice is a union of all the types of policy that can be supplied.

Field Description Scheme Required
semver SemVer gives a semantic version range to check against the tags available. *SemVerPolicy false
alphabetical Alphabetical set of rules to use for alphabetical ordering of the tags. *AlphabeticalPolicy false

Back to Custom Resources

ImageScan

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec ImageScanSpec false
status ImageScanStatus false

Back to Custom Resources

ImageScanSpec

API is taken from https://github.com/fluxcd/image-reflector-controller

Field Description Scheme Required
tagName TagName is the tag ref that needs to be put in manifest to replace fields string false
gitrepoName GitRepo reference name string false
image Image is the name of the image repository string false
interval Interval is the length of time to wait between scans of the image repository. metav1.Duration false
secretRef SecretRef can be given the name of a secret containing credentials to use for the image registry. The secret should be created with kubectl create secret docker-registry, or the equivalent. *corev1.LocalObjectReference false
suspend This flag tells the controller to suspend subsequent image scans. It does not apply to already started scans. Defaults to false. bool false
policy Policy gives the particulars of the policy to be followed in selecting the most recent image ImagePolicyChoice true

Back to Custom Resources

ImageScanStatus

Field Description Scheme Required
conditions []genericcondition.GenericCondition false
lastScanTime LastScanTime is the last time image was scanned metav1.Time false
latestImage LatestImage gives the first in the list of images scanned by the image repository, when filtered and ordered according to the policy. string false
latestTag Latest tag is the latest tag filtered by the policy string false
latestDigest LatestDigest is the digest of latest tag string false
observedGeneration int64 false
canonicalImageName CannonicalName is the name of the image repository with all the implied bits made explicit; e.g., docker.io/library/alpine rather than alpine. string false

Back to Custom Resources

SemVerPolicy

SemVerPolicy specifices a semantic version policy.

Field Description Scheme Required
range Range gives a semver range for the image tag; the highest version within the range that's a tag yields the latest image. string true

Back to Custom Resources

AgentStatus

Field Description Scheme Required
lastSeen metav1.Time true
namespace string true
nonReadyNodes int true
readyNodes int true
nonReadyNodeNames At most 3 nodes []string true
readyNodeNames At most 3 nodes []string true

Back to Custom Resources

Cluster

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec ClusterSpec false
status ClusterStatus false

Back to Custom Resources

ClusterDisplay

Field Description Scheme Required
readyBundles string false
readyNodes string false
sampleNode string false
state string false

Back to Custom Resources

ClusterGroup

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec ClusterGroupSpec true
status ClusterGroupStatus true

Back to Custom Resources

ClusterGroupDisplay

Field Description Scheme Required
readyClusters string false
readyBundles string false
state string false

Back to Custom Resources

ClusterGroupSpec

Field Description Scheme Required
selector *metav1.LabelSelector false

Back to Custom Resources

ClusterGroupStatus

Field Description Scheme Required
clusterCount int true
nonReadyClusterCount int true
nonReadyClusters []string false
conditions []genericcondition.GenericCondition false
summary BundleSummary false
display ClusterGroupDisplay false
resourceCounts GitRepoResourceCounts false

Back to Custom Resources

ClusterRegistration

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec ClusterRegistrationSpec false
status ClusterRegistrationStatus false

Back to Custom Resources

ClusterRegistrationSpec

Field Description Scheme Required
clientID string false
clientRandom string false
clusterLabels map[string]string false

Back to Custom Resources

ClusterRegistrationStatus

Field Description Scheme Required
clusterName string false
granted bool false

Back to Custom Resources

ClusterRegistrationToken

Field Description Scheme Required
metadata metav1.ObjectMeta false
spec ClusterRegistrationTokenSpec false
status ClusterRegistrationTokenStatus false

Back to Custom Resources

ClusterRegistrationTokenSpec

Field Description Scheme Required
ttl *metav1.Duration false

Back to Custom Resources

ClusterRegistrationTokenStatus

Field Description Scheme Required
expires *metav1.Time false
secretName string false

Back to Custom Resources

ClusterSpec

Field Description Scheme Required
paused bool false
clientID string false
kubeConfigSecret string false
redeployAgentGeneration int64 false
agentEnvVars []v1.EnvVar false
agentNamespace AgentNamespace defaults to the system namespace, e.g. cattle-fleet-system string false
privateRepoURL string false

Back to Custom Resources

ClusterStatus

Field Description Scheme Required
conditions []genericcondition.GenericCondition false
namespace Namespace is the cluster namespace, it contains the clusters service account as well as any bundledeployments. Example: "cluster-fleet-local-cluster-294db1acfa77-d9ccf852678f" string false
summary BundleSummary false
resourceCounts GitRepoResourceCounts false
readyGitRepos int true
desiredReadyGitRepos int true
agentEnvVarsHash string false
agentPrivateRepoURL string false
agentDeployedGeneration *int64 false
agentMigrated bool false
agentNamespaceMigrated bool false
cattleNamespaceMigrated bool false
display ClusterDisplay false
agent AgentStatus false

Back to Custom Resources