Can you use the Docker copy instruction to copy files from your local machine or from remote urls?

Nội dung chính Show

• Docker to host file copy command
• Docker file copy command
• How to Docker copy files to host
• Docker cp command example
• Monthly Docker Tips
• In the Beginning...
• Too Much Magic
• Like ADD, But Less
• Which to Use?
• Can you use the Docker copy instruction to copy files from your local machine to a container?
• Which instruction is used in Dockerfile to copy the files from remote URL to Docker container?
• How do I copy a file from Docker to local?
• Can you copy a file into a Docker image?

Docker to host file copy command

For those just looking for the command to copy a file from inside a Docker container to the local file system on the host machine, here it is:

sudo docker cp container-id:/path/filename.txt ~/Desktop/filename.txt

Docker file copy command

This Docker copy (cp) command takes a file that exists inside a Docker container and saves it to your computer’s local file system.

The container-name specified in the example command can be either the name given to the Docker container when it was started, or the unique ID that Docker assigned to the container.

After you specify the container name or ID, simply provide the full path to the file you want to copy, and then provide the name of the destination folder on the host system.

By default, the file inside Docker will be saved to the host machine with the same name, but you have the option to rename the file as it is copied.

sudo docker cp container-id:/path/filename.txt ~/Desktop/filename.txt

How to Docker copy files to host

To summarize, follow these steps to copy a file from a Docker container to a host machine:

1. Obtain the name or id of the Docker container
2. Issue the docker cp command and reference the container name or id
3. The first parameter of the docker copy command is the path to the file inside the container
4. The second parameter of the docker copy command is the location to save the file on the host
5. Edit and use the file copied from inside the container to your host machine

Docker cp command example

Copying a file from inside a Docker container to the host is a great way to create a custom Docker image.

For example, you could run the official Nginx Docker image and then copy the Nginx configuration file to the local filesystem.

Then you could edit the config file to setup an Nginx reverse proxy or install PHP support.

You could easily create a Dockerfile that copies the edited config file back into your Nginx load balancer image to override the default behavior. From that, you could create a custom Docker image.

This would result in a customized Docker image for your environment that is built upon the best practices and experience of the experts who originally developed the Nginx Docker image.

This blog post will help you understand the differences between two similar Dockerfile instructions – ADD and COPY – how they became what they are today, and our recommendation on which instruction you should use. (Hint: It's not ADD)

When building Docker images from a Dockerfile you have two instructions you can choose from to add directories/files to your image: ADD and COPY. Both instructions follow the same basic form and accomplish pretty much the same thing:

In both cases, directories or files (the <src>) are copied and added to the filesystem of the container at the specified <dest> path.

So if both instructions are equivalent, why do they both exist and which one should you use? Read on to find out.

TL;DR

If you're not interested in the nuances of ADD and COPY and just want an answer to "which one should I use?", all you need to know is: use COPY.

Monthly Docker Tips

In the Beginning...

Unlike the COPY instruction, ADD was part of Docker from the beginning and supports a few additional tricks beyond simply copying files from the build context.

The ADD instruction allows you to use a URL as the <src> parameter. When a URL is provided, a file is downloaded from the URL and copied to the <dest>.

The file above will be downloaded from the specified URL and added to the container's filesystem at /tmp/main.go. Another form allows you to simply specify the destination directory for the downloaded file:

Because the <dest> argument ends with a trailing slash, Docker will infer the filename from the URL and add it to the specified directory. In this case, a file named /tmp/bar.go will be added to the container's filesystem.

Another feature of ADD is the ability to automatically unpack compressed files. If the <src> argument is a local file in a recognized compression format (tar, gzip, bzip2, etc) then it is unpacked at the specified <dest> in the container's filesystem.

The command above would result in the contents of the foo.tar.gz archive being unpacked into the container's /tmp directory.

Interestingly, the URL download and archive unpacking features cannot be used together. Any archives copied via URL will NOT be automatically unpacked.

Too Much Magic

Clearly, there is a lot of functionality behind the simple ADD instruction. While this makes ADD quite versatile it does NOT make it particularly predictable. Here's a quote from an issue that was logged against the ADD command back in December of 2013:

Currently the ADD command is IMO far too magical. It can add local and remote files. It will sometimes untar a file and it will sometimes not untar a file. If a file is a tarball that you want to copy, you accidentally untar it. If the file is a tarball in some unrecognized compressed format that you want to untar, you accidentally copy it. - amluto

The consensus seemed to be that ADD tried to do too much and was confusing to the user. Obviously, no one wanted to break backward compatibility with existing usage of ADD, so it was decided that a new instruction would be added which behaved more predictably.

Like ADD, But Less

When version 1.0 of Docker was released the new COPY instruction was included. Unlike ADD, COPY does a straight-forward, as-is copy of files and folders from the build context into the container.

COPY doesn't support URLs as a <src> argument so it can't be used to download files from remote locations. Anything that you want to COPY into the container must be present in the local build context.

Also, COPY doesn't give any special treatment to archives. If you COPY an archive file it will land in the container exactly as it appears in the build context without any attempt to unpack it.

COPY is really just a stripped-down version of ADD that aims to meet the majority of the "copy-files-to-container" use cases without any surprises.

Which to Use?

In case it isn't obvious by now, the recommendation from the Docker team is to use COPY in almost all cases.

Really, the only reason to use ADD is when you have an archive file that you definitely want to have auto-extracted into the image. Ideally, ADD would be renamed to something like EXTRACT to really drive this point home (again, for backward-compatibility reasons, this is unlikely to happen).

OK, but what about fetching packages from remote URLs, isn't ADD still useful for that? Technically, yes, but in most cases you're probably better off RUNning a curl or wget. Consider the following example:

Here we have an ADD instruction which retrieves a package from a URL followed by a RUN instruction which unpacks it, builds it and then attempts to clean-up the downloaded archive.

Unfortunately, since the package retrieval and the rm command are in separate image layers we don't actually save any space in our final image (for a more detailed explanation of this phenomenon, see my Optimizing Docker Images article).

In this case you're better off doing something like this:

Here we curl the package and pipe it right into the tar command for extraction. This way we aren't left with an archive file on the filesystem that we need to clean-up.

There may still be valid reasons to ADD a remote file to your image, but that should be an explicit decision and not your default choice.

Ultimately, the rule is this: use COPY (unless you're absolutely sure you need ADD).

Don't have a CenturyLink account? No problem. Just head over to our website and activate an account.

Can you use the Docker copy instruction to copy files from your local machine to a container?

Which instruction is used in Dockerfile to copy the files from remote URL to Docker container?

How do I copy a file from Docker to local?

Can you copy a file into a Docker image?