Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Kubernetes: Is it possible to mutate the status subresources in the mutation admission webhooks?

I am writing the mutate and validate admission webhooks for the CRDs. I am using kubebuilder to setup the CRDs. Spec and status subresources are behaving correctly.

As a part of mutation, I am having a requirement where I need to update the status subresources.

For example, Exam is my CR and status.status is the Exam status. I want to set the status to "NotDone" in mutation.

I tried following approaches

  1. Json patching approach explained here https://banzaicloud.com/blog/k8s-admission-webhooks/ This gives error that the custom resource not found. i.e. it expects the custom resource for which we are updating the status.
  2. Get and update status using go client https://book-v1.book.kubebuilder.io/basics/status_subresource.html

but none of the approach worked for me.

I am wondering if it is even possible to update the status subresources in the admission webhooks?

like image 689
Yudi Avatar asked Sep 03 '25 09:09

Yudi


1 Answers

When a Custom Resource Definition (CRD) set in .spec.versions[].subresources a subresource the mutating and validating admission webhooks has to include in the .webhooks[].rules[].resources both <custom resource name> and <custom resource name>/<subresource name> values in order to mutate and validate both the resource and the subresource.

For example for a test CRD:

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: test.test
spec:
  group: test
  scope: Namespaced
  names:
    kind: Test
    listKind: TestList
    plural: tests
    singular: test
    shortNames:
      - tst
  versions:
    - name: v1
      served: true
      storage: true
      subresources:
        status: { }

You will have to define a mutating admission webhook like so:

apiVersion: admissionregistration.k8s.io/v1
kind: MutatingWebhookConfiguration
metadata:
  name: test
webhooks:
  - name: test
    sideEffects: None
    rules:
      - operations: ["CREATE", "UPDATE"]
        apiGroups: ["test"]
        apiVersions: ["*"]
        resources: ["test", "test/status"]
    failurePolicy: Fail
    clientConfig:
      service:
        namespace: test
        name: test
        path: '/test'
      caBundle: <the certificate in base64>
    admissionReviewVersions: ["v1"]

Similar for the validating admission webhook:

apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingWebhookConfiguration
metadata:
  name: test
webhooks:
  - name: test
    sideEffects: None
    rules:
      - operations: ["CREATE", "UPDATE"]
        apiGroups: ["test"]
        apiVersions: ["*"]
        resources: ["test", "test/status"]
    failurePolicy: Fail
    clientConfig:
      service:
        namespace: test
        name: test
        path: '/test'
      caBundle: <the certificate in base64>
    admissionReviewVersions: ["v1"]

The mutating and validating webhook in this example will then be called twice on creation. First time for the resource and second time for the subresource. You can figure out in the request if the call is for the resource or the subresource by reading the field .request.subResource. It will be empty for the resource and it will contain the subresource name for the subresource. This is important for validation since mutation on the subresource will only be available when the webhook is called for the subresource.

It is very important to note here that the mutating and validating webhook for the subresource will not be called synchronously during the creation of the custom resource. Instead they are called asynchronously after the custom resource has been created so that a failing validation of the subresource will not block creation of the custom resource.

like image 65
teoincontatto Avatar answered Sep 04 '25 23:09

teoincontatto