Added Release Notes

Release notes for v.1.1 have been added to the docs index.md page. Made some revisions to
other content to make it shorter.

Docker-DCO-1.1-Signed-off-by: Fred Lifton <fred.lifton@docker.com> (github: fredlf)
This commit is contained in:
Fred Lifton 2014-07-02 16:33:13 -07:00
parent 8ea3589287
commit d946cae364
1 changed files with 65 additions and 25 deletions

View File

@ -22,8 +22,9 @@ Docker consists of:
## Why Docker?
- **Faster delivery of your applications**
* We want your environment to work better. Docker containers,
*Faster delivery of your applications*
* We want your environment to work better. Docker containers,
and the work flow that comes with them, help your developers,
sysadmins, QA folks, and release engineers work together to get your code
into production and make it useful. We've created a standard
@ -31,40 +32,42 @@ Docker consists of:
inside containers while sysadmins and operators can work on running the
container in your deployment. This separation of duties streamlines and
simplifies the management and deployment of code.
* We make it easy to build new containers, enable rapid iteration of
* We make it easy to build new containers, enable rapid iteration of
your applications, and increase the visibility of changes. This
helps everyone in your organization understand how an application works
and how it is built.
* Docker containers are lightweight and fast! Containers have
* Docker containers are lightweight and fast! Containers have
sub-second launch times, reducing the cycle
time of development, testing, and deployment.
- **Deploy and scale more easily**
* Docker containers run (almost) everywhere. You can deploy
*Deploy and scale more easily*
* Docker containers run (almost) everywhere. You can deploy
containers on desktops, physical servers, virtual machines, into
data centers, and up to public and private clouds.
* Since Docker runs on so many platforms, it's easy to move your
* Since Docker runs on so many platforms, it's easy to move your
applications around. You can easily move an application from a
testing environment into the cloud and back whenever you need.
* Docker's lightweight containers also make scaling up and
* Docker's lightweight containers also make scaling up and
down fast and easy. You can quickly launch more containers when
needed and then shut them down easily when they're no longer needed.
- **Get higher density and run more workloads**
* Docker containers don't need a hypervisor, so you can pack more of
*Get higher density and run more workloads*
* Docker containers don't need a hypervisor, so you can pack more of
them onto your hosts. This means you get more value out of every
server and can potentially reduce what you spend on equipment and
licenses.
- **Faster deployment makes for easier management**
* As Docker speeds up your work flow, it gets easier to make lots
*Faster deployment makes for easier management*
* As Docker speeds up your work flow, it gets easier to make lots
of small changes instead of huge, big bang updates. Smaller
changes mean reduced risk and more uptime.
## About this guide
First, the [Understanding Docker
section](introduction/understanding-docker.md) will help you:
The [Understanding Docker section](introduction/understanding-docker.md) will help you:
- See how Docker works at a high level
- Understand the architecture of Docker
@ -72,22 +75,59 @@ section](introduction/understanding-docker.md) will help you:
- See how Docker compares to virtual machines
- See some common use cases.
> [Click here to go to the Understanding
> Docker section](introduction/understanding-docker.md).
### Installation Guides
Next, we'll show you how to install Docker on a variety of platforms in the
[installation](/installation/#installation) section.
The [installation section](/installation/#installation) will show you how to install
Docker on a variety of platforms.
> [Click here to go to the Installation
> section](/installation/#installation).
### Docker User Guide
Once you've gotten Docker installed we recommend you work through the
[Docker User Guide](/userguide/), to learn about Docker in more detail and
answer questions about usage and implementation.
To learn about Docker in more detail and to answer questions about usage and implementation, check out the [Docker User Guide](/userguide/).
## Release Notes
<b>Version 1.1</b>
### New Features
*`.dockerignore` support*
You can now add a `.dockerignore` file next to your `Dockerfile` and Docker will ignore files and directories specified in that file when sending the build context to the daemon.
Example: https://github.com/dotcloud/docker/blob/master/.dockerignore
*Pause containers during commit*
Doing a commit on a running container was not recommended because you could end up with files in an inconsistent state (for example, if they were being written during the commit). Containers are now paused when a commit is made to them.
You can disable this feature by doing a `docker commit --pause=false <container_id>`
*Tailing logs*
You can now tail the logs of a container. For example, you can get the last ten lines of a log by using `docker logs --tail 10 <container_id>`. You can also follow the logs of a container without having to read the whole log file with `docker logs --tail 0 -f <container_id>`.
*Allow a tar file as context for docker build*
You can now pass a tar archive to `docker build` as context. This can be used to automate docker builds, for example: `cat context.tar | docker build -` or `docker run builder_image | docker build -`
*Bind mounting your whole filesystem in a container*
`/` is now allowed as source of `--volumes`. This means you can bind-mount your whole system in a container if you need to. For example: `docker run -v /:/my_host ubuntu:ro ls /my_host`. However, it is now forbidden to mount to /.
### Other Improvements & Changes
* Port allocation has been improved. In the previous release, Docker could prevent you from starting a container with previously allocated ports which seemed to be in use when in fact they were not. This has been fixed.
* A bug in `docker save` was introduced in the last release. The `docker save` command could produce images with invalid metadata. The command now produces images with correct metadata.
* Running `docker inspect` in a container now returns which containers it is linked to.
* Parsing of the `docker commit` flag has improved validation, to better prevent you from committing an image with a name such as `-m`. Image names with dashes in them potentially conflict with command line flags.
* The API now has Improved status codes for `start` and `stop`. Trying to start a running container will now return a 304 error.
* Performance has been improved overall. Starting the daemon is faster than in previous releases. The daemons performance has also been improved when it is working with large numbers of images and containers.
* Fixed an issue with white-spaces and multi-lines in Dockerfiles.
> [Click here to go to the Docker User Guide](/userguide/).