/* Copyright 2018 The Kubernetes Authors. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package snapshotter import ( "context" "fmt" "reflect" "testing" "time" "github.com/container-storage-interface/spec/lib/go/csi" "github.com/golang/mock/gomock" "github.com/kubernetes-csi/csi-lib-utils/connection" "github.com/kubernetes-csi/csi-lib-utils/metrics" "github.com/kubernetes-csi/csi-test/v5/driver" "google.golang.org/grpc" "google.golang.org/grpc/codes" "google.golang.org/grpc/status" "google.golang.org/protobuf/types/known/timestamppb" v1 "k8s.io/api/core/v1" metav1 "k8s.io/apimachinery/pkg/apis/meta/v1" "k8s.io/apimachinery/pkg/types" ) const ( driverName = "foo/bar" ) func createMockServer(t *testing.T) (*gomock.Controller, *driver.MockCSIDriver, *driver.MockIdentityServer, *driver.MockControllerServer, *grpc.ClientConn, error) { // Start the mock server mockController := gomock.NewController(t) identityServer := driver.NewMockIdentityServer(mockController) controllerServer := driver.NewMockControllerServer(mockController) metricsManager := metrics.NewCSIMetricsManager("" /* driverName */) drv := driver.NewMockCSIDriver(&driver.MockCSIDriverServers{ Identity: identityServer, Controller: controllerServer, }) drv.Start() // Create a client connection to it addr := drv.Address() csiConn, err := connection.Connect(addr, metricsManager) if err != nil { return nil, nil, nil, nil, nil, err } return mockController, drv, identityServer, controllerServer, csiConn, nil } func TestCreateSnapshot(t *testing.T) { defaultName := "snapshot-test" defaultID := "testid" createTimestamp := timestamppb.Now() createTime := createTimestamp.AsTime() createSecrets := map[string]string{"foo": "bar"} defaultParameter := map[string]string{ "param1": "value1", "param2": "value2", } csiVolume := FakeCSIVolume() defaultRequest := &csi.CreateSnapshotRequest{ Name: defaultName, SourceVolumeId: csiVolume.Spec.CSI.VolumeHandle, } attributesRequest := &csi.CreateSnapshotRequest{ Name: defaultName, Parameters: defaultParameter, SourceVolumeId: csiVolume.Spec.CSI.VolumeHandle, } secretsRequest := &csi.CreateSnapshotRequest{ Name: defaultName, SourceVolumeId: csiVolume.Spec.CSI.VolumeHandle, Secrets: createSecrets, } defaultResponse := &csi.CreateSnapshotResponse{ Snapshot: &csi.Snapshot{ SnapshotId: defaultID, SizeBytes: 1000, SourceVolumeId: csiVolume.Spec.CSI.VolumeHandle, CreationTime: createTimestamp, ReadyToUse: true, }, } pluginInfoOutput := &csi.GetPluginInfoResponse{ Name: driverName, VendorVersion: "0.3.0", Manifest: map[string]string{ "hello": "world", }, } type snapshotResult struct { driverName string snapshotId string timestamp time.Time size int64 readyToUse bool } result := &snapshotResult{ size: 1000, driverName: driverName, snapshotId: defaultID, timestamp: createTime, readyToUse: true, } tests := []struct { name string snapshotName string volumeHandle string parameters map[string]string secrets map[string]string input *csi.CreateSnapshotRequest output *csi.CreateSnapshotResponse injectError codes.Code expectError bool expectResult *snapshotResult }{ { name: "success", snapshotName: defaultName, volumeHandle: csiVolume.Spec.CSI.VolumeHandle, input: defaultRequest, output: defaultResponse, expectError: false, expectResult: result, }, { name: "attributes", snapshotName: defaultName, volumeHandle: csiVolume.Spec.CSI.VolumeHandle, parameters: defaultParameter, input: attributesRequest, output: defaultResponse, expectError: false, expectResult: result, }, { name: "secrets", snapshotName: defaultName, volumeHandle: csiVolume.Spec.CSI.VolumeHandle, secrets: createSecrets, input: secretsRequest, output: defaultResponse, expectError: false, expectResult: result, }, { name: "gRPC transient error", snapshotName: defaultName, volumeHandle: csiVolume.Spec.CSI.VolumeHandle, input: defaultRequest, output: nil, injectError: codes.DeadlineExceeded, expectError: true, }, { name: "gRPC final error", snapshotName: defaultName, volumeHandle: csiVolume.Spec.CSI.VolumeHandle, input: defaultRequest, output: nil, injectError: codes.NotFound, expectError: true, }, } mockController, driver, identityServer, controllerServer, csiConn, err := createMockServer(t) if err != nil { t.Fatal(err) } defer mockController.Finish() defer driver.Stop() defer csiConn.Close() for _, test := range tests { in := test.input out := test.output var injectedErr error if test.injectError != codes.OK { injectedErr = status.Error(test.injectError, fmt.Sprintf("Injecting error %d", test.injectError)) } // Setup expectation if in != nil { identityServer.EXPECT().GetPluginInfo(gomock.Any(), gomock.Any()).Return(pluginInfoOutput, nil).Times(1) controllerServer.EXPECT().CreateSnapshot(gomock.Any(), in).Return(out, injectedErr).Times(1) } s := NewSnapshotter(csiConn) driverName, snapshotId, timestamp, size, readyToUse, err := s.CreateSnapshot(context.Background(), test.snapshotName, test.volumeHandle, test.parameters, test.secrets) if test.expectError && err == nil { t.Errorf("test %q: Expected error, got none", test.name) } if !test.expectError && err != nil { t.Errorf("test %q: got error: %v", test.name, err) } if test.expectResult != nil { if driverName != test.expectResult.driverName { t.Errorf("test %q: expected driverName: %q, got: %q", test.name, test.expectResult.driverName, driverName) } if snapshotId != test.expectResult.snapshotId { t.Errorf("test %q: expected snapshotId: %v, got: %v", test.name, test.expectResult.snapshotId, snapshotId) } if timestamp != test.expectResult.timestamp { t.Errorf("test %q: expected create time: %v, got: %v", test.name, test.expectResult.timestamp, timestamp) } if size != test.expectResult.size { t.Errorf("test %q: expected size: %v, got: %v", test.name, test.expectResult.size, size) } if !reflect.DeepEqual(readyToUse, test.expectResult.readyToUse) { t.Errorf("test %q: expected readyToUse: %v, got: %v", test.name, test.expectResult.readyToUse, readyToUse) } } } } func TestDeleteSnapshot(t *testing.T) { defaultID := "testid" secrets := map[string]string{"foo": "bar"} defaultRequest := &csi.DeleteSnapshotRequest{ SnapshotId: defaultID, } secretsRequest := &csi.DeleteSnapshotRequest{ SnapshotId: defaultID, Secrets: secrets, } tests := []struct { name string snapshotID string secrets map[string]string input *csi.DeleteSnapshotRequest output *csi.DeleteSnapshotResponse injectError codes.Code expectError bool }{ { name: "success", snapshotID: defaultID, input: defaultRequest, output: &csi.DeleteSnapshotResponse{}, expectError: false, }, { name: "secrets", snapshotID: defaultID, secrets: secrets, input: secretsRequest, output: &csi.DeleteSnapshotResponse{}, expectError: false, }, { name: "gRPC transient error", snapshotID: defaultID, input: defaultRequest, output: nil, injectError: codes.DeadlineExceeded, expectError: true, }, { name: "gRPC final error", snapshotID: defaultID, input: defaultRequest, output: nil, injectError: codes.NotFound, expectError: true, }, } mockController, driver, _, controllerServer, csiConn, err := createMockServer(t) if err != nil { t.Fatal(err) } defer mockController.Finish() defer driver.Stop() defer csiConn.Close() for _, test := range tests { in := test.input out := test.output var injectedErr error if test.injectError != codes.OK { injectedErr = status.Error(test.injectError, fmt.Sprintf("Injecting error %d", test.injectError)) } // Setup expectation if in != nil { controllerServer.EXPECT().DeleteSnapshot(gomock.Any(), in).Return(out, injectedErr).Times(1) } s := NewSnapshotter(csiConn) err := s.DeleteSnapshot(context.Background(), test.snapshotID, test.secrets) if test.expectError && err == nil { t.Errorf("test %q: Expected error, got none", test.name) } if !test.expectError && err != nil { t.Errorf("test %q: got error: %v", test.name, err) } } } func TestGetSnapshotStatus(t *testing.T) { defaultID := "testid" size := int64(1000) createTimestamp := timestamppb.Now() createTime := createTimestamp.AsTime() defaultRequest := &csi.ListSnapshotsRequest{ SnapshotId: defaultID, } defaultResponse := &csi.ListSnapshotsResponse{ Entries: []*csi.ListSnapshotsResponse_Entry{ { Snapshot: &csi.Snapshot{ SnapshotId: defaultID, SizeBytes: size, SourceVolumeId: "volumeid", CreationTime: createTimestamp, ReadyToUse: true, }, }, }, } secret := map[string]string{"foo": "bar"} secretRequest := &csi.ListSnapshotsRequest{ SnapshotId: defaultID, Secrets: secret, } tests := []struct { name string snapshotID string snapshotterListCredentials map[string]string listSnapshotsSupported bool input *csi.ListSnapshotsRequest output *csi.ListSnapshotsResponse injectError codes.Code expectError bool expectReady bool expectCreateAt time.Time expectSize int64 }{ { name: "success", snapshotID: defaultID, listSnapshotsSupported: true, input: defaultRequest, output: defaultResponse, expectError: false, expectReady: true, expectCreateAt: createTime, expectSize: size, }, { name: "secret", snapshotID: defaultID, snapshotterListCredentials: secret, listSnapshotsSupported: true, input: secretRequest, output: defaultResponse, expectError: false, expectReady: true, expectCreateAt: createTime, expectSize: size, }, { name: "ListSnapshots not supported", snapshotID: defaultID, listSnapshotsSupported: false, input: defaultRequest, output: defaultResponse, expectError: false, expectReady: true, expectCreateAt: time.Time{}, expectSize: 0, }, { name: "gRPC transient error", snapshotID: defaultID, listSnapshotsSupported: true, input: defaultRequest, output: nil, injectError: codes.DeadlineExceeded, expectError: true, }, { name: "gRPC final error", snapshotID: defaultID, listSnapshotsSupported: true, input: defaultRequest, output: nil, injectError: codes.NotFound, expectError: true, }, } mockController, driver, _, controllerServer, csiConn, err := createMockServer(t) if err != nil { t.Fatal(err) } defer mockController.Finish() defer driver.Stop() defer csiConn.Close() for _, test := range tests { in := test.input out := test.output var injectedErr error if test.injectError != codes.OK { injectedErr = status.Error(test.injectError, fmt.Sprintf("Injecting error %d", test.injectError)) } // Setup expectation listSnapshotsCap := &csi.ControllerServiceCapability{ Type: &csi.ControllerServiceCapability_Rpc{ Rpc: &csi.ControllerServiceCapability_RPC{ Type: csi.ControllerServiceCapability_RPC_LIST_SNAPSHOTS, }, }, } var controllerCapabilities []*csi.ControllerServiceCapability if test.listSnapshotsSupported { controllerCapabilities = append(controllerCapabilities, listSnapshotsCap) } if in != nil { controllerServer.EXPECT().ControllerGetCapabilities(gomock.Any(), gomock.Any()).Return(&csi.ControllerGetCapabilitiesResponse{ Capabilities: controllerCapabilities, }, nil).Times(1) if test.listSnapshotsSupported { controllerServer.EXPECT().ListSnapshots(gomock.Any(), in).Return(out, injectedErr).Times(1) } } s := NewSnapshotter(csiConn) ready, createTime, size, _, err := s.GetSnapshotStatus(context.Background(), test.snapshotID, test.snapshotterListCredentials) if test.expectError && err == nil { t.Errorf("test %q: Expected error, got none", test.name) } if !test.expectError && err != nil { t.Errorf("test %q: got error: %v", test.name, err) } if test.expectReady != ready { t.Errorf("test %q: expected status: %v, got: %v", test.name, test.expectReady, ready) } if test.expectCreateAt != createTime { t.Errorf("test %q: expected createTime: %v, got: %v", test.name, test.expectCreateAt, createTime) } if test.expectSize != size { t.Errorf("test %q: expected size: %v, got: %v", test.name, test.expectSize, size) } } } func FakeCSIVolume() *v1.PersistentVolume { volume := v1.PersistentVolume{ ObjectMeta: metav1.ObjectMeta{ Name: "fake-csi-volume", }, Spec: v1.PersistentVolumeSpec{ ClaimRef: &v1.ObjectReference{ Kind: "PersistentVolumeClaim", APIVersion: "v1", UID: types.UID("uid123"), Namespace: "default", Name: "test-claim", }, PersistentVolumeSource: v1.PersistentVolumeSource{ CSI: &v1.CSIPersistentVolumeSource{ Driver: driverName, VolumeHandle: "foo", }, }, StorageClassName: "default", }, Status: v1.PersistentVolumeStatus{ Phase: v1.VolumeBound, }, } return &volume }