Trident

Storage Orchestrator for Containers

Introduction

• What is Trident?

Kubernetes

• Trident for Kubernetes
  • Deploying
    • Before you begin
    • 1: Qualify your Kubernetes cluster
    • 2: Download & extract the installer
    • 3: Configure the installer
    • 4: Install Trident
      • Customized Installation
    • 5: Verify your first backend
    • 6: Add your first storage class
    • 7: Provision your first volume
    • 8: Mount the volume in a pod
  • Common tasks
    • Managing Trident
      • Installing Trident
      • Updating Trident
      • Uninstalling Trident
    • Worker preparation
      • NFS
      • iSCSI
    • Backend configuration
      • Cloud Volumes Service for AWS
        • Preparation
        • Backend configuration options
        • Virtual storage pools
        • Example configurations
      • Element (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
          • ontap-san
        • Backend configuration options
        • Example configuration
        • 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
      • Resizing an NFS volume
      • Importing a volume
      • Behavior of Drivers for Volume Import
  • Production considerations
    • etcd
      • Trident’s use of etcd
      • Using an external etcd cluster
      • Building your own etcd cluster
        • Installing
        • Testing
        • Uninstalling
  • Concepts
    • Kubernetes and Trident objects
      • Object overview
      • Kubernetes PersistentVolumeClaim objects
      • Kubernetes PersistentVolume objects
      • Kubernetes StorageClass objects
      • Trident StorageClass objects
      • Trident Backend objects
      • Trident StoragePool objects
      • Trident Volume objects
    • How does provisioning work?
  • Known issues
  • Troubleshooting
  • CSI Trident for Kubernetes
    • CSI overview
    • CSI Trident
      • Installing CSI Trident
      • Using CSI Trident
      • Uninstalling CSI Trident
• 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.4. NetApp HCI
    • 3.5. SANtricity
    • 3.6. Cloud Volumes Service for AWS
  • 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 the Trident user
      • 6.1.4. Create and use an SVM QoS policy
      • 6.1.5. Limit storage resource access to Kubernetes cluster members
      • 6.1.6. Create an export policy
      • 6.1.7. Disable showmount for the application SVM
      • 6.1.8. Use NFSv4 for Trident’s etcd when possible
    • 6.2. Best practices for configuring SolidFire
    • 6.3. Best practices for configuring E-Series
    • 6.4. Best practices for configuring Cloud Volumes Service
  • 7. Deploying Trident
    • 7.1. Supported Kubernetes cluster architectures
    • 7.2. Trident installation modes
    • 7.3. Trident CSI installation
    • 7.4. Trident Installation on Docker UCP 3.1
    • 7.5. Trident Installation on NetApp Kubernetes Service
    • 7.6. Recommendations for all deployments
      • 7.6.1. Deploy Trident to a dedicated namespace
      • 7.6.2. Use quotas and range limits to control storage consumption
    • 7.7. Deploying Trident to OpenShift
      • 7.7.1. Deploy Trident to infrastructure nodes
  • 8. Integrating Trident
    • 8.1. Trident backend design
      • 8.1.1. ONTAP
      • 8.1.2. SolidFire Backend Driver
      • 8.1.3. SANtricity (E-Series)
      • 8.1.4. Cloud Volumes Service with AWS 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. PVC characteristics which affect storage provisioning
      • 8.3.1. Access mode
    • 8.4. Modifying persistent volumes
      • 8.4.1. Volume move operations
      • 8.4.2. Expanding volumes with ONTAP
    • 8.5. When to manually provision a volume instead of using Trident
    • 8.6. Import an existing volume into Kubernetes
    • 8.7. Deploying OpenShift services using Trident
      • 8.7.1. Registry service
      • 8.7.2. Logging service
      • 8.7.3. Metrics service
  • 9. Backup and Disaster Recovery
    • 9.1. ONTAP Snapshots
      • 9.1.1. Using ONTAP snapshots with containers
      • 9.1.2. Accessing the snapshot directory
      • 9.1.3. Restoring the snapshots
    • 9.2. SolidFire snapshots
    • 9.3. Trident etcd snapshots using etcdctl command line utility
      • 9.3.1. etcdctl snapshot backup
      • 9.3.2. etcdctl snapshot restore
    • 9.4. Data replication using ONTAP
      • 9.4.1. ONTAP SnapMirror SVM Replication
      • 9.4.2. ONTAP SnapMirror SVM Replication Setup
      • 9.4.3. SnapMirror SVM Disaster Recovery Workflow for Trident
      • 9.4.4. ONTAP SnapMirror Volume Replication
      • 9.4.5. ONTAP SnapMirror Volume Replication Setup
      • 9.4.6. SnapMirror Volume Disaster Recovery Workflow for Trident
  • 10. Security Recommendations
    • 10.1. Run Trident in its own namespace
    • 10.2. etcd container
    • 10.3. CHAP authentication
    • 10.4. Storage backend credentials
      • 10.4.1. Delete backend config files
      • 10.4.2. Encrypt Trident etcd Volume

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
    • 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
    • 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
        • SolidFire Volume Options
          • Other SolidFire Create Options
        • E-Series Volume Options
          • Media Type
          • File System Type
        • Cloud Volumes Service (CVS) on AWS 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)
  • Supported host operating systems
  • Host configuration
  • Storage system configuration
  • External etcd cluster (Optional)
• Getting help

Reference

• trident
  • Logging
  • Persistence
  • Kubernetes
  • Docker
  • REST
• tridentctl
  • create
  • delete
  • get
  • import volume
  • install
  • logs
  • uninstall
  • update
  • version
• REST API
• Simple Kubernetes install
  • Prerequisites
  • Install Docker CE 17.03
  • Install the appropriate version of kubeadm, kubectl and kubelet
  • Configure the host
  • Create the cluster
  • Install the kubectl creds and untaint the cluster
  • Add an overlay network
  • Verify that all of the services started