mirror of
https://github.com/YuzuZensai/netbird-kubernetes-operator.git
synced 2026-09-13 10:49:15 +00:00
38f2a8cb99
Bumps [sigs.k8s.io/structured-merge-diff/v6](https://github.com/kubernetes-sigs/structured-merge-diff) from 6.3.2 to 6.4.0. <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/d56620e25cf07b2e4b592fd9a36c1763fd97066c"><code>d56620e</code></a> Merge pull request <a href="https://redirect.github.com/kubernetes-sigs/structured-merge-diff/issues/323">#323</a> from aramase/aramase/f/fix_generators_inline</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/6e51105e56a2966a75df9a1a91b6642ac27c8643"><code>6e51105</code></a> fix(value): detect inline fields structurally instead of matching ",inline" tag</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/8fd4c42aee2614581d2db098bd4974e8cb913601"><code>8fd4c42</code></a> Merge pull request <a href="https://redirect.github.com/kubernetes-sigs/structured-merge-diff/issues/312">#312</a> from alvaroaleman/unexported</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/eedc5365731c428d67da403defc8fb52b8d13a10"><code>eedc536</code></a> Merge pull request <a href="https://redirect.github.com/kubernetes-sigs/structured-merge-diff/issues/320">#320</a> from inteon/use_slices_funcs</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/ee543853b6cf69af62f089b0219771ea44af3183"><code>ee54385</code></a> Merge pull request <a href="https://redirect.github.com/kubernetes-sigs/structured-merge-diff/issues/322">#322</a> from inteon/typed_allocator</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/f0a2e6ec225fd5d50a305cdd984f676ab60410cb"><code>f0a2e6e</code></a> add benchmark for FromValue function</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/7ba0b4efa39e596a5dd4f3d21e37de4c54289f6b"><code>7ba0b4e</code></a> Merge pull request <a href="https://redirect.github.com/kubernetes-sigs/structured-merge-diff/issues/314">#314</a> from inteon/tests_add_state</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/138fc0a13636adba330a92a67970c7a3243e7561"><code>138fc0a</code></a> fully clear freed objects</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/f7fc3d8623e37f800e447e8668f9b4e2199a22b9"><code>f7fc3d8</code></a> make freelist typed</li> <li><a href="https://github.com/kubernetes-sigs/structured-merge-diff/commit/910648e439842165cfd9025e9f6993f9759100ba"><code>910648e</code></a> Code cleanup: use modern slices.BinarySearchFunc and slices.Insert where poss...</li> <li>Additional commits viewable in <a href="https://github.com/kubernetes-sigs/structured-merge-diff/compare/v6.3.2...v6.4.0">compare view</a></li> </ul> </details> <br /> [](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>
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
- Add helm repository.
helm repo add netbirdio https://netbirdio.github.io/kubernetes-operator
- (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
- 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)
- (Recommended) Create a
values.yamlfile, checkhelm show values netbirdio/kubernetes-operatorfor more info. - Install using
helm install --create-namespace -f values.yaml -n netbird netbird-operator netbirdio/kubernetes-operator. - (Recommended) Check pod status using
kubectl get pods -n netbird. - (Optional) Create an
exposed-nginx.yamlfile to create a Nginx service for testing. - (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.
- (If ingress mode is enabled) Remove all instances of
netbird.io/exposeannotation on Services. - Run
helm uninstall -n netbird netbird-operator. - 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:
- Git.
- Make.
- Go programming language.
- Docker CE.
- Kubernetes cluster (v1.16+). KIND is recommended.
- Kubebuilder.
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