KubeOps.Operator
9.1.5
dotnet add package KubeOps.Operator --version 9.1.5
NuGet\Install-Package KubeOps.Operator -Version 9.1.5
<PackageReference Include="KubeOps.Operator" Version="9.1.5" />
paket add KubeOps.Operator --version 9.1.5
#r "nuget: KubeOps.Operator, 9.1.5"
// Install KubeOps.Operator as a Cake Addin #addin nuget:?package=KubeOps.Operator&version=9.1.5 // Install KubeOps.Operator as a Cake Tool #tool nuget:?package=KubeOps.Operator&version=9.1.5
KubeOps Operator
The KubeOps.Operator
package provides a framework
for building Kubernetes operators in .NET.
It is built on top of the Kubernetes client libraries for .NET
and provides a set of abstractions and utilities for implementing
operators that manage custom resources in a Kubernetes cluster.
Getting Started
To get started with the SDK, you can install it from NuGet:
dotnet add package KubeOps.Operator
Once you have installed the package, you can create entities, controllers, finalizers, and more to implement your operator.
All resources must be added to the operator builder in order to be recognized by the SDK and to be used as operator resources. The KubeOps.Generator helps with convenience methods to register everything at once.
You'll need to use the Generic Host to run your operator. However, for a plain operator without webhooks, no ASP.net is required (in contrast to v7).
using KubeOps.Operator;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
var builder = Host.CreateApplicationBuilder(args);
builder.Logging.SetMinimumLevel(LogLevel.Trace);
builder.Services
.AddKubernetesOperator()
.RegisterComponents();
using var host = builder.Build();
await host.RunAsync();
Registering Resources
When using the KubeOps.Generator,
you can use the RegisterResources
function:
builder.Services
.AddKubernetesOperator()
.RegisterComponents();
Otherwise, you can register resources manually:
builder.Services
.AddKubernetesOperator()
.AddController<TestController, V1TestEntity>()
.AddFinalizer<FirstFinalizer, V1TestEntity>("first")
.AddFinalizer<SecondFinalizer, V1TestEntity>("second")
Entity
To create an entity, you need to implement the
IKubernetesObject<V1ObjectMeta>
interface. There are convenience
classes available to help with initialization, status and spec
properties.
[KubernetesEntity(Group = "testing.dev", ApiVersion = "v1", Kind = "TestEntity")]
public class V1TestEntity :
CustomKubernetesEntity<V1TestEntity.EntitySpec, V1TestEntity.EntityStatus>
{
public override string ToString()
=> $"Test Entity ({Metadata.Name}): {Spec.Username} ({Spec.Email})";
public class EntitySpec
{
public string Username { get; set; } = string.Empty;
public string Email { get; set; } = string.Empty;
}
public class EntityStatus
{
public string Status { get; set; } = string.Empty;
}
}
Controller
A controller is the element that reconciles a specific entity. You can reconcile your own custom entities or all other entities as long as they are registered within the SDK. For a guide on how to reconcile external entities, refer to the documentation.
A simple controller could look like this:
[EntityRbac(typeof(V1TestEntity), Verbs = RbacVerb.All)]
public class V1TestEntityController : IEntityController<V1TestEntity>
{
private readonly IKubernetesClient _client;
private readonly EntityFinalizerAttacher<FinalizerOne, V1TestEntity> _finalizer1;
public V1TestEntityController(
IKubernetesClient client,
EntityFinalizerAttacher<FinalizerOne, V1TestEntity> finalizer1)
{
_client = client;
_finalizer1 = finalizer1;
}
public async Task ReconcileAsync(V1TestEntity entity)
{
_logger.LogInformation("Reconciling entity {Entity}.", entity);
entity = await _finalizer1(entity);
entity.Status.Status = "Reconciling";
entity = await _client.UpdateStatus(entity);
entity.Status.Status = "Reconciled";
await _client.UpdateStatus(entity);
}
}
This controller attaches a specific finalizer to the entity, updates its status and then saves the entity.
[!CAUTION] It is important to always use the returned values of an entity when using modifying actions of the Kubernetes client. Otherwise, you will receive "HTTP CONFLICT" errors because of the resource version field in the entity.
[!NOTE] Do not update the entity itself in the reconcile loop. It is considered bad practice to update entities while reconciling them. However, the status may be updated. To update entities before they are reconciled (e.g. to ban certain values or change values), use webhooks instead.
Finalizer
A finalizer is an element for asynchronous cleanup in Kubernetes.
It is attached with an EntityFinalizerAttacher
and is called
when the entity is marked as deleted.
public class FinalizerOne : IEntityFinalizer<V1TestEntity>
{
public Task FinalizeAsync(V1TestEntity entity)
{
return Task.CompletedTask;
}
}
[!NOTE] The controller (if you overwrote the
DeletedAsync
method) will receive the notification as soon as all finalizers are removed.
Documentation
For more information, please visit the documentation.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- KubeOps.Abstractions (>= 9.1.5)
- KubeOps.KubernetesClient (>= 9.1.5)
- KubeOps.Transpiler (>= 9.1.5)
- Microsoft.Extensions.Hosting (>= 8.0.0)
-
net7.0
- KubeOps.Abstractions (>= 9.1.5)
- KubeOps.KubernetesClient (>= 9.1.5)
- KubeOps.Transpiler (>= 9.1.5)
- Microsoft.Extensions.Hosting (>= 8.0.0)
-
net8.0
- KubeOps.Abstractions (>= 9.1.5)
- KubeOps.KubernetesClient (>= 9.1.5)
- KubeOps.Transpiler (>= 9.1.5)
- Microsoft.Extensions.Hosting (>= 8.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on KubeOps.Operator:
Package | Downloads |
---|---|
KubeOps.Operator.Web
This is an operator sdk written in c#. It enables a developer to create a custom controller for CRDs (CustomResourceDefinitions) that runs on kubernetes. This operator uses ASP.net to support webhooks and external access to the operator. |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on KubeOps.Operator:
Repository | Stars |
---|---|
josephnhtam/live-streaming-server-net
A .NET implementation of RTMP live streaming server, supporting HTTP-FLV, WebSocket-FLV, HLS, Kubernetes, cloud storage services integration and more.
|
Version | Downloads | Last updated |
---|---|---|
9.1.5 | 16,414 | 9/10/2024 |
9.1.4 | 1,137 | 8/26/2024 |
9.1.3 | 13,529 | 6/28/2024 |
9.1.2 | 8,869 | 6/20/2024 |
9.1.1 | 4,677 | 5/22/2024 |
9.1.0 | 1,968 | 5/15/2024 |
9.0.2 | 216 | 5/13/2024 |
9.0.0 | 11,700 | 3/13/2024 |
9.0.0-pre.4 | 79 | 4/19/2024 |
9.0.0-pre.3 | 65 | 3/21/2024 |
9.0.0-pre.2 | 66 | 3/13/2024 |
9.0.0-pre.1 | 74 | 3/7/2024 |
8.0.2-pre.2 | 82 | 2/21/2024 |
8.0.2-pre.1 | 61 | 2/19/2024 |
8.0.1 | 10,505 | 2/13/2024 |
8.0.1-pre.7 | 79 | 2/12/2024 |
8.0.1-pre.6 | 75 | 2/7/2024 |
8.0.1-pre.5 | 72 | 2/5/2024 |
8.0.1-pre.4 | 73 | 1/31/2024 |
8.0.1-pre.3 | 72 | 1/26/2024 |
8.0.1-pre.2 | 75 | 1/25/2024 |
8.0.1-pre.1 | 66 | 1/18/2024 |
8.0.0 | 858 | 1/17/2024 |
8.0.0-pre.45 | 66 | 1/17/2024 |
8.0.0-pre.44 | 68 | 1/16/2024 |
8.0.0-pre.43 | 68 | 1/16/2024 |
8.0.0-pre.42 | 812 | 1/10/2024 |
8.0.0-pre.41 | 299 | 1/2/2024 |
8.0.0-pre.40 | 170 | 12/27/2023 |
8.0.0-pre.39 | 77 | 12/21/2023 |
8.0.0-pre.38 | 419 | 12/6/2023 |
8.0.0-pre.37 | 140 | 12/6/2023 |
8.0.0-pre.36 | 143 | 12/3/2023 |
8.0.0-pre.35 | 106 | 11/28/2023 |
8.0.0-pre.34 | 94 | 11/24/2023 |
8.0.0-pre.33 | 76 | 11/24/2023 |
8.0.0-pre.32 | 74 | 11/23/2023 |
8.0.0-pre.31 | 79 | 11/23/2023 |
8.0.0-pre.30 | 80 | 11/23/2023 |
8.0.0-pre.29 | 483 | 11/11/2023 |
8.0.0-pre.28 | 92 | 11/8/2023 |
8.0.0-pre.27 | 582 | 10/23/2023 |
8.0.0-pre.26 | 115 | 10/19/2023 |
8.0.0-pre.25 | 82 | 10/18/2023 |
8.0.0-pre.24 | 100 | 10/13/2023 |
8.0.0-pre.23 | 84 | 10/13/2023 |
8.0.0-pre.22 | 79 | 10/13/2023 |
8.0.0-pre.21 | 86 | 10/12/2023 |
8.0.0-pre.20 | 84 | 10/11/2023 |
8.0.0-pre.19 | 85 | 10/9/2023 |
8.0.0-pre.18 | 79 | 10/9/2023 |
8.0.0-pre.17 | 78 | 10/7/2023 |
8.0.0-pre.16 | 110 | 10/6/2023 |
8.0.0-pre.15 | 77 | 10/6/2023 |
8.0.0-pre.14 | 77 | 10/5/2023 |
8.0.0-pre.13 | 76 | 10/5/2023 |
8.0.0-pre.12 | 79 | 10/4/2023 |
8.0.0-pre.11 | 80 | 10/3/2023 |
8.0.0-pre.10 | 82 | 10/3/2023 |
8.0.0-pre.9 | 80 | 10/3/2023 |
8.0.0-pre.8 | 78 | 10/2/2023 |
8.0.0-pre.7 | 78 | 10/2/2023 |
8.0.0-pre.6 | 80 | 9/29/2023 |
8.0.0-pre.5 | 76 | 9/28/2023 |
8.0.0-pre.4 | 76 | 9/28/2023 |
8.0.0-pre.3 | 75 | 9/27/2023 |
8.0.0-pre.2 | 65 | 9/26/2023 |
8.0.0-pre.1 | 75 | 9/22/2023 |
'## [9.1.5](https://github.com/buehler/dotnet-operator-sdk/compare/v9.1.4...v9.1.5) (2024-09-10)
### Bug Fixes
* Resource watcher re-connects should reset currentVersion ([#792](https://github.com/buehler/dotnet-operator-sdk/issues/792)) ([108240e](https://github.com/buehler/dotnet-operator-sdk/commit/108240e982fb6a295147a31695b79f3b4fdbbc79))
'