Skip to main content
Version: v0.22

Gardener Extension for ONTAP Documentation

Technical background documentation for the extension, ONTAP, and their integration into metal-stack.

These pages supplement the concise project overview and development instructions in the repository README. They can be read independently as topic-based reference material.

Topics​

TopicContentStart here
NetApp ONTAPONTAP concepts, HA pairs, MetroCluster, SVMs, aggregates, LIFs, NVMe/TCP, Trident, and the PVC data path./././ontap-storage.md
Gardener Extension for ONTAPActivation, inputs, reconciliation, SVM and credential lifecycle, ManagedResources, shoot webhook, and cleanup boundaries./././gardener-extension-ontap.md

I want to understand the storage architecture​

  1. ONTAP Storage — from the physical MetroCluster to a project-specific SVM
  2. Gardener Extension for ONTAP — how the architecture is automated for a shoot cluster

I am investigating a provisioning failure​

  1. Gardener Extension for ONTAP: Reconciliation
  2. Gardener Extension for ONTAP: State Inspection
  3. ONTAP Storage: Management and Data Paths

I am investigating a mount or I/O failure​

  1. ONTAP Storage: From a PVC to a Volume
  2. ONTAP Storage: Management and Data Paths
  3. Gardener Extension for ONTAP: Shoot Webhook

I am planning maintenance or cleanup​

  1. ONTAP Storage: Failure Behavior
  2. Gardener Extension for ONTAP: Delete Lifecycle

System Overview​

Provisioning and data paths from cluster creation to an ONTAP volume

The components have distinct responsibilities:

ComponentResponsibility
Cloud API / Metal APIDetects the ONTAP-enabled cluster configuration and reserves project-specific LIF addresses.
Gardener extensionEstablishes the desired ONTAP and shoot state.
ONTAP MetroClusterStores and replicates data and provides SVMs and network endpoints.
TridentTranslates Kubernetes storage operations into ONTAP operations.
Kubernetes workerConnects the remote block device over NVMe/TCP and mounts it into the workload.

Documentation Structure​

gardener-extension-ontap.md documents the behavior of this repository and links to the relevant source paths. ontap-storage.md describes the wider platform and storage context in which the extension operates.