mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Looking into some broken links, I noticed that we don't need to use
relative paths, and also fixed some broken images. There are still more todo - next PR I think :) Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@fosiki.com> (github: SvenDowideit)
This commit is contained in:
parent
c932667cd2
commit
ada86fc5b7
42 changed files with 95 additions and 94 deletions
|
@ -116,11 +116,12 @@ pages:
|
||||||
- ['jsearch.md', '**HIDDEN**']
|
- ['jsearch.md', '**HIDDEN**']
|
||||||
|
|
||||||
# - ['static_files/README.md', 'static_files', 'README']
|
# - ['static_files/README.md', 'static_files', 'README']
|
||||||
#- ['terms/index.md', '**HIDDEN**']
|
- ['terms/index.md', '**HIDDEN**']
|
||||||
# - ['terms/layer.md', 'terms', 'layer']
|
- ['terms/layer.md', '**HIDDEN**', 'layer']
|
||||||
# - ['terms/index.md', 'terms', 'Home']
|
- ['terms/index.md', '**HIDDEN**', 'Home']
|
||||||
# - ['terms/registry.md', 'terms', 'registry']
|
- ['terms/registry.md', '**HIDDEN**', 'registry']
|
||||||
# - ['terms/container.md', 'terms', 'container']
|
- ['terms/container.md', '**HIDDEN**', 'container']
|
||||||
# - ['terms/repository.md', 'terms', 'repository']
|
- ['terms/repository.md', '**HIDDEN**', 'repository']
|
||||||
# - ['terms/filesystem.md', 'terms', 'filesystem']
|
- ['terms/filesystem.md', '**HIDDEN**', 'filesystem']
|
||||||
# - ['terms/image.md', 'terms', 'image']
|
- ['terms/image.md', '**HIDDEN**', 'image']
|
||||||
|
|
||||||
|
|
|
@ -5,7 +5,7 @@ page_keywords: Examples, Usage, base image, docker, documentation, examples
|
||||||
# Create a Base Image
|
# Create a Base Image
|
||||||
|
|
||||||
So you want to create your own [*Base Image*](
|
So you want to create your own [*Base Image*](
|
||||||
../../terms/image/#base-image-def)? Great!
|
/terms/image/#base-image-def)? Great!
|
||||||
|
|
||||||
The specific process will depend heavily on the Linux distribution you
|
The specific process will depend heavily on the Linux distribution you
|
||||||
want to package. We have some examples below, and you are encouraged to
|
want to package. We have some examples below, and you are encouraged to
|
||||||
|
|
|
@ -38,7 +38,7 @@ of another container. Of course, if the host system is setup
|
||||||
accordingly, containers can interact with each other through their
|
accordingly, containers can interact with each other through their
|
||||||
respective network interfaces — just like they can interact with
|
respective network interfaces — just like they can interact with
|
||||||
external hosts. When you specify public ports for your containers or use
|
external hosts. When you specify public ports for your containers or use
|
||||||
[*links*](../../use/working_with_links_names/#working-with-links-names)
|
[*links*](/use/working_with_links_names/#working-with-links-names)
|
||||||
then IP traffic is allowed between containers. They can ping each other,
|
then IP traffic is allowed between containers. They can ping each other,
|
||||||
send/receive UDP packets, and establish TCP connections, but that can be
|
send/receive UDP packets, and establish TCP connections, but that can be
|
||||||
restricted if necessary. From a network architecture point of view, all
|
restricted if necessary. From a network architecture point of view, all
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, networking, debian, ubuntu
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup).
|
> access*](/installation/binaries/#dockergroup).
|
||||||
> - **If you're using OS X or docker via TCP** then you shouldn't use
|
> - **If you're using OS X or docker via TCP** then you shouldn't use
|
||||||
> sudo.
|
> sudo.
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, networking, couchdb, data
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
Here's an example of using data volumes to share the same data between
|
Here's an example of using data volumes to share the same data between
|
||||||
two CouchDB containers. This could be used for hot upgrades, testing
|
two CouchDB containers. This could be used for hot upgrades, testing
|
||||||
|
|
|
@ -15,7 +15,7 @@ like `/var/lib/docker/repositories: permission denied`
|
||||||
you may have an incomplete Docker installation or insufficient
|
you may have an incomplete Docker installation or insufficient
|
||||||
privileges to access docker on your machine.
|
privileges to access docker on your machine.
|
||||||
|
|
||||||
Please refer to [*Installation*](../../installation/)
|
Please refer to [*Installation*](/installation/)
|
||||||
for installation instructions.
|
for installation instructions.
|
||||||
|
|
||||||
## Hello World
|
## Hello World
|
||||||
|
@ -26,7 +26,7 @@ for installation instructions.
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](#check-your-docker-installation).
|
> install*](#check-your-docker-installation).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
This is the most basic example available for using Docker.
|
This is the most basic example available for using Docker.
|
||||||
|
|
||||||
|
@ -71,7 +71,7 @@ See the example in action
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](#check-your-docker-installation).
|
> install*](#check-your-docker-installation).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
And now for the most boring daemon ever written!
|
And now for the most boring daemon ever written!
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, networking, mongodb
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
The goal of this example is to show how you can build your own Docker
|
The goal of this example is to show how you can build your own Docker
|
||||||
images with MongoDB pre-installed. We will do that by constructing a
|
images with MongoDB pre-installed. We will do that by constructing a
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, node, centos
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
The goal of this example is to show you how you can build your own
|
The goal of this example is to show you how you can build your own
|
||||||
Docker images from a parent image using a `Dockerfile`
|
Docker images from a parent image using a `Dockerfile`
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, postgresql
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
## Installing PostgreSQL on Docker
|
## Installing PostgreSQL on Docker
|
||||||
|
|
||||||
|
@ -87,7 +87,7 @@ And run the PostgreSQL server container (in the foreground):
|
||||||
$ sudo docker run -rm -P -name pg_test eg_postgresql
|
$ sudo docker run -rm -P -name pg_test eg_postgresql
|
||||||
|
|
||||||
There are 2 ways to connect to the PostgreSQL server. We can use [*Link
|
There are 2 ways to connect to the PostgreSQL server. We can use [*Link
|
||||||
Containers*](../../use/working_with_links_names/#working-with-links-names),
|
Containers*](/use/working_with_links_names/#working-with-links-names),
|
||||||
or we can access it from our host (or the network).
|
or we can access it from our host (or the network).
|
||||||
|
|
||||||
> **Note**:
|
> **Note**:
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, python, web app
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
While using Dockerfiles is the preferred way to create maintainable and
|
While using Dockerfiles is the preferred way to create maintainable and
|
||||||
repeatable images, its useful to know how you can try things out and
|
repeatable images, its useful to know how you can try things out and
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, networking, redis
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
Very simple, no frills, Redis service attached to a web application
|
Very simple, no frills, Redis service attached to a web application
|
||||||
using a link.
|
using a link.
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, example, package installation, networking, riak
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
The goal of this example is to show you how to build a Docker image with
|
The goal of this example is to show you how to build a Docker image with
|
||||||
Riak pre-installed.
|
Riak pre-installed.
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: docker, example, package installation, networking
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
The following Dockerfile sets up an sshd service in a container that you
|
The following Dockerfile sets up an sshd service in a container that you
|
||||||
can use to connect to and inspect other container's volumes, or to get
|
can use to connect to and inspect other container's volumes, or to get
|
||||||
|
|
|
@ -10,7 +10,7 @@ page_keywords: docker, supervisor, process management
|
||||||
> more information please see [*Check your Docker
|
> more information please see [*Check your Docker
|
||||||
> install*](../hello_world/#running-examples).
|
> install*](../hello_world/#running-examples).
|
||||||
> - **If you don't like sudo** then see [*Giving non-root
|
> - **If you don't like sudo** then see [*Giving non-root
|
||||||
> access*](../../installation/binaries/#dockergroup)
|
> access*](/installation/binaries/#dockergroup)
|
||||||
|
|
||||||
Traditionally a Docker container runs a single process when it is
|
Traditionally a Docker container runs a single process when it is
|
||||||
launched, for example an Apache daemon or a SSH server daemon. Often
|
launched, for example an Apache daemon or a SSH server daemon. Often
|
||||||
|
|
|
@ -59,8 +59,8 @@ add the *ubuntu* user to it so that you don't have to use
|
||||||
`sudo` for every Docker command.
|
`sudo` for every Docker command.
|
||||||
|
|
||||||
Once you`ve got Docker installed, you're ready to try it out – head on
|
Once you`ve got Docker installed, you're ready to try it out – head on
|
||||||
over to the [*First steps with Docker*](../../use/basics/) or
|
over to the [*First steps with Docker*](/use/basics/) or
|
||||||
[*Examples*](../../examples/) section.
|
[*Examples*](/examples/) section.
|
||||||
|
|
||||||
## Amazon QuickStart (Release Candidate - March 2014)
|
## Amazon QuickStart (Release Candidate - March 2014)
|
||||||
|
|
||||||
|
@ -100,4 +100,4 @@ QuickStart*](#amazon-quickstart) to pick an image (or use one of your
|
||||||
own) and skip the step with the *User Data*. Then continue with the
|
own) and skip the step with the *User Data*. Then continue with the
|
||||||
[*Ubuntu*](../ubuntulinux/#ubuntu-linux) instructions.
|
[*Ubuntu*](../ubuntulinux/#ubuntu-linux) instructions.
|
||||||
|
|
||||||
Continue with the [*Hello World*](../../examples/hello_world/#hello-world) example.
|
Continue with the [*Hello World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
|
@ -80,7 +80,7 @@ all the client commands.
|
||||||
> **Warning**:
|
> **Warning**:
|
||||||
> The *docker* group (or the group specified with `-G`) is root-equivalent;
|
> The *docker* group (or the group specified with `-G`) is root-equivalent;
|
||||||
> see [*Docker Daemon Attack Surface*](
|
> see [*Docker Daemon Attack Surface*](
|
||||||
> ../../articles/security/#dockersecurity-daemon) details.
|
> /articles/security/#dockersecurity-daemon) details.
|
||||||
|
|
||||||
## Upgrades
|
## Upgrades
|
||||||
|
|
||||||
|
@ -99,4 +99,4 @@ Then follow the regular installation steps.
|
||||||
# run a container and open an interactive shell in the container
|
# run a container and open an interactive shell in the container
|
||||||
sudo ./docker run -i -t ubuntu /bin/bash
|
sudo ./docker run -i -t ubuntu /bin/bash
|
||||||
|
|
||||||
Continue with the [*Hello World*](../../examples/hello_world/#hello-world) example.
|
Continue with the [*Hello World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
|
@ -61,4 +61,4 @@ Now let's verify that Docker is working.
|
||||||
sudo docker run -i -t fedora /bin/bash
|
sudo docker run -i -t fedora /bin/bash
|
||||||
|
|
||||||
**Done!**, now continue with the [*Hello
|
**Done!**, now continue with the [*Hello
|
||||||
World*](../../examples/hello_world/#hello-world) example.
|
World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
|
@ -143,7 +143,7 @@ If you feel the need to connect to the VM, you can simply run:
|
||||||
# Pwd: tcuser
|
# Pwd: tcuser
|
||||||
|
|
||||||
You can now continue with the [*Hello
|
You can now continue with the [*Hello
|
||||||
World*](../../examples/hello_world/#hello-world) example.
|
World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
||||||
## Learn More
|
## Learn More
|
||||||
|
|
||||||
|
|
|
@ -61,4 +61,4 @@ Docker daemon.
|
||||||
|
|
||||||
**Done!**
|
**Done!**
|
||||||
Now continue with the [*Hello World*](
|
Now continue with the [*Hello World*](
|
||||||
../../examples/hello_world/#hello-world) example.
|
/examples/hello_world/#hello-world) example.
|
||||||
|
|
|
@ -68,7 +68,7 @@ Now let's verify that Docker is working.
|
||||||
sudo docker run -i -t fedora /bin/bash
|
sudo docker run -i -t fedora /bin/bash
|
||||||
|
|
||||||
**Done!**
|
**Done!**
|
||||||
Now continue with the [*Hello World*](../../examples/hello_world/#hello-world) example.
|
Now continue with the [*Hello World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
||||||
## Issues?
|
## Issues?
|
||||||
|
|
||||||
|
|
|
@ -33,4 +33,4 @@ page_keywords: IBM SoftLayer, virtualization, cloud, docker, documentation, inst
|
||||||
instructions.
|
instructions.
|
||||||
|
|
||||||
Continue with the [*Hello World*](
|
Continue with the [*Hello World*](
|
||||||
../../examples/hello_world/#hello-world) example.
|
/examples/hello_world/#hello-world) example.
|
||||||
|
|
|
@ -96,7 +96,7 @@ Now verify that the installation has worked by downloading the
|
||||||
Type `exit` to exit
|
Type `exit` to exit
|
||||||
|
|
||||||
**Done!**, now continue with the [*Hello
|
**Done!**, now continue with the [*Hello
|
||||||
World*](../../examples/hello_world/#hello-world) example.
|
World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
||||||
## Ubuntu Raring 13.04 and Saucy 13.10 (64 bit)
|
## Ubuntu Raring 13.04 and Saucy 13.10 (64 bit)
|
||||||
|
|
||||||
|
@ -144,7 +144,7 @@ Now verify that the installation has worked by downloading the
|
||||||
Type `exit` to exit
|
Type `exit` to exit
|
||||||
|
|
||||||
**Done!**, now continue with the [*Hello
|
**Done!**, now continue with the [*Hello
|
||||||
World*](../../examples/hello_world/#hello-world) example.
|
World*](/examples/hello_world/#hello-world) example.
|
||||||
|
|
||||||
### Giving non-root access
|
### Giving non-root access
|
||||||
|
|
||||||
|
@ -168,7 +168,7 @@ than `docker` should own the Unix socket with the
|
||||||
> **Warning**:
|
> **Warning**:
|
||||||
> The *docker* group (or the group specified with `-G`) is
|
> The *docker* group (or the group specified with `-G`) is
|
||||||
> root-equivalent; see [*Docker Daemon Attack Surface*](
|
> root-equivalent; see [*Docker Daemon Attack Surface*](
|
||||||
> ../../articles/security/#dockersecurity-daemon) details.
|
> /articles/security/#dockersecurity-daemon) details.
|
||||||
|
|
||||||
**Example:**
|
**Example:**
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -540,7 +540,7 @@ Attach to the container `id`
|
||||||
|
|
||||||
When using the TTY setting is enabled in
|
When using the TTY setting is enabled in
|
||||||
[`POST /containers/create`
|
[`POST /containers/create`
|
||||||
](../../docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
](/api/docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
||||||
the stream is the raw data from the process PTY and client's stdin.
|
the stream is the raw data from the process PTY and client's stdin.
|
||||||
When the TTY is disabled, then the stream is multiplexed to separate
|
When the TTY is disabled, then the stream is multiplexed to separate
|
||||||
stdout and stderr.
|
stdout and stderr.
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -489,7 +489,7 @@ Attach to the container `id`
|
||||||
|
|
||||||
When using the TTY setting is enabled in
|
When using the TTY setting is enabled in
|
||||||
[`POST /containers/create`
|
[`POST /containers/create`
|
||||||
](../../docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
](/api/docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
||||||
the stream is the raw data from the process PTY and client's stdin.
|
the stream is the raw data from the process PTY and client's stdin.
|
||||||
When the TTY is disabled, then the stream is multiplexed to separate
|
When the TTY is disabled, then the stream is multiplexed to separate
|
||||||
stdout and stderr.
|
stdout and stderr.
|
||||||
|
@ -980,7 +980,7 @@ Build an image from Dockerfile via stdin
|
||||||
The archive must include a file called `Dockerfile`
|
The archive must include a file called `Dockerfile`
|
||||||
at its root. It may include any number of other files,
|
at its root. It may include any number of other files,
|
||||||
which will be accessible in the build context (See the [*ADD build
|
which will be accessible in the build context (See the [*ADD build
|
||||||
command*](../../../builder/#dockerbuilder)).
|
command*](/builder/#dockerbuilder)).
|
||||||
|
|
||||||
Query Parameters:
|
Query Parameters:
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -531,7 +531,7 @@ Attach to the container `id`
|
||||||
|
|
||||||
When using the TTY setting is enabled in
|
When using the TTY setting is enabled in
|
||||||
[`POST /containers/create`
|
[`POST /containers/create`
|
||||||
](../../docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
](/api/docker_remote_api_v1.9/#post--containers-create "POST /containers/create"),
|
||||||
the stream is the raw data from the process PTY and client's stdin.
|
the stream is the raw data from the process PTY and client's stdin.
|
||||||
When the TTY is disabled, then the stream is multiplexed to separate
|
When the TTY is disabled, then the stream is multiplexed to separate
|
||||||
stdout and stderr.
|
stdout and stderr.
|
||||||
|
@ -1024,7 +1024,7 @@ Build an image from Dockerfile via stdin
|
||||||
The archive must include a file called `Dockerfile`
|
The archive must include a file called `Dockerfile`
|
||||||
at its root. It may include any number of other files,
|
at its root. It may include any number of other files,
|
||||||
which will be accessible in the build context (See the [*ADD build
|
which will be accessible in the build context (See the [*ADD build
|
||||||
command*](../../../builder/#dockerbuilder)).
|
command*](/reference/builder/#dockerbuilder)).
|
||||||
|
|
||||||
Query Parameters:
|
Query Parameters:
|
||||||
|
|
||||||
|
|
|
@ -96,7 +96,7 @@ an Authorization Code.
|
||||||
prompt which asks the user to authorize your application with a
|
prompt which asks the user to authorize your application with a
|
||||||
description of the requested scopes.
|
description of the requested scopes.
|
||||||
|
|
||||||
![](../../../static_files/io_oauth_authorization_page.png)
|
![](/reference/api/_static/io_oauth_authorization_page.png)
|
||||||
|
|
||||||
Once the user allows or denies your Authorization Request the user
|
Once the user allows or denies your Authorization Request the user
|
||||||
will be redirected back to your application. Included in that
|
will be redirected back to your application. Included in that
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -1009,7 +1009,7 @@ Build an image from Dockerfile via stdin
|
||||||
The archive must include a file called `Dockerfile`
|
The archive must include a file called `Dockerfile`
|
||||||
at its root. It may include any number of other files,
|
at its root. It may include any number of other files,
|
||||||
which will be accessible in the build context (See the [*ADD build
|
which will be accessible in the build context (See the [*ADD build
|
||||||
command*](../../builder/#dockerbuilder)).
|
command*](/reference/builder/#dockerbuilder)).
|
||||||
|
|
||||||
Query Parameters:
|
Query Parameters:
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -1012,7 +1012,7 @@ Build an image from Dockerfile via stdin
|
||||||
The archive must include a file called `Dockerfile`
|
The archive must include a file called `Dockerfile`
|
||||||
at its root. It may include any number of other files,
|
at its root. It may include any number of other files,
|
||||||
which will be accessible in the build context (See the [*ADD build
|
which will be accessible in the build context (See the [*ADD build
|
||||||
command*](../../builder/#dockerbuilder)).
|
command*](/reference/builder/#dockerbuilder)).
|
||||||
|
|
||||||
Query Parameters:
|
Query Parameters:
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@ page_keywords: API, Docker, rcli, REST, documentation
|
||||||
- The Remote API has replaced rcli
|
- The Remote API has replaced rcli
|
||||||
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
- The daemon listens on `unix:///var/run/docker.sock` but you can
|
||||||
[*Bind Docker to another host/port or a Unix socket*](
|
[*Bind Docker to another host/port or a Unix socket*](
|
||||||
../../../use/basics/#bind-docker).
|
/use/basics/#bind-docker).
|
||||||
- The API tends to be REST, but for some complex commands, like `attach`
|
- The API tends to be REST, but for some complex commands, like `attach`
|
||||||
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
or `pull`, the HTTP connection is hijacked to transport `stdout, stdin`
|
||||||
and `stderr`
|
and `stderr`
|
||||||
|
@ -1022,7 +1022,7 @@ Build an image from Dockerfile using a POST body.
|
||||||
The archive must include a file called `Dockerfile`
|
The archive must include a file called `Dockerfile`
|
||||||
at its root. It may include any number of other files,
|
at its root. It may include any number of other files,
|
||||||
which will be accessible in the build context (See the [*ADD build
|
which will be accessible in the build context (See the [*ADD build
|
||||||
command*](../../builder/#dockerbuilder)).
|
command*](/reference/builder/#dockerbuilder)).
|
||||||
|
|
||||||
Query Parameters:
|
Query Parameters:
|
||||||
|
|
||||||
|
|
|
@ -95,7 +95,7 @@ supports:
|
||||||
|
|
||||||
### Pull
|
### Pull
|
||||||
|
|
||||||
![](../../../static_files/docker_pull_chart.png)
|
![](/static_files/docker_pull_chart.png)
|
||||||
|
|
||||||
1. Contact the Index to know where I should download “samalba/busybox”
|
1. Contact the Index to know where I should download “samalba/busybox”
|
||||||
2. Index replies: a. `samalba/busybox` is on Registry A b. here are the
|
2. Index replies: a. `samalba/busybox` is on Registry A b. here are the
|
||||||
|
@ -187,7 +187,7 @@ and for an active account.
|
||||||
|
|
||||||
### Push
|
### Push
|
||||||
|
|
||||||
![](../../../static_files/docker_push_chart.png)
|
![](/static_files/docker_push_chart.png)
|
||||||
|
|
||||||
1. Contact the index to allocate the repository name “samalba/busybox”
|
1. Contact the index to allocate the repository name “samalba/busybox”
|
||||||
(authentication required with user credentials)
|
(authentication required with user credentials)
|
||||||
|
|
|
@ -57,7 +57,7 @@ accelerating `docker build` significantly (indicated by `Using cache`):
|
||||||
|
|
||||||
When you're done with your build, you're ready to look into
|
When you're done with your build, you're ready to look into
|
||||||
[*Pushing a repository to its registry*](
|
[*Pushing a repository to its registry*](
|
||||||
../../use/workingwithrepository/#image-push).
|
/use/workingwithrepository/#image-push).
|
||||||
|
|
||||||
## Format
|
## Format
|
||||||
|
|
||||||
|
@ -71,7 +71,7 @@ be UPPERCASE in order to distinguish them from arguments more easily.
|
||||||
|
|
||||||
Docker evaluates the instructions in a Dockerfile in order. **The first
|
Docker evaluates the instructions in a Dockerfile in order. **The first
|
||||||
instruction must be \`FROM\`** in order to specify the [*Base
|
instruction must be \`FROM\`** in order to specify the [*Base
|
||||||
Image*](../../terms/image/#base-image-def) from which you are building.
|
Image*](/terms/image/#base-image-def) from which you are building.
|
||||||
|
|
||||||
Docker will treat lines that *begin* with `#` as a
|
Docker will treat lines that *begin* with `#` as a
|
||||||
comment. A `#` marker anywhere else in the line will
|
comment. A `#` marker anywhere else in the line will
|
||||||
|
@ -91,11 +91,11 @@ Or
|
||||||
|
|
||||||
FROM <image>:<tag>
|
FROM <image>:<tag>
|
||||||
|
|
||||||
The `FROM` instruction sets the [*Base Image*](../../terms/image/#base-image-def)
|
The `FROM` instruction sets the [*Base Image*](/terms/image/#base-image-def)
|
||||||
for subsequent instructions. As such, a valid Dockerfile must have `FROM` as
|
for subsequent instructions. As such, a valid Dockerfile must have `FROM` as
|
||||||
its first instruction. The image can be any valid image – it is especially easy
|
its first instruction. The image can be any valid image – it is especially easy
|
||||||
to start by **pulling an image** from the [*Public Repositories*](
|
to start by **pulling an image** from the [*Public Repositories*](
|
||||||
../../use/workingwithrepository/#using-public-repositories).
|
/use/workingwithrepository/#using-public-repositories).
|
||||||
|
|
||||||
`FROM` must be the first non-comment instruction in the Dockerfile.
|
`FROM` must be the first non-comment instruction in the Dockerfile.
|
||||||
|
|
||||||
|
@ -191,9 +191,9 @@ default specified in CMD.
|
||||||
The `EXPOSE` instructions informs Docker that the container will listen on the
|
The `EXPOSE` instructions informs Docker that the container will listen on the
|
||||||
specified network ports at runtime. Docker uses this information to interconnect
|
specified network ports at runtime. Docker uses this information to interconnect
|
||||||
containers using links (see
|
containers using links (see
|
||||||
[*links*](../../use/working_with_links_names/#working-with-links-names)),
|
[*links*](/use/working_with_links_names/#working-with-links-names)),
|
||||||
and to setup port redirection on the host system (see [*Redirect Ports*](
|
and to setup port redirection on the host system (see [*Redirect Ports*](
|
||||||
../../use/port_redirection/#port-redirection)).
|
/use/port_redirection/#port-redirection)).
|
||||||
|
|
||||||
## ENV
|
## ENV
|
||||||
|
|
||||||
|
@ -327,7 +327,7 @@ The `VOLUME` instruction will create a mount point with the specified name
|
||||||
and mark it as holding externally mounted volumes from native host or other
|
and mark it as holding externally mounted volumes from native host or other
|
||||||
containers. For more information/examples and mounting instructions via docker
|
containers. For more information/examples and mounting instructions via docker
|
||||||
client, refer to [*Share Directories via Volumes*](
|
client, refer to [*Share Directories via Volumes*](
|
||||||
../../use/working_with_volumes/#volume-def) documentation.
|
/use/working_with_volumes/#volume-def) documentation.
|
||||||
|
|
||||||
## USER
|
## USER
|
||||||
|
|
||||||
|
|
|
@ -197,7 +197,7 @@ and a "context".
|
||||||
|
|
||||||
The files at `PATH` or `URL` are called the "context" of the build. The build
|
The files at `PATH` or `URL` are called the "context" of the build. The build
|
||||||
process may refer to any of the files in the context, for example when using an
|
process may refer to any of the files in the context, for example when using an
|
||||||
[*ADD*](../../builder/#dockerfile-add) instruction. When a single Dockerfile is
|
[*ADD*](/reference/builder/#dockerfile-add) instruction. When a single Dockerfile is
|
||||||
given as `URL`, then no context is set.
|
given as `URL`, then no context is set.
|
||||||
|
|
||||||
When a Git repository is set as `URL`, then the
|
When a Git repository is set as `URL`, then the
|
||||||
|
@ -209,7 +209,7 @@ vpn's etc can be used to access private repositories
|
||||||
|
|
||||||
See also:
|
See also:
|
||||||
|
|
||||||
[*Dockerfile Reference*](../../builder/#dockerbuilder).
|
[*Dockerfile Reference*](/reference/builder/#dockerbuilder).
|
||||||
|
|
||||||
### Examples:
|
### Examples:
|
||||||
|
|
||||||
|
@ -248,7 +248,7 @@ machine and that no parsing of the Dockerfile
|
||||||
happens at the client side (where you're running
|
happens at the client side (where you're running
|
||||||
`docker build`). That means that *all* the files at
|
`docker build`). That means that *all* the files at
|
||||||
`PATH` get sent, not just the ones listed to
|
`PATH` get sent, not just the ones listed to
|
||||||
[*ADD*](../../builder/#dockerfile-add) in the Dockerfile.
|
[*ADD*](/reference/builder/#dockerfile-add) in the Dockerfile.
|
||||||
|
|
||||||
The transfer of context from the local machine to the Docker daemon is
|
The transfer of context from the local machine to the Docker daemon is
|
||||||
what the `docker` client means when you see the
|
what the `docker` client means when you see the
|
||||||
|
@ -843,10 +843,10 @@ of all containers.
|
||||||
The `docker run` command can be used in combination with `docker commit` to
|
The `docker run` command can be used in combination with `docker commit` to
|
||||||
[*change the command that a container runs*](#commit-an-existing-container).
|
[*change the command that a container runs*](#commit-an-existing-container).
|
||||||
|
|
||||||
See [*Redirect Ports*](../../../use/port_redirection/#port-redirection)
|
See [*Redirect Ports*](/use/port_redirection/#port-redirection)
|
||||||
for more detailed information about the `--expose`, `-p`, `-P` and `--link`
|
for more detailed information about the `--expose`, `-p`, `-P` and `--link`
|
||||||
parameters, and [*Link Containers*](
|
parameters, and [*Link Containers*](
|
||||||
../../../use/working_with_links_names/#working-with-links-names) for specific
|
/use/working_with_links_names/#working-with-links-names) for specific
|
||||||
examples using `--link`.
|
examples using `--link`.
|
||||||
|
|
||||||
### Known Issues (run –volumes-from)
|
### Known Issues (run –volumes-from)
|
||||||
|
@ -914,14 +914,14 @@ manipulate the host's docker daemon.
|
||||||
$ sudo docker run -p 127.0.0.1:80:8080 ubuntu bash
|
$ sudo docker run -p 127.0.0.1:80:8080 ubuntu bash
|
||||||
|
|
||||||
This binds port `8080` of the container to port `80` on `127.0.0.1` of the host
|
This binds port `8080` of the container to port `80` on `127.0.0.1` of the host
|
||||||
machine. [*Redirect Ports*](../../../use/port_redirection/#port-redirection)
|
machine. [*Redirect Ports*](/use/port_redirection/#port-redirection)
|
||||||
explains in detail how to manipulate ports in Docker.
|
explains in detail how to manipulate ports in Docker.
|
||||||
|
|
||||||
$ sudo docker run --expose 80 ubuntu bash
|
$ sudo docker run --expose 80 ubuntu bash
|
||||||
|
|
||||||
This exposes port `80` of the container for use within a link without publishing
|
This exposes port `80` of the container for use within a link without publishing
|
||||||
the port to the host system's interfaces. [*Redirect Ports*](
|
the port to the host system's interfaces. [*Redirect Ports*](
|
||||||
../../../use/port_redirection/#port-redirection) explains in detail how to
|
/use/port_redirection/#port-redirection) explains in detail how to
|
||||||
manipulate ports in Docker.
|
manipulate ports in Docker.
|
||||||
|
|
||||||
$ sudo docker run -e MYVAR1 --env MYVAR2=foo --env-file ./env.list ubuntu bash
|
$ sudo docker run -e MYVAR1 --env MYVAR2=foo --env-file ./env.list ubuntu bash
|
||||||
|
@ -1074,7 +1074,7 @@ Search the docker index for images
|
||||||
-t, --trusted=false: Only show trusted builds
|
-t, --trusted=false: Only show trusted builds
|
||||||
|
|
||||||
See [*Find Public Images on the Central Index*](
|
See [*Find Public Images on the Central Index*](
|
||||||
../../../use/workingwithrepository/#searching-central-index) for
|
/use/workingwithrepository/#searching-central-index) for
|
||||||
more details on finding shared images from the commandline.
|
more details on finding shared images from the commandline.
|
||||||
|
|
||||||
## start
|
## start
|
||||||
|
@ -1107,7 +1107,7 @@ Tag an image into a repository
|
||||||
|
|
||||||
You can group your images together using names and tags, and then upload
|
You can group your images together using names and tags, and then upload
|
||||||
them to [*Share Images via Repositories*](
|
them to [*Share Images via Repositories*](
|
||||||
../../../use/workingwithrepository/#working-with-the-repository).
|
/use/workingwithrepository/#working-with-the-repository).
|
||||||
|
|
||||||
## top
|
## top
|
||||||
|
|
||||||
|
@ -1124,4 +1124,4 @@ version.
|
||||||
|
|
||||||
Usage: docker wait [OPTIONS] NAME
|
Usage: docker wait [OPTIONS] NAME
|
||||||
|
|
||||||
Block until a container stops, then print its exit code.
|
Block until a container stops, then print its exit code.
|
||||||
|
|
|
@ -7,25 +7,25 @@ page_keywords: docker, run, configure, runtime
|
||||||
**Docker runs processes in isolated containers**. When an operator
|
**Docker runs processes in isolated containers**. When an operator
|
||||||
executes `docker run`, she starts a process with its
|
executes `docker run`, she starts a process with its
|
||||||
own file system, its own networking, and its own isolated process tree.
|
own file system, its own networking, and its own isolated process tree.
|
||||||
The [*Image*](../../terms/image/#image-def) which starts the process may
|
The [*Image*](/terms/image/#image-def) which starts the process may
|
||||||
define defaults related to the binary to run, the networking to expose,
|
define defaults related to the binary to run, the networking to expose,
|
||||||
and more, but `docker run` gives final control to
|
and more, but `docker run` gives final control to
|
||||||
the operator who starts the container from the image. That's the main
|
the operator who starts the container from the image. That's the main
|
||||||
reason [*run*](../../commandline/cli/#cli-run) has more options than any
|
reason [*run*](/commandline/cli/#cli-run) has more options than any
|
||||||
other `docker` command.
|
other `docker` command.
|
||||||
|
|
||||||
Every one of the [*Examples*](../../examples/#example-list) shows
|
Every one of the [*Examples*](/examples/#example-list) shows
|
||||||
running containers, and so here we try to give more in-depth guidance.
|
running containers, and so here we try to give more in-depth guidance.
|
||||||
|
|
||||||
## General Form
|
## General Form
|
||||||
|
|
||||||
As you`ve seen in the [*Examples*](../../examples/#example-list), the
|
As you`ve seen in the [*Examples*](/examples/#example-list), the
|
||||||
basic run command takes this form:
|
basic run command takes this form:
|
||||||
|
|
||||||
docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...]
|
docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...]
|
||||||
|
|
||||||
To learn how to interpret the types of `[OPTIONS]`,
|
To learn how to interpret the types of `[OPTIONS]`,
|
||||||
see [*Option types*](../../commandline/cli/#cli-options).
|
see [*Option types*](/commandline/cli/#cli-options).
|
||||||
|
|
||||||
The list of `[OPTIONS]` breaks down into two groups:
|
The list of `[OPTIONS]` breaks down into two groups:
|
||||||
|
|
||||||
|
@ -121,7 +121,7 @@ assign a name to the container with `--name` then
|
||||||
the daemon will also generate a random string name too. The name can
|
the daemon will also generate a random string name too. The name can
|
||||||
become a handy way to add meaning to a container since you can use this
|
become a handy way to add meaning to a container since you can use this
|
||||||
name when defining
|
name when defining
|
||||||
[*links*](../../use/working_with_links_names/#working-with-links-names)
|
[*links*](/use/working_with_links_names/#working-with-links-names)
|
||||||
(or any other place you need to identify a container). This works for
|
(or any other place you need to identify a container). This works for
|
||||||
both background and foreground Docker containers.
|
both background and foreground Docker containers.
|
||||||
|
|
||||||
|
@ -372,7 +372,7 @@ And we can use that information to connect from another container as a client:
|
||||||
--volumes-from="": Mount all volumes from the given container(s)
|
--volumes-from="": Mount all volumes from the given container(s)
|
||||||
|
|
||||||
The volumes commands are complex enough to have their own documentation in
|
The volumes commands are complex enough to have their own documentation in
|
||||||
section [*Share Directories via Volumes*](../../use/working_with_volumes/#volume-def).
|
section [*Share Directories via Volumes*](/use/working_with_volumes/#volume-def).
|
||||||
A developer can define one or more `VOLUME's associated with an image, but only the
|
A developer can define one or more `VOLUME's associated with an image, but only the
|
||||||
operator can give access from one container to another (or from a container to a
|
operator can give access from one container to another (or from a container to a
|
||||||
volume mounted on the host).
|
volume mounted on the host).
|
||||||
|
|
|
@ -6,7 +6,7 @@ page_keywords: containers, lxc, concepts, explanation, image, container
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-busyboxrw.png)
|
![](/terms/images/docker-filesystems-busyboxrw.png)
|
||||||
|
|
||||||
Once you start a process in Docker from an [*Image*](image.md), Docker fetches
|
Once you start a process in Docker from an [*Image*](image.md), Docker fetches
|
||||||
the image and its [*Parent Image*](image.md), and repeats the process until it
|
the image and its [*Parent Image*](image.md), and repeats the process until it
|
||||||
|
|
|
@ -6,7 +6,7 @@ page_keywords: containers, files, linux
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-generic.png)
|
![](/terms/images/docker-filesystems-generic.png)
|
||||||
|
|
||||||
In order for a Linux system to run, it typically needs two [file
|
In order for a Linux system to run, it typically needs two [file
|
||||||
systems](http://en.wikipedia.org/wiki/Filesystem):
|
systems](http://en.wikipedia.org/wiki/Filesystem):
|
||||||
|
@ -32,4 +32,4 @@ usually what make your software packages dependent on one distribution
|
||||||
versus another. Docker can help solve this problem by running multiple
|
versus another. Docker can help solve this problem by running multiple
|
||||||
distributions at the same time.
|
distributions at the same time.
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-multiroot.png)
|
![](/terms/images/docker-filesystems-multiroot.png)
|
||||||
|
|
|
@ -6,7 +6,7 @@ page_keywords: containers, lxc, concepts, explanation, image, container
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-debian.png)
|
![](/terms/images/docker-filesystems-debian.png)
|
||||||
|
|
||||||
In Docker terminology, a read-only [*Layer*](../layer/#layer-def) is
|
In Docker terminology, a read-only [*Layer*](../layer/#layer-def) is
|
||||||
called an **image**. An image never changes.
|
called an **image**. An image never changes.
|
||||||
|
@ -17,11 +17,11 @@ changes go to the top-most writeable layer, and underneath, the original
|
||||||
file in the read-only image is unchanged. Since images don't change,
|
file in the read-only image is unchanged. Since images don't change,
|
||||||
images do not have state.
|
images do not have state.
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-debianrw.png)
|
![](/terms/images/docker-filesystems-debianrw.png)
|
||||||
|
|
||||||
## Parent Image
|
## Parent Image
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-multilayer.png)
|
![](/terms/images/docker-filesystems-multilayer.png)
|
||||||
|
|
||||||
Each image may depend on one more image which forms the layer beneath
|
Each image may depend on one more image which forms the layer beneath
|
||||||
it. We sometimes say that the lower image is the **parent** of the upper
|
it. We sometimes say that the lower image is the **parent** of the upper
|
||||||
|
|
|
@ -20,7 +20,7 @@ file system *over* the read-only file system. In fact there may be
|
||||||
multiple read-only file systems stacked on top of each other. We think
|
multiple read-only file systems stacked on top of each other. We think
|
||||||
of each one of these file systems as a **layer**.
|
of each one of these file systems as a **layer**.
|
||||||
|
|
||||||
![](../../static_files/docker-filesystems-multilayer.png)
|
![](/terms/images/docker-filesystems-multilayer.png)
|
||||||
|
|
||||||
At first, the top read-write layer has nothing in it, but any time a
|
At first, the top read-write layer has nothing in it, but any time a
|
||||||
process creates a file, this happens in the top layer. And if something
|
process creates a file, this happens in the top layer. And if something
|
||||||
|
|
|
@ -17,7 +17,7 @@ like `/var/lib/docker/repositories: permission denied`
|
||||||
you may have an incomplete docker installation or insufficient
|
you may have an incomplete docker installation or insufficient
|
||||||
privileges to access Docker on your machine.
|
privileges to access Docker on your machine.
|
||||||
|
|
||||||
Please refer to [*Installation*](../../installation/#installation-list)
|
Please refer to [*Installation*](/installation/#installation-list)
|
||||||
for installation instructions.
|
for installation instructions.
|
||||||
|
|
||||||
## Download a pre-built image
|
## Download a pre-built image
|
||||||
|
@ -172,4 +172,4 @@ You now have a image state from which you can create new instances.
|
||||||
|
|
||||||
Read more about [*Share Images via Repositories*](
|
Read more about [*Share Images via Repositories*](
|
||||||
../workingwithrepository/#working-with-the-repository) or
|
../workingwithrepository/#working-with-the-repository) or
|
||||||
continue to the complete [*Command Line*](../../reference/commandline/cli/#cli)
|
continue to the complete [*Command Line*](/reference/commandline/cli/#cli)
|
||||||
|
|
|
@ -7,7 +7,7 @@ page_keywords: chef, installation, usage, docker, documentation
|
||||||
> **Note**:
|
> **Note**:
|
||||||
> Please note this is a community contributed installation path. The only
|
> Please note this is a community contributed installation path. The only
|
||||||
> `official` installation is using the
|
> `official` installation is using the
|
||||||
> [*Ubuntu*](../../installation/ubuntulinux/#ubuntu-linux) installation
|
> [*Ubuntu*](/installation/ubuntulinux/#ubuntu-linux) installation
|
||||||
> path. This version may sometimes be out of date.
|
> path. This version may sometimes be out of date.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
|
@ -6,7 +6,7 @@ page_keywords: puppet, installation, usage, docker, documentation
|
||||||
|
|
||||||
> *Note:* Please note this is a community contributed installation path. The
|
> *Note:* Please note this is a community contributed installation path. The
|
||||||
> only `official` installation is using the
|
> only `official` installation is using the
|
||||||
> [*Ubuntu*](../../installation/ubuntulinux/#ubuntu-linux) installation
|
> [*Ubuntu*](/installation/ubuntulinux/#ubuntu-linux) installation
|
||||||
> path. This version may sometimes be out of date.
|
> path. This version may sometimes be out of date.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
|
@ -8,7 +8,7 @@ page_keywords: Examples, Usage, volume, docker, documentation, examples
|
||||||
|
|
||||||
A *data volume* is a specially-designated directory within one or more
|
A *data volume* is a specially-designated directory within one or more
|
||||||
containers that bypasses the [*Union File
|
containers that bypasses the [*Union File
|
||||||
System*](../../terms/layer/#ufs-def) to provide several useful features
|
System*](/terms/layer/#ufs-def) to provide several useful features
|
||||||
for persistent or shared data:
|
for persistent or shared data:
|
||||||
|
|
||||||
- **Data volumes can be shared and reused between containers:**
|
- **Data volumes can be shared and reused between containers:**
|
||||||
|
@ -20,7 +20,7 @@ for persistent or shared data:
|
||||||
very large files.
|
very large files.
|
||||||
- **Changes to a data volume will not be included at the next commit:**
|
- **Changes to a data volume will not be included at the next commit:**
|
||||||
Because they are not recorded as regular filesystem changes in the
|
Because they are not recorded as regular filesystem changes in the
|
||||||
top layer of the [*Union File System*](../../terms/layer/#ufs-def)
|
top layer of the [*Union File System*](/terms/layer/#ufs-def)
|
||||||
- **Volumes persist until no containers use them:**
|
- **Volumes persist until no containers use them:**
|
||||||
As they are a reference counted resource. The container does not need to be
|
As they are a reference counted resource. The container does not need to be
|
||||||
running to share its volumes, but running it can help protect it
|
running to share its volumes, but running it can help protect it
|
||||||
|
|
|
@ -7,7 +7,7 @@ page_keywords: repo, repositories, usage, pull image, push image, image, documen
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
A *repository* is a shareable collection of tagged
|
A *repository* is a shareable collection of tagged
|
||||||
[*images*](../../terms/image/#image-def) that together create the file
|
[*images*](/terms/image/#image-def) that together create the file
|
||||||
systems for containers. The repository's name is a label that indicates
|
systems for containers. The repository's name is a label that indicates
|
||||||
the provenance of the repository, i.e. who created it and where the
|
the provenance of the repository, i.e. who created it and where the
|
||||||
original copy is located.
|
original copy is located.
|
||||||
|
@ -19,7 +19,7 @@ the home of "top-level" repositories and the Central Index. This
|
||||||
registry may also include public "user" repositories.
|
registry may also include public "user" repositories.
|
||||||
|
|
||||||
Docker is not only a tool for creating and managing your own
|
Docker is not only a tool for creating and managing your own
|
||||||
[*containers*](../../terms/container/#container-def) – **Docker is also
|
[*containers*](/terms/container/#container-def) – **Docker is also
|
||||||
a tool for sharing**. The Docker project provides a Central Registry to
|
a tool for sharing**. The Docker project provides a Central Registry to
|
||||||
host public repositories, namespaced by user, and a Central Index which
|
host public repositories, namespaced by user, and a Central Index which
|
||||||
provides user authentication and search over all the public
|
provides user authentication and search over all the public
|
||||||
|
@ -89,7 +89,7 @@ Once you have found the image name, you can download it:
|
||||||
539c0211cd76: Download complete
|
539c0211cd76: Download complete
|
||||||
|
|
||||||
What can you do with that image? Check out the
|
What can you do with that image? Check out the
|
||||||
[*Examples*](../../examples/#example-list) and, when you're ready with
|
[*Examples*](/examples/#example-list) and, when you're ready with
|
||||||
your own image, come back here to learn how to share it.
|
your own image, come back here to learn how to share it.
|
||||||
|
|
||||||
## Contributing to the Central Registry
|
## Contributing to the Central Registry
|
||||||
|
|
Loading…
Add table
Reference in a new issue