Kubernetes C# Client

The Kubernetes C# Client provides a generic mechanism to create, get, list, and delete custom resources. This allows you to interact with any resource defined by a CRD without needing pre-generated strongly-typed classes for every specific custom type.

Typical workflow:

1. Initialize configuration via BuildConfigFromConfigFile().
2. Use the generic client to perform CRUD operations on the custom resource group (e.g., customresources.csharp.com).
3. Access the Spec and Labels of the retrieved resource.

Before interacting with custom resources via the client, you must ensure the Custom Resource Definition (CRD) is registered in your Kubernetes cluster.

1. Create the CRD using kubectl:

kubectl create -f ./config/crd.yaml

2. Verify the CRD exists by creating an instance and checking the resource type:

kubectl create -f ./config/yaml-cr-instance.yaml
kubectl get customresources.csharp.com

To use the Kubernetes C# Client library, add the KubernetesClient NuGet package to your project using the dotnet CLI.

dotnet add package KubernetesClient

To use the Kubernetes C# client in your project, add the KubernetesClient NuGet package using the dotnet CLI.

dotnet add package KubernetesClient

If you encounter an authentication provider that is not yet supported by BuildConfigFromConfigFile, you can use kubectl proxy as a workaround.

1. Start the proxy locally:

   kubectl proxy

2. Configure the client to point to the local proxy host (usually http://127.0.0.1:8001):

   var config = new KubernetesClientConfiguration { Host = "http://127.0.0.1:8001" };
   var client = new Kubernetes(config);

   Note: This is a workaround and is not recommended for production use.

Use the API groups (e.g., CoreV1) to list resources. For example, you can iterate through all namespaces and then list the pods within each namespace.

var namespaces = client.CoreV1.ListNamespace();
foreach (var ns in namespaces.Items) {
    Console.WriteLine(ns.Metadata.Name);
    var list = client.CoreV1.ListNamespacedPod(ns.Metadata.Name);
    foreach (var item in list.Items)
    {
        Console.WriteLine(item.Metadata.Name);
    }
}

You can create and delete resources by passing the appropriate model objects (like V1Namespace) to the corresponding API methods.

var ns = new V1Namespace
{
    Metadata = new V1ObjectMeta
    {
        Name = "test"
    }
};

var result = client.CoreV1.CreateNamespace(ns);
Console.WriteLine(result);

var status = client.CoreV1.DeleteNamespace(ns.Metadata.Name, new V1DeleteOptions());