YuzuZensai/netbird-kubernetes-operator
1
0
Fork 0
mirror of https://github.com/YuzuZensai/netbird-kubernetes-operator.git synced 2026-09-13 10:49:15 +00:00
Code Issues Packages Projects Releases Wiki Activity
67 Commits 1 Branch 0 Tags
55d12bfa13fff8edc65915ec0ec5e4f59bd95c22
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 55d12bfa13 Bump github.com/onsi/gomega from 1.35.1 to 1.39.1 (#136) 
Bumps [github.com/onsi/gomega](https://github.com/onsi/gomega) from
1.35.1 to 1.39.1.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/onsi/gomega/releases">github.com/onsi/gomega's
releases</a>.</em></p>
<blockquote>
<h2>v1.39.1</h2>
<h2>1.39.1</h2>
<p>Update all dependencies. This auto-updated the required version of Go
to 1.24, consistent with the fact that Go 1.23 has been out of support
for almost six months.</p>
<h2>v1.39.0</h2>
<h2>1.39.0</h2>
<h3>Features</h3>
<p>Add <code>MatchErrorStrictly</code> which only passes if
<code>errors.Is(actual, expected)</code> returns true.
<code>MatchError</code>, by contrast, will fallback to string
comparison.</p>
<h2>v1.38.3</h2>
<h2>1.38.3</h2>
<h3>Fixes</h3>
<p>make string formatitng more consistent for users who use
format.Object directly</p>
<h2>v1.38.2</h2>
<h2>1.38.2</h2>
<ul>
<li>roll back to go 1.23.0 [c404969]</li>
</ul>
<h2>v1.38.1</h2>
<h2>1.38.1</h2>
<h3>Fixes</h3>
<p>Numerous minor fixes and dependency bumps</p>
<h2>v1.38.0</h2>
<h2>1.38.0</h2>
<h3>Features</h3>
<ul>
<li>gstruct handles extra unexported fields [4ee7ed0]</li>
</ul>
<h3>Fixes</h3>
<ul>
<li>support [] in IgnoringTopFunction function signatures (<a
href="https://redirect.github.com/onsi/gomega/issues/851">#851</a>)
[36bbf72]</li>
</ul>
<h3>Maintenance</h3>
<ul>
<li>Bump golang.org/x/net from 0.40.0 to 0.41.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/846">#846</a>)
[529d408]</li>
<li>Fix typo [acd1f55]</li>
<li>Bump google.golang.org/protobuf from 1.36.5 to 1.36.6 (<a
href="https://redirect.github.com/onsi/gomega/issues/835">#835</a>)
[bae65a0]</li>
<li>Bump nokogiri from 1.18.4 to 1.18.8 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/842">#842</a>)
[8dda91f]</li>
<li>Bump golang.org/x/net from 0.39.0 to 0.40.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/843">#843</a>)
[212d812]</li>
<li>Bump github.com/onsi/ginkgo/v2 from 2.23.3 to 2.23.4 (<a
href="https://redirect.github.com/onsi/gomega/issues/839">#839</a>)
[59bd7f9]</li>
<li>Bump nokogiri from 1.18.1 to 1.18.4 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/834">#834</a>)
[328c729]</li>
<li>Bump uri from 1.0.2 to 1.0.3 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/826">#826</a>)
[9a798a1]</li>
<li>Bump golang.org/x/net from 0.37.0 to 0.39.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/841">#841</a>)
[04a72c6]</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/onsi/gomega/blob/master/CHANGELOG.md">github.com/onsi/gomega's
changelog</a>.</em></p>
<blockquote>
<h2>1.39.1</h2>
<p>Update all dependencies. This auto-updated the required version of Go
to 1.24, consistent with the fact that Go 1.23 has been out of support
for almost six months.</p>
<h2>1.39.0</h2>
<h3>Features</h3>
<p>Add <code>MatchErrorStrictly</code> which only passes if
<code>errors.Is(actual, expected)</code> returns true.
<code>MatchError</code>, by contrast, will fallback to string
comparison.</p>
<h2>1.38.3</h2>
<h3>Fixes</h3>
<p>make string formatitng more consistent for users who use
format.Object directly</p>
<h2>1.38.2</h2>
<ul>
<li>roll back to go 1.23.0 [c404969]</li>
</ul>
<h2>1.38.1</h2>
<h3>Fixes</h3>
<p>Numerous minor fixes and dependency bumps</p>
<h2>1.38.0</h2>
<h3>Features</h3>
<ul>
<li>gstruct handles extra unexported fields [4ee7ed0]</li>
</ul>
<h3>Fixes</h3>
<ul>
<li>support [] in IgnoringTopFunction function signatures (<a
href="https://redirect.github.com/onsi/gomega/issues/851">#851</a>)
[36bbf72]</li>
</ul>
<h3>Maintenance</h3>
<ul>
<li>Bump golang.org/x/net from 0.40.0 to 0.41.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/846">#846</a>)
[529d408]</li>
<li>Fix typo [acd1f55]</li>
<li>Bump google.golang.org/protobuf from 1.36.5 to 1.36.6 (<a
href="https://redirect.github.com/onsi/gomega/issues/835">#835</a>)
[bae65a0]</li>
<li>Bump nokogiri from 1.18.4 to 1.18.8 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/842">#842</a>)
[8dda91f]</li>
<li>Bump golang.org/x/net from 0.39.0 to 0.40.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/843">#843</a>)
[212d812]</li>
<li>Bump github.com/onsi/ginkgo/v2 from 2.23.3 to 2.23.4 (<a
href="https://redirect.github.com/onsi/gomega/issues/839">#839</a>)
[59bd7f9]</li>
<li>Bump nokogiri from 1.18.1 to 1.18.4 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/834">#834</a>)
[328c729]</li>
<li>Bump uri from 1.0.2 to 1.0.3 in /docs (<a
href="https://redirect.github.com/onsi/gomega/issues/826">#826</a>)
[9a798a1]</li>
<li>Bump golang.org/x/net from 0.37.0 to 0.39.0 (<a
href="https://redirect.github.com/onsi/gomega/issues/841">#841</a>)
[04a72c6]</li>
</ul>
<h2>1.37.0</h2>
<h3>Features</h3>
<ul>
<li>add To/ToNot/NotTo aliases for AsyncAssertion [5666f98]</li>
</ul>
<h2>1.36.3</h2>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/onsi/gomega/commit/1a25a36414f51967615277623eed3b85b0ca6ce8"><code>1a25a36</code></a>
v1.39.1</li>
<li><a
href="https://github.com/onsi/gomega/commit/406faee2de82aa2584ea4d76b0e2662f70ae4d2c"><code>406faee</code></a>
bump all deps</li>
<li><a
href="https://github.com/onsi/gomega/commit/49561ad293853e660030f8397b07607127e3ebb7"><code>49561ad</code></a>
v1.39.0</li>
<li><a
href="https://github.com/onsi/gomega/commit/8f7f42585ccc794dcb3a4979ac7d67e00fb070ae"><code>8f7f425</code></a>
document MatchErrorStrictly</li>
<li><a
href="https://github.com/onsi/gomega/commit/bae643da0469185d9502e8d7528da137f4c62320"><code>bae643d</code></a>
add matcher relecting errors.Is behavior</li>
<li><a
href="https://github.com/onsi/gomega/commit/a3ca2ca026268dc6acfc60a2e8393b33b428c507"><code>a3ca2ca</code></a>
v1.38.3</li>
<li><a
href="https://github.com/onsi/gomega/commit/4dada364c7635fffe6b8a6b45a7588dabd64cdf4"><code>4dada36</code></a>
fix failing have http tests</li>
<li><a
href="https://github.com/onsi/gomega/commit/d40c6917ce1a2c9299bda4b900b59d80bdefc689"><code>d40c691</code></a>
make string formatitng more consistent for users who use format.Object
directly</li>
<li><a
href="https://github.com/onsi/gomega/commit/2a37b463cac790e945d16f52c1c13a4e835511a1"><code>2a37b46</code></a>
doc: fix typos</li>
<li><a
href="https://github.com/onsi/gomega/commit/ee26170d3a0a21d5702f4164df42eb99c50221d7"><code>ee26170</code></a>
docs: fix HaveValue example</li>
<li>Additional commits viewable in <a
href="https://github.com/onsi/gomega/compare/v1.35.1...v1.39.1">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=github.com/onsi/gomega&package-manager=go_modules&previous-version=1.35.1&new-version=1.39.1)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-03-11 11:40:12 +01:00
.github
Cleanup workflows and pin action versions (#118)
2026-03-11 11:24:17 +01:00
api/v1
Add optional privileged mode to NBRoutingPeerSpec (#92)
2026-03-03 08:29:52 +01:00
cmd
Fix flaky e2e tests (#120)
2026-03-10 21:31:54 +01:00
crds
Bump chart version to 0.1.10 (#39)
2025-05-02 19:37:36 +02:00
docs
Add support for running as a init sidecar container (#99)
2026-02-11 15:20:52 +03:00
examples
Add support for running as a init sidecar container (#99)
2026-02-11 15:20:52 +03:00
hack
Add initial version with help and admission controller (#1)
2025-01-29 22:44:09 +01:00
helm
fix: rendering of protocols and ports in NBPolicy (#96)
2026-03-03 08:58:50 +01:00
internal
Update Netbird dependency and Golang version (#112)
2026-03-03 10:31:38 +01:00
manifests
Add ingress feature to controller (#5)
2025-03-06 09:57:45 +01:00
test
Fix flaky e2e tests (#120)
2026-03-10 21:31:54 +01:00
.dockerignore
Add initial version with help and admission controller (#1)
2025-01-29 22:44:09 +01:00
.gitignore
Add initial version with help and admission controller (#1)
2025-01-29 22:44:09 +01:00
.golangci.yml
Update Golang CI Lint to the latest version (#113)
2026-02-27 19:07:58 +01:00
CONTRIBUTOR_LICENSE_AGREEMENT.md
Add CLA (#15)
2025-03-19 15:12:18 +01:00
Dockerfile
Update Netbird dependency and Golang version (#112)
2026-03-03 10:31:38 +01:00
Dockerfile.kubectl
Add missing envsubst utility (#101) (#102)
2026-03-03 08:30:27 +01:00
Dockerfile.release
Add initial version with help and admission controller (#1)
2025-01-29 22:44:09 +01:00
go.mod
Bump github.com/onsi/gomega from 1.35.1 to 1.39.1 (#136)
2026-03-11 11:40:12 +01:00
go.sum
Bump github.com/onsi/gomega from 1.35.1 to 1.39.1 (#136)
2026-03-11 11:40:12 +01:00
LICENSE
Initial commit
2025-01-24 13:01:03 +01:00
Makefile
Remove goreleaser and fix helm packaging (#6)
2025-03-05 09:03:04 +01:00
PROJECT
Add ingress feature to controller (#5)
2025-03-06 09:57:45 +01:00
README.md
Add uninstallation doc to README
2025-08-08 14:14:25 +03:00

README.md

NetBird Kubernetes Operator

For easily provisioning access to Kubernetes resources using NetBird.

https://github.com/user-attachments/assets/5472a499-e63d-4301-a513-ad84cfe5ca7b

Description

This operator easily provides NetBird access on Kubernetes clusters, allowing users to access internal resources directly.

Getting Started

Prerequisites

  • (Recommended) helm version 3+
  • kubectl version v1.11.3+.
  • Access to a Kubernetes v1.11.3+ cluster.
  • (Recommended) Cert Manager.

Deployment

  1. Add helm repository.
helm repo add netbirdio https://netbirdio.github.io/kubernetes-operator
  1. (Recommended) Install cert-manager for k8s API to communicate with the NetBird operator.
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.0/cert-manager.yaml
  1. Add NetBird API token
kubectl create namespace netbird
kubectl -n netbird create secret generic netbird-mgmt-api-key --from-literal=NB_API_KEY=$(cat ~/nb-pat.secret)
  1. (Recommended) Create a values.yaml file, check helm show values netbirdio/kubernetes-operator for more info.
  2. Install using helm install --create-namespace -f values.yaml -n netbird netbird-operator netbirdio/kubernetes-operator.
  3. (Recommended) Check pod status using kubectl get pods -n netbird.
  4. (Optional) Create an exposed-nginx.yaml file to create a Nginx service for testing.
  5. (Optional) Apply the Nginx service:
kubectl apply -f exposed-nginx.yaml

Learn more about the values.yaml options here and Granting controller access to NetBird Management.

Uninstallation

Important

Most operator resources are annotated with finalizers, attempting to delete the namespace will result in hanged deletion.

  1. (If ingress mode is enabled) Remove all instances of netbird.io/expose annotation on Services.
  2. Run helm uninstall -n netbird netbird-operator.
  3. Wait for all deletion jobs to finish.

Version

We have developed and executed tests against Kubernetes v1.31, but it should work with most recent Kubernetes version.

Latest operator version: v0.1.1.

Tested against:

Distribution Test status Kubernetes Version
Google GKE Pass 1.31.5
AWS EKS Pass 1.31
Azure AKS Not tested N/A
OpenShift Not tested N/A

We would love community feedback to improve the test matrix. Please submit a PR with your test results.

Usage

Check the usage of usage.md and examples.

Contributing

Prerequisites

To be able to develop this project, you need to have the following tools installed:

Running tests

Running unit tests

make test

Running E2E tests

kind create cluster # If not already created, you can check with `kind get clusters`
make test-e2e
Reference in New Issue View Git Blame Copy Permalink
S
Description
Kubernetes operator for Netbird
Readme BSD-3-Clause
1.2 MiB
Languages
Go 97.8%
Makefile 1.2%
Go Template 0.9%
Dockerfile 0.1%