Quick Start

Who needs documentation, lets 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.

  1. brew install helm

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

  1. helm -n cattle-fleet-system install --create-namespace --wait \
  2.     fleet-crd https://github.com/rancher/fleet/releases/download/v0.4.1/fleet-crd-v0.4.1.tgz
  3. helm -n cattle-fleet-system install --create-namespace --wait \
  4.     fleet https://github.com/rancher/fleet/releases/download/v0.4.1/fleet-v0.4.1.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.

  1. cat > example.yaml << "EOF"
  2. apiVersion: fleet.cattle.io/v1alpha1
  3. kind: GitRepo
  4. metadata:
  5.   name: sample
  6.   # This namespace is special and auto-wired to deploy to the local cluster
  7.   namespace: fleet-local
  8. spec:
  9.   # Everything from this repo will be run in this cluster. You trust me right?
  10.   repo: "https://github.com/rancher/fleet-examples"
  11.   paths:
  12.   - simple
  13. EOF
  15. kubectl apply -f example.yaml

Get Status

Get status of what fleet is doing

  1. kubectl -n fleet-local get fleet

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

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

Enjoy and read the docs.