README
¶
End-to-End Testing
Context
The FSx OpenZFS CSI driver utilizes a variety of workflows to validate end to end functionality in a Kubernetes environment. The framework and existing testsuites for Kubernetes storage E2E testing is leveraged to test common cases. Untested or unique test cases are also tested using a custom testsuite.
Due to the nature of end-to-end tests it is possible to leave testing artifacts stranded.
Events such as abrupt termination or server-side API failures can prevent resources from being deleted properly.
The fsx hack contains a function that cleans up all testing resources that may have been left stranded.
Run bash ../../hack/e2e/fsx.sh fsx_delete_e2e_resources to execute this function.
Running
In order to run the E2E tests, an EKS cluster with an OpenZFS driver installed must be utilized. Follow the respective section depending on if a test environment is already set up.
Existing Environment
The test environment should contain the following:
- Kubernetes 1.13+ (CSI 1.0).
- EKS Cluster
- Ginkgo CLI
Run ginkgo -r --procs=4 --timeout=5h --junit-report=report.xml from the tests/e2e folder to run
Documentation
¶
Index ¶
- Constants
- Variables
- func InitCustomSnapshotsTestSuite(patterns []storageframework.TestPattern) storageframework.TestSuite
- func InitFSxCSIDriver(parameters map[string]string, restoreSnapshotParameters map[string]string, ...) storageframework.TestDriver
- func InitSnapshotsTestSuite() storageframework.TestSuite
- type Cloud
- func (c *Cloud) CreateFileSystem(ctx context.Context, input fsx.CreateFileSystemInput) (*fsx.FileSystem, error)
- func (c *Cloud) CreateVolume(ctx context.Context, input fsx.CreateVolumeInput) (*fsx.Volume, error)
- func (c *Cloud) DeleteFileSystem(ctx context.Context, input fsx.DeleteFileSystemInput) error
- func (c *Cloud) DeleteVolume(ctx context.Context, input fsx.DeleteVolumeInput) error
- func (c *Cloud) GetDNSName(ctx context.Context, filesystemId string) (string, error)
- func (c *Cloud) GetNodeInstance(ctx context.Context, clusterName string) (*ec2.Instance, error)
- func (c *Cloud) GetSecurityGroupIds(node *ec2.Instance) []string
- func (c *Cloud) WaitForFilesystemAvailable(ctx context.Context, filesystemId string) error
- func (c *Cloud) WaitForVolumeAvailable(ctx context.Context, volumeId string) error
- type FSxFilesystem
- type FSxResource
- type FSxTestDriver
- type FSxVolume
Constants ¶
const ( RESOURCETYPE = "ResourceType" RESOURCETYPE_FILESYSTEM = "filesystem" RESOURCETYPE_VOLUME = "volume" )
const (
CSIDriverE2ETagKey = "OpenZFSCSIDriverE2E"
)
Variables ¶
var ( ClusterName string Region string PullRequest string )
var APIGroup = "snapshot.storage.k8s.io"
var CustomSuites = []func() storageframework.TestSuite{ InitSnapshotsTestSuite, }
Functions ¶
func InitCustomSnapshotsTestSuite ¶
func InitCustomSnapshotsTestSuite(patterns []storageframework.TestPattern) storageframework.TestSuite
InitCustomSnapshotsTestSuite returns snapshotsTestSuite that implements TestSuite interface using custom test patterns
func InitFSxCSIDriver ¶
func InitFSxCSIDriver(parameters map[string]string, restoreSnapshotParameters map[string]string, snapshotParameters map[string]string, createInput any, deleteInput any) storageframework.TestDriver
func InitSnapshotsTestSuite ¶
func InitSnapshotsTestSuite() storageframework.TestSuite
InitSnapshotsTestSuite returns snapshotsTestSuite that implements TestSuite interface\ using test suite default patterns
Types ¶
type Cloud ¶
func (*Cloud) CreateFileSystem ¶
func (c *Cloud) CreateFileSystem(ctx context.Context, input fsx.CreateFileSystemInput) (*fsx.FileSystem, error)
func (*Cloud) CreateVolume ¶
func (*Cloud) DeleteFileSystem ¶
func (*Cloud) DeleteVolume ¶
func (*Cloud) GetDNSName ¶
func (*Cloud) GetNodeInstance ¶
func (*Cloud) GetSecurityGroupIds ¶
func (*Cloud) WaitForFilesystemAvailable ¶
type FSxFilesystem ¶
type FSxFilesystem struct {
RootVolumeId string
// contains filtered or unexported fields
}
func (*FSxFilesystem) DeleteVolume ¶
func (f *FSxFilesystem) DeleteVolume(ctx context.Context)
type FSxResource ¶
type FSxResource struct {
// contains filtered or unexported fields
}
type FSxTestDriver ¶
type FSxTestDriver interface {
storageframework.TestDriver
GetRestoreSnapshotStorageClass(ctx context.Context) *storagev1.StorageClass
}
Source Files