mirror of https://github.com/YuzuZensai/netbird-kubernetes-operator.git synced 2026-09-13 10:49:15 +00:00

T

Philip LaineandGitHub c5eaa832d3 Fix noisy reconcile errors (#275 )

Certain errors are better ignored to instead rely on the child resource
to trigger a new reconcile.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Bug Fixes**
* Enhanced error handling in group resolution to prevent silent failures
and ensure proper error notification
* Improved system resilience by gracefully handling missing or
unavailable Kubernetes resources without triggering reconciliation
failures
* Optimized setup key processing workflow to enhance overall system
robustness and reliability

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/netbirdio/kubernetes-operator/pull/275?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

<!-- review_stack_entry_end -->

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

2026-05-29 09:58:14 +02:00

.github

Bump the github-actions group with 3 updates (#271 )

2026-05-25 09:55:54 +02:00

api

Add AllowExtraDnsLabels to setupKey CRD (#277 )

2026-05-27 18:45:07 +02:00

charts/netbird-operator

Add AllowExtraDnsLabels to setupKey CRD (#277 )

2026-05-27 18:45:07 +02:00

cmd

Verify management url correct format (#254 )

2026-05-14 15:27:42 +02:00

config/crd

Add AllowExtraDnsLabels to setupKey CRD (#277 )

2026-05-27 18:45:07 +02:00

docs

Add AllowExtraDnsLabels to setupKey CRD (#277 )

2026-05-27 18:45:07 +02:00

examples

Rename Helm chart and Docker image and move to GHCR (#233 )

2026-05-06 12:26:32 +02:00

hack

Fix SPDX license header (#231 )

2026-05-05 12:59:36 +02:00

internal

Fix noisy reconcile errors (#275 )

2026-05-29 09:58:14 +02:00

pkg/applyconfigurations

Add AllowExtraDnsLabels to setupKey CRD (#277 )

2026-05-27 18:45:07 +02:00

test/e2e

Bump github.com/go-openapi/testify/v2 from 2.5.0 to 2.5.1 in /test/e2e in the gomod-e2e group across 1 directory (#273 )

2026-05-25 09:56:35 +02:00

.dockerignore

Refactor Dockerfile to build Go binary outside of Docker (#218 )

2026-05-04 14:44:10 +02:00

.gitignore

Add initial version with help and admission controller (#1 )

2025-01-29 22:44:09 +01:00

.golangci.yml

Add build version to NetBird client user agent. (#248 )

2026-05-13 12:43:46 +02:00

CONTRIBUTOR_LICENSE_AGREEMENT.md

Add CLA (#15 )

2025-03-19 15:12:18 +01:00

Dockerfile

Rename Helm chart and Docker image and move to GHCR (#233 )

2026-05-06 12:26:32 +02:00

go.mod

Bump github.com/netbirdio/netbird from 0.71.2 to 0.71.4 (#272 )

2026-05-26 16:34:02 +02:00

go.sum

Bump github.com/netbirdio/netbird from 0.71.2 to 0.71.4 (#272 )

2026-05-26 16:34:02 +02:00

LICENSE

Initial commit

2025-01-24 13:01:03 +01:00

Makefile

Fix incorrect arch build for ARM64 in multiarch images (#252 )

2026-05-13 14:02:51 +02:00

PROJECT

Add sidecar profile (#192 )

2026-04-23 19:17:53 +02:00

README.md

Move docs to NetBird documentation website. (#247 )

2026-05-13 12:43:27 +02:00

README.md

NetBird Kubernetes Operator

The NetBird Kubernetes Operator automates the provisioning of NetBird network access for services running in your cluster. It extends the Kubernetes API with CRDs, letting you manage NetBird peers, routes, and groups declaratively, the same way you manage the rest of your infrastructure.

Features

Declarative peer management - define NetBird peers as Kubernetes resources and let the operator handle provisioning and lifecycle
Automatic secret management - setup keys and credentials are stored and rotated as Kubernetes secrets
Namespace-scoped or cluster-wide - deploy per-namespace for multi-tenant clusters or cluster-wide for full coverage
Works with any NetBird deployment - compatible with NetBird Cloud and self-hosted instances

Getting Started

For full setup instructions, see the Getting Started documentation.

Once your secret is configured, install the operator with Helm.

helm upgrade --install --create-namespace -n netbird netbird-operator oci://ghcr.io/netbirdio/helm-charts/netbird-operator

API

Kind	API Version
Group	`netbird.io/v1alpha1`
NetworkResource	`netbird.io/v1alpha1`
NetworkRouter	`netbird.io/v1alpha1`
SetupKey	`netbird.io/v1alpha1`
SidecarProfile	`netbird.io/v1alpha1`