DDCS: Deployment#

Configuration#

First follow the DDCS: Configure to craft a values.yaml for your environment.

Deployment Steps#

1. Configure Helm#

If the chart repo nvidia/omniverse is not setup, execute the following to add the repo and update the local chart index.

To review your existing chart repositories run the following.

helm repo list

If https://helm.ngc.nvidia.com/nvidia/omniverse is not listed, run the following to setup the chart repository.

# Replace <ngc-api-key> with your org's access token or your NGC personal key with access
# to BYOC NGC repo.
helm repo add omniverse https://helm.ngc.nvidia.com/nvidia/omniverse \
    --username '$oauthtoken' \
    --password "<ngc-api-key>"

helm repo update

2. Prepare Namespace#

Create the Kubernetes namespace where the service will be deployed, if it doesn’t already exist. Skip this step if the target namespace already exists.

# Create the namespace if does not already exist.
kubectl create namespace ddcs

3. Create Required Secrets#

  • Image Pull Secret

    Create a secret to allow Kubernetes to to access the NGC registry.

    # Setup the docker-registry secret.
    # Replace <ngc-api-key> with your org's access token or your NGC personal key with access
    # to BYOC NGC repo.
    kubectl create secret docker-registry ngc-container-pull \
       --namespace ddcs \
       --docker-server=nvcr.io \
       --docker-username='$oauthtoken' \
       --docker-password=<ngc-api-key>
    

    Important

    The secret name ngc-container-pull must match the one specified in your Helm values under image.pullSecrets.

  • (Optional) TLS Secret

    If you are enabling TLS for a production deployment, follow the DDCS: TLS Configuration guide to create and configure TLS secrets.

4. Install Helm Chart#

Using the prepared values file, install the ddcs Helm chart.

helm install ddcs omniverse/ddcs \
    --namespace ddcs \
    -f values.yaml

Uninstall Instructions#

  1. Uninstall Helm Chart

    helm uninstall ddcs -n ddcs
    
  2. Remove Unused Persistent Volumes

    Orphaned Data Will Remain

    Persistent volumes created by the installation are not cleaned up by helm or Kubernetes. New/re-installations will not use pre-existing volumes.

    It is recommended to remove unused PVCs after running the uninstall steps above.

    # Remove **all** persistent volumes that are not attached to pods from the
    # given namespace.
    kubectl delete pvc --all -n ddcs
    

Summary#

This guide covered the deployment steps for DDCS, including Helm repository setup, namespace creation, secret configuration, and chart installation. After deployment, verify that DDCS pods are running and healthy in your cluster.

For detailed information on configuring DDCS settings such as memory allocation, storage sizing, and monitoring, refer to the DDCS: Configure guide.