fleet

command module
v0.4.1-SURE-3613.1 Latest Latest
Warning

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

Go to latest
Published: Jan 13, 2023 License: Apache-2.0 Imports: 8 Imported by: 0

README

Introduction

Unit E2E Examples E2E Multi-Cluster Examples golangci-lint

Fleet is GitOps at scale. Fleet is designed to manage up to a million clusters. It's also lightweight enough that it works great for a single cluster too, but it really shines when you get to a large scale. By large scale we mean either a lot of clusters, a lot of deployments, or a lot of teams in a single organization.

Fleet can manage deployments from git of raw Kubernetes YAML, Helm charts, or Kustomize or any combination of the three. Regardless of the source all resources are dynamically turned into Helm charts and Helm is used as the engine to deploy everything in the cluster. This gives a high degree of control, consistency, and auditability. Fleet focuses not only on the ability to scale, but to give one a high degree of control and visibility to exactly what is installed on the cluster.

Quick Start

Who needs documentation, let's just run this thing!

Install

Get helm if you don't have it. Helm 3 is just a CLI and won't do bad insecure things to your cluster.

brew install helm

Install the Fleet Helm charts (there's two because we separate out CRDs for ultimate flexibility.)

VERSION=0.3.9
helm -n cattle-fleet-system install --create-namespace --wait \
    fleet-crd https://github.com/rancher/fleet/releases/download/v${VERSION}/fleet-crd-${VERSION}.tgz
helm -n cattle-fleet-system install --create-namespace --wait \
    fleet https://github.com/rancher/fleet/releases/download/v${VERSION}/fleet-${VERSION}.tgz

Add a Git Repo to watch

Change spec.repo to your git repo of choice. Kubernetes manifest files that should be deployed should be in /manifests in your repo.

cat > example.yaml << "EOF"
apiVersion: fleet.cattle.io/v1alpha1
kind: GitRepo
metadata:
  name: sample
  # This namespace is special and auto-wired to deploy to the local cluster
  namespace: fleet-local
spec:
  # Everything from this repo will be ran in this cluster. You trust me right?
  repo: "https://github.com/rancher/fleet-examples"
  paths:
  - simple
EOF

kubectl apply -f example.yaml

Get Status

Get status of what fleet is doing

kubectl -n fleet-local get fleet

You should see something like this get created in your cluster.

kubectl get deploy frontend
NAME       READY   UP-TO-DATE   AVAILABLE   AGE
frontend   3/3     3            3           116m

Enjoy and read the docs.


For developer and maintainer documentation, see DEVELOPING.md.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
e2e
testenv
Package testenv contains common helpers for tests
Package testenv contains common helpers for tests
testenv/kubectl
Package kubectl is a wrapper around the kubectl CLI
Package kubectl is a wrapper around the kubectl CLI
testenv/infra Module
modules
agent/pkg/deployer/internal/diff
copied from argoproj/gitops-engine/pkg/diff/diff.go
copied from argoproj/gitops-engine/pkg/diff/diff.go
agent/pkg/deployer/internal/diffnormalize
extracted from argoproj/argo-cd/util/argo/diff/normalize.go
extracted from argoproj/argo-cd/util/argo/diff/normalize.go
agent/pkg/deployer/internal/glob
copied from argoproj/argo-cd/util/glob/glob.go
copied from argoproj/argo-cd/util/glob/glob.go
agent/pkg/deployer/internal/json
copied from argoproj/gitops-engine/pkg/utils/json/json.go
copied from argoproj/gitops-engine/pkg/utils/json/json.go
agent/pkg/deployer/internal/normalizers
extracted from argoproj/argo-cd/util/argo/normalizers/diff_normalizer.go
extracted from argoproj/argo-cd/util/argo/normalizers/diff_normalizer.go
agent/pkg/deployer/internal/resource
extracted from argoproj/argo-cd/pkg/apis/application/v1alpha1/types.go
extracted from argoproj/argo-cd/pkg/apis/application/v1alpha1/types.go
agent/pkg/deployer/internal/scheme
copied from https://github.com/argoproj/gitops-engine/blob/master/pkg/utils/kube/scheme/scheme.go
copied from https://github.com/argoproj/gitops-engine/blob/master/pkg/utils/kube/scheme/scheme.go
pkg
crd
apis Module

Jump to

Keyboard shortcuts

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