Giter VIP home page Giter VIP logo

package-for-flux's Introduction

Flux

Test Workflow Release Workflow The SLSA Level 3 badge The Apache 2.0 license badge Follow us on Twitter

A Carvel package for Flux, a continuous deployment solution for Kubernetes powered by the GitOps Toolkit.

๐Ÿš€ย  Getting Started

Prerequisites

  • Kubernetes 1.28+

  • Carvel kctrl CLI.

  • Carvel kapp-controller deployed in your Kubernetes cluster. You can install it with Carvel kapp (recommended choice) or kubectl.

    kapp deploy -a kapp-controller -y \
      -f https://github.com/carvel-dev/kapp-controller/releases/latest/download/release.yml

Installation

Add the Kadras package repository to your Kubernetes cluster:

kctrl package repository add -r kadras-packages \
  --url ghcr.io/kadras-io/kadras-packages \
  -n kadras-system --create-namespace
Installation without package repository The recommended way of installing the Flux package is via the Kadras package repository. If you prefer not using the repository, you can add the package definition directly using kapp or kubectl.
kubectl create namespace kadras-system
kapp deploy -a flux-package -n kadras-system -y \
  -f https://github.com/kadras-io/package-for-flux/releases/latest/download/metadata.yml \
  -f https://github.com/kadras-io/package-for-flux/releases/latest/download/package.yml

Install the Flux package:

kctrl package install -i flux \
  -p flux.packages.kadras.io \
  -v ${VERSION} \
  -n kadras-system

Note You can find the ${VERSION} value by retrieving the list of package versions available in the Kadras package repository installed on your cluster.

kctrl package available list -p flux.packages.kadras.io -n kadras-system

Verify the installed packages and their status:

kctrl package installed list -n kadras-system

๐Ÿ“™ย  Documentation

Documentation, tutorials and examples for this package are available in the docs folder. For documentation specific to Flux, check out fluxcd.io.

๐ŸŽฏย  Configuration

The Flux package can be customized via a values.yml file.

components:
  kustomize_controller: true
  helm_controller: true
  notification_controller: true
  image_automation_controller: false
  image_reflector_controller: false

Reference the values.yml file from the kctrl command when installing or upgrading the package.

kctrl package install -i flux \
  -p flux.packages.kadras.io \
  -v ${VERSION} \
  -n kadras-system \
  --values-file values.yml

Values

The Flux package has the following configurable properties.

Configurable properties
Config Default Description
optional_components.kustomize_controller true Whether to deploy the Kustomize Controller.
optional_components.helm_controller false Whether to deploy the Helm Controller.
optional_components.notification_controller false Whether to deploy the Notification Controller.
optional_components.image_automation_controller false Whether to deploy the Image Automation Controller.
optional_components.image_reflector_controller false Whether to deploy the Image Reflector Controller.
policies.include false Whether to include the out-of-the-box Kyverno policies to validate and secure the package installation.

Settings for logging.

Config Default Description
logging.level info Log verbosity level. Options: trace, debug, info, error.
logging.encoding json Log encoding format. Options: console, json.

Settings for the corporate proxy.

Config Default Description
proxy.https_proxy "" The HTTPS proxy to use for network traffic.
proxy.http_proxy "" The HTTP proxy to use for network traffic.
proxy.no_proxy "" A comma-separated list of hostnames, IP addresses, or IP ranges in CIDR format that should not use the proxy.

๐Ÿ›ก๏ธย  Security

The security process for reporting vulnerabilities is described in SECURITY.md.

๐Ÿ–Š๏ธย  License

This project is licensed under the Apache License 2.0. See LICENSE for more information.

package-for-flux's People

Contributors

thomasvitale avatar

Watchers

 avatar

package-for-flux's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.