1
0
Fork 0
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:
Zac Dover 2014-05-19 03:21:31 +10:00
parent 7393eafde7
commit 41a913b390

View 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.