-
Notifications
You must be signed in to change notification settings - Fork 10.4k
[bitnami/metallb] Adding the MetalLB Helm Chart. #2068
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 15 commits
Commits
Show all changes
51 commits
Select commit
Hold shift + click to select a range
8b71c2f
added objectstorageConfig to the sidecar container
Cellebyte 73dae2e
Merge branch 'master' of github.com:bitnami/charts
Cellebyte 9320720
Bumped version and added documentation of the added values.
Cellebyte 1e01619
Fixed indentation of environment variables
Cellebyte c29ff24
Rename ConfigMap to Secret and added to production-values
Cellebyte aed0b29
Fixed missing space
Cellebyte d298494
Merged upstream
Cellebyte dd14741
added the metallb chart
Cellebyte 2a63ad7
Update bitnami/metallb/Chart.yaml
Cellebyte 27cdbbe
Update bitnami/metallb/README.md
Cellebyte 767ada9
Update bitnami/metallb/templates/tests/test-connection.yaml
Cellebyte 9e982a2
Update bitnami/metallb/values.yaml
Cellebyte 9304c19
Update bitnami/metallb/values.yaml
Cellebyte 6ce2a0c
Update README.md
Cellebyte 67f34eb
Update bitnami/metallb/README.md
Cellebyte b36ec66
fixed `---`
Cellebyte f104ce4
Added templating
Cellebyte e0827e6
Fixed some bugs and added securityContext also bumped metallb appVersion
Cellebyte 7f9bcaf
Bumped versions
Cellebyte a8ab815
Added metallb templates
Cellebyte 5a3ed8d
Added metallb 0.9.2 changes to the chart
Cellebyte 3861669
Added metallb 0.9.2 changes to the chart
Cellebyte ee4b750
Added missing EOL
Cellebyte 4572be9
Fixed the appVersion
Cellebyte 38f238f
added secret autogeneration for the members to join
Cellebyte 7b86733
Bumped version accordingly to cellebyte/helm
Cellebyte 14e7d32
Fixed missing EOL
Cellebyte 968f1f9
Bumped templates to the new versiona and bumped metallb version
Cellebyte 11f3c28
Fixed some template behaviour
Cellebyte cd32f7e
Bumped chart version
Cellebyte b1b6c69
Bumped image tags to use the latest version
Cellebyte 4adf30e
Run the container as Root because the speaker needs the capability to…
Cellebyte cb92295
fixed typo and email
Cellebyte e15ed43
use bitnami images
Cellebyte f4549f1
added app.kubernetes.io/component app.kubernetes.io/app
Cellebyte ba204e9
Use nindent
Cellebyte f2f60f3
Fixed nindent and some old labels
Cellebyte db3a5d2
added more configurable options
Cellebyte 79fe7d4
Fixed nindent stuff
Cellebyte 38e6d04
Fixed trim-suffix
Cellebyte 73a3da5
added templates to handle secrets and configmaps the proper way
Cellebyte 76018ab
fixed wrong documentation
Cellebyte ba3b8ba
Fixed template executing if configInline defined
Cellebyte 5712cfa
fixed the psps
Cellebyte 1b28d68
Make psp also autogenerated
Cellebyte cf67fbe
remove one eol
Cellebyte 8ada22a
Added eol
Cellebyte 4d687a0
Added the missing doc pieces
Cellebyte faaa025
added ref for securityContext
Cellebyte bca4222
Fixed securityContext
Cellebyte de23221
added some NOTES after the deployment
Cellebyte File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| # Patterns to ignore when building packages. | ||
| # This supports shell glob matching, relative path matching, and | ||
| # negation (prefixed with !). Only one pattern per line. | ||
| .DS_Store | ||
| # Common VCS dirs | ||
| .git/ | ||
| .gitignore | ||
| .bzr/ | ||
| .bzrignore | ||
| .hg/ | ||
| .hgignore | ||
| .svn/ | ||
| # Common backup files | ||
| *.swp | ||
| *.bak | ||
| *.tmp | ||
| *~ | ||
| # Various IDEs | ||
| .project | ||
| .idea/ | ||
| *.tmproj | ||
| .vscode/ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| apiVersion: v1 | ||
| name: metallb | ||
| description: The Metal LB for Kubernetes | ||
| appVersion: 0.8.3 | ||
| keywords: | ||
| - "load-balancer" | ||
| - "balancer" | ||
| - "lb" | ||
| - "bgp" | ||
| - "arp" | ||
| - "vrrp" | ||
| - "vip" | ||
| home: https://metallb.universe.tf | ||
| icon: https://metallb.universe.tf/images/logo.png | ||
| sources: | ||
| - https://github.com/metallb/metallb | ||
| - https://github.com/bitnami/bitnami-docker-metallb | ||
| version: 0.1.3 | ||
| maintainers: | ||
| - name: cellebyte | ||
| url: https://github.com/Cellebyte | ||
| - name: Bitnami | ||
| email: containers@bitnami.com | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,141 @@ | ||
| # metallb | ||
|
Cellebyte marked this conversation as resolved.
Outdated
|
||
|
|
||
| [MetalLB](https://metallb.universe.tf/faq/) is an open source, rock solid LoadBalancer. It handles the `ServiceType: Loadbalancer`. | ||
|
|
||
| ## TL;DR; | ||
|
|
||
| ```console | ||
| $ helm repo add bitnami https://charts.bitnami.com/bitnami | ||
| $ helm install my-release bitnami/metallb | ||
| ``` | ||
|
|
||
| ## Introduction | ||
| Bitnami charts for Helm are carefully engineered, actively maintained and are the quickest and easiest way to deploy containers on a Kubernetes cluster that are ready to handle production workloads. | ||
|
|
||
| This chart bootstraps a [MetalLB Controller](https://metallb.universe.tf/community/) Controller Deployment and a [MetalLB Speaker](https://metallb.universe.tf/community/) Daemonset on a [Kubernetes](http://kubernetes.io) cluster using the [Helm](https://helm.sh) package manager. | ||
|
|
||
|
Cellebyte marked this conversation as resolved.
|
||
| Bitnami charts can be used with [Kubeapps](https://kubeapps.com/) for deployment and management of Helm Charts in clusters. This Helm chart has been tested on top of [Bitnami Kubernetes Production Runtime](https://kubeprod.io/) (BKPR). Deploy BKPR to get automated TLS certificates, logging and monitoring for your applications. | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| - Kubernetes 1.12+ | ||
| - Helm 2.11+ or Helm 3.0-beta3+ | ||
| - Virtual IPs for Layer 2 or Route Reflector for BGP setup. | ||
|
|
||
| ## Installing the Chart | ||
|
|
||
| To install the chart with the release name `my-release`: | ||
|
|
||
| ```console | ||
| $ helm repo add bitnami https://charts.bitnami.com/bitnami | ||
| $ helm install my-release bitnami/metallb | ||
| ``` | ||
|
|
||
| These commands deploy metallb on the Kubernetes cluster in the default configuration. The [Parameters](#parameters) section lists the parameters that can be configured during installation. | ||
|
|
||
| > **Tip**: List all releases using `helm list` | ||
|
|
||
| ## Uninstalling the Chart | ||
|
|
||
| To uninstall/delete the `my-release` helm release: | ||
|
|
||
| ```console | ||
| $ helm uninstall my-release | ||
| ``` | ||
|
|
||
| The command removes all the Kubernetes components associated with the chart and deletes the release. | ||
|
|
||
| ## Parameters | ||
|
|
||
| The following tables lists the configurable parameters of the metallb chart and their default values. | ||
|
|
||
| | Parameter | Description | Default | | ||
| |----------------------------------------------------|--------------------------------------------------------------------------------------------------------|---------------------------------------------------------| | ||
| | `global.imageRegistry` | Global Docker image registry | `nil` | | ||
| | `global.imagePullSecrets` | Global Docker registry secret names as an array | `[]` (does not add image pull secrets to deployed pods) | | ||
|
miguelaeh marked this conversation as resolved.
Outdated
|
||
| | `controller.image.registry` | MetalLB Controller image registry | `docker.io` | | ||
| | `controller.image.repository` | MetalLB Controller image name | `metallb/controller` | | ||
|
Cellebyte marked this conversation as resolved.
Outdated
|
||
| | `controller.image.tag` | MetalLB Controller image tag | `{TAG_NAME}` | | ||
| | `controller.pullPolicy` | MetalLB Controller image pull policy | `IfNotPresent` | | ||
| | `controller.image.pullSecrets` | Specify docker-registry secret names as an array | `[]` (does not add image pull secrets to deployed pods) | | ||
| | `controller.resources.limits` | Specify resource limits which the container is not allowed to succeed. | `{}` (does not add resource limits to deployed pods) | | ||
| | `controller.resources.requests` | Specify resource requests which the container needs to spawn. | `{}` (does not add resource limits to deployed pods) | | ||
| | `controller.nodeSelector` | Node labels for controller pod assignment | `{}` | | ||
| | `controller.tolerations` | Tolerations for controller pod assignment | `[]` | | ||
| | `controller.affinity` | Affinity for controller pod assignment | `{}` | | ||
| | `controller.podAnnotations` | Controller Pod annotations | `{}` | | ||
| | `controller.serviceAccount.create` | create a serviceAccount for the controller pod | `true` | | ||
| | `controller.serviceAccount.name` | use the serviceAccount with the specified name | "" | | ||
| | `speaker.image.registry` | MetalLB Speaker image registry | `docker.io` | | ||
| | `speaker.image.repository` | MetalLB Speaker image name | `metallb/speaker` | | ||
|
Cellebyte marked this conversation as resolved.
Outdated
|
||
| | `speaker.image.tag` | MetalLB Speaker image tag | `{TAG_NAME}` | | ||
| | `speaker.pullPolicy` | MetalLB Speaker image pull policy | `IfNotPresent` | | ||
| | `speaker.image.pullSecrets` | Specify docker-registry secret names as an array | `[]` (does not add image pull secrets to deployed pods) | | ||
| | `speaker.resources.limits` | Specify resource limits which the container is not allowed to succeed. | `{}` (does not add resource limits to deployed pods) | | ||
| | `speaker.resources.requests` | Specify resource requests which the container needs to spawn. | `{}` (does not add resource limits to deployed pods) | | ||
| | `speaker.nodeSelector` | Node labels for speaker pod assignment | `{}` | | ||
| | `speaker.tolerations` | Tolerations for speaker pod assignment | `[]` | | ||
| | `speaker.affinity` | Affinity for speaker pod assignment | `{}` | | ||
| | `speaker.podAnnotations` | Speaker Pod annotations | `{}` | | ||
| | `speaker.serviceAccount.create` | create a serviceAccount for the speaker pod | `true` | | ||
| | `speaker.serviceAccount.name` | use the serviceAccount with the specified name | "" | | ||
| | `nameOverride` | String to partially override metallb.fullname template with a string (will prepend the release name) | `nil` | | ||
| | `fullnameOverride` | String to fully override metallb.fullname template with a string | `nil` | | ||
| | `livenessProbe.enabled` | Enable/disable the Liveness probe | `true` | | ||
| | `livenessProbe.initialDelaySeconds` | Delay before liveness probe is initiated | `60` | | ||
| | `livenessProbe.periodSeconds` | How often to perform the probe | `10` | | ||
| | `livenessProbe.timeoutSeconds` | When the probe times out | `5` | | ||
| | `livenessProbe.successThreshold` | Minimum consecutive successes for the probe to be considered successful after having failed. | `1` | | ||
| | `livenessProbe.failureThreshold` | Minimum consecutive failures for the probe to be considered failed after having succeeded. | `6` | | ||
| | `existingConfigMap` | Specify an existing configMapName to use. (this mutually exclusive with existingConfigMap) | `metallb-config` | | ||
|
miguelaeh marked this conversation as resolved.
Outdated
|
||
| | `configInline` | Specify the config for metallb as a new configMap inline. | `{}` (does not create configMap) | | ||
| | `rbac.create` | Specify if an rbac authorization should be created with the necessarry Rolebindings. | `true` | | ||
| | `prometheus.serviceMonitor.enabled` | Specify if a servicemonitor will be deployed for prometheus-operator. | `true` | | ||
| | `prometheus.serviceMonitor.jobLabel` | Specify the jobLabel to use for the prometheus-operator | `metallb` | | ||
| | `prometheus.serviceMonitor.interval` | Specify the scrape interval if not specified use defaul prometheus scrapeIntervall | `""` | | ||
| | `prometheus.serviceMonitor.metricRelabelings` | Specify additional relabeling of metrics. | `[]` | | ||
| | `prometheus.serviceMonitor.relabelings` | Specify general relabeling. | `[]` | | ||
| | `prometheus.serviceMonitor.prometheusRule.enabled` | Enable prometheus alertmanager basic alerts. | `true` | | ||
|
|
||
|
Cellebyte marked this conversation as resolved.
Outdated
|
||
| Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. For example, | ||
|
|
||
| ```console | ||
| $ helm install my-release \ | ||
| --set livenessProbe.successThreshold=5 \ | ||
| bitnami/metallb | ||
| ``` | ||
| The above command sets the `livenessProbe.successThreshold` to `5`. | ||
|
|
||
| ## Configuration and installation details | ||
|
|
||
| ### [Rolling VS Immutable tags](https://docs.bitnami.com/containers/how-to/understand-rolling-tags-containers/) | ||
|
|
||
| It is strongly recommended to use immutable tags in a production environment. This ensures your deployment does not change automatically if the same tag is updated with a different image. | ||
|
|
||
| Bitnami will release a new chart updating its containers if a new version of the main container, significant changes, or critical vulnerabilities exist. | ||
|
|
||
| To configure [MetalLB](https://metallb.universe.tf) please look into the configuration section [MetalLB Configuration](https://metallb.universe.tf/configuration/). | ||
|
|
||
| ### Example Layer 2 configuration | ||
|
|
||
| ```yaml | ||
| configInline: | ||
| # The address-pools section lists the IP addresses that MetalLB is | ||
| # allowed to allocate, along with settings for how to advertise | ||
| # those addresses over BGP once assigned. You can have as many | ||
| # address pools as you want. | ||
| address-pools: | ||
| - # A name for the address pool. Services can request allocation | ||
| # from a specific address pool using this name, by listing this | ||
| # name under the 'metallb.universe.tf/address-pool' annotation. | ||
| name: generic-cluster-pool | ||
| # Protocol can be used to select how the announcement is done. | ||
| # Supported values are bgp and layer2. | ||
| protocol: layer2 | ||
| # A list of IP address ranges over which MetalLB has | ||
| # authority. You can list multiple ranges in a single pool, they | ||
| # will all share the same settings. Each range can be either a | ||
| # CIDR prefix, or an explicit start-end range of IPs. | ||
| addresses: | ||
| - 10.27.50.30-10.27.50.35 | ||
| ``` | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
|
|
||
|
Cellebyte marked this conversation as resolved.
Cellebyte marked this conversation as resolved.
|
||
| MetalLB is now running in the cluster. | ||
| {{- if .Values.configInline }} | ||
| LoadBalancer Services in your cluster are now available on the IPs you | ||
| defined in MetalLB's configuration. To see IP assignments, | ||
| try `kubectl get services`. | ||
| {{- else }} | ||
| WARNING: you specified a ConfigMap that isn't managed by | ||
| Helm. LoadBalancer services will not function until you add that | ||
| ConfigMap to your cluster yourself. | ||
| {{- end }} | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.