mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Dockerfile.5.md stub
Properly formatted DCO: Docker-DCO-1.1-Signed-off-by: Zac Dover <zdover@redhat.com> (github: zdover23) Docker-DCO-1.1-Signed-off-by: Zac Dover <zdover@redhat.com> (github: )
This commit is contained in:
parent
7393eafde7
commit
41a913b390
1 changed files with 41 additions and 0 deletions
41
contrib/man/md/Dockerfile.5.md
Normal file
41
contrib/man/md/Dockerfile.5.md
Normal file
|
@ -0,0 +1,41 @@
|
|||
% DOCKERFILE(1) Docker User Manuals
|
||||
% Zac Dover
|
||||
% May 2014
|
||||
# NAME
|
||||
|
||||
Dockerfile - automate the steps of creating a Docker image
|
||||
|
||||
# INTRODUCTION
|
||||
**Dockerfile** is a configuration file that automates the steps of creating a Docker image. Docker can act as a builder and can read instructions from **Dockerfile** to automate the steps that you would otherwise manually perform to create an image. To build an image from a source repository, create a description file called **Dockerfile** at the root of your repository. This file describes the steps that will be taken to assemble the image. When **Dockerfile** has been created, call **docker build** with the path of the source repository as the argument.
|
||||
|
||||
# SYNOPSIS
|
||||
|
||||
INSTRUCTION arguments
|
||||
|
||||
For example:
|
||||
|
||||
FROM image
|
||||
|
||||
# DESCRIPTION
|
||||
|
||||
Dockerfile is a file that automates the steps of creating a Docker image.
|
||||
|
||||
# USAGE
|
||||
|
||||
$ sudo docker build .
|
||||
-- runs the steps and commits them, building a final image
|
||||
The path to the source repository defines where to find the context of the build.
|
||||
The build is run by the docker daemon, not the CLI. The whole context must be
|
||||
transferred to the daemon. The Docker CLI reports "Uploading context" when the
|
||||
context is sent to the daemon.
|
||||
|
||||
$ sudo docker build -t repository/tag .
|
||||
-- specifies a repository and tag at which to save the new image if the build succeeds.
|
||||
The Docker daemon runs the steps one-by-one, commiting the result to a new image
|
||||
if necessary before finally outputting the ID of the new image. The Docker
|
||||
daemon automatically cleans up the context it is given.
|
||||
|
||||
Docker re-uses intermediate images whenever possible. This significantly accelerates the *docker build* process.
|
||||
|
||||
# HISTORY
|
||||
May 2014, Compiled by Zac Dover (zdover at redhat dot com) based on docker.io Dockerfile documentation.
|
Loading…
Reference in a new issue