Get started with Nest

Deploy Nest to a local Kubernetes cluster and provision your first DataResource.

  1. 1. Deploy Rook-Ceph

    Nest depends on Rook-Ceph for its managed storage backend (RBD block, CephFS file, RGW object). Deploy it before provisioning any DataResources.

  2. 2. Deploy Nest (Kustomize)

    Alpha and local clusters deploy via Kustomize by default — this creates the namespace, RBAC, and all core components in one pass.

    kubectl kustomize k8s/kustomize/overlays/alpha | kubectl apply -f -
  3. 3. Deploy Nest (Helm, alternative)

    The core components also ship as an umbrella Helm chart, with standalone per-service charts (k8s/helm/nest-*) for optional services such as analytics engines and observability.

    helm dependency update k8s/helm/nest
    helm upgrade --install nest k8s/helm/nest \
      -n nest --create-namespace \
      -f k8s/helm/nest/values.yaml \
      -f k8s/helm/nest/values-alpha.yaml
  4. 4. Provision a block volume

    kubectl apply -f - <<EOF
    apiVersion: nest.penguintech.io/v1
    kind: DataResource
    metadata:
      name: my-volume
      namespace: default
    spec:
      type: pvc/block
      tenant: acme
      size:
        storage: 20Gi
    EOF
  5. 5. Verify it is ready

    kubectl wait --for=condition=Ready dataresource/my-volume --timeout=120s

More resources