feat: update DatadogAgent CRD v2alpha1 to operator v1.21.0 with CSI support

[ryanfarisco]

Update DatadogAgent CRD v2alpha1 to Datadog Operator v1.21.0

Summary

This PR updates the DatadogAgent Custom Resource Definition (CRD) schema for version v2alpha1 to match the latest stable release v1.21.0 of the Datadog Operator (released December 17, 2025).

Version Details

• Current version in catalog: Last updated September 2024 (labeled as "2.10.0")
• Updating to: Datadog Operator v1.21.0 (latest stable release)
• Source: https://github.com/DataDog/datadog-operator/releases/tag/v1.21.0

Key Improvements

1. CSI Driver Support ✨

The CSI (Container Storage Interface) driver configuration is now included under spec.global.csi:

• Enables Unix Domain Socket volume support
• Provides ~10x lower latency than TCP/UDP connections
• Improves security by eliminating network port exposure

2. Added 1,740 Field Descriptions 📝

The original schema in the catalog had zero field descriptions. This update adds comprehensive descriptions for all fields, dramatically improving the developer experience when using validation tools or IDE integrations.

3. Complete Feature Set 🚀

Updates the schema to include all features from Datadog Operator v1.21.0, ensuring full compatibility with current deployments.

Method

Following the repository guidelines, this update was performed using the CRD Extractor utility:

# Download CRD from v1.21.0 release
curl -s https://raw.githubusercontent.com/DataDog/datadog-operator/v1.21.0/config/crd/bases/v1/datadoghq.com_datadogagents.yaml -o datadog-crd-v1.21.0.yaml

# Convert using openapi2jsonschema.py utility
python3 openapi2jsonschema.py datadog-crd-v1.21.0.yaml

Usage Example

With this update, users can now:

Configure CSI driver:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    csi:
      enabled: true

Mount Datadog sockets via CSI:

volumes:
- name: datadog-sockets
  csi:
    driver: csi.datadog.com
    volumeAttributes:
      socket: "all"  # Options: "dsd", "apm", or "all"

Statistics

• Target version: Datadog Operator v1.21.0
• Added descriptions: 1,740 (from 0)
• Total changes: 2,137 additions, 3 deletions
• File size: 309KB → 653KB (with descriptions)

Testing

• Schema extracted using the official openapi2jsonschema.py utility
• JSON schema validates correctly
• CSI configuration is present under spec.global.csi
• Field descriptions are properly included

Notes

• This update brings the DatadogAgent CRD to full parity with Datadog Operator v1.21.0
• Fixes issue datadogagent schemas missing otlp.logs.enabled attribute #622 (missing OTLP configuration)
• All changes are backward compatible (only adds optional fields)
• If file size is a concern, I can provide a version without descriptions (336KB)

[ryanfarisco]

Note on Descriptions

I noticed the original DatadogAgent CRDs (v1alpha1 and v2alpha1) were the only ones in the datadoghq.com namespace without field descriptions, while other Datadog CRDs have them.

The extracted version includes descriptions which doubles the file size (309K → 653K). I can provide a version without descriptions if preferred (would be 336K).

My analysis shows:

• ~95% of CRDs in this catalog include descriptions
• All other Datadog CRDs have descriptions
• The descriptions significantly improve developer experience

Please let me know if you'd prefer the version without descriptions.

[ryanfarisco]

Version Information

Current version in catalog: Claims to be from "2.10.0" (last updated September 2024)

Updating to: Latest from Datadog Operator main branch (commit 7780750, December 18, 2025)

• This includes all changes from v1.21.0 (released December 17, 2025)
• Plus additional commits toward v1.22.0

Key features added between these versions:

• CSI driver support (under spec.global.csi)
• Complete field descriptions (1,740 added)
• Many additional features and improvements from ~15 months of development

The Datadog Operator has had numerous releases since the catalog was last updated, including v1.19, v1.20, and v1.21 with significant enhancements.

[eyarz]

@ryanfarisco thanks for all the info, but I think the key detail is still missing - which (release) version are you targeting for the schema update?

[ryanfarisco]

@eyarz no problems, I've made changes to specifically update to v1.21.0, please review 🙏