Merge pull request #1349 from fluxcd/fix-throttling

Avoid throttling when some Flux CRDs are not registered

.github/workflows/docs.yaml

@@ -1,76 +0,0 @@
-name: Publish docs via GitHub Pages
-
-on:
-  push:
-    branches: [ 'docs*', main ]
-
-jobs:
-  build:
-    name: Deploy docs
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout master
-        uses: actions/checkout@v1
-      - name: Copy assets
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          controller_version() {
-            sed -n "s/.*$1\/releases\/download\/\(.*\)\/.*/\1/p;n" manifests/bases/$1/kustomization.yaml
-          }
-
-          {
-            # source-controller CRDs
-            SOURCE_VER=$(controller_version source-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/source-controller/$SOURCE_VER/docs/api/source.md" > docs/components/source/api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/source-controller/$SOURCE_VER/docs/spec/v1beta1/gitrepositories.md" > docs/components/source/gitrepositories.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/source-controller/$SOURCE_VER/docs/spec/v1beta1/helmrepositories.md" > docs/components/source/helmrepositories.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/source-controller/$SOURCE_VER/docs/spec/v1beta1/helmcharts.md" > docs/components/source/helmcharts.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/source-controller/$SOURCE_VER/docs/spec/v1beta1/buckets.md" > docs/components/source/buckets.md
-          }
-
-          {
-            # kustomize-controller CRDs
-            KUSTOMIZE_VER=$(controller_version kustomize-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/kustomize-controller/$KUSTOMIZE_VER/docs/api/kustomize.md" > docs/components/kustomize/api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/kustomize-controller/$KUSTOMIZE_VER/docs/spec/v1beta1/kustomization.md" > docs/components/kustomize/kustomization.md
-          }
-
-          {
-            # helm-controller CRDs
-            HELM_VER=$(controller_version helm-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/helm-controller/$HELM_VER/docs/api/helmrelease.md" > docs/components/helm/api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/helm-controller/$HELM_VER/docs/spec/v2beta1/helmreleases.md" > docs/components/helm/helmreleases.md
-          }
-
-          {
-            # notification-controller CRDs
-            NOTIFICATION_VER=$(controller_version notification-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/notification-controller/$NOTIFICATION_VER/docs/api/notification.md" > docs/components/notification/api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/notification-controller/$NOTIFICATION_VER/docs/spec/v1beta1/event.md" > docs/components/notification/event.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/notification-controller/$NOTIFICATION_VER/docs/spec/v1beta1/alert.md" > docs/components/notification/alert.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/notification-controller/$NOTIFICATION_VER/docs/spec/v1beta1/provider.md" > docs/components/notification/provider.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/notification-controller/$NOTIFICATION_VER/docs/spec/v1beta1/receiver.md" > docs/components/notification/receiver.md
-          }
-
-          {
-            # image-*-controller CRDs; these use the same API group
-            IMG_REFL_VER=$(controller_version image-reflector-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/image-reflector-controller/$IMG_REFL_VER/docs/api/image-reflector.md" > docs/components/image/reflector-api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/image-reflector-controller/$IMG_REFL_VER/docs/spec/v1alpha2/imagerepositories.md" > docs/components/image/imagerepositories.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/image-reflector-controller/$IMG_REFL_VER/docs/spec/v1alpha2/imagepolicies.md" > docs/components/image/imagepolicies.md
-
-            IMG_AUTO_VER=$(controller_version image-automation-controller)
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/image-automation-controller/$IMG_AUTO_VER/docs/api/image-automation.md" > docs/components/image/automation-api.md
-            curl -# -Lf "https://raw.githubusercontent.com/fluxcd/image-automation-controller/$IMG_AUTO_VER/docs/spec/v1alpha2/imageupdateautomations.md" > docs/components/image/imageupdateautomations.md
-          }
-
-          {
-            # install script
-            cp install/flux.sh docs/install.sh
-          }
-      - name: Deploy docs
-        uses: mhausenblas/mkdocs-deploy-gh-pages@master
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          CUSTOM_DOMAIN: toolkit.fluxcd.io

.gitignore

@@ -19,3 +19,6 @@ dist/
 bin/
 output/
 cmd/flux/manifests/
+
+# Docs
+site/

.goreleaser.yml

@@ -47,7 +47,7 @@ brews:
       name: homebrew-tap
       token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
     folder: Formula
-    homepage: "https://toolkit.fluxcd.io/"
+    homepage: "https://fluxcd.io/"
     description: "Flux CLI"
     dependencies:
       - name: kubectl

CONTRIBUTING.md

@@ -59,7 +59,7 @@ This project is composed of:
 ### Understanding the code
 
 To get started with developing controllers, you might want to review
-[our guide](https://toolkit.fluxcd.io/dev-guides/source-watcher/) which
+[our guide](https://fluxcd.io/docs/gitops-toolkit/source-watcher/) which
 walks you through writing a short and concise controller that watches out
 for source changes.
 

Makefile

@@ -14,7 +14,7 @@ fmt:
 vet:
 	go vet ./...
 
-test: $(EMBEDDED_MANIFESTS_TARGET) tidy fmt vet docs
+test: $(EMBEDDED_MANIFESTS_TARGET) tidy fmt vet
 	go test ./... -coverprofile cover.out
 
 $(EMBEDDED_MANIFESTS_TARGET): $(call rwildcard,manifests/,*.yaml *.json)
@@ -26,10 +26,5 @@ build: $(EMBEDDED_MANIFESTS_TARGET)
 install:
 	go install cmd/flux
 
-.PHONY: docs
-docs:
-	rm -rf docs/cmd/*
-	mkdir -p ./docs/cmd && go run ./cmd/flux/ docgen
-
 install-dev:
 	CGO_ENABLED=0 go build -o /usr/local/bin ./cmd/flux

README.md

@@ -31,7 +31,7 @@ brew install fluxcd/tap/flux
 With Bash:
 
 ```sh
-curl -s https://toolkit.fluxcd.io/install.sh | sudo bash
+curl -s https://fluxcd.io/install.sh | sudo bash
 
 # enable completions in ~/.bash_profile
 . <(flux completion bash)
@@ -63,13 +63,13 @@ flux check --pre
 ## Get started
 
 To get started with Flux, start [browsing the
-documentation](https://toolkit.fluxcd.io) or get started with one of
+documentation](https://fluxcd.io/docs/) or get started with one of
 the following guides:
 
-- [Get started with Flux](https://toolkit.fluxcd.io/get-started/)
-- [Manage Helm Releases](https://toolkit.fluxcd.io/guides/helmreleases/)
-- [Automate image updates to Git](https://toolkit.fluxcd.io/guides/image-update/)  
-- [Manage Kubernetes secrets with Mozilla SOPS](https://toolkit.fluxcd.io/guides/mozilla-sops/)  
+- [Get started with Flux](https://fluxcd.io/docs/get-started/)
+- [Manage Helm Releases](https://fluxcd.io/docs/guides/helmreleases/)
+- [Automate image updates to Git](https://fluxcd.io/docs/guides/image-update/)  
+- [Manage Kubernetes secrets with Mozilla SOPS](https://fluxcd.io/docs/guides/mozilla-sops/)  
 
 If you need help, please refer to our **[Support page](https://fluxcd.io/support/)**.
 
@@ -84,27 +84,27 @@ automation tooling.
 
 You can use the toolkit to extend Flux, or to build your own systems
 for continuous delivery -- see [the developer
-guides](https://toolkit.fluxcd.io/dev-guides/source-watcher/).
+guides](https://fluxcd.io/docs/gitops-toolkit/source-watcher/).
 
 ### Components
 
-- [Source Controller](https://toolkit.fluxcd.io/components/source/controller/)
-    - [GitRepository CRD](https://toolkit.fluxcd.io/components/source/gitrepositories/)
-    - [HelmRepository CRD](https://toolkit.fluxcd.io/components/source/helmrepositories/)
-    - [HelmChart CRD](https://toolkit.fluxcd.io/components/source/helmcharts/)
-    - [Bucket CRD](https://toolkit.fluxcd.io/components/source/buckets/)
-- [Kustomize Controller](https://toolkit.fluxcd.io/components/kustomize/controller/)
-    - [Kustomization CRD](https://toolkit.fluxcd.io/components/kustomize/kustomization/)
-- [Helm Controller](https://toolkit.fluxcd.io/components/helm/controller/)
-    - [HelmRelease CRD](https://toolkit.fluxcd.io/components/helm/helmreleases/)
-- [Notification Controller](https://toolkit.fluxcd.io/components/notification/controller/)
-    - [Provider CRD](https://toolkit.fluxcd.io/components/notification/provider/)
-    - [Alert CRD](https://toolkit.fluxcd.io/components/notification/alert/)
-    - [Receiver CRD](https://toolkit.fluxcd.io/components/notification/receiver/)
-- [Image Automation Controllers](https://toolkit.fluxcd.io/components/image/controller/)
-  - [ImageRepository CRD](https://toolkit.fluxcd.io/components/image/imagerepositories/)
-  - [ImagePolicy CRD](https://toolkit.fluxcd.io/components/image/imagepolicies/)
-  - [ImageUpdateAutomation CRD](https://toolkit.fluxcd.io/components/image/imageupdateautomations/)
+- [Source Controller](https://fluxcd.io/docs/components/source/)
+    - [GitRepository CRD](https://fluxcd.io/docs/components/source/gitrepositories/)
+    - [HelmRepository CRD](https://fluxcd.io/docs/components/source/helmrepositories/)
+    - [HelmChart CRD](https://fluxcd.io/docs/components/source/helmcharts/)
+    - [Bucket CRD](https://fluxcd.io/docs/components/source/buckets/)
+- [Kustomize Controller](https://fluxcd.io/docs/components/kustomize/)
+    - [Kustomization CRD](https://fluxcd.io/docs/components/kustomize/kustomization/)
+- [Helm Controller](https://fluxcd.io/docs/components/helm/)
+    - [HelmRelease CRD](https://fluxcd.io/docs/components/helm/helmreleases/)
+- [Notification Controller](https://fluxcd.io/docs/components/notification/)
+    - [Provider CRD](https://fluxcd.io/docs/components/notification/provider/)
+    - [Alert CRD](https://fluxcd.io/docs/components/notification/alert/)
+    - [Receiver CRD](https://fluxcd.io/docs/components/notification/receiver/)
+- [Image Automation Controllers](https://fluxcd.io/docs/components/image/)
+  - [ImageRepository CRD](https://fluxcd.io/docs/components/image/imagerepositories/)
+  - [ImagePolicy CRD](https://fluxcd.io/docs/components/image/imagepolicies/)
+  - [ImageUpdateAutomation CRD](https://fluxcd.io/docs/components/image/imageupdateautomations/)
   
 ## Community
 
@@ -112,7 +112,7 @@ Need help or want to contribute? Please see the links below. The Flux project is
 new contributors and there are a multitude of ways to get involved.
 
 - Getting Started?
-    - Look at our [Get Started guide](https://toolkit.fluxcd.io/get-started/) and give us feedback
+    - Look at our [Get Started guide](https://fluxcd.io/docs/get-started/) and give us feedback
 - Need help?
     - First: Ask questions on our [GH Discussions page](https://github.com/fluxcd/flux2/discussions)
     - Second: Talk to us in the #flux channel on [CNCF Slack](https://slack.cncf.io/)

cmd/flux/bootstrap_git.go

@@ -173,7 +173,6 @@ func bootstrapGitCmdRun(cmd *cobra.Command, args []string) error {
 		// Configure repository URL to match auth config for sync.
 		repositoryURL.User = url.User(gitArgs.username)
 		repositoryURL.Scheme = "ssh"
-		repositoryURL.Host = repositoryURL.Hostname()
 		if bootstrapArgs.sshHostname != "" {
 			repositoryURL.Host = bootstrapArgs.sshHostname
 		}

cmd/flux/bootstrap_github.go

@@ -94,7 +94,7 @@ var githubArgs githubFlags
 func init() {
 	bootstrapGitHubCmd.Flags().StringVar(&githubArgs.owner, "owner", "", "GitHub user or organization name")
 	bootstrapGitHubCmd.Flags().StringVar(&githubArgs.repository, "repository", "", "GitHub repository name")
-	bootstrapGitHubCmd.Flags().StringArrayVar(&githubArgs.teams, "team", []string{}, "GitHub team to be given maintainer access")
+	bootstrapGitHubCmd.Flags().StringSliceVar(&githubArgs.teams, "team", []string{}, "GitHub team to be given maintainer access (also accepts comma-separated values)")
 	bootstrapGitHubCmd.Flags().BoolVar(&githubArgs.personal, "personal", false, "if true, the owner is assumed to be a GitHub user; otherwise an org")
 	bootstrapGitHubCmd.Flags().BoolVar(&githubArgs.private, "private", true, "if true, the repository is setup or configured as private")
 	bootstrapGitHubCmd.Flags().DurationVar(&githubArgs.interval, "interval", time.Minute, "sync interval")

cmd/flux/bootstrap_gitlab.go

@@ -94,7 +94,7 @@ var gitlabArgs gitlabFlags
 func init() {
 	bootstrapGitLabCmd.Flags().StringVar(&gitlabArgs.owner, "owner", "", "GitLab user or group name")
 	bootstrapGitLabCmd.Flags().StringVar(&gitlabArgs.repository, "repository", "", "GitLab repository name")
-	bootstrapGitLabCmd.Flags().StringArrayVar(&gitlabArgs.teams, "team", []string{}, "GitLab teams to be given maintainer access")
+	bootstrapGitLabCmd.Flags().StringSliceVar(&gitlabArgs.teams, "team", []string{}, "GitLab teams to be given maintainer access (also accepts comma-separated values)")
 	bootstrapGitLabCmd.Flags().BoolVar(&gitlabArgs.personal, "personal", false, "if true, the owner is assumed to be a GitLab user; otherwise a group")
 	bootstrapGitLabCmd.Flags().BoolVar(&gitlabArgs.private, "private", true, "if true, the repository is setup or configured as private")
 	bootstrapGitLabCmd.Flags().DurationVar(&gitlabArgs.interval, "interval", time.Minute, "sync interval")

cmd/flux/create_alert.go

@@ -58,7 +58,7 @@ var alertArgs alertFlags
 func init() {
 	createAlertCmd.Flags().StringVar(&alertArgs.providerRef, "provider-ref", "", "reference to provider")
 	createAlertCmd.Flags().StringVar(&alertArgs.eventSeverity, "event-severity", "", "severity of events to send alerts for")
-	createAlertCmd.Flags().StringArrayVar(&alertArgs.eventSources, "event-source", []string{}, "sources that should generate alerts (<kind>/<name>)")
+	createAlertCmd.Flags().StringSliceVar(&alertArgs.eventSources, "event-source", []string{}, "sources that should generate alerts (<kind>/<name>), also accepts comma-separated values")
 	createCmd.AddCommand(createAlertCmd)
 }
 

cmd/flux/create_helmrelease.go

@@ -126,10 +126,10 @@ func init() {
 	createHelmReleaseCmd.Flags().Var(&helmReleaseArgs.source, "source", helmReleaseArgs.source.Description())
 	createHelmReleaseCmd.Flags().StringVar(&helmReleaseArgs.chart, "chart", "", "Helm chart name or path")
 	createHelmReleaseCmd.Flags().StringVar(&helmReleaseArgs.chartVersion, "chart-version", "", "Helm chart version, accepts a semver range (ignored for charts from GitRepository sources)")
-	createHelmReleaseCmd.Flags().StringArrayVar(&helmReleaseArgs.dependsOn, "depends-on", nil, "HelmReleases that must be ready before this release can be installed, supported formats '<name>' and '<namespace>/<name>'")
+	createHelmReleaseCmd.Flags().StringSliceVar(&helmReleaseArgs.dependsOn, "depends-on", nil, "HelmReleases that must be ready before this release can be installed, supported formats '<name>' and '<namespace>/<name>'")
 	createHelmReleaseCmd.Flags().StringVar(&helmReleaseArgs.targetNamespace, "target-namespace", "", "namespace to install this release, defaults to the HelmRelease namespace")
 	createHelmReleaseCmd.Flags().StringVar(&helmReleaseArgs.saName, "service-account", "", "the name of the service account to impersonate when reconciling this HelmRelease")
-	createHelmReleaseCmd.Flags().StringArrayVar(&helmReleaseArgs.valuesFiles, "values", nil, "local path to values.yaml files")
+	createHelmReleaseCmd.Flags().StringSliceVar(&helmReleaseArgs.valuesFiles, "values", nil, "local path to values.yaml files, also accepts comma-separated values")
 	createHelmReleaseCmd.Flags().Var(&helmReleaseArgs.valuesFrom, "values-from", helmReleaseArgs.valuesFrom.Description())
 	createHelmReleaseCmd.Flags().Var(&helmReleaseArgs.crds, "crds", helmReleaseArgs.crds.Description())
 	createCmd.AddCommand(createHelmReleaseCmd)

cmd/flux/create_kustomization.go

@@ -100,10 +100,10 @@ func init() {
 	createKsCmd.Flags().Var(&kustomizationArgs.source, "source", kustomizationArgs.source.Description())
 	createKsCmd.Flags().Var(&kustomizationArgs.path, "path", "path to the directory containing a kustomization.yaml file")
 	createKsCmd.Flags().BoolVar(&kustomizationArgs.prune, "prune", false, "enable garbage collection")
-	createKsCmd.Flags().StringArrayVar(&kustomizationArgs.healthCheck, "health-check", nil, "workload to be included in the health assessment, in the format '<kind>/<name>.<namespace>'")
+	createKsCmd.Flags().StringSliceVar(&kustomizationArgs.healthCheck, "health-check", nil, "workload to be included in the health assessment, in the format '<kind>/<name>.<namespace>'")
 	createKsCmd.Flags().DurationVar(&kustomizationArgs.healthTimeout, "health-check-timeout", 2*time.Minute, "timeout of health checking operations")
 	createKsCmd.Flags().StringVar(&kustomizationArgs.validation, "validation", "", "validate the manifests before applying them on the cluster, can be 'client' or 'server'")
-	createKsCmd.Flags().StringArrayVar(&kustomizationArgs.dependsOn, "depends-on", nil, "Kustomization that must be ready before this Kustomization can be applied, supported formats '<name>' and '<namespace>/<name>'")
+	createKsCmd.Flags().StringSliceVar(&kustomizationArgs.dependsOn, "depends-on", nil, "Kustomization that must be ready before this Kustomization can be applied, supported formats '<name>' and '<namespace>/<name>', also accepts comma-separated values")
 	createKsCmd.Flags().StringVar(&kustomizationArgs.saName, "service-account", "", "the name of the service account to impersonate when reconciling this Kustomization")
 	createKsCmd.Flags().Var(&kustomizationArgs.decryptionProvider, "decryption-provider", kustomizationArgs.decryptionProvider.Description())
 	createKsCmd.Flags().StringVar(&kustomizationArgs.decryptionSecret, "decryption-secret", "", "set the Kubernetes secret name that contains the OpenPGP private keys used for sops decryption")

cmd/flux/create_receiver.go

@@ -61,8 +61,8 @@ var receiverArgs receiverFlags
 func init() {
 	createReceiverCmd.Flags().StringVar(&receiverArgs.receiverType, "type", "", "")
 	createReceiverCmd.Flags().StringVar(&receiverArgs.secretRef, "secret-ref", "", "")
-	createReceiverCmd.Flags().StringArrayVar(&receiverArgs.events, "event", []string{}, "")
-	createReceiverCmd.Flags().StringArrayVar(&receiverArgs.resources, "resource", []string{}, "")
+	createReceiverCmd.Flags().StringSliceVar(&receiverArgs.events, "event", []string{}, "also accepts comma-separated values")
+	createReceiverCmd.Flags().StringSliceVar(&receiverArgs.resources, "resource", []string{}, "also accepts comma-separated values")
 	createCmd.AddCommand(createReceiverCmd)
 }
 

cmd/flux/create_source_git.go

@@ -122,7 +122,7 @@ var sourceGitArgs = newSourceGitFlags()
 
 func init() {
 	createSourceGitCmd.Flags().StringVar(&sourceGitArgs.url, "url", "", "git address, e.g. ssh://git@host/org/repository")
-	createSourceGitCmd.Flags().StringVar(&sourceGitArgs.branch, "branch", "master", "git branch")
+	createSourceGitCmd.Flags().StringVar(&sourceGitArgs.branch, "branch", "", "git branch")
 	createSourceGitCmd.Flags().StringVar(&sourceGitArgs.tag, "tag", "", "git tag")
 	createSourceGitCmd.Flags().StringVar(&sourceGitArgs.semver, "tag-semver", "", "git tag semver range")
 	createSourceGitCmd.Flags().StringVarP(&sourceGitArgs.username, "username", "u", "", "basic authentication username")
@@ -166,6 +166,10 @@ func createSourceGitCmdRun(cmd *cobra.Command, args []string) error {
 		return fmt.Errorf("git URL scheme '%s' not supported, can be: ssh, http and https", u.Scheme)
 	}
 
+	if sourceGitArgs.branch == "" && sourceGitArgs.tag == "" && sourceGitArgs.semver == "" {
+		return fmt.Errorf("a Git ref is required, use one of the following: --branch, --tag or --tag-semver")
+	}
+
 	if sourceGitArgs.caFile != "" && u.Scheme == "ssh" {
 		return fmt.Errorf("specifing a CA file is not supported for Git over SSH")
 	}

cmd/flux/docgen.go

@@ -59,7 +59,7 @@ func docgenCmdRun(cmd *cobra.Command, args []string) error {
 func frontmatterPrepender(filename string) string {
 	name := filepath.Base(filename)
 	base := strings.TrimSuffix(name, path.Ext(name))
-	title := strings.Replace(base, "_", " ", -1) + " command"
+	title := strings.Replace(base, "_", " ", -1)
 	return fmt.Sprintf(fmTemplate, title)
 }
 

cmd/flux/get_image_all.go

@@ -49,13 +49,6 @@ var getImageAllCmd = &cobra.Command{
 				list:    &imageUpdateAutomationListAdapter{&autov1.ImageUpdateAutomationList{}},
 			},
 		}
-		c := getCommand{
-			apiType: imageRepositoryType,
-			list:    imageRepositoryListAdapter{&imagev1.ImageRepositoryList{}},
-		}
-		if err := c.run(cmd, args); err != nil {
-			logger.Failuref(err.Error())
-		}
 
 		for _, c := range allImageCmd {
 			if err := c.run(cmd, args); err != nil {

cmd/flux/resume.go

@@ -23,6 +23,7 @@ import (
 	"github.com/spf13/cobra"
 	"k8s.io/apimachinery/pkg/types"
 	"k8s.io/apimachinery/pkg/util/wait"
+	"sigs.k8s.io/controller-runtime/pkg/client"
 
 	"github.com/fluxcd/flux2/internal/utils"
 )
@@ -33,7 +34,15 @@ var resumeCmd = &cobra.Command{
 	Long:  "The resume sub-commands resume a suspended resource.",
 }
 
+type ResumeFlags struct {
+	all bool
+}
+
+var resumeArgs ResumeFlags
+
 func init() {
+	resumeCmd.PersistentFlags().BoolVarP(&resumeArgs.all, "all", "", false,
+		"suspend all resources in that namespace")
 	rootCmd.AddCommand(resumeCmd)
 }
 
@@ -47,13 +56,18 @@ type resumable interface {
 type resumeCommand struct {
 	apiType
 	object resumable
+	list   listResumable
+}
+
+type listResumable interface {
+	listAdapter
+	resumeItem(i int) resumable
 }
 
 func (resume resumeCommand) run(cmd *cobra.Command, args []string) error {
-	if len(args) < 1 {
+	if len(args) < 1 && !resumeArgs.all {
 		return fmt.Errorf("%s name is required", resume.humanKind)
 	}
-	name := args[0]
 
 	ctx, cancel := context.WithTimeout(context.Background(), rootArgs.timeout)
 	defer cancel()
@@ -63,29 +77,46 @@ func (resume resumeCommand) run(cmd *cobra.Command, args []string) error {
 		return err
 	}
 
-	namespacedName := types.NamespacedName{
-		Namespace: rootArgs.namespace,
-		Name:      name,
+	var listOpts []client.ListOption
+	listOpts = append(listOpts, client.InNamespace(rootArgs.namespace))
+	if len(args) > 0 {
+		listOpts = append(listOpts, client.MatchingFields{
+			"metadata.name": args[0],
+		})
 	}
 
-	err = kubeClient.Get(ctx, namespacedName, resume.object.asClientObject())
+	err = kubeClient.List(ctx, resume.list.asClientList(), listOpts...)
 	if err != nil {
 		return err
 	}
 
-	logger.Actionf("resuming %s %s in %s namespace", resume.humanKind, name, rootArgs.namespace)
-	resume.object.setUnsuspended()
-	if err := kubeClient.Update(ctx, resume.object.asClientObject()); err != nil {
-		return err
+	if resume.list.len() == 0 {
+		logger.Failuref("no %s objects found in %s namespace", resume.kind, rootArgs.namespace)
+		return nil
 	}
-	logger.Successf("%s resumed", resume.humanKind)
 
-	logger.Waitingf("waiting for %s reconciliation", resume.kind)
-	if err := wait.PollImmediate(rootArgs.pollInterval, rootArgs.timeout,
-		isReady(ctx, kubeClient, namespacedName, resume.object)); err != nil {
-		return err
+	for i := 0; i < resume.list.len(); i++ {
+		logger.Actionf("resuming %s %s in %s namespace", resume.humanKind, resume.list.resumeItem(i).asClientObject().GetName(), rootArgs.namespace)
+		resume.list.resumeItem(i).setUnsuspended()
+		if err := kubeClient.Update(ctx, resume.list.resumeItem(i).asClientObject()); err != nil {
+			return err
+		}
+		logger.Successf("%s resumed", resume.humanKind)
+
+		namespacedName := types.NamespacedName{
+			Name:      resume.list.resumeItem(i).asClientObject().GetName(),
+			Namespace: rootArgs.namespace,
+		}
+
+		logger.Waitingf("waiting for %s reconciliation", resume.kind)
+		if err := wait.PollImmediate(rootArgs.pollInterval, rootArgs.timeout,
+			isReady(ctx, kubeClient, namespacedName, resume.list.resumeItem(i))); err != nil {
+			logger.Failuref(err.Error())
+			continue
+		}
+		logger.Successf("%s reconciliation completed", resume.kind)
+		logger.Successf(resume.list.resumeItem(i).successMessage())
 	}
-	logger.Successf("%s reconciliation completed", resume.kind)
-	logger.Successf(resume.object.successMessage())
+
 	return nil
 }

cmd/flux/resume_alert.go

@@ -32,6 +32,7 @@ finish the apply.`,
 	RunE: resumeCommand{
 		apiType: alertType,
 		object:  alertAdapter{&notificationv1.Alert{}},
+		list:    &alertListAdapter{&notificationv1.AlertList{}},
 	}.run,
 }
 
@@ -50,3 +51,7 @@ func (obj alertAdapter) setUnsuspended() {
 func (obj alertAdapter) successMessage() string {
 	return "Alert reconciliation completed"
 }
+
+func (a alertListAdapter) resumeItem(i int) resumable {
+	return &alertAdapter{&a.AlertList.Items[i]}
+}

cmd/flux/resume_helmrelease.go

@@ -35,6 +35,7 @@ finish the apply.`,
 	RunE: resumeCommand{
 		apiType: helmReleaseType,
 		object:  helmReleaseAdapter{&helmv2.HelmRelease{}},
+		list:    helmReleaseListAdapter{&helmv2.HelmReleaseList{}},
 	}.run,
 }
 
@@ -53,3 +54,7 @@ func (obj helmReleaseAdapter) setUnsuspended() {
 func (obj helmReleaseAdapter) successMessage() string {
 	return fmt.Sprintf("applied revision %s", obj.Status.LastAppliedRevision)
 }
+
+func (a helmReleaseListAdapter) resumeItem(i int) resumable {
+	return &helmReleaseAdapter{&a.HelmReleaseList.Items[i]}
+}

cmd/flux/resume_image_repository.go

@@ -31,6 +31,7 @@ var resumeImageRepositoryCmd = &cobra.Command{
 	RunE: resumeCommand{
 		apiType: imageRepositoryType,
 		object:  imageRepositoryAdapter{&imagev1.ImageRepository{}},
+		list:    imageRepositoryListAdapter{&imagev1.ImageRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj imageRepositoryAdapter) getObservedGeneration() int64 {
 func (obj imageRepositoryAdapter) setUnsuspended() {
 	obj.ImageRepository.Spec.Suspend = false
 }
+
+func (a imageRepositoryListAdapter) resumeItem(i int) resumable {
+	return &imageRepositoryAdapter{&a.ImageRepositoryList.Items[i]}
+}

cmd/flux/resume_image_updateauto.go

@@ -31,6 +31,7 @@ var resumeImageUpdateCmd = &cobra.Command{
 	RunE: resumeCommand{
 		apiType: imageUpdateAutomationType,
 		object:  imageUpdateAutomationAdapter{&autov1.ImageUpdateAutomation{}},
+		list:    imageUpdateAutomationListAdapter{&autov1.ImageUpdateAutomationList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj imageUpdateAutomationAdapter) setUnsuspended() {
 func (obj imageUpdateAutomationAdapter) getObservedGeneration() int64 {
 	return obj.ImageUpdateAutomation.Status.ObservedGeneration
 }
+
+func (a imageUpdateAutomationListAdapter) resumeItem(i int) resumable {
+	return &imageUpdateAutomationAdapter{&a.ImageUpdateAutomationList.Items[i]}
+}

cmd/flux/resume_kustomization.go

@@ -35,6 +35,7 @@ finish the apply.`,
 	RunE: resumeCommand{
 		apiType: kustomizationType,
 		object:  kustomizationAdapter{&kustomizev1.Kustomization{}},
+		list:    kustomizationListAdapter{&kustomizev1.KustomizationList{}},
 	}.run,
 }
 
@@ -53,3 +54,7 @@ func (obj kustomizationAdapter) setUnsuspended() {
 func (obj kustomizationAdapter) successMessage() string {
 	return fmt.Sprintf("applied revision %s", obj.Status.LastAppliedRevision)
 }
+
+func (a kustomizationListAdapter) resumeItem(i int) resumable {
+	return &kustomizationAdapter{&a.KustomizationList.Items[i]}
+}

cmd/flux/resume_receiver.go

@@ -32,6 +32,7 @@ finish the apply.`,
 	RunE: resumeCommand{
 		apiType: receiverType,
 		object:  receiverAdapter{&notificationv1.Receiver{}},
+		list:    receiverListAdapter{&notificationv1.ReceiverList{}},
 	}.run,
 }
 
@@ -50,3 +51,7 @@ func (obj receiverAdapter) setUnsuspended() {
 func (obj receiverAdapter) successMessage() string {
 	return "Receiver reconciliation completed"
 }
+
+func (a receiverListAdapter) resumeItem(i int) resumable {
+	return &receiverAdapter{&a.ReceiverList.Items[i]}
+}

cmd/flux/resume_source_bucket.go

@@ -45,3 +45,7 @@ func (obj bucketAdapter) getObservedGeneration() int64 {
 func (obj bucketAdapter) setUnsuspended() {
 	obj.Bucket.Spec.Suspend = false
 }
+
+func (a bucketListAdapter) resumeItem(i int) resumable {
+	return &bucketAdapter{&a.BucketList.Items[i]}
+}

cmd/flux/resume_source_chart.go

@@ -33,6 +33,7 @@ var resumeSourceHelmChartCmd = &cobra.Command{
 	RunE: resumeCommand{
 		apiType: helmChartType,
 		object:  &helmChartAdapter{&sourcev1.HelmChart{}},
+		list:    &helmChartListAdapter{&sourcev1.HelmChartList{}},
 	}.run,
 }
 
@@ -51,3 +52,7 @@ func (obj helmChartAdapter) setUnsuspended() {
 func (obj helmChartAdapter) successMessage() string {
 	return fmt.Sprintf("fetched revision %s", obj.Status.Artifact.Revision)
 }
+
+func (a helmChartListAdapter) resumeItem(i int) resumable {
+	return &helmChartAdapter{&a.HelmChartList.Items[i]}
+}

cmd/flux/resume_source_git.go

@@ -31,6 +31,7 @@ var resumeSourceGitCmd = &cobra.Command{
 	RunE: resumeCommand{
 		apiType: gitRepositoryType,
 		object:  gitRepositoryAdapter{&sourcev1.GitRepository{}},
+		list:    gitRepositoryListAdapter{&sourcev1.GitRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj gitRepositoryAdapter) getObservedGeneration() int64 {
 func (obj gitRepositoryAdapter) setUnsuspended() {
 	obj.GitRepository.Spec.Suspend = false
 }
+
+func (a gitRepositoryListAdapter) resumeItem(i int) resumable {
+	return &gitRepositoryAdapter{&a.GitRepositoryList.Items[i]}
+}

cmd/flux/resume_source_helm.go

@@ -31,6 +31,7 @@ var resumeSourceHelmCmd = &cobra.Command{
 	RunE: resumeCommand{
 		apiType: helmRepositoryType,
 		object:  helmRepositoryAdapter{&sourcev1.HelmRepository{}},
+		list:    helmRepositoryListAdapter{&sourcev1.HelmRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj helmRepositoryAdapter) getObservedGeneration() int64 {
 func (obj helmRepositoryAdapter) setUnsuspended() {
 	obj.HelmRepository.Spec.Suspend = false
 }
+
+func (a helmRepositoryListAdapter) resumeItem(i int) resumable {
+	return &helmRepositoryAdapter{&a.HelmRepositoryList.Items[i]}
+}

cmd/flux/suspend.go

@@ -21,7 +21,7 @@ import (
 	"fmt"
 
 	"github.com/spf13/cobra"
-	"k8s.io/apimachinery/pkg/types"
+	"sigs.k8s.io/controller-runtime/pkg/client"
 
 	"github.com/fluxcd/flux2/internal/utils"
 )
@@ -32,7 +32,15 @@ var suspendCmd = &cobra.Command{
 	Long:  "The suspend sub-commands suspend the reconciliation of a resource.",
 }
 
+type SuspendFlags struct {
+	all bool
+}
+
+var suspendArgs SuspendFlags
+
 func init() {
+	suspendCmd.PersistentFlags().BoolVarP(&suspendArgs.all, "all", "", false,
+		"suspend all resources in that namespace")
 	rootCmd.AddCommand(suspendCmd)
 }
 
@@ -44,14 +52,19 @@ type suspendable interface {
 
 type suspendCommand struct {
 	apiType
+	list   listSuspendable
 	object suspendable
 }
 
+type listSuspendable interface {
+	listAdapter
+	item(i int) suspendable
+}
+
 func (suspend suspendCommand) run(cmd *cobra.Command, args []string) error {
-	if len(args) < 1 {
+	if len(args) < 1 && !suspendArgs.all {
 		return fmt.Errorf("%s name is required", suspend.humanKind)
 	}
-	name := args[0]
 
 	ctx, cancel := context.WithTimeout(context.Background(), rootArgs.timeout)
 	defer cancel()
@@ -61,21 +74,33 @@ func (suspend suspendCommand) run(cmd *cobra.Command, args []string) error {
 		return err
 	}
 
-	namespacedName := types.NamespacedName{
-		Namespace: rootArgs.namespace,
-		Name:      name,
+	var listOpts []client.ListOption
+	listOpts = append(listOpts, client.InNamespace(rootArgs.namespace))
+	if len(args) > 0 {
+		listOpts = append(listOpts, client.MatchingFields{
+			"metadata.name": args[0],
+		})
 	}
-	err = kubeClient.Get(ctx, namespacedName, suspend.object.asClientObject())
+
+	err = kubeClient.List(ctx, suspend.list.asClientList(), listOpts...)
 	if err != nil {
 		return err
 	}
 
-	logger.Actionf("suspending %s %s in %s namespace", suspend.humanKind, name, rootArgs.namespace)
-	suspend.object.setSuspended()
-	if err := kubeClient.Update(ctx, suspend.object.asClientObject()); err != nil {
-		return err
+	if suspend.list.len() == 0 {
+		logger.Failuref("no %s objects found in %s namespace", suspend.kind, rootArgs.namespace)
+		return nil
+	}
+
+	for i := 0; i < suspend.list.len(); i++ {
+		logger.Actionf("suspending %s %s in %s namespace", suspend.humanKind, suspend.list.item(i).asClientObject().GetName(), rootArgs.namespace)
+		suspend.list.item(i).setSuspended()
+		if err := kubeClient.Update(ctx, suspend.list.item(i).asClientObject()); err != nil {
+			return err
+		}
+		logger.Successf("%s suspended", suspend.humanKind)
+
 	}
-	logger.Successf("%s suspended", suspend.humanKind)
 
 	return nil
 }

cmd/flux/suspend_alert.go

@@ -31,6 +31,7 @@ var suspendAlertCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: alertType,
 		object:  &alertAdapter{&notificationv1.Alert{}},
+		list:    &alertListAdapter{&notificationv1.AlertList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj alertAdapter) isSuspended() bool {
 func (obj alertAdapter) setSuspended() {
 	obj.Alert.Spec.Suspend = true
 }
+
+func (a alertListAdapter) item(i int) suspendable {
+	return &alertAdapter{&a.AlertList.Items[i]}
+}

cmd/flux/suspend_helmrelease.go

@@ -32,6 +32,7 @@ var suspendHrCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: helmReleaseType,
 		object:  &helmReleaseAdapter{&helmv2.HelmRelease{}},
+		list:    &helmReleaseListAdapter{&helmv2.HelmReleaseList{}},
 	}.run,
 }
 
@@ -46,3 +47,7 @@ func (obj helmReleaseAdapter) isSuspended() bool {
 func (obj helmReleaseAdapter) setSuspended() {
 	obj.HelmRelease.Spec.Suspend = true
 }
+
+func (a helmReleaseListAdapter) item(i int) suspendable {
+	return &helmReleaseAdapter{&a.HelmReleaseList.Items[i]}
+}

cmd/flux/suspend_image_repository.go

@@ -31,6 +31,7 @@ var suspendImageRepositoryCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: imageRepositoryType,
 		object:  imageRepositoryAdapter{&imagev1.ImageRepository{}},
+		list:    &imageRepositoryListAdapter{&imagev1.ImageRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj imageRepositoryAdapter) isSuspended() bool {
 func (obj imageRepositoryAdapter) setSuspended() {
 	obj.ImageRepository.Spec.Suspend = true
 }
+
+func (a imageRepositoryListAdapter) item(i int) suspendable {
+	return &imageRepositoryAdapter{&a.ImageRepositoryList.Items[i]}
+}

cmd/flux/suspend_image_updateauto.go

@@ -31,6 +31,7 @@ var suspendImageUpdateCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: imageUpdateAutomationType,
 		object:  imageUpdateAutomationAdapter{&autov1.ImageUpdateAutomation{}},
+		list:    &imageUpdateAutomationListAdapter{&autov1.ImageUpdateAutomationList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (update imageUpdateAutomationAdapter) isSuspended() bool {
 func (update imageUpdateAutomationAdapter) setSuspended() {
 	update.ImageUpdateAutomation.Spec.Suspend = true
 }
+
+func (a imageUpdateAutomationListAdapter) item(i int) suspendable {
+	return &imageUpdateAutomationAdapter{&a.ImageUpdateAutomationList.Items[i]}
+}

cmd/flux/suspend_kustomization.go

@@ -32,6 +32,7 @@ var suspendKsCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: kustomizationType,
 		object:  kustomizationAdapter{&kustomizev1.Kustomization{}},
+		list:    &kustomizationListAdapter{&kustomizev1.KustomizationList{}},
 	}.run,
 }
 
@@ -46,3 +47,7 @@ func (obj kustomizationAdapter) isSuspended() bool {
 func (obj kustomizationAdapter) setSuspended() {
 	obj.Kustomization.Spec.Suspend = true
 }
+
+func (a kustomizationListAdapter) item(i int) suspendable {
+	return &kustomizationAdapter{&a.KustomizationList.Items[i]}
+}

cmd/flux/suspend_receiver.go

@@ -31,6 +31,7 @@ var suspendReceiverCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: receiverType,
 		object:  &receiverAdapter{&notificationv1.Receiver{}},
+		list:    &receiverListAdapter{&notificationv1.ReceiverList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj receiverAdapter) isSuspended() bool {
 func (obj receiverAdapter) setSuspended() {
 	obj.Receiver.Spec.Suspend = true
 }
+
+func (a receiverListAdapter) item(i int) suspendable {
+	return &receiverAdapter{&a.ReceiverList.Items[i]}
+}

cmd/flux/suspend_source_bucket.go

@@ -31,6 +31,7 @@ var suspendSourceBucketCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: bucketType,
 		object:  bucketAdapter{&sourcev1.Bucket{}},
+		list:    bucketListAdapter{&sourcev1.BucketList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj bucketAdapter) isSuspended() bool {
 func (obj bucketAdapter) setSuspended() {
 	obj.Bucket.Spec.Suspend = true
 }
+
+func (a bucketListAdapter) item(i int) suspendable {
+	return &bucketAdapter{&a.BucketList.Items[i]}
+}

cmd/flux/suspend_source_chart.go

@@ -31,6 +31,7 @@ var suspendSourceHelmChartCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: helmChartType,
 		object:  helmChartAdapter{&sourcev1.HelmChart{}},
+		list:    helmChartListAdapter{&sourcev1.HelmChartList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj helmChartAdapter) isSuspended() bool {
 func (obj helmChartAdapter) setSuspended() {
 	obj.HelmChart.Spec.Suspend = true
 }
+
+func (a helmChartListAdapter) item(i int) suspendable {
+	return &helmChartAdapter{&a.HelmChartList.Items[i]}
+}

cmd/flux/suspend_source_git.go

@@ -31,6 +31,7 @@ var suspendSourceGitCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: gitRepositoryType,
 		object:  gitRepositoryAdapter{&sourcev1.GitRepository{}},
+		list:    gitRepositoryListAdapter{&sourcev1.GitRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj gitRepositoryAdapter) isSuspended() bool {
 func (obj gitRepositoryAdapter) setSuspended() {
 	obj.GitRepository.Spec.Suspend = true
 }
+
+func (a gitRepositoryListAdapter) item(i int) suspendable {
+	return &gitRepositoryAdapter{&a.GitRepositoryList.Items[i]}
+}

cmd/flux/suspend_source_helm.go

@@ -31,6 +31,7 @@ var suspendSourceHelmCmd = &cobra.Command{
 	RunE: suspendCommand{
 		apiType: helmRepositoryType,
 		object:  helmRepositoryAdapter{&sourcev1.HelmRepository{}},
+		list:    helmRepositoryListAdapter{&sourcev1.HelmRepositoryList{}},
 	}.run,
 }
 
@@ -45,3 +46,7 @@ func (obj helmRepositoryAdapter) isSuspended() bool {
 func (obj helmRepositoryAdapter) setSuspended() {
 	obj.HelmRepository.Spec.Suspend = true
 }
+
+func (a helmRepositoryListAdapter) item(i int) suspendable {
+	return &helmRepositoryAdapter{&a.HelmRepositoryList.Items[i]}
+}

docs/README.md

@@ -0,0 +1,17 @@
+# Flux v2 Documentation
+
+The documentation for `flux2` has moved to this repository: <https://github.com/fluxcd/website>.
+
+[The Website's README](https://github.com/fluxcd/website/#readme) has information on how to
+
+- modify and extend documentation
+- run the site <https://fluxcd.io> locally
+- publish changes
+
+and where all the individual pieces of content come from.
+
+It will be easier for us to maintain a coherent web presences (and merge all of Flux documentation) in one central repository. This was partly discussed in <https://github.com/fluxcd/flux2/discussions/367>.
+
+## toolkit.fluxcd.io
+
+For historical reasons we are keeping a `_redirects` file in this directory. It defines how redirects from the old site `toolkit.fluxcd.io` to our new website <https://fluxcd.io> work. Changes to this file need to be merged and a manual build triggered in the Netlify App.

docs/_files/flux-icon.svg

@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg width="64px" height="64px" viewBox="0 0 64 64" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <!-- Generator: Sketch 56.3 (81716) - https://sketch.com -->
-    <title>flux-icon</title>
-    <desc>Created with Sketch.</desc>
-    <g id="flux-icon" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="Group" transform="translate(11.000000, 2.000000)">
-            <path d="M0.803134615,15.7791346 C-0.246288462,15.0966346 -0.246288462,13.5602885 0.803134615,12.8783654 L20.1819808,0.279519231 C20.7554423,-0.0931730769 21.4944808,-0.0931730769 22.0679423,0.279519231 L41.4473654,12.8783654 C42.4967885,13.5602885 42.4967885,15.0966346 41.4473654,15.7791346 L22.0679423,28.3779808 C21.4944808,28.7506731 20.7554423,28.7506731 20.1819808,28.3779808 L0.803134615,15.7791346 Z" id="Fill-1" fill="#326CE5"></path>
-            <path d="M24.1851346,18.0023077 L25.5293654,18.0023077 C26.3145577,18.0023077 26.8055192,17.1525 26.4126346,16.4728846 L22.0084038,8.84423077 C21.6160962,8.16461538 20.63475,8.16461538 20.2418654,8.84423077 L15.8376346,16.4728846 C15.4453269,17.1525 15.9357115,18.0023077 16.7209038,18.0023077 L18.0657115,18.0023077 C18.6287885,18.0023077 19.0851346,18.4592308 19.0851346,19.0223077 L19.0851346,27.7298077 L19.9874423,28.3165385 C20.6791731,28.7665385 21.5710962,28.7665385 22.2628269,28.3165385 L23.1651346,27.7298077 L23.1651346,19.0223077 C23.1651346,18.4592308 23.6214808,18.0023077 24.1851346,18.0023077" id="Fill-3" fill="#C1D2F7"></path>
-            <path d="M27.8390769,34.8375577 L23.1648462,31.7989038 L23.1648462,33.2389038 C24.6902308,33.8919808 26.2588846,34.4008269 27.8390769,34.8375577" id="Fill-5" fill="#326CE5"></path>
-            <path d="M23.1650769,35.8280192 L23.1650769,37.8495577 C24.7095,38.3209038 26.2723846,38.7080192 27.8191154,39.0893654 C32.8706538,40.3349423 37.6418077,41.5107115 41.4783462,45.3478269 C41.6733462,45.54225 41.8562308,45.7407115 42.0373846,45.93975 C42.4308462,45.1880192 42.2335385,44.1957115 41.4466154,43.6845577 L33.8560385,38.7489808 C32.0133462,38.1409038 30.1360385,37.6759038 28.2806538,37.2189808 C26.5308462,36.7874423 24.8196923,36.3570577 23.1650769,35.8280192" id="Fill-7" fill="#326CE5"></path>
-            <path d="M19.08525,34.1699423 C18.4304423,33.8318654 17.7854423,33.4689808 17.1629423,33.0489808 L15.4269808,34.1774423 C16.5975577,35.0382115 17.8235192,35.7362885 19.08525,36.3212885 L19.08525,34.1699423 Z" id="Fill-9" fill="#326CE5"></path>
-            <path d="M24.8941731,40.6051154 C24.3137885,40.4620385 23.7374423,40.3195385 23.1651346,40.1735769 L23.1651346,42.1605 C23.5885962,42.2666538 24.0114808,42.3722308 24.4326346,42.4760769 C29.4841731,43.7210769 34.2553269,44.8968462 38.0924423,48.7339615 C38.0987885,48.7408846 38.1045577,48.7472308 38.1114808,48.7541538 L39.75225,47.6868462 C39.6524423,47.5824231 39.5584038,47.4751154 39.4545577,47.3718462 C35.2384038,43.1551154 29.9791731,41.8587692 24.8941731,40.6051154" id="Fill-11" fill="#326CE5"></path>
-            <path d="M19.08525,38.9907115 C16.8900577,38.2389808 14.8096731,37.2714808 12.9115962,35.8124423 L11.2119808,36.9178269 C13.6287115,38.9110962 16.3194808,40.1203269 19.08525,41.0168654 L19.08525,38.9907115 Z" id="Fill-13" fill="#326CE5"></path>
-            <path d="M19.08525,43.3809808 C15.3069808,42.3909808 11.7537115,41.18175 8.71794231,38.5388654 L7.04717308,39.6252115 C10.6125577,42.9102115 14.8540962,44.2832885 19.08525,45.3707885 L19.08525,43.3809808 Z" id="Fill-15" fill="#326CE5"></path>
-            <path d="M23.1650769,46.3935 C27.1175769,47.4140769 30.8341154,48.6342692 33.9823846,51.4381154 L35.6439231,50.3581154 C31.9654615,46.9000385 27.5514231,45.5194615 23.1650769,44.4048462 L23.1650769,46.3935 Z" id="Fill-17" fill="#326CE5"></path>
-            <path d="M4.57875,41.2299231 L2.92990385,42.3018462 C2.98759615,42.3612692 3.04009615,42.423 3.09951923,42.4818462 C7.31625,46.6985769 12.5743269,47.9949231 17.6599038,49.2485769 C22.0641346,50.3337692 26.2543269,51.3687692 29.7989423,54.1581923 L31.4893269,53.0591538 C27.4958654,49.6968462 22.7385577,48.5158846 18.1214423,47.3781923 C13.1206731,46.1453077 8.39567308,44.9758846 4.57875,41.2299231" id="Fill-19" fill="#326CE5"></path>
-            <path d="M1.07555769,44.5060962 C0.883442308,44.3139808 0.702865385,44.1184038 0.524019231,43.9216731 C-0.227711538,44.6745577 -0.139442308,45.9726346 0.80325,46.5853269 L6.50959615,50.2955192 C9.03536538,51.3409038 11.6765192,51.9945577 14.2738269,52.6349423 C18.3284423,53.6341731 22.2019038,54.5924423 25.5578654,56.9157115 L27.2834423,55.7930192 C23.4676731,52.9245577 19.0403654,51.8255192 14.7347885,50.7639808 C9.68382692,49.5189808 4.91267308,48.3432115 1.07555769,44.5060962" id="Fill-21" fill="#326CE5"></path>
-            <path d="M19.6441154,58.8342692 C20.0243077,59.0188846 20.3998846,59.2133077 20.7691154,59.4221538 C21.2093077,59.5150385 21.6771923,59.4383077 22.0683462,59.1838846 L23.0260385,58.5613846 C19.9493077,56.5035 16.5287308,55.461 13.1196923,54.5927308 L19.6441154,58.8342692 Z" id="Fill-23" fill="#326CE5"></path>
-        </g>
-    </g>
-</svg>

docs/_redirects

@@ -0,0 +1,18 @@
+# individual rules
+/core-concepts          https://fluxcd.io/docs/concepts                     301!
+/contributing           https://fluxcd.io/contributing                      301!
+/install.sh             https://fluxcd.io/install.sh                        301!
+
+# refer to https://github.com/fluxcd/flux2/discussions/367
+/dev-guides/*           https://fluxcd.io/docs/gitops-toolkit/:splat        301!
+
+
+# this is how things looked in the navbar anyway..?
+/guides/faq-migration                   https://fluxcd.io/docs/migration/faq-migration                  301!
+/guides/flux-v1-automation-migration    https://fluxcd.io/docs/migration/flux-v1-automation-migration   301!
+/guides/flux-v1-migration               https://fluxcd.io/docs/migration/flux-v1-migration              301!
+/guides/helm-operator-migration         https://fluxcd.io/docs/migration/helm-operator-migration        301!
+
+
+# catch all
+/*                      https://fluxcd.io/docs/:splat                       301!

docs/_static/custom.css

@@ -1,122 +0,0 @@
-@import url("https://fonts.googleapis.com/css?family=Montserrat&display=swap");
-
-body {
-  font-family: "Montserrat", sans-serif;
-}
-
-.md-logo {
-    width: 40px;
-    height: 40px;
-    padding-bottom: 2px;
-    padding-top: 2px;
-}
-.md-logo img {
-    width: 40px;
-    height: 40px;
-}
-
-.md-header, .md-footer-nav {
-    background-image: linear-gradient(45deg, rgb(0, 150, 225) 0%, rgb(27, 141, 226) 24%, rgb(42, 125, 227) 53%, rgb(53, 112, 227) 78%, rgb(53, 112, 227) 100%);
-}
-
-.md-header-nav__title {
-    font-size: .85rem;
-}
-
-.check-bullet {
-  color:#07bfa5;
-  background-color: white;
-  margin-left:-22px;
-}
-
-/* Progress bar styling */
-
-.progress-label {
-    position: absolute;
-    text-align: center;
-    font-weight: 700;
-    width: 100%;
-    /* remove original styling for thin styling
-    margin: 0 ! important; */
-    margin-top: -0.4rem ! important;
-    line-height: 1.2rem;
-    white-space: nowrap;
-    overflow: hidden;
-  }
-  
-  .progress-bar {
-    /*remove original styling for thin styling
-    height: 1.2rem; */
-    height: 0.4rem;
-    float: left;
-    background: repeating-linear-gradient(
-        45deg,
-        rgba(255, 255, 255, 0.2),
-        rgba(255, 255, 255, 0.2) 10px,
-        rgba(255, 255, 255, 0.3) 10px,
-        rgba(255, 255, 255, 0.3) 20px
-      ) #2979ff;
-      border-radius: 2px;
-  }
-  
-  .progress {
-    display: block;
-    width: 100%;
-    /* remove original styling for thin styling
-    margin: 0.5rem 0;
-    height: 1.2rem; */
-    margin-top: 0.9rem;
-    height: 0.4rem;
-    background-color: #eeeeee;
-    position: relative;
-    border-radius: 2px;
-  }
-
-  .progress-100plus .progress-bar {
-    background-color: #00c853;
-  }
-  
-  .progress-80plus .progress-bar {
-    background-color: #64dd17;
-  }
-  
-  .progress-60plus .progress-bar {
-    background-color: #fbc02d;
-  }
-  
-  .progress-40plus .progress-bar {
-    background-color: #ff9100;
-  }
-  
-  .progress-20plus .progress-bar {
-    background-color: #ff5252;
-  }
-  
-  .progress-0plus .progress-bar {
-    background-color: #ff1744;
-  }
-
-/* Custom admonitions */
-/* See https://squidfunk.github.io/mkdocs-material/reference/admonitions */
-:root {
-  --md-admonition-icon--heart: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 20.408c-.492.308-.903.546-1.192.709-.153.086-.308.17-.463.252h-.002a.75.75 0 0 1-.686 0 16.709 16.709 0 0 1-.465-.252 31.147 31.147 0 0 1-4.803-3.34C3.8 15.572 1 12.331 1 8.513 1 5.052 3.829 2.5 6.736 2.5 9.03 2.5 10.881 3.726 12 5.605 13.12 3.726 14.97 2.5 17.264 2.5 20.17 2.5 23 5.052 23 8.514c0 3.818-2.801 7.06-5.389 9.262A31.146 31.146 0 0 1 14 20.408z"/></svg>')
-}
-.md-typeset .admonition.heart,
-.md-typeset details.heart {
-  border-color: rgb(233, 30, 99);
-}
-.md-typeset .heart > .admonition-title,
-.md-typeset .heart > summary {
-  background-color: rgba(233, 30, 99, 0.1);
-}
-.md-typeset .heart > .admonition-title::before,
-.md-typeset .heart > summary::before {
-  background-color: rgb(233, 30, 99);
-  -webkit-mask-image: var(--md-admonition-icon--heart);
-          mask-image: var(--md-admonition-icon--heart);
-}
-
-.timetable-explicit-col-widths th:nth-child(1) { width: 4%; }
-.timetable-explicit-col-widths th:nth-child(2) { width: 32%; }
-.timetable-explicit-col-widths th:nth-child(3) { width: 32%; }
-.timetable-explicit-col-widths th:nth-child(4) { width: 32%; }

docs/cmd/flux.md

@@ -1,96 +0,0 @@
----
-title: "flux command"
----
-## flux
-
-Command line utility for assembling Kubernetes CD pipelines
-
-### Synopsis
-
-
-Command line utility for assembling Kubernetes CD pipelines the GitOps way.
-
-### Examples
-
-```
-  # Check prerequisites
-  flux check --pre
-
-  # Install the latest version of Flux
-  flux install --version=master
-
-  # Create a source for a public Git repository
-  flux create source git webapp-latest \
-    --url=https://github.com/stefanprodan/podinfo \
-    --branch=master \
-    --interval=3m
-
-  # List GitRepository sources and their status
-  flux get sources git
-
-  # Trigger a GitRepository source reconciliation
-  flux reconcile source git flux-system
-
-  # Export GitRepository sources in YAML format
-  flux export source git --all > sources.yaml
-
-  # Create a Kustomization for deploying a series of microservices
-  flux create kustomization webapp-dev \
-    --source=webapp-latest \
-    --path="./deploy/webapp/" \
-    --prune=true \
-    --interval=5m \
-    --validation=client \
-    --health-check="Deployment/backend.webapp" \
-    --health-check="Deployment/frontend.webapp" \
-    --health-check-timeout=2m
-
-  # Trigger a git sync of the Kustomization's source and apply changes
-  flux reconcile kustomization webapp-dev --with-source
-
-  # Suspend a Kustomization reconciliation
-  flux suspend kustomization webapp-dev
-
-  # Export Kustomizations in YAML format
-  flux export kustomization --all > kustomizations.yaml
-
-  # Resume a Kustomization reconciliation
-  flux resume kustomization webapp-dev
-
-  # Delete a Kustomization
-  flux delete kustomization webapp-dev
-
-  # Delete a GitRepository source
-  flux delete source git webapp-latest
-
-  # Uninstall Flux and delete CRDs
-  flux uninstall
-```
-
-### Options
-
-```
-      --context string      kubernetes context to use
-  -h, --help                help for flux
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux bootstrap](../flux_bootstrap/)	 - Bootstrap toolkit components
-* [flux check](../flux_check/)	 - Check requirements and installation
-* [flux completion](../flux_completion/)	 - Generates completion scripts for various shells
-* [flux create](../flux_create/)	 - Create or update sources and resources
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-* [flux export](../flux_export/)	 - Export resources in YAML format
-* [flux get](../flux_get/)	 - Get the resources and their status
-* [flux install](../flux_install/)	 - Install or upgrade Flux
-* [flux logs](../flux_logs/)	 - Display formatted logs for Flux components
-* [flux reconcile](../flux_reconcile/)	 - Reconcile sources and resources
-* [flux resume](../flux_resume/)	 - Resume suspended resources
-* [flux suspend](../flux_suspend/)	 - Suspend resources
-* [flux uninstall](../flux_uninstall/)	 - Uninstall Flux and its custom resource definitions
-

docs/cmd/flux_bootstrap.md

@@ -1,57 +0,0 @@
----
-title: "flux bootstrap command"
----
-## flux bootstrap
-
-Bootstrap toolkit components
-
-### Synopsis
-
-The bootstrap sub-commands bootstrap the toolkit components on the targeted Git provider.
-
-### Options
-
-```
-      --author-email string                    author email for Git commits
-      --author-name string                     author name for Git commits (default "Flux")
-      --branch string                          Git branch (default "main")
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-      --cluster-domain string                  internal cluster domain (default "cluster.local")
-      --commit-message-appendix string         string to add to the commit messages, e.g. '[ci skip]'
-      --components strings                     list of components, accepts comma-separated values (default [source-controller,kustomize-controller,helm-controller,notification-controller])
-      --components-extra strings               list of components in addition to those supplied or defaulted, accepts comma-separated values
-  -h, --help                                   help for bootstrap
-      --image-pull-secret string               Kubernetes secret name used for pulling the toolkit images from a private registry
-      --log-level logLevel                     log level, available options are: (debug, info, error) (default info)
-      --network-policy                         deny ingress access to the toolkit controllers from other namespaces using network policies (default true)
-      --private-key-file string                path to a private key file used for authenticating to the Git SSH server
-      --recurse-submodules                     when enabled, configures the GitRepository source to initialize and include Git submodules in the artifact it produces
-      --registry string                        container registry where the toolkit images are published (default "ghcr.io/fluxcd")
-      --secret-name string                     name of the secret the sync credentials can be found in or stored to (default "flux-system")
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-hostname string                    SSH hostname, to be used when the SSH host differs from the HTTPS one
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --token-auth                             when enabled, the personal access token will be used instead of SSH deploy key
-      --toleration-keys strings                list of toleration keys used to schedule the components pods onto nodes with matching taints
-  -v, --version string                         toolkit version, when specified the manifests are downloaded from https://github.com/fluxcd/flux2/releases
-      --watch-all-namespaces                   watch for custom resources in all namespaces, if set to false it will only watch the namespace where the toolkit is installed (default true)
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux](../flux/)	 - Command line utility for assembling Kubernetes CD pipelines
-* [flux bootstrap git](../flux_bootstrap_git/)	 - Bootstrap toolkit components in a Git repository
-* [flux bootstrap github](../flux_bootstrap_github/)	 - Bootstrap toolkit components in a GitHub repository
-* [flux bootstrap gitlab](../flux_bootstrap_gitlab/)	 - Bootstrap toolkit components in a GitLab repository
-

docs/cmd/flux_bootstrap_git.md

@@ -1,83 +0,0 @@
----
-title: "flux bootstrap git command"
----
-## flux bootstrap git
-
-Bootstrap toolkit components in a Git repository
-
-### Synopsis
-
-The bootstrap git command commits the toolkit components manifests to the
-branch of a Git repository. It then configures the target cluster to synchronize with
-the repository. If the toolkit components are present on the cluster, the bootstrap
-command will perform an upgrade if needed.
-
-```
-flux bootstrap git [flags]
-```
-
-### Examples
-
-```
-  # Run bootstrap for a Git repository and authenticate with your SSH agent
-  flux bootstrap git --url=ssh://git@example.com/repository.git
-
-  # Run bootstrap for a Git repository and authenticate using a password
-  flux bootstrap git --url=https://example.com/repository.git --password=<password>
-
-  # Run bootstrap for a Git repository with a passwordless private key
-  flux bootstrap git --url=ssh://git@example.com/repository.git --private-key-file=<path/to/private.key>
-
-  # Run bootstrap for a Git repository with a private key and password
-  flux bootstrap git --url=ssh://git@example.com/repository.git --private-key-file=<path/to/private.key> --password=<password>
-
-```
-
-### Options
-
-```
-  -h, --help                    help for git
-      --interval duration       sync interval (default 1m0s)
-  -p, --password string         basic authentication password
-      --path safeRelativePath   path relative to the repository root, when specified the cluster sync will be scoped to this path
-      --url string              Git repository URL
-  -u, --username string         basic authentication username (default "git")
-```
-
-### Options inherited from parent commands
-
-```
-      --author-email string                    author email for Git commits
-      --author-name string                     author name for Git commits (default "Flux")
-      --branch string                          Git branch (default "main")
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-      --cluster-domain string                  internal cluster domain (default "cluster.local")
-      --commit-message-appendix string         string to add to the commit messages, e.g. '[ci skip]'
-      --components strings                     list of components, accepts comma-separated values (default [source-controller,kustomize-controller,helm-controller,notification-controller])
-      --components-extra strings               list of components in addition to those supplied or defaulted, accepts comma-separated values
-      --context string                         kubernetes context to use
-      --image-pull-secret string               Kubernetes secret name used for pulling the toolkit images from a private registry
-      --kubeconfig string                      absolute path to the kubeconfig file
-      --log-level logLevel                     log level, available options are: (debug, info, error) (default info)
-  -n, --namespace string                       the namespace scope for this operation (default "flux-system")
-      --network-policy                         deny ingress access to the toolkit controllers from other namespaces using network policies (default true)
-      --private-key-file string                path to a private key file used for authenticating to the Git SSH server
-      --recurse-submodules                     when enabled, configures the GitRepository source to initialize and include Git submodules in the artifact it produces
-      --registry string                        container registry where the toolkit images are published (default "ghcr.io/fluxcd")
-      --secret-name string                     name of the secret the sync credentials can be found in or stored to (default "flux-system")
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-hostname string                    SSH hostname, to be used when the SSH host differs from the HTTPS one
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --timeout duration                       timeout for this operation (default 5m0s)
-      --token-auth                             when enabled, the personal access token will be used instead of SSH deploy key
-      --toleration-keys strings                list of toleration keys used to schedule the components pods onto nodes with matching taints
-      --verbose                                print generated objects
-  -v, --version string                         toolkit version, when specified the manifests are downloaded from https://github.com/fluxcd/flux2/releases
-      --watch-all-namespaces                   watch for custom resources in all namespaces, if set to false it will only watch the namespace where the toolkit is installed (default true)
-```
-
-### SEE ALSO
-
-* [flux bootstrap](../flux_bootstrap/)	 - Bootstrap toolkit components
-

docs/cmd/flux_bootstrap_github.md

@@ -1,100 +0,0 @@
----
-title: "flux bootstrap github command"
----
-## flux bootstrap github
-
-Bootstrap toolkit components in a GitHub repository
-
-### Synopsis
-
-The bootstrap github command creates the GitHub repository if it doesn't exists and
-commits the toolkit components manifests to the main branch.
-Then it configures the target cluster to synchronize with the repository.
-If the toolkit components are present on the cluster,
-the bootstrap command will perform an upgrade if needed.
-
-```
-flux bootstrap github [flags]
-```
-
-### Examples
-
-```
-  # Create a GitHub personal access token and export it as an env var
-  export GITHUB_TOKEN=<my-token>
-
-  # Run bootstrap for a private repository owned by a GitHub organization
-  flux bootstrap github --owner=<organization> --repository=<repository name>
-
-  # Run bootstrap for a private repository and assign organization teams to it
-  flux bootstrap github --owner=<organization> --repository=<repository name> --team=<team1 slug> --team=<team2 slug>
-
-  # Run bootstrap for a repository path
-  flux bootstrap github --owner=<organization> --repository=<repository name> --path=dev-cluster
-
-  # Run bootstrap for a public repository on a personal account
-  flux bootstrap github --owner=<user> --repository=<repository name> --private=false --personal=true
-
-  # Run bootstrap for a private repository hosted on GitHub Enterprise using SSH auth
-  flux bootstrap github --owner=<organization> --repository=<repository name> --hostname=<domain> --ssh-hostname=<domain>
-
-  # Run bootstrap for a private repository hosted on GitHub Enterprise using HTTPS auth
-  flux bootstrap github --owner=<organization> --repository=<repository name> --hostname=<domain> --token-auth
-
-  # Run bootstrap for an existing repository with a branch named main
-  flux bootstrap github --owner=<organization> --repository=<repository name> --branch=main
-```
-
-### Options
-
-```
-  -h, --help                    help for github
-      --hostname string         GitHub hostname (default "github.com")
-      --interval duration       sync interval (default 1m0s)
-      --owner string            GitHub user or organization name
-      --path safeRelativePath   path relative to the repository root, when specified the cluster sync will be scoped to this path
-      --personal                if true, the owner is assumed to be a GitHub user; otherwise an org
-      --private                 if true, the repository is setup or configured as private (default true)
-      --read-write-key          if true, the deploy key is configured with read/write permissions
-      --reconcile               if true, the configured options are also reconciled if the repository already exists
-      --repository string       GitHub repository name
-      --team stringArray        GitHub team to be given maintainer access
-```
-
-### Options inherited from parent commands
-
-```
-      --author-email string                    author email for Git commits
-      --author-name string                     author name for Git commits (default "Flux")
-      --branch string                          Git branch (default "main")
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-      --cluster-domain string                  internal cluster domain (default "cluster.local")
-      --commit-message-appendix string         string to add to the commit messages, e.g. '[ci skip]'
-      --components strings                     list of components, accepts comma-separated values (default [source-controller,kustomize-controller,helm-controller,notification-controller])
-      --components-extra strings               list of components in addition to those supplied or defaulted, accepts comma-separated values
-      --context string                         kubernetes context to use
-      --image-pull-secret string               Kubernetes secret name used for pulling the toolkit images from a private registry
-      --kubeconfig string                      absolute path to the kubeconfig file
-      --log-level logLevel                     log level, available options are: (debug, info, error) (default info)
-  -n, --namespace string                       the namespace scope for this operation (default "flux-system")
-      --network-policy                         deny ingress access to the toolkit controllers from other namespaces using network policies (default true)
-      --private-key-file string                path to a private key file used for authenticating to the Git SSH server
-      --recurse-submodules                     when enabled, configures the GitRepository source to initialize and include Git submodules in the artifact it produces
-      --registry string                        container registry where the toolkit images are published (default "ghcr.io/fluxcd")
-      --secret-name string                     name of the secret the sync credentials can be found in or stored to (default "flux-system")
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-hostname string                    SSH hostname, to be used when the SSH host differs from the HTTPS one
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --timeout duration                       timeout for this operation (default 5m0s)
-      --token-auth                             when enabled, the personal access token will be used instead of SSH deploy key
-      --toleration-keys strings                list of toleration keys used to schedule the components pods onto nodes with matching taints
-      --verbose                                print generated objects
-  -v, --version string                         toolkit version, when specified the manifests are downloaded from https://github.com/fluxcd/flux2/releases
-      --watch-all-namespaces                   watch for custom resources in all namespaces, if set to false it will only watch the namespace where the toolkit is installed (default true)
-```
-
-### SEE ALSO
-
-* [flux bootstrap](../flux_bootstrap/)	 - Bootstrap toolkit components
-

docs/cmd/flux_bootstrap_gitlab.md

@@ -1,97 +0,0 @@
----
-title: "flux bootstrap gitlab command"
----
-## flux bootstrap gitlab
-
-Bootstrap toolkit components in a GitLab repository
-
-### Synopsis
-
-The bootstrap gitlab command creates the GitLab repository if it doesn't exists and
-commits the toolkit components manifests to the master branch.
-Then it configures the target cluster to synchronize with the repository.
-If the toolkit components are present on the cluster,
-the bootstrap command will perform an upgrade if needed.
-
-```
-flux bootstrap gitlab [flags]
-```
-
-### Examples
-
-```
-  # Create a GitLab API token and export it as an env var
-  export GITLAB_TOKEN=<my-token>
-
-  # Run bootstrap for a private repository using HTTPS token authentication
-  flux bootstrap gitlab --owner=<group> --repository=<repository name> --token-auth
-
-  # Run bootstrap for a private repository using SSH authentication
-  flux bootstrap gitlab --owner=<group> --repository=<repository name>
-
-  # Run bootstrap for a repository path
-  flux bootstrap gitlab --owner=<group> --repository=<repository name> --path=dev-cluster
-
-  # Run bootstrap for a public repository on a personal account
-  flux bootstrap gitlab --owner=<user> --repository=<repository name> --private=false --personal --token-auth
-
-  # Run bootstrap for a private repository hosted on a GitLab server
-  flux bootstrap gitlab --owner=<group> --repository=<repository name> --hostname=<domain> --token-auth
-
-  # Run bootstrap for a an existing repository with a branch named main
-  flux bootstrap gitlab --owner=<organization> --repository=<repository name> --branch=main --token-auth
-```
-
-### Options
-
-```
-  -h, --help                    help for gitlab
-      --hostname string         GitLab hostname (default "gitlab.com")
-      --interval duration       sync interval (default 1m0s)
-      --owner string            GitLab user or group name
-      --path safeRelativePath   path relative to the repository root, when specified the cluster sync will be scoped to this path
-      --personal                if true, the owner is assumed to be a GitLab user; otherwise a group
-      --private                 if true, the repository is setup or configured as private (default true)
-      --read-write-key          if true, the deploy key is configured with read/write permissions
-      --reconcile               if true, the configured options are also reconciled if the repository already exists
-      --repository string       GitLab repository name
-      --team stringArray        GitLab teams to be given maintainer access
-```
-
-### Options inherited from parent commands
-
-```
-      --author-email string                    author email for Git commits
-      --author-name string                     author name for Git commits (default "Flux")
-      --branch string                          Git branch (default "main")
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-      --cluster-domain string                  internal cluster domain (default "cluster.local")
-      --commit-message-appendix string         string to add to the commit messages, e.g. '[ci skip]'
-      --components strings                     list of components, accepts comma-separated values (default [source-controller,kustomize-controller,helm-controller,notification-controller])
-      --components-extra strings               list of components in addition to those supplied or defaulted, accepts comma-separated values
-      --context string                         kubernetes context to use
-      --image-pull-secret string               Kubernetes secret name used for pulling the toolkit images from a private registry
-      --kubeconfig string                      absolute path to the kubeconfig file
-      --log-level logLevel                     log level, available options are: (debug, info, error) (default info)
-  -n, --namespace string                       the namespace scope for this operation (default "flux-system")
-      --network-policy                         deny ingress access to the toolkit controllers from other namespaces using network policies (default true)
-      --private-key-file string                path to a private key file used for authenticating to the Git SSH server
-      --recurse-submodules                     when enabled, configures the GitRepository source to initialize and include Git submodules in the artifact it produces
-      --registry string                        container registry where the toolkit images are published (default "ghcr.io/fluxcd")
-      --secret-name string                     name of the secret the sync credentials can be found in or stored to (default "flux-system")
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-hostname string                    SSH hostname, to be used when the SSH host differs from the HTTPS one
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --timeout duration                       timeout for this operation (default 5m0s)
-      --token-auth                             when enabled, the personal access token will be used instead of SSH deploy key
-      --toleration-keys strings                list of toleration keys used to schedule the components pods onto nodes with matching taints
-      --verbose                                print generated objects
-  -v, --version string                         toolkit version, when specified the manifests are downloaded from https://github.com/fluxcd/flux2/releases
-      --watch-all-namespaces                   watch for custom resources in all namespaces, if set to false it will only watch the namespace where the toolkit is installed (default true)
-```
-
-### SEE ALSO
-
-* [flux bootstrap](../flux_bootstrap/)	 - Bootstrap toolkit components
-

docs/cmd/flux_check.md

@@ -1,49 +0,0 @@
----
-title: "flux check command"
----
-## flux check
-
-Check requirements and installation
-
-### Synopsis
-
-The check command will perform a series of checks to validate that
-the local environment is configured correctly and if the installed components are healthy.
-
-```
-flux check [flags]
-```
-
-### Examples
-
-```
-  # Run pre-installation checks
-  flux check --pre
-
-  # Run installation checks
-  flux check
-```
-
-### Options
-
-```
-      --components strings         list of components, accepts comma-separated values (default [source-controller,kustomize-controller,helm-controller,notification-controller])
-      --components-extra strings   list of components in addition to those supplied or defaulted, accepts comma-separated values
-  -h, --help                       help for check
-      --pre                        only run pre-installation checks
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux](../flux/)	 - Command line utility for assembling Kubernetes CD pipelines
-

docs/cmd/flux_completion.md

@@ -1,35 +0,0 @@
----
-title: "flux completion command"
----
-## flux completion
-
-Generates completion scripts for various shells
-
-### Synopsis
-
-The completion sub-command generates completion scripts for various shells
-
-### Options
-
-```
-  -h, --help   help for completion
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux](../flux/)	 - Command line utility for assembling Kubernetes CD pipelines
-* [flux completion bash](../flux_completion_bash/)	 - Generates bash completion scripts
-* [flux completion fish](../flux_completion_fish/)	 - Generates fish completion scripts
-* [flux completion powershell](../flux_completion_powershell/)	 - Generates powershell completion scripts
-* [flux completion zsh](../flux_completion_zsh/)	 - Generates zsh completion scripts
-

docs/cmd/flux_completion_bash.md

@@ -1,44 +0,0 @@
----
-title: "flux completion bash command"
----
-## flux completion bash
-
-Generates bash completion scripts
-
-```
-flux completion bash [flags]
-```
-
-### Examples
-
-```
-To load completion run
-
-. <(flux completion bash)
-
-To configure your bash shell to load completions for each session add to your bashrc
-
-# ~/.bashrc or ~/.profile
-command -v flux >/dev/null && . <(flux completion bash)
-```
-
-### Options
-
-```
-  -h, --help   help for bash
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux completion](../flux_completion/)	 - Generates completion scripts for various shells
-

docs/cmd/flux_completion_fish.md

@@ -1,41 +0,0 @@
----
-title: "flux completion fish command"
----
-## flux completion fish
-
-Generates fish completion scripts
-
-```
-flux completion fish [flags]
-```
-
-### Examples
-
-```
-To configure your fish shell to load completions for each session write this script to your completions dir:
-
-flux completion fish > ~/.config/fish/completions/flux.fish
-
-See http://fishshell.com/docs/current/index.html#completion-own for more details
-```
-
-### Options
-
-```
-  -h, --help   help for fish
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux completion](../flux_completion/)	 - Generates completion scripts for various shells
-

docs/cmd/flux_completion_powershell.md

@@ -1,51 +0,0 @@
----
-title: "flux completion powershell command"
----
-## flux completion powershell
-
-Generates powershell completion scripts
-
-```
-flux completion powershell [flags]
-```
-
-### Examples
-
-```
-To load completion run
-
-. <(flux completion powershell)
-
-To configure your powershell shell to load completions for each session add to your powershell profile
-
-Windows:
-
-cd "$env:USERPROFILE\Documents\WindowsPowerShell\Modules"
-flux completion >> flux-completion.ps1
-
-Linux:
-
-cd "${XDG_CONFIG_HOME:-"$HOME/.config/"}/powershell/modules"
-flux completion >> flux-completions.ps1
-```
-
-### Options
-
-```
-  -h, --help   help for powershell
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux completion](../flux_completion/)	 - Generates completion scripts for various shells
-

docs/cmd/flux_completion_zsh.md

@@ -1,52 +0,0 @@
----
-title: "flux completion zsh command"
----
-## flux completion zsh
-
-Generates zsh completion scripts
-
-```
-flux completion zsh [flags]
-```
-
-### Examples
-
-```
-To load completion run
-
-. <(flux completion zsh) && compdef _flux flux
-
-To configure your zsh shell to load completions for each session add to your zshrc
-
-# ~/.zshrc or ~/.profile
-command -v flux >/dev/null && . <(flux completion zsh) && compdef _flux flux
-
-or write a cached file in one of the completion directories in your ${fpath}:
-
-echo "${fpath// /\n}" | grep -i completion
-flux completion zsh > _flux
-
-mv _flux ~/.oh-my-zsh/completions  # oh-my-zsh
-mv _flux ~/.zprezto/modules/completion/external/src/  # zprezto
-```
-
-### Options
-
-```
-  -h, --help   help for zsh
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux completion](../flux_completion/)	 - Generates completion scripts for various shells
-

docs/cmd/flux_create.md

@@ -1,43 +0,0 @@
----
-title: "flux create command"
----
-## flux create
-
-Create or update sources and resources
-
-### Synopsis
-
-The create sub-commands generate sources and resources.
-
-### Options
-
-```
-      --export              export in YAML format to stdout
-  -h, --help                help for create
-      --interval duration   source sync interval (default 1m0s)
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux](../flux/)	 - Command line utility for assembling Kubernetes CD pipelines
-* [flux create alert](../flux_create_alert/)	 - Create or update a Alert resource
-* [flux create alert-provider](../flux_create_alert-provider/)	 - Create or update a Provider resource
-* [flux create helmrelease](../flux_create_helmrelease/)	 - Create or update a HelmRelease resource
-* [flux create image](../flux_create_image/)	 - Create or update resources dealing with image automation
-* [flux create kustomization](../flux_create_kustomization/)	 - Create or update a Kustomization resource
-* [flux create receiver](../flux_create_receiver/)	 - Create or update a Receiver resource
-* [flux create secret](../flux_create_secret/)	 - Create or update Kubernetes secrets
-* [flux create source](../flux_create_source/)	 - Create or update sources
-* [flux create tenant](../flux_create_tenant/)	 - Create or update a tenant
-

docs/cmd/flux_create_alert-provider.md

@@ -1,60 +0,0 @@
----
-title: "flux create alert-provider command"
----
-## flux create alert-provider
-
-Create or update a Provider resource
-
-### Synopsis
-
-The create alert-provider command generates a Provider resource.
-
-```
-flux create alert-provider [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a Provider for a Slack channel
-  flux create alert-provider slack \
-  --type slack \
-  --channel general \
-  --address https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK \
-  --secret-ref webhook-url
-
-  # Create a Provider for a Github repository
-  flux create alert-provider github-podinfo \
-  --type github \
-  --address https://github.com/stefanprodan/podinfo \
-  --secret-ref github-token
-```
-
-### Options
-
-```
-      --address string      path to either the git repository, chat provider or webhook
-      --channel string      channel to send messages to in the case of a chat provider
-  -h, --help                help for alert-provider
-      --secret-ref string   name of secret containing authentication token
-      --type string         type of provider
-      --username string     bot username used by the provider
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_create_alert.md

@@ -1,52 +0,0 @@
----
-title: "flux create alert command"
----
-## flux create alert
-
-Create or update a Alert resource
-
-### Synopsis
-
-The create alert command generates a Alert resource.
-
-```
-flux create alert [name] [flags]
-```
-
-### Examples
-
-```
-  # Create an Alert for kustomization events
-  flux create alert \
-  --event-severity info \
-  --event-source Kustomization/flux-system \
-  --provider-ref slack \
-  flux-system
-```
-
-### Options
-
-```
-      --event-severity string      severity of events to send alerts for
-      --event-source stringArray   sources that should generate alerts (<kind>/<name>)
-  -h, --help                       help for alert
-      --provider-ref string        reference to provider
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_create_helmrelease.md

@@ -1,111 +0,0 @@
----
-title: "flux create helmrelease command"
----
-## flux create helmrelease
-
-Create or update a HelmRelease resource
-
-### Synopsis
-
-The helmrelease create command generates a HelmRelease resource for a given HelmRepository source.
-
-```
-flux create helmrelease [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a HelmRelease with a chart from a HelmRepository source
-  flux create hr podinfo \
-    --interval=10m \
-    --source=HelmRepository/podinfo \
-    --chart=podinfo \
-    --chart-version=">4.0.0"
-
-  # Create a HelmRelease with a chart from a GitRepository source
-  flux create hr podinfo \
-    --interval=10m \
-    --source=GitRepository/podinfo \
-    --chart=./charts/podinfo
-
-  # Create a HelmRelease with a chart from a Bucket source
-  flux create hr podinfo \
-    --interval=10m \
-    --source=Bucket/podinfo \
-    --chart=./charts/podinfo
-
-  # Create a HelmRelease with values from local YAML files
-  flux create hr podinfo \
-    --source=HelmRepository/podinfo \
-    --chart=podinfo \
-    --values=./my-values1.yaml \
-    --values=./my-values2.yaml
-
-  # Create a HelmRelease with values from a Kubernetes secret
-  kubectl -n app create secret generic my-secret-values \
-	--from-file=values.yaml=/path/to/my-secret-values.yaml
-  flux -n app create hr podinfo \
-    --source=HelmRepository/podinfo \
-    --chart=podinfo \
-    --values-from=Secret/my-secret-values
-
-  # Create a HelmRelease with a custom release name
-  flux create hr podinfo \
-    --release-name=podinfo-dev
-    --source=HelmRepository/podinfo \
-    --chart=podinfo \
-
-  # Create a HelmRelease targeting another namespace than the resource
-  flux create hr podinfo \
-    --target-namespace=default \
-    --source=HelmRepository/podinfo \
-    --chart=podinfo
-
-  # Create a HelmRelease using a source from a different namespace
-  flux create hr podinfo \
-    --namespace=default \
-    --source=HelmRepository/podinfo.flux-system \
-    --chart=podinfo
-
-  # Create a HelmRelease definition on disk without applying it on the cluster
-  flux create hr podinfo \
-    --source=HelmRepository/podinfo \
-    --chart=podinfo \
-    --values=./values.yaml \
-    --export > podinfo-release.yaml
-```
-
-### Options
-
-```
-      --chart string                        Helm chart name or path
-      --chart-version string                Helm chart version, accepts a semver range (ignored for charts from GitRepository sources)
-      --crds crds                           upgrade CRDs policy, available options are: (Skip, Create, CreateReplace)
-      --depends-on stringArray              HelmReleases that must be ready before this release can be installed, supported formats '<name>' and '<namespace>/<name>'
-  -h, --help                                help for helmrelease
-      --release-name string                 name used for the Helm release, defaults to a composition of '[<target-namespace>-]<HelmRelease-name>'
-      --service-account string              the name of the service account to impersonate when reconciling this HelmRelease
-      --source helmChartSource              source that contains the chart in the format '<kind>/<name>.<namespace>', where kind must be one of: (HelmRepository, GitRepository, Bucket)
-      --target-namespace string             namespace to install this release, defaults to the HelmRelease namespace
-      --values stringArray                  local path to values.yaml files
-      --values-from helmReleaseValuesFrom   Kubernetes object reference that contains the values.yaml data key in the format '<kind>/<name>', where kind must be one of: (Secret, ConfigMap)
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_create_image.md

@@ -1,39 +0,0 @@
----
-title: "flux create image command"
----
-## flux create image
-
-Create or update resources dealing with image automation
-
-### Synopsis
-
-The create image sub-commands work with image automation objects; that is,
-object controlling updates to git based on e.g., new container images
-being available.
-
-### Options
-
-```
-  -h, --help   help for image
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-* [flux create image policy](../flux_create_image_policy/)	 - Create or update an ImagePolicy object
-* [flux create image repository](../flux_create_image_repository/)	 - Create or update an ImageRepository object
-* [flux create image update](../flux_create_image_update/)	 - Create or update an ImageUpdateAutomation object
-

docs/cmd/flux_create_image_policy.md

@@ -1,65 +0,0 @@
----
-title: "flux create image policy command"
----
-## flux create image policy
-
-Create or update an ImagePolicy object
-
-### Synopsis
-
-The create image policy command generates an ImagePolicy resource.
-An ImagePolicy object calculates a "latest image" given an image
-repository and a policy, e.g., semver.
-
-The image that sorts highest according to the policy is recorded in
-the status of the object.
-
-```
-flux create image policy [name] [flags]
-```
-
-### Examples
-
-```
-  # Create an ImagePolicy to select the latest stable release
-  flux create image policy podinfo \
-    --image-ref=podinfo \
-    --select-semver=">=1.0.0"
-
-  # Create an ImagePolicy to select the latest main branch build tagged as "${GIT_BRANCH}-${GIT_SHA:0:7}-$(date +%s)"
-  flux create image policy podinfo \
-    --image-ref=podinfo \
-    --select-numeric=asc \
-	--filter-regex='^main-[a-f0-9]+-(?P<ts>[0-9]+)' \
-	--filter-extract='$ts'
-```
-
-### Options
-
-```
-      --filter-extract string   replacement pattern (using capture groups from --filter-regex) to use for sorting
-      --filter-regex string     regular expression pattern used to filter the image tags
-  -h, --help                    help for policy
-      --image-ref string        the name of an image repository object
-      --select-alpha string     use alphabetical sorting to select image; either "asc" meaning select the last, or "desc" meaning select the first
-      --select-numeric string   use numeric sorting to select image; either "asc" meaning select the last, or "desc" meaning select the first
-      --select-semver string    a semver range to apply to tags; e.g., '1.x'
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create image](../flux_create_image/)	 - Create or update resources dealing with image automation
-

docs/cmd/flux_create_image_repository.md

@@ -1,72 +0,0 @@
----
-title: "flux create image repository command"
----
-## flux create image repository
-
-Create or update an ImageRepository object
-
-### Synopsis
-
-The create image repository command generates an ImageRepository resource.
-An ImageRepository object specifies an image repository to scan.
-
-```
-flux create image repository [name] [flags]
-```
-
-### Examples
-
-```
-  # Create an ImageRepository object to scan the alpine image repository:
-  flux create image repository alpine-repo --image alpine --interval 20m
-
-  # Create an image repository that uses an image pull secret (assumed to
-  # have been created already):
-  flux create image repository myapp-repo \
-    --secret-ref image-pull \
-    --image ghcr.io/example.com/myapp --interval 5m
-
-  # Create a TLS secret for a local image registry using a self-signed
-  # host certificate, and use it to scan an image. ca.pem is a file
-  # containing the CA certificate used to sign the host certificate.
-  flux create secret tls local-registry-cert --ca-file ./ca.pem
-  flux create image repository app-repo \
-    --cert-secret-ref local-registry-cert \
-    --image local-registry:5000/app --interval 5m
-
-  # Create a TLS secret with a client certificate and key, and use it
-  # to scan a private image registry.
-  flux create secret tls client-cert \
-    --cert-file client.crt --key-file client.key
-  flux create image repository app-repo \
-    --cert-secret-ref client-cert \
-    --image registry.example.com/private/app --interval 5m
-```
-
-### Options
-
-```
-      --cert-ref string         the name of a secret to use for TLS certificates
-  -h, --help                    help for repository
-      --image string            the image repository to scan; e.g., library/alpine
-      --scan-timeout duration   a timeout for scanning; this defaults to the interval if not set
-      --secret-ref string       the name of a docker-registry secret to use for credentials
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create image](../flux_create_image/)	 - Create or update resources dealing with image automation
-

docs/cmd/flux_create_image_update.md

@@ -1,70 +0,0 @@
----
-title: "flux create image update command"
----
-## flux create image update
-
-Create or update an ImageUpdateAutomation object
-
-### Synopsis
-
-The create image update command generates an ImageUpdateAutomation resource.
-An ImageUpdateAutomation object specifies an automated update to images
-mentioned in YAMLs in a git repository.
-
-```
-flux create image update [name] [flags]
-```
-
-### Examples
-
-```
-  # Configure image updates for the main repository created by flux bootstrap
-  flux create image update flux-system \
-    --git-repo-ref=flux-system \
-    --git-repo-path="./clusters/my-cluster" \
-    --checkout-branch=main \
-    --author-name=flux \
-    --author-email=flux@example.com \
-    --commit-template="{{range .Updated.Images}}{{println .}}{{end}}"
-
-  # Configure image updates to push changes to a different branch, if the branch doesn't exists it will be created
-  flux create image update flux-system \
-    --git-repo-ref=flux-system \
-    --git-repo-path="./clusters/my-cluster" \
-    --checkout-branch=main \
-    --push-branch=image-updates \
-    --author-name=flux \
-    --author-email=flux@example.com \
-    --commit-template="{{range .Updated.Images}}{{println .}}{{end}}"
-```
-
-### Options
-
-```
-      --author-email string      the email to use for commit author
-      --author-name string       the name to use for commit author
-      --checkout-branch string   the branch to checkout
-      --commit-template string   a template for commit messages
-      --git-repo-path string     path to the directory containing the manifests to be updated, defaults to the repository root
-      --git-repo-ref string      the name of a GitRepository resource with details of the upstream Git repository
-  -h, --help                     help for update
-      --push-branch string       the branch to push commits to, defaults to the checkout branch if not specified
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create image](../flux_create_image/)	 - Create or update resources dealing with image automation
-

docs/cmd/flux_create_kustomization.md

@@ -1,88 +0,0 @@
----
-title: "flux create kustomization command"
----
-## flux create kustomization
-
-Create or update a Kustomization resource
-
-### Synopsis
-
-The kustomization source create command generates a Kustomize resource for a given source.
-
-```
-flux create kustomization [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a Kustomization resource from a source at a given path
-  flux create kustomization contour \
-    --source=GitRepository/contour \
-    --path="./examples/contour/" \
-    --prune=true \
-    --interval=10m \
-    --validation=client \
-    --health-check="Deployment/contour.projectcontour" \
-    --health-check="DaemonSet/envoy.projectcontour" \
-    --health-check-timeout=3m
-
-  # Create a Kustomization resource that depends on the previous one
-  flux create kustomization webapp \
-    --depends-on=contour \
-    --source=GitRepository/webapp \
-    --path="./deploy/overlays/dev" \
-    --prune=true \
-    --interval=5m \
-    --validation=client
-
-  # Create a Kustomization using a source from a different namespace
-  flux create kustomization podinfo \
-    --namespace=default \
-    --source=GitRepository/podinfo.flux-system \
-    --path="./deploy/overlays/dev" \
-    --prune=true \
-    --interval=5m \
-    --validation=client
-
-  # Create a Kustomization resource that references a Bucket
-  flux create kustomization secrets \
-    --source=Bucket/secrets \
-    --prune=true \
-    --interval=5m
-```
-
-### Options
-
-```
-      --decryption-provider decryptionProvider   decryption provider, available options are: (sops)
-      --decryption-secret string                 set the Kubernetes secret name that contains the OpenPGP private keys used for sops decryption
-      --depends-on stringArray                   Kustomization that must be ready before this Kustomization can be applied, supported formats '<name>' and '<namespace>/<name>'
-      --health-check stringArray                 workload to be included in the health assessment, in the format '<kind>/<name>.<namespace>'
-      --health-check-timeout duration            timeout of health checking operations (default 2m0s)
-  -h, --help                                     help for kustomization
-      --path safeRelativePath                    path to the directory containing a kustomization.yaml file (default ./)
-      --prune                                    enable garbage collection
-      --service-account string                   the name of the service account to impersonate when reconciling this Kustomization
-      --source kustomizationSource               source that contains the Kubernetes manifests in the format '[<kind>/]<name>.<namespace>', where kind must be one of: (GitRepository, Bucket), if kind is not specified it defaults to GitRepository
-      --target-namespace string                  overrides the namespace of all Kustomization objects reconciled by this Kustomization
-      --validation string                        validate the manifests before applying them on the cluster, can be 'client' or 'server'
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_create_receiver.md

@@ -1,55 +0,0 @@
----
-title: "flux create receiver command"
----
-## flux create receiver
-
-Create or update a Receiver resource
-
-### Synopsis
-
-The create receiver command generates a Receiver resource.
-
-```
-flux create receiver [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a Receiver
-  flux create receiver github-receiver \
-	--type github \
-	--event ping \
-	--event push \
-	--secret-ref webhook-token \
-	--resource GitRepository/webapp \
-	--resource HelmRepository/webapp
-```
-
-### Options
-
-```
-      --event stringArray      
-  -h, --help                   help for receiver
-      --resource stringArray   
-      --secret-ref string      
-      --type string            
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_create_secret.md

@@ -1,37 +0,0 @@
----
-title: "flux create secret command"
----
-## flux create secret
-
-Create or update Kubernetes secrets
-
-### Synopsis
-
-The create source sub-commands generate Kubernetes secrets specific to Flux.
-
-### Options
-
-```
-  -h, --help   help for secret
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-* [flux create secret git](../flux_create_secret_git/)	 - Create or update a Kubernetes secret for Git authentication
-* [flux create secret helm](../flux_create_secret_helm/)	 - Create or update a Kubernetes secret for Helm repository authentication
-* [flux create secret tls](../flux_create_secret_tls/)	 - Create or update a Kubernetes secret with TLS certificates
-

docs/cmd/flux_create_secret_git.md

@@ -1,94 +0,0 @@
----
-title: "flux create secret git command"
----
-## flux create secret git
-
-Create or update a Kubernetes secret for Git authentication
-
-### Synopsis
-
-The create secret git command generates a Kubernetes secret with Git credentials.
-For Git over SSH, the host and SSH keys are automatically generated and stored in the secret.
-For Git over HTTP/S, the provided basic authentication credentials are stored in the secret.
-
-```
-flux create secret git [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a Git SSH authentication secret using an ECDSA P-521 curve public key
-
-  flux create secret git podinfo-auth \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --ssh-key-algorithm=ecdsa \
-    --ssh-ecdsa-curve=p521
-
-  # Create a Git SSH authentication secret with a passwordless private key from file
-  # The public SSH host key will still be gathered from the host
-  flux create secret git podinfo-auth \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --private-key-file=./private.key
-
-  # Create a Git SSH authentication secret with a passworded private key from file
-  # The public SSH host key will still be gathered from the host
-  flux create secret git podinfo-auth \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --private-key-file=./private.key \
-    --password=<password>
-
-  # Create a secret for a Git repository using basic authentication
-  flux create secret git podinfo-auth \
-    --url=https://github.com/stefanprodan/podinfo \
-    --username=username \
-    --password=password
-
-  # Create a Git SSH secret on disk and print the deploy key
-  flux create secret git podinfo-auth \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --export > podinfo-auth.yaml
-
-  yq read podinfo-auth.yaml 'data."identity.pub"' | base64 --decode
-
-  # Create a Git SSH secret on disk and encrypt it with Mozilla SOPS
-  flux create secret git podinfo-auth \
-    --namespace=apps \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --export > podinfo-auth.yaml
-
-  sops --encrypt --encrypted-regex '^(data|stringData)$' \
-    --in-place podinfo-auth.yaml
-```
-
-### Options
-
-```
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-  -h, --help                                   help for git
-  -p, --password string                        basic authentication password
-      --private-key-file string                path to a passwordless private key file used for authenticating to the Git SSH server
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --url string                             git address, e.g. ssh://git@host/org/repository
-  -u, --username string                        basic authentication username
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create secret](../flux_create_secret/)	 - Create or update Kubernetes secrets
-

docs/cmd/flux_create_secret_helm.md

@@ -1,65 +0,0 @@
----
-title: "flux create secret helm command"
----
-## flux create secret helm
-
-Create or update a Kubernetes secret for Helm repository authentication
-
-### Synopsis
-
-The create secret helm command generates a Kubernetes secret with basic authentication credentials.
-
-```
-flux create secret helm [name] [flags]
-```
-
-### Examples
-
-```
- # Create a Helm authentication secret on disk and encrypt it with Mozilla SOPS
-  flux create secret helm repo-auth \
-    --namespace=my-namespace \
-    --username=my-username \
-    --password=my-password \
-    --export > repo-auth.yaml
-
-  sops --encrypt --encrypted-regex '^(data|stringData)$' \
-    --in-place repo-auth.yaml
-
-  # Create a Helm authentication secret using a custom TLS cert
-  flux create secret helm repo-auth \
-    --username=username \
-    --password=password \
-    --cert-file=./cert.crt \
-    --key-file=./key.crt \
-    --ca-file=./ca.crt
-```
-
-### Options
-
-```
-      --ca-file string     TLS authentication CA file path
-      --cert-file string   TLS authentication cert file path
-  -h, --help               help for helm
-      --key-file string    TLS authentication key file path
-  -p, --password string    basic authentication password
-  -u, --username string    basic authentication username
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create secret](../flux_create_secret/)	 - Create or update Kubernetes secrets
-

docs/cmd/flux_create_secret_tls.md

@@ -1,56 +0,0 @@
----
-title: "flux create secret tls command"
----
-## flux create secret tls
-
-Create or update a Kubernetes secret with TLS certificates
-
-### Synopsis
-
-The create secret tls command generates a Kubernetes secret with certificates for use with TLS.
-
-```
-flux create secret tls [name] [flags]
-```
-
-### Examples
-
-```
- # Create a TLS secret on disk and encrypt it with Mozilla SOPS.
-  # Files are expected to be PEM-encoded.
-  flux create secret tls certs \
-    --namespace=my-namespace \
-    --cert-file=./client.crt \
-    --key-file=./client.key \
-    --export > certs.yaml
-
-  sops --encrypt --encrypted-regex '^(data|stringData)$' \
-    --in-place certs.yaml
-```
-
-### Options
-
-```
-      --ca-file string     TLS authentication CA file path
-      --cert-file string   TLS authentication cert file path
-  -h, --help               help for tls
-      --key-file string    TLS authentication key file path
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create secret](../flux_create_secret/)	 - Create or update Kubernetes secrets
-

docs/cmd/flux_create_source.md

@@ -1,37 +0,0 @@
----
-title: "flux create source command"
----
-## flux create source
-
-Create or update sources
-
-### Synopsis
-
-The create source sub-commands generate sources.
-
-### Options
-
-```
-  -h, --help   help for source
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-* [flux create source bucket](../flux_create_source_bucket/)	 - Create or update a Bucket source
-* [flux create source git](../flux_create_source_git/)	 - Create or update a GitRepository source
-* [flux create source helm](../flux_create_source_helm/)	 - Create or update a HelmRepository source
-

docs/cmd/flux_create_source_bucket.md

@@ -1,68 +0,0 @@
----
-title: "flux create source bucket command"
----
-## flux create source bucket
-
-Create or update a Bucket source
-
-### Synopsis
-
-The create source bucket command generates a Bucket resource and waits for it to be downloaded.
-For Buckets with static authentication, the credentials are stored in a Kubernetes secret.
-
-```
-flux create source bucket [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a source for a Bucket using static authentication
-  flux create source bucket podinfo \
-	--bucket-name=podinfo \
-    --endpoint=minio.minio.svc.cluster.local:9000 \
-	--insecure=true \
-	--access-key=myaccesskey \
-	--secret-key=mysecretkey \
-    --interval=10m
-
-  # Create a source for an Amazon S3 Bucket using IAM authentication
-  flux create source bucket podinfo \
-	--bucket-name=podinfo \
-	--provider=aws \
-    --endpoint=s3.amazonaws.com \
-	--region=us-east-1 \
-    --interval=10m
-```
-
-### Options
-
-```
-      --access-key string               the bucket access key
-      --bucket-name string              the bucket name
-      --endpoint string                 the bucket endpoint address
-  -h, --help                            help for bucket
-      --insecure                        for when connecting to a non-TLS S3 HTTP endpoint
-      --provider sourceBucketProvider   the S3 compatible storage provider name, available options are: (generic, aws) (default generic)
-      --region string                   the bucket region
-      --secret-key string               the bucket secret key
-      --secret-ref string               the name of an existing secret containing credentials
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create source](../flux_create_source/)	 - Create or update sources
-

docs/cmd/flux_create_source_git.md

@@ -1,109 +0,0 @@
----
-title: "flux create source git command"
----
-## flux create source git
-
-Create or update a GitRepository source
-
-### Synopsis
-
-The create source git command generates a GitRepository resource and waits for it to sync.
-For Git over SSH, host and SSH keys are automatically generated and stored in a Kubernetes secret.
-For private Git repositories, the basic authentication credentials are stored in a Kubernetes secret.
-
-```
-flux create source git [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a source from a public Git repository master branch
-  flux create source git podinfo \
-    --url=https://github.com/stefanprodan/podinfo \
-    --branch=master
-
-  # Create a source for a Git repository pinned to specific git tag
-  flux create source git podinfo \
-    --url=https://github.com/stefanprodan/podinfo \
-    --tag="3.2.3"
-
-  # Create a source from a public Git repository tag that matches a semver range
-  flux create source git podinfo \
-    --url=https://github.com/stefanprodan/podinfo \
-    --tag-semver=">=3.2.0 <3.3.0"
-
-  # Create a source for a Git repository using SSH authentication
-  flux create source git podinfo \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --branch=master
-
-  # Create a source for a Git repository using SSH authentication and an
-  # ECDSA P-521 curve public key
-  flux create source git podinfo \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --branch=master \
-    --ssh-key-algorithm=ecdsa \
-    --ssh-ecdsa-curve=p521
-
-  # Create a source for a Git repository using SSH authentication and a
-  #	passwordless private key from file
-  # The public SSH host key will still be gathered from the host
-  flux create source git podinfo \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --branch=master \
-    --private-key-file=./private.key
-
-  # Create a source for a Git repository using SSH authentication and a
-  # private key with a password from file
-  # The public SSH host key will still be gathered from the host
-  flux create source git podinfo \
-    --url=ssh://git@github.com/stefanprodan/podinfo \
-    --branch=master \
-    --private-key-file=./private.key \
-    --password=<password>
-
-  # Create a source for a Git repository using basic authentication
-  flux create source git podinfo \
-    --url=https://github.com/stefanprodan/podinfo \
-    --username=username \
-    --password=password
-```
-
-### Options
-
-```
-      --branch string                          git branch (default "master")
-      --ca-file string                         path to TLS CA file used for validating self-signed certificates
-      --git-implementation gitImplementation   the Git implementation to use, available options are: (go-git, libgit2)
-  -h, --help                                   help for git
-  -p, --password string                        basic authentication password
-      --private-key-file string                path to a passwordless private key file used for authenticating to the Git SSH server
-      --recurse-submodules                     when enabled, configures the GitRepository source to initialize and include Git submodules in the artifact it produces
-      --secret-ref string                      the name of an existing secret containing SSH or basic credentials
-      --ssh-ecdsa-curve ecdsaCurve             SSH ECDSA public key curve (p256, p384, p521) (default p384)
-      --ssh-key-algorithm publicKeyAlgorithm   SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa)
-      --ssh-rsa-bits rsaKeyBits                SSH RSA public key bit size (multiplies of 8) (default 2048)
-      --tag string                             git tag
-      --tag-semver string                      git tag semver range
-      --url string                             git address, e.g. ssh://git@host/org/repository
-  -u, --username string                        basic authentication username
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create source](../flux_create_source/)	 - Create or update sources
-

docs/cmd/flux_create_source_helm.md

@@ -1,68 +0,0 @@
----
-title: "flux create source helm command"
----
-## flux create source helm
-
-Create or update a HelmRepository source
-
-### Synopsis
-
-The create source helm command generates a HelmRepository resource and waits for it to fetch the index.
-For private Helm repositories, the basic authentication credentials are stored in a Kubernetes secret.
-
-```
-flux create source helm [name] [flags]
-```
-
-### Examples
-
-```
-  # Create a source for a public Helm repository
-  flux create source helm podinfo \
-    --url=https://stefanprodan.github.io/podinfo \
-    --interval=10m
-
-  # Create a source for a Helm repository using basic authentication
-  flux create source helm podinfo \
-    --url=https://stefanprodan.github.io/podinfo \
-    --username=username \
-    --password=password
-
-  # Create a source for a Helm repository using TLS authentication
-  flux create source helm podinfo \
-    --url=https://stefanprodan.github.io/podinfo \
-    --cert-file=./cert.crt \
-    --key-file=./key.crt \
-    --ca-file=./ca.crt
-```
-
-### Options
-
-```
-      --ca-file string      TLS authentication CA file path
-      --cert-file string    TLS authentication cert file path
-  -h, --help                help for helm
-      --key-file string     TLS authentication key file path
-  -p, --password string     basic authentication password
-      --secret-ref string   the name of an existing secret containing TLS or basic auth credentials
-      --url string          Helm repository address
-  -u, --username string     basic authentication username
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create source](../flux_create_source/)	 - Create or update sources
-

docs/cmd/flux_create_tenant.md

@@ -1,56 +0,0 @@
----
-title: "flux create tenant command"
----
-## flux create tenant
-
-Create or update a tenant
-
-### Synopsis
-
-The create tenant command generates namespaces, service accounts and role bindings to limit the
-reconcilers scope to the tenant namespaces.
-
-```
-flux create tenant [flags]
-```
-
-### Examples
-
-```
-  # Create a tenant with access to a namespace 
-  flux create tenant dev-team \
-    --with-namespace=frontend \
-    --label=environment=dev
-
-  # Generate tenant namespaces and role bindings in YAML format
-  flux create tenant dev-team \
-    --with-namespace=frontend \
-    --with-namespace=backend \
-	--export > dev-team.yaml
-```
-
-### Options
-
-```
-      --cluster-role string      cluster role of the tenant role binding (default "cluster-admin")
-  -h, --help                     help for tenant
-      --with-namespace strings   namespace belonging to this tenant
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --export              export in YAML format to stdout
-      --interval duration   source sync interval (default 1m0s)
-      --kubeconfig string   absolute path to the kubeconfig file
-      --label strings       set labels on the resource (can specify multiple labels with commas: label1=value1,label2=value2)
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux create](../flux_create/)	 - Create or update sources and resources
-

docs/cmd/flux_delete.md

@@ -1,39 +0,0 @@
----
-title: "flux delete command"
----
-## flux delete
-
-Delete sources and resources
-
-### Synopsis
-
-The delete sub-commands delete sources and resources.
-
-### Options
-
-```
-  -h, --help     help for delete
-  -s, --silent   delete resource without asking for confirmation
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux](../flux/)	 - Command line utility for assembling Kubernetes CD pipelines
-* [flux delete alert](../flux_delete_alert/)	 - Delete a Alert resource
-* [flux delete alert-provider](../flux_delete_alert-provider/)	 - Delete a Provider resource
-* [flux delete helmrelease](../flux_delete_helmrelease/)	 - Delete a HelmRelease resource
-* [flux delete image](../flux_delete_image/)	 - Delete image automation objects
-* [flux delete kustomization](../flux_delete_kustomization/)	 - Delete a Kustomization resource
-* [flux delete receiver](../flux_delete_receiver/)	 - Delete a Receiver resource
-* [flux delete source](../flux_delete_source/)	 - Delete sources
-

docs/cmd/flux_delete_alert-provider.md

@@ -1,43 +0,0 @@
----
-title: "flux delete alert-provider command"
----
-## flux delete alert-provider
-
-Delete a Provider resource
-
-### Synopsis
-
-The delete alert-provider command removes the given Provider from the cluster.
-
-```
-flux delete alert-provider [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete a Provider and the Kubernetes resources created by it
-  flux delete alert-provider slack
-```
-
-### Options
-
-```
-  -h, --help   help for alert-provider
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-

docs/cmd/flux_delete_alert.md

@@ -1,43 +0,0 @@
----
-title: "flux delete alert command"
----
-## flux delete alert
-
-Delete a Alert resource
-
-### Synopsis
-
-The delete alert command removes the given Alert from the cluster.
-
-```
-flux delete alert [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete an Alert and the Kubernetes resources created by it
-  flux delete alert main
-```
-
-### Options
-
-```
-  -h, --help   help for alert
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-

docs/cmd/flux_delete_helmrelease.md

@@ -1,43 +0,0 @@
----
-title: "flux delete helmrelease command"
----
-## flux delete helmrelease
-
-Delete a HelmRelease resource
-
-### Synopsis
-
-The delete helmrelease command removes the given HelmRelease from the cluster.
-
-```
-flux delete helmrelease [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete a Helm release and the Kubernetes resources created by it
-  flux delete hr podinfo
-```
-
-### Options
-
-```
-  -h, --help   help for helmrelease
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-

docs/cmd/flux_delete_image.md

@@ -1,35 +0,0 @@
----
-title: "flux delete image command"
----
-## flux delete image
-
-Delete image automation objects
-
-### Synopsis
-
-The delete image sub-commands delete image automation objects.
-
-### Options
-
-```
-  -h, --help   help for image
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-* [flux delete image policy](../flux_delete_image_policy/)	 - Delete an ImagePolicy object
-* [flux delete image repository](../flux_delete_image_repository/)	 - Delete an ImageRepository object
-* [flux delete image update](../flux_delete_image_update/)	 - Delete an ImageUpdateAutomation object
-

docs/cmd/flux_delete_image_policy.md

@@ -1,43 +0,0 @@
----
-title: "flux delete image policy command"
----
-## flux delete image policy
-
-Delete an ImagePolicy object
-
-### Synopsis
-
-The delete image policy command deletes the given ImagePolicy from the cluster.
-
-```
-flux delete image policy [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete an image policy
-  flux delete image policy alpine3.x
-```
-
-### Options
-
-```
-  -h, --help   help for policy
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete image](../flux_delete_image/)	 - Delete image automation objects
-

docs/cmd/flux_delete_image_repository.md

@@ -1,43 +0,0 @@
----
-title: "flux delete image repository command"
----
-## flux delete image repository
-
-Delete an ImageRepository object
-
-### Synopsis
-
-The delete image repository command deletes the given ImageRepository from the cluster.
-
-```
-flux delete image repository [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete an image repository
-  flux delete image repository alpine
-```
-
-### Options
-
-```
-  -h, --help   help for repository
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete image](../flux_delete_image/)	 - Delete image automation objects
-

docs/cmd/flux_delete_image_update.md

@@ -1,43 +0,0 @@
----
-title: "flux delete image update command"
----
-## flux delete image update
-
-Delete an ImageUpdateAutomation object
-
-### Synopsis
-
-The delete image update command deletes the given ImageUpdateAutomation from the cluster.
-
-```
-flux delete image update [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete an image update automation
-  flux delete image update latest-images
-```
-
-### Options
-
-```
-  -h, --help   help for update
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete image](../flux_delete_image/)	 - Delete image automation objects
-

docs/cmd/flux_delete_kustomization.md

@@ -1,43 +0,0 @@
----
-title: "flux delete kustomization command"
----
-## flux delete kustomization
-
-Delete a Kustomization resource
-
-### Synopsis
-
-The delete kustomization command deletes the given Kustomization from the cluster.
-
-```
-flux delete kustomization [name] [flags]
-```
-
-### Examples
-
-```
-  # Delete a kustomization and the Kubernetes resources created by it
-  flux delete kustomization podinfo
-```
-
-### Options
-
-```
-  -h, --help   help for kustomization
-```
-
-### Options inherited from parent commands
-
-```
-      --context string      kubernetes context to use
-      --kubeconfig string   absolute path to the kubeconfig file
-  -n, --namespace string    the namespace scope for this operation (default "flux-system")
-  -s, --silent              delete resource without asking for confirmation
-      --timeout duration    timeout for this operation (default 5m0s)
-      --verbose             print generated objects
-```
-
-### SEE ALSO
-
-* [flux delete](../flux_delete/)	 - Delete sources and resources
-