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
      • 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
  • 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.3. Element OS
    • 3.4. NetApp HCI
    • 3.5. SANtricity
  • 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
    • 4.4. Persistent storage for cluster services
      • 4.4.1. Etcd persistent storage
      • 4.4.2. Persistent storage for logging services
      • 4.4.3. Metrics and analytics services
  • 5. Storage for Kubernetes Infrastructure Services
    • 5.1. Persistent storage for cluster services
      • 5.1.1. etcd considerations
      • 5.1.2. logging
      • 5.1.3. metrics
      • 5.1.4. registry
    • 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
      • 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 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
  • 7. Deploying Trident
    • 7.1. Supported Kubernetes cluster architectures
    • 7.2. Trident installation modes
    • 7.3. Trident CSI installation
    • 7.4. Recommendations for all deployments
      • 7.4.1. Deploy Trident to a dedicated namespace
      • 7.4.2. Use quotas and range limits to control storage consumption
      • 7.4.3. Use PVC protection to protect in-use resources
    • 7.5. Deploying Trident to OpenShift
      • 7.5.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.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.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. Resizing volumes
    • 8.5. When to manually provision a volume instead of using Trident
    • 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. 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. 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
  • 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
    • 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
      • 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
  • 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