> For the complete documentation index, see [llms.txt](https://camelgemonion.gitbook.io/docker/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://camelgemonion.gitbook.io/docker/dockerfile-zhi-ling/copy.md). # COPY **COPY有两种形式：** ``` COPY [--chown=:] ... COPY [--chown=:] ["",... ""] ``` 包含空白的路径需要后一种形式。 **NOTE:** **--chown**功能仅在用于构建**Linux**容器的**Dockerfiles**上受到支持，在**Windows**容器上不起作用。由于**用户**和**组所有权**概念无法在**Linux**和**Windows**之间进行转换，因此使用**/etc/passwd**和**/etc/group**将**用户名**和**组名**转换为**ID**限制了该功能，使得该功能仅适用于基于**Linux OS**的容器。 **COPY指令**从拷贝新的文件或目录，将它们添加到容器文件系统的指定路径中去。 每一个可能包含通配符的路径会通过**Go**的**filepath.Match（参考ADD中的解释）**规则进行匹配。例如： 添加所有文件名以**”hom“**开头的文件： ``` COPY hom* /mydir/ ``` 在下面的示例中，**?**可以被替换为任何单个字符，例如**"home.txt"**。 ``` COPY hom?.txt /mydir/ ``` 是绝对路径，或相对于WORKDIR的路径，源文件将被拷贝到目标容器所在文件系统的路径中。 下面的示例使用相对路径，并将**"test.txt“**添加到 **/relativeDir/**： ``` COPY test.txt relativeDir/ ``` 而此示例使用了绝对路径，并向**/absoluteDir/**添加了**"test.txt"** ``` COPY test.txt /absoluteDir/ ``` 在拷贝包含特殊字符的文件或目录（如 **\[和]**） 时，我们需要按照**Golang**规则对这些路径进行转义，以防止它们被视为匹配模式。例如，要添加名为 **arr\[0].txt**的文件，请使用以下文件： ``` COPY arr[[]0].txt /mydir/ ``` 所有新文件和目录均以值为**0**的**UID**和**GID**创建，除非通过可选的**--chown**指定**用户名**、**组名**或**UID/GID**组合，来为添加的内容指定**所有权(ownership)**。**--chown**允许使用**用户名和组名字符串的格式**，或直接使用**整数形式**的**UID**和**GID**。如果使用不带**组名**的**用户名**或不带**GID**的**UID**的形式，则会使用与**UID**相同的值来作为**GID**。如果提供了**用户名**或**组名**，则会根据容器根文件系统中的**/etc/passwd**和**/etc/group**文件来将**用户名**和**组名**从**name**的形式转换为**整数**的形式。以下示例显示了**--chown**的有效定义： ``` COPY --chown=55:mygroup files* /somedir/ COPY --chown=bin files* /somedir/ COPY --chown=1 files* /somedir/ COPY --chown=10:11 files* /somedir/ ``` 如果容器的根文件系统不包含**/etc/passwd**和**/etc/group**文件，并且以**用户**或**组名**的形式使用**--chown**，那么关于**COPY**构建的操作将会失败。使用**数值ID**形式的**用户**或**组**，则不需要查询且不会去依赖容器根文件系统的内容。 **NOTE:** 在构建镜像时，如果通过标准输入来传递**Dockerfile（docker build - < somefile)**，则不会存在构建上下文，**COPY**将无法被使用。 **COPY**接受可选的**--from=**选项标志，该标志可用于将拷贝的源位置设置为先前的构建阶段（使用**FROM .. AS** 创建），该阶段将代替用户发送给**docker守护进程**的构建上下文。如果找不到具有指定名称的构建阶段，则尝试改用具有相同名称的镜像。 示例： ``` ARG VERSION=7 FROM centos:$VERSION AS centos RUN mkdir test_dir && cd test_dir && touch file{1,2} && echo hello world > file1 FROM alpine:latest COPY --from=centos /test_dir/file1 /tmp CMD ["/bin/echo", "process finished"] ``` ```bash docker run -it camelgem/copy:v1 /bin/sh liuyang@liuyangdeiMac docker % docker run -it camelgem/copy:v1 /bin/sh $ cd /tmp && ls file1 # 通过上面的Dockerfile，我们将镜像centos中我们新创建的file文件,通过COPY指令的--from=选项标志拷贝到了alpine镜像的文件系统中。通过--from=centos，我们将COPY指令的上下文替换为centos文件系统的目录上下文，而不是我们在命令行指定的构建上下文。 ``` **COPY指令遵照以下规则：** * **\路径必须包含在构建上下文之中；不能使用COPY ../something /something, 因为docker build的第一步就是将上下文目录（及其子目录）发送给docker守护进程。** * **如果\是一个目录，整个目录的内容包括文件系统的元数据都会被拷贝到目标路径中。** **NOTE:** **目录本身并不会被拷贝，仅仅只是拷贝目录中的内容。** * 如果**\**是任意其他类型的文件，它和它的元数据会被单独拷贝。在这种情况下，如果**\**以斜线结尾，它会被当作目录，**\**的内容会被写入到**\/base(\)**。 * 如果通过直接或使用通配符的方式指定了多个**\**资源，那么**\**必须是一个目录，并且必须以斜线结尾。 * 如果**\**没有以斜线结尾，那么它会被当成一个正常的文件，而**\**的内容会被写入到这个文件中。 * 如果**\**不存在，那么会在它的路径下创建所有缺失的目录。 **NOTE:** 如果**\**中的内容被更改了，在构建镜像时，遇到的第一个**COPY指令**会使后续指令的缓存失效。这其中还包含了**RUN指令**的缓存。查看[**Dockerfile Best Practice guide - Leverage build cache**](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#leverage-build-cache)来获取更多信息。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://camelgemonion.gitbook.io/docker/dockerfile-zhi-ling/copy.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.