Trident

Storage Orchestrator for Containers

Introduction

• What is Trident?

Kubernetes

• Trident for Kubernetes
  • Upgrading/Downgrading Trident
    • Upgrading Trident
      • Initiate the upgrade
        • Upgrading Trident on Kubernetes 1.13
        • Upgrading Trident on Kubernetes 1.14 and above
      • What happens when you upgrade
      • Next steps
      • Upgrading legacy volumes to CSI volumes
        • Things to consider when upgrading volumes
        • Example volume upgrade
    • Downgrading Trident
      • When to downgrade
      • When not to downgrade
      • How to downgrade
  • Deploying
    • Choosing the right option
      • Why should I use the Trident Operator?
        • Self-Healing
        • Updating existing installations
        • Handling Kubernetes upgrades
      • When should I use tridentctl?
    • Moving between installation methods
  • Deploying with tridentctl
    • Before you begin
    • 1: Qualify your Kubernetes cluster
    • 2: Download & extract the installer
    • 3: Install Trident
      • Installing Trident on Kubernetes 1.13
      • Installing Trident on Kubernetes 1.14 and above
      • Customized Installation
    • 4: Create and Verify your first backend
    • 5: Add your first storage class
    • 6: Provision your first volume
    • 7: Mount the volume in a pod
  • Deploying with the Trident Operator
    • Prerequisites
    • 1: Qualify your Kubernetes cluster
    • 2: Download & setup the operator
    • 3: Creating a TridentProvisioner CR and installing Trident
      • Observing the status of the operator
      • Customizing your deployment
    • 4: Creating a Trident backend
    • 5: Creating a Storage Class
    • 6: Provision your first volume
    • 7: Mount the volume in a pod
  • Common tasks
    • Managing Trident
      • Installing Trident
      • Upgrading Trident
      • Monitoring Trident
      • Uninstalling Trident
        • Uninstalling with the Trident Operator
        • Uninstalling with tridentctl
      • Downgrading Trident
    • Worker preparation
      • NFS
      • iSCSI
    • Backend configuration
      • Azure NetApp Files
        • Preparation
        • Backend configuration options
        • Example configurations
      • Cloud Volumes Service for AWS
        • Preparation
        • Backend configuration options
        • Example configurations
      • Cloud Volumes Service for GCP
        • Preparation
        • Backend configuration options
        • Example configurations
      • Element (HCI/SolidFire)
        • Preparation
        • Backend configuration options
        • Example configuration
        • Using access groups
      • ONTAP (AFF/FAS/Select/Cloud)
        • Choosing a driver
        • Preparation
          • ontap-nas, ontap-nas-economy, ontap-nas-flexgroups
            • Dynamic Export Policies with ONTAP NAS
              • Prerequisites
              • How it works
              • Updating your Kubernetes cluster configuration
              • Updating legacy backends
          • ontap-san, ontap-san-economy
            • Using CHAP with ONTAP SAN drivers
              • Configuration
              • How it works
              • Rotating credentials and updating backends
        • Backend configuration options
        • Example configurations
        • User permissions
      • SANtricity (E-Series)
        • Preparation
        • Backend configuration options
        • Example configuration
    • Managing backends
      • Creating a backend configuration
      • Creating a backend
      • Deleting a backend
      • Viewing the existing backends
      • Identifying the storage classes that will use a backend
      • Updating a backend
    • Managing storage classes
      • Designing a storage class
      • Creating a storage class
      • Deleting a storage class
      • Viewing the existing storage classes
      • Setting a default storage class
      • Identifying the Trident backends that a storage class will use
    • Managing volumes
      • On-Demand Volume Snapshots
        • Create a VolumeSnapshot
        • Create PVCs from VolumeSnapshots
      • Expanding an iSCSI volume
      • Expanding an NFS volume
      • Importing a volume
        • Behavior of Drivers for Volume Import
  • Concepts
    • Kubernetes and Trident objects
      • Object overview
      • Kubernetes PersistentVolumeClaim objects
      • Kubernetes PersistentVolume objects
      • Kubernetes StorageClass objects
      • Kubernetes VolumeSnapshotClass Objects
      • Kubernetes VolumeSnapshot Objects
      • Kubernetes VolumeSnapshotContent Objects
      • Kubernetes CustomResourceDefinition objects
      • Trident StorageClass objects
      • Trident Backend objects
      • Trident StoragePool objects
      • Trident Volume objects
      • Trident Snapshot Objects
    • How does provisioning work?
    • Virtual Storage Pools
  • Known issues
  • Troubleshooting
• Design and Architecture Guide
  • 1. Introduction
    • 1.1. Target Audience
  • 2. Concepts and Definitions
    • 2.1. Kubernetes storage concepts
      • 2.1.1. Persistent Volume Claim
      • 2.1.2. Persistent Volume
      • 2.1.3. Storage Class
    • 2.2. Kubernetes compute concepts
      • 2.2.1. Pods
      • 2.2.2. Services
      • 2.2.3. Deployments
      • 2.2.4. StatefulSets
    • 2.3. Connecting containers to storage
    • 2.4. Destroying and creating pods
    • 2.5. Container Storage Interface
  • 3. NetApp Products and Integrations with Kubernetes
    • 3.1. Trident
    • 3.2. ONTAP
      • 3.2.1. Cloud Volumes ONTAP
    • 3.3. Element OS
      • 3.3.1. NetApp HCI
    • 3.4. SANtricity
    • 3.5. Azure NetApp Files
    • 3.6. Cloud Volumes Service for AWS
    • 3.7. Cloud Volumes Service for GCP
  • 4. Kubernetes Cluster Architecture and Considerations
    • 4.1. Cluster concepts and components
    • 4.2. Cluster architectures
      • 4.2.1. Single master, compute
      • 4.2.2. Multiple master, compute
      • 4.2.3. Master, etcd, compute
      • 4.2.4. Red Hat OpenShift infrastructure architecture
    • 4.3. Choosing an architecture
  • 5. Storage for Kubernetes Infrastructure Services
    • 5.1. Persistent storage for cluster services
      • 5.1.1. etcd considerations
      • 5.1.2. logging considerations
      • 5.1.3. metrics considerations
      • 5.1.4. registry considerations
    • 5.2. Design choices and guidelines when using ONTAP
      • 5.2.1. Storage Virtual Machines
      • 5.2.2. Kubernetes cluster services
  • 6. Storage Configuration for Trident
    • 6.1. Best practices for configuring ONTAP and Cloud Volumes ONTAP
      • 6.1.1. Use SVM(s) which are dedicated to Trident
      • 6.1.2. Limit the maximum volume count
      • 6.1.3. Limit the maximum size of volumes created by Trident
      • 6.1.4. Configure Trident to use bidirectional CHAP
      • 6.1.5. Create and use an SVM QoS policy
      • 6.1.6. Limit storage resource access to Kubernetes cluster members
      • 6.1.7. Use a dedicated export policy
      • 6.1.8. Disable showmount for the application SVM
    • 6.2. Best practices for configuring SolidFire
    • 6.3. Best practices for configuring E-Series
    • 6.4. Best practices for configuring Cloud Volumes Service on AWS
  • 7. Deploying Trident
    • 7.1. Supported Kubernetes cluster architectures
    • 7.2. Trident installation modes
    • 7.3. Trident Installation on Docker UCP 3.1
    • 7.4. Deploying Trident as an enhanced CSI Provisioner
    • 7.5. CRDs for maintaining Trident’s state
      • 7.5.1. Things to keep in mind about Trident’s CRDs
    • 7.6. Trident Upgrade/Downgrade Process
      • 7.6.1. Upgrading Trident
      • 7.6.2. Downgrading Trident
    • 7.7. Recommendations for all deployments
      • 7.7.1. Deploy Trident to a dedicated namespace
      • 7.7.2. Use quotas and range limits to control storage consumption
    • 7.8. Deploying Trident to OpenShift
      • 7.8.1. Deploy Trident to infrastructure nodes (OpenShift 3.11)
  • 8. Integrating Trident
    • 8.1. Trident backend design
      • 8.1.1. ONTAP
      • 8.1.2. Element (HCI/SolidFire)
      • 8.1.3. SANtricity (E-Series)
      • 8.1.4. Azure NetApp Files Backend Driver
      • 8.1.5. Cloud Volumes Service with AWS Backend Driver
      • 8.1.6. Cloud Volumes Service with GCP Backend Driver
    • 8.2. Storage Class design
      • 8.2.1. Storage Class design for specific backend utilization
      • 8.2.2. Storage Class design to emulate QoS policies
      • 8.2.3. Storage Class Design To utilize backend based on specific features
      • 8.2.4. Storage Class Design for Virtual Storage Pools
    • 8.3. Virtual Storage Pool Design
      • 8.3.1. Design Virtual Storage Pools for emulating different Service Levels/QoS
      • 8.3.2. Design Virtual Pools for Assigning Specifc Set of Aspects
    • 8.4. PVC characteristics which affect storage provisioning
      • 8.4.1. Access mode
    • 8.5. Volume Operations
      • 8.5.1. Modifying persistent volumes
      • 8.5.2. On-Demand Volume Snapshots with Trident’s Enhanced CSI Provisioner
      • 8.5.3. Creating Volumes from Snapshots with Trident’s Enhanced CSI Provisioner
      • 8.5.4. Volume Move Operations
      • 8.5.5. Expanding volumes
      • 8.5.6. Import an existing volume into Kubernetes
    • 8.6. Deploying OpenShift services using Trident
      • 8.6.1. Registry service
      • 8.6.2. Logging service
      • 8.6.3. Metrics service
  • 9. Backup and Disaster Recovery
    • 9.1. Backing Up Kubernetes and Trident’s state
      • 9.1.1. etcdctl snapshot backup
      • 9.1.2. etcdctl snapshot restore
    • 9.2. ONTAP Snapshots
      • 9.2.1. Using ONTAP snapshots with containers
      • 9.2.2. Accessing the snapshot directory
      • 9.2.3. Restoring the snapshots
    • 9.3. Data replication using ONTAP
      • 9.3.1. ONTAP SnapMirror SVM Replication
        • 9.3.1.1. ONTAP SnapMirror SVM Replication Setup
        • 9.3.1.2. SnapMirror SVM Disaster Recovery Workflow for Trident
      • 9.3.2. ONTAP SnapMirror Volume Replication
        • 9.3.2.1. ONTAP SnapMirror Volume Replication Setup
        • 9.3.2.2. SnapMirror Volume Disaster Recovery Workflow for Trident
    • 9.4. ElementOS snapshots
  • 10. Security Recommendations
    • 10.1. Run Trident in its own namespace
    • 10.2. CHAP authentication
      • 10.2.1. CHAP with ONTAP SAN backends
      • 10.2.2. CHAP with HCI/SolidFire backends

Frequently Asked Questions

• Frequently Asked Questions
  • Trident for Kubernetes Installation
  • Trident Backend Configuration and Use
  • Trident Upgrade, Support, Licensing, and Troubleshooting

Docker

• Trident for Docker
  • Deploying
  • Host and storage configuration
    • Host Configuration
      • NFS
      • iSCSI
      • Traditional Install Method (Docker <= 1.12)
        • Starting Trident at System Startup
      • Docker Managed Plugin Method (Docker >= 1.13 / 17.03)
    • Global Configuration
    • ONTAP Configuration
      • User Permissions
      • Configuration File Options
      • Scaling Options
      • Example ONTAP Config Files
    • Element OS/SolidFire Configuration
      • Example Solidfire Config File
    • E-Series Configuration
      • Example E-Series Config File
      • E-Series Array Setup Notes
    • Cloud Volumes Service (CVS) on AWS Configuration
      • Example CVS on AWS Config File
    • Cloud Volumes Service (CVS) on GCP Configuration
      • Example CVS on GCP Config File
    • Azure NetApp Files Configuration
      • Preparation
      • Backend configuration options
      • Example Configurations
    • Multiple Instances of Trident
  • Common tasks
    • Managing Trident
      • Installing Trident
      • Updating Trident
      • Uninstalling Trident
    • Managing volumes
      • Create a Volume
      • Volume Driver CLI Options
        • ONTAP Volume Options
        • Element OS/SolidFire Volume Options
          • Other SolidFire Create Options
        • E-Series Volume Options
          • Media Type
          • File System Type
        • Cloud Volumes Service (CVS) on AWS Volume Options
        • Cloud Volumes Service (CVS) on GCP Volume Options
        • Azure NetApp Files Volume Options
      • Destroy a Volume
      • Volume Cloning
      • Access Externally Created Volumes
  • Known issues
  • Troubleshooting
    • Managed plugin method
    • Binary method

Support

• Requirements
  • Supported frontends (orchestrators)
  • Supported backends (storage)
  • Feature Requirements
  • Supported host operating systems
  • Host configuration
  • Storage system configuration
• Getting help

Reference

• trident
  • Logging
  • Kubernetes
  • Docker
  • REST
• tridentctl
  • create
  • delete
  • get
  • import volume
  • install
  • logs
  • uninstall
  • update
  • upgrade
  • version
• REST API
• Simple Kubernetes install