
1. reason to deactivate committed snapshot The thin device will not be used for IO after committed, and further thin snapshotting is OK using an inactive thin device as origin. The benefits to deactivate are: - device is not unneccesary visible avoiding any unexpected IO; - save useless kernel data structs for maintaining active dm. Quote from kernel doc (Documentation/device-mapper/provisioning.txt): " ii) Using an internal snapshot. Once created, the user doesn't have to worry about any connection between the origin and the snapshot. Indeed the snapshot is no different from any other thinly-provisioned device and can be snapshotted itself via the same method. It's perfectly legal to have only one of them active, and there's no ordering requirement on activating or removing them both. (This differs from conventional device-mapper snapshots.) " 2. an thinpool metadata bug is naturally removed An problem happens when failed to suspend/resume origin thin device when creating snapshot: "failed to create snapshot device from parent vg0-mythinpool-snap-3" error="failed to save initial metadata for snapshot "vg0-mythinpool-snap-19": object already exists" This issue occurs because when failed to create snapshot, the snapshotter.store can be rollbacked, but the thin pool metadata boltdb failed to rollback in PoolDevice.CreateSnapshotDevice(), therefore metadata becomes inconsistent: the snapshotID is not taken in snapshotter.store, but saved in pool metadata boltdb. The cause is, in PoolDevice.CreateSnapshotDevice(), the defer calls are invoked on "first-in-last-out" order. When the error happens on the "resume device" defer call, the metadata is saved and snapshot is created, which has no chance to be rollbacked. Signed-off-by: Eric Ren <renzhen@linux.alibaba.com>
253 lines
7.4 KiB
Go
253 lines
7.4 KiB
Go
// +build linux
|
|
|
|
/*
|
|
Copyright The containerd 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 devmapper
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"io/ioutil"
|
|
"os"
|
|
"os/exec"
|
|
"path/filepath"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/containerd/containerd/mount"
|
|
"github.com/containerd/containerd/pkg/testutil"
|
|
"github.com/containerd/containerd/snapshots/devmapper/dmsetup"
|
|
"github.com/containerd/containerd/snapshots/devmapper/losetup"
|
|
"github.com/docker/go-units"
|
|
"github.com/sirupsen/logrus"
|
|
"gotest.tools/assert"
|
|
)
|
|
|
|
const (
|
|
thinDevice1 = "thin-1"
|
|
thinDevice2 = "thin-2"
|
|
snapDevice1 = "snap-1"
|
|
device1Size = 100000
|
|
device2Size = 200000
|
|
testsPrefix = "devmapper-snapshotter-tests-"
|
|
)
|
|
|
|
// TestPoolDevice runs integration tests for pool device.
|
|
// The following scenario implemented:
|
|
// - Create pool device with name 'test-pool-device'
|
|
// - Create two thin volumes 'thin-1' and 'thin-2'
|
|
// - Write ext4 file system on 'thin-1' and make sure it'errs moutable
|
|
// - Write v1 test file on 'thin-1' volume
|
|
// - Take 'thin-1' snapshot 'snap-1'
|
|
// - Change v1 file to v2 on 'thin-1'
|
|
// - Mount 'snap-1' and make sure test file is v1
|
|
// - Unmount volumes and remove all devices
|
|
func TestPoolDevice(t *testing.T) {
|
|
testutil.RequiresRoot(t)
|
|
|
|
logrus.SetLevel(logrus.DebugLevel)
|
|
ctx := context.Background()
|
|
|
|
tempDir, err := ioutil.TempDir("", "pool-device-test-")
|
|
assert.NilError(t, err, "couldn't get temp directory for testing")
|
|
|
|
_, loopDataDevice := createLoopbackDevice(t, tempDir)
|
|
_, loopMetaDevice := createLoopbackDevice(t, tempDir)
|
|
|
|
poolName := fmt.Sprintf("test-pool-device-%d", time.Now().Nanosecond())
|
|
err = dmsetup.CreatePool(poolName, loopDataDevice, loopMetaDevice, 64*1024/dmsetup.SectorSize)
|
|
assert.NilError(t, err, "failed to create pool %q", poolName)
|
|
|
|
defer func() {
|
|
// Detach loop devices and remove images
|
|
err := losetup.DetachLoopDevice(loopDataDevice, loopMetaDevice)
|
|
assert.NilError(t, err)
|
|
|
|
err = os.RemoveAll(tempDir)
|
|
assert.NilError(t, err, "couldn't cleanup temp directory")
|
|
}()
|
|
|
|
config := &Config{
|
|
PoolName: poolName,
|
|
RootPath: tempDir,
|
|
BaseImageSize: "16mb",
|
|
BaseImageSizeBytes: 16 * 1024 * 1024,
|
|
}
|
|
|
|
pool, err := NewPoolDevice(ctx, config)
|
|
assert.NilError(t, err, "can't create device pool")
|
|
assert.Assert(t, pool != nil)
|
|
|
|
defer func() {
|
|
err := pool.RemovePool(ctx)
|
|
assert.NilError(t, err, "can't close device pool")
|
|
}()
|
|
|
|
// Create thin devices
|
|
t.Run("CreateThinDevice", func(t *testing.T) {
|
|
testCreateThinDevice(t, pool)
|
|
})
|
|
|
|
// Make ext4 filesystem on 'thin-1'
|
|
t.Run("MakeFileSystem", func(t *testing.T) {
|
|
testMakeFileSystem(t, pool)
|
|
})
|
|
|
|
// Mount 'thin-1' and write v1 test file on 'thin-1' device
|
|
err = mount.WithTempMount(ctx, getMounts(thinDevice1), func(thin1MountPath string) error {
|
|
// Write v1 test file on 'thin-1' device
|
|
thin1TestFilePath := filepath.Join(thin1MountPath, "TEST")
|
|
err := ioutil.WriteFile(thin1TestFilePath, []byte("test file (v1)"), 0700)
|
|
assert.NilError(t, err, "failed to write test file v1 on '%s' volume", thinDevice1)
|
|
|
|
return nil
|
|
})
|
|
|
|
// Take snapshot of 'thin-1'
|
|
t.Run("CreateSnapshotDevice", func(t *testing.T) {
|
|
testCreateSnapshot(t, pool)
|
|
})
|
|
|
|
// Update TEST file on 'thin-1' to v2
|
|
err = mount.WithTempMount(ctx, getMounts(thinDevice1), func(thin1MountPath string) error {
|
|
thin1TestFilePath := filepath.Join(thin1MountPath, "TEST")
|
|
err = ioutil.WriteFile(thin1TestFilePath, []byte("test file (v2)"), 0700)
|
|
assert.NilError(t, err, "failed to write test file v2 on 'thin-1' volume after taking snapshot")
|
|
|
|
return nil
|
|
})
|
|
|
|
assert.NilError(t, err)
|
|
|
|
// Mount 'snap-1' and make sure TEST file is v1
|
|
err = mount.WithTempMount(ctx, getMounts(snapDevice1), func(snap1MountPath string) error {
|
|
// Read test file from snapshot device and make sure it's v1
|
|
fileData, err := ioutil.ReadFile(filepath.Join(snap1MountPath, "TEST"))
|
|
assert.NilError(t, err, "couldn't read test file from '%s' device", snapDevice1)
|
|
assert.Equal(t, "test file (v1)", string(fileData), "test file content is invalid on snapshot")
|
|
|
|
return nil
|
|
})
|
|
|
|
assert.NilError(t, err)
|
|
|
|
t.Run("DeactivateDevice", func(t *testing.T) {
|
|
testDeactivateThinDevice(t, pool)
|
|
})
|
|
|
|
t.Run("RemoveDevice", func(t *testing.T) {
|
|
testRemoveThinDevice(t, pool)
|
|
})
|
|
}
|
|
|
|
func testCreateThinDevice(t *testing.T, pool *PoolDevice) {
|
|
ctx := context.Background()
|
|
|
|
err := pool.CreateThinDevice(ctx, thinDevice1, device1Size)
|
|
assert.NilError(t, err, "can't create first thin device")
|
|
|
|
err = pool.CreateThinDevice(ctx, thinDevice1, device1Size)
|
|
assert.Assert(t, err != nil, "device pool allows duplicated device names")
|
|
|
|
err = pool.CreateThinDevice(ctx, thinDevice2, device2Size)
|
|
assert.NilError(t, err, "can't create second thin device")
|
|
|
|
deviceInfo1, err := pool.metadata.GetDevice(ctx, thinDevice1)
|
|
assert.NilError(t, err)
|
|
|
|
deviceInfo2, err := pool.metadata.GetDevice(ctx, thinDevice2)
|
|
assert.NilError(t, err)
|
|
|
|
assert.Assert(t, deviceInfo1.DeviceID != deviceInfo2.DeviceID, "assigned device ids should be different")
|
|
|
|
usage, err := pool.GetUsage(thinDevice1)
|
|
assert.NilError(t, err)
|
|
assert.Equal(t, usage, int64(0))
|
|
}
|
|
|
|
func testMakeFileSystem(t *testing.T, pool *PoolDevice) {
|
|
devicePath := dmsetup.GetFullDevicePath(thinDevice1)
|
|
args := []string{
|
|
devicePath,
|
|
"-E",
|
|
"nodiscard,lazy_itable_init=0,lazy_journal_init=0",
|
|
}
|
|
|
|
output, err := exec.Command("mkfs.ext4", args...).CombinedOutput()
|
|
assert.NilError(t, err, "failed to make filesystem on '%s': %s", thinDevice1, string(output))
|
|
|
|
usage, err := pool.GetUsage(thinDevice1)
|
|
assert.NilError(t, err)
|
|
assert.Assert(t, usage > 0)
|
|
}
|
|
|
|
func testCreateSnapshot(t *testing.T, pool *PoolDevice) {
|
|
err := pool.CreateSnapshotDevice(context.Background(), thinDevice1, snapDevice1, device1Size)
|
|
assert.NilError(t, err, "failed to create snapshot from '%s' volume", thinDevice1)
|
|
}
|
|
|
|
func testDeactivateThinDevice(t *testing.T, pool *PoolDevice) {
|
|
deviceList := []string{
|
|
thinDevice2,
|
|
snapDevice1,
|
|
}
|
|
|
|
for _, deviceName := range deviceList {
|
|
assert.Assert(t, pool.IsActivated(deviceName))
|
|
|
|
err := pool.DeactivateDevice(context.Background(), deviceName, false, true)
|
|
assert.NilError(t, err, "failed to remove '%s'", deviceName)
|
|
|
|
assert.Assert(t, !pool.IsActivated(deviceName))
|
|
}
|
|
}
|
|
|
|
func testRemoveThinDevice(t *testing.T, pool *PoolDevice) {
|
|
err := pool.RemoveDevice(testCtx, thinDevice1)
|
|
assert.NilError(t, err, "should delete thin device from pool")
|
|
}
|
|
|
|
func getMounts(thinDeviceName string) []mount.Mount {
|
|
return []mount.Mount{
|
|
{
|
|
Source: dmsetup.GetFullDevicePath(thinDeviceName),
|
|
Type: "ext4",
|
|
},
|
|
}
|
|
}
|
|
|
|
func createLoopbackDevice(t *testing.T, dir string) (string, string) {
|
|
file, err := ioutil.TempFile(dir, testsPrefix)
|
|
assert.NilError(t, err)
|
|
|
|
size, err := units.RAMInBytes("128Mb")
|
|
assert.NilError(t, err)
|
|
|
|
err = file.Truncate(size)
|
|
assert.NilError(t, err)
|
|
|
|
err = file.Close()
|
|
assert.NilError(t, err)
|
|
|
|
imagePath := file.Name()
|
|
|
|
loopDevice, err := losetup.AttachLoopDevice(imagePath)
|
|
assert.NilError(t, err)
|
|
|
|
return imagePath, loopDevice
|
|
}
|