ebcb7d6b40
Use strongly typed errors to set HTTP status codes. Error interfaces are defined in the api/errors package and errors returned from controllers are checked against these interfaces. Errors can be wraeped in a pkg/errors.Causer, as long as somewhere in the line of causes one of the interfaces is implemented. The special error interfaces take precedence over Causer, meaning if both Causer and one of the new error interfaces are implemented, the Causer is not traversed. Signed-off-by: Brian Goff <cpuguy83@gmail.com>
486 lines
18 KiB
Go
486 lines
18 KiB
Go
package main
|
|
|
|
import (
|
|
"os"
|
|
"path/filepath"
|
|
|
|
"github.com/docker/docker/integration-cli/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, nil)
|
|
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, nil)
|
|
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")
|
|
_, dstStatErr := os.Lstat(filepath.Dir(dstPath))
|
|
c.Assert(os.IsNotExist(dstStatErr), checker.True)
|
|
|
|
err := runDockerCp(c, srcPath, dstPath, nil)
|
|
c.Assert(err.Error(), checker.Contains, dstStatErr.Error())
|
|
|
|
// Try with a directory source.
|
|
srcPath = containerCpPath(containerID, "/dir1")
|
|
|
|
err = runDockerCp(c, srcPath, dstPath, nil)
|
|
c.Assert(err.Error(), checker.Contains, dstStatErr.Error())
|
|
}
|
|
|
|
// 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, nil)
|
|
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, nil)
|
|
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, nil), 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, nil), 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, nil), 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, nil), 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, nil), 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, nil), 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, nil)
|
|
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, nil), 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, nil), 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, nil), 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, nil), 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, nil), 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, nil)
|
|
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, nil), 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, nil), 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, nil), 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, nil), 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, nil)
|
|
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, nil), 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, nil), checker.IsNil)
|
|
|
|
c.Assert(fileContentEquals(c, dstPath, "file1-1\n"), checker.IsNil)
|
|
}
|