Natuurlijk! Hieronder vind je een stapsgewijze gids voor het maken van een Custom Resource Definition (CRD) voor een voorraadbeheersysteem in Kubernetes, inclusief aanbevelingen, voorbeelden en best practices. --- ### 1. Algemene structuur van de CRD Een CRD bestaat uit: - `spec`: Specificatie van het resource, inclusief velden zoals voorraaditems, versies, etc. - `status`: Statusinformatie, zoals de actuele voorraadstatus. - `metadata`: Metadata zoals naam, labels, annotaties. ### 2. Resource-schema en validatiestrategieën Gebruik OpenAPI-v3 schema’s voor validatie. Voor een voorraadbeheersysteem kunnen de velden bijvoorbeeld zijn: ```yaml apiVersion: apiextensions.k8s.io/v1 kind: CustomResourceDefinition metadata: name: voorraaditems.mijnbedrijf.nl spec: group: mijnbedrijf.nl versions: - name: v1alpha1 served: true storage: true schema: openAPIV3Schema: type: object properties: apiVersion: type: string kind: type: string metadata: type: object spec: type: object properties: itemId: type: string naam: type: string hoeveelheid: type: integer minimum: 0 locatie: type: string versie: type: integer minimum: 1 required: - itemId - naam - hoeveelheid - versie status: type: object properties: voorraadStatus: type: string enum: [InVoorraad, UitVerkocht, Gereserveerd] laatsteUpdate: type: string format: date-time required: - voorraadStatus - laatsteUpdate scope: Namespaced names: plural: voorraaditems singular: voorraaditem kind: VoorraadItem shortNames: - vitem ``` **Aanbevelingen:** - Gebruik `minimum` en `enum` voor velden om datavalidatie te versterken. - Definieer verplichte velden onder `required`. - Maak onderscheid tussen `spec` (de gewenste toestand) en `status` (huidige toestand). --- ### 3. Levenscyclusbeheer en gebeurtenissen **Creëren / Bijwerken**: - Wanneer een `VoorraadItem` wordt aangemaakt of bijgewerkt, kun je controllers gebruiken om voorraadbeheerlogica te automatiseren. - Bijvoorbeeld, bij een update wordt de `status`-sectie aangepast op basis van de `hoeveelheid`. **Statusupdates**: - Gebruik Kubernetes `status`-subresources` om externe controllers toe te staan de status bij te werken zonder de specificatie te wijzigen. - Voeg in de CRD toe: ```yaml subresources: status: {} ``` **Voorbeeld voor de controller-logica**: - Detecteer levenscyclusgebeurtenissen zoals voorraadtoevoegingen, -verbruiken, of reserveringen. - Update de `status.voorraadStatus` op basis van de `hoeveelheid`. --- ### 4. Voorbeeld van een VoorraadItem resource ```yaml apiVersion: mijnbedrijf.nl/v1alpha1 kind: VoorraadItem metadata: name: example-voorraad spec: itemId: "12345" naam: "Widget" hoeveelheid: 100 locatie: "Magazijn A" versie: 1 status: voorraadStatus: InVoorraad laatsteUpdate: "2024-04-27T12:34:56Z" ``` --- ### 5. Aanbevelingen voor versiebeheer - Gebruik semantisch versiebeheer (bijv. v1alpha1, v1beta1, v1) om evolutie van de CRD te beheren. - Voeg `metadata.resourceVersion` toe om wijzigingen te kunnen volgen. - Bij grote wijzigingen, overweeg een upgrade-strategie met migratie scripts of controllers. --- ### 6. Samenvatting - Definieer een duidelijke `spec`-structuur met verplichte velden en validaties. - Implementeer `status`-subresource voor statusupdates. - Gebruik controllers voor het beheren van levenscyclusgebeurtenissen en automatische statusupdates. - Voorzie in versiebeheer door versies te specificeren in de CRD en resources. - Test je CRD uitgebreid met voorbeeldresources en controleer validaties. --- Indien je verdere hulp nodig hebt bij het schrijven van de volledige CRD YAML of het ontwikkelen van controllers, laat het gerust weten!

Zeker, ik help je graag bij het maken van een Custom Resource Definition (CRD) voor jouw voorraadbeheersysteem in Kubernetes. Hier is een complete handleiding inclusief schema, validatie en levenscyclusmanagement. ## 1. CRD Definitie met Schema ```yaml apiVersion: apiextensions.k8s.io/v1 kind: CustomResourceDefinition metadata: name: voorraaditems.voorraad.beheer.example.com spec: group: voorraad.beheer.example.com versions: - name: v1 served: true storage: true schema: openAPIV3Schema: type: object properties: spec: type: object required: - productnaam - huidigeVoorraad - minimumVoorraad properties: productnaam: type: string description: "Unieke naam van het product" maxLength: 63 beschrijving: type: string description: "Beschrijving van het product" huidigeVoorraad: type: integer description: "Huidige hoeveelheid in voorraad" minimum: 0 minimumVoorraad: type: integer description: "Minimum voorraadniveau voor herbestelling" minimum: 0 eenheid: type: string description: "Eenheid van de voorraad (stuks, kg, liter, etc.)" enum: ["stuks", "kg", "liter", "dozen", "pallets"] locatie: type: string description: "Opslaglocatie in het magazijn" categorie: type: string description: "Productcategorie" status: type: object properties: voorraadStatus: type: string enum: ["voldoende", "laag", "uitvoorraad", "besteld"] laatsteUpdate: type: string format: date-time herbestelDatum: type: string format: date-time waarschuwingen: type: array items: type: string scope: Namespaced names: plural: voorraaditems singular: voorraaditem kind: VoorraadItem shortNames: - vi ``` ## 2. Validatie en Webhook Configuratie Voor geavanceerde validatie raad ik aan een Validating Webhook te gebruiken: ```yaml apiVersion: admissionregistration.k8s.io/v1 kind: ValidatingWebhookConfiguration metadata: name: voorraad-validatie webhooks: - name: voorraad.validatie.example.com clientConfig: service: name: voorraad-webhook-service namespace: default path: /validate caBundle: <CA_BUNDLE> rules: - operations: ["CREATE", "UPDATE"] apiGroups: ["voorraad.beheer.example.com"] apiVersions: ["v1"] resources: ["voorraaditems"] admissionReviewVersions: ["v1"] sideEffects: None ``` ## 3. Voorbeeld Resource Manifest ```yaml apiVersion: voorraad.beheer.example.com/v1 kind: VoorraadItem metadata: name: laptop-dell-xps13 namespace: default labels: categorie: elektronica locatie: magazijn-a spec: productnaam: "Dell XPS 13 Laptop" beschrijving: "High-performance business laptop" huidigeVoorraad: 15 minimumVoorraad: 5 eenheid: "stuks" locatie: "Rack A-12" categorie: "laptops" status: voorraadStatus: "voldoende" laatsteUpdate: "2024-01-15T10:30:00Z" waarschuwingen: [] ``` ## 4. Operator Implementatie (Python voorbeeld) ```python from kubernetes import client, config, watch from kubernetes.client.rest import ApiException import logging from datetime import datetime class VoorraadOperator: def __init__(self): config.load_incluster_config() self.api = client.CustomObjectsApi() self.core_api = client.CoreV1Api() def calculate_stock_status(self, current, minimum): if current == 0: return "uitvoorraad" elif current <= minimum: return "laag" elif current <= minimum * 2: return "besteld" else: return "voldoende" def update_status(self, name, namespace, status_data): try: # Patch de status self.api.patch_namespaced_custom_object_status( group="voorraad.beheer.example.com", version="v1", namespace=namespace, plural="voorraaditems", name=name, body={"status": status_data} ) logging.info(f"Status bijgewerkt voor {name}") except ApiException as e: logging.error(f"Fout bij status update: {e}") def handle_voorraad_event(self, event): item = event['object'] name = item['metadata']['name'] namespace = item['metadata']['namespace'] spec = item.get('spec', {}) current_stock = spec.get('huidigeVoorraad', 0) min_stock = spec.get('minimumVoorraad', 0) # Bereken nieuwe status stock_status = self.calculate_stock_status(current_stock, min_stock) warnings = [] if stock_status == "laag": warnings.append("Voorraadniveau is laag - overweeg herbestelling") elif stock_status == "uitvoorraad": warnings.append("Product is uit voorraad - dringende actie nodig") new_status = { "voorraadStatus": stock_status, "laatsteUpdate": datetime.utcnow().isoformat() + "Z", "waarschuwingen": warnings } if current_stock <= min_stock: new_status["herbestelDatum"] = datetime.utcnow().isoformat() + "Z" self.update_status(name, namespace, new_status) def run(self): w = watch.Watch() while True: try: for event in w.stream( self.api.list_cluster_custom_object, group="voorraad.beheer.example.com", version="v1", plural="voorraaditems" ): self.handle_voorraad_event(event) except Exception as e: logging.error(f"Watch error: {e}") ``` ## 5. Geavanceerde Validatie Regels Voeg deze toe aan je CRD voor extra validatie: ```yaml # Onder spec.versions[0].schema.openAPIV3Schema spec: versions: - name: v1 schema: openAPIV3Schema: # ... bestaande schema ... x-kubernetes-validations: - rule: "self.spec.minimumVoorraad >= 0" message: "Minimum voorraad moet 0 of hoger zijn" - rule: "self.spec.huidigeVoorraad >= 0" message: "Huidige voorraad moet 0 of hoger zijn" - rule: "has(self.metadata.labels) && has(self.metadata.labels['categorie'])" message: "Categorie label is verplicht" ``` ## 6. Aanbevelingen voor Productie 1. **Versionering**: - Gebruik `v1alpha1`, `v1beta1`, `v1` voor progressive maturity - Ondersteun meerdere versies tijdens migraties 2. **Status Management**: - Gebruik conditions voor complexe status - Implementeer retry logic voor status updates 3. **Security**: - Configureer RBAC voor je operator - Gebruik network policies om webhook verkeer te beperken 4. **Monitoring**: - Exporteer metrics voor voorraadniveaus - Stel alerts in voor lage voorraad ## 7. Deployment Manifest voor Operator ```yaml apiVersion: apps/v1 kind: Deployment metadata: name: voorraad-operator spec: replicas: 1 selector: matchLabels: app: voorraad-operator template: metadata: labels: app: voorraad-operator spec: serviceAccountName: voorraad-operator containers: - name: operator image: your-registry/voorraad-operator:v1.0.0 env: - name: WATCH_NAMESPACE value: "" ``` Deze CRD biedt een solide basis voor je voorraadbeheersysteem met goede validatie, status tracking en uitbreidingsmogelijkheden voor toekomstige requirements.