mirror of https://github.com/docker/docs.git
blindly make all uses of e\.?g\.? into e.g.,
Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit)
This commit is contained in:
parent
b44e13ae02
commit
fde10cf87b
|
@ -70,7 +70,7 @@ in their shell:
|
||||||
|
|
||||||
### Images
|
### Images
|
||||||
|
|
||||||
When you need to add images, try to make them as small as possible (e.g. as
|
When you need to add images, try to make them as small as possible (e.g., as
|
||||||
gifs). Usually images should go in the same directory as the `.md` file which
|
gifs). Usually images should go in the same directory as the `.md` file which
|
||||||
references them, or in a subdirectory if one already exists.
|
references them, or in a subdirectory if one already exists.
|
||||||
|
|
||||||
|
|
|
@ -14,7 +14,7 @@ Using an existing container's name or ID you can create a new image.
|
||||||
|
|
||||||
# OPTIONS
|
# OPTIONS
|
||||||
**-a, --author**=""
|
**-a, --author**=""
|
||||||
Author name. (e.g. "John Hannibal Smith <hannibal@a-team.com>"
|
Author name. (e.g., "John Hannibal Smith <hannibal@a-team.com>"
|
||||||
|
|
||||||
**-m, --message**=""
|
**-m, --message**=""
|
||||||
Commit message
|
Commit message
|
||||||
|
|
|
@ -17,7 +17,7 @@ docker-images - List the images in the local repository
|
||||||
This command lists the images stored in the local Docker repository.
|
This command lists the images stored in the local Docker repository.
|
||||||
|
|
||||||
By default, intermediate images, used during builds, are not listed. Some of the
|
By default, intermediate images, used during builds, are not listed. Some of the
|
||||||
output, e.g. image ID, is truncated, for space reasons. However the truncated
|
output, e.g., image ID, is truncated, for space reasons. However the truncated
|
||||||
image ID, and often the first few characters, are enough to be used in other
|
image ID, and often the first few characters, are enough to be used in other
|
||||||
Docker commands that use the image ID. The output includes repository, tag, image
|
Docker commands that use the image ID. The output includes repository, tag, image
|
||||||
ID, date created and the virtual size.
|
ID, date created and the virtual size.
|
||||||
|
|
|
@ -142,7 +142,7 @@ output:
|
||||||
|
|
||||||
## Getting information on an image
|
## Getting information on an image
|
||||||
|
|
||||||
Use an image's ID or name (e.g. repository/name[:tag]) to get information
|
Use an image's ID or name (e.g., repository/name[:tag]) to get information
|
||||||
on it.
|
on it.
|
||||||
|
|
||||||
# docker inspect 58394af37342
|
# docker inspect 58394af37342
|
||||||
|
|
|
@ -10,7 +10,7 @@ docker-pull - Pull an image or a repository from the registry
|
||||||
# DESCRIPTION
|
# DESCRIPTION
|
||||||
|
|
||||||
This command pulls down an image or a repository from the registry. If
|
This command pulls down an image or a repository from the registry. If
|
||||||
there is more than one image for a repository (e.g. fedora) then all
|
there is more than one image for a repository (e.g., fedora) then all
|
||||||
images for that repository name are pulled down including any tags.
|
images for that repository name are pulled down including any tags.
|
||||||
It is also possible to specify a non-default registry to pull from.
|
It is also possible to specify a non-default registry to pull from.
|
||||||
|
|
||||||
|
|
|
@ -71,7 +71,7 @@ stopping the process by pressing the keys CTRL-P CTRL-Q.
|
||||||
**--dns**=*IP-address*
|
**--dns**=*IP-address*
|
||||||
Set custom DNS servers. This option can be used to override the DNS
|
Set custom DNS servers. This option can be used to override the DNS
|
||||||
configuration passed to the container. Typically this is necessary when the
|
configuration passed to the container. Typically this is necessary when the
|
||||||
host DNS configuration is invalid for the container (e.g. 127.0.0.1). When this
|
host DNS configuration is invalid for the container (e.g., 127.0.0.1). When this
|
||||||
is the case the **-dns** flags is necessary for every run.
|
is the case the **-dns** flags is necessary for every run.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -35,7 +35,7 @@ Note that here TAG is a part of the overall name or "tag".
|
||||||
|
|
||||||
## Giving an image a new alias
|
## Giving an image a new alias
|
||||||
|
|
||||||
Here is an example of aliasing an image (e.g. 0e5574283393) as "httpd" and
|
Here is an example of aliasing an image (e.g., 0e5574283393) as "httpd" and
|
||||||
tagging it into the "fedora" repository with "version1.0":
|
tagging it into the "fedora" repository with "version1.0":
|
||||||
|
|
||||||
docker tag 0e5574283393 fedora/httpd:version1.0
|
docker tag 0e5574283393 fedora/httpd:version1.0
|
||||||
|
|
|
@ -87,7 +87,7 @@ The first two steps can be done as part of a Dockerfile, as follows.
|
||||||
ENTRYPOINT ["/var/cfengine/bin/docker_processes_run.sh"]
|
ENTRYPOINT ["/var/cfengine/bin/docker_processes_run.sh"]
|
||||||
|
|
||||||
By saving this file as Dockerfile to a working directory, you can then build
|
By saving this file as Dockerfile to a working directory, you can then build
|
||||||
your image with the docker build command, e.g.
|
your image with the docker build command, e.g.,
|
||||||
`docker build -t managed_image`.
|
`docker build -t managed_image`.
|
||||||
|
|
||||||
### Testing the container
|
### Testing the container
|
||||||
|
|
|
@ -29,7 +29,7 @@ keys:
|
||||||
$ openssl req -new -x509 -days 365 -key ca-key.pem -out ca.pem
|
$ openssl req -new -x509 -days 365 -key ca-key.pem -out ca.pem
|
||||||
|
|
||||||
Now that we have a CA, you can create a server key and certificate
|
Now that we have a CA, you can create a server key and certificate
|
||||||
signing request. Make sure that "Common Name (e.g. server FQDN or YOUR
|
signing request. Make sure that "Common Name (e.g., server FQDN or YOUR
|
||||||
name)" matches the hostname you will use to connect to Docker or just
|
name)" matches the hostname you will use to connect to Docker or just
|
||||||
use `\*` for a certificate valid for any hostname:
|
use `\*` for a certificate valid for any hostname:
|
||||||
|
|
||||||
|
|
|
@ -35,7 +35,7 @@ known to the system, the hierarchy they belong to, and how many groups they cont
|
||||||
|
|
||||||
You can also look at `/proc/<pid>/cgroup` to see which control groups a process
|
You can also look at `/proc/<pid>/cgroup` to see which control groups a process
|
||||||
belongs to. The control group will be shown as a path relative to the root of
|
belongs to. The control group will be shown as a path relative to the root of
|
||||||
the hierarchy mountpoint; e.g. `/` means “this process has not been assigned into
|
the hierarchy mountpoint; e.g., `/` means “this process has not been assigned into
|
||||||
a particular group”, while `/lxc/pumpkin` means that the process is likely to be
|
a particular group”, while `/lxc/pumpkin` means that the process is likely to be
|
||||||
a member of a container named `pumpkin`.
|
a member of a container named `pumpkin`.
|
||||||
|
|
||||||
|
@ -106,9 +106,9 @@ to the processes within the cgroup, excluding sub-cgroups. The second half
|
||||||
(with the `total_` prefix) includes sub-cgroups as well.
|
(with the `total_` prefix) includes sub-cgroups as well.
|
||||||
|
|
||||||
Some metrics are "gauges", i.e. values that can increase or decrease
|
Some metrics are "gauges", i.e. values that can increase or decrease
|
||||||
(e.g. swap, the amount of swap space used by the members of the cgroup).
|
(e.g., swap, the amount of swap space used by the members of the cgroup).
|
||||||
Some others are "counters", i.e. values that can only go up, because
|
Some others are "counters", i.e. values that can only go up, because
|
||||||
they represent occurrences of a specific event (e.g. pgfault, which
|
they represent occurrences of a specific event (e.g., pgfault, which
|
||||||
indicates the number of page faults which happened since the creation of
|
indicates the number of page faults which happened since the creation of
|
||||||
the cgroup; this number can never decrease).
|
the cgroup; this number can never decrease).
|
||||||
|
|
||||||
|
@ -410,7 +410,7 @@ used.
|
||||||
|
|
||||||
Docker makes this difficult because it relies on `lxc-start`, which
|
Docker makes this difficult because it relies on `lxc-start`, which
|
||||||
carefully cleans up after itself, but it is still possible. It is
|
carefully cleans up after itself, but it is still possible. It is
|
||||||
usually easier to collect metrics at regular intervals (e.g. every
|
usually easier to collect metrics at regular intervals (e.g., every
|
||||||
minute, with the collectd LXC plugin) and rely on that instead.
|
minute, with the collectd LXC plugin) and rely on that instead.
|
||||||
|
|
||||||
But, if you'd still like to gather the stats when a container stops,
|
But, if you'd still like to gather the stats when a container stops,
|
||||||
|
|
|
@ -91,8 +91,8 @@ without any restriction. This sounds crazy? Well, you have to know that
|
||||||
same way**. Nothing prevents you from sharing your root filesystem (or
|
same way**. Nothing prevents you from sharing your root filesystem (or
|
||||||
even your root block device) with a virtual machine.
|
even your root block device) with a virtual machine.
|
||||||
|
|
||||||
This has a strong security implication: if you instrument Docker from
|
This has a strong security implication: for example, if you instrument Docker
|
||||||
e.g. a web server to provision containers through an API, you should be
|
from a web server to provision containers through an API, you should be
|
||||||
even more careful than usual with parameter checking, to make sure that
|
even more careful than usual with parameter checking, to make sure that
|
||||||
a malicious user cannot pass crafted parameters causing Docker to create
|
a malicious user cannot pass crafted parameters causing Docker to create
|
||||||
arbitrary containers.
|
arbitrary containers.
|
||||||
|
@ -108,7 +108,7 @@ socket.
|
||||||
You can also expose the REST API over HTTP if you explicitly decide so.
|
You can also expose the REST API over HTTP if you explicitly decide so.
|
||||||
However, if you do that, being aware of the above mentioned security
|
However, if you do that, being aware of the above mentioned security
|
||||||
implication, you should ensure that it will be reachable only from a
|
implication, you should ensure that it will be reachable only from a
|
||||||
trusted network or VPN; or protected with e.g. `stunnel` and client SSL
|
trusted network or VPN; or protected with e.g., `stunnel` and client SSL
|
||||||
certificates. You can also secure them with [HTTPS and
|
certificates. You can also secure them with [HTTPS and
|
||||||
certificates](/articles/https/).
|
certificates](/articles/https/).
|
||||||
|
|
||||||
|
@ -136,7 +136,7 @@ Finally, if you run Docker on a server, it is recommended to run
|
||||||
exclusively Docker in the server, and move all other services within
|
exclusively Docker in the server, and move all other services within
|
||||||
containers controlled by Docker. Of course, it is fine to keep your
|
containers controlled by Docker. Of course, it is fine to keep your
|
||||||
favorite admin tools (probably at least an SSH server), as well as
|
favorite admin tools (probably at least an SSH server), as well as
|
||||||
existing monitoring/supervision processes (e.g. NRPE, collectd, etc).
|
existing monitoring/supervision processes (e.g., NRPE, collectd, etc).
|
||||||
|
|
||||||
## Linux Kernel Capabilities
|
## Linux Kernel Capabilities
|
||||||
|
|
||||||
|
@ -154,8 +154,8 @@ This means a lot for container security; let's see why!
|
||||||
|
|
||||||
Your average server (bare metal or virtual machine) needs to run a bunch
|
Your average server (bare metal or virtual machine) needs to run a bunch
|
||||||
of processes as root. Those typically include SSH, cron, syslogd;
|
of processes as root. Those typically include SSH, cron, syslogd;
|
||||||
hardware management tools (to e.g. load modules), network configuration
|
hardware management tools (e.g., load modules), network configuration
|
||||||
tools (to handle e.g. DHCP, WPA, or VPNs), and much more. A container is
|
tools (e.g., to handle DHCP, WPA, or VPNs), and much more. A container is
|
||||||
very different, because almost all of those tasks are handled by the
|
very different, because almost all of those tasks are handled by the
|
||||||
infrastructure around the container:
|
infrastructure around the container:
|
||||||
|
|
||||||
|
@ -232,7 +232,7 @@ harden a Docker host. Here are a few examples.
|
||||||
mechanism.
|
mechanism.
|
||||||
|
|
||||||
Just like there are many third-party tools to augment Docker containers
|
Just like there are many third-party tools to augment Docker containers
|
||||||
with e.g. special network topologies or shared filesystems, you can
|
with e.g., special network topologies or shared filesystems, you can
|
||||||
expect to see tools to harden existing Docker containers without
|
expect to see tools to harden existing Docker containers without
|
||||||
affecting Docker's core.
|
affecting Docker's core.
|
||||||
|
|
||||||
|
|
|
@ -113,7 +113,7 @@ something like this
|
||||||
ok github.com/dotcloud/docker/utils 0.017s
|
ok github.com/dotcloud/docker/utils 0.017s
|
||||||
|
|
||||||
If $TESTFLAGS is set in the environment, it is passed as extra arguments
|
If $TESTFLAGS is set in the environment, it is passed as extra arguments
|
||||||
to `go test`. You can use this to select certain tests to run, e.g.
|
to `go test`. You can use this to select certain tests to run, e.g.,
|
||||||
|
|
||||||
$ TESTFLAGS=`-run \^TestBuild\$` make test
|
$ TESTFLAGS=`-run \^TestBuild\$` make test
|
||||||
|
|
||||||
|
|
|
@ -15,7 +15,7 @@ will need to install it. And this is a little more difficult on
|
||||||
Rackspace.
|
Rackspace.
|
||||||
|
|
||||||
Rackspace boots their servers using grub's `menu.lst`
|
Rackspace boots their servers using grub's `menu.lst`
|
||||||
and does not like non `virtual` packages (e.g. Xen compatible)
|
and does not like non `virtual` packages (e.g., Xen compatible)
|
||||||
kernels there, although they do work. This results in
|
kernels there, although they do work. This results in
|
||||||
`update-grub` not having the expected result, and
|
`update-grub` not having the expected result, and
|
||||||
you will need to set the kernel manually.
|
you will need to set the kernel manually.
|
||||||
|
|
|
@ -373,7 +373,7 @@ List containers (/containers/json):
|
||||||
|
|
||||||
Start containers (/containers/<id>/start):
|
Start containers (/containers/<id>/start):
|
||||||
|
|
||||||
- You can now pass host-specific configuration (e.g. bind mounts) in
|
- You can now pass host-specific configuration (e.g., bind mounts) in
|
||||||
the POST body for start calls
|
the POST body for start calls
|
||||||
|
|
||||||
## v1.2
|
## v1.2
|
||||||
|
|
|
@ -935,7 +935,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -946,7 +946,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -286,7 +286,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps\_args** – ps arguments to use (e.g. aux)
|
- **ps\_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1181,7 +1181,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -290,7 +290,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1223,7 +1223,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -290,7 +290,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1301,7 +1301,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -290,7 +290,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1304,7 +1304,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -959,7 +959,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -1009,7 +1009,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -264,7 +264,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1055,7 +1055,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -261,7 +261,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1067,7 +1067,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -311,7 +311,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1163,7 +1163,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -267,7 +267,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1112,7 +1112,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
- **run** – config automatically applied when the image is run.
|
- **run** – config automatically applied when the image is run.
|
||||||
(ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]})
|
(ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]})
|
||||||
|
|
|
@ -303,7 +303,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1157,7 +1157,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
- **run** – config automatically applied when the image is run.
|
- **run** – config automatically applied when the image is run.
|
||||||
(ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]})
|
(ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]})
|
||||||
|
|
|
@ -303,7 +303,7 @@ List processes running inside the container `id`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- **ps_args** – ps arguments to use (e.g. aux)
|
- **ps_args** – ps arguments to use (e.g., aux)
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
||||||
|
@ -1194,7 +1194,7 @@ Create a new image from a container's changes
|
||||||
- **repo** – repository
|
- **repo** – repository
|
||||||
- **tag** – tag
|
- **tag** – tag
|
||||||
- **m** – commit message
|
- **m** – commit message
|
||||||
- **author** – author (e.g. "John Hannibal Smith
|
- **author** – author (e.g., "John Hannibal Smith
|
||||||
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
<[hannibal@a-team.com](mailto:hannibal%40a-team.com)>")
|
||||||
|
|
||||||
Status Codes:
|
Status Codes:
|
||||||
|
|
|
@ -77,11 +77,11 @@ grasp the context, here are some examples of registries:
|
||||||
> - local mount point;
|
> - local mount point;
|
||||||
> - remote docker addressed through SSH.
|
> - remote docker addressed through SSH.
|
||||||
|
|
||||||
The latter would only require two new commands in docker, e.g.
|
The latter would only require two new commands in docker, e.g.,
|
||||||
`registryget` and `registryput`,
|
`registryget` and `registryput`,
|
||||||
wrapping access to the local filesystem (and optionally doing
|
wrapping access to the local filesystem (and optionally doing
|
||||||
consistency checks). Authentication and authorization are then delegated
|
consistency checks). Authentication and authorization are then delegated
|
||||||
to SSH (e.g. with public keys).
|
to SSH (e.g., with public keys).
|
||||||
|
|
||||||
### Docker
|
### Docker
|
||||||
|
|
||||||
|
|
|
@ -62,10 +62,10 @@ grasp the context, here are some examples of registries:
|
||||||
> - local mount point;
|
> - local mount point;
|
||||||
> - remote docker addressed through SSH.
|
> - remote docker addressed through SSH.
|
||||||
|
|
||||||
The latter would only require two new commands in docker, e.g.
|
The latter would only require two new commands in docker, e.g.,
|
||||||
`registryget` and `registryput`, wrapping access to the local filesystem
|
`registryget` and `registryput`, wrapping access to the local filesystem
|
||||||
(and optionally doing consistency checks). Authentication and authorization
|
(and optionally doing consistency checks). Authentication and authorization
|
||||||
are then delegated to SSH (e.g. with public keys).
|
are then delegated to SSH (e.g., with public keys).
|
||||||
|
|
||||||
# Endpoints
|
# Endpoints
|
||||||
|
|
||||||
|
|
|
@ -335,7 +335,7 @@ schema.
|
||||||
|
|
||||||
Create a new image from a container's changes
|
Create a new image from a container's changes
|
||||||
|
|
||||||
-a, --author="" Author (eg. "John Hannibal Smith <hannibal@a-team.com>")
|
-a, --author="" Author (e.g., "John Hannibal Smith <hannibal@a-team.com>")
|
||||||
-m, --message="" Commit message
|
-m, --message="" Commit message
|
||||||
|
|
||||||
It can be useful to commit a container's file changes or settings into a
|
It can be useful to commit a container's file changes or settings into a
|
||||||
|
@ -518,7 +518,7 @@ by default.
|
||||||
### Filtering
|
### Filtering
|
||||||
|
|
||||||
The filtering flag (`-f` or `--filter`) format is of "key=value". If there are more
|
The filtering flag (`-f` or `--filter`) format is of "key=value". If there are more
|
||||||
than one filter, then pass multiple flags (e.g. `--filter "foo=bar" --filter "bif=baz"`)
|
than one filter, then pass multiple flags (e.g., `--filter "foo=bar" --filter "bif=baz"`)
|
||||||
|
|
||||||
Current filters:
|
Current filters:
|
||||||
* dangling (boolean - true or false)
|
* dangling (boolean - true or false)
|
||||||
|
@ -929,7 +929,7 @@ removed before the image is removed.
|
||||||
--sig-proxy=true Proxify received signals to the process (even in non-tty mode). SIGCHLD is not proxied.
|
--sig-proxy=true Proxify received signals to the process (even in non-tty mode). SIGCHLD is not proxied.
|
||||||
-t, --tty=false Allocate a pseudo-tty
|
-t, --tty=false Allocate a pseudo-tty
|
||||||
-u, --user="" Username or UID
|
-u, --user="" Username or UID
|
||||||
-v, --volume=[] Bind mount a volume (e.g. from the host: -v /host:/container, from docker: -v /container)
|
-v, --volume=[] Bind mount a volume (e.g., from the host: -v /host:/container, from docker: -v /container)
|
||||||
--volumes-from=[] Mount volumes from the specified container(s)
|
--volumes-from=[] Mount volumes from the specified container(s)
|
||||||
-w, --workdir="" Working directory inside the container
|
-w, --workdir="" Working directory inside the container
|
||||||
|
|
||||||
|
|
|
@ -13,10 +13,10 @@ server.
|
||||||
Images can be associated with a repository (or multiple) by giving them
|
Images can be associated with a repository (or multiple) by giving them
|
||||||
an image name using one of three different commands:
|
an image name using one of three different commands:
|
||||||
|
|
||||||
1. At build time (e.g. `sudo docker build -t IMAGENAME`),
|
1. At build time (e.g., `sudo docker build -t IMAGENAME`),
|
||||||
2. When committing a container (e.g.
|
2. When committing a container (e.g.,
|
||||||
`sudo docker commit CONTAINERID IMAGENAME`) or
|
`sudo docker commit CONTAINERID IMAGENAME`) or
|
||||||
3. When tagging an image id with an image name (e.g.
|
3. When tagging an image id with an image name (e.g.,
|
||||||
`sudo docker tag IMAGEID IMAGENAME`).
|
`sudo docker tag IMAGEID IMAGENAME`).
|
||||||
|
|
||||||
A Fully Qualified Image Name (FQIN) can be made up of 3 parts:
|
A Fully Qualified Image Name (FQIN) can be made up of 3 parts:
|
||||||
|
|
Loading…
Reference in New Issue