config.toml

baseURL = "/"
title = "Flux"
enableRobotsTXT = true
enableEmoji = true

# Language configuration
contentDir = "content/en"
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = false
enableMissingTranslationPlaceholders = true

# Markup settings
# Ref: https://gohugo.io/getting-started/configuration-markup#goldmark
[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
[markup.highlight]
# See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html
style = "dracula"
[markup.parser]
autoHeadingID = true
autoHeadingIDType = "github"

# Provide .LastMod values
enableGitInfo = true

[languages]
[languages.en]
languageName = "English"
languageCode = "en-us"
time_format_default = "2006-01-02"
time_format_blog = "2006-01-02"

[[menus.main]]
name = "Blog"
url = "/blog"

[[menus.main]]
name = "Community"
url = "/community"

[[menus.main]]
identifier = "project"
name = "Project"

[[menus.main]]
name = "Code of Conduct"
parent = "project"
url = "https://github.com/fluxcd/community/blob/main/CODE_OF_CONDUCT.md"
weight = 1

[[menus.main]]
name = "Contributing"
parent = "project"
url = "/contributing"
weight = 30

[[menus.main]]
name = "Governance"
parent = "project"
url = "/governance"
weight = 40

[[menus.main]]
name = "Security"
parent = "project"
url = "/security"
weight = 50

[[menus.main]]
name = "Branding"
parent = "project"
url = "https://branding.cncf.io/projects/flux"
weight = 9999

[params]
description          = "Open and extensible continuous delivery solution for Kubernetes."
copyright            = "The Flux authors"
github_repo          = "fluxcd/flux2"
github_website_repo  = "fluxcd/website"
slack                = "https://cloud-native.slack.com/messages/flux"
twitter              = "https://twitter.com/fluxcd"
linkedin             = "https://linkedin.com/groups/8985374"
mailing_list         = "https://lists.cncf.io/g/cncf-flux-dev"
youtube              = "https://www.youtube.com/playlist?list=PLbx4FZ4kOKntmgJqaT-iJ8tn4xat150yL"
support              = "/support"
rss                  = "/blog/index.xml"
font_awesome_version = "5.9.0"

#notification = """
#"""

[params.celebration]
emoji = ""
description = ""
url = ""

[params.logos]
navbar = "flux-horizontal-white.png"
hero   = "flux-horizontal-color.png"
footer = "flux-stacked-white.png"
cncf   = "cncf-color.png"

[[params.fonts]]
name  = "Montserrat"
sizes = [300,400,600,700]
type  = "sans_serif"

# Flux hero element
[params.flux]
# title    = "Alternative title"
subtitle = """
Flux v2 will soon be generally available. It is the start of Flux as a GitOps family of projects.
Open, extensible continuous and progressive delivery solutions for Kubernetes. Powered by the GitOps Toolkit.

Now is a good time to start familiarising yourself with Flux v2.
"""

[[params.flux.buttons]]
text  = "Get started"
color = "warning"
url   = "https://toolkit.fluxcd.io/get-started/"

[[params.flux.buttons]]
text = "Learn more"
url  = "https://toolkit.fluxcd.io"

# Overview hero element
[params.overview]
title   = "Overview"
summary = """
Flux is a tool for keeping [Kubernetes](https://kubernetes.io) clusters in sync with sources of configuration
(like Git repositories), and automating updates to configuration when there is new code to deploy.
"""

## Overview features
[[params.overview.features]]
icon   = "fab fa-git-square fa-3x"
header = "Declarative"
text   = """
Describe the entire desired state of your system in [Git](https://git-scm.com). This includes apps, configuration,
dashboards, monitoring, and everything else.
"""

[[params.overview.features]]
icon   = "fas fa-robot fa-3x"
header = "Automated"
text   = """
Use [YAML](https://yaml.org) to enforce conformance to the declared system. You don't need to run
[`kubectl`](https://kubectl.docs.kubernetes.io/) because all changes are synced automatically.
"""

[[params.overview.features]]
icon   = "fas fa-code fa-3x"
header = "Auditable"
text   = """
Everything is controlled through pull requests. Your Git history provides a sequence of transactions, allowing you to
recover state from any snapshot.
"""

[[params.overview.features]]
icon   = "fas fa-drafting-compass fa-3x"
header = "Designed for Kubernetes"
text   = """
Declaratively configurable using Custom Resources, state reports in the
[object's status](https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/#object-spec-and-status)
and via [Kubernetes Events](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-application-introspection/),
and integrations with Kubernetes RBAC.
"""


[[params.overview.features]]
icon   = "fas fa-box-open fa-3x"
header = "Out-of-the-box integrations"
text   = """
Support for e.g. [Kustomize](https://kustomize.io), [Helm](https://helm.sh); GitHub, GitLab, Harbor and custom
webhooks; notifications to most team communication platforms; and many more.
"""

[[params.overview.features]]
icon   = "fas fa-cube fa-3x"
header = "Extensible"
text   = """
Easily create a continous delivery solution with only the components you need, or use the [GitOps Toolkit](#gitops-toolkit)
to extend Flux.
"""

# Resources hero element
[params.resources]
title   = "Resources"
summary = """
If you are new to Flux, you might want to check out some of the following resources to get started.
"""

## Resource items
[[params.resources.items]]
title       = "Flux v2 with GitOps Toolkit by Viktor Farcic"
description = """
In this video, Viktor Farcic from "The DevOps Toolkit Series" demos and reviews Flux v2.
"""
youtube     = "R6OeIgb7lUI"

[[params.resources.items]]
title       = "Flux v2 series by Geert Baeke"
description = """
In this series, Geert Baeke takes a deep dive in Flux v2 and the use of GitOps principles to deploy to Kubernetes.
"""
url         = "https://www.youtube.com/playlist?list=PLG9qZAczREKmCq6on_LG8D0uiHMx1h3yn"

[[params.resources.items]]
title       = "The Power of GitOps with Flux v2 and GitOps Toolkit II with Leigh Capili"
description = """
In this second demo, Leigh shows the multi-tenancy, remote cluster and dependency management capabilities of Flux.
"""
youtube     = "fC2YCxQRUwU"

[[params.resources.items]]
title       = "The Kubelist Podcast: Flux with Michael Bridgen"
description = """
Michael talks about Flux, as well as GitOps adoption and progressive delivery.
"""
url         = "https://www.heavybit.com/library/podcasts/the-kubelist-podcast/ep-5-flux-with-michael-bridgen-of-weaveworks/"

[[params.resources.items]]
title       = "Rawkode Live: Introduction to GitOps Toolkit with Stefan Prodan"
description = """
Stefan's introduction to Flux and GitOps Toolkit at Rawkode Live.
"""
youtube     = "HqTzuOBP0eY"

[[params.resources.items]]
title       = "The Power of GitOps with Flux v2 and GitOps Toolkit with Leigh Capili"
description = """
Leigh talks about getting started with Flux and GitOps Toolkit, reconciliation and observability, and the
powerful use of Prometheus and Grafana.
"""
youtube     = "0v5bjysXTL8"

[[params.resources.items]]
title       = " Introduction to GitOps and GitOps Toolkit by Stefan Prodan"
description = """
Alexis Richardson, CEO at Weaveworks and Stefan Prodan, maintainer of the Flux project introduce you to GitOps Toolkit.

Talk from Cloud Native Nordics Tech Talks.
"""
youtube     = "qQBtSkgl7tI"

[params.family]
title = "Other Flux projects"

# Toolkit hero element
[params.toolkit]
title = "GitOps Toolkit"
subtitle = """
The set of APIs and controllers that make up the runtime for Flux.
You can use the GitOps Toolkit to extend Flux, and to build your
own systems for continuous delivery.
"""
image = "building-blocks.svg"

[[params.toolkit.buttons]]
text = "Get started"
color = "dark"
url = "https://toolkit.fluxcd.io/dev-guides/source-watcher/"

[[params.toolkit.buttons]]
text = "Learn more"
url = "https://toolkit.fluxcd.io/components/"

# Flagger hero element
[params.flagger]
title = "Flagger"
subtitle = """
Kubernetes Operator for the automation of promoting canary deployments using Istio,
Linkerd, App Mesh, NGINX, Skipper, Contour, Gloo or Traefik routing for traffic
shifting, and Prometheus metrics for canary analysis.

The canary analysis can be extended with webhooks for running system
integration/acceptance tests, load tests, or any other custom validation.
"""
image = "flagger-gitops.png"

[[params.flagger.buttons]]
text = "Get started"
color = "dark"
url = "https://docs.flagger.app/"

[[params.flagger.buttons]]
text = "Learn more"
url = "https://flagger.app/"

[params.v1]
title = "Flux v1 and Helm Operator"
subtitle = """
We owe our success and good reputation as GitOps project to Flux and Helm Operator. They are the v1 iteration of our project and currently in [maintenance mode](https://github.com/fluxcd/flux/issues/3320).

We strongly advise everyone to familiarise themselves with Flux v2 and start the process of migrating.
"""
image = "logos/flux-horizontal-color.png"

[[params.v1.buttons]]
text = "Flux v1 Documentation"
color = "info"
url = "https://docs.fluxcd.io/"

[[params.v1.buttons]]
text = "Helm Operator Documentation"
color = "info"
url = "https://docs.fluxcd.io/projects/helm-operator/"



# Community hero element
[params.community]
title = "Community"
summary = """
The Flux project aspires to be the vendor-neutral home for GitOps in a Cloud Native world.<br>
What we achieved up until today is only possible because of our community.
"""

[[params.community.highlights]]
title = "GitHub Discussions"
icon = "fab fa-github"
text  = """
Join the conversation in GitHub Discussions. Everything Flux v2 related ranging from specificiations and feature planning to Show & Tell happens here.

[Join the discussion today](https://github.com/fluxcd/toolkit/discussions)!
"""

[[params.community.highlights]]
title = "Slack"
titleBgColor = "slack-green"
icon = "fab fa-slack"
text  = """
If you want to talk to the Flux team and community in real-time, join us on Slack. This is a great way to get to know everyone.

[Get an invite](https://slack.cnfc.io), or [go to the `#flux` channel](https://cloud-native.slack.com/messages/flux)
"""

[[params.community.highlights]]
title = "Mailing list"
titleBgColor = "info"
icon = "far fa-paper-plane"
text  = """
Join our (low-traffic) mailing list to stay up to day on announcements and sporadic discussions.

[Join the mailing list](https://lists.cncf.io/g/cncf-flux-dev)!
"""