mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
488 lines
17 KiB
Go
488 lines
17 KiB
Go
package main
|
|
|
|
import (
|
|
"os"
|
|
"path/filepath"
|
|
|
|
"github.com/docker/docker/pkg/integration/checker"
|
|
"github.com/go-check/check"
|
|
)
|
|
|
|
// docker cp CONTAINER:PATH LOCALPATH
|
|
|
|
// Try all of the test cases from the archive package which implements the
|
|
// internals of `docker cp` and ensure that the behavior matches when actually
|
|
// copying to and from containers.
|
|
|
|
// Basic assumptions about SRC and DST:
|
|
// 1. SRC must exist.
|
|
// 2. If SRC ends with a trailing separator, it must be a directory.
|
|
// 3. DST parent directory must exist.
|
|
// 4. If DST exists as a file, it must not end with a trailing separator.
|
|
|
|
// First get these easy error cases out of the way.
|
|
|
|
// Test for error when SRC does not exist.
|
|
func (s *DockerSuite) TestCpFromErrSrcNotExists(c *check.C) {
|
|
containerID := makeTestContainer(c, testContainerOptions{})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-err-src-not-exists")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
err := runDockerCp(c, containerCpPath(containerID, "file1"), tmpDir)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotExist(err), checker.True, check.Commentf("expected IsNotExist error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// Test for error when SRC ends in a trailing
|
|
// path separator but it exists as a file.
|
|
func (s *DockerSuite) TestCpFromErrSrcNotDir(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-err-src-not-dir")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
err := runDockerCp(c, containerCpPathTrailingSep(containerID, "file1"), tmpDir)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotDir(err), checker.True, check.Commentf("expected IsNotDir error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// Test for error when SRC is a valid file or directory,
|
|
// bu the DST parent directory does not exist.
|
|
func (s *DockerSuite) TestCpFromErrDstParentNotExists(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-err-dst-parent-not-exists")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
// Try with a file source.
|
|
srcPath := containerCpPath(containerID, "/file1")
|
|
dstPath := cpPath(tmpDir, "notExists", "file1")
|
|
|
|
err := runDockerCp(c, srcPath, dstPath)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotExist(err), checker.True, check.Commentf("expected IsNotExist error, but got %T: %s", err, err))
|
|
|
|
// Try with a directory source.
|
|
srcPath = containerCpPath(containerID, "/dir1")
|
|
|
|
err = runDockerCp(c, srcPath, dstPath)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotExist(err), checker.True, check.Commentf("expected IsNotExist error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// Test for error when DST ends in a trailing
|
|
// path separator but exists as a file.
|
|
func (s *DockerSuite) TestCpFromErrDstNotDir(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-err-dst-not-dir")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
// Try with a file source.
|
|
srcPath := containerCpPath(containerID, "/file1")
|
|
dstPath := cpPathTrailingSep(tmpDir, "file1")
|
|
|
|
err := runDockerCp(c, srcPath, dstPath)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotDir(err), checker.True, check.Commentf("expected IsNotDir error, but got %T: %s", err, err))
|
|
|
|
// Try with a directory source.
|
|
srcPath = containerCpPath(containerID, "/dir1")
|
|
|
|
err = runDockerCp(c, srcPath, dstPath)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpNotDir(err), checker.True, check.Commentf("expected IsNotDir error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// Check that copying from a container to a local symlink copies to the symlink
|
|
// target and does not overwrite the local symlink itself.
|
|
func (s *DockerSuite) TestCpFromSymlinkDestination(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-err-dst-not-dir")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
// First, copy a file from the container to a symlink to a file. This
|
|
// should overwrite the symlink target contents with the source contents.
|
|
srcPath := containerCpPath(containerID, "/file2")
|
|
dstPath := cpPath(tmpDir, "symlinkToFile1")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
// The symlink should not have been modified.
|
|
c.Assert(symlinkTargetEquals(c, dstPath, "file1"), checker.IsNil)
|
|
|
|
// The file should have the contents of "file2" now.
|
|
c.Assert(fileContentEquals(c, cpPath(tmpDir, "file1"), "file2\n"), checker.IsNil)
|
|
|
|
// Next, copy a file from the container to a symlink to a directory. This
|
|
// should copy the file into the symlink target directory.
|
|
dstPath = cpPath(tmpDir, "symlinkToDir1")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
// The symlink should not have been modified.
|
|
c.Assert(symlinkTargetEquals(c, dstPath, "dir1"), checker.IsNil)
|
|
|
|
// The file should have the contents of "file2" now.
|
|
c.Assert(fileContentEquals(c, cpPath(tmpDir, "file2"), "file2\n"), checker.IsNil)
|
|
|
|
// Next, copy a file from the container to a symlink to a file that does
|
|
// not exist (a broken symlink). This should create the target file with
|
|
// the contents of the source file.
|
|
dstPath = cpPath(tmpDir, "brokenSymlinkToFileX")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
// The symlink should not have been modified.
|
|
c.Assert(symlinkTargetEquals(c, dstPath, "fileX"), checker.IsNil)
|
|
|
|
// The file should have the contents of "file2" now.
|
|
c.Assert(fileContentEquals(c, cpPath(tmpDir, "fileX"), "file2\n"), checker.IsNil)
|
|
|
|
// Next, copy a directory from the container to a symlink to a local
|
|
// directory. This should copy the directory into the symlink target
|
|
// directory and not modify the symlink.
|
|
srcPath = containerCpPath(containerID, "/dir2")
|
|
dstPath = cpPath(tmpDir, "symlinkToDir1")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
// The symlink should not have been modified.
|
|
c.Assert(symlinkTargetEquals(c, dstPath, "dir1"), checker.IsNil)
|
|
|
|
// The directory should now contain a copy of "dir2".
|
|
c.Assert(fileContentEquals(c, cpPath(tmpDir, "dir1/dir2/file2-1"), "file2-1\n"), checker.IsNil)
|
|
|
|
// Next, copy a directory from the container to a symlink to a local
|
|
// directory that does not exist (a broken symlink). This should create
|
|
// the target as a directory with the contents of the source directory. It
|
|
// should not modify the symlink.
|
|
dstPath = cpPath(tmpDir, "brokenSymlinkToDirX")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
// The symlink should not have been modified.
|
|
c.Assert(symlinkTargetEquals(c, dstPath, "dirX"), checker.IsNil)
|
|
|
|
// The "dirX" directory should now be a copy of "dir2".
|
|
c.Assert(fileContentEquals(c, cpPath(tmpDir, "dirX/file2-1"), "file2-1\n"), checker.IsNil)
|
|
}
|
|
|
|
// Possibilities are reduced to the remaining 10 cases:
|
|
//
|
|
// case | srcIsDir | onlyDirContents | dstExists | dstIsDir | dstTrSep | action
|
|
// ===================================================================================================
|
|
// A | no | - | no | - | no | create file
|
|
// B | no | - | no | - | yes | error
|
|
// C | no | - | yes | no | - | overwrite file
|
|
// D | no | - | yes | yes | - | create file in dst dir
|
|
// E | yes | no | no | - | - | create dir, copy contents
|
|
// F | yes | no | yes | no | - | error
|
|
// G | yes | no | yes | yes | - | copy dir and contents
|
|
// H | yes | yes | no | - | - | create dir, copy contents
|
|
// I | yes | yes | yes | no | - | error
|
|
// J | yes | yes | yes | yes | - | copy dir contents
|
|
//
|
|
|
|
// A. SRC specifies a file and DST (no trailing path separator) doesn't
|
|
// exist. This should create a file with the name DST and copy the
|
|
// contents of the source file into it.
|
|
func (s *DockerSuite) TestCpFromCaseA(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-a")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
srcPath := containerCpPath(containerID, "/root/file1")
|
|
dstPath := cpPath(tmpDir, "itWorks.txt")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1\n"), checker.IsNil)
|
|
}
|
|
|
|
// B. SRC specifies a file and DST (with trailing path separator) doesn't
|
|
// exist. This should cause an error because the copy operation cannot
|
|
// create a directory when copying a single file.
|
|
func (s *DockerSuite) TestCpFromCaseB(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-b")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
srcPath := containerCpPath(containerID, "/file1")
|
|
dstDir := cpPathTrailingSep(tmpDir, "testDir")
|
|
|
|
err := runDockerCp(c, srcPath, dstDir)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpDirNotExist(err), checker.True, check.Commentf("expected DirNotExists error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// C. SRC specifies a file and DST exists as a file. This should overwrite
|
|
// the file at DST with the contents of the source file.
|
|
func (s *DockerSuite) TestCpFromCaseC(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-c")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcPath := containerCpPath(containerID, "/root/file1")
|
|
dstPath := cpPath(tmpDir, "file2")
|
|
|
|
// Ensure the local file starts with different content.
|
|
c.Assert(fileContentEquals(c, dstPath, "file2\n"), checker.IsNil)
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstPath), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1\n"), checker.IsNil)
|
|
}
|
|
|
|
// D. SRC specifies a file and DST exists as a directory. This should place
|
|
// a copy of the source file inside it using the basename from SRC. Ensure
|
|
// this works whether DST has a trailing path separator or not.
|
|
func (s *DockerSuite) TestCpFromCaseD(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-d")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcPath := containerCpPath(containerID, "/file1")
|
|
dstDir := cpPath(tmpDir, "dir1")
|
|
dstPath := filepath.Join(dstDir, "file1")
|
|
|
|
// Ensure that dstPath doesn't exist.
|
|
_, err := os.Stat(dstPath)
|
|
c.Assert(os.IsNotExist(err), checker.True, check.Commentf("did not expect dstPath %q to exist", dstPath))
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1\n"), checker.IsNil)
|
|
|
|
// Now try again but using a trailing path separator for dstDir.
|
|
|
|
// unable to remove dstDir
|
|
c.Assert(os.RemoveAll(dstDir), checker.IsNil)
|
|
|
|
// unable to make dstDir
|
|
c.Assert(os.MkdirAll(dstDir, os.FileMode(0755)), checker.IsNil)
|
|
|
|
dstDir = cpPathTrailingSep(tmpDir, "dir1")
|
|
|
|
c.Assert(runDockerCp(c, srcPath, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1\n"), checker.IsNil)
|
|
}
|
|
|
|
// E. SRC specifies a directory and DST does not exist. This should create a
|
|
// directory at DST and copy the contents of the SRC directory into the DST
|
|
// directory. Ensure this works whether DST has a trailing path separator or
|
|
// not.
|
|
func (s *DockerSuite) TestCpFromCaseE(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-e")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
srcDir := containerCpPath(containerID, "dir1")
|
|
dstDir := cpPath(tmpDir, "testDir")
|
|
dstPath := filepath.Join(dstDir, "file1-1")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
|
|
// Now try again but using a trailing path separator for dstDir.
|
|
|
|
// unable to remove dstDir
|
|
c.Assert(os.RemoveAll(dstDir), checker.IsNil)
|
|
|
|
dstDir = cpPathTrailingSep(tmpDir, "testDir")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
}
|
|
|
|
// F. SRC specifies a directory and DST exists as a file. This should cause an
|
|
// error as it is not possible to overwrite a file with a directory.
|
|
func (s *DockerSuite) TestCpFromCaseF(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-f")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcDir := containerCpPath(containerID, "/root/dir1")
|
|
dstFile := cpPath(tmpDir, "file1")
|
|
|
|
err := runDockerCp(c, srcDir, dstFile)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpCannotCopyDir(err), checker.True, check.Commentf("expected ErrCannotCopyDir error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// G. SRC specifies a directory and DST exists as a directory. This should copy
|
|
// the SRC directory and all its contents to the DST directory. Ensure this
|
|
// works whether DST has a trailing path separator or not.
|
|
func (s *DockerSuite) TestCpFromCaseG(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-g")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcDir := containerCpPath(containerID, "/root/dir1")
|
|
dstDir := cpPath(tmpDir, "dir2")
|
|
resultDir := filepath.Join(dstDir, "dir1")
|
|
dstPath := filepath.Join(resultDir, "file1-1")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
|
|
// Now try again but using a trailing path separator for dstDir.
|
|
|
|
// unable to remove dstDir
|
|
c.Assert(os.RemoveAll(dstDir), checker.IsNil)
|
|
|
|
// unable to make dstDir
|
|
c.Assert(os.MkdirAll(dstDir, os.FileMode(0755)), checker.IsNil)
|
|
|
|
dstDir = cpPathTrailingSep(tmpDir, "dir2")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
}
|
|
|
|
// H. SRC specifies a directory's contents only and DST does not exist. This
|
|
// should create a directory at DST and copy the contents of the SRC
|
|
// directory (but not the directory itself) into the DST directory. Ensure
|
|
// this works whether DST has a trailing path separator or not.
|
|
func (s *DockerSuite) TestCpFromCaseH(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{addContent: true})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-h")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
srcDir := containerCpPathTrailingSep(containerID, "dir1") + "."
|
|
dstDir := cpPath(tmpDir, "testDir")
|
|
dstPath := filepath.Join(dstDir, "file1-1")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
|
|
// Now try again but using a trailing path separator for dstDir.
|
|
|
|
// unable to remove resultDir
|
|
c.Assert(os.RemoveAll(dstDir), checker.IsNil)
|
|
|
|
dstDir = cpPathTrailingSep(tmpDir, "testDir")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
}
|
|
|
|
// I. SRC specifies a directory's contents only and DST exists as a file. This
|
|
// should cause an error as it is not possible to overwrite a file with a
|
|
// directory.
|
|
func (s *DockerSuite) TestCpFromCaseI(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-i")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcDir := containerCpPathTrailingSep(containerID, "/root/dir1") + "."
|
|
dstFile := cpPath(tmpDir, "file1")
|
|
|
|
err := runDockerCp(c, srcDir, dstFile)
|
|
c.Assert(err, checker.NotNil)
|
|
|
|
c.Assert(isCpCannotCopyDir(err), checker.True, check.Commentf("expected ErrCannotCopyDir error, but got %T: %s", err, err))
|
|
}
|
|
|
|
// J. SRC specifies a directory's contents only and DST exists as a directory.
|
|
// This should copy the contents of the SRC directory (but not the directory
|
|
// itself) into the DST directory. Ensure this works whether DST has a
|
|
// trailing path separator or not.
|
|
func (s *DockerSuite) TestCpFromCaseJ(c *check.C) {
|
|
testRequires(c, DaemonIsLinux)
|
|
containerID := makeTestContainer(c, testContainerOptions{
|
|
addContent: true, workDir: "/root",
|
|
})
|
|
|
|
tmpDir := getTestDir(c, "test-cp-from-case-j")
|
|
defer os.RemoveAll(tmpDir)
|
|
|
|
makeTestContentInDir(c, tmpDir)
|
|
|
|
srcDir := containerCpPathTrailingSep(containerID, "/root/dir1") + "."
|
|
dstDir := cpPath(tmpDir, "dir2")
|
|
dstPath := filepath.Join(dstDir, "file1-1")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
|
|
// Now try again but using a trailing path separator for dstDir.
|
|
|
|
// unable to remove dstDir
|
|
c.Assert(os.RemoveAll(dstDir), checker.IsNil)
|
|
|
|
// unable to make dstDir
|
|
c.Assert(os.MkdirAll(dstDir, os.FileMode(0755)), checker.IsNil)
|
|
|
|
dstDir = cpPathTrailingSep(tmpDir, "dir2")
|
|
|
|
c.Assert(runDockerCp(c, srcDir, dstDir), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
}
|