From 936a03bfddb24cd45f5f12c20a961bf2ae6ede93 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Tue, 15 Apr 2014 06:01:25 +0000 Subject: [PATCH] move the documentation to markdown Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: ) --- Makefile | 10 +- docs/Dockerfile | 50 +- docs/README.md | 146 +- docs/asciinema.patch | 86 + docs/convert.sh | 53 + docs/convert_with_sphinx.patch | 197 + docs/mkdocs.yml | 124 + docs/pr4923.patch | 12836 ++++++++++++++++ docs/release.sh | 63 + docs/s3_website.json | 15 + docs/sources/index.md | 81 + docs/sources/index.rst | 29 - docs/sources/index/docs.md | 236 + docs/sources/index/home.md | 13 + docs/sources/index/index.md | 15 + docs/sources/installation/windows.rst | 6 +- docs/sources/introduction/get-docker.md | 77 + docs/sources/introduction/technology.md | 282 + .../introduction/understanding-docker.md | 272 + .../introduction/working-with-docker.md | 408 + docs/sources/jsearch.md | 9 + .../api/archive/docker_remote_api_v1.0.md | 998 ++ .../{ => archive}/docker_remote_api_v1.0.rst | 0 .../api/archive/docker_remote_api_v1.1.md | 1008 ++ .../{ => archive}/docker_remote_api_v1.1.rst | 0 .../api/archive/docker_remote_api_v1.2.md | 1028 ++ .../{ => archive}/docker_remote_api_v1.2.rst | 0 .../api/archive/docker_remote_api_v1.3.md | 1110 ++ .../{ => archive}/docker_remote_api_v1.3.rst | 0 .../api/archive/docker_remote_api_v1.4.md | 1156 ++ .../{ => archive}/docker_remote_api_v1.4.rst | 0 .../api/archive/docker_remote_api_v1.5.md | 1164 ++ .../{ => archive}/docker_remote_api_v1.5.rst | 0 .../api/archive/docker_remote_api_v1.6.md | 1267 ++ .../{ => archive}/docker_remote_api_v1.6.rst | 0 .../api/archive/docker_remote_api_v1.7.md | 1263 ++ .../{ => archive}/docker_remote_api_v1.7.rst | 0 .../api/archive/docker_remote_api_v1.8.md | 1310 ++ .../{ => archive}/docker_remote_api_v1.8.rst | 0 .../reference/api/docker_io_accounts_api.rst | 2 - .../reference/api/docker_io_oauth_api.rst | 2 - .../reference/api/docker_remote_api.rst | 18 - .../reference/api/docker_remote_api_v1.10.rst | 2 - .../reference/api/docker_remote_api_v1.11.rst | 2 - .../reference/api/docker_remote_api_v1.9.rst | 2 - docs/sources/reference/commandline/cli.rst | 13 +- docs/sources/reference/run.rst | 3 - docs/sources/robots.txt | 2 + docs/sources/toctree.rst | 1 - docs/theme/docker/layout.html | 146 - docs/theme/mkdocs/autoindex.html | 12 + docs/theme/mkdocs/base.html | 57 + docs/theme/mkdocs/breadcrumbs.html | 15 + docs/theme/mkdocs/css/base.css | 735 + docs/theme/mkdocs/css/bootstrap-custom.css | 7098 +++++++++ .../theme/mkdocs/css/bootstrap-custom.min.css | 7 + docs/theme/mkdocs/css/prettify-1.0.css | 28 + docs/theme/mkdocs/docker_io_nav.html | 38 + .../mkdocs/fonts/fontawesome-webfont.eot | Bin 0 -> 38205 bytes .../mkdocs/fonts/fontawesome-webfont.svg | 414 + .../mkdocs/fonts/fontawesome-webfont.ttf | Bin 0 -> 80652 bytes .../mkdocs/fonts/fontawesome-webfont.woff | Bin 0 -> 44432 bytes .../fonts/glyphicons-halflings-regular.eot | Bin 0 -> 20335 bytes .../fonts/glyphicons-halflings-regular.svg | 229 + .../fonts/glyphicons-halflings-regular.ttf | Bin 0 -> 41280 bytes .../fonts/glyphicons-halflings-regular.woff | Bin 0 -> 23320 bytes docs/theme/mkdocs/footer.html | 84 + .../mkdocs/img/docs_nav_menu_arrow_1x.png | Bin 0 -> 481 bytes docs/theme/mkdocs/img/favicon.png | Bin 0 -> 1475 bytes docs/theme/mkdocs/img/logo.png | Bin 0 -> 13924 bytes docs/theme/mkdocs/img/logo_compressed.png | Bin 0 -> 4972 bytes .../mkdocs/img/social/docker_social_logos.png | Bin 0 -> 3130 bytes .../theme/mkdocs/img/website-footer_clean.svg | 197 + docs/theme/mkdocs/js/base.js | 80 + docs/theme/mkdocs/js/bootstrap-3.0.3.min.js | 7 + .../mkdocs/js/jquery-scrolltofixed-min.js | 8 + docs/theme/mkdocs/js/prettify-1.0.min.js | 28 + docs/theme/mkdocs/nav.html | 51 + docs/theme/mkdocs/prev_next.html | 22 + docs/theme/mkdocs/tipuesearch/img/loader.gif | Bin 0 -> 4178 bytes docs/theme/mkdocs/tipuesearch/img/search.png | Bin 0 -> 315 bytes docs/theme/mkdocs/tipuesearch/tipuesearch.css | 136 + docs/theme/mkdocs/tipuesearch/tipuesearch.js | 383 + .../mkdocs/tipuesearch/tipuesearch.min.js | 12 + .../mkdocs/tipuesearch/tipuesearch_content.js | 13 + .../mkdocs/tipuesearch/tipuesearch_set.js | 23 + docs/theme/mkdocs/toc.html | 13 + 87 files changed, 34848 insertions(+), 347 deletions(-) mode change 100644 => 100755 docs/README.md create mode 100644 docs/asciinema.patch create mode 100755 docs/convert.sh create mode 100644 docs/convert_with_sphinx.patch create mode 100755 docs/mkdocs.yml create mode 100644 docs/pr4923.patch create mode 100755 docs/release.sh create mode 100644 docs/s3_website.json create mode 100644 docs/sources/index.md delete mode 100644 docs/sources/index.rst create mode 100644 docs/sources/index/docs.md create mode 100644 docs/sources/index/home.md create mode 100644 docs/sources/index/index.md mode change 100644 => 100755 docs/sources/installation/windows.rst create mode 100644 docs/sources/introduction/get-docker.md create mode 100644 docs/sources/introduction/technology.md create mode 100644 docs/sources/introduction/understanding-docker.md create mode 100644 docs/sources/introduction/working-with-docker.md create mode 100644 docs/sources/jsearch.md create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.0.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.0.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.1.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.1.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.2.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.2.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.3.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.3.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.4.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.4.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.5.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.5.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.6.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.6.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.7.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.7.rst (100%) create mode 100644 docs/sources/reference/api/archive/docker_remote_api_v1.8.md rename docs/sources/reference/api/{ => archive}/docker_remote_api_v1.8.rst (100%) create mode 100644 docs/sources/robots.txt create mode 100644 docs/theme/mkdocs/autoindex.html create mode 100644 docs/theme/mkdocs/base.html create mode 100644 docs/theme/mkdocs/breadcrumbs.html create mode 100644 docs/theme/mkdocs/css/base.css create mode 100644 docs/theme/mkdocs/css/bootstrap-custom.css create mode 100644 docs/theme/mkdocs/css/bootstrap-custom.min.css create mode 100644 docs/theme/mkdocs/css/prettify-1.0.css create mode 100644 docs/theme/mkdocs/docker_io_nav.html create mode 100755 docs/theme/mkdocs/fonts/fontawesome-webfont.eot create mode 100755 docs/theme/mkdocs/fonts/fontawesome-webfont.svg create mode 100755 docs/theme/mkdocs/fonts/fontawesome-webfont.ttf create mode 100755 docs/theme/mkdocs/fonts/fontawesome-webfont.woff create mode 100644 docs/theme/mkdocs/fonts/glyphicons-halflings-regular.eot create mode 100644 docs/theme/mkdocs/fonts/glyphicons-halflings-regular.svg create mode 100644 docs/theme/mkdocs/fonts/glyphicons-halflings-regular.ttf create mode 100644 docs/theme/mkdocs/fonts/glyphicons-halflings-regular.woff create mode 100644 docs/theme/mkdocs/footer.html create mode 100644 docs/theme/mkdocs/img/docs_nav_menu_arrow_1x.png create mode 100644 docs/theme/mkdocs/img/favicon.png create mode 100644 docs/theme/mkdocs/img/logo.png create mode 100644 docs/theme/mkdocs/img/logo_compressed.png create mode 100644 docs/theme/mkdocs/img/social/docker_social_logos.png create mode 100644 docs/theme/mkdocs/img/website-footer_clean.svg create mode 100644 docs/theme/mkdocs/js/base.js create mode 100644 docs/theme/mkdocs/js/bootstrap-3.0.3.min.js create mode 100644 docs/theme/mkdocs/js/jquery-scrolltofixed-min.js create mode 100644 docs/theme/mkdocs/js/prettify-1.0.min.js create mode 100644 docs/theme/mkdocs/nav.html create mode 100644 docs/theme/mkdocs/prev_next.html create mode 100644 docs/theme/mkdocs/tipuesearch/img/loader.gif create mode 100755 docs/theme/mkdocs/tipuesearch/img/search.png create mode 100755 docs/theme/mkdocs/tipuesearch/tipuesearch.css create mode 100644 docs/theme/mkdocs/tipuesearch/tipuesearch.js create mode 100644 docs/theme/mkdocs/tipuesearch/tipuesearch.min.js create mode 100644 docs/theme/mkdocs/tipuesearch/tipuesearch_content.js create mode 100644 docs/theme/mkdocs/tipuesearch/tipuesearch_set.js create mode 100644 docs/theme/mkdocs/toc.html diff --git a/Makefile b/Makefile index d49aa3b667..4186869ce2 100644 --- a/Makefile +++ b/Makefile @@ -11,7 +11,8 @@ DOCKER_DOCS_IMAGE := docker-docs$(if $(GIT_BRANCH),:$(GIT_BRANCH)) DOCKER_MOUNT := $(if $(BINDDIR),-v "$(CURDIR)/$(BINDDIR):/go/src/github.com/dotcloud/docker/$(BINDDIR)") DOCKER_RUN_DOCKER := docker run --rm -it --privileged -e TESTFLAGS -e DOCKER_GRAPHDRIVER -e DOCKER_EXECDRIVER $(DOCKER_MOUNT) "$(DOCKER_IMAGE)" -DOCKER_RUN_DOCS := docker run --rm -it -p $(if $(DOCSPORT),$(DOCSPORT):)8000 "$(DOCKER_DOCS_IMAGE)" +# to allow `make DOCSDIR=docs docs-shell` +DOCKER_RUN_DOCS := docker run --rm -it -p $(if $(DOCSPORT),$(DOCSPORT):)8000 $(if $(DOCSDIR),-v $(CURDIR)/$(DOCSDIR):/$(DOCSDIR)) -e AWS_S3_BUCKET default: binary @@ -25,10 +26,13 @@ cross: build $(DOCKER_RUN_DOCKER) hack/make.sh binary cross docs: docs-build - $(DOCKER_RUN_DOCS) + $(DOCKER_RUN_DOCS) "$(DOCKER_DOCS_IMAGE)" mkdocs serve docs-shell: docs-build - $(DOCKER_RUN_DOCS) bash + $(DOCKER_RUN_DOCS) "$(DOCKER_DOCS_IMAGE)" bash + +docs-release: docs-build + $(DOCKER_RUN_DOCS) "$(DOCKER_DOCS_IMAGE)" ./release.sh test: build $(DOCKER_RUN_DOCKER) hack/make.sh binary test test-integration test-integration-cli diff --git a/docs/Dockerfile b/docs/Dockerfile index 69aa5cb409..aafa0abc8b 100644 --- a/docs/Dockerfile +++ b/docs/Dockerfile @@ -1,19 +1,45 @@ -FROM ubuntu:12.04 -MAINTAINER Nick Stinemates # -# docker build -t docker:docs . && docker run -p 8000:8000 docker:docs +# See the top level Makefile in https://github.com/dotcloud/docker for usage. # +FROM debian:jessie +MAINTAINER Sven Dowideit (@SvenDowideit) -# TODO switch to http://packages.ubuntu.com/trusty/python-sphinxcontrib-httpdomain once trusty is released +RUN apt-get update && apt-get install -yq make python-pip python-setuptools vim-tiny git pandoc -RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq make python-pip python-setuptools +RUN pip install mkdocs + +# installing sphinx for the rst->md conversion only - will be removed after May release # pip installs from docs/requirements.txt, but here to increase cacheability -RUN pip install Sphinx==1.2.1 -RUN pip install sphinxcontrib-httpdomain==1.2.0 -ADD . /docs -RUN make -C /docs clean docs +RUN pip install Sphinx==1.2.1 +RUN pip install sphinxcontrib-httpdomain==1.2.0 + +# add MarkdownTools to get transclusion +# (future development) +#RUN easy_install -U setuptools +#RUN pip install MarkdownTools2 + +# this week I seem to need the latest dev release of awscli too +# awscli 1.3.6 does --error-document correctly +# https://github.com/aws/aws-cli/commit/edc2290e173dfaedc70b48cfa3624d58c533c6c3 +RUN pip install awscli + +# get my sitemap.xml branch of mkdocs and use that for now +RUN git clone https://github.com/SvenDowideit/mkdocs &&\ + cd mkdocs/ &&\ + git checkout docker-markdown-merge &&\ + ./setup.py install + +ADD . /docs +ADD MAINTAINERS /docs/sources/humans.txt +WORKDIR /docs + +#build the sphinx html +#RUN make -C /docs clean docs + +#convert to markdown +RUN ./convert.sh -WORKDIR /docs/_build/html -CMD ["python", "-m", "SimpleHTTPServer"] # note, EXPOSE is only last because of https://github.com/dotcloud/docker/issues/3525 -EXPOSE 8000 +EXPOSE 8000 + +CMD ["mkdocs", "serve"] diff --git a/docs/README.md b/docs/README.md old mode 100644 new mode 100755 index 9379d86870..de1b1250f0 --- a/docs/README.md +++ b/docs/README.md @@ -4,30 +4,25 @@ Docker Documentation Overview -------- -The source for Docker documentation is here under ``sources/`` in the -form of .rst files. These files use -[reStructuredText](http://docutils.sourceforge.net/rst.html) -formatting with [Sphinx](http://sphinx-doc.org/) extensions for -structure, cross-linking and indexing. +The source for Docker documentation is here under ``sources/`` and uses +extended Markdown, as implemented by [mkdocs](http://mkdocs.org). -The HTML files are built and hosted on -[readthedocs.org](https://readthedocs.org/projects/docker/), appearing -via proxy on https://docs.docker.io. The HTML files update +The HTML files are built and hosted on https://docs.docker.io, and update automatically after each change to the master or release branch of the [docker files on GitHub](https://github.com/dotcloud/docker) thanks to post-commit hooks. The "release" branch maps to the "latest" -documentation and the "master" branch maps to the "master" +documentation and the "master" (unreleased development) branch maps to the "master" documentation. ## Branches **There are two branches related to editing docs**: ``master`` and a ``doc*`` branch (currently ``doc0.8.1``). You should normally edit -docs on the ``master`` branch. That way your fixes will automatically -get included in later releases, and docs maintainers can easily -cherry-pick your changes to bring over to the current docs branch. In -the rare case where your change is not forward-compatible, then you -could base your change on the appropriate ``doc*`` branch. +docs on a local branch of the ``master`` branch. That way your fixes +will automatically get included in later releases, and docs maintainers +can easily cherry-pick your changes to bring over to the current docs +branch. In the rare case where your change is not forward-compatible, +then you could base your change on the appropriate ``doc*`` branch. Now that we have a ``doc*`` branch, we can keep the ``latest`` docs up to date with any bugs found between ``docker`` code releases. @@ -38,43 +33,19 @@ release. ``Master`` docs should be used only for understanding bleeding-edge development and ``latest`` (which points to the ``doc*`` branch``) should be used for the latest official release. -If you need to manually trigger a build of an existing branch, then -you can do that through the [readthedocs -interface](https://readthedocs.org/builds/docker/). If you would like -to add new build targets, including new branches or tags, then you -must contact one of the existing maintainers and get your -readthedocs.org account added to the maintainers list, or just file an -issue on GitHub describing the branch/tag and why it needs to be added -to the docs, and one of the maintainers will add it for you. - Getting Started --------------- -To edit and test the docs, you'll need to install the Sphinx tool and -its dependencies. There are two main ways to install this tool: - -### Native Installation - -Install dependencies from `requirements.txt` file in your `docker/docs` -directory: - -* Linux: `pip install -r docs/requirements.txt` - -* Mac OS X: `[sudo] pip-2.7 install -r docs/requirements.txt` - -### Alternative Installation: Docker Container - -If you're running ``docker`` on your development machine then you may -find it easier and cleaner to use the docs Dockerfile. This installs Sphinx -in a container, adds the local ``docs/`` directory and builds the HTML -docs inside the container, even starting a simple HTTP server on port -8000 so that you can connect and see your changes. +Docker documentation builds are done in a docker container, which installs all +the required tools, adds the local ``docs/`` directory and builds the HTML +docs. It then starts a simple HTTP server on port 8000 so that you can connect +and see your changes. In the ``docker`` source directory, run: ```make docs``` -This is the equivalent to ``make clean server`` since each container -starts clean. +If you have any issues you need to debug, you can use ``make docs-shell`` and +then run ``mkdocs serve`` # Contributing @@ -84,8 +55,8 @@ starts clean. ``../CONTRIBUTING.md``](../CONTRIBUTING.md)). * [Remember to sign your work!](../CONTRIBUTING.md#sign-your-work) * Work in your own fork of the code, we accept pull requests. -* Change the ``.rst`` files with your favorite editor -- try to keep the - lines short and respect RST and Sphinx conventions. +* Change the ``.md`` files with your favorite editor -- try to keep the + lines short (80 chars) and respect Markdown conventions. * Run ``make clean docs`` to clean up old files and generate new ones, or just ``make docs`` to update after small changes. * Your static website can now be found in the ``_build`` directory. @@ -94,27 +65,13 @@ starts clean. ``make clean docs`` must complete without any warnings or errors. -## Special Case for RST Newbies: - -If you want to write a new doc or make substantial changes to an -existing doc, but **you don't know RST syntax**, we will accept pull -requests in Markdown and plain text formats. We really want to -encourage people to share their knowledge and don't want the markup -syntax to be the obstacle. So when you make the Pull Request, please -note in your comment that you need RST markup assistance, and we'll -make the changes for you, and then we will make a pull request to your -pull request so that you can get all the changes and learn about the -markup. You still need to follow the -[``CONTRIBUTING``](../CONTRIBUTING) guidelines, so please sign your -commits. - Working using GitHub's file editor ---------------------------------- Alternatively, for small changes and typos you might want to use GitHub's built in file editor. It allows you to preview your changes right online (though there can be some differences between GitHub -markdown and Sphinx RST). Just be careful not to create many commits. +Markdown and mkdocs Markdown). Just be careful not to create many commits. And you must still [sign your work!](../CONTRIBUTING.md#sign-your-work) Images @@ -122,62 +79,25 @@ Images When you need to add images, try to make them as small as possible (e.g. as gif). Usually images should go in the same directory as the -.rst file which references them, or in a subdirectory if one already +.md file which references them, or in a subdirectory if one already exists. -Notes ------ +Publishing Documentation +------------------------ -* For the template the css is compiled from less. When changes are - needed they can be compiled using +To publish a copy of the documentation you need a ``docs/awsconfig`` +file containing AWS settings to deploy to. The release script will +create an s3 if needed, and will then push the files to it. - lessc ``lessc main.less`` or watched using watch-lessc ``watch-lessc -i main.less -o main.css`` +``` +[profile dowideit-docs] +aws_access_key_id = IHOIUAHSIDH234rwf.... +aws_secret_access_key = OIUYSADJHLKUHQWIUHE...... +region = ap-southeast-2 +``` -Guides on using sphinx ----------------------- -* To make links to certain sections create a link target like so: +The ``profile`` name must be the same as the name of the bucket you are +deploying to - which you call from the docker directory: - ``` - .. _hello_world: - - Hello world - =========== - - This is a reference to :ref:`hello_world` and will work even if we - move the target to another file or change the title of the section. - ``` - - The ``_hello_world:`` will make it possible to link to this position - (page and section heading) from all other pages. See the [Sphinx - docs](http://sphinx-doc.org/markup/inline.html#role-ref) for more - information and examples. - -* Notes, warnings and alarms - - ``` - # a note (use when something is important) - .. note:: - - # a warning (orange) - .. warning:: - - # danger (red, use sparsely) - .. danger:: - -* Code examples - - * Start typed commands with ``$ `` (dollar space) so that they - are easily differentiated from program output. - * Use "sudo" with docker to ensure that your command is runnable - even if they haven't [used the *docker* - group](http://docs.docker.io/en/latest/use/basics/#why-sudo). - -Manpages --------- - -* To make the manpages, run ``make man``. Please note there is a bug - in Sphinx 1.1.3 which makes this fail. Upgrade to the latest version - of Sphinx. -* Then preview the manpage by running ``man _build/man/docker.1``, - where ``_build/man/docker.1`` is the path to the generated manfile +``make AWS_S3_BUCKET=dowideit-docs docs-release`` diff --git a/docs/asciinema.patch b/docs/asciinema.patch new file mode 100644 index 0000000000..297c535815 --- /dev/null +++ b/docs/asciinema.patch @@ -0,0 +1,86 @@ +diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md +index 6e072f6..5a4537d 100644 +--- a/docs/sources/examples/hello_world.md ++++ b/docs/sources/examples/hello_world.md +@@ -59,6 +59,9 @@ standard out. + + See the example in action + ++ ++ ++ + ## Hello World Daemon + + Note +@@ -142,6 +145,8 @@ Make sure it is really stopped. + + See the example in action + ++ ++ + The next example in the series is a [*Node.js Web + App*](../nodejs_web_app/#nodejs-web-app) example, or you could skip to + any of the other examples: +diff --git a/docs/asciinema.patch b/docs/asciinema.patch +index e240bf3..e69de29 100644 +--- a/docs/asciinema.patch ++++ b/docs/asciinema.patch +@@ -1,23 +0,0 @@ +-diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md +-index 6e072f6..5a4537d 100644 +---- a/docs/sources/examples/hello_world.md +-+++ b/docs/sources/examples/hello_world.md +-@@ -59,6 +59,9 @@ standard out. +- +- See the example in action +- +-+ +-+ +-+ +- ## Hello World Daemon +- +- Note +-@@ -142,6 +145,8 @@ Make sure it is really stopped. +- +- See the example in action +- +-+ +-+ +- The next example in the series is a [*Node.js Web +- App*](../nodejs_web_app/#nodejs-web-app) example, or you could skip to +- any of the other examples: +diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md +index 6e072f6..c277f38 100644 +--- a/docs/sources/examples/hello_world.md ++++ b/docs/sources/examples/hello_world.md +@@ -59,6 +59,8 @@ standard out. + + See the example in action + ++ ++ + ## Hello World Daemon + + Note +@@ -142,6 +144,8 @@ Make sure it is really stopped. + + See the example in action + ++ ++ + The next example in the series is a [*Node.js Web + App*](../nodejs_web_app/#nodejs-web-app) example, or you could skip to + any of the other examples: +diff --git a/docs/sources/use/workingwithrepository.md b/docs/sources/use/workingwithrepository.md +index 2122b8d..49edbc8 100644 +--- a/docs/sources/use/workingwithrepository.md ++++ b/docs/sources/use/workingwithrepository.md +@@ -199,6 +199,8 @@ searchable (or indexed at all) in the Central Index, and there will be + no user name checking performed. Your registry will function completely + independently from the Central Index. + ++ ++ + See also + + [Docker Blog: How to use your own diff --git a/docs/convert.sh b/docs/convert.sh new file mode 100755 index 0000000000..2316923f6d --- /dev/null +++ b/docs/convert.sh @@ -0,0 +1,53 @@ +#!/bin/sh + +cd / + +#run the sphinx build first +make -C /docs clean docs + +cd /docs + +#find sources -name '*.md*' -exec rm '{}' \; + +# convert from rst to md for mkdocs.org +# TODO: we're using a sphinx specific rst thing to do between docs links, which we then need to convert to mkdocs specific markup (and pandoc loses it when converting to html / md) +HTML_FILES=$(find _build -name '*.html' | sed 's/_build\/html\/\(.*\)\/index.html/\1/') + +for name in ${HTML_FILES} +do + echo $name + # lets not use gratuitious unicode quotes that cause terrible copy and paste issues + sed -i 's/“/"/g' _build/html/${name}/index.html + sed -i 's/”/"/g' _build/html/${name}/index.html + pandoc -f html -t markdown --atx-headers -o sources/${name}.md1 _build/html/${name}/index.html + + #add the meta-data from the rst + egrep ':(title|description|keywords):' sources/${name}.rst | sed 's/^:/page_/' > sources/${name}.md + echo >> sources/${name}.md + #cat sources/${name}.md1 >> sources/${name}.md + # remove the paragraph links from the source + cat sources/${name}.md1 | sed 's/\[..\](#.*)//' >> sources/${name}.md + + rm sources/${name}.md1 + + sed -i 's/{.docutils .literal}//g' sources/${name}.md + sed -i 's/{.docutils$//g' sources/${name}.md + sed -i 's/^.literal} //g' sources/${name}.md + sed -i 's/`{.descname}`//g' sources/${name}.md + sed -i 's/{.descname}//g' sources/${name}.md + sed -i 's/{.xref}//g' sources/${name}.md + sed -i 's/{.xref .doc .docutils .literal}//g' sources/${name}.md + sed -i 's/{.xref .http .http-post .docutils$//g' sources/${name}.md + sed -i 's/^ .literal}//g' sources/${name}.md + + sed -i 's/\\\$container\\_id/\$container_id/' sources/examples/hello_world.md + sed -i 's/\\\$TESTFLAGS/\$TESTFLAGS/' sources/contributing/devenvironment.md + sed -i 's/\\\$MYVAR1/\$MYVAR1/g' sources/reference/commandline/cli.md + + # git it all so we can test +# git add ${name}.md +done + +#annoyingly, there are lots of failures +patch --fuzz 50 -t -p2 < pr4923.patch || true +patch --fuzz 50 -t -p2 < asciinema.patch || true diff --git a/docs/convert_with_sphinx.patch b/docs/convert_with_sphinx.patch new file mode 100644 index 0000000000..995c9afeca --- /dev/null +++ b/docs/convert_with_sphinx.patch @@ -0,0 +1,197 @@ +diff --git a/docs/Dockerfile b/docs/Dockerfile +index bc2b73b..b9808b2 100644 +--- a/docs/Dockerfile ++++ b/docs/Dockerfile +@@ -4,14 +4,24 @@ MAINTAINER SvenDowideit@docker.com + # docker build -t docker:docs . && docker run -p 8000:8000 docker:docs + # + +-RUN apt-get update && apt-get install -yq make python-pip python-setuptools +- ++RUN apt-get update && apt-get install -yq make python-pip python-setuptools + RUN pip install mkdocs + ++RUN apt-get install -yq vim-tiny git pandoc ++ ++# pip installs from docs/requirements.txt, but here to increase cacheability ++RUN pip install Sphinx==1.2.1 ++RUN pip install sphinxcontrib-httpdomain==1.2.0 ++ + ADD . /docs ++ ++#build the sphinx html ++RUN make -C /docs clean docs ++ + WORKDIR /docs + +-CMD ["mkdocs", "serve"] ++#CMD ["mkdocs", "serve"] ++CMD bash + + # note, EXPOSE is only last because of https://github.com/dotcloud/docker/issues/3525 + EXPOSE 8000 +diff --git a/docs/theme/docker/layout.html b/docs/theme/docker/layout.html +index 7d78fb9..0dac9e0 100755 +--- a/docs/theme/docker/layout.html ++++ b/docs/theme/docker/layout.html +@@ -63,48 +63,6 @@ + + + +-
+-
+-
+-
+- +-
+- +-
+- +- +-
+-
+-
+- +-
+- +- +-
+- +-
+-
+-

DOCUMENTATION

+-
+- +- {{ toctree(collapse=False, maxdepth=3) }} +-
+- +-
+-
+-
+- + +
+ +@@ -114,111 +72,7 @@ + {% block body %}{% endblock %} + + +-
Edit this article on GitHub
+
+-
+-
+- +- +-
+- +- +- +- +- +- +- +- +- +- +- +- +- + + + diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml new file mode 100755 index 0000000000..b91fe10125 --- /dev/null +++ b/docs/mkdocs.yml @@ -0,0 +1,124 @@ +site_name: Docker Documentation +#site_url: http://docs.docker.io/ +site_url: / +site_description: Documentation for fast and lightweight Docker container based virtualization framework. +site_favicon: img/favicon.png + +dev_addr: '0.0.0.0:8000' + +repo_url: https://github.com/dotcloud/docker/ + +docs_dir: sources + +include_search: true + +use_absolute_urls: true + +# theme: docker +theme_dir: ./theme/mkdocs/ +theme_center_lead: false +include_search: true + +copyright: Copyright © 2014, Docker, Inc. +google_analytics: ['UA-6096819-11', 'docker.io'] + +pages: + +# Introduction: +- ['index.md', 'About', 'Docker'] +- ['introduction/index.md', '**HIDDEN**'] +- ['introduction/understanding-docker.md', 'About', 'Understanding Docker'] +- ['introduction/technology.md', 'About', 'The Technology'] +- ['introduction/working-with-docker.md', 'About', 'Working with Docker'] +- ['introduction/get-docker.md', 'About', 'Get Docker'] + +# Installation: +- ['installation/index.md', '**HIDDEN**'] +- ['installation/mac.md', 'Installation', 'Mac OS X'] +- ['installation/ubuntulinux.md', 'Installation', 'Ubuntu'] +- ['installation/rhel.md', 'Installation', 'Red Hat Enterprise Linux'] +- ['installation/gentoolinux.md', 'Installation', 'Gentoo'] +- ['installation/google.md', 'Installation', 'Google Cloud Platform'] +- ['installation/rackspace.md', 'Installation', 'Rackspace Cloud'] +- ['installation/amazon.md', 'Installation', 'Amazon EC2'] +- ['installation/softlayer.md', 'Installation', 'IBM Softlayer'] +- ['installation/archlinux.md', 'Installation', 'Arch Linux'] +- ['installation/frugalware.md', 'Installation', 'FrugalWare'] +- ['installation/fedora.md', 'Installation', 'Fedora'] +- ['installation/openSUSE.md', 'Installation', 'openSUSE'] +- ['installation/cruxlinux.md', 'Installation', 'CRUX Linux'] +- ['installation/windows.md', 'Installation', 'Microsoft Windows'] +- ['installation/binaries.md', 'Installation', 'Binaries'] + +# Examples: +- ['use/index.md', '**HIDDEN**'] +- ['use/basics.md', 'Examples', 'First steps with Docker'] +- ['examples/index.md', '**HIDDEN**'] +- ['examples/hello_world.md', 'Examples', 'Hello World'] +- ['examples/nodejs_web_app.md', 'Examples', 'Node.js web application'] +- ['examples/python_web_app.md', 'Examples', 'Python web application'] +- ['examples/mongodb.md', 'Examples', 'MongoDB service'] +- ['examples/running_redis_service.md', 'Examples', 'Redis service'] +- ['examples/postgresql_service.md', 'Examples', 'PostgreSQL service'] +- ['examples/running_riak_service.md', 'Examples', 'Running a Riak service'] +- ['examples/running_ssh_service.md', 'Examples', 'Running an SSH service'] +- ['examples/couchdb_data_volumes.md', 'Examples', 'CouchDB service'] +- ['examples/apt-cacher-ng.md', 'Examples', 'Apt-Cacher-ng service'] +- ['examples/https.md', 'Examples', 'Running Docker with HTTPS'] +- ['examples/using_supervisord.md', 'Examples', 'Using Supervisor'] +- ['examples/cfengine_process_management.md', 'Examples', 'Process management with CFEngine'] +- ['use/working_with_links_names.md', 'Examples', 'Linking containers together'] +- ['use/working_with_volumes.md', 'Examples', 'Sharing Directories using volumes'] +- ['use/puppet.md', 'Examples', 'Using Puppet'] +- ['use/chef.md', 'Examples', 'Using Chef'] +# - ['use/workingwithrepository.md', 'Examples', 'Working with a Docker Repository'] +- ['use/port_redirection.md', 'Examples', 'Redirect ports'] +- ['use/ambassador_pattern_linking.md', 'Examples', 'Cross-Host linking using Ambassador Containers'] +- ['use/host_integration.md', 'Examples', 'Automatically starting Containers'] + +#- ['user-guide/index.md', '**HIDDEN**'] +# - ['user-guide/writing-your-docs.md', 'User Guide', 'Writing your docs'] +# - ['user-guide/styling-your-docs.md', 'User Guide', 'Styling your docs'] +# - ['user-guide/configuration.md', 'User Guide', 'Configuration'] +# ./faq.md + +# Reference +- ['reference/index.md', '**HIDDEN**'] +- ['reference/commandline/cli.md', 'Reference', 'Command line'] +- ['reference/builder.md', 'Reference', 'Dockerfile'] +- ['reference/run.md', 'Reference', 'Run Reference'] +- ['articles/index.md', '**HIDDEN**'] +- ['articles/runmetrics.md', 'Reference', 'Runtime metrics'] +- ['articles/security.md', 'Reference', 'Security'] +- ['articles/baseimages.md', 'Reference', 'Creating a Base Image'] +- ['use/networking.md', 'Reference', 'Advanced networking'] +- ['reference/api/index_api.md', 'Reference', 'Docker Index API'] +- ['reference/api/registry_api.md', 'Reference', 'Docker Registry API'] +- ['reference/api/registry_index_spec.md', 'Reference', 'Registry & Index Spec'] +- ['reference/api/docker_remote_api.md', 'Reference', 'Docker Remote API'] +- ['reference/api/docker_remote_api_v1.10.md', 'Reference', 'Docker Remote API v1.10'] +- ['reference/api/docker_remote_api_v1.9.md', 'Reference', 'Docker Remote API v1.9'] +- ['reference/api/remote_api_client_libraries.md', 'Reference', 'Docker Remote API Client Libraries'] + +# Contribute: +- ['contributing/index.md', '**HIDDEN**'] +- ['contributing/contributing.md', 'Contribute', 'Contributing'] +- ['contributing/devenvironment.md', 'Contribute', 'Development environment'] +# - ['about/license.md', 'About', 'License'] + +# Docker Index docs: +- ['index/index.md', '**HIDDEN**'] +- ['index/home.md', 'Docker Index', 'Help'] +- ['index/docs.md', 'Docker Index', 'Documentation'] + +- ['jsearch.md', '**HIDDEN**'] + +# - ['static_files/README.md', 'static_files', 'README'] +#- ['terms/index.md', '**HIDDEN**'] +# - ['terms/layer.md', 'terms', 'layer'] +# - ['terms/index.md', 'terms', 'Home'] +# - ['terms/registry.md', 'terms', 'registry'] +# - ['terms/container.md', 'terms', 'container'] +# - ['terms/repository.md', 'terms', 'repository'] +# - ['terms/filesystem.md', 'terms', 'filesystem'] +# - ['terms/image.md', 'terms', 'image'] diff --git a/docs/pr4923.patch b/docs/pr4923.patch new file mode 100644 index 0000000000..ef420520f7 --- /dev/null +++ b/docs/pr4923.patch @@ -0,0 +1,12836 @@ +diff --git a/docs/sources/articles.md b/docs/sources/articles.md +index da5a2d2..48654b0 100644 +--- a/docs/sources/articles.md ++++ b/docs/sources/articles.md +@@ -1,8 +1,7 @@ +-# Articles + +-## Contents: ++# Articles + +-- [Docker Security](security/) +-- [Create a Base Image](baseimages/) +-- [Runtime Metrics](runmetrics/) ++- [Docker Security](security/) ++- [Create a Base Image](baseimages/) ++- [Runtime Metrics](runmetrics/) + +diff --git a/docs/sources/articles/runmetrics.md b/docs/sources/articles/runmetrics.md +index 1a832d1..2372282 100644 +--- a/docs/sources/articles/runmetrics.md ++++ b/docs/sources/articles/runmetrics.md +@@ -56,7 +56,7 @@ ID or long ID of the container. If a container shows up as ae836c95b4c3 + in `docker ps`, its long ID might be something like + `ae836c95b4c3c9e9179e0e91015512da89fdec91612f63cebae57df9a5444c79`{.docutils + .literal}. You can look it up with `docker inspect` +-or `docker ps -notrunc`. ++or `docker ps --no-trunc`. + + Putting everything together to look at the memory metrics for a Docker + container, take a look at +diff --git a/docs/sources/articles/security.md b/docs/sources/articles/security.md +index 23d595f..13917f0 100644 +--- a/docs/sources/articles/security.md ++++ b/docs/sources/articles/security.md +@@ -5,7 +5,7 @@ page_keywords: Docker, Docker documentation, security + # Docker Security + + > *Adapted from* [Containers & Docker: How Secure are +-> They?](blogsecurity) ++> They?](http://blog.docker.io/2013/08/containers-docker-how-secure-are-they/) + + There are three major areas to consider when reviewing Docker security: + +@@ -255,4 +255,4 @@ with Docker, since everything is provided by the kernel anyway. + + For more context and especially for comparisons with VMs and other + container systems, please also see the [original blog +-post](blogsecurity). ++post](http://blog.docker.io/2013/08/containers-docker-how-secure-are-they/). +diff --git a/docs/sources/contributing.md b/docs/sources/contributing.md +index b311d13..0a31cb2 100644 +--- a/docs/sources/contributing.md ++++ b/docs/sources/contributing.md +@@ -1,7 +1,6 @@ +-# Contributing + +-## Contents: ++# Contributing + +-- [Contributing to Docker](contributing/) +-- [Setting Up a Dev Environment](devenvironment/) ++- [Contributing to Docker](contributing/) ++- [Setting Up a Dev Environment](devenvironment/) + +diff --git a/docs/sources/contributing/devenvironment.md b/docs/sources/contributing/devenvironment.md +index 3b77acf..76df680 100644 +--- a/docs/sources/contributing/devenvironment.md ++++ b/docs/sources/contributing/devenvironment.md +@@ -10,7 +10,7 @@ used for all tests, builds and releases. The standard development + environment defines all build dependencies: system libraries and + binaries, go environment, go dependencies, etc. + +-## Install Docker ++## Step 1: Install Docker + + Docker’s build environment itself is a Docker container, so the first + step is to install Docker on your system. +@@ -20,7 +20,7 @@ system](https://docs.docker.io/en/latest/installation/). Make sure you + have a working, up-to-date docker installation, then continue to the + next step. + +-## Install tools used for this tutorial ++## Step 2: Install tools used for this tutorial + + Install `git`; honest, it’s very good. You can use + other ways to get the Docker source, but they’re not anywhere near as +@@ -30,7 +30,7 @@ Install `make`. This tutorial uses our base Makefile + to kick off the docker containers in a repeatable and consistent way. + Again, you can do it in other ways but you need to do more work. + +-## Check out the Source ++## Step 3: Check out the Source + + git clone http://git@github.com/dotcloud/docker + cd docker +@@ -38,7 +38,7 @@ Again, you can do it in other ways but you need to do more work. + To checkout a different revision just use `git checkout`{.docutils + .literal} with the name of branch or revision number. + +-## Build the Environment ++## Step 4: Build the Environment + + This following command will build a development environment using the + Dockerfile in the current directory. Essentially, it will install all +@@ -50,7 +50,7 @@ This command will take some time to complete when you first execute it. + If the build is successful, congratulations! You have produced a clean + build of docker, neatly encapsulated in a standard build environment. + +-## Build the Docker Binary ++## Step 5: Build the Docker Binary + + To create the Docker binary, run this command: + +@@ -73,7 +73,7 @@ Note + Its safer to run the tests below before swapping your hosts docker + binary. + +-## Run the Tests ++## Step 5: Run the Tests + + To execute the test cases, run this command: + +@@ -114,7 +114,7 @@ eg. + + > TESTFLAGS=’-run \^TestBuild\$’ make test + +-## Use Docker ++## Step 6: Use Docker + + You can run an interactive session in the newly built container: + +@@ -122,7 +122,7 @@ You can run an interactive session in the newly built container: + + # type 'exit' or Ctrl-D to exit + +-## Build And View The Documentation ++## Extra Step: Build and view the Documentation + + If you want to read the documentation from a local website, or are + making changes to it, you can build the documentation and then serve it +diff --git a/docs/sources/examples.md b/docs/sources/examples.md +index 98b3d25..81ad1de 100644 +--- a/docs/sources/examples.md ++++ b/docs/sources/examples.md +@@ -1,25 +1,23 @@ + + # Examples + +-## Introduction: +- + Here are some examples of how to use Docker to create running processes, + starting from a very simple *Hello World* and progressing to more + substantial services like those which you might find in production. + +-## Contents: +- +-- [Check your Docker install](hello_world/) +-- [Hello World](hello_world/#hello-world) +-- [Hello World Daemon](hello_world/#hello-world-daemon) +-- [Node.js Web App](nodejs_web_app/) +-- [Redis Service](running_redis_service/) +-- [SSH Daemon Service](running_ssh_service/) +-- [CouchDB Service](couchdb_data_volumes/) +-- [PostgreSQL Service](postgresql_service/) +-- [Building an Image with MongoDB](mongodb/) +-- [Riak Service](running_riak_service/) +-- [Using Supervisor with Docker](using_supervisord/) +-- [Process Management with CFEngine](cfengine_process_management/) +-- [Python Web App](python_web_app/) ++- [Check your Docker install](hello_world/) ++- [Hello World](hello_world/#hello-world) ++- [Hello World Daemon](hello_world/#hello-world-daemon) ++- [Node.js Web App](nodejs_web_app/) ++- [Redis Service](running_redis_service/) ++- [SSH Daemon Service](running_ssh_service/) ++- [CouchDB Service](couchdb_data_volumes/) ++- [PostgreSQL Service](postgresql_service/) ++- [Building an Image with MongoDB](mongodb/) ++- [Riak Service](running_riak_service/) ++- [Using Supervisor with Docker](using_supervisord/) ++- [Process Management with CFEngine](cfengine_process_management/) ++- [Python Web App](python_web_app/) ++- [Apt-Cacher-ng Service](apt-cacher-ng/) ++- [Running Docker with https](https/) + +diff --git a/docs/sources/examples/couchdb_data_volumes.md b/docs/sources/examples/couchdb_data_volumes.md +index c4d478e..9665bb0 100644 +--- a/docs/sources/examples/couchdb_data_volumes.md ++++ b/docs/sources/examples/couchdb_data_volumes.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + 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 +diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md +index 8f2ae58..a9b0d7d 100644 +--- a/docs/sources/examples/hello_world.md ++++ b/docs/sources/examples/hello_world.md +@@ -2,7 +2,7 @@ page_title: Hello world example + page_description: A simple hello world example with Docker + page_keywords: docker, example, hello world + +-# Check your Docker installation ++# Check your Docker install + + This guide assumes you have a working installation of Docker. To check + your Docker install, run the following command: +@@ -18,7 +18,7 @@ privileges to access docker on your machine. + Please refer to [*Installation*](../../installation/#installation-list) + for installation instructions. + +-## Hello World ++# Hello World + + Note + +@@ -27,6 +27,8 @@ Note + install*](#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + This is the most basic example available for using Docker. + +@@ -59,7 +61,9 @@ standard out. + + See the example in action + +-## Hello World Daemon ++* * * * * ++ ++# Hello World Daemon + + Note + +@@ -68,6 +72,8 @@ Note + install*](#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + And now for the most boring daemon ever written! + +@@ -77,7 +83,7 @@ continue to do this until we stop it. + + **Steps:** + +- CONTAINER_ID=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done") ++ container_id=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done") + + We are going to run a simple hello world daemon in a new container made + from the `ubuntu` image. +@@ -89,31 +95,31 @@ from the `ubuntu` image. + - **“while true; do echo hello world; sleep 1; done”** is the mini + script we want to run, that will just print hello world once a + second until we stop it. +-- **\$CONTAINER\_ID** the output of the run command will return a ++- **\$container\_id** the output of the run command will return a + container id, we can use in future commands to see what is going on + with this process. + + + +- sudo docker logs $CONTAINER_ID ++ sudo docker logs $container_id + + Check the logs make sure it is working correctly. + + - **“docker logs**” This will return the logs for a container +-- **\$CONTAINER\_ID** The Id of the container we want the logs for. ++- **\$container\_id** The Id of the container we want the logs for. + + + +- sudo docker attach -sig-proxy=false $CONTAINER_ID ++ sudo docker attach --sig-proxy=false $container_id + + Attach to the container to see the results in real-time. + + - **“docker attach**” This will allow us to attach to a background + process to see what is going on. +-- **“-sig-proxy=false”** Do not forward signals to the container; ++- **“–sig-proxy=false”** Do not forward signals to the container; + allows us to exit the attachment using Control-C without stopping + the container. +-- **\$CONTAINER\_ID** The Id of the container we want to attach too. ++- **\$container\_id** The Id of the container we want to attach too. + + Exit from the container attachment by pressing Control-C. + +@@ -125,12 +131,12 @@ Check the process list to make sure it is running. + + + +- sudo docker stop $CONTAINER_ID ++ sudo docker stop $container_id + + Stop the container, since we don’t need it anymore. + + - **“docker stop”** This stops a container +-- **\$CONTAINER\_ID** The Id of the container we want to stop. ++- **\$container\_id** The Id of the container we want to stop. + + + +diff --git a/docs/sources/examples/mongodb.md b/docs/sources/examples/mongodb.md +index 6612bf3..3708c18 100644 +--- a/docs/sources/examples/mongodb.md ++++ b/docs/sources/examples/mongodb.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + 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 +@@ -43,7 +45,7 @@ we’ll divert `/sbin/initctl` to + + # Hack for initctl not being available in Ubuntu + RUN dpkg-divert --local --rename --add /sbin/initctl +- RUN ln -s /bin/true /sbin/initctl ++ RUN ln -sf /bin/true /sbin/initctl + + Afterwards we’ll be able to update our apt repositories and install + MongoDB +@@ -75,10 +77,10 @@ Now you should be able to run `mongod` as a daemon + and be able to connect on the local port! + + # Regular style +- MONGO_ID=$(sudo docker run -d /mongodb) ++ MONGO_ID=$(sudo docker run -P -d /mongodb) + + # Lean and mean +- MONGO_ID=$(sudo docker run -d /mongodb --noprealloc --smallfiles) ++ MONGO_ID=$(sudo docker run -P -d /mongodb --noprealloc --smallfiles) + + # Check the logs out + sudo docker logs $MONGO_ID +diff --git a/docs/sources/examples/nodejs_web_app.md b/docs/sources/examples/nodejs_web_app.md +index 8d692d8..59e6c77 100644 +--- a/docs/sources/examples/nodejs_web_app.md ++++ b/docs/sources/examples/nodejs_web_app.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + The goal of this example is to show you how you can build your own + Docker images from a parent image using a `Dockerfile`{.docutils +@@ -82,7 +84,7 @@ CentOS, we’ll use the instructions from the [Node.js + wiki](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager#rhelcentosscientific-linux-6): + + # Enable EPEL for Node.js +- RUN rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm ++ RUN rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm + # Install Node.js and npm + RUN yum install -y npm + +diff --git a/docs/sources/examples/postgresql_service.md b/docs/sources/examples/postgresql_service.md +index 211dcb2..b87d121 100644 +--- a/docs/sources/examples/postgresql_service.md ++++ b/docs/sources/examples/postgresql_service.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + ## Installing PostgreSQL on Docker + +@@ -34,7 +36,7 @@ suitably secure. + + # Add the PostgreSQL PGP key to verify their Debian packages. + # It should be the same key as https://www.postgresql.org/media/keys/ACCC4CF8.asc +- RUN apt-key adv --keyserver keyserver.ubuntu.com --recv-keys B97B0AFCAA1A47F044F244A07FCC7D46ACCC4CF8 ++ RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys B97B0AFCAA1A47F044F244A07FCC7D46ACCC4CF8 + + # Add PostgreSQL's repository. It contains the most recent stable release + # of PostgreSQL, ``9.3``. +@@ -85,7 +87,7 @@ Build an image from the Dockerfile assign it a name. + + 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 + Containers*](../../use/working_with_links_names/#working-with-links-names), +@@ -93,17 +95,17 @@ or we can access it from our host (or the network). + + Note + +-The `-rm` removes the container and its image when ++The `--rm` removes the container and its image when + the container exists successfully. + + ### Using container linking + + Containers can be linked to another container’s ports directly using +-`-link remote_name:local_alias` in the client’s ++`--link remote_name:local_alias` in the client’s + `docker run`. This will set a number of environment + variables that can then be used to connect: + +- $ sudo docker run -rm -t -i -link pg_test:pg eg_postgresql bash ++ $ sudo docker run --rm -t -i --link pg_test:pg eg_postgresql bash + + postgres@7ef98b1b7243:/$ psql -h $PG_PORT_5432_TCP_ADDR -p $PG_PORT_5432_TCP_PORT -d docker -U docker --password + +@@ -145,7 +147,7 @@ prompt, you can create a table and populate it. + You can use the defined volumes to inspect the PostgreSQL log files and + to backup your configuration and data: + +- docker run -rm --volumes-from pg_test -t -i busybox sh ++ docker run --rm --volumes-from pg_test -t -i busybox sh + + / # ls + bin etc lib linuxrc mnt proc run sys usr +diff --git a/docs/sources/examples/python_web_app.md b/docs/sources/examples/python_web_app.md +index b5854a4..8c0d783 100644 +--- a/docs/sources/examples/python_web_app.md ++++ b/docs/sources/examples/python_web_app.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + While using Dockerfiles is the preferred way to create maintainable and + repeatable images, its useful to know how you can try things out and +@@ -52,7 +54,7 @@ the `$URL` variable. The container is given a name + While this example is simple, you could run any number of interactive + commands, try things out, and then exit when you’re done. + +- $ sudo docker run -i -t -name pybuilder_run shykes/pybuilder bash ++ $ sudo docker run -i -t --name pybuilder_run shykes/pybuilder bash + + $$ URL=http://github.com/shykes/helloflask/archive/master.tar.gz + $$ /usr/local/bin/buildapp $URL +diff --git a/docs/sources/examples/running_redis_service.md b/docs/sources/examples/running_redis_service.md +index 81114e6..c0511a9 100644 +--- a/docs/sources/examples/running_redis_service.md ++++ b/docs/sources/examples/running_redis_service.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + Very simple, no frills, Redis service attached to a web application + using a link. +@@ -20,11 +22,11 @@ using a link. + Firstly, we create a `Dockerfile` for our new Redis + image. + +- FROM ubuntu:12.10 +- RUN apt-get update +- RUN apt-get -y install redis-server ++ FROM debian:jessie ++ RUN apt-get update && apt-get install -y redis-server + EXPOSE 6379 + ENTRYPOINT ["/usr/bin/redis-server"] ++ CMD ["--bind", "0.0.0.0"] + + Next we build an image from our `Dockerfile`. + Replace `` with your own user name. +@@ -48,7 +50,7 @@ database. + ## Create your web application container + + Next we can create a container for our application. We’re going to use +-the `-link` flag to create a link to the ++the `--link` flag to create a link to the + `redis` container we’ve just created with an alias + of `db`. This will create a secure tunnel to the + `redis` container and expose the Redis instance +diff --git a/docs/sources/examples/running_riak_service.md b/docs/sources/examples/running_riak_service.md +index e7171d8..c1b95e7 100644 +--- a/docs/sources/examples/running_riak_service.md ++++ b/docs/sources/examples/running_riak_service.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + The goal of this example is to show you how to build a Docker image with + Riak pre-installed. +@@ -85,7 +87,7 @@ Almost there. Next, we add a hack to get us by the lack of + # Hack for initctl + # See: https://github.com/dotcloud/docker/issues/1024 + RUN dpkg-divert --local --rename --add /sbin/initctl +- RUN ln -s /bin/true /sbin/initctl ++ RUN ln -sf /bin/true /sbin/initctl + + Then, we expose the Riak Protocol Buffers and HTTP interfaces, along + with SSH: +diff --git a/docs/sources/examples/running_ssh_service.md b/docs/sources/examples/running_ssh_service.md +index 112b9fa..2a0acfa 100644 +--- a/docs/sources/examples/running_ssh_service.md ++++ b/docs/sources/examples/running_ssh_service.md +@@ -4,12 +4,15 @@ page_keywords: docker, example, package installation, networking + + # SSH Daemon Service + +-> **Note:** +-> - This example assumes you have Docker running in daemon mode. For +-> more information please see [*Check your Docker +-> install*](../hello_world/#running-examples). +-> - **If you don’t like sudo** then see [*Giving non-root +-> access*](../../installation/binaries/#dockergroup) ++Note ++ ++- This example assumes you have Docker running in daemon mode. For ++ more information please see [*Check your Docker ++ install*](../hello_world/#running-examples). ++- **If you don’t like sudo** then see [*Giving non-root ++ access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + 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 +@@ -35,12 +38,12 @@ quick access to a test container. + + Build the image using: + +- $ sudo docker build -rm -t eg_sshd . ++ $ sudo docker build -t eg_sshd . + + Then run it. You can then use `docker port` to find + out what host port the container’s port 22 is mapped to: + +- $ sudo docker run -d -P -name test_sshd eg_sshd ++ $ sudo docker run -d -P --name test_sshd eg_sshd + $ sudo docker port test_sshd 22 + 0.0.0.0:49154 + +diff --git a/docs/sources/examples/using_supervisord.md b/docs/sources/examples/using_supervisord.md +index d64b300..8d6e796 100644 +--- a/docs/sources/examples/using_supervisord.md ++++ b/docs/sources/examples/using_supervisord.md +@@ -11,6 +11,8 @@ Note + install*](../hello_world/#running-examples). + - **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) ++- **If you’re using OS X or docker via TCP** then you shouldn’t use ++ sudo + + Traditionally a Docker container runs a single process when it is + launched, for example an Apache daemon or a SSH server daemon. Often +diff --git a/docs/sources/faq.md b/docs/sources/faq.md +index 06da238..4977f73 100644 +--- a/docs/sources/faq.md ++++ b/docs/sources/faq.md +@@ -1,122 +1,128 @@ ++page_title: FAQ ++page_description: Most frequently asked questions. ++page_keywords: faq, questions, documentation, docker ++ + # FAQ + + ## Most frequently asked questions. + + ### How much does Docker cost? + +-Docker is 100% free, it is open source, so you can use it without +-paying. ++> Docker is 100% free, it is open source, so you can use it without ++> paying. + + ### What open source license are you using? + +-We are using the Apache License Version 2.0. +-You can see it [here](https://github.com/dotcloud/docker/blob/master/LICENSE). ++> We are using the Apache License Version 2.0, see it here: ++> [https://github.com/dotcloud/docker/blob/master/LICENSE](https://github.com/dotcloud/docker/blob/master/LICENSE) + + ### Does Docker run on Mac OS X or Windows? + +-Not at this time, Docker currently only runs on Linux, but you can use +-VirtualBox to run Docker in a virtual machine on your box, and get the +-best of both worlds. Check out the [*Mac OSX*](../installation/mac/#macosx) and +-[*Windows*](../installation/windows/#windows) installation guides. The +-small Linux distribution *boot2docker* can be run inside virtual +-machines on these two operating systems. ++> Not at this time, Docker currently only runs on Linux, but you can use ++> VirtualBox to run Docker in a virtual machine on your box, and get the ++> best of both worlds. Check out the [*Mac OS ++> X*](../installation/mac/#macosx) and [*Microsoft ++> Windows*](../installation/windows/#windows) installation guides. The ++> small Linux distribution boot2docker can be run inside virtual ++> machines on these two operating systems. + + ### How do containers compare to virtual machines? + +-They are complementary. VMs are best used to allocate chunks of +-hardware resources. Containers operate at the process level, which +-makes them very lightweight and perfect as a unit of software +-delivery. ++> They are complementary. VMs are best used to allocate chunks of ++> hardware resources. Containers operate at the process level, which ++> makes them very lightweight and perfect as a unit of software ++> delivery. + + ### What does Docker add to just plain LXC? + +-Docker is not a replacement for LXC. “LXC” refers to capabilities of +-the Linux kernel (specifically namespaces and control groups) which +-allow sandboxing processes from one another, and controlling their +-resource allocations. On top of this low-level foundation of kernel +-features, Docker offers a high-level tool with several powerful +-functionalities: +- +- - **Portable deployment across machines:** +- Docker defines a format for bundling an application and all +- its dependencies into a single object which can be transferred +- to any Docker-enabled machine, and executed there with the +- guarantee that the execution environment exposed to the +- application will be the same. LXC implements process +- sandboxing, which is an important pre-requisite for portable +- deployment, but that alone is not enough for portable +- deployment. If you sent me a copy of your application +- installed in a custom LXC configuration, it would almost +- certainly not run on my machine the way it does on yours, +- because it is tied to your machine’s specific configuration: +- networking, storage, logging, distro, etc. Docker defines an +- abstraction for these machine-specific settings, so that the +- exact same Docker container can run - unchanged - on many +- different machines, with many different configurations. +- +- - **Application-centric:** +- Docker is optimized for the deployment of applications, as +- opposed to machines. This is reflected in its API, user +- interface, design philosophy and documentation. By contrast, +- the `lxc` helper scripts focus on +- containers as lightweight machines - basically servers that +- boot faster and need less RAM. We think there’s more to +- containers than just that. +- +- - **Automatic build:** +- Docker includes [*a tool for developers to automatically +- assemble a container from their source +- code*](../reference/builder/#dockerbuilder), with full control +- over application dependencies, build tools, packaging etc. +- They are free to use +- `make, maven, chef, puppet, salt,` Debian +- packages, RPMs, source tarballs, or any combination of the +- above, regardless of the configuration of the machines. +- +- - **Versioning:** +- Docker includes git-like capabilities for tracking successive +- versions of a container, inspecting the diff between versions, +- committing new versions, rolling back etc. The history also +- includes how a container was assembled and by whom, so you get +- full traceability from the production server all the way back +- to the upstream developer. Docker also implements incremental +- uploads and downloads, similar to `git pull`{.docutils +- .literal}, so new versions of a container can be transferred +- by only sending diffs. +- +- - **Component re-use:** +- Any container can be used as a [*“base +- image”*](../terms/image/#base-image-def) to create more +- specialized components. This can be done manually or as part +- of an automated build. For example you can prepare the ideal +- Python environment, and use it as a base for 10 different +- applications. Your ideal Postgresql setup can be re-used for +- all your future projects. And so on. +- +- - **Sharing:** +- Docker has access to a [public registry](http://index.docker.io) +- where thousands of people have uploaded useful containers: anything +- from Redis, CouchDB, Postgres to IRC bouncers to Rails app servers to +- Hadoop to base images for various Linux distros. The +- [*registry*](../reference/api/registry_index_spec/#registryindexspec) +- also includes an official “standard library” of useful +- containers maintained by the Docker team. The registry itself +- is open-source, so anyone can deploy their own registry to +- store and transfer private containers, for internal server +- deployments for example. +- +- - **Tool ecosystem:** +- Docker defines an API for automating and customizing the +- creation and deployment of containers. There are a huge number +- of tools integrating with Docker to extend its capabilities. +- PaaS-like deployment (Dokku, Deis, Flynn), multi-node +- orchestration (Maestro, Salt, Mesos, Openstack Nova), +- management dashboards (docker-ui, Openstack Horizon, +- Shipyard), configuration management (Chef, Puppet), continuous +- integration (Jenkins, Strider, Travis), etc. Docker is rapidly +- establishing itself as the standard for container-based +- tooling. +- ++> Docker is not a replacement for LXC. “LXC” refers to capabilities of ++> the Linux kernel (specifically namespaces and control groups) which ++> allow sandboxing processes from one another, and controlling their ++> resource allocations. On top of this low-level foundation of kernel ++> features, Docker offers a high-level tool with several powerful ++> functionalities: ++> ++> - *Portable deployment across machines.* ++> : Docker defines a format for bundling an application and all ++> its dependencies into a single object which can be transferred ++> to any Docker-enabled machine, and executed there with the ++> guarantee that the execution environment exposed to the ++> application will be the same. LXC implements process ++> sandboxing, which is an important pre-requisite for portable ++> deployment, but that alone is not enough for portable ++> deployment. If you sent me a copy of your application ++> installed in a custom LXC configuration, it would almost ++> certainly not run on my machine the way it does on yours, ++> because it is tied to your machine’s specific configuration: ++> networking, storage, logging, distro, etc. Docker defines an ++> abstraction for these machine-specific settings, so that the ++> exact same Docker container can run - unchanged - on many ++> different machines, with many different configurations. ++> ++> - *Application-centric.* ++> : Docker is optimized for the deployment of applications, as ++> opposed to machines. This is reflected in its API, user ++> interface, design philosophy and documentation. By contrast, ++> the `lxc` helper scripts focus on ++> containers as lightweight machines - basically servers that ++> boot faster and need less RAM. We think there’s more to ++> containers than just that. ++> ++> - *Automatic build.* ++> : Docker includes [*a tool for developers to automatically ++> assemble a container from their source ++> code*](../reference/builder/#dockerbuilder), with full control ++> over application dependencies, build tools, packaging etc. ++> They are free to use ++> `make, maven, chef, puppet, salt,` Debian ++> packages, RPMs, source tarballs, or any combination of the ++> above, regardless of the configuration of the machines. ++> ++> - *Versioning.* ++> : Docker includes git-like capabilities for tracking successive ++> versions of a container, inspecting the diff between versions, ++> committing new versions, rolling back etc. The history also ++> includes how a container was assembled and by whom, so you get ++> full traceability from the production server all the way back ++> to the upstream developer. Docker also implements incremental ++> uploads and downloads, similar to `git pull`{.docutils ++> .literal}, so new versions of a container can be transferred ++> by only sending diffs. ++> ++> - *Component re-use.* ++> : Any container can be used as a [*“base ++> image”*](../terms/image/#base-image-def) to create more ++> specialized components. This can be done manually or as part ++> of an automated build. For example you can prepare the ideal ++> Python environment, and use it as a base for 10 different ++> applications. Your ideal Postgresql setup can be re-used for ++> all your future projects. And so on. ++> ++> - *Sharing.* ++> : Docker has access to a [public ++> registry](http://index.docker.io) where thousands of people ++> have uploaded useful containers: anything from Redis, CouchDB, ++> Postgres to IRC bouncers to Rails app servers to Hadoop to ++> base images for various Linux distros. The ++> [*registry*](../reference/api/registry_index_spec/#registryindexspec) ++> also includes an official “standard library” of useful ++> containers maintained by the Docker team. The registry itself ++> is open-source, so anyone can deploy their own registry to ++> store and transfer private containers, for internal server ++> deployments for example. ++> ++> - *Tool ecosystem.* ++> : Docker defines an API for automating and customizing the ++> creation and deployment of containers. There are a huge number ++> of tools integrating with Docker to extend its capabilities. ++> PaaS-like deployment (Dokku, Deis, Flynn), multi-node ++> orchestration (Maestro, Salt, Mesos, Openstack Nova), ++> management dashboards (docker-ui, Openstack Horizon, ++> Shipyard), configuration management (Chef, Puppet), continuous ++> integration (Jenkins, Strider, Travis), etc. Docker is rapidly ++> establishing itself as the standard for container-based ++> tooling. ++> + ### What is different between a Docker container and a VM? + + There’s a great StackOverflow answer [showing the +@@ -159,22 +165,22 @@ here](http://docs.docker.io/en/latest/examples/using_supervisord/). + + ### What platforms does Docker run on? + +-**Linux:** ++Linux: + +-- Ubuntu 12.04, 13.04 et al +-- Fedora 19/20+ +-- RHEL 6.5+ +-- Centos 6+ +-- Gentoo +-- ArchLinux +-- openSUSE 12.3+ +-- CRUX 3.0+ ++- Ubuntu 12.04, 13.04 et al ++- Fedora 19/20+ ++- RHEL 6.5+ ++- Centos 6+ ++- Gentoo ++- ArchLinux ++- openSUSE 12.3+ ++- CRUX 3.0+ + +-**Cloud:** ++Cloud: + +-- Amazon EC2 +-- Google Compute Engine +-- Rackspace ++- Amazon EC2 ++- Google Compute Engine ++- Rackspace + + ### How do I report a security issue with Docker? + +@@ -196,14 +202,17 @@ sources. + + ### Where can I find more answers? + +-You can find more answers on: +- +-- [Docker user mailinglist](https://groups.google.com/d/forum/docker-user) +-- [Docker developer mailinglist](https://groups.google.com/d/forum/docker-dev) +-- [IRC, docker on freenode](irc://chat.freenode.net#docker) +-- [GitHub](http://www.github.com/dotcloud/docker) +-- [Ask questions on Stackoverflow](http://stackoverflow.com/search?q=docker) +-- [Join the conversation on Twitter](http://twitter.com/docker) ++> You can find more answers on: ++> ++> - [Docker user ++> mailinglist](https://groups.google.com/d/forum/docker-user) ++> - [Docker developer ++> mailinglist](https://groups.google.com/d/forum/docker-dev) ++> - [IRC, docker on freenode](irc://chat.freenode.net#docker) ++> - [GitHub](http://www.github.com/dotcloud/docker) ++> - [Ask questions on ++> Stackoverflow](http://stackoverflow.com/search?q=docker) ++> - [Join the conversation on Twitter](http://twitter.com/docker) + + Looking for something else to read? Checkout the [*Hello + World*](../examples/hello_world/#hello-world) example. +diff --git a/docs/sources/genindex.md b/docs/sources/genindex.md +index 8b013d6..e9bcd34 100644 +--- a/docs/sources/genindex.md ++++ b/docs/sources/genindex.md +@@ -1 +1,2 @@ ++ + # Index +diff --git a/docs/sources/http-routingtable.md b/docs/sources/http-routingtable.md +index 2a06fdb..4ca4116 100644 +--- a/docs/sources/http-routingtable.md ++++ b/docs/sources/http-routingtable.md +@@ -1,3 +1,4 @@ ++ + # HTTP Routing Table + + [**/api**](#cap-/api) | [**/auth**](#cap-/auth) | +diff --git a/docs/sources/index.md b/docs/sources/index.md +index c5a5b6f..dd9e272 100644 +--- a/docs/sources/index.md ++++ b/docs/sources/index.md +@@ -1,3 +1 @@ +-# Docker Documentation +- +-## Introduction +\ No newline at end of file ++# Docker documentation +diff --git a/docs/sources/installation.md b/docs/sources/installation.md +index 0ee7b2f..4fdd102 100644 +--- a/docs/sources/installation.md ++++ b/docs/sources/installation.md +@@ -1,25 +1,26 @@ +-# Installation + +-## Introduction ++# Installation + + There are a number of ways to install Docker, depending on where you + want to run the daemon. The [*Ubuntu*](ubuntulinux/#ubuntu-linux) + installation is the officially-tested version. The community adds more + techniques for installing Docker all the time. + +-## Contents: ++Contents: ++ ++- [Ubuntu](ubuntulinux/) ++- [Red Hat Enterprise Linux](rhel/) ++- [Fedora](fedora/) ++- [Arch Linux](archlinux/) ++- [CRUX Linux](cruxlinux/) ++- [Gentoo](gentoolinux/) ++- [openSUSE](openSUSE/) ++- [FrugalWare](frugalware/) ++- [Mac OS X](mac/) ++- [Microsoft Windows](windows/) ++- [Amazon EC2](amazon/) ++- [Rackspace Cloud](rackspace/) ++- [Google Cloud Platform](google/) ++- [IBM SoftLayer](softlayer/) ++- [Binaries](binaries/) + +-- [Ubuntu](ubuntulinux/) +-- [Red Hat Enterprise Linux](rhel/) +-- [Fedora](fedora/) +-- [Arch Linux](archlinux/) +-- [CRUX Linux](cruxlinux/) +-- [Gentoo](gentoolinux/) +-- [openSUSE](openSUSE/) +-- [FrugalWare](frugalware/) +-- [Mac OS X](mac/) +-- [Windows](windows/) +-- [Amazon EC2](amazon/) +-- [Rackspace Cloud](rackspace/) +-- [Google Cloud Platform](google/) +-- [Binaries](binaries/) +\ No newline at end of file +diff --git a/docs/sources/installation/binaries.md b/docs/sources/installation/binaries.md +index 5d761de..0aa22ca 100644 +--- a/docs/sources/installation/binaries.md ++++ b/docs/sources/installation/binaries.md +@@ -23,14 +23,15 @@ packages for many distributions, and more keep showing up all the time! + To run properly, docker needs the following software to be installed at + runtime: + +-- iproute2 version 3.5 or later (build after 2012-05-21), and +- specifically the “ip” utility + - iptables version 1.4 or later +-- The LXC utility scripts +- ([http://lxc.sourceforge.net](http://lxc.sourceforge.net)) version +- 0.8 or later + - Git version 1.7 or later + - XZ Utils 4.9 or later ++- a [properly ++ mounted](https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount) ++ cgroupfs hierarchy (having a single, all-encompassing “cgroup” mount ++ point [is](https://github.com/dotcloud/docker/issues/2683) ++ [not](https://github.com/dotcloud/docker/issues/3485) ++ [sufficient](https://github.com/dotcloud/docker/issues/4568)) + + ## Check kernel dependencies + +@@ -38,7 +39,7 @@ Docker in daemon mode has specific kernel requirements. For details, + check your distribution in [*Installation*](../#installation-list). + + Note that Docker also has a client mode, which can run on virtually any +-linux kernel (it even builds on OSX!). ++Linux kernel (it even builds on OSX!). + + ## Get the docker binary: + +@@ -69,7 +70,9 @@ all the client commands. + + Warning + +-The *docker* group is root-equivalent. ++The *docker* group (or the group specified with `-G`{.docutils ++.literal}) is root-equivalent; see [*Docker Daemon Attack ++Surface*](../../articles/security/#dockersecurity-daemon) details. + + ## Upgrades + +diff --git a/docs/sources/installation/fedora.md b/docs/sources/installation/fedora.md +index 545e523..32f4fd2 100644 +--- a/docs/sources/installation/fedora.md ++++ b/docs/sources/installation/fedora.md +@@ -31,13 +31,14 @@ installed already, it will conflict with `docker-io`{.docutils + .literal}. There’s a [bug + report](https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for + it. To proceed with `docker-io` installation on +-Fedora 19, please remove `docker` first. ++Fedora 19 or Fedora 20, please remove `docker` ++first. + + sudo yum -y remove docker + +-For Fedora 20 and later, the `wmdocker` package will +-provide the same functionality as `docker` and will +-also not conflict with `docker-io`. ++For Fedora 21 and later, the `wmdocker` package will ++provide the same functionality as the old `docker` ++and will also not conflict with `docker-io`. + + sudo yum -y install wmdocker + sudo yum -y remove docker +diff --git a/docs/sources/installation/ubuntulinux.md b/docs/sources/installation/ubuntulinux.md +index 8c83e87..b6e9889 100644 +--- a/docs/sources/installation/ubuntulinux.md ++++ b/docs/sources/installation/ubuntulinux.md +@@ -56,13 +56,13 @@ These instructions have changed for 0.6. If you are upgrading from an + earlier version, you will need to follow them again. + + Docker is available as a Debian package, which makes installation easy. +-**See the :ref:\`installmirrors\` section below if you are not in the +-United States.** Other sources of the Debian packages may be faster for +-you to install. ++**See the** [*Docker and local DNS server warnings*](#installmirrors) ++**section below if you are not in the United States.** Other sources of ++the Debian packages may be faster for you to install. + + First add the Docker repository key to your local keychain. + +- sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 ++ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 + + Add the Docker repository to your apt sources list, update and install + the `lxc-docker` package. +@@ -121,7 +121,7 @@ upgrading from an earlier version, you will need to follow them again. + + First add the Docker repository key to your local keychain. + +- sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 ++ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 + + Add the Docker repository to your apt sources list, update and install + the `lxc-docker` package. +@@ -156,11 +156,15 @@ socket read/writable by the *docker* group when the daemon starts. The + `docker` daemon must always run as the root user, + but if you run the `docker` client as a user in the + *docker* group then you don’t need to add `sudo` to +-all the client commands. ++all the client commands. As of 0.9.0, you can specify that a group other ++than `docker` should own the Unix socket with the ++`-G` option. + + Warning + +-The *docker* group is root-equivalent. ++The *docker* group (or the group specified with `-G`{.docutils ++.literal}) is root-equivalent; see [*Docker Daemon Attack ++Surface*](../../articles/security/#dockersecurity-daemon) details. + + **Example:** + +@@ -259,9 +263,9 @@ Docker daemon for the containers: + sudo nano /etc/default/docker + --- + # Add: +- DOCKER_OPTS="-dns 8.8.8.8" ++ DOCKER_OPTS="--dns 8.8.8.8" + # 8.8.8.8 could be replaced with a local DNS server, such as 192.168.1.1 +- # multiple DNS servers can be specified: -dns 8.8.8.8 -dns 192.168.1.1 ++ # multiple DNS servers can be specified: --dns 8.8.8.8 --dns 192.168.1.1 + + The Docker daemon has to be restarted: + +diff --git a/docs/sources/installation/windows.md b/docs/sources/installation/windows.md +index ec3e706..ad367d9 100644 +--- a/docs/sources/installation/windows.md ++++ b/docs/sources/installation/windows.md +@@ -2,7 +2,7 @@ page_title: Installation on Windows + page_description: Please note this project is currently under heavy development. It should not be used in production. + page_keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker + +-# Windows ++# Microsoft Windows + + Docker can run on Windows using a virtualization platform like + VirtualBox. A Linux distribution is run inside a virtual machine and +@@ -17,7 +17,7 @@ production yet, but we’re getting closer with each release. Please see + our blog post, [“Getting to Docker + 1.0”](http://blog.docker.io/2013/08/getting-to-docker-1-0/) + +-1. Install virtualbox from ++1. Install VirtualBox from + [https://www.virtualbox.org](https://www.virtualbox.org) - or follow + this + [tutorial](http://www.slideshare.net/julienbarbier42/install-virtualbox-on-windows-7). +diff --git a/docs/sources/reference.md b/docs/sources/reference.md +index 3cd720c..1c4022e 100644 +--- a/docs/sources/reference.md ++++ b/docs/sources/reference.md +@@ -1,9 +1,10 @@ ++ + # Reference Manual + +-## Contents: ++Contents: + +-- [Commands](commandline/) +-- [Dockerfile Reference](builder/) +-- [Docker Run Reference](run/) +-- [APIs](api/) ++- [Commands](commandline/) ++- [Dockerfile Reference](builder/) ++- [Docker Run Reference](run/) ++- [APIs](api/) + +diff --git a/docs/sources/reference/api.md b/docs/sources/reference/api.md +index ae55e6a..ce571bc 100644 +--- a/docs/sources/reference/api.md ++++ b/docs/sources/reference/api.md +@@ -1,3 +1,4 @@ ++ + # APIs + + Your programs and scripts can access Docker’s functionality via these +@@ -8,34 +9,28 @@ interfaces: + - [1.1 Index](registry_index_spec/#index) + - [1.2 Registry](registry_index_spec/#registry) + - [1.3 Docker](registry_index_spec/#docker) +- + - [2. Workflow](registry_index_spec/#workflow) + - [2.1 Pull](registry_index_spec/#pull) + - [2.2 Push](registry_index_spec/#push) + - [2.3 Delete](registry_index_spec/#delete) +- + - [3. How to use the Registry in standalone + mode](registry_index_spec/#how-to-use-the-registry-in-standalone-mode) + - [3.1 Without an + Index](registry_index_spec/#without-an-index) + - [3.2 With an Index](registry_index_spec/#with-an-index) +- + - [4. The API](registry_index_spec/#the-api) + - [4.1 Images](registry_index_spec/#images) + - [4.2 Users](registry_index_spec/#users) + - [4.3 Tags (Registry)](registry_index_spec/#tags-registry) + - [4.4 Images (Index)](registry_index_spec/#images-index) + - [4.5 Repositories](registry_index_spec/#repositories) +- + - [5. Chaining + Registries](registry_index_spec/#chaining-registries) + - [6. Authentication & + Authorization](registry_index_spec/#authentication-authorization) + - [6.1 On the Index](registry_index_spec/#on-the-index) + - [6.2 On the Registry](registry_index_spec/#on-the-registry) +- + - [7 Document Version](registry_index_spec/#document-version) +- + - [Docker Registry API](registry_api/) + - [1. Brief introduction](registry_api/#brief-introduction) + - [2. Endpoints](registry_api/#endpoints) +@@ -43,16 +38,13 @@ interfaces: + - [2.2 Tags](registry_api/#tags) + - [2.3 Repositories](registry_api/#repositories) + - [2.4 Status](registry_api/#status) +- + - [3 Authorization](registry_api/#authorization) +- + - [Docker Index API](index_api/) + - [1. Brief introduction](index_api/#brief-introduction) + - [2. Endpoints](index_api/#endpoints) + - [2.1 Repository](index_api/#repository) + - [2.2 Users](index_api/#users) + - [2.3 Search](index_api/#search) +- + - [Docker Remote API](docker_remote_api/) + - [1. Brief introduction](docker_remote_api/#brief-introduction) + - [2. Versions](docker_remote_api/#versions) +@@ -67,7 +59,6 @@ interfaces: + - [v1.2](docker_remote_api/#v1-2) + - [v1.1](docker_remote_api/#v1-1) + - [v1.0](docker_remote_api/#v1-0) +- + - [Docker Remote API Client Libraries](remote_api_client_libraries/) + - [docker.io OAuth API](docker_io_oauth_api/) + - [1. Brief introduction](docker_io_oauth_api/#brief-introduction) +@@ -79,10 +70,8 @@ interfaces: + - [3.2 Get an Access + Token](docker_io_oauth_api/#get-an-access-token) + - [3.3 Refresh a Token](docker_io_oauth_api/#refresh-a-token) +- + - [4. Use an Access Token with the + API](docker_io_oauth_api/#use-an-access-token-with-the-api) +- + - [docker.io Accounts API](docker_io_accounts_api/) + - [1. Endpoints](docker_io_accounts_api/#endpoints) + - [1.1 Get a single +@@ -96,4 +85,5 @@ interfaces: + - [1.5 Update an email address for a + user](docker_io_accounts_api/#update-an-email-address-for-a-user) + - [1.6 Delete email address for a +- user](docker_io_accounts_api/#delete-email-address-for-a-user) +\ No newline at end of file ++ user](docker_io_accounts_api/#delete-email-address-for-a-user) ++ +diff --git a/docs/sources/reference/api/docker_io_accounts_api.md b/docs/sources/reference/api/docker_io_accounts_api.md +index 6ad5361..dc78076 100644 +--- a/docs/sources/reference/api/docker_io_accounts_api.md ++++ b/docs/sources/reference/api/docker_io_accounts_api.md +@@ -2,35 +2,50 @@ page_title: docker.io Accounts API + page_description: API Documentation for docker.io accounts. + page_keywords: API, Docker, accounts, REST, documentation + +-# Docker IO Accounts API ++# [docker.io Accounts API](#id1) + +-## Endpoints ++Table of Contents + +-### Get A Single User ++- [docker.io Accounts API](#docker-io-accounts-api) ++ - [1. Endpoints](#endpoints) ++ - [1.1 Get a single user](#get-a-single-user) ++ - [1.2 Update a single user](#update-a-single-user) ++ - [1.3 List email addresses for a ++ user](#list-email-addresses-for-a-user) ++ - [1.4 Add email address for a ++ user](#add-email-address-for-a-user) ++ - [1.5 Update an email address for a ++ user](#update-an-email-address-for-a-user) ++ - [1.6 Delete email address for a ++ user](#delete-email-address-for-a-user) ++ ++## [1. Endpoints](#id2) ++ ++### [1.1 Get a single user](#id3) + + `GET `{.descname}`/api/v1.1/users/:username/`{.descname} + : Get profile info for the specified user. + + Parameters: + +- - **username** – username of the user whose profile info is being ++ - **username** – username of the user whose profile info is being + requested. + + Request Headers: + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + + Status Codes: + +- - **200** – success, user data returned. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **200** – success, user data returned. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `profile_read` scope. +- - **404** – the specified username does not exist. ++ - **404** – the specified username does not exist. + + **Example request**: + +@@ -59,45 +74,45 @@ page_keywords: API, Docker, accounts, REST, documentation + "is_active": true + } + +-### Update A Single User ++### [1.2 Update a single user](#id4) + + `PATCH `{.descname}`/api/v1.1/users/:username/`{.descname} + : Update profile info for the specified user. + + Parameters: + +- - **username** – username of the user whose profile info is being ++ - **username** – username of the user whose profile info is being + updated. + + Json Parameters: + +   + +- - **full\_name** (*string*) – (optional) the new name of the user. +- - **location** (*string*) – (optional) the new location. +- - **company** (*string*) – (optional) the new company of the user. +- - **profile\_url** (*string*) – (optional) the new profile url. +- - **gravatar\_email** (*string*) – (optional) the new Gravatar ++ - **full\_name** (*string*) – (optional) the new name of the user. ++ - **location** (*string*) – (optional) the new location. ++ - **company** (*string*) – (optional) the new company of the user. ++ - **profile\_url** (*string*) – (optional) the new profile url. ++ - **gravatar\_email** (*string*) – (optional) the new Gravatar + email address. + + Request Headers: + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- - **Content-Type** – MIME Type of post data. JSON, url-encoded ++ - **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + + Status Codes: + +- - **200** – success, user data updated. +- - **400** – post data validation error. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **200** – success, user data updated. ++ - **400** – post data validation error. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being updated, OAuth access tokens must have + `profile_write` scope. +- - **404** – the specified username does not exist. ++ - **404** – the specified username does not exist. + + **Example request**: + +@@ -132,31 +147,31 @@ page_keywords: API, Docker, accounts, REST, documentation + "is_active": true + } + +-### List Email Addresses For A User ++### [1.3 List email addresses for a user](#id5) + + `GET `{.descname}`/api/v1.1/users/:username/emails/`{.descname} + : List email info for the specified user. + + Parameters: + +- - **username** – username of the user whose profile info is being ++ - **username** – username of the user whose profile info is being + updated. + + Request Headers: + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token + + Status Codes: + +- - **200** – success, user data updated. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **200** – success, user data updated. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_read` scope. +- - **404** – the specified username does not exist. ++ - **404** – the specified username does not exist. + + **Example request**: + +@@ -170,7 +185,7 @@ page_keywords: API, Docker, accounts, REST, documentation + HTTP/1.1 200 OK + Content-Type: application/json + +- ++ [ + { + "email": "jane.doe@example.com", + "verified": true, +@@ -178,7 +193,7 @@ page_keywords: API, Docker, accounts, REST, documentation + } + ] + +-### Add Email Address For A User ++### [1.4 Add email address for a user](#id6) + + `POST `{.descname}`/api/v1.1/users/:username/emails/`{.descname} + : Add a new email address to the specified user’s account. The email +@@ -189,26 +204,26 @@ page_keywords: API, Docker, accounts, REST, documentation + +   + +- - **email** (*string*) – email address to be added. ++ - **email** (*string*) – email address to be added. + + Request Headers: + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- - **Content-Type** – MIME Type of post data. JSON, url-encoded ++ - **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + + Status Codes: + +- - **201** – success, new email added. +- - **400** – data validation error. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **201** – success, new email added. ++ - **400** – data validation error. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_write` scope. +- - **404** – the specified username does not exist. ++ - **404** – the specified username does not exist. + + **Example request**: + +@@ -233,7 +248,7 @@ page_keywords: API, Docker, accounts, REST, documentation + "primary": false + } + +-### Update An Email Address For A User ++### [1.5 Update an email address for a user](#id7) + + `PATCH `{.descname}`/api/v1.1/users/:username/emails/`{.descname} + : Update an email address for the specified user to either verify an +@@ -244,17 +259,17 @@ page_keywords: API, Docker, accounts, REST, documentation + + Parameters: + +- - **username** – username of the user whose email info is being ++ - **username** – username of the user whose email info is being + updated. + + Json Parameters: + +   + +- - **email** (*string*) – the email address to be updated. +- - **verified** (*boolean*) – (optional) whether the email address ++ - **email** (*string*) – the email address to be updated. ++ - **verified** (*boolean*) – (optional) whether the email address + is verified, must be `true` or absent. +- - **primary** (*boolean*) – (optional) whether to set the email ++ - **primary** (*boolean*) – (optional) whether to set the email + address as the primary email, must be `true` + or absent. + +@@ -262,20 +277,20 @@ page_keywords: API, Docker, accounts, REST, documentation + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- - **Content-Type** – MIME Type of post data. JSON, url-encoded ++ - **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + + Status Codes: + +- - **200** – success, user’s email updated. +- - **400** – data validation error. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **200** – success, user’s email updated. ++ - **400** – data validation error. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being updated, OAuth access tokens must have + `email_write` scope. +- - **404** – the specified username or email address does not ++ - **404** – the specified username or email address does not + exist. + + **Example request**: +@@ -303,7 +318,7 @@ page_keywords: API, Docker, accounts, REST, documentation + "primary": false + } + +-### Delete Email Address For A User ++### [1.6 Delete email address for a user](#id8) + + `DELETE `{.descname}`/api/v1.1/users/:username/emails/`{.descname} + : Delete an email address from the specified user’s account. You +@@ -313,26 +328,26 @@ page_keywords: API, Docker, accounts, REST, documentation + +   + +- - **email** (*string*) – email address to be deleted. ++ - **email** (*string*) – email address to be deleted. + + Request Headers: + +   + +- - **Authorization** – required authentication credentials of ++ - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. +- - **Content-Type** – MIME Type of post data. JSON, url-encoded ++ - **Content-Type** – MIME Type of post data. JSON, url-encoded + form data, etc. + + Status Codes: + +- - **204** – success, email address removed. +- - **400** – validation error. +- - **401** – authentication error. +- - **403** – permission error, authenticated user must be the user ++ - **204** – success, email address removed. ++ - **400** – validation error. ++ - **401** – authentication error. ++ - **403** – permission error, authenticated user must be the user + whose data is being requested, OAuth access tokens must have + `email_write` scope. +- - **404** – the specified username or email address does not ++ - **404** – the specified username or email address does not + exist. + + **Example request**: +@@ -350,4 +365,6 @@ page_keywords: API, Docker, accounts, REST, documentation + **Example response**: + + HTTP/1.1 204 NO CONTENT +- Content-Length: 0 +\ No newline at end of file ++ Content-Length: 0 ++ ++ +diff --git a/docs/sources/reference/api/docker_io_oauth_api.md b/docs/sources/reference/api/docker_io_oauth_api.md +index 85f3a22..c39ab56 100644 +--- a/docs/sources/reference/api/docker_io_oauth_api.md ++++ b/docs/sources/reference/api/docker_io_oauth_api.md +@@ -2,9 +2,21 @@ page_title: docker.io OAuth API + page_description: API Documentation for docker.io's OAuth flow. + page_keywords: API, Docker, oauth, REST, documentation + +-# Docker IO OAuth API ++# [docker.io OAuth API](#id1) + +-## Introduction ++Table of Contents ++ ++- [docker.io OAuth API](#docker-io-oauth-api) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Register Your Application](#register-your-application) ++ - [3. Endpoints](#endpoints) ++ - [3.1 Get an Authorization Code](#get-an-authorization-code) ++ - [3.2 Get an Access Token](#get-an-access-token) ++ - [3.3 Refresh a Token](#refresh-a-token) ++ - [4. Use an Access Token with the ++ API](#use-an-access-token-with-the-api) ++ ++## [1. Brief introduction](#id2) + + Some docker.io API requests will require an access token to + authenticate. To get an access token for a user, that user must first +@@ -12,13 +24,13 @@ grant your application access to their docker.io account. In order for + them to grant your application access you must first register your + application. + +-Before continuing, we encourage you to familiarize yourself with The +-OAuth 2.0 Authorization Framework](http://tools.ietf.org/c6749). ++Before continuing, we encourage you to familiarize yourself with [The ++OAuth 2.0 Authorization Framework](http://tools.ietf.org/html/rfc6749). + + *Also note that all OAuth interactions must take place over https + connections* + +-## Registering Your Application ++## [2. Register Your Application](#id3) + + You will need to register your application with docker.io before users + will be able to grant your application access to their account +@@ -27,10 +39,10 @@ request registration of your application send an email to + [support-accounts@docker.com](mailto:support-accounts%40docker.com) with + the following information: + +-- The name of your application +-- A description of your application and the service it will provide to ++- The name of your application ++- A description of your application and the service it will provide to + docker.io users. +-- A callback URI that we will use for redirecting authorization ++- A callback URI that we will use for redirecting authorization + requests to your application. These are used in the step of getting + an Authorization Code. The domain name of the callback URI will be + visible to the user when they are requested to authorize your +@@ -41,9 +53,9 @@ docker.io team with your `client_id` and + `client_secret` which your application will use in + the steps of getting an Authorization Code and getting an Access Token. + +-## Endpoints ++## [3. Endpoints](#id4) + +-### Get an Authorization Code ++### [3.1 Get an Authorization Code](#id5) + + Once You have registered you are ready to start integrating docker.io + accounts into your application! The process is usually started by a user +@@ -61,24 +73,24 @@ following a link in your application to an OAuth Authorization endpoint. + +   + +- - **client\_id** – The `client_id` given to ++ - **client\_id** – The `client_id` given to + your application at registration. +- - **response\_type** – MUST be set to `code`. ++ - **response\_type** – MUST be set to `code`. + This specifies that you would like an Authorization Code + returned. +- - **redirect\_uri** – The URI to redirect back to after the user ++ - **redirect\_uri** – The URI to redirect back to after the user + has authorized your application. If omitted, the first of your + registered `response_uris` is used. If + included, it must be one of the URIs which were submitted when + registering your application. +- - **scope** – The extent of access permissions you are requesting. ++ - **scope** – The extent of access permissions you are requesting. + Currently, the scope options are `profile_read`{.docutils + .literal}, `profile_write`, + `email_read`, and `email_write`{.docutils + .literal}. Scopes must be separated by a space. If omitted, the + default scopes `profile_read email_read` are + used. +- - **state** – (Recommended) Used by your application to maintain ++ - **state** – (Recommended) Used by your application to maintain + state between the authorization request and callback to protect + against CSRF attacks. + +@@ -115,7 +127,7 @@ following a link in your application to an OAuth Authorization endpoint. + : An error message in the event of the user denying the + authorization or some other kind of error with the request. + +-### Get an Access Token ++### [3.2 Get an Access Token](#id6) + + Once the user has authorized your application, a request will be made to + your application’s specified `redirect_uri` which +@@ -131,7 +143,7 @@ to get an Access Token. + +   + +- - **Authorization** – HTTP basic authentication using your ++ - **Authorization** – HTTP basic authentication using your + application’s `client_id` and + `client_secret` + +@@ -139,11 +151,11 @@ to get an Access Token. + +   + +- - **grant\_type** – MUST be set to `authorization_code`{.docutils ++ - **grant\_type** – MUST be set to `authorization_code`{.docutils + .literal} +- - **code** – The authorization code received from the user’s ++ - **code** – The authorization code received from the user’s + redirect request. +- - **redirect\_uri** – The same `redirect_uri` ++ - **redirect\_uri** – The same `redirect_uri` + used in the authentication request. + + **Example Request** +@@ -180,7 +192,7 @@ to get an Access Token. + In the case of an error, there will be a non-200 HTTP Status and and + data detailing the error. + +-### Refresh a Token ++### [3.3 Refresh a Token](#id7) + + Once the Access Token expires you can use your `refresh_token`{.docutils + .literal} to have docker.io issue your application a new Access Token, +@@ -195,7 +207,7 @@ if the user has not revoked access from your application. + +   + +- - **Authorization** – HTTP basic authentication using your ++ - **Authorization** – HTTP basic authentication using your + application’s `client_id` and + `client_secret` + +@@ -203,11 +215,11 @@ if the user has not revoked access from your application. + +   + +- - **grant\_type** – MUST be set to `refresh_token`{.docutils ++ - **grant\_type** – MUST be set to `refresh_token`{.docutils + .literal} +- - **refresh\_token** – The `refresh_token` ++ - **refresh\_token** – The `refresh_token` + which was issued to your application. +- - **scope** – (optional) The scope of the access token to be ++ - **scope** – (optional) The scope of the access token to be + returned. Must not include any scope not originally granted by + the user and if omitted is treated as equal to the scope + originally granted. +@@ -245,7 +257,7 @@ if the user has not revoked access from your application. + In the case of an error, there will be a non-200 HTTP Status and and + data detailing the error. + +-## Use an Access Token with the API ++## [4. Use an Access Token with the API](#id8) + + Many of the docker.io API requests will require a Authorization request + header field. Simply ensure you add this header with “Bearer +diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md +index 35dd858..8a2e456 100644 +--- a/docs/sources/reference/api/docker_remote_api.md ++++ b/docs/sources/reference/api/docker_remote_api.md +@@ -4,21 +4,21 @@ page_keywords: API, Docker, rcli, REST, documentation + + # Docker Remote API + +-## Introduction +- +-- The Remote API is replacing rcli +-- By default the Docker daemon listens on unix:///var/run/docker.sock +- and the client must have root access to interact with the daemon +-- If a group named *docker* exists on your system, docker will apply +- ownership of the socket to the group +-- The API tends to be REST, but for some complex commands, like attach +- or pull, the HTTP connection is hijacked to transport stdout stdin +- and stderr +-- Since API version 1.2, the auth configuration is now handled client +- side, so the client has to send the authConfig as POST in +- `/images/(name)/push`. +- +-## Docker Remote API Versions ++## 1. Brief introduction ++ ++- The Remote API is replacing rcli ++- By default the Docker daemon listens on unix:///var/run/docker.sock ++ and the client must have root access to interact with the daemon ++- If a group named *docker* exists on your system, docker will apply ++ ownership of the socket to the group ++- The API tends to be REST, but for some complex commands, like attach ++ or pull, the HTTP connection is hijacked to transport stdout stdin ++ and stderr ++- Since API version 1.2, the auth configuration is now handled client ++ side, so the client has to send the authConfig as POST in ++ /images/(name)/push ++ ++## 2. Versions + + The current version of the API is 1.10 + +@@ -28,25 +28,31 @@ Calling /images/\/insert is the same as calling + You can still call an old version of the api using + /v1.0/images/\/insert + +-## Docker Remote API v1.10 ++### v1.10 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.10*](../docker_remote_api_v1.10/) + +-### What’s new ++#### What’s new + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : **New!** You can now use the force parameter to force delete of an +- image, even if it’s tagged in multiple repositories. ++ image, even if it’s tagged in multiple repositories. **New!** You ++ can now use the noprune parameter to prevent the deletion of parent ++ images + +-## Docker Remote API v1.9 ++ `DELETE `{.descname}`/containers/`{.descname}(*id*) ++: **New!** You can now use the force paramter to force delete a ++ container, even if it is currently running + +-### Full Documentation ++### v1.9 ++ ++#### Full Documentation + + [*Docker Remote API v1.9*](../docker_remote_api_v1.9/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/build`{.descname} + : **New!** This endpoint now takes a serialized ConfigFile which it +@@ -54,13 +60,13 @@ You can still call an old version of the api using + base image. Clients which previously implemented the version + accepting an AuthConfig object must be updated. + +-## Docker Remote API v1.8 ++### v1.8 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.8*](../docker_remote_api_v1.8/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/build`{.descname} + : **New!** This endpoint now returns build status as json stream. In +@@ -82,13 +88,13 @@ You can still call an old version of the api using + possible to get the current value and the total of the progress + without having to parse the string. + +-## Docker Remote API v1.7 ++### v1.7 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.7*](../docker_remote_api_v1.7/) + +-### What’s New ++#### What’s new + + `GET `{.descname}`/images/json`{.descname} + : The format of the json returned from this uri changed. Instead of an +@@ -175,17 +181,17 @@ You can still call an old version of the api using + ] + + `GET `{.descname}`/images/viz`{.descname} +-: This URI no longer exists. The `images -viz` ++: This URI no longer exists. The `images --viz` + output is now generated in the client, using the + `/images/json` data. + +-## Docker Remote API v1.6 ++### v1.6 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.6*](../docker_remote_api_v1.6/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : **New!** You can now split stderr from stdout. This is done by +@@ -195,13 +201,13 @@ You can still call an old version of the api using + The WebSocket attach is unchanged. Note that attach calls on the + previous API version didn’t change. Stdout and stderr are merged. + +-## Docker Remote API v1.5 ++### v1.5 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.5*](../docker_remote_api_v1.5/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/images/create`{.descname} + : **New!** You can now pass registry credentials (via an AuthConfig +@@ -216,13 +222,13 @@ You can still call an old version of the api using + dicts each containing PublicPort, PrivatePort and Type describing a + port mapping. + +-## Docker Remote API v1.4 ++### v1.4 + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.4*](../docker_remote_api_v1.4/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/images/create`{.descname} + : **New!** When pulling a repo, all images are now downloaded in +@@ -235,16 +241,16 @@ You can still call an old version of the api using + `GET `{.descname}`/events:`{.descname} + : **New!** Image’s name added in the events + +-## Docker Remote API v1.3 ++### v1.3 + + docker v0.5.0 + [51f6c4a](https://github.com/dotcloud/docker/commit/51f6c4a7372450d164c61e0054daf0223ddbd909) + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.3*](../docker_remote_api_v1.3/) + +-### What’s New ++#### What’s new + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List the processes running inside a container. +@@ -254,10 +260,10 @@ docker v0.5.0 + + Builder (/build): + +-- Simplify the upload of the build context +-- Simply stream a tarball instead of multipart upload with 4 +- intermediary buffers +-- Simpler, less memory usage, less disk usage and faster ++- Simplify the upload of the build context ++- Simply stream a tarball instead of multipart upload with 4 ++ intermediary buffers ++- Simpler, less memory usage, less disk usage and faster + + Warning + +@@ -266,23 +272,23 @@ break on /build. + + List containers (/containers/json): + +-- You can use size=1 to get the size of the containers ++- You can use size=1 to get the size of the containers + + Start containers (/containers/\/start): + +-- You can now pass host-specific configuration (e.g. bind mounts) in +- the POST body for start calls ++- You can now pass host-specific configuration (e.g. bind mounts) in ++ the POST body for start calls + +-## Docker Remote API v1.2 ++### v1.2 + + docker v0.4.2 + [2e7649b](https://github.com/dotcloud/docker/commit/2e7649beda7c820793bd46766cbc2cfeace7b168) + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.2*](../docker_remote_api_v1.2/) + +-### What’s New ++#### What’s new + + The auth configuration is now handled by the client. + +@@ -302,16 +308,16 @@ The client should send it’s authConfig as POST on each call of + : Now returns a JSON structure with the list of images + deleted/untagged. + +-## Docker Remote API v1.1 ++### v1.1 + + docker v0.4.0 + [a8ae398](https://github.com/dotcloud/docker/commit/a8ae398bf52e97148ee7bd0d5868de2e15bd297f) + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.1*](../docker_remote_api_v1.1/) + +-### What’s New ++#### What’s new + + `POST `{.descname}`/images/create`{.descname} + : +@@ -330,15 +336,15 @@ docker v0.4.0 + > {"error":"Invalid..."} + > ... + +-## Docker Remote API v1.0 ++### v1.0 + + docker v0.3.4 + [8d73740](https://github.com/dotcloud/docker/commit/8d73740343778651c09160cde9661f5f387b36f4) + +-### Full Documentation ++#### Full Documentation + + [*Docker Remote API v1.0*](../docker_remote_api_v1.0/) + +-### What’s New ++#### What’s new + + Initial version +diff --git a/docs/sources/reference/api/docker_remote_api_v1.0.md b/docs/sources/reference/api/docker_remote_api_v1.0.md +index 6bb0fcb..30b1718 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.0.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.0.md +@@ -2,21 +2,70 @@ page_title: Remote API v1.0 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.0 +- +-## Introduction +- +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++# [Docker Remote API v1.0](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.0](#docker-remote-api-v1-0) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Get default username and ++ email](#get-default-username-and-email) ++ - [Check auth configuration and store ++ it](#check-auth-configuration-and-store-it) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -65,22 +114,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -126,16 +175,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -198,11 +247,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem:] ++#### [Inspect changes on a container’s filesystem](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -233,11 +282,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -255,11 +304,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id10) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -274,11 +323,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -295,15 +344,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -320,15 +369,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -343,11 +392,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -367,25 +416,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -404,11 +453,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id16) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -425,19 +474,19 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id17) + +-### List images: ++#### [List Images](#id18) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -498,16 +547,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id19) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -528,18 +577,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id20) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -557,10 +606,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id21) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -603,11 +652,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id22) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -636,11 +685,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id23) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -660,15 +709,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id24) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -685,17 +734,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id25) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -710,11 +759,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such image +- - **500** – server error ++ - **204** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Search images: ++#### [Search images](#id26) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -747,9 +796,9 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id27) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id28) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -770,15 +819,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name to be applied to the resulting image in ++ - **t** – repository name to be applied to the resulting image in + case of success + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-#### [Get default username and email ++#### [Get default username and email](#id29) + + `GET `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -799,10 +848,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: and store it ++#### [Check auth configuration and store it](#id30) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -824,11 +873,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id31) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -854,10 +903,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id32) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -879,10 +928,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id33) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -908,41 +957,41 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id34) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id35) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id36) + + In this first version of the API, some of the endpoints, like /attach, + /pull or /push uses hijacking to transport stdin, stdout and stderr on +diff --git a/docs/sources/reference/api/docker_remote_api_v1.1.md b/docs/sources/reference/api/docker_remote_api_v1.1.md +index 476b942..2d510f4 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.1.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.1.md +@@ -2,21 +2,70 @@ page_title: Remote API v1.1 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.1 +- +-## Introduction +- +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++# [Docker Remote API v1.1](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.1](#docker-remote-api-v1-1) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Get default username and ++ email](#get-default-username-and-email) ++ - [Check auth configuration and store ++ it](#check-auth-configuration-and-store-it) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -65,22 +114,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -126,16 +175,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -198,11 +247,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem:] ++#### [Inspect changes on a container’s filesystem](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -233,11 +282,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -255,11 +304,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id10) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -274,11 +323,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -295,15 +344,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -320,15 +369,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -343,11 +392,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -367,25 +416,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -404,11 +453,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id16) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -425,19 +474,19 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id17) + +-### List images: ++#### [List Images](#id18) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -498,16 +547,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id19) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -531,18 +580,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id20) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -564,10 +613,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id21) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -610,11 +659,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id22) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -643,11 +692,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id23) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -670,15 +719,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id24) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -695,18 +744,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id25) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -721,11 +770,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such image +- - **500** – server error ++ - **204** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Search images: ++#### [Search images](#id26) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -758,9 +807,9 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id27) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id28) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -781,15 +830,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – tag to be applied to the resulting image in case of ++ - **t** – tag to be applied to the resulting image in case of + success + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-#### [Get default username and email ++#### [Get default username and email](#id29) + + `GET `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -810,10 +859,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: and store it ++#### [Check auth configuration and store it](#id30) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -835,11 +884,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id31) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -865,10 +914,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id32) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -890,10 +939,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id33) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -919,41 +968,41 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id34) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id35) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id36) + + In this version of the API, /attach uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. +diff --git a/docs/sources/reference/api/docker_remote_api_v1.10.md b/docs/sources/reference/api/docker_remote_api_v1.10.md +index b6aa5bc..2a99f72 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.10.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.10.md +@@ -2,24 +2,80 @@ page_title: Remote API v1.10 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.10 +- +-## Introduction +- +-- The Remote API has replaced rcli +-- The daemon listens on `unix:///var/run/docker.sock`{.docutils ++# [Docker Remote API v1.10](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.10](#docker-remote-api-v1-10) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [Get a tarball containing all images and tags in a ++ repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) ++ - [Load a tarball with a set of images and tags into ++ docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API has replaced rcli ++- The daemon listens on `unix:///var/run/docker.sock`{.docutils + .literal}, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../use/basics/#bind-docker). +-- The API tends to be REST, but for some complex commands, like ++- The API tends to be REST, but for some complex commands, like + `attach` or `pull`{.docutils .literal}, the HTTP + connection is hijacked to transport `stdout, stdin`{.docutils + .literal} and `stderr` + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -80,24 +136,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -130,6 +186,7 @@ page_keywords: API, Docker, rcli, REST, documentation + }, + "VolumesFrom":"", + "WorkingDir":"", ++ "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } +@@ -149,23 +206,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Query Parameters: + +   + +- - **name** – Assign the specified name to the container. Must ++ - **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -246,11 +303,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -288,15 +345,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -327,11 +384,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -349,11 +406,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -380,15 +437,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -405,15 +462,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -430,15 +487,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -453,11 +510,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -477,23 +534,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + + **Stream details**: + +@@ -518,9 +575,9 @@ page_keywords: API, Docker, rcli, REST, documentation + + `STREAM_TYPE` can be: + +- - 0: stdin (will be writen on stdout) +- - 1: stdout +- - 2: stderr ++ - 0: stdin (will be writen on stdout) ++ - 1: stdout ++ - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. +@@ -539,7 +596,7 @@ page_keywords: API, Docker, rcli, REST, documentation + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -558,11 +615,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -579,17 +636,19 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false ++ - **force** – 1/True/true or 0/False/false, Removes the container ++ even if it was running. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -612,13 +671,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/json`{.descname} + : **Example request**: +@@ -655,7 +714,7 @@ page_keywords: API, Docker, rcli, REST, documentation + } + ] + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -683,24 +742,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Request Headers: + +   + +- - **X-Registry-Auth** – base64-encoded AuthConfig object ++ - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -722,10 +781,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -770,11 +829,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -803,11 +862,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -830,22 +889,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Request Headers: + +   + +- - **X-Registry-Auth** – include a base64-encoded AuthConfig ++ - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -862,18 +921,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -897,16 +956,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **force** – 1/True/true or 0/False/false, default false ++ - **force** – 1/True/true or 0/False/false, default false ++ - **noprune** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index. +@@ -954,16 +1014,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **term** – term to search ++ - **term** – term to search + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -995,25 +1055,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image + + Request Headers: + +   + +- - **Content-type** – should be set to ++ - **Content-type** – should be set to + `"application/tar"`. +- - **X-Registry-Config** – base64-encoded ConfigFile object ++ - **X-Registry-Config** – base64-encoded ConfigFile object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -1036,11 +1096,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -1067,10 +1127,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1092,10 +1152,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1115,22 +1175,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[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”]}) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1154,14 +1214,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Get a tarball containing all images and tags in a repository: ++#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET `{.descname}`/images/`{.descname}(*name*)`/get`{.descname} + : Get a tarball containing all images and metadata for the repository +@@ -1180,10 +1240,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Load a tarball with a set of images and tags into docker: ++#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST `{.descname}`/images/load`{.descname} + : Load a set of images and tags into the docker repository. +@@ -1200,38 +1260,38 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id38) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id39) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id40) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id41) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.2.md b/docs/sources/reference/api/docker_remote_api_v1.2.md +index 5a70c94..b11bce6 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.2.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.2.md +@@ -2,21 +2,68 @@ page_title: Remote API v1.2 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.2 +- +-## Introduction +- +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++# [Docker Remote API v1.2](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.2](#docker-remote-api-v1-2) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -77,22 +124,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -138,16 +185,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -210,11 +257,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem:] ++#### [Inspect changes on a container’s filesystem](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -245,11 +292,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -267,11 +314,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id10) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -286,11 +333,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -307,15 +354,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -332,15 +379,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -355,11 +402,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -379,25 +426,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -416,11 +463,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id16) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -437,19 +484,19 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id17) + +-### List images: ++#### [List Images](#id18) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -514,16 +561,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id19) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -547,18 +594,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id20) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -580,10 +627,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id21) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -627,11 +674,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id22) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -661,11 +708,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id23) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -689,15 +736,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id24) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -714,18 +761,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id25) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -747,12 +794,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **204** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id26) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -785,9 +832,9 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id27) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id28) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile +@@ -808,19 +855,19 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name to be applied to the resulting image in ++ - **t** – repository name to be applied to the resulting image in + case of success +- - **remote** – resource to fetch, as URI ++ - **remote** – resource to fetch, as URI + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + + {{ STREAM }} is the raw text output of the build command. It uses the + HTTP Hijack method in order to stream. + +-### Check auth configuration: ++#### [Check auth configuration](#id29) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -847,13 +894,13 @@ HTTP Hijack method in order to stream. + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **401** – unauthorized +- - **403** – forbidden +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **401** – unauthorized ++ - **403** – forbidden ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id30) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -879,10 +926,10 @@ HTTP Hijack method in order to stream. + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id31) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -904,10 +951,10 @@ HTTP Hijack method in order to stream. + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id32) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -933,49 +980,49 @@ HTTP Hijack method in order to stream. + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id33) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id34) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id35) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id36) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + + > docker -d -H=”[tcp://192.168.1.9:4243](tcp://192.168.1.9:4243)” +-> -api-enable-cors ++> –api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.3.md b/docs/sources/reference/api/docker_remote_api_v1.3.md +index 7e0e6bd..4203699 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.3.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.3.md +@@ -2,74 +2,71 @@ page_title: Remote API v1.3 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.3 ++# [Docker Remote API v1.3](#id1) + + Table of Contents + +-- [Docker Remote API v1.3](#docker-remote-api-v1-3) +- - [1. Brief introduction](#brief-introduction) +- - [2. Endpoints](#endpoints) +- - [2.1 Containers](#containers) +- - [List containers](#list-containers) +- - [Create a container](#create-a-container) +- - [Inspect a container](#inspect-a-container) +- - [List processes running inside a ++- [Docker Remote API v1.3](#docker-remote-api-v1-3) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a + container](#list-processes-running-inside-a-container) +- - [Inspect changes on a container’s ++ - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) +- - [Export a container](#export-a-container) +- - [Start a container](#start-a-container) +- - [Stop a container](#stop-a-container) +- - [Restart a container](#restart-a-container) +- - [Kill a container](#kill-a-container) +- - [Attach to a container](#attach-to-a-container) +- - [Wait a container](#wait-a-container) +- - [Remove a container](#remove-a-container) +- +- - [2.2 Images](#images) +- - [List Images](#list-images) +- - [Create an image](#create-an-image) +- - [Insert a file in an image](#insert-a-file-in-an-image) +- - [Inspect an image](#inspect-an-image) +- - [Get the history of an ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an + image](#get-the-history-of-an-image) +- - [Push an image on the ++ - [Push an image on the + registry](#push-an-image-on-the-registry) +- - [Tag an image into a ++ - [Tag an image into a + repository](#tag-an-image-into-a-repository) +- - [Remove an image](#remove-an-image) +- - [Search images](#search-images) +- +- - [2.3 Misc](#misc) +- - [Build an image from Dockerfile via ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) +- - [Check auth configuration](#check-auth-configuration) +- - [Display system-wide ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide + information](#display-system-wide-information) +- - [Show the docker version ++ - [Show the docker version + information](#show-the-docker-version-information) +- - [Create a new image from a container’s ++ - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) +- - [Monitor Docker’s events](#monitor-docker-s-events) +- +- - [3. Going further](#going-further) +- - [3.1 Inside ‘docker run’](#inside-docker-run) +- - [3.2 Hijacking](#hijacking) +- - [3.3 CORS Requests](#cors-requests) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) + +-## Introduction ++## [1. Brief introduction](#id2) + +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -130,24 +127,24 @@ Table of Contents + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -193,16 +190,16 @@ Table of Contents + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -265,11 +262,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -300,11 +297,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -335,11 +332,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -357,11 +354,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -384,15 +381,15 @@ Table of Contents + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -409,15 +406,15 @@ Table of Contents + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -434,15 +431,15 @@ Table of Contents + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -457,11 +454,11 @@ Table of Contents + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -481,25 +478,25 @@ Table of Contents + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -518,11 +515,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -539,19 +536,19 @@ Table of Contents + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id18) + +-### List images: ++#### [List Images](#id19) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -616,16 +613,16 @@ Table of Contents + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id20) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -649,18 +646,18 @@ Table of Contents + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id21) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -682,10 +679,10 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id22) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -729,11 +726,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -762,11 +759,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id24) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -790,15 +787,15 @@ Table of Contents + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -815,18 +812,18 @@ Table of Contents + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id26) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -848,12 +845,12 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id27) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -886,9 +883,9 @@ Table of Contents + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id28) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id29) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -917,16 +914,16 @@ Table of Contents + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output ++ - **q** – suppress verbose build output + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id30) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -948,11 +945,11 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id31) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -981,10 +978,10 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id32) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1006,10 +1003,10 @@ Table of Contents + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id33) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1035,20 +1032,20 @@ Table of Contents + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id34) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1072,42 +1069,42 @@ Table of Contents + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id35) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id36) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id37) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id38) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +-> docker -d -H=”192.168.1.9:4243” -api-enable-cors ++> docker -d -H=”192.168.1.9:4243” –api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.4.md b/docs/sources/reference/api/docker_remote_api_v1.4.md +index f665b1e..4eca2a6 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.4.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.4.md +@@ -2,21 +2,73 @@ page_title: Remote API v1.4 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.4 +- +-## Introduction +- +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++# [Docker Remote API v1.4](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.4](#docker-remote-api-v1-4) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -77,24 +129,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -143,16 +195,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -217,12 +269,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **409** – conflict between containers and images +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **409** – conflict between containers and images ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -260,15 +312,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -299,11 +351,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -321,11 +373,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -349,15 +401,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -374,15 +426,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -399,15 +451,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -422,11 +474,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -446,25 +498,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -483,11 +535,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -504,17 +556,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -537,13 +589,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -608,16 +660,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -641,18 +693,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -674,10 +726,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -722,12 +774,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict between containers and images +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict between containers and images ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -756,11 +808,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -782,14 +834,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error :statuscode 404: no such image :statuscode ++ - **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -806,18 +858,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -839,12 +891,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -877,9 +929,9 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -908,17 +960,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -941,11 +993,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -972,10 +1024,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -997,10 +1049,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1026,20 +1078,20 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1063,42 +1115,42 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id36) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id37) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id38) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id39) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.5.md b/docs/sources/reference/api/docker_remote_api_v1.5.md +index d9c3542..ff11cd1 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.5.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.5.md +@@ -2,21 +2,73 @@ page_title: Remote API v1.5 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.5 +- +-## Introduction +- +-- The Remote API is replacing rcli +-- Default port in the docker daemon is 4243 +-- The API tends to be REST, but for some complex commands, like attach ++# [Docker Remote API v1.5](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.5](#docker-remote-api-v1-5) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API is replacing rcli ++- Default port in the docker daemon is 4243 ++- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -77,24 +129,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -142,16 +194,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -215,11 +267,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -257,15 +309,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -296,11 +348,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -318,11 +370,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -346,15 +398,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -371,15 +423,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -396,15 +448,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -419,11 +471,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -443,25 +495,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -480,11 +532,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -501,17 +553,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -534,13 +586,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -605,16 +657,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -642,18 +694,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -675,10 +727,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -723,11 +775,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -756,11 +808,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -786,15 +838,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -811,18 +863,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -844,12 +896,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -882,16 +934,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **term** – term to search ++ - **term** – term to search + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -920,18 +972,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image +- - **rm** – remove intermediate containers after a successful build ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image ++ - **rm** – remove intermediate containers after a successful build + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -954,11 +1006,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -985,10 +1037,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1010,10 +1062,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1039,20 +1091,20 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1076,37 +1128,37 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id36) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id37) + + Here are the steps of ‘docker run’ : + +-- Create the container +-- If the status code is 404, it means the image doesn’t exists: \* Try ++- Create the container ++- If the status code is 404, it means the image doesn’t exists: \* Try + to pull it \* Then retry to create the container +-- Start the container +-- If you are not in detached mode: \* Attach to the container, using ++- Start the container ++- If you are not in detached mode: \* Attach to the container, using + logs=1 (to have stdout and stderr from the container’s start) and + stream=1 +-- If in detached mode or only stdin is attached: \* Display the ++- If in detached mode or only stdin is attached: \* Display the + container’s id + +-### Hijacking ++### [3.2 Hijacking](#id38) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id39) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.6.md b/docs/sources/reference/api/docker_remote_api_v1.6.md +index 4455608..fd6a650 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.6.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.6.md +@@ -2,24 +2,76 @@ page_title: Remote API v1.6 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.6 +- +-## Introduction +- +-- The Remote API has replaced rcli +-- The daemon listens on `unix:///var/run/docker.sock`{.docutils ++# [Docker Remote API v1.6](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.6](#docker-remote-api-v1-6) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API has replaced rcli ++- The daemon listens on `unix:///var/run/docker.sock`{.docutils + .literal}, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../use/basics/#bind-docker). +-- The API tends to be REST, but for some complex commands, like ++- The API tends to be REST, but for some complex commands, like + `attach` or `pull`{.docutils .literal}, the HTTP + connection is hijacked to transport `stdout, stdin`{.docutils + .literal} and `stderr` + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -80,24 +132,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -144,20 +196,20 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Query Parameters: + +   + +- - **name** – container name to use ++ - **name** – container name to use + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + + **More Complex Example request, in 2 steps.** **First, use create to + expose a Private Port, which can be bound back to a Public Port at +@@ -202,7 +254,7 @@ page_keywords: API, Docker, rcli, REST, documentation + + **Now you can ssh into your new container on port 11022.** + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -267,11 +319,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -309,15 +361,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -348,11 +400,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -370,11 +422,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -403,15 +455,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -428,15 +480,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -453,15 +505,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -478,17 +530,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **signal** – Signal to send to the container (integer). When not ++ - **signal** – Signal to send to the container (integer). When not + set, SIGKILL is assumed and the call will waits for the + container to exit. + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -508,23 +560,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + + **Stream details**: + +@@ -549,9 +601,9 @@ page_keywords: API, Docker, rcli, REST, documentation + + `STREAM_TYPE` can be: + +- - 0: stdin (will be writen on stdout) +- - 1: stdout +- - 2: stderr ++ - 0: stdin (will be writen on stdout) ++ - 1: stdout ++ - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. +@@ -570,7 +622,7 @@ page_keywords: API, Docker, rcli, REST, documentation + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -589,11 +641,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -610,17 +662,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -643,13 +695,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/`{.descname}(*format*) + : List images `format` could be json or viz (json +@@ -714,16 +766,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -751,18 +803,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -784,10 +836,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -832,11 +884,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -865,11 +917,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -893,14 +945,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Status Codes: + +- - **200** – no error :statuscode 404: no such image :statuscode ++ - **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -917,18 +969,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -950,12 +1002,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index +@@ -988,9 +1040,9 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -1019,17 +1071,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -1052,11 +1104,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -1083,10 +1135,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1108,10 +1160,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1137,20 +1189,20 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1174,42 +1226,42 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id36) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id37) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id38) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id39) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.7.md b/docs/sources/reference/api/docker_remote_api_v1.7.md +index 1d1bd27..0c8c962 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.7.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.7.md +@@ -2,24 +2,80 @@ page_title: Remote API v1.7 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.7 +- +-## Introduction +- +-- The Remote API has replaced rcli +-- The daemon listens on `unix:///var/run/docker.sock`{.docutils ++# [Docker Remote API v1.7](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.7](#docker-remote-api-v1-7) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [Get a tarball containing all images and tags in a ++ repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) ++ - [Load a tarball with a set of images and tags into ++ docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API has replaced rcli ++- The daemon listens on `unix:///var/run/docker.sock`{.docutils + .literal}, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../use/basics/#bind-docker). +-- The API tends to be REST, but for some complex commands, like ++- The API tends to be REST, but for some complex commands, like + `attach` or `pull`{.docutils .literal}, the HTTP + connection is hijacked to transport `stdout, stdin`{.docutils + .literal} and `stderr` + +-## Endpoints ++## [2. Endpoints](#id3) + +-### Containers ++### [2.1 Containers](#id4) + +-### List containers: ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -80,24 +136,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -149,16 +205,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **config** – the container’s configuration ++ - **config** – the container’s configuration + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -223,11 +279,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -265,15 +321,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -304,11 +360,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -326,11 +382,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -360,15 +416,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **hostConfig** – the container’s host configuration (optional) ++ - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -385,15 +441,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -410,15 +466,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -433,11 +489,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -457,23 +513,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + + **Stream details**: + +@@ -498,9 +554,9 @@ page_keywords: API, Docker, rcli, REST, documentation + + `STREAM_TYPE` can be: + +- - 0: stdin (will be writen on stdout) +- - 1: stdout +- - 2: stderr ++ - 0: stdin (will be writen on stdout) ++ - 1: stdout ++ - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. +@@ -519,7 +575,7 @@ page_keywords: API, Docker, rcli, REST, documentation + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -538,11 +594,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -559,17 +615,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -592,13 +648,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/json`{.descname} + : **Example request**: +@@ -635,7 +691,7 @@ page_keywords: API, Docker, rcli, REST, documentation + } + ] + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -663,24 +719,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Request Headers: + +   + +- - **X-Registry-Auth** – base64-encoded AuthConfig object ++ - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -702,10 +758,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -750,11 +806,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -783,11 +839,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -810,22 +866,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Request Headers: + +   + +- - **X-Registry-Auth** – include a base64-encoded AuthConfig ++ - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -842,18 +898,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -875,12 +931,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index. +@@ -928,16 +984,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **term** – term to search ++ - **term** – term to search + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -967,24 +1023,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image + + Request Headers: + +   + +- - **Content-type** – should be set to ++ - **Content-type** – should be set to + `"application/tar"`. + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -1007,11 +1063,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -1038,10 +1094,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1063,10 +1119,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1086,22 +1142,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[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”]}) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1125,14 +1181,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Get a tarball containing all images and tags in a repository: ++#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET `{.descname}`/images/`{.descname}(*name*)`/get`{.descname} + : Get a tarball containing all images and metadata for the repository +@@ -1153,7 +1209,7 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-### Load a tarball with a set of images and tags into docker: ++#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST `{.descname}`/images/load`{.descname} + : Load a set of images and tags into the docker repository. +@@ -1173,35 +1229,35 @@ page_keywords: API, Docker, rcli, REST, documentation + :statuscode 200: no error + :statuscode 500: server error + +-## Going Further ++## [3. Going further](#id38) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id39) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id40) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id41) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.8.md b/docs/sources/reference/api/docker_remote_api_v1.8.md +index 49c8fb6..115cabc 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.8.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.8.md +@@ -2,24 +2,80 @@ page_title: Remote API v1.8 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.8 +- +-## Introduction +- +-- The Remote API has replaced rcli +-- The daemon listens on `unix:///var/run/docker.sock`{.docutils +- .literal}, but you can [*Bind Docker to another host/port or a Unix +- socket*](../../../use/basics/#bind-docker). +-- The API tends to be REST, but for some complex commands, like +- `attach` or `pull`{.docutils .literal}, the HTTP +- connection is hijacked to transport `stdout, stdin`{.docutils +- .literal} and `stderr` +- +-## Endpoints +- +-### Containers +- +-### List containers: ++# [Docker Remote API v1.8](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.8](#docker-remote-api-v1-8) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from Dockerfile via ++ stdin](#build-an-image-from-dockerfile-via-stdin) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [Get a tarball containing all images and tags in a ++ repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) ++ - [Load a tarball with a set of images and tags into ++ docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API has replaced rcli ++- The daemon listens on `unix:///var/run/docker.sock`{.docutils ++ .literal}, but you can [*Bind Docker to another host/port or a Unix ++ socket*](../../../use/basics/#bind-docker). ++- The API tends to be REST, but for some complex commands, like ++ `attach` or `pull`{.docutils .literal}, the HTTP ++ connection is hijacked to transport `stdout, stdin`{.docutils ++ .literal} and `stderr` ++ ++## [2. Endpoints](#id3) ++ ++### [2.1 Containers](#id4) ++ ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -80,24 +136,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -150,36 +206,36 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **Hostname** – Container host name +- - **User** – Username or UID +- - **Memory** – Memory Limit in bytes +- - **CpuShares** – CPU shares (relative weight +- - **AttachStdin** – 1/True/true or 0/False/false, attach to ++ - **Hostname** – Container host name ++ - **User** – Username or UID ++ - **Memory** – Memory Limit in bytes ++ - **CpuShares** – CPU shares (relative weight) ++ - **AttachStdin** – 1/True/true or 0/False/false, attach to + standard input. Default false +- - **AttachStdout** – 1/True/true or 0/False/false, attach to ++ - **AttachStdout** – 1/True/true or 0/False/false, attach to + standard output. Default false +- - **AttachStderr** – 1/True/true or 0/False/false, attach to ++ - **AttachStderr** – 1/True/true or 0/False/false, attach to + standard error. Default false +- - **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. ++ - **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. + Default false +- - **OpenStdin** – 1/True/true or 0/False/false, keep stdin open ++ - **OpenStdin** – 1/True/true or 0/False/false, keep stdin open + even if not attached. Default false + + Query Parameters: + +   + +- - **name** – Assign the specified name to the container. Must ++ - **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -260,11 +316,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -302,15 +358,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -341,11 +397,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Export a container: ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -363,11 +419,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Start a container: ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -394,24 +450,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **Binds** – Create a bind mount to a directory or file with ++ - **Binds** – Create a bind mount to a directory or file with + [host-path]:[container-path]:[rw|ro]. If a directory + “container-path” is missing, then docker creates a new volume. +- - **LxcConf** – Map of custom lxc options +- - **PortBindings** – Expose ports from the container, optionally ++ - **LxcConf** – Map of custom lxc options ++ - **PortBindings** – Expose ports from the container, optionally + publishing them via the HostPort flag +- - **PublishAllPorts** – 1/True/true or 0/False/false, publish all ++ - **PublishAllPorts** – 1/True/true or 0/False/false, publish all + exposed ports to the host interfaces. Default false +- - **Privileged** – 1/True/true or 0/False/false, give extended ++ - **Privileged** – 1/True/true or 0/False/false, give extended + privileges to this container. Default false + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Stop a container: ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -428,15 +484,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Restart a container: ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -453,15 +509,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Kill a container: ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -476,11 +532,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Attach to a container: ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -500,23 +556,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + + **Stream details**: + +@@ -541,9 +597,9 @@ page_keywords: API, Docker, rcli, REST, documentation + + `STREAM_TYPE` can be: + +- - 0: stdin (will be writen on stdout +- - 1: stdout +- - 2: stderr ++ - 0: stdin (will be writen on stdout) ++ - 1: stdout ++ - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. +@@ -560,9 +616,9 @@ page_keywords: API, Docker, rcli, REST, documentation + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 byets + 4. Read the extracted size and output it on the correct output +- 5. Goto 1 ++ 5. Goto 1) + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -581,13 +637,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + +- `DELETE `{.descname}`/containers/`{.descname}(*id* ++ `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem + + **Example request**: +@@ -602,17 +658,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -635,13 +691,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Images ++### [2.2 Images](#id19) + +-### List Images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/json`{.descname} + : **Example request**: +@@ -678,7 +734,7 @@ page_keywords: API, Docker, rcli, REST, documentation + } + ] + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -706,24 +762,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Request Headers: + +   + +- - **X-Registry-Auth** – base64-encoded AuthConfig object ++ - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Insert a file in an image: ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -745,10 +801,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -793,11 +849,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -826,11 +882,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Push an image on the registry: ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -853,22 +909,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Request Headers: + +   + +- - **X-Registry-Auth** – include a base64-encoded AuthConfig ++ - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -885,20 +941,20 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + +- `DELETE `{.descname}`/images/`{.descname}(*name* ++ `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem + + **Example request**: +@@ -918,12 +974,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index. +@@ -971,16 +1027,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **term** – term to search ++ - **term** – term to search + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile via stdin: ++#### [Build an image from Dockerfile via stdin](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile via stdin +@@ -1012,25 +1068,25 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image + + Request Headers: + +   + +- - **Content-type** – should be set to ++ - **Content-type** – should be set to + `"application/tar"`. +- - **X-Registry-Auth** – base64-encoded AuthConfig object ++ - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -1053,11 +1109,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -1084,10 +1140,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1109,10 +1165,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1132,26 +1188,26 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith +- \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>” +- - **run** – config automatically applied when the image is run. +- (ex: {“Cmd”: [“cat”, “/world”], “PortSpecs”:[“22”]} ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith ++ \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>”) ++ - **run** – config automatically applied when the image is run. ++ (ex: {“Cmd”: [“cat”, “/world”], “PortSpecs”:[“22”]}) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +- polling (using since ++ polling (using since) + + **Example request**: + +@@ -1171,14 +1227,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Get a tarball containing all images and tags in a repository: ++#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET `{.descname}`/images/`{.descname}(*name*)`/get`{.descname} + : Get a tarball containing all images and metadata for the repository +@@ -1197,10 +1253,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Load a tarball with a set of images and tags into docker: ++#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST `{.descname}`/images/load`{.descname} + : Load a set of images and tags into the docker repository. +@@ -1217,38 +1273,38 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id38) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id39) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id40) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id41) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/docker_remote_api_v1.9.md b/docs/sources/reference/api/docker_remote_api_v1.9.md +index 658835c..c25f837 100644 +--- a/docs/sources/reference/api/docker_remote_api_v1.9.md ++++ b/docs/sources/reference/api/docker_remote_api_v1.9.md +@@ -2,24 +2,80 @@ page_title: Remote API v1.9 + page_description: API Documentation for Docker + page_keywords: API, Docker, rcli, REST, documentation + +-# Docker Remote API v1.9 +- +-## Introduction +- +-- The Remote API has replaced rcli +-- The daemon listens on `unix:///var/run/docker.sock`{.docutils +- .literal}, but you can [*Bind Docker to another host/port or a Unix +- socket*](../../../use/basics/#bind-docker). +-- The API tends to be REST, but for some complex commands, like +- `attach` or `pull`{.docutils .literal}, the HTTP +- connection is hijacked to transport `stdout, stdin`{.docutils +- .literal} and `stderr` +- +-## Endpoints +- +-## Containers +- +-### List containers: ++# [Docker Remote API v1.9](#id1) ++ ++Table of Contents ++ ++- [Docker Remote API v1.9](#docker-remote-api-v1-9) ++ - [1. Brief introduction](#brief-introduction) ++ - [2. Endpoints](#endpoints) ++ - [2.1 Containers](#containers) ++ - [List containers](#list-containers) ++ - [Create a container](#create-a-container) ++ - [Inspect a container](#inspect-a-container) ++ - [List processes running inside a ++ container](#list-processes-running-inside-a-container) ++ - [Inspect changes on a container’s ++ filesystem](#inspect-changes-on-a-container-s-filesystem) ++ - [Export a container](#export-a-container) ++ - [Start a container](#start-a-container) ++ - [Stop a container](#stop-a-container) ++ - [Restart a container](#restart-a-container) ++ - [Kill a container](#kill-a-container) ++ - [Attach to a container](#attach-to-a-container) ++ - [Wait a container](#wait-a-container) ++ - [Remove a container](#remove-a-container) ++ - [Copy files or folders from a ++ container](#copy-files-or-folders-from-a-container) ++ - [2.2 Images](#images) ++ - [List Images](#list-images) ++ - [Create an image](#create-an-image) ++ - [Insert a file in an image](#insert-a-file-in-an-image) ++ - [Inspect an image](#inspect-an-image) ++ - [Get the history of an ++ image](#get-the-history-of-an-image) ++ - [Push an image on the ++ registry](#push-an-image-on-the-registry) ++ - [Tag an image into a ++ repository](#tag-an-image-into-a-repository) ++ - [Remove an image](#remove-an-image) ++ - [Search images](#search-images) ++ - [2.3 Misc](#misc) ++ - [Build an image from ++ Dockerfile](#build-an-image-from-dockerfile) ++ - [Check auth configuration](#check-auth-configuration) ++ - [Display system-wide ++ information](#display-system-wide-information) ++ - [Show the docker version ++ information](#show-the-docker-version-information) ++ - [Create a new image from a container’s ++ changes](#create-a-new-image-from-a-container-s-changes) ++ - [Monitor Docker’s events](#monitor-docker-s-events) ++ - [Get a tarball containing all images and tags in a ++ repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) ++ - [Load a tarball with a set of images and tags into ++ docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) ++ - [3. Going further](#going-further) ++ - [3.1 Inside ‘docker run’](#inside-docker-run) ++ - [3.2 Hijacking](#hijacking) ++ - [3.3 CORS Requests](#cors-requests) ++ ++## [1. Brief introduction](#id2) ++ ++- The Remote API has replaced rcli ++- The daemon listens on `unix:///var/run/docker.sock`{.docutils ++ .literal}, but you can [*Bind Docker to another host/port or a Unix ++ socket*](../../../use/basics/#bind-docker). ++- The API tends to be REST, but for some complex commands, like ++ `attach` or `pull`{.docutils .literal}, the HTTP ++ connection is hijacked to transport `stdout, stdin`{.docutils ++ .literal} and `stderr` ++ ++## [2. Endpoints](#id3) ++ ++### [2.1 Containers](#id4) ++ ++#### [List containers](#id5) + + `GET `{.descname}`/containers/json`{.descname} + : List containers +@@ -80,24 +136,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **all** – 1/True/true or 0/False/false, Show all containers. ++ - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default +- - **limit** – Show `limit` last created ++ - **limit** – Show `limit` last created + containers, include non-running ones. +- - **since** – Show only containers created since Id, include ++ - **since** – Show only containers created since Id, include + non-running ones. +- - **before** – Show only containers created before Id, include ++ - **before** – Show only containers created before Id, include + non-running ones. +- - **size** – 1/True/true or 0/False/false, Show the containers ++ - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **500** – server error + +-### Create a container: ++#### [Create a container](#id6) + + `POST `{.descname}`/containers/create`{.descname} + : Create a container +@@ -150,36 +206,36 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **Hostname** – Container host name +- - **User** – Username or UID +- - **Memory** – Memory Limit in bytes +- - **CpuShares** – CPU shares (relative weight) +- - **AttachStdin** – 1/True/true or 0/False/false, attach to ++ - **Hostname** – Container host name ++ - **User** – Username or UID ++ - **Memory** – Memory Limit in bytes ++ - **CpuShares** – CPU shares (relative weight) ++ - **AttachStdin** – 1/True/true or 0/False/false, attach to + standard input. Default false +- - **AttachStdout** – 1/True/true or 0/False/false, attach to ++ - **AttachStdout** – 1/True/true or 0/False/false, attach to + standard output. Default false +- - **AttachStderr** – 1/True/true or 0/False/false, attach to ++ - **AttachStderr** – 1/True/true or 0/False/false, attach to + standard error. Default false +- - **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. ++ - **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. + Default false +- - **OpenStdin** – 1/True/true or 0/False/false, keep stdin open ++ - **OpenStdin** – 1/True/true or 0/False/false, keep stdin open + even if not attached. Default false + + Query Parameters: + +   + +- - **name** – Assign the specified name to the container. Must ++ - **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **406** – impossible to attach (container not running) +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **406** – impossible to attach (container not running) ++ - **500** – server error + +-### Inspect a container: ++#### [Inspect a container](#id7) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/json`{.descname} + : Return low-level information on the container `id`{.docutils +@@ -260,11 +316,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### List processes running inside a container: ++#### [List processes running inside a container](#id8) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/top`{.descname} + : List processes running inside the container `id` +@@ -302,15 +358,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **ps\_args** – ps arguments to use (eg. aux) ++ - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Inspect changes on a container’s filesystem: ++#### [Inspect changes on a container’s filesystem](#id9) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/changes`{.descname} + : Inspect changes on container `id` ‘s filesystem +@@ -341,12 +397,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error +- +-### Export a container: ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Export a container](#id10) + + `GET `{.descname}`/containers/`{.descname}(*id*)`/export`{.descname} + : Export the contents of container `id` +@@ -364,12 +419,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error +- +-### Start a container: ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Start a container](#id11) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/start`{.descname} + : Start the container `id` +@@ -396,25 +450,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **Binds** – Create a bind mount to a directory or file with ++ - **Binds** – Create a bind mount to a directory or file with + [host-path]:[container-path]:[rw|ro]. If a directory + “container-path” is missing, then docker creates a new volume. +- - **LxcConf** – Map of custom lxc options +- - **PortBindings** – Expose ports from the container, optionally ++ - **LxcConf** – Map of custom lxc options ++ - **PortBindings** – Expose ports from the container, optionally + publishing them via the HostPort flag +- - **PublishAllPorts** – 1/True/true or 0/False/false, publish all ++ - **PublishAllPorts** – 1/True/true or 0/False/false, publish all + exposed ports to the host interfaces. Default false +- - **Privileged** – 1/True/true or 0/False/false, give extended ++ - **Privileged** – 1/True/true or 0/False/false, give extended + privileges to this container. Default false + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error +- +-### Stop a container: ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Stop a container](#id12) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/stop`{.descname} + : Stop the container `id` +@@ -431,16 +484,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error +- +-### Restart a container: ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Restart a container](#id13) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/restart`{.descname} + : Restart the container `id` +@@ -457,16 +509,15 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – number of seconds to wait before killing the container ++ - **t** – number of seconds to wait before killing the container + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error +- +-### Kill a container: ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Kill a container](#id14) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/kill`{.descname} + : Kill the container `id` +@@ -481,12 +532,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **204** – no error +- - **404** – no such container +- - **500** – server error +- +-### Attach to a container: ++ - **204** – no error ++ - **404** – no such container ++ - **500** – server error + ++#### [Attach to a container](#id15) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/attach`{.descname} + : Attach to the container `id` +@@ -506,23 +556,23 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **logs** – 1/True/true or 0/False/false, return logs. Default ++ - **logs** – 1/True/true or 0/False/false, return logs. Default + false +- - **stream** – 1/True/true or 0/False/false, return stream. ++ - **stream** – 1/True/true or 0/False/false, return stream. + Default false +- - **stdin** – 1/True/true or 0/False/false, if stream=true, attach ++ - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false +- - **stdout** – 1/True/true or 0/False/false, if logs=true, return ++ - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false +- - **stderr** – 1/True/true or 0/False/false, if logs=true, return ++ - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + +- - **200** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + + **Stream details**: + +@@ -547,9 +597,9 @@ page_keywords: API, Docker, rcli, REST, documentation + + `STREAM_TYPE` can be: + +- - 0: stdin (will be writen on stdout) +- - 1: stdout +- - 2: stderr ++ - 0: stdin (will be writen on stdout) ++ - 1: stdout ++ - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. +@@ -568,7 +618,7 @@ page_keywords: API, Docker, rcli, REST, documentation + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +-### Wait a container: ++#### [Wait a container](#id16) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/wait`{.descname} + : Block until container `id` stops, then returns +@@ -587,11 +637,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Remove a container: ++#### [Remove a container](#id17) + + `DELETE `{.descname}`/containers/`{.descname}(*id*) + : Remove the container `id` from the filesystem +@@ -608,17 +658,17 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **v** – 1/True/true or 0/False/false, Remove the volumes ++ - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + +- - **204** – no error +- - **400** – bad parameter +- - **404** – no such container +- - **500** – server error ++ - **204** – no error ++ - **400** – bad parameter ++ - **404** – no such container ++ - **500** – server error + +-### Copy files or folders from a container: ++#### [Copy files or folders from a container](#id18) + + `POST `{.descname}`/containers/`{.descname}(*id*)`/copy`{.descname} + : Copy files or folders of container `id` +@@ -641,13 +691,13 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such container +- - **500** – server error ++ - **200** – no error ++ - **404** – no such container ++ - **500** – server error + +-## Images ++### [2.2 Images](#id19) + +-### List Images: ++#### [List Images](#id20) + + `GET `{.descname}`/images/json`{.descname} + : **Example request**: +@@ -684,7 +734,7 @@ page_keywords: API, Docker, rcli, REST, documentation + } + ] + +-### Create an image: ++#### [Create an image](#id21) + + `POST `{.descname}`/images/create`{.descname} + : Create an image, either by pull it from the registry or by importing +@@ -712,25 +762,24 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **fromImage** – name of the image to pull +- - **fromSrc** – source to import, - means stdin +- - **repo** – repository +- - **tag** – tag +- - **registry** – the registry to pull from ++ - **fromImage** – name of the image to pull ++ - **fromSrc** – source to import, - means stdin ++ - **repo** – repository ++ - **tag** – tag ++ - **registry** – the registry to pull from + + Request Headers: + +   + +- - **X-Registry-Auth** – base64-encoded AuthConfig object ++ - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + +- - **200** – no error +- - **500** – server error +- +-### Insert a file in an image: ++ - **200** – no error ++ - **500** – server error + ++#### [Insert a file in an image](#id22) + + `POST `{.descname}`/images/`{.descname}(*name*)`/insert`{.descname} + : Insert a file from `url` in the image +@@ -752,10 +801,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Inspect an image: ++#### [Inspect an image](#id23) + + `GET `{.descname}`/images/`{.descname}(*name*)`/json`{.descname} + : Return low-level information on the image `name` +@@ -800,11 +849,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Get the history of an image: ++#### [Get the history of an image](#id24) + + `GET `{.descname}`/images/`{.descname}(*name*)`/history`{.descname} + : Return the history of the image `name` +@@ -833,12 +882,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error +- +-### Push an image on the registry: ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + ++#### [Push an image on the registry](#id25) + + `POST `{.descname}`/images/`{.descname}(*name*)`/push`{.descname} + : Push the image `name` on the registry +@@ -861,22 +909,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **registry** – the registry you wan to push, optional ++ - **registry** – the registry you wan to push, optional + + Request Headers: + +   + +- - **X-Registry-Auth** – include a base64-encoded AuthConfig ++ - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **500** – server error + +-### Tag an image into a repository: ++#### [Tag an image into a repository](#id26) + + `POST `{.descname}`/images/`{.descname}(*name*)`/tag`{.descname} + : Tag the image `name` into a repository +@@ -893,18 +941,18 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **repo** – The repository to tag in +- - **force** – 1/True/true or 0/False/false, default false ++ - **repo** – The repository to tag in ++ - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + +- - **201** – no error +- - **400** – bad parameter +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **201** – no error ++ - **400** – bad parameter ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Remove an image: ++#### [Remove an image](#id27) + + `DELETE `{.descname}`/images/`{.descname}(*name*) + : Remove the image `name` from the filesystem +@@ -926,12 +974,12 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **404** – no such image +- - **409** – conflict +- - **500** – server error ++ - **200** – no error ++ - **404** – no such image ++ - **409** – conflict ++ - **500** – server error + +-### Search images: ++#### [Search images](#id28) + + `GET `{.descname}`/images/search`{.descname} + : Search for an image in the docker index. +@@ -979,16 +1027,16 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **term** – term to search ++ - **term** – term to search + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Misc ++### [2.3 Misc](#id29) + +-### Build an image from Dockerfile: ++#### [Build an image from Dockerfile](#id30) + + `POST `{.descname}`/build`{.descname} + : Build an image from Dockerfile using a POST body. +@@ -1020,26 +1068,26 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **t** – repository name (and optionally a tag) to be applied to ++ - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success +- - **q** – suppress verbose build output +- - **nocache** – do not use the cache when building the image +- - **rm** – Remove intermediate containers after a successful build ++ - **q** – suppress verbose build output ++ - **nocache** – do not use the cache when building the image ++ - **rm** – Remove intermediate containers after a successful build + + Request Headers: + +   + +- - **Content-type** – should be set to ++ - **Content-type** – should be set to + `"application/tar"`. +- - **X-Registry-Config** – base64-encoded ConfigFile object ++ - **X-Registry-Config** – base64-encoded ConfigFile object + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Check auth configuration: ++#### [Check auth configuration](#id31) + + `POST `{.descname}`/auth`{.descname} + : Get the default username and email +@@ -1062,11 +1110,11 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **204** – no error +- - **500** – server error ++ - **200** – no error ++ - **204** – no error ++ - **500** – server error + +-### Display system-wide information: ++#### [Display system-wide information](#id32) + + `GET `{.descname}`/info`{.descname} + : Display system-wide information +@@ -1093,10 +1141,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Show the docker version information: ++#### [Show the docker version information](#id33) + + `GET `{.descname}`/version`{.descname} + : Show the docker version information +@@ -1118,10 +1166,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Create a new image from a container’s changes: ++#### [Create a new image from a container’s changes](#id34) + + `POST `{.descname}`/commit`{.descname} + : Create a new image from a container’s changes +@@ -1141,22 +1189,22 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **container** – source container +- - **repo** – repository +- - **tag** – tag +- - **m** – commit message +- - **author** – author (eg. “John Hannibal Smith ++ - **container** – source container ++ - **repo** – repository ++ - **tag** – tag ++ - **m** – commit message ++ - **author** – author (eg. “John Hannibal Smith + \<[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”]}) + + Status Codes: + +- - **201** – no error +- - **404** – no such container +- - **500** – server error ++ - **201** – no error ++ - **404** – no such container ++ - **500** – server error + +-### Monitor Docker’s events: ++#### [Monitor Docker’s events](#id35) + + `GET `{.descname}`/events`{.descname} + : Get events from docker, either in real time via streaming, or via +@@ -1180,14 +1228,14 @@ page_keywords: API, Docker, rcli, REST, documentation + +   + +- - **since** – timestamp used for polling ++ - **since** – timestamp used for polling + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Get a tarball containing all images and tags in a repository: ++#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET `{.descname}`/images/`{.descname}(*name*)`/get`{.descname} + : Get a tarball containing all images and metadata for the repository +@@ -1206,10 +1254,10 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-### Load a tarball with a set of images and tags into docker: ++#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST `{.descname}`/images/load`{.descname} + : Load a set of images and tags into the docker repository. +@@ -1226,38 +1274,38 @@ page_keywords: API, Docker, rcli, REST, documentation + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + +-## Going Further ++## [3. Going further](#id38) + +-### Inside ‘docker run’ ++### [3.1 Inside ‘docker run’](#id39) + + Here are the steps of ‘docker run’ : + +-- Create the container ++- Create the container + +-- If the status code is 404, it means the image doesn’t exists: +- : - Try to pull it +- - Then retry to create the container ++- If the status code is 404, it means the image doesn’t exists: ++ : - Try to pull it ++ - Then retry to create the container + +-- Start the container ++- Start the container + +-- If you are not in detached mode: +- : - Attach to the container, using logs=1 (to have stdout and ++- If you are not in detached mode: ++ : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +-- If in detached mode or only stdin is attached: +- : - Display the container’s id ++- If in detached mode or only stdin is attached: ++ : - Display the container’s id + +-### Hijacking ++### [3.2 Hijacking](#id40) + + In this version of the API, /attach, uses hijacking to transport stdin, + stdout and stderr on the same socket. This might change in the future. + +-### CORS Requests ++### [3.3 CORS Requests](#id41) + + To enable cross origin requests to the remote api add the flag +-“-api-enable-cors” when running docker in daemon mode. ++“–api-enable-cors” when running docker in daemon mode. + +- docker -d -H="192.168.1.9:4243" -api-enable-cors ++ docker -d -H="192.168.1.9:4243" --api-enable-cors +diff --git a/docs/sources/reference/api/index_api.md b/docs/sources/reference/api/index_api.md +index 83cf36b..e9bcc2b 100644 +--- a/docs/sources/reference/api/index_api.md ++++ b/docs/sources/reference/api/index_api.md +@@ -4,17 +4,19 @@ page_keywords: API, Docker, index, REST, documentation + + # Docker Index API + +-## Introduction ++## 1. Brief introduction + +-- This is the REST API for the Docker index +-- Authorization is done with basic auth over SSL +-- Not all commands require authentication, only those noted as such. ++- This is the REST API for the Docker index ++- Authorization is done with basic auth over SSL ++- Not all commands require authentication, only those noted as such. + +-## Repository ++## 2. Endpoints + +-### Repositories ++### 2.1 Repository + +-### User Repo ++#### Repositories ++ ++##### User Repo + + `PUT `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repo\_name*)`/`{.descname} + : Create a user repository with the given `namespace`{.docutils +@@ -33,8 +35,8 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **namespace** – the namespace for the repo +- - **repo\_name** – the name for the repo ++ - **namespace** – the namespace for the repo ++ - **repo\_name** – the name for the repo + + **Example Response**: + +@@ -49,10 +51,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – Created +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active ++ - **200** – Created ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active + + `DELETE `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repo\_name*)`/`{.descname} + : Delete a user repository with the given `namespace`{.docutils +@@ -71,8 +73,8 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **namespace** – the namespace for the repo +- - **repo\_name** – the name for the repo ++ - **namespace** – the namespace for the repo ++ - **repo\_name** – the name for the repo + + **Example Response**: + +@@ -87,13 +89,13 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – Deleted +- - **202** – Accepted +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active ++ - **200** – Deleted ++ - **202** – Accepted ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active + +-### Library Repo ++##### Library Repo + + `PUT `{.descname}`/v1/repositories/`{.descname}(*repo\_name*)`/`{.descname} + : Create a library repository with the given `repo_name`{.docutils +@@ -116,7 +118,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **repo\_name** – the library name for the repo ++ - **repo\_name** – the library name for the repo + + **Example Response**: + +@@ -131,10 +133,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – Created +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active ++ - **200** – Created ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active + + `DELETE `{.descname}`/v1/repositories/`{.descname}(*repo\_name*)`/`{.descname} + : Delete a library repository with the given `repo_name`{.docutils +@@ -157,7 +159,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **repo\_name** – the library name for the repo ++ - **repo\_name** – the library name for the repo + + **Example Response**: + +@@ -172,15 +174,15 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – Deleted +- - **202** – Accepted +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active ++ - **200** – Deleted ++ - **202** – Accepted ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active + +-### Repository Images ++#### Repository Images + +-### User Repo Images ++##### User Repo Images + + `PUT `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repo\_name*)`/images`{.descname} + : Update the images for a user repo. +@@ -198,8 +200,8 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **namespace** – the namespace for the repo +- - **repo\_name** – the name for the repo ++ - **namespace** – the namespace for the repo ++ - **repo\_name** – the name for the repo + + **Example Response**: + +@@ -211,10 +213,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **204** – Created +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active or permission denied ++ - **204** – Created ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active or permission denied + + `GET `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repo\_name*)`/images`{.descname} + : get the images for a user repo. +@@ -227,8 +229,8 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **namespace** – the namespace for the repo +- - **repo\_name** – the name for the repo ++ - **namespace** – the namespace for the repo ++ - **repo\_name** – the name for the repo + + **Example Response**: + +@@ -243,10 +245,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – OK +- - **404** – Not found ++ - **200** – OK ++ - **404** – Not found + +-### Library Repo Images ++##### Library Repo Images + + `PUT `{.descname}`/v1/repositories/`{.descname}(*repo\_name*)`/images`{.descname} + : Update the images for a library repo. +@@ -264,7 +266,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **repo\_name** – the library name for the repo ++ - **repo\_name** – the library name for the repo + + **Example Response**: + +@@ -276,10 +278,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **204** – Created +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active or permission denied ++ - **204** – Created ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active or permission denied + + `GET `{.descname}`/v1/repositories/`{.descname}(*repo\_name*)`/images`{.descname} + : get the images for a library repo. +@@ -292,7 +294,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **repo\_name** – the library name for the repo ++ - **repo\_name** – the library name for the repo + + **Example Response**: + +@@ -307,12 +309,12 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – OK +- - **404** – Not found ++ - **200** – OK ++ - **404** – Not found + +-### Repository Authorization ++#### Repository Authorization + +-### Library Repo ++##### Library Repo + + `PUT `{.descname}`/v1/repositories/`{.descname}(*repo\_name*)`/auth`{.descname} + : authorize a token for a library repo +@@ -326,7 +328,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **repo\_name** – the library name for the repo ++ - **repo\_name** – the library name for the repo + + **Example Response**: + +@@ -338,11 +340,11 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – OK +- - **403** – Permission denied +- - **404** – Not found ++ - **200** – OK ++ - **403** – Permission denied ++ - **404** – Not found + +-### User Repo ++##### User Repo + + `PUT `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repo\_name*)`/auth`{.descname} + : authorize a token for a user repo +@@ -356,8 +358,8 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **namespace** – the namespace for the repo +- - **repo\_name** – the name for the repo ++ - **namespace** – the namespace for the repo ++ - **repo\_name** – the name for the repo + + **Example Response**: + +@@ -369,13 +371,13 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – OK +- - **403** – Permission denied +- - **404** – Not found ++ - **200** – OK ++ - **403** – Permission denied ++ - **404** – Not found + +-### Users ++### 2.2 Users + +-### User Login ++#### User Login + + `GET `{.descname}`/v1/users`{.descname} + : If you want to check your login, you can try this endpoint +@@ -397,11 +399,11 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **200** – no error +- - **401** – Unauthorized +- - **403** – Account is not Active ++ - **200** – no error ++ - **401** – Unauthorized ++ - **403** – Account is not Active + +-### User Register ++#### User Register + + `POST `{.descname}`/v1/users`{.descname} + : Registering a new account. +@@ -421,10 +423,10 @@ page_keywords: API, Docker, index, REST, documentation + +   + +- - **email** – valid email address, that needs to be confirmed +- - **username** – min 4 character, max 30 characters, must match ++ - **email** – valid email address, that needs to be confirmed ++ - **username** – min 4 character, max 30 characters, must match + the regular expression [a-z0-9\_]. +- - **password** – min 5 characters ++ - **password** – min 5 characters + + **Example Response**: + +@@ -436,10 +438,10 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **201** – User Created +- - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **201** – User Created ++ - **400** – Errors (invalid json, missing or invalid fields, etc) + +-### Update User ++#### Update User + + `PUT `{.descname}`/v1/users/`{.descname}(*username*)`/`{.descname} + : Change a password or email address for given user. If you pass in an +@@ -463,7 +465,7 @@ page_keywords: API, Docker, index, REST, documentation + + Parameters: + +- - **username** – username for the person you want to update ++ - **username** – username for the person you want to update + + **Example Response**: + +@@ -475,17 +477,17 @@ page_keywords: API, Docker, index, REST, documentation + + Status Codes: + +- - **204** – User Updated +- - **400** – Errors (invalid json, missing or invalid fields, etc) +- - **401** – Unauthorized +- - **403** – Account is not Active +- - **404** – User not found ++ - **204** – User Updated ++ - **400** – Errors (invalid json, missing or invalid fields, etc) ++ - **401** – Unauthorized ++ - **403** – Account is not Active ++ - **404** – User not found + +-## Search ++### 2.3 Search + + If you need to search the index, this is the endpoint you would use. + +-### Search ++#### Search + + `GET `{.descname}`/v1/search`{.descname} + : Search the Index given a search term. It accepts +@@ -515,11 +517,13 @@ If you need to search the index, this is the endpoint you would use. + + Query Parameters: + +- - **q** – what you want to search for ++   ++ ++ - **q** – what you want to search for + + Status Codes: + +- - **200** – no error +- - **500** – server error ++ - **200** – no error ++ - **500** – server error + + +diff --git a/docs/sources/reference/api/registry_api.md b/docs/sources/reference/api/registry_api.md +index e067586..f251169 100644 +--- a/docs/sources/reference/api/registry_api.md ++++ b/docs/sources/reference/api/registry_api.md +@@ -4,34 +4,34 @@ page_keywords: API, Docker, index, registry, REST, documentation + + # Docker Registry API + +-## Introduction ++## 1. Brief introduction + +-- This is the REST API for the Docker Registry +-- It stores the images and the graph for a set of repositories +-- It does not have user accounts data +-- It has no notion of user accounts or authorization +-- It delegates authentication and authorization to the Index Auth ++- This is the REST API for the Docker Registry ++- It stores the images and the graph for a set of repositories ++- It does not have user accounts data ++- It has no notion of user accounts or authorization ++- It delegates authentication and authorization to the Index Auth + service using tokens +-- It supports different storage backends (S3, cloud files, local FS) +-- It doesn’t have a local database +-- It will be open-sourced at some point ++- It supports different storage backends (S3, cloud files, local FS) ++- It doesn’t have a local database ++- It will be open-sourced at some point + + We expect that there will be multiple registries out there. To help to + grasp the context, here are some examples of registries: + +-- **sponsor registry**: such a registry is provided by a third-party ++- **sponsor registry**: such a registry is provided by a third-party + hosting infrastructure as a convenience for their customers and the + docker community as a whole. Its costs are supported by the third + party, but the management and operation of the registry are + supported by dotCloud. It features read/write access, and delegates + authentication and authorization to the Index. +-- **mirror registry**: such a registry is provided by a third-party ++- **mirror registry**: such a registry is provided by a third-party + hosting infrastructure but is targeted at their customers only. Some + mechanism (unspecified to date) ensures that public images are + pulled from a sponsor registry to the mirror registry, to make sure + that the customers of the third-party provider can “docker pull” + those images locally. +-- **vendor registry**: such a registry is provided by a software ++- **vendor registry**: such a registry is provided by a software + vendor, who wants to distribute docker images. It would be operated + and managed by the vendor. Only users authorized by the vendor would + be able to get write access. Some images would be public (accessible +@@ -41,7 +41,7 @@ grasp the context, here are some examples of registries: + basho/riak1.3” and automatically push from the vendor registry + (instead of a sponsor registry); i.e. get all the convenience of a + sponsor registry, while retaining control on the asset distribution. +-- **private registry**: such a registry is located behind a firewall, ++- **private registry**: such a registry is located behind a firewall, + or protected by an additional security layer (HTTP authorization, + SSL client-side certificates, IP address authorization...). The + registry is operated by a private entity, outside of dotCloud’s +@@ -58,9 +58,9 @@ can be powered by a simple static HTTP server. + Note + + The latter implies that while HTTP is the protocol of choice for a registry, multiple schemes are possible (and in some cases, trivial): +-: - HTTP with GET (and PUT for read-write registries); +- - local mount point; +- - remote docker addressed through SSH. ++: - HTTP with GET (and PUT for read-write registries); ++ - local mount point; ++ - remote docker addressed through SSH. + + The latter would only require two new commands in docker, e.g. + `registryget` and `registryput`{.docutils .literal}, +@@ -68,11 +68,11 @@ wrapping access to the local filesystem (and optionally doing + consistency checks). Authentication and authorization are then delegated + to SSH (e.g. with public keys). + +-## Endpoints ++## 2. Endpoints + +-### Images ++### 2.1 Images + +-### Layer ++#### Layer + + `GET `{.descname}`/v1/images/`{.descname}(*image\_id*)`/layer`{.descname} + : get image layer for a given `image_id` +@@ -87,7 +87,7 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **image\_id** – the id for the layer you want to get ++ - **image\_id** – the id for the layer you want to get + + **Example Response**: + +@@ -100,9 +100,9 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Image not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Image not found + + `PUT `{.descname}`/v1/images/`{.descname}(*image\_id*)`/layer`{.descname} + : put image layer for a given `image_id` +@@ -118,7 +118,7 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **image\_id** – the id for the layer you want to get ++ - **image\_id** – the id for the layer you want to get + + **Example Response**: + +@@ -131,11 +131,11 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Image not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Image not found + +-### Image ++#### Image + + `PUT `{.descname}`/v1/images/`{.descname}(*image\_id*)`/json`{.descname} + : put image for a given `image_id` +@@ -181,7 +181,7 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **image\_id** – the id for the layer you want to get ++ - **image\_id** – the id for the layer you want to get + + **Example Response**: + +@@ -194,8 +194,8 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization ++ - **200** – OK ++ - **401** – Requires authorization + + `GET `{.descname}`/v1/images/`{.descname}(*image\_id*)`/json`{.descname} + : get image for a given `image_id` +@@ -210,7 +210,7 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **image\_id** – the id for the layer you want to get ++ - **image\_id** – the id for the layer you want to get + + **Example Response**: + +@@ -254,11 +254,11 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Image not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Image not found + +-### Ancestry ++#### Ancestry + + `GET `{.descname}`/v1/images/`{.descname}(*image\_id*)`/ancestry`{.descname} + : get ancestry for an image given an `image_id` +@@ -273,7 +273,7 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **image\_id** – the id for the layer you want to get ++ - **image\_id** – the id for the layer you want to get + + **Example Response**: + +@@ -289,11 +289,11 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Image not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Image not found + +-### Tags ++### 2.2 Tags + + `GET `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repository*)`/tags`{.descname} + : get all of the tags for the given repo. +@@ -309,8 +309,8 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **namespace** – namespace for the repo +- - **repository** – name for the repo ++ - **namespace** – namespace for the repo ++ - **repository** – name for the repo + + **Example Response**: + +@@ -326,9 +326,9 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Repository not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Repository not found + + `GET `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repository*)`/tags/`{.descname}(*tag*) + : get a tag for the given repo. +@@ -344,9 +344,9 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **namespace** – namespace for the repo +- - **repository** – name for the repo +- - **tag** – name of tag you want to get ++ - **namespace** – namespace for the repo ++ - **repository** – name for the repo ++ - **tag** – name of tag you want to get + + **Example Response**: + +@@ -359,9 +359,9 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Tag not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Tag not found + + `DELETE `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repository*)`/tags/`{.descname}(*tag*) + : delete the tag for the repo +@@ -376,9 +376,9 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **namespace** – namespace for the repo +- - **repository** – name for the repo +- - **tag** – name of tag you want to delete ++ - **namespace** – namespace for the repo ++ - **repository** – name for the repo ++ - **tag** – name of tag you want to delete + + **Example Response**: + +@@ -391,9 +391,9 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Tag not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Tag not found + + `PUT `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repository*)`/tags/`{.descname}(*tag*) + : put a tag for the given repo. +@@ -410,9 +410,9 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **namespace** – namespace for the repo +- - **repository** – name for the repo +- - **tag** – name of tag you want to add ++ - **namespace** – namespace for the repo ++ - **repository** – name for the repo ++ - **tag** – name of tag you want to add + + **Example Response**: + +@@ -425,12 +425,12 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **400** – Invalid data +- - **401** – Requires authorization +- - **404** – Image not found ++ - **200** – OK ++ - **400** – Invalid data ++ - **401** – Requires authorization ++ - **404** – Image not found + +-### Repositories ++### 2.3 Repositories + + `DELETE `{.descname}`/v1/repositories/`{.descname}(*namespace*)`/`{.descname}(*repository*)`/`{.descname} + : delete a repository +@@ -447,8 +447,8 @@ to SSH (e.g. with public keys). + + Parameters: + +- - **namespace** – namespace for the repo +- - **repository** – name for the repo ++ - **namespace** – namespace for the repo ++ - **repository** – name for the repo + + **Example Response**: + +@@ -461,11 +461,11 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK +- - **401** – Requires authorization +- - **404** – Repository not found ++ - **200** – OK ++ - **401** – Requires authorization ++ - **404** – Repository not found + +-### Status ++### 2.4 Status + + `GET `{.descname}`/v1/_ping`{.descname} + : Check status of the registry. This endpoint is also used to +@@ -491,9 +491,9 @@ to SSH (e.g. with public keys). + + Status Codes: + +- - **200** – OK ++ - **200** – OK + +-## Authorization ++## 3 Authorization + + This is where we describe the authorization process, including the + tokens and cookies. +diff --git a/docs/sources/reference/api/registry_index_spec.md b/docs/sources/reference/api/registry_index_spec.md +index dc0dd80..281fe07 100644 +--- a/docs/sources/reference/api/registry_index_spec.md ++++ b/docs/sources/reference/api/registry_index_spec.md +@@ -4,55 +4,55 @@ page_keywords: docker, registry, api, index + + # Registry & Index Spec + +-## The 3 roles ++## 1. The 3 roles + +-### Index ++### 1.1 Index + + The Index is responsible for centralizing information about: + +-- User accounts +-- Checksums of the images +-- Public namespaces ++- User accounts ++- Checksums of the images ++- Public namespaces + + The Index has different components: + +-- Web UI +-- Meta-data store (comments, stars, list public repositories) +-- Authentication service +-- Tokenization ++- Web UI ++- Meta-data store (comments, stars, list public repositories) ++- Authentication service ++- Tokenization + + The index is authoritative for those information. + + We expect that there will be only one instance of the index, run and + managed by Docker Inc. + +-### Registry ++### 1.2 Registry + +-- It stores the images and the graph for a set of repositories +-- It does not have user accounts data +-- It has no notion of user accounts or authorization +-- It delegates authentication and authorization to the Index Auth ++- It stores the images and the graph for a set of repositories ++- It does not have user accounts data ++- It has no notion of user accounts or authorization ++- It delegates authentication and authorization to the Index Auth + service using tokens +-- It supports different storage backends (S3, cloud files, local FS) +-- It doesn’t have a local database +-- [Source Code](https://github.com/dotcloud/docker-registry) ++- It supports different storage backends (S3, cloud files, local FS) ++- It doesn’t have a local database ++- [Source Code](https://github.com/dotcloud/docker-registry) + + We expect that there will be multiple registries out there. To help to + grasp the context, here are some examples of registries: + +-- **sponsor registry**: such a registry is provided by a third-party ++- **sponsor registry**: such a registry is provided by a third-party + hosting infrastructure as a convenience for their customers and the + docker community as a whole. Its costs are supported by the third + party, but the management and operation of the registry are + supported by dotCloud. It features read/write access, and delegates + authentication and authorization to the Index. +-- **mirror registry**: such a registry is provided by a third-party ++- **mirror registry**: such a registry is provided by a third-party + hosting infrastructure but is targeted at their customers only. Some + mechanism (unspecified to date) ensures that public images are + pulled from a sponsor registry to the mirror registry, to make sure + that the customers of the third-party provider can “docker pull” + those images locally. +-- **vendor registry**: such a registry is provided by a software ++- **vendor registry**: such a registry is provided by a software + vendor, who wants to distribute docker images. It would be operated + and managed by the vendor. Only users authorized by the vendor would + be able to get write access. Some images would be public (accessible +@@ -62,20 +62,19 @@ grasp the context, here are some examples of registries: + basho/riak1.3” and automatically push from the vendor registry + (instead of a sponsor registry); i.e. get all the convenience of a + sponsor registry, while retaining control on the asset distribution. +-- **private registry**: such a registry is located behind a firewall, ++- **private registry**: such a registry is located behind a firewall, + or protected by an additional security layer (HTTP authorization, + SSL client-side certificates, IP address authorization...). The + registry is operated by a private entity, outside of dotCloud’s + control. It can optionally delegate additional authorization to the + Index, but it is not mandatory. + +-> **Note:** The latter implies that while HTTP is the protocol +-> of choice for a registry, multiple schemes are possible (and +-> in some cases, trivial): +-> +-> - HTTP with GET (and PUT for read-write registries); +-> - local mount point; +-> - remote docker addressed through SSH. ++Note ++ ++The latter implies that while HTTP is the protocol of choice for a registry, multiple schemes are possible (and in some cases, trivial): ++: - HTTP with GET (and PUT for read-write registries); ++ - local mount point; ++ - remote docker addressed through SSH. + + The latter would only require two new commands in docker, e.g. + `registryget` and `registryput`{.docutils .literal}, +@@ -83,17 +82,17 @@ wrapping access to the local filesystem (and optionally doing + consistency checks). Authentication and authorization are then delegated + to SSH (e.g. with public keys). + +-### Docker ++### 1.3 Docker + + On top of being a runtime for LXC, Docker is the Registry client. It + supports: + +-- Push / Pull on the registry +-- Client authentication on the Index ++- Push / Pull on the registry ++- Client authentication on the Index + +-## Workflow ++## 2. Workflow + +-### Pull ++### 2.1 Pull + + ![](../../../_images/docker_pull_chart.png) + +@@ -147,9 +146,9 @@ and for an active account. + 2. (Index -\> Docker) HTTP 200 OK + + > **Headers**: +- > : - Authorization: Token ++ > : - Authorization: Token + > signature=123abc,repository=”foo/bar”,access=write +- > - X-Docker-Endpoints: registry.docker.io [, ++ > - X-Docker-Endpoints: registry.docker.io [, + > registry2.docker.io] + > + > **Body**: +@@ -188,7 +187,7 @@ Note + If someone makes a second request, then we will always give a new token, + never reuse tokens. + +-### Push ++### 2.2 Push + + ![](../../../_images/docker_push_chart.png) + +@@ -204,15 +203,17 @@ never reuse tokens. + pushed by docker and store the repository (with its images) + 6. docker contacts the index to give checksums for upload images + +-> **Note:** +-> **It’s possible not to use the Index at all!** In this case, a deployed +-> version of the Registry is deployed to store and serve images. Those +-> images are not authenticated and the security is not guaranteed. ++Note ++ ++**It’s possible not to use the Index at all!** In this case, a deployed ++version of the Registry is deployed to store and serve images. Those ++images are not authenticated and the security is not guaranteed. ++ ++Note + +-> **Note:** +-> **Index can be replaced!** For a private Registry deployed, a custom +-> Index can be used to serve and validate token according to different +-> policies. ++**Index can be replaced!** For a private Registry deployed, a custom ++Index can be used to serve and validate token according to different ++policies. + + Docker computes the checksums and submit them to the Index at the end of + the push. When a repository name does not have checksums on the Index, +@@ -227,7 +228,7 @@ the end). + true + + **Action**:: +- : - in index, we allocated a new repository, and set to ++ : - in index, we allocated a new repository, and set to + initialized + + **Body**:: +@@ -239,9 +240,9 @@ the end). + + 2. (Index -\> Docker) 200 Created + : **Headers**: +- : - WWW-Authenticate: Token ++ : - WWW-Authenticate: Token + signature=123abc,repository=”foo/bar”,access=write +- - X-Docker-Endpoints: registry.docker.io [, ++ - X-Docker-Endpoints: registry.docker.io [, + registry2.docker.io] + + 3. (Docker -\> Registry) PUT /v1/images/98765432\_parent/json +@@ -255,18 +256,18 @@ the end). + signature=123abc,repository=”foo/bar”,access=write + + **Action**:: +- : - Index: ++ : - Index: + : will invalidate the token. + +- - Registry: ++ - Registry: + : grants a session (if token is approved) and fetches + the images id + + 5. (Docker -\> Registry) PUT /v1/images/98765432\_parent/json + : **Headers**:: +- : - Authorization: Token ++ : - Authorization: Token + signature=123abc,repository=”foo/bar”,access=write +- - Cookie: (Cookie provided by the Registry) ++ - Cookie: (Cookie provided by the Registry) + + 6. (Docker -\> Registry) PUT /v1/images/98765432/json + : **Headers**: +@@ -303,17 +304,19 @@ the end). + + **Return** HTTP 204 + +-> **Note:** If push fails and they need to start again, what happens in the index, +-> there will already be a record for the namespace/name, but it will be +-> initialized. Should we allow it, or mark as name already used? One edge +-> case could be if someone pushes the same thing at the same time with two +-> different shells. ++Note ++ ++If push fails and they need to start again, what happens in the index, ++there will already be a record for the namespace/name, but it will be ++initialized. Should we allow it, or mark as name already used? One edge ++case could be if someone pushes the same thing at the same time with two ++different shells. + + If it’s a retry on the Registry, Docker has a cookie (provided by the + registry after token validation). So the Index won’t have to provide a + new token. + +-### Delete ++### 2.3 Delete + + If you need to delete something from the index or registry, we need a + nice clean way to do that. Here is the workflow. +@@ -333,9 +336,11 @@ nice clean way to do that. Here is the workflow. + 6. docker contacts the index to let it know it was removed from the + registry, the index removes all records from the database. + +-> **Note:** The Docker client should present an “Are you sure?” prompt to confirm +-> the deletion before starting the process. Once it starts it can’t be +-> undone. ++Note ++ ++The Docker client should present an “Are you sure?” prompt to confirm ++the deletion before starting the process. Once it starts it can’t be ++undone. + + #### API (deleting repository foo/bar): + +@@ -345,7 +350,7 @@ nice clean way to do that. Here is the workflow. + true + + **Action**:: +- : - in index, we make sure it is a valid repository, and set ++ : - in index, we make sure it is a valid repository, and set + to deleted (logically) + + **Body**:: +@@ -353,9 +358,9 @@ nice clean way to do that. Here is the workflow. + + 2. (Index -\> Docker) 202 Accepted + : **Headers**: +- : - WWW-Authenticate: Token ++ : - WWW-Authenticate: Token + signature=123abc,repository=”foo/bar”,access=delete +- - X-Docker-Endpoints: registry.docker.io [, ++ - X-Docker-Endpoints: registry.docker.io [, + registry2.docker.io] \# list of endpoints where this + repo lives. + +@@ -370,10 +375,10 @@ nice clean way to do that. Here is the workflow. + signature=123abc,repository=”foo/bar”,access=delete + + **Action**:: +- : - Index: ++ : - Index: + : will invalidate the token. + +- - Registry: ++ - Registry: + : deletes the repository (if token is approved) + + 5. (Registry -\> Docker) 200 OK +@@ -391,20 +396,20 @@ nice clean way to do that. Here is the workflow. + > + > **Return** HTTP 200 + +-## How to use the Registry in standalone mode ++## 3. How to use the Registry in standalone mode + + The Index has two main purposes (along with its fancy social features): + +-- Resolve short names (to avoid passing absolute URLs all the time) +- : - username/projectname -\> ++- Resolve short names (to avoid passing absolute URLs all the time) ++ : - username/projectname -\> + https://registry.docker.io/users/\/repositories/\/ +- - team/projectname -\> ++ - team/projectname -\> + https://registry.docker.io/team/\/repositories/\/ + +-- Authenticate a user as a repos owner (for a central referenced ++- Authenticate a user as a repos owner (for a central referenced + repository) + +-### Without an Index ++### 3.1 Without an Index + + Using the Registry without the Index can be useful to store the images + on a private network without having to rely on an external entity +@@ -425,12 +430,12 @@ As hinted previously, a standalone registry can also be implemented by + any HTTP server handling GET/PUT requests (or even only GET requests if + no write access is necessary). + +-### With an Index ++### 3.2 With an Index + + The Index data needed by the Registry are simple: + +-- Serve the checksums +-- Provide and authorize a Token ++- Serve the checksums ++- Provide and authorize a Token + + In the scenario of a Registry running on a private network with the need + of centralizing and authorizing, it’s easy to use a custom Index. +@@ -441,12 +446,12 @@ specific Index, it’ll be the private entity responsibility (basically + the organization who uses Docker in a private environment) to maintain + the Index and the Docker’s configuration among its consumers. + +-## The API ++## 4. The API + + The first version of the api is available here: + [https://github.com/jpetazzo/docker/blob/acd51ecea8f5d3c02b00a08176171c59442df8b3/docs/images-repositories-push-pull.md](https://github.com/jpetazzo/docker/blob/acd51ecea8f5d3c02b00a08176171c59442df8b3/docs/images-repositories-push-pull.md) + +-### Images ++### 4.1 Images + + The format returned in the images is not defined here (for layer and + JSON), basically because Registry stores exactly the same kind of +@@ -464,9 +469,9 @@ file is empty. + GET /v1/images//ancestry + PUT /v1/images//ancestry + +-### Users ++### 4.2 Users + +-### Create a user (Index) ++#### 4.2.1 Create a user (Index) + + POST /v1/users + +@@ -474,9 +479,9 @@ POST /v1/users + : {“email”: “[sam@dotcloud.com](mailto:sam%40dotcloud.com)”, + “password”: “toto42”, “username”: “foobar”’} + **Validation**: +-: - **username**: min 4 character, max 30 characters, must match the ++: - **username**: min 4 character, max 30 characters, must match the + regular expression [a-z0-9\_]. +- - **password**: min 5 characters ++ - **password**: min 5 characters + + **Valid**: return HTTP 200 + +@@ -489,7 +494,7 @@ Note + A user account will be valid only if the email has been validated (a + validation link is sent to the email address). + +-### Update a user (Index) ++#### 4.2.2 Update a user (Index) + + PUT /v1/users/\ + +@@ -501,7 +506,7 @@ Note + We can also update email address, if they do, they will need to reverify + their new email address. + +-### Login (Index) ++#### 4.2.3 Login (Index) + + Does nothing else but asking for a user authentication. Can be used to + validate credentials. HTTP Basic Auth for now, maybe change in future. +@@ -509,11 +514,11 @@ validate credentials. HTTP Basic Auth for now, maybe change in future. + GET /v1/users + + **Return**: +-: - Valid: HTTP 200 +- - Invalid login: HTTP 401 +- - Account inactive: HTTP 403 Account is not Active ++: - Valid: HTTP 200 ++ - Invalid login: HTTP 401 ++ - Account inactive: HTTP 403 Account is not Active + +-### Tags (Registry) ++### 4.3 Tags (Registry) + + The Registry does not know anything about users. Even though + repositories are under usernames, it’s just a namespace for the +@@ -522,11 +527,11 @@ per user later, without modifying the Registry’s API. + + The following naming restrictions apply: + +-- Namespaces must match the same regular expression as usernames (See ++- Namespaces must match the same regular expression as usernames (See + 4.2.1.) +-- Repository names must match the regular expression [a-zA-Z0-9-\_.] ++- Repository names must match the regular expression [a-zA-Z0-9-\_.] + +-### Get all tags: ++#### 4.3.1 Get all tags + + GET /v1/repositories/\/\/tags + +@@ -536,25 +541,25 @@ GET /v1/repositories/\/\/tags + “0.1.1”: + “b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087” } + +-### Read the content of a tag (resolve the image id): ++#### 4.3.2 Read the content of a tag (resolve the image id) + + GET /v1/repositories/\/\/tags/\ + + **Return**: + : “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f” + +-### Delete a tag (registry): ++#### 4.3.3 Delete a tag (registry) + + DELETE /v1/repositories/\/\/tags/\ + +-## Images (Index) ++### 4.4 Images (Index) + + For the Index to “resolve” the repository name to a Registry location, + it uses the X-Docker-Endpoints header. In other terms, this requests + always add a `X-Docker-Endpoints` to indicate the + location of the registry which hosts this repository. + +-### Get the images: ++#### 4.4.1 Get the images + + GET /v1/repositories/\/\/images + +@@ -562,9 +567,9 @@ GET /v1/repositories/\/\/images + : [{“id”: + “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, + “checksum”: +- “[md5:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087](md5:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087)”}] ++ “”}] + +-### Add/update the images: ++#### 4.4.2 Add/update the images + + You always add images, you never remove them. + +@@ -579,15 +584,15 @@ PUT /v1/repositories/\/\/images + + **Return** 204 + +-### Repositories ++### 4.5 Repositories + +-### Remove a Repository (Registry) ++#### 4.5.1 Remove a Repository (Registry) + + DELETE /v1/repositories/\/\ + + Return 200 OK + +-### Remove a Repository (Index) ++#### 4.5.2 Remove a Repository (Index) + + This starts the delete process. see 2.3 for more details. + +@@ -595,12 +600,12 @@ DELETE /v1/repositories/\/\ + + Return 202 OK + +-## Chaining Registries ++## 5. Chaining Registries + + It’s possible to chain Registries server for several reasons: + +-- Load balancing +-- Delegate the next request to another server ++- Load balancing ++- Delegate the next request to another server + + When a Registry is a reference for a repository, it should host the + entire images chain in order to avoid breaking the chain during the +@@ -618,9 +623,9 @@ On every request, a special header can be returned: + On the next request, the client will always pick a server from this + list. + +-## Authentication & Authorization ++## 6. Authentication & Authorization + +-### On the Index ++### 6.1 On the Index + + The Index supports both “Basic” and “Token” challenges. Usually when + there is a `401 Unauthorized`, the Index replies +@@ -634,16 +639,16 @@ You have 3 options: + 1. Provide user credentials and ask for a token + + > **Header**: +- > : - Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== +- > - X-Docker-Token: true ++ > : - Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== ++ > - X-Docker-Token: true + > + > In this case, along with the 200 response, you’ll get a new token + > (if user auth is ok): If authorization isn’t correct you get a 401 + > response. If account isn’t active you will get a 403 response. + > + > **Response**: +- > : - 200 OK +- > - X-Docker-Token: Token ++ > : - 200 OK ++ > - X-Docker-Token: Token + > signature=123abc,repository=”foo/bar”,access=read + > + 2. Provide user credentials only +@@ -681,9 +686,9 @@ Next request: + GET /(...) + Cookie: session="wD/J7LqL5ctqw8haL10vgfhrb2Q=?foo=UydiYXInCnAxCi4=×tamp=RjEzNjYzMTQ5NDcuNDc0NjQzCi4=" + +-## Document Version ++## 7 Document Version + +-- 1.0 : May 6th 2013 : initial release +-- 1.1 : June 1st 2013 : Added Delete Repository and way to handle new ++- 1.0 : May 6th 2013 : initial release ++- 1.1 : June 1st 2013 : Added Delete Repository and way to handle new + source namespace. + +diff --git a/docs/sources/reference/api/remote_api_client_libraries.md b/docs/sources/reference/api/remote_api_client_libraries.md +index 0392da3..4991924 100644 +--- a/docs/sources/reference/api/remote_api_client_libraries.md ++++ b/docs/sources/reference/api/remote_api_client_libraries.md +@@ -4,115 +4,82 @@ page_keywords: API, Docker, index, registry, REST, documentation, clients, Pytho + + # Docker Remote API Client Libraries + +-## Introduction +- + These libraries have not been tested by the Docker Maintainers for + compatibility. Please file issues with the library owners. If you find + more library implementations, please list them in Docker doc bugs and we + will add the libraries here. + +-Language/Framework +- +-Name +- +-Repository +- +-Status +- +-Python +- +-docker-py +- +-[https://github.com/dotcloud/docker-py](https://github.com/dotcloud/docker-py) +- +-Active +- +-Ruby +- +-docker-client +- +-[https://github.com/geku/docker-client](https://github.com/geku/docker-client) +- +-Outdated +- +-Ruby +- +-docker-api +- +-[https://github.com/swipely/docker-api](https://github.com/swipely/docker-api) +- +-Active +- +-JavaScript (NodeJS) +- +-dockerode +- +-[https://github.com/apocas/dockerode](https://github.com/apocas/dockerode) +-Install via NPM: npm install dockerode +- +-Active +- +-JavaScript (NodeJS) +- +-docker.io +- +-[https://github.com/appersonlabs/docker.io](https://github.com/appersonlabs/docker.io) +-Install via NPM: npm install docker.io +- +-Active +- +-JavaScript +- +-docker-js +- +-[https://github.com/dgoujard/docker-js](https://github.com/dgoujard/docker-js) +- +-Active +- +-JavaScript (Angular) **WebUI** +- +-docker-cp +- +-[https://github.com/13W/docker-cp](https://github.com/13W/docker-cp) +- +-Active +- +-JavaScript (Angular) **WebUI** +- +-dockerui +- +-[https://github.com/crosbymichael/dockerui](https://github.com/crosbymichael/dockerui) ++ ------------------------------------------------------------------------- ++ Language/Framewor Name Repository Status ++ k ++ ----------------- ------------ ---------------------------------- ------- ++ Python docker-py [https://github.com/dotcloud/docke Active ++ r-py](https://github.com/dotcloud/ ++ docker-py) + +-Active ++ Ruby docker-clien [https://github.com/geku/docker-cl Outdate ++ t ient](https://github.com/geku/dock d ++ er-client) + +-Java ++ Ruby docker-api [https://github.com/swipely/docker Active ++ -api](https://github.com/swipely/d ++ ocker-api) + +-docker-java ++ JavaScript dockerode [https://github.com/apocas/dockero Active ++ (NodeJS) de](https://github.com/apocas/dock ++ erode) ++ Install via NPM: npm install ++ dockerode + +-[https://github.com/kpelykh/docker-java](https://github.com/kpelykh/docker-java) ++ JavaScript docker.io [https://github.com/appersonlabs/d Active ++ (NodeJS) ocker.io](https://github.com/apper ++ sonlabs/docker.io) ++ Install via NPM: npm install ++ docker.io + +-Active ++ JavaScript docker-js [https://github.com/dgoujard/docke Outdate ++ r-js](https://github.com/dgoujard/ d ++ docker-js) + +-Erlang ++ JavaScript docker-cp [https://github.com/13W/docker-cp] Active ++ (Angular) (https://github.com/13W/docker-cp) ++ **WebUI** + +-erldocker ++ JavaScript dockerui [https://github.com/crosbymichael/ Active ++ (Angular) dockerui](https://github.com/crosb ++ **WebUI** ymichael/dockerui) + +-[https://github.com/proger/erldocker](https://github.com/proger/erldocker) ++ Java docker-java [https://github.com/kpelykh/docker Active ++ -java](https://github.com/kpelykh/ ++ docker-java) + +-Active ++ Erlang erldocker [https://github.com/proger/erldock Active ++ er](https://github.com/proger/erld ++ ocker) + +-Go ++ Go go-dockercli [https://github.com/fsouza/go-dock Active ++ ent erclient](https://github.com/fsouz ++ a/go-dockerclient) + +-go-dockerclient ++ Go dockerclient [https://github.com/samalba/docker Active ++ client](https://github.com/samalba ++ /dockerclient) + +-[https://github.com/fsouza/go-dockerclient](https://github.com/fsouza/go-dockerclient) ++ PHP Alvine [http://pear.alvine.io/](http://pe Active ++ ar.alvine.io/) ++ (alpha) + +-Active ++ PHP Docker-PHP [http://stage1.github.io/docker-ph Active ++ p/](http://stage1.github.io/docker ++ -php/) + +-PHP ++ Perl Net::Docker [https://metacpan.org/pod/Net::Doc Active ++ ker](https://metacpan.org/pod/Net: ++ :Docker) + +-Alvine ++ Perl Eixo::Docker [https://github.com/alambike/eixo- Active ++ docker](https://github.com/alambik ++ e/eixo-docker) ++ ------------------------------------------------------------------------- + +-[http://pear.alvine.io/](http://pear.alvine.io/) (alpha) + +-Active +diff --git a/docs/sources/reference/commandline.md b/docs/sources/reference/commandline.md +index 6f7a779..b2fb7e0 100644 +--- a/docs/sources/reference/commandline.md ++++ b/docs/sources/reference/commandline.md +@@ -1,7 +1,7 @@ + + # Commands + +-## Contents: ++Contents: + + - [Command Line Help](cli/) + - [Options](cli/#options) +diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md +index 9d825ce..3deac40 100644 +--- a/docs/sources/reference/run.md ++++ b/docs/sources/reference/run.md +@@ -2,7 +2,7 @@ page_title: Docker Run Reference + page_description: Configure containers at runtime + page_keywords: docker, run, configure, runtime + +-# Docker Run Reference ++# [Docker Run Reference](#id2) + + **Docker runs processes in isolated containers**. When an operator + executes `docker run`, she starts a process with its +@@ -25,7 +25,7 @@ Table of Contents + - [Overriding `Dockerfile` Image + Defaults](#overriding-dockerfile-image-defaults) + +-## General Form ++## [General Form](#id3) + + As you’ve seen in the [*Examples*](../../examples/#example-list), the + basic run command takes this form: +@@ -52,7 +52,7 @@ control over runtime behavior to the operator, allowing them to override + all defaults set by the developer during `docker build`{.docutils + .literal} and nearly all the defaults set by the Docker runtime itself. + +-## Operator Exclusive Options ++## [Operator Exclusive Options](#id4) + + Only the operator (the person executing `docker run`{.docutils + .literal}) can set the following options. +@@ -60,19 +60,17 @@ Only the operator (the person executing `docker run`{.docutils + - [Detached vs Foreground](#detached-vs-foreground) + - [Detached (-d)](#detached-d) + - [Foreground](#foreground) +- + - [Container Identification](#container-identification) +- - [Name (-name)](#name-name) ++ - [Name (–name)](#name-name) + - [PID Equivalent](#pid-equivalent) +- + - [Network Settings](#network-settings) +-- [Clean Up (-rm)](#clean-up-rm) ++- [Clean Up (–rm)](#clean-up-rm) + - [Runtime Constraints on CPU and + Memory](#runtime-constraints-on-cpu-and-memory) + - [Runtime Privilege and LXC + Configuration](#runtime-privilege-and-lxc-configuration) + +-### Detached vs Foreground ++### [Detached vs Foreground](#id6) + + When starting a Docker container, you must first decide if you want to + run the container in the background in a “detached” mode or in the +@@ -80,7 +78,7 @@ default foreground mode: + + -d=false: Detached mode: Run container in the background, print new container id + +-**Detached (-d)** ++#### [Detached (-d)](#id7) + + In detached mode (`-d=true` or just `-d`{.docutils + .literal}), all I/O should be done through network connections or shared +@@ -88,10 +86,10 @@ volumes because the container is no longer listening to the commandline + where you executed `docker run`. You can reattach to + a detached container with `docker` + [*attach*](../commandline/cli/#cli-attach). If you choose to run a +-container in the detached mode, then you cannot use the `-rm`{.docutils ++container in the detached mode, then you cannot use the `--rm`{.docutils + .literal} option. + +-**Foreground** ++#### [Foreground](#id8) + + In foreground mode (the default when `-d` is not + specified), `docker run` can start the process in +@@ -100,10 +98,10 @@ output, and standard error. It can even pretend to be a TTY (this is + what most commandline executables expect) and pass along signals. All of + that is configurable: + +- -a=[] : Attach to ``stdin``, ``stdout`` and/or ``stderr`` +- -t=false : Allocate a pseudo-tty +- -sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) +- -i=false : Keep STDIN open even if not attached ++ -a=[] : Attach to ``stdin``, ``stdout`` and/or ``stderr`` ++ -t=false : Allocate a pseudo-tty ++ --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) ++ -i=false : Keep STDIN open even if not attached + + If you do not specify `-a` then Docker will [attach + everything +@@ -119,9 +117,9 @@ as well as persistent standard input (`stdin`), so + you’ll use `-i -t` together in most interactive + cases. + +-### Container Identification ++### [Container Identification](#id9) + +-**Name (-name)** ++#### [Name (–name)](#id10) + + The operator can identify a container in three ways: + +@@ -131,27 +129,27 @@ The operator can identify a container in three ways: + - Name (“evil\_ptolemy”) + + The UUID identifiers come from the Docker daemon, and if you do not +-assign a name to the container with `-name` then 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 name +-when defining ++assign a name to the container with `--name` then ++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 ++name when defining + [*links*](../../use/working_with_links_names/#working-with-links-names) + (or any other place you need to identify a container). This works for + both background and foreground Docker containers. + +-**PID Equivalent** ++#### [PID Equivalent](#id11) + + And finally, to help with automation, you can have Docker write the + container ID out to a file of your choosing. This is similar to how some + programs might write out their process ID to a file (you’ve seen them as + PID files): + +- -cidfile="": Write the container ID to the file ++ --cidfile="": Write the container ID to the file + +-### Network Settings ++### [Network Settings](#id12) + + -n=true : Enable networking for this container +- -dns=[] : Set custom dns servers for the container ++ --dns=[] : Set custom dns servers for the container + + By default, all containers have networking enabled and they can make any + outgoing connections. The operator can completely disable networking +@@ -160,9 +158,9 @@ outgoing networking. In cases like this, you would perform I/O through + files or STDIN/STDOUT only. + + Your container will use the same DNS servers as the host by default, but +-you can override this with `-dns`. ++you can override this with `--dns`. + +-### Clean Up (-rm) ++### [Clean Up (–rm)](#id13) + + By default a container’s file system persists even after the container + exits. This makes debugging a lot easier (since you can inspect the +@@ -170,11 +168,11 @@ final state) and you retain all your data by default. But if you are + running short-term **foreground** processes, these container file + systems can really pile up. If instead you’d like Docker to + **automatically clean up the container and remove the file system when +-the container exits**, you can add the `-rm` flag: ++the container exits**, you can add the `--rm` flag: + +- -rm=false: Automatically remove the container when it exits (incompatible with -d) ++ --rm=false: Automatically remove the container when it exits (incompatible with -d) + +-### Runtime Constraints on CPU and Memory ++### [Runtime Constraints on CPU and Memory](#id14) + + The operator can also adjust the performance parameters of the + container: +@@ -193,10 +191,10 @@ the same priority and get the same proportion of CPU cycles, but you can + tell the kernel to give more shares of CPU time to one or more + containers when you start them via Docker. + +-### Runtime Privilege and LXC Configuration ++### [Runtime Privilege and LXC Configuration](#id15) + +- -privileged=false: Give extended privileges to this container +- -lxc-conf=[]: Add custom lxc options -lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" ++ --privileged=false: Give extended privileges to this container ++ --lxc-conf=[]: (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" + + By default, Docker containers are “unprivileged” and cannot, for + example, run a Docker daemon inside a Docker container. This is because +@@ -206,23 +204,26 @@ by default a container is not allowed to access any devices, but a + and documentation on [cgroups + devices](https://www.kernel.org/doc/Documentation/cgroups/devices.txt)). + +-When the operator executes `docker run -privileged`, +-Docker will enable to access to all devices on the host as well as set +-some configuration in AppArmor to allow the container nearly all the +-same access to the host as processes running outside containers on the +-host. Additional information about running with `-privileged`{.docutils +-.literal} is available on the [Docker ++When the operator executes `docker run --privileged`{.docutils ++.literal}, Docker will enable to access to all devices on the host as ++well as set some configuration in AppArmor to allow the container nearly ++all the same access to the host as processes running outside containers ++on the host. Additional information about running with ++`--privileged` is available on the [Docker + Blog](http://blog.docker.io/2013/09/docker-can-now-run-within-docker/). + +-An operator can also specify LXC options using one or more +-`-lxc-conf` parameters. These can be new parameters ++If the Docker daemon was started using the `lxc` ++exec-driver (`docker -d --exec-driver=lxc`) then the ++operator can also specify LXC options using one or more ++`--lxc-conf` parameters. These can be new parameters + or override existing parameters from the + [lxc-template.go](https://github.com/dotcloud/docker/blob/master/execdriver/lxc/lxc_template.go). + Note that in the future, a given host’s Docker daemon may not use LXC, + so this is an implementation-specific configuration meant for operators + already familiar with using LXC directly. + +-## Overriding `Dockerfile` Image Defaults ++## [Overriding `Dockerfile` Image Defaults](#id5) ++ + When a developer builds an image from a + [*Dockerfile*](../builder/#dockerbuilder) or when she commits it, the + developer can set a number of default parameters that take effect when +@@ -244,7 +245,7 @@ how the operator can override that setting. + - [USER](#user) + - [WORKDIR](#workdir) + +-### CMD (Default Command or Options) ++### [CMD (Default Command or Options)](#id16) + + Recall the optional `COMMAND` in the Docker + commandline: +@@ -262,9 +263,9 @@ If the image also specifies an `ENTRYPOINT` then the + `CMD` or `COMMAND`{.docutils .literal} get appended + as arguments to the `ENTRYPOINT`. + +-### ENTRYPOINT (Default Command to Execute at Runtime ++### [ENTRYPOINT (Default Command to Execute at Runtime](#id17) + +- -entrypoint="": Overwrite the default entrypoint set by the image ++ --entrypoint="": Overwrite the default entrypoint set by the image + + The ENTRYPOINT of an image is similar to a `COMMAND` + because it specifies what executable to run when the container starts, +@@ -280,14 +281,14 @@ the new `ENTRYPOINT`. Here is an example of how to + run a shell in a container that has been set up to automatically run + something else (like `/usr/bin/redis-server`): + +- docker run -i -t -entrypoint /bin/bash example/redis ++ docker run -i -t --entrypoint /bin/bash example/redis + + or two examples of how to pass more parameters to that ENTRYPOINT: + +- docker run -i -t -entrypoint /bin/bash example/redis -c ls -l +- docker run -i -t -entrypoint /usr/bin/redis-cli example/redis --help ++ docker run -i -t --entrypoint /bin/bash example/redis -c ls -l ++ docker run -i -t --entrypoint /usr/bin/redis-cli example/redis --help + +-### EXPOSE (Incoming Ports) ++### [EXPOSE (Incoming Ports)](#id18) + + The `Dockerfile` doesn’t give much control over + networking, only providing the `EXPOSE` instruction +@@ -295,17 +296,17 @@ to give a hint to the operator about what incoming ports might provide + services. The following options work with or override the + `Dockerfile`‘s exposed defaults: + +- -expose=[]: Expose a port from the container ++ --expose=[]: Expose a port from the container + without publishing it to your host +- -P=false : Publish all exposed ports to the host interfaces +- -p=[] : Publish a container's port to the host (format: +- ip:hostPort:containerPort | ip::containerPort | +- hostPort:containerPort) +- (use 'docker port' to see the actual mapping) +- -link="" : Add link to another container (name:alias) ++ -P=false : Publish all exposed ports to the host interfaces ++ -p=[] : Publish a container's port to the host (format: ++ ip:hostPort:containerPort | ip::containerPort | ++ hostPort:containerPort) ++ (use 'docker port' to see the actual mapping) ++ --link="" : Add link to another container (name:alias) + + As mentioned previously, `EXPOSE` (and +-`-expose`) make a port available **in** a container ++`--expose`) make a port available **in** a container + for incoming connections. The port number on the inside of the container + (where the service listens) does not need to be the same number as the + port exposed on the outside of the container (where clients connect), so +@@ -315,11 +316,11 @@ inside the container you might have an HTTP service listening on port 80 + might be 42800. + + To help a new client container reach the server container’s internal +-port operator `-expose`‘d by the operator or ++port operator `--expose`‘d by the operator or + `EXPOSE`‘d by the developer, the operator has three + choices: start the server container with `-P` or + `-p,` or start the client container with +-`-link`. ++`--link`. + + If the operator uses `-P` or `-p`{.docutils + .literal} then Docker will make the exposed port accessible on the host +@@ -327,20 +328,20 @@ and the ports will be available to any client that can reach the host. + To find the map between the host ports and the exposed ports, use + `docker port`) + +-If the operator uses `-link` when starting the new ++If the operator uses `--link` when starting the new + client container, then the client container can access the exposed port + via a private networking interface. Docker will set some environment + variables in the client container to help indicate which interface and + port to use. + +-### ENV (Environment Variables) ++### [ENV (Environment Variables)](#id19) + + The operator can **set any environment variable** in the container by + using one or more `-e` flags, even overriding those + already defined by the developer with a Dockefile `ENV`{.docutils + .literal}: + +- $ docker run -e "deep=purple" -rm ubuntu /bin/bash -c export ++ $ docker run -e "deep=purple" --rm ubuntu /bin/bash -c export + declare -x HOME="/" + declare -x HOSTNAME="85bc26a0e200" + declare -x OLDPWD +@@ -353,13 +354,13 @@ already defined by the developer with a Dockefile `ENV`{.docutils + Similarly the operator can set the **hostname** with `-h`{.docutils + .literal}. + +-`-link name:alias` also sets environment variables, ++`--link name:alias` also sets environment variables, + using the *alias* string to define environment variables within the + container that give the IP and PORT information for connecting to the + service container. Let’s imagine we have a container running Redis: + + # Start the service container, named redis-name +- $ docker run -d -name redis-name dockerfiles/redis ++ $ docker run -d --name redis-name dockerfiles/redis + 4241164edf6f5aca5b0e9e4c9eccd899b0b8080c64c0cd26efe02166c73208f3 + + # The redis-name container exposed port 6379 +@@ -372,10 +373,10 @@ service container. Let’s imagine we have a container running Redis: + 2014/01/25 00:55:38 Error: No public port '6379' published for 4241164edf6f + + Yet we can get information about the Redis container’s exposed ports +-with `-link`. Choose an alias that will form a valid +-environment variable! ++with `--link`. Choose an alias that will form a ++valid environment variable! + +- $ docker run -rm -link redis-name:redis_alias -entrypoint /bin/bash dockerfiles/redis -c export ++ $ docker run --rm --link redis-name:redis_alias --entrypoint /bin/bash dockerfiles/redis -c export + declare -x HOME="/" + declare -x HOSTNAME="acda7f7b1cdc" + declare -x OLDPWD +@@ -393,14 +394,14 @@ environment variable! + And we can use that information to connect from another container as a + client: + +- $ docker run -i -t -rm -link redis-name:redis_alias -entrypoint /bin/bash dockerfiles/redis -c '/redis-stable/src/redis-cli -h $REDIS_ALIAS_PORT_6379_TCP_ADDR -p $REDIS_ALIAS_PORT_6379_TCP_PORT' ++ $ docker run -i -t --rm --link redis-name:redis_alias --entrypoint /bin/bash dockerfiles/redis -c '/redis-stable/src/redis-cli -h $REDIS_ALIAS_PORT_6379_TCP_ADDR -p $REDIS_ALIAS_PORT_6379_TCP_PORT' + 172.17.0.32:6379> + +-### VOLUME (Shared Filesystems) ++### [VOLUME (Shared Filesystems)](#id20) + + -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. + If "container-dir" is missing, then docker creates a new volume. +- -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 section [*Share Directories via +@@ -409,7 +410,7 @@ 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 volume mounted on the host). + +-### USER ++### [USER](#id21) + + The default user within a container is `root` (id = + 0), but if the developer created additional users, those are accessible +@@ -419,7 +420,7 @@ override it + + -u="": Username or UID + +-### WORKDIR ++### [WORKDIR](#id22) + + The default working directory for running binaries within a container is + the root directory (`/`), but the developer can set +diff --git a/docs/sources/search.md b/docs/sources/search.md +index 0e2e13f..0296d50 100644 +--- a/docs/sources/search.md ++++ b/docs/sources/search.md +@@ -1,8 +1,7 @@ +-# Search + +-*Please activate JavaScript to enable the search functionality.* ++# Search {#search-documentation} + +-## How To Search ++Please activate JavaScript to enable the search functionality. + + From here you can search these documents. Enter your search words into + the box below and click "search". Note that the search function will +diff --git a/docs/sources/terms.md b/docs/sources/terms.md +index 59579d9..5152876 100644 +--- a/docs/sources/terms.md ++++ b/docs/sources/terms.md +@@ -1,13 +1,14 @@ ++ + # Glossary + +-*Definitions of terms used in Docker documentation.* ++Definitions of terms used in Docker documentation. + +-## Contents: ++Contents: + +-- [File System](filesystem/) +-- [Layers](layer/) +-- [Image](image/) +-- [Container](container/) +-- [Registry](registry/) +-- [Repository](repository/) ++- [File System](filesystem/) ++- [Layers](layer/) ++- [Image](image/) ++- [Container](container/) ++- [Registry](registry/) ++- [Repository](repository/) + +diff --git a/docs/sources/terms/container.md b/docs/sources/terms/container.md +index bc493d4..6fbf952 100644 +--- a/docs/sources/terms/container.md ++++ b/docs/sources/terms/container.md +@@ -4,8 +4,6 @@ page_keywords: containers, lxc, concepts, explanation, image, container + + # Container + +-## Introduction +- + ![](../../_images/docker-filesystems-busyboxrw.png) + + Once you start a process in Docker from an +diff --git a/docs/sources/terms/filesystem.md b/docs/sources/terms/filesystem.md +index 2038d00..8fbd977 100644 +--- a/docs/sources/terms/filesystem.md ++++ b/docs/sources/terms/filesystem.md +@@ -4,8 +4,6 @@ page_keywords: containers, files, linux + + # File System + +-## Introduction +- + ![](../../_images/docker-filesystems-generic.png) + + In order for a Linux system to run, it typically needs two [file +diff --git a/docs/sources/terms/image.md b/docs/sources/terms/image.md +index 721d4c9..98914dd 100644 +--- a/docs/sources/terms/image.md ++++ b/docs/sources/terms/image.md +@@ -4,8 +4,6 @@ page_keywords: containers, lxc, concepts, explanation, image, container + + # Image + +-## Introduction +- + ![](../../_images/docker-filesystems-debian.png) + + In Docker terminology, a read-only [*Layer*](../layer/#layer-def) is +diff --git a/docs/sources/terms/layer.md b/docs/sources/terms/layer.md +index 7665467..6949d5c 100644 +--- a/docs/sources/terms/layer.md ++++ b/docs/sources/terms/layer.md +@@ -4,8 +4,6 @@ page_keywords: containers, lxc, concepts, explanation, image, container + + # Layers + +-## Introduction +- + In a traditional Linux boot, the kernel first mounts the root [*File + System*](../filesystem/#filesystem-def) as read-only, checks its + integrity, and then switches the whole rootfs volume to read-write mode. +diff --git a/docs/sources/terms/registry.md b/docs/sources/terms/registry.md +index 0d5af2c..53c0a24 100644 +--- a/docs/sources/terms/registry.md ++++ b/docs/sources/terms/registry.md +@@ -4,8 +4,6 @@ page_keywords: containers, lxc, concepts, explanation, image, repository, contai + + # Registry + +-## Introduction +- + A Registry is a hosted service containing + [*repositories*](../repository/#repository-def) of + [*images*](../image/#image-def) which responds to the Registry API. +@@ -14,7 +12,5 @@ The default registry can be accessed using a browser at + [http://images.docker.io](http://images.docker.io) or using the + `sudo docker search` command. + +-## Further Reading +- + For more information see [*Working with + Repositories*](../../use/workingwithrepository/#working-with-the-repository) +diff --git a/docs/sources/terms/repository.md b/docs/sources/terms/repository.md +index e3332e4..8868440 100644 +--- a/docs/sources/terms/repository.md ++++ b/docs/sources/terms/repository.md +@@ -4,8 +4,6 @@ page_keywords: containers, lxc, concepts, explanation, image, repository, contai + + # Repository + +-## Introduction +- + A repository is a set of images either on your local Docker server, or + shared, by pushing it to a [*Registry*](../registry/#registry-def) + server. +diff --git a/docs/sources/toctree.md b/docs/sources/toctree.md +index 259a231..b268e90 100644 +--- a/docs/sources/toctree.md ++++ b/docs/sources/toctree.md +@@ -1,14 +1,18 @@ ++page_title: Documentation ++page_description: -- todo: change me ++page_keywords: todo, docker, documentation, installation, usage, examples, contributing, faq, command line, concepts ++ + # Documentation + +-## This documentation has the following resources: +- +-- [Introduction](../) +-- [Installation](../installation/) +-- [Use](../use/) +-- [Examples](../examples/) +-- [Reference Manual](../reference/) +-- [Contributing](../contributing/) +-- [Glossary](../terms/) +-- [Articles](../articles/) +-- [FAQ](../faq/) ++This documentation has the following resources: ++ ++- [Introduction](../) ++- [Installation](../installation/) ++- [Use](../use/) ++- [Examples](../examples/) ++- [Reference Manual](../reference/) ++- [Contributing](../contributing/) ++- [Glossary](../terms/) ++- [Articles](../articles/) ++- [FAQ](../faq/) + +diff --git a/docs/sources/use.md b/docs/sources/use.md +index ce4a510..00077a5 100644 +--- a/docs/sources/use.md ++++ b/docs/sources/use.md +@@ -1,13 +1,16 @@ ++ + # Use + +-## Contents: +- +-- [First steps with Docker](basics/) +-- [Share Images via Repositories](workingwithrepository/) +-- [Redirect Ports](port_redirection/) +-- [Configure Networking](networking/) +-- [Automatically Start Containers](host_integration/) +-- [Share Directories via Volumes](working_with_volumes/) +-- [Link Containers](working_with_links_names/) +-- [Link via an Ambassador Container](ambassador_pattern_linking/) +-- [Using Puppet](puppet/) +\ No newline at end of file ++Contents: ++ ++- [First steps with Docker](basics/) ++- [Share Images via Repositories](workingwithrepository/) ++- [Redirect Ports](port_redirection/) ++- [Configure Networking](networking/) ++- [Automatically Start Containers](host_integration/) ++- [Share Directories via Volumes](working_with_volumes/) ++- [Link Containers](working_with_links_names/) ++- [Link via an Ambassador Container](ambassador_pattern_linking/) ++- [Using Chef](chef/) ++- [Using Puppet](puppet/) ++ +diff --git a/docs/sources/use/ambassador_pattern_linking.md b/docs/sources/use/ambassador_pattern_linking.md +index b5df7f8..f7704a5 100644 +--- a/docs/sources/use/ambassador_pattern_linking.md ++++ b/docs/sources/use/ambassador_pattern_linking.md +@@ -4,8 +4,6 @@ page_keywords: Examples, Usage, links, docker, documentation, examples, names, n + + # Link via an Ambassador Container + +-## Introduction +- + Rather than hardcoding network links between a service consumer and + provider, Docker encourages service portability. + +@@ -38,24 +36,24 @@ link wiring is controlled entirely from the `docker run`{.docutils + + Start actual redis server on one Docker host + +- big-server $ docker run -d -name redis crosbymichael/redis ++ big-server $ docker run -d --name redis crosbymichael/redis + + Then add an ambassador linked to the redis server, mapping a port to the + outside world + +- big-server $ docker run -d -link redis:redis -name redis_ambassador -p 6379:6379 svendowideit/ambassador ++ big-server $ docker run -d --link redis:redis --name redis_ambassador -p 6379:6379 svendowideit/ambassador + + On the other host, you can set up another ambassador setting environment + variables for each remote port we want to proxy to the + `big-server` + +- client-server $ docker run -d -name redis_ambassador -expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador ++ client-server $ docker run -d --name redis_ambassador --expose 6379 -e REDIS_PORT_6379_TCP=tcp://192.168.1.52:6379 svendowideit/ambassador + + Then on the `client-server` host, you can use a + redis client container to talk to the remote redis server, just by + linking to the local redis ambassador. + +- client-server $ docker run -i -t -rm -link redis_ambassador:redis relateiq/redis-cli ++ client-server $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli + redis 172.17.0.160:6379> ping + PONG + +@@ -68,19 +66,19 @@ The following example shows what the `svendowideit/ambassador`{.docutils + On the docker host (192.168.1.52) that redis will run on: + + # start actual redis server +- $ docker run -d -name redis crosbymichael/redis ++ $ docker run -d --name redis crosbymichael/redis + + # get a redis-cli container for connection testing + $ docker pull relateiq/redis-cli + + # test the redis server by talking to it directly +- $ docker run -t -i -rm -link redis:redis relateiq/redis-cli ++ $ docker run -t -i --rm --link redis:redis relateiq/redis-cli + redis 172.17.0.136:6379> ping + PONG + ^D + + # add redis ambassador +- $ docker run -t -i -link redis:redis -name redis_ambassador -p 6379:6379 busybox sh ++ $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 busybox sh + + in the redis\_ambassador container, you can see the linked redis + containers’s env +@@ -104,7 +102,7 @@ to the world (via the -p 6379:6379 port mapping) + + $ docker rm redis_ambassador + $ sudo ./contrib/mkimage-unittest.sh +- $ docker run -t -i -link redis:redis -name redis_ambassador -p 6379:6379 docker-ut sh ++ $ docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 docker-ut sh + + $ socat TCP4-LISTEN:6379,fork,reuseaddr TCP4:172.17.0.136:6379 + +@@ -113,14 +111,14 @@ then ping the redis server via the ambassador + Now goto a different server + + $ sudo ./contrib/mkimage-unittest.sh +- $ docker run -t -i -expose 6379 -name redis_ambassador docker-ut sh ++ $ docker run -t -i --expose 6379 --name redis_ambassador docker-ut sh + + $ socat TCP4-LISTEN:6379,fork,reuseaddr TCP4:192.168.1.52:6379 + + and get the redis-cli image so we can talk over the ambassador bridge + + $ docker pull relateiq/redis-cli +- $ docker run -i -t -rm -link redis_ambassador:redis relateiq/redis-cli ++ $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli + redis 172.17.0.160:6379> ping + PONG + +@@ -133,7 +131,7 @@ out the (possibly multiple) link environment variables to set up the + port forwarding. On the remote host, you need to set the variable using + the `-e` command line option. + +-`-expose 1234 -e REDIS_PORT_1234_TCP=tcp://192.168.1.52:6379`{.docutils ++`--expose 1234 -e REDIS_PORT_1234_TCP=tcp://192.168.1.52:6379`{.docutils + .literal} will forward the local `1234` port to the + remote IP and port - in this case `192.168.1.52:6379`{.docutils + .literal}. +@@ -146,12 +144,12 @@ remote IP and port - in this case `192.168.1.52:6379`{.docutils + # docker build -t SvenDowideit/ambassador . + # docker tag SvenDowideit/ambassador ambassador + # then to run it (on the host that has the real backend on it) +- # docker run -t -i -link redis:redis -name redis_ambassador -p 6379:6379 ambassador ++ # docker run -t -i --link redis:redis --name redis_ambassador -p 6379:6379 ambassador + # on the remote host, you can set up another ambassador +- # docker run -t -i -name redis_ambassador -expose 6379 sh ++ # docker run -t -i --name redis_ambassador --expose 6379 sh + + FROM docker-ut + MAINTAINER SvenDowideit@home.org.au + + +- CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \&/' | sh && top +\ No newline at end of file ++ CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \&/' | sh && top +diff --git a/docs/sources/use/basics.md b/docs/sources/use/basics.md +index 1b10335..0abc8e7 100644 +--- a/docs/sources/use/basics.md ++++ b/docs/sources/use/basics.md +@@ -37,7 +37,10 @@ hash `539c0211cd76: Download complete` which is the + short form of the image ID. These short image IDs are the first 12 + characters of the full image ID - which can be found using + `docker inspect` or +-`docker images -notrunc=true` ++`docker images --no-trunc=true` ++ ++**If you’re using OS X** then you shouldn’t use `sudo`{.docutils ++.literal} + + ## Running an interactive shell + +diff --git a/docs/sources/use/host_integration.md b/docs/sources/use/host_integration.md +index 50eae8b..a7dba9b 100644 +--- a/docs/sources/use/host_integration.md ++++ b/docs/sources/use/host_integration.md +@@ -5,7 +5,8 @@ page_keywords: systemd, upstart, supervisor, docker, documentation, host integra + # Automatically Start Containers + + You can use your Docker containers with process managers like +-`upstart`, `systemd`{.docutils .literal} and `supervisor`. ++`upstart`, `systemd`{.docutils .literal} and ++`supervisor`. + + ## Introduction + +@@ -15,21 +16,22 @@ docker will not automatically restart your containers when the host is + restarted. + + When you have finished setting up your image and are happy with your +-running container, you may want to use a process manager to manage it. ++running container, you can then attach a process manager to manage it. + When your run `docker start -a` docker will +-automatically attach to the process and forward all signals so that the +-process manager can detect when a container stops and correctly restart +-it. ++automatically attach to the running container, or start it if needed and ++forward all signals so that the process manager can detect when a ++container stops and correctly restart it. + + Here are a few sample scripts for systemd and upstart to integrate with + docker. + + ## Sample Upstart Script + +-In this example we’ve already created a container to run Redis with an +-id of 0a7e070b698b. To create an upstart script for our container, we +-create a file named `/etc/init/redis.conf` and place +-the following into it: ++In this example we’ve already created a container to run Redis with ++`--name redis_server`. To create an upstart script ++for our container, we create a file named ++`/etc/init/redis.conf` and place the following into ++it: + + description "Redis container" + author "Me" +@@ -42,7 +44,7 @@ the following into it: + while [ ! -e $FILE ] ; do + inotifywait -t 2 -e create $(dirname $FILE) + done +- /usr/bin/docker start -a 0a7e070b698b ++ /usr/bin/docker start -a redis_server + end script + + Next, we have to configure docker so that it’s run with the option +@@ -59,8 +61,8 @@ Next, we have to configure docker so that it’s run with the option + + [Service] + Restart=always +- ExecStart=/usr/bin/docker start -a 0a7e070b698b +- ExecStop=/usr/bin/docker stop -t 2 0a7e070b698b ++ ExecStart=/usr/bin/docker start -a redis_server ++ ExecStop=/usr/bin/docker stop -t 2 redis_server + + [Install] + WantedBy=local.target +diff --git a/docs/sources/use/networking.md b/docs/sources/use/networking.md +index e4cc5c5..56a9885 100644 +--- a/docs/sources/use/networking.md ++++ b/docs/sources/use/networking.md +@@ -4,16 +4,15 @@ page_keywords: network, networking, bridge, docker, documentation + + # Configure Networking + +-## Introduction +- + Docker uses Linux bridge capabilities to provide network connectivity to + containers. The `docker0` bridge interface is + managed by Docker for this purpose. When the Docker daemon starts it : + +-- creates the `docker0` bridge if not present +-- searches for an IP address range which doesn’t overlap with an existing route +-- picks an IP in the selected range +-- assigns this IP to the `docker0` bridge ++- creates the `docker0` bridge if not present ++- searches for an IP address range which doesn’t overlap with an ++ existing route ++- picks an IP in the selected range ++- assigns this IP to the `docker0` bridge + + + +@@ -113,9 +112,9 @@ The value of the Docker daemon’s `icc` parameter + determines whether containers can communicate with each other over the + bridge network. + +-- The default, `-icc=true` allows containers to ++- The default, `--icc=true` allows containers to + communicate with each other. +-- `-icc=false` means containers are isolated from ++- `--icc=false` means containers are isolated from + each other. + + Docker uses `iptables` under the hood to either +@@ -137,6 +136,6 @@ ip link command) and the namespaces infrastructure. + + ## I want more + +-Jérôme Petazzoni has create `pipework` to connect ++Jérôme Petazzoni has created `pipework` to connect + together containers in arbitrarily complex scenarios : + [https://github.com/jpetazzo/pipework](https://github.com/jpetazzo/pipework) +diff --git a/docs/sources/use/port_redirection.md b/docs/sources/use/port_redirection.md +index 6970d0d..1c1b676 100644 +--- a/docs/sources/use/port_redirection.md ++++ b/docs/sources/use/port_redirection.md +@@ -4,8 +4,6 @@ page_keywords: Usage, basic port, docker, documentation, examples + + # Redirect Ports + +-## Introduction +- + Interacting with a service is commonly done through a connection to a + port. When this service runs inside a container, one can connect to the + port after finding the IP address of the container as follows: +@@ -74,7 +72,7 @@ port on the host machine bound to a given container port. It is useful + when using dynamically allocated ports: + + # Bind to a dynamically allocated port +- docker run -p 127.0.0.1::8080 -name dyn-bound ++ docker run -p 127.0.0.1::8080 --name dyn-bound + + # Lookup the actual port + docker port dyn-bound 8080 +@@ -105,18 +103,18 @@ started. + + Here is a full example. On `server`, the port of + interest is exposed. The exposure is done either through the +-`-expose` parameter to the `docker run`{.docutils ++`--expose` parameter to the `docker run`{.docutils + .literal} command, or the `EXPOSE` build command in + a Dockerfile: + + # Expose port 80 +- docker run -expose 80 -name server ++ docker run --expose 80 --name server + + The `client` then links to the `server`{.docutils + .literal}: + + # Link +- docker run -name client -link server:linked-server ++ docker run --name client --link server:linked-server + + `client` locally refers to `server`{.docutils + .literal} as `linked-server`. The following +@@ -137,4 +135,4 @@ port 80 of `server` and that `server`{.docutils + .literal} is accessible at the IP address 172.17.0.8 + + Note: Using the `-p` parameter also exposes the +-port.. ++port. +diff --git a/docs/sources/use/puppet.md b/docs/sources/use/puppet.md +index 55f16dd..b00346c 100644 +--- a/docs/sources/use/puppet.md ++++ b/docs/sources/use/puppet.md +@@ -4,10 +4,12 @@ page_keywords: puppet, installation, usage, docker, documentation + + # Using Puppet + +-> *Note:* Please note this is a community contributed installation path. The only +-> ‘official’ installation is using the +-> [*Ubuntu*](../../installation/ubuntulinux/#ubuntu-linux) installation +-> path. This version may sometimes be out of date. ++Note ++ ++Please note this is a community contributed installation path. The only ++‘official’ installation is using the ++[*Ubuntu*](../../installation/ubuntulinux/#ubuntu-linux) installation ++path. This version may sometimes be out of date. + + ## Requirements + +diff --git a/docs/sources/use/working_with_links_names.md b/docs/sources/use/working_with_links_names.md +index 3a12284..b41be0d 100644 +--- a/docs/sources/use/working_with_links_names.md ++++ b/docs/sources/use/working_with_links_names.md +@@ -4,8 +4,6 @@ page_keywords: Examples, Usage, links, linking, docker, documentation, examples, + + # Link Containers + +-## Introduction +- + From version 0.6.5 you are now able to `name` a + container and `link` it to another container by + referring to its name. This will create a parent -\> child relationship +@@ -15,12 +13,13 @@ where the parent container can see selected information about its child. + + New in version v0.6.5. + +-You can now name your container by using the `-name` +-flag. If no name is provided, Docker will automatically generate a name. +-You can see this name using the `docker ps` command. ++You can now name your container by using the `--name`{.docutils ++.literal} flag. If no name is provided, Docker will automatically ++generate a name. You can see this name using the `docker ps`{.docutils ++.literal} command. + +- # format is "sudo docker run -name " +- $ sudo docker run -name test ubuntu /bin/bash ++ # format is "sudo docker run --name " ++ $ sudo docker run --name test ubuntu /bin/bash + + # the flag "-a" Show all containers. Only running containers are shown by default. + $ sudo docker ps -a +@@ -32,9 +31,9 @@ You can see this name using the `docker ps` command. + New in version v0.6.5. + + Links allow containers to discover and securely communicate with each +-other by using the flag `-link name:alias`. ++other by using the flag `--link name:alias`. + Inter-container communication can be disabled with the daemon flag +-`-icc=false`. With this flag set to ++`--icc=false`. With this flag set to + `false`, Container A cannot access Container B + unless explicitly allowed via a link. This is a huge win for securing + your containers. When two containers are linked together Docker creates +@@ -52,9 +51,9 @@ communication is set to false. + For example, there is an image called `crosbymichael/redis`{.docutils + .literal} that exposes the port 6379 and starts the Redis server. Let’s + name the container as `redis` based on that image +-and run it as daemon. ++and run it as a daemon. + +- $ sudo docker run -d -name redis crosbymichael/redis ++ $ sudo docker run -d --name redis crosbymichael/redis + + We can issue all the commands that you would expect using the name + `redis`; start, stop, attach, using the name for our +@@ -67,9 +66,9 @@ our Redis server we did not use the `-p` flag to + publish the Redis port to the host system. Redis exposed port 6379 and + this is all we need to establish a link. + +- $ sudo docker run -t -i -link redis:db -name webapp ubuntu bash ++ $ sudo docker run -t -i --link redis:db --name webapp ubuntu bash + +-When you specified `-link redis:db` you are telling ++When you specified `--link redis:db` you are telling + Docker to link the container named `redis` into this + new container with the alias `db`. Environment + variables are prefixed with the alias so that the parent container can +@@ -101,8 +100,18 @@ Accessing the network information along with the environment of the + child container allows us to easily connect to the Redis service on the + specific IP and port in the environment. + ++Note ++ ++These Environment variables are only set for the first process in the ++container. Similarly, some daemons (such as `sshd`) ++will scrub them when spawning shells for connection. ++ ++You can work around this by storing the initial `env`{.docutils ++.literal} in a file, or looking at `/proc/1/environ`{.docutils ++.literal}. ++ + Running `docker ps` shows the 2 containers, and the +-`webapp/db` alias name for the redis container. ++`webapp/db` alias name for the Redis container. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES +diff --git a/docs/sources/use/working_with_volumes.md b/docs/sources/use/working_with_volumes.md +index 6cf57ee..542c715 100644 +--- a/docs/sources/use/working_with_volumes.md ++++ b/docs/sources/use/working_with_volumes.md +@@ -4,27 +4,24 @@ page_keywords: Examples, Usage, volume, docker, documentation, examples + + # Share Directories via Volumes + +-## Introduction +- + A *data volume* is a specially-designated directory within one or more + containers that bypasses the [*Union File + System*](../../terms/layer/#ufs-def) to provide several useful features + for persistent or shared data: + +-- **Data volumes can be shared and reused between containers:** +- This is the feature that makes data volumes so powerful. You can +- use it for anything from hot database upgrades to custom backup or +- replication tools. See the example below. +-- **Changes to a data volume are made directly:** +- Without the overhead of a copy-on-write mechanism. This is good for +- very large files. +-- **Changes to a data volume will not be included at the next commit:** +- Because they are not recorded as regular filesystem changes in the +- top layer of the [*Union File System*](../../terms/layer/#ufs-def) +-- **Volumes persist until no containers use them:** +- 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 +- against accidental removal via `docker rm`. ++- **Data volumes can be shared and reused between containers.** This ++ is the feature that makes data volumes so powerful. You can use it ++ for anything from hot database upgrades to custom backup or ++ replication tools. See the example below. ++- **Changes to a data volume are made directly**, without the overhead ++ of a copy-on-write mechanism. This is good for very large files. ++- **Changes to a data volume will not be included at the next commit** ++ because they are not recorded as regular filesystem changes in the ++ top layer of the [*Union File System*](../../terms/layer/#ufs-def) ++- **Volumes persist until no containers use them** 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 ++ against accidental removal via `docker rm`. + + Each container can have zero or more data volumes. + +@@ -43,7 +40,7 @@ container with two new volumes: + This command will create the new container with two new volumes that + exits instantly (`true` is pretty much the smallest, + simplest program that you can run). Once created you can mount its +-volumes in any other container using the `-volumes-from`{.docutils ++volumes in any other container using the `--volumes-from`{.docutils + .literal} option; irrespective of whether the container is running or + not. + +@@ -51,7 +48,7 @@ Or, you can use the VOLUME instruction in a Dockerfile to add one or + more new volumes to any container created from that image: + + # BUILD-USING: docker build -t data . +- # RUN-USING: docker run -name DATA data ++ # RUN-USING: docker run --name DATA data + FROM busybox + VOLUME ["/var/volume1", "/var/volume2"] + CMD ["/bin/true"] +@@ -66,20 +63,20 @@ it. + Create a named container with volumes to share (`/var/volume1`{.docutils + .literal} and `/var/volume2`): + +- $ docker run -v /var/volume1 -v /var/volume2 -name DATA busybox true ++ $ docker run -v /var/volume1 -v /var/volume2 --name DATA busybox true + + Then mount those data volumes into your application containers: + +- $ docker run -t -i -rm -volumes-from DATA -name client1 ubuntu bash ++ $ docker run -t -i --rm --volumes-from DATA --name client1 ubuntu bash + +-You can use multiple `-volumes-from` parameters to ++You can use multiple `--volumes-from` parameters to + bring together multiple data volumes from multiple containers. + + Interestingly, you can mount the volumes that came from the + `DATA` container in yet another container via the + `client1` middleman container: + +- $ docker run -t -i -rm -volumes-from client1 -name client2 ubuntu bash ++ $ docker run -t -i --rm --volumes-from client1 --name client2 ubuntu bash + + This allows you to abstract the actual data source from users of that + data, similar to +@@ -136,9 +133,9 @@ because they are external to images. Instead you can use + `--volumes-from` to start a new container that can + access the data-container’s volume. For example: + +- $ sudo docker run -rm --volumes-from DATA -v $(pwd):/backup busybox tar cvf /backup/backup.tar /data ++ $ sudo docker run --rm --volumes-from DATA -v $(pwd):/backup busybox tar cvf /backup/backup.tar /data + +-- `-rm` - remove the container when it exits ++- `--rm` - remove the container when it exits + - `--volumes-from DATA` - attach to the volumes + shared by the `DATA` container + - `-v $(pwd):/backup` - bind mount the current +@@ -153,13 +150,13 @@ Then to restore to the same container, or another that you’ve made + elsewhere: + + # create a new data container +- $ sudo docker run -v /data -name DATA2 busybox true ++ $ sudo docker run -v /data --name DATA2 busybox true + # untar the backup files into the new container's data volume +- $ sudo docker run -rm --volumes-from DATA2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar ++ $ sudo docker run --rm --volumes-from DATA2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar + data/ + data/sven.txt + # compare to the original container +- $ sudo docker run -rm --volumes-from DATA -v `pwd`:/backup busybox ls /data ++ $ sudo docker run --rm --volumes-from DATA -v `pwd`:/backup busybox ls /data + sven.txt + + You can use the basic techniques above to automate backup, migration and +diff --git a/docs/sources/use/workingwithrepository.md b/docs/sources/use/workingwithrepository.md +index bd0e274..1cfec63 100644 +--- a/docs/sources/use/workingwithrepository.md ++++ b/docs/sources/use/workingwithrepository.md +@@ -4,8 +4,6 @@ page_keywords: repo, repositories, usage, pull image, push image, image, documen + + # Share Images via Repositories + +-## Introduction +- + A *repository* is a shareable collection of tagged + [*images*](../../terms/image/#image-def) that together create the file + systems for containers. The repository’s name is a label that indicates +@@ -27,14 +25,12 @@ repositories. You can host your own Registry too! Docker acts as a + client for these services via `docker search, pull, login`{.docutils + .literal} and `push`. + +-## Repositories +- +-### Local Repositories ++## Local Repositories + + Docker images which have been created and labeled on your local Docker + server need to be pushed to a Public or Private registry to be shared. + +-### Public Repositories ++## Public Repositories + + There are two types of public repositories: *top-level* repositories + which are controlled by the Docker team, and *user* repositories created +@@ -67,7 +63,7 @@ user name or description: + + Search the docker index for images + +- -notrunc=false: Don't truncate output ++ --no-trunc=false: Don't truncate output + $ sudo docker search centos + Found 25 results matching your query ("centos") + NAME DESCRIPTION +@@ -204,7 +200,7 @@ See also + [Docker Blog: How to use your own + registry](http://blog.docker.io/2013/07/how-to-use-your-own-registry/) + +-## Authentication File ++## Authentication file + + The authentication is stored in a json file, `.dockercfg`{.docutils + .literal} located in your home directory. It supports multiple registry diff --git a/docs/release.sh b/docs/release.sh new file mode 100755 index 0000000000..323887f594 --- /dev/null +++ b/docs/release.sh @@ -0,0 +1,63 @@ +#!/usr/bin/env bash +set -e + +set -o pipefail + +usage() { + cat >&2 <<'EOF' +To publish the Docker documentation you need to set your access_key and secret_key in the docs/awsconfig file +(with the keys in a [profile $AWS_S3_BUCKET] section - so you can have more than one set of keys in your file) +and set the AWS_S3_BUCKET env var to the name of your bucket. + +make AWS_S3_BUCKET=beta-docs.docker.io docs-release + +will then push the documentation site to your s3 bucket. +EOF + exit 1 +} + +[ "$AWS_S3_BUCKET" ] || usage + +#VERSION=$(cat VERSION) +BUCKET=$AWS_S3_BUCKET + +export AWS_CONFIG_FILE=$(pwd)/awsconfig +[ -e "$AWS_CONFIG_FILE" ] || usage +export AWS_DEFAULT_PROFILE=$BUCKET + +echo "cfg file: $AWS_CONFIG_FILE ; profile: $AWS_DEFAULT_PROFILE" + +setup_s3() { + echo "Create $BUCKET" + # Try creating the bucket. Ignore errors (it might already exist). + aws s3 mb s3://$BUCKET 2>/dev/null || true + # Check access to the bucket. + echo "test $BUCKET exists" + aws s3 ls s3://$BUCKET + # Make the bucket accessible through website endpoints. + echo "make $BUCKET accessible as a website" + #aws s3 website s3://$BUCKET --index-document index.html --error-document jsearch/index.html + s3conf=$(cat s3_website.json) + aws s3api put-bucket-website --bucket $BUCKET --website-configuration "$s3conf" +} + +build_current_documentation() { + mkdocs build +} + +upload_current_documentation() { + src=site/ + dst=s3://$BUCKET + + echo + echo "Uploading $src" + echo " to $dst" + echo + #s3cmd --recursive --follow-symlinks --preserve --acl-public sync "$src" "$dst" + aws s3 sync --acl public-read --exclude "*.rej" --exclude "*.rst" --exclude "*.orig" --exclude "*.py" "$src" "$dst" +} + +setup_s3 +build_current_documentation +upload_current_documentation + diff --git a/docs/s3_website.json b/docs/s3_website.json new file mode 100644 index 0000000000..bb68b6652c --- /dev/null +++ b/docs/s3_website.json @@ -0,0 +1,15 @@ +{ + "ErrorDocument": { + "Key": "jsearch/index.html" + }, + "IndexDocument": { + "Suffix": "index.html" + }, + "RoutingRules": [ + { "Condition": { "KeyPrefixEquals": "en/latest/" }, "Redirect": { "ReplaceKeyPrefixWith": "" } }, + { "Condition": { "KeyPrefixEquals": "en/master/" }, "Redirect": { "ReplaceKeyPrefixWith": "" } }, + { "Condition": { "KeyPrefixEquals": "en/v0.6.3/" }, "Redirect": { "ReplaceKeyPrefixWith": "" } }, + { "Condition": { "KeyPrefixEquals": "jsearch/index.html" }, "Redirect": { "ReplaceKeyPrefixWith": "jsearch/" } } + ] +} + diff --git a/docs/sources/index.md b/docs/sources/index.md new file mode 100644 index 0000000000..6c789eae47 --- /dev/null +++ b/docs/sources/index.md @@ -0,0 +1,81 @@ +page_title: About Docker +page_description: Docker introduction home page +page_keywords: docker, introduction, documentation, about, technology, understanding, Dockerfile + +# About Docker + +*Secure And Portable Containers Made Easy* + +## Introduction + +[**Docker**](http://www.docker.io) is a container based virtualization +framework. Unlike traditional virtualization Docker is fast, lightweight +and easy to use. Docker allows you to create containers holding +all the dependencies for an application. Each container is kept isolated +from any other, and nothing gets shared. + +## Docker highlights + + - **Containers provide sand-boxing:** + Applications run securely without outside access. + - **Docker allows simple portability:** + Containers are directories, they can be zipped and transported. + - **It all works fast:** + Starting a container is a very fast single process. + - **Docker is easy on the system resources (unlike VMs):** + No more than what each application needs. + - **Agnostic in its _essence_:** + Free of framework, language or platform dependencies. + +And most importantly: + + - **Docker reduces complexity:** + Docker accepts commands *in plain English*, e.g. `docker run [..]`. + +## About this guide + +In this introduction we will take you on a tour and show you what +makes Docker tick. + +On the [**first page**](introduction/understanding-docker.md), which is +**_informative_**: + + - You will find information on Docker; + - And discover Docker's features. + - We will also compare Docker to virtual machines; + - And see some common use cases. + +> [Click here to go to Understanding Docker](introduction/understanding-docker.md). + +The [**second page**](introduction/technology.md) has **_technical_** information on: + + - The architecture of Docker; + - The underlying technology, and; + - *How* Docker works. + +> [Click here to go to Understanding the Technology](introduction/technology.md). + +On the [**third page**](introduction/working-with-docker.md) we get **_practical_**. +There you can: + + - Learn about Docker's components (i.e. Containers, Images and the + Dockerfile); + - And get started working with them straight away. + +> [Click here to go to Working with Docker](introduction/working-with-docker.md). + +Finally, on the [**fourth**](introduction/get-docker.md) page, we go **_hands on_** +and see: + + - The installation instructions, and; + - How Docker makes some hard problems much, much easier. + +> [Click here to go to Get Docker](introduction/get-docker.md). + +**Note**: We know how valuable your time is. Therefore, the +documentation is prepared in a way to allow anyone to start from any +section need. Although we strongly recommend that you visit +[Understanding Docker](introduction/understanding-docker.md) to see how Docker is +different, if you already have some knowledge and want to quickly get +started with Docker, don't hesitate to jump to [Working with +Docker](introduction/working-with-docker.md). diff --git a/docs/sources/index.rst b/docs/sources/index.rst deleted file mode 100644 index a89349b2bb..0000000000 --- a/docs/sources/index.rst +++ /dev/null @@ -1,29 +0,0 @@ -:title: Docker Documentation -:description: An overview of the Docker Documentation -:keywords: containers, lxc, concepts, explanation - -Introduction ------------- - -Docker is an open-source engine to easily create lightweight, portable, -self-sufficient containers from any application. The same container that a -developer builds and tests on a laptop can run at scale, in production, on -VMs, bare metal, OpenStack clusters, or any major infrastructure provider. - -Common use cases for Docker include: - -- Automating the packaging and deployment of web applications. -- Automated testing and continuous integration/deployment. -- Deploying and scaling databases and backend services in a service-oriented environment. -- Building custom PaaS environments, either from scratch or as an extension of off-the-shelf platforms like OpenShift or Cloud Foundry. - -Please note Docker is currently under heavy development. It should not be used in production (yet). - -For a high-level overview of Docker, please see the `Introduction -`_. When you're ready to start working with -Docker, we have a `quick start `_ -and a more in-depth guide to :ref:`ubuntu_linux` and other -:ref:`installation_list` paths including prebuilt binaries, -Rackspace and Amazon instances. - -Enough reading! :ref:`Try it out! ` diff --git a/docs/sources/index/docs.md b/docs/sources/index/docs.md new file mode 100644 index 0000000000..f4456981ee --- /dev/null +++ b/docs/sources/index/docs.md @@ -0,0 +1,236 @@ +page_title: The Documentation +page_description: The Docker Index help documentation +page_keywords: Docker, docker, index, accounts, plans, Dockerfile, Docker.io, docs, documentation + +# The Documentation + +## Docker IO and Docker Index Accounts + +You can `search` for Docker images and `pull` them from the [Docker Index] +(https://index.docker.io) without signing in or even having an account. However, +in order to `push` images, leave comments or to *star* a repository, you are going +to need a [Docker IO](https://www.docker.io) account. + +### Registration for a Docker IO Account + +You can get a Docker IO account by [signing up for one here] +(https://index.docker.io/account/signup/). A valid email address is required to +register, which you will need to verify for account activation. + +### Email activation process + +You need to have at least one verified email address to be able to use your +Docker IO account. If you can't find the validation email, you can request +another by visiting the [Resend Email Confirmation] +(https://index.docker.io/account/resend-email-confirmation/) page. + +### Password reset process + +If you can't access your account for some reason, you can reset your password +from the [*Password Reset*](https://www.docker.io/account/forgot-password/) +page. + +## Searching for repositories and images + +You can `search` for all the publicly available repositories and images using +Docker. If a repository is not public (i.e., private), it won't be listed on +the Index search results. To see repository statuses, you can look at your +[profile page](https://index.docker.io/account/). + +## Repositories + +### Stars + +Stars are a way to show that you like a repository. They are also an easy way +of bookmark your favorites. + +### Comments + +You can interact with other members of the Docker community and maintainers by +leaving comments on repositories. If you find any comments that are not +appropriate, you can flag them for the Index admins' review. + +### Private Docker Repositories + +To work with a private repository on the Docker Index, you will need to add one +via the [Add Repository](https://index.docker.io/account/repositories/add) link. +Once the private repository is created, you can `push` and `pull` images to and +from it using Docker. + +> *Note:* You need to be signed in and have access to work with a private +> repository. + +Private repositories are just like public ones. However, it isn't possible to +browse them or search their content on the public index. They do not get cached +the same way as a public repository either. + +It is possible to give access to a private repository to those whom you +designate (i.e., collaborators) from its settings page. + +From there, you can also switch repository status (*public* to *private*, or +viceversa). You will need to have an available private repository slot open +before you can do such a switch. If you don't have any, you can always upgrade +your [Docker Index plan](https://index.docker.io/plans/). + +### Collaborators and their role + +A collaborator is someone you want to give access to a private repository. Once +designated, they can `push` and `pull`. Although, they will not be allowed to +perform any administrative tasks such as deleting the repository or changing its +status from private to public. + +> **Note:** A collaborator can not add other collaborators. Only the owner of +> the repository has administrative access. + +### Webhooks + +You can configure webhooks on the repository settings page. A webhook is called +only after a successful `push` is made. The webhook calls are HTTP POST requests +with a JSON payload similar to the example shown below. + +> **Note:** For testing, you can try an HTTP request tool like +> [requestb.in](http://requestb.in/). + +*Example webhook JSON payload:* + + { + "push_data":{ + "pushed_at":1385141110, + "images":[ + "imagehash1", + "imagehash2", + "imagehash3" + ], + "pusher":"username" + }, + "repository":{ + "status":"Active", + "description":"my docker repo that does cool things", + "is_trusted":false, + "full_description":"This is my full description", + "repo_url":"https://index.docker.io/u/username/reponame/", + "owner":"username", + "is_official":false, + "is_private":false, + "name":"reponame", + "namespace":"username", + "star_count":1, + "comment_count":1, + "date_created":1370174400, + "dockerfile":"my full dockerfile is listed here", + "repo_name":"username/reponame" + } + } + +## Trusted Builds + +*Trusted Builds* is a special feature allowing you to specify a source +repository with a *Dockerfile* to be built by the Docker build clusters. The +system will clone your repository and build the Dockerfile using the repository +as the context. The resulting image will then be uploaded to the index and +marked as a `Trusted Build`. + +Trusted Builds have a number of advantages. For example, users of *your* Trusted +Build can be certain that the resulting image was built exactly how it claims +to be. + +Furthermore, the Dockerfile will be available to anyone browsing your repository +on the Index. Another advantage of the Trusted Builds feature is the automated +builds. This makes sure that your repository is always up to date. + +### Linking with a GitHub account + +In order to setup a Trusted Build, you need to first link your Docker Index +account with a GitHub one. This will allow the Docker Index to see your +repositories. + +> *Note:* We currently request access for *read* and *write* since the Index +> needs to setup a GitHub service hook. Although nothing else is done with +> your account, this is how GitHub manages permissions, sorry! + +### Creating a Trusted Build + +You can [create a Trusted Build](https://index.docker.io/builds/github/select/) +from any of your public GitHub repositories with a Dockerfile. + +> **Note:** We currently only support public repositories. To have more than +> one Docker image from the same GitHub repository, you will need to set up one +> Trusted Build per Dockerfile, each using a different image name. This rule +> applies to building multiple branches on the same GitHub repository as well. + +### GitHub organizations + +GitHub organizations appear once your membership to that organization is +made public on GitHub. To verify, you can look at the members tab for your +organization on GitHub. + +### GitHub service hooks + +You can follow the below steps to configure the GitHub service hooks for your +Trusted Build: + + + + + + + + + + + + + + + + + + + + + + +
StepScreenshotDescription
1.Login to Github.com, and visit your Repository page. Click on the repository "Settings" link. You will need admin rights to the repository in order to do this. So if you don't have admin rights, you will need to ask someone who does.
2.Service HooksClick on the "Service Hooks" link
3.Find the service hook labeled DockerFind the service hook labeled "Docker" and click on it.
4.Activate Service HooksClick on the "Active" checkbox and then the "Update settings" button, to save changes.
+ +### The Dockerfile and Trusted Builds + +During the build process, we copy the contents of your Dockerfile. We also +add it to the Docker Index for the Docker community to see on the repository +page. + +### README.md + +If you have a `README.md` file in your repository, we will use that as the +repository's full description. + +> **Warning:** If you change the full description after a build, it will be +> rewritten the next time the Trusted Build has been built. To make changes, +> modify the README.md from the Git repository. We will look for a README.md +> in the same directory as your Dockerfile. + +### Build triggers + +If you need another way to trigger your Trusted Builds outside of GitHub, you +can setup a build trigger. When you turn on the build trigger for a Trusted +Build, it will give you a URL to which you can send POST requests. This will +trigger the Trusted Build process, which is similar to GitHub webhooks. + +> **Note:** You can only trigger one build at a time and no more than one +> every five minutes. If you have a build already pending, or if you already +> recently submitted a build request, those requests *will be ignored*. +> You can find the logs of last 10 triggers on the settings page to verify +> if everything is working correctly. + +### Repository links + +Repository links are a way to associate one Trusted Build with another. If one +gets updated, linking system also triggers a build for the other Trusted Build. +This makes it easy to keep your Trusted Builds up to date. + +To add a link, go to the settings page of a Trusted Build and click on +*Repository Links*. Then enter the name of the repository that you want have +linked. + +> **Warning:** You can add more than one repository link, however, you should +> be very careful. Creating a two way relationship between Trusted Builds will +> cause a never ending build loop. \ No newline at end of file diff --git a/docs/sources/index/home.md b/docs/sources/index/home.md new file mode 100644 index 0000000000..1b03df4ab7 --- /dev/null +++ b/docs/sources/index/home.md @@ -0,0 +1,13 @@ +page_title: The Docker Index Help +page_description: The Docker Index help documentation home +page_keywords: Docker, docker, index, accounts, plans, Dockerfile, Docker.io, docs, documentation + +# The Docker Index Help + +## Introduction + +For your questions about the [Docker Index](https://index.docker.io) you can +use [this documentation](docs.md). + +If you can not find something you are looking for, please feel free to +[contact us](https://index.docker.io/help/support/). \ No newline at end of file diff --git a/docs/sources/index/index.md b/docs/sources/index/index.md new file mode 100644 index 0000000000..747b4ee491 --- /dev/null +++ b/docs/sources/index/index.md @@ -0,0 +1,15 @@ +title +: Documentation + +description +: -- todo: change me + +keywords +: todo, docker, documentation, basic, builder + +Use +=== + +Contents: + +{{ site_name }} diff --git a/docs/sources/installation/windows.rst b/docs/sources/installation/windows.rst old mode 100644 new mode 100755 index d00b012e6c..ceb29c8853 --- a/docs/sources/installation/windows.rst +++ b/docs/sources/installation/windows.rst @@ -4,8 +4,8 @@ .. _windows: -Windows -======= +Microsoft Windows +================= Docker can run on Windows using a virtualization platform like VirtualBox. A Linux distribution is run inside a virtual machine and that's where Docker will run. @@ -15,7 +15,7 @@ Installation .. include:: install_header.inc -1. Install virtualbox from https://www.virtualbox.org - or follow this `tutorial `_. +1. Install VirtualBox from https://www.virtualbox.org - or follow this `tutorial `_. 2. Download the latest boot2docker.iso from https://github.com/boot2docker/boot2docker/releases. diff --git a/docs/sources/introduction/get-docker.md b/docs/sources/introduction/get-docker.md new file mode 100644 index 0000000000..e0d6f16654 --- /dev/null +++ b/docs/sources/introduction/get-docker.md @@ -0,0 +1,77 @@ +page_title: Getting Docker +page_description: Getting Docker and installation tutorials +page_keywords: docker, introduction, documentation, about, technology, understanding, Dockerfile + +# Getting Docker + +*How to install Docker?* + +## Introductions + +Once you are comfortable with your level of knowledge of Docker, and +feel like actually trying the product, you can download and start using +it by following the links listed below. There, you will find +installation instructions, specifically tailored for your platform of choice. + +## Installation Instructions + +### Linux (Native) + + - **Arch Linux:** + [Installation on Arch Linux](../installation/archlinux.md) + - **Fedora:** + [Installation on Fedora](../installation/fedora.md) + - **FrugalWare:** + [Installation on FrugalWare](../installation/frugalware.md) + - **Gentoo:** + [Installation on Gentoo](../installation/gentoolinux.md) + - **Red Hat Enterprise Linux:** + [Installation on Red Hat Enterprise Linux](../installation/rhel.md) + - **Ubuntu:** + [Installation on Ubuntu](../installation/ubuntulinux.md) + - **openSUSE:** + [Installation on openSUSE](../installation/openSUSE.md) + +### Mac OS X (Using Boot2Docker) + +In order to work, Docker makes use of some Linux Kernel features which +are not supported by Mac OS X. To run Docker on OS X we install and run +a lightweight virtual machine and run Docker on that. + + - **Mac OS X :** + [Installation on Mac OS X](../installation/mac.md) + +### Windows (Using Boot2Docker) + +Docker can also run on Windows using a virtual machine. You then run +Linux and Docker inside that virtual machine. + + - **Windows:** + [Installation on Windows](../installation/windows.md) + +### Infrastructure-as-a-Service + + - **Amazon EC2:** + [Installation on Amazon EC2](../installation/amazon.md) + - **Google Cloud Platform:** + [Installation on Google Cloud Platform](../installation/google.md) + - **Rackspace Cloud:** + [Installation on Rackspace Cloud](../installation/rackspace.md) + +## Where to go from here + +### Understanding Docker + +Visit [Understanding Docker](understanding-docker.md) in our Getting Started manual. + +### Learn about parts of Docker and the underlying technology + +Visit [Understanding the Technology](technology.md) in our Getting Started manual. + +### Get practical and learn how to use Docker straight away + +Visit [Working with Docker](working-with-docker.md) in our Getting Started manual. + +### Get the whole story + +[https://www.docker.io/the_whole_story/](https://www.docker.io/the_whole_story/) diff --git a/docs/sources/introduction/technology.md b/docs/sources/introduction/technology.md new file mode 100644 index 0000000000..ba1e09f0d7 --- /dev/null +++ b/docs/sources/introduction/technology.md @@ -0,0 +1,282 @@ +page_title: Understanding the Technology +page_description: Technology of Docker explained in depth +page_keywords: docker, introduction, documentation, about, technology, understanding, Dockerfile + +# Understanding the Technology + +*What is the architecture of Docker? What is its underlying technology?* + +## Introduction + +When it comes to understanding Docker and its underlying technology +there is no *magic* involved. Everything is based on tried and tested +features of the *Linux kernel*. Docker either makes use of those +features directly or builds upon them to provide new functionality. + +Aside from the technology, one of the major factors that make Docker +great is the way it is built. The project's core is very lightweight and +as much of Docker as possible is designed to be pluggable. Docker is +also built with integration in mind and has a fully featured API that +allows you to access all of the power of Docker from inside your own +applications. + +## The Architecture of Docker + +Docker is designed for developers and sysadmins. It's built to help you +build applications and services and then deploy them quickly and +efficiently: from development to production. + +Let's take a look. + +- Docker is a client-server application. +- Both the Docker client and the daemon *can* run on the same system, or; +- You can connect a Docker client with a remote Docker daemon. +- They communicate via sockets or through a RESTful API. +- Users interact with the client to command the daemon, e.g. to create, run, and stop containers. +- The daemon, receiving those commands, does the job, e.g. run a container, stop a container. + + + _________________ + | Host(s) | + The Client Sends Commands |_________________| + ------------------------- | | + [docker] <= pull, run => | [docker daemon] | + client | | + | - container 1 | + | - container 2 | + | - .. | + |_______~~________| + || + [The Docker Image Index] + +P.S. Do not be put off with this scary looking representation. It's just our ASCII drawing skills. ;-) + +## The components of Docker + +Docker's main components are: + + - Docker *daemon*; + - Docker *client*, and; + - The Docker Index. + +### The Docker daemon + +As shown on the diagram above, the Docker daemon runs on a host machine. +The user does not directly interact with the daemon, but instead through +an intermediary: the Docker client. + +### Docker client + +The Docker client is the primary user interface to Docker. It is tasked +with accepting commands from the user and communicating back and forth +with a Docker daemon to manage the container lifecycle on any host. + +### Docker Index, the central Docker registry + +The [Docker Index](http://index.docker.io) is the global archive (and +directory) of user supplied Docker container images. It currently hosts +a large – in fact, rapidly growing – number of projects where you +can find almost any popular application or deployment stack readily +available to download and run with a single command. + +As a social community project, Docker tries to provide all necessary +tools for everyone to grow with other *Dockers*. By issuing a single +command through the Docker client you can start sharing your own +creations with the rest of the world. + +However, knowing that not everything can be shared the Docker Index also +offers private repositories. In order to see the available plans, you +can click [here](https://index.docker.io/plans). + +Using the [Docker Registry](https://github.com/dotcloud/docker-registry), it is +also possible to run your own private Docker image registry service on your own +servers. + +> **Note:** To learn more about the [*Docker Image Index*]( +> http://index.docker.io) (public *and* private), check out the [Registry & +> Index Spec](http://docs.docker.io/en/latest/api/registry_index_spec/). + +### Summary + + - **When you install Docker, you get all the components:** + The daemon, the client and access to the public image registry: the [Docker Index](http://index.docker.io). + - **You can run these components together or distributed:** + Servers with the Docker daemon running, controlled by the Docker client. + - **You can benefit form the public registry:** + Download and build upon images created by the community. + - **You can start a private repository for proprietary use.** + Sign up for a [plan](https://index.docker.io/plans) or host your own [Docker registry](https://github.com/dotcloud/docker-registry). + +## Elements of Docker + +The basic elements of Docker are: + + - **Containers, which allow:** + The run portion of Docker. Your applications run inside of containers. + - **Images, which provide:** + The build portion of Docker. Your containers are built from images. + - **The Dockerfile, which automates:** + A file that contains simple instructions that build Docker images. + +To get practical and learn what they are, and **_how to work_** with +them, continue to [Working with Docker](working-with-docker.md). If you would like to +understand **_how they work_**, stay here and continue reading. + +## The underlying technology + +The power of Docker comes from the underlying technology it is built +from. A series of operating system features are carefully glued together +to provide Docker's features and provide an easy to use interface to +those features. In this section, we will see the main operating system +features that Docker uses to make easy containerization happen. + +### Namespaces + +Docker takes advantage of a technology called `namespaces` to provide +an isolated workspace we call a *container*. When you run a container, +Docker creates a set of *namespaces* for that container. + +This provides a layer of isolation: each process runs in its own +namespace and does not have access outside it. + +Some of the namespaces Docker uses are: + + - **The `pid` namespace:** + Used for process numbering (PID: Process ID) + - **The `net` namespace:** + Used for managing network interfaces (NET: Networking) + - **The `ipc` namespace:** + Used for managing access to IPC resources (IPC: InterProcess Communication) + - **The `mnt` namespace:** + Used for managing mount-points (MNT: Mount) + - **The `uts` namespace:** + Used for isolating kernel / version identifiers. (UTS: Unix Timesharing System) + +### Control groups + +Docker also makes use of another technology called `cgroups` or control +groups. A key need to run applications in isolation is to have them +contained, not just in terms of related filesystem and/or dependencies, +but also, resources. Control groups allow Docker to fairly +share available hardware resources to containers and if asked, set up to +limits and constraints, for example limiting the memory to a maximum of 128 +MBs. + +### UnionFS + +UnionFS or union filesystems are filesystems that operate by creating +layers, making them very lightweight and fast. Docker uses union +filesystems to provide the building blocks for containers. We'll see +more about this below. + +### Containers + +Docker combines these components to build a container format we call +`libcontainer`. Docker also supports traditional Linux containers like +[LXC](https://linuxcontainers.org/) which also make use of these +components. + +## How does everything work + +A lot happens when Docker creates a container. + +Let's see how it works! + +### How does a container work? + +A container consists of an operating system, user added files and +meta-data. Each container is built from an image. That image tells +Docker what the container holds, what process to run when the container +is launched and a variety of other configuration data. The Docker image +is read-only. When Docker runs a container from an image it adds a +read-write layer on top of the image (using the UnionFS technology we +saw earlier) to run inside the container. + +### What happens when you run a container? + +The Docker client (or the API!) tells the Docker daemon to run a +container. Let's take a look at a simple `Hello world` example. + + $ docker run -i -t ubuntu /bin/bash + +Let's break down this command. The Docker client is launched using the +`docker` binary. The bare minimum the Docker client needs to tell the +Docker daemon is: + +* What Docker image to build the container from; +* The command you want to run inside the container when it is launched. + +So what happens under the covers when we run this command? + +Docker begins with: + + - **Pulling the `ubuntu` image:** + Docker checks for the presence of the `ubuntu` image and if it doesn't + exist locally on the host, then Docker downloads it from the [Docker Index](https://index.docker.io) + - **Creates a new container:** + Once Docker has the image it creates a container from it. + - **Allocates a filesystem and mounts a read-write _layer_:** + The container is created in the filesystem and a read-write layer is added to the image. + - **Allocates a network / bridge interface:** + Creates a network interface that allows the Docker container to talk to the local host. + - **Sets up an IP address:** + Intelligently finds and attaches an available IP address from a pool. + - **Executes _a_ process that you specify:** + Runs your application, and; + - **Captures and provides application output:** + Connects and logs standard input, outputs and errors for you to see how your application is running. + +### How does a Docker Image work? + +We've already seen that Docker images are read-only templates that +Docker containers are launched from. When you launch that container it +creates a read-write layer on top of that image that your application is +run in. + +Docker images are built using a simple descriptive set of steps we +call *instructions*. Instructions are stored in a file called a +`Dockerfile`. Each instruction writes a new layer to an image using the +UnionFS technology we saw earlier. + +Every image starts from a base image, for example `ubuntu` a base Ubuntu +image or `fedora` a base Fedora image. Docker builds and provides these +base images via the [Docker Index](http://index.docker.io). + +### How does a Docker registry work? + +The Docker registry is a store for your Docker images. Once you build a +Docker image you can *push* it to the [Docker +Index](http://index.docker.io) or to a private registry you run behind +your firewall. + +Using the Docker client, you can search for already published images and +then pull them down to your Docker host to build containers from them +(or even build on these images). + +The [Docker Index](http://index.docker.io) provides both public and +private storage for images. Public storage is searchable and can be +downloaded by anyone. Private repositories are excluded from search +results and only you and your users can pull them down and use them to +build containers. You can [sign up for a plan here](https://index.docker.io/plans). + +To learn more, check out the [Working With Repositories]( +http://docs.docker.io/en/latest/use/workingwithrepository) section of our +[User's Manual](http://docs.docker.io). + +## Where to go from here + +### Understanding Docker + +Visit [Understanding Docker](understanding-docker.md) in our Getting Started manual. + +### Get practical and learn how to use Docker straight away + +Visit [Working with Docker](working-with-docker.md) in our Getting Started manual. + +### Get the product and go hands-on + +Visit [Get Docker](get-docker.md) in our Getting Started manual. + +### Get the whole story + +[https://www.docker.io/the_whole_story/](https://www.docker.io/the_whole_story/) diff --git a/docs/sources/introduction/understanding-docker.md b/docs/sources/introduction/understanding-docker.md new file mode 100644 index 0000000000..1c979d5810 --- /dev/null +++ b/docs/sources/introduction/understanding-docker.md @@ -0,0 +1,272 @@ +page_title: Understanding Docker +page_description: Docker explained in depth +page_keywords: docker, introduction, documentation, about, technology, understanding, Dockerfile + +# Understanding Docker + +*What is Docker? What makes it great?* + +Building development lifecycles, pipelines and deployment tooling is +hard. It's not easy to create portable applications and services. +There's often high friction getting code from your development +environment to production. It's also hard to ensure those applications +and services are consistent, up-to-date and managed. + +Docker is designed to solve these problem for both developers and +sysadmins. It is a lightweight framework (with a powerful API) that +provides a lifecycle for building and deploying applications into +containers. + +Docker provides a way to run almost any application securely isolated +into a container. The isolation and security allows you to run many +containers simultaneously on your host. The lightweight nature of +containers, which run without the extra overload of a hypervisor, means +you can get more out of your hardware. + +**Note:** Docker itself is *shipped* with the Apache 2.0 license and it +is completely open-source — *the pun? very much intended*. + +### What are the Docker basics I need to know? + +Docker has three major components: + +* Docker containers. +* Docker images. +* Docker registries. + +#### Docker containers + +Docker containers are like a directory. A Docker container holds +everything that is needed for an application to run. Each container is +created from a Docker image. Docker containers can be run, started, +stopped, moved and deleted. Each container is an isolated and secure +application platform. You can consider Docker containers the *run* +portion of the Docker framework. + +#### Docker images + +The Docker image is a template, for example an Ubuntu +operating system with Apache and your web application installed. Docker +containers are launched from images. Docker provides a simple way to +build new images or update existing images. You can consider Docker +images to be the *build* portion of the Docker framework. + +#### Docker Registries + +Docker registries hold images. These are public (or private!) stores +that you can upload or download images to and from. These images can be +images you create yourself or you can make use of images that others +have previously created. Docker registries allow you to build simple and +powerful development and deployment work flows. You can consider Docker +registries the *share* portion of the Docker framework. + +### How does Docker work? + +Docker is a client-server framework. The Docker *client* commands the Docker +*daemon*, which in turn creates, builds and manages containers. + +The Docker daemon takes advantage of some neat Linux kernel and +operating system features, like `namespaces` and `cgroups`, to build +isolated container. Docker provides a simple abstraction layer to these +technologies. + +> **Note:** If you would like to learn more about the underlying technology, +> why not jump to [Understanding the Technology](technology.md) where we talk about them? You can +> always come back here to continue learning about features of Docker and what +> makes it different. + +## Features of Docker + +In order to get a good grasp of the capabilities of Docker you should +read the [User's Manual](http://docs.docker.io). Let's look at a summary +of Docker's features to give you an idea of how Docker might be useful +to you. + +### User centric and simple to use + +*Docker is made for humans.* + +It's easy to get started and easy to build and deploy applications with +Docker: or as we say "*dockerise*" them! As much of Docker as possible +uses plain English for commands and tries to be as lightweight and +transparent as possible. We want to get out of the way so you can build +and deploy your applications. + +### Docker is Portable + +*Dockerise And Go!* + +Docker containers are highly portable. Docker provides a standard +container format to hold your applications: + +* You take care of your applications inside the container, and; +* Docker takes care of managing the container. + +Any machine, be it bare-metal or virtualized, can run any Docker +container. The sole requirement is to have Docker installed. + +**This translates to:** + + - Reliability; + - Freeing your applications out of the dependency-hell; + - A natural guarantee that things will work, anywhere. + +### Lightweight + +*No more resources waste.* + +Containers are lightweight, in fact, they are extremely lightweight. +Unlike traditional virtual machines, which have the overhead of a +hypervisor, Docker relies on operating system level features to provide +isolation and security. A Docker container does not need anything more +than what your application needs to run. + +This translates to: + + - Ability to deploy a large number of applications on a single system; + - Lightning fast start up times and reduced overhead. + +### Docker can run anything + +*An amazing host! (again, pun intended.)* + +Docker isn't prescriptive about what applications or services you can run +inside containers. We provide use cases and examples for running web +services, databases, applications - just about anything you can imagine +can run in a Docker container. + +**This translates to:** + + - Ability to run a wide range of applications; + - Ability to deploy reliably without repeating yourself. + +### Plays well with others + +*A wonderful guest.* + +Today, it is possible to install and use Docker almost anywhere. Even on +non-Linux systems such as Windows or Mac OS X thanks to a project called +[Boot2Docker](http://boot2docker.io). + +**This translates to running Docker (and Docker containers!) _anywhere_:** + + - **Linux:** + Ubuntu, CentOS / RHEL, Fedora, Gentoo, openSUSE and more. + - **Infrastructure-as-a-Service:** + Amazon AWS, Google GCE, Rackspace Cloud and probably, your favorite IaaS. + - **Microsoft Windows** + - **OS X** + +### Docker is Responsible + +*A tool that you can trust.* + +Docker does not just bring you a set of tools to isolate and run +applications. It also allows you to specify constraints and controls on +those resources. + +**This translates to:** + + - Fine tuning available resources for each application; + - Allocating memory or CPU intelligently to make most of your environment; + +Without dealing with complicated commands or third party applications. + +### Docker is Social + +*Docker knows that No One Is an Island.* + +Docker allows you to share the images you've built with the world. And +lots of people have already shared their own images. + +To facilitate this sharing Docker comes with a public registry and index +called the [Docker Index](http://index.docker.io). If you don't want +your images to be public you can also use private images on the Index or +even run your own registry behind your firewall. + +**This translates to:** + + - No more wasting time building everything from scratch; + - Easily and quickly save your application stack; + - Share and benefit from the depth of the Docker community. + +## Docker versus Virtual Machines + +> I suppose it is tempting, if the *only* tool you have is a hammer, to +> treat *everything* as if it were a nail. +> — **_Abraham Maslow_** + +**Docker containers are:** + + - Easy on the resources; + - Extremely light to deal with; + - Do not come with substantial overhead; + - Very easy to work with; + - Agnostic; + - Can work *on* virtual machines; + - Secure and isolated; + - *Artful*, *social*, *fun*, and; + - Powerful sand-boxes. + +**Docker containers are not:** + + - Hardware or OS emulators; + - Resource heavy; + - Platform, software or language dependent. + +## Docker Use Cases + +Docker is a framework. As a result it's flexible and powerful enough to +be used in a lot of different use cases. + +### For developers + + - **Developed with developers in mind:** + Build, test and ship applications with nothing but Docker and lean + containers. + - **Re-usable building blocks to create more:** + Docker images are easily updated building blocks. + - **Automatically build-able:** + It has never been this easy to build - *anything*. + - **Easy to integrate:** + A powerful, fully featured API allows you to integrate Docker into your tooling. + +### For sysadmins + + - **Efficient (and DevOps friendly!) lifecycle:** + Operations and developments are consistent, repeatable and reliable. + - **Balanced environments:** + Processes between development, testing and production are leveled. + - **Improvements on speed and integration:** + Containers are almost nothing more than isolated, secure processes. + - **Lowered costs of infrastructure:** + Containers are lightweight and heavy on resources compared to virtual machines. + - **Portable configurations:** + Issues and overheads with dealing with configurations and systems are eliminated. + +### For everyone + + - **Increased security without performance loss:** + Replacing VMs with containers provide security without additional + hardware (or software). + - **Portable:** + You can easily move applications and workloads from different operating + systems and platforms. + +## Where to go from here + +### Learn about Parts of Docker and the underlying technology + +Visit [Understanding the Technology](technology.md) in our Getting Started manual. + +### Get practical and learn how to use Docker straight away + +Visit [Working with Docker](working-with-docker.md) in our Getting Started manual. + +### Get the product and go hands-on + +Visit [Get Docker](get-docker.md) in our Getting Started manual. + +### Get the whole story + +[https://www.docker.io/the_whole_story/](https://www.docker.io/the_whole_story/) diff --git a/docs/sources/introduction/working-with-docker.md b/docs/sources/introduction/working-with-docker.md new file mode 100644 index 0000000000..f395723d60 --- /dev/null +++ b/docs/sources/introduction/working-with-docker.md @@ -0,0 +1,408 @@ +page_title: Working with Docker and the Dockerfile +page_description: Working with Docker and The Dockerfile explained in depth +page_keywords: docker, introduction, documentation, about, technology, understanding, Dockerfile + +# Working with Docker and the Dockerfile + +*How to use and work with Docker?* + +> **Warning! Don't let this long page bore you.** +> If you prefer a summary and would like to see how a specific command +> works, check out the glossary of all available client +> commands on our [User's Manual: Commands Reference]( +> http://docs.docker.io/en/latest/reference/commandline/cli). + +## Introduction + +On the last page, [Understanding the Technology](technology.md), we covered the +components that make up Docker and learnt about the +underlying technology and *how* everything works. + +Now, it is time to get practical and see *how to work with* the Docker client, +Docker containers and images and the `Dockerfile`. + +> **Note:** You are encouraged to take a good look at the container, +> image and `Dockerfile` explanations here to have a better understanding +> on what exactly they are and to get an overall idea on how to work with +> them. On the next page (i.e., [Get Docker](get-docker.md)), you will be +> able to find links for platform-centric installation instructions. + +## Elements of Docker + +As we mentioned on the, [Understanding the Technology](technology.md) page, the main +elements of Docker are: + + - Containers; + - Images, and; + - The `Dockerfile`. + +> **Note:** This page is more *practical* than *technical*. If you are +> interested in understanding how these tools work behind the scenes +> and do their job, you can always read more on +> [Understanding the Technology](technology.md). + +## Working with the Docker client + +In order to work with the Docker client, you need to have a host with +the Docker daemon installed and running. + +### How to use the client + +The client provides you a command-line interface to Docker. It is +accessed by running the `docker` binary. + +> **Tip:** The below instructions can be considered a summary of our +> *interactive tutorial*. If you prefer a more hands-on approach without +> installing anything, why not give that a shot and check out the +> [Docker Interactive Tutorial](http://www.docker.io/interactivetutorial). + +The `docker` client usage consists of passing a chain of arguments: + + # Usage: [sudo] docker [option] [command] [arguments] .. + # Example: + docker run -i -t ubuntu /bin/bash + +### Our first Docker command + +Let's get started with our first Docker command by checking the +version of the currently installed Docker client using the `docker +version` command. + + # Usage: [sudo] docker version + # Example: + docker version + +This command will not only provide you the version of Docker client you +are using, but also the version of Go (the programming language powering +Docker). + + Client version: 0.8.0 + Go version (client): go1.2 + + Git commit (client): cc3a8c8 + Server version: 0.8.0 + + Git commit (server): cc3a8c8 + Go version (server): go1.2 + + Last stable version: 0.8.0 + +### Finding out all available commands + +The user-centric nature of Docker means providing you a constant stream +of helpful instructions. This begins with the client itself. + +In order to get a full list of available commands run the `docker` +binary: + + # Usage: [sudo] docker + # Example: + docker + +You will get an output with all currently available commands. + + Commands: + attach Attach to a running container + build Build a container from a Dockerfile + commit Create a new image from a container's changes + . . . + +### Command usage instructions + +The same way used to learn all available commands can be repeated to find +out usage instructions for a specific command. + +Try typing Docker followed with a `[command]` to see the instructions: + + # Usage: [sudo] docker [command] [--help] + # Example: + docker attach + Help outputs . . . + +Or you can pass the `--help` flag to the `docker` binary. + + docker images --help + +You will get an output with all available options: + + Usage: docker attach [OPTIONS] CONTAINER + + Attach to a running container + + --no-stdin=false: Do not attach stdin + --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) + +## Working with images + +### Docker Images + +As we've discovered a Docker image is a read-only template that we build +containers from. Every Docker container is launched from an image and +you can use both images provided by others, for example we've discovered +the base `ubuntu` image provided by Docker, as well as images built by +others. For example we can build an image that runs Apache and our own +web application as a starting point to launch containers. + +### Searching for images + +To search for Docker image we use the `docker search` command. The +`docker search` command returns a list of all images that match your +search criteria together with additional, useful information about that +image. This includes information such as social metrics like how many +other people like the image - we call these "likes" *stars*. We also +tell you if an image is *trusted*. A *trusted* image is built from a +known source and allows you to introspect in greater detail how the +image is constructed. + + # Usage: [sudo] docker search [image name] + # Example: + docker search nginx + + NAME DESCRIPTION STARS OFFICIAL TRUSTED + dockerfile/nginx Trusted Nginx (http://nginx.org/) Build 6 [OK] + paintedfox/nginx-php5 A docker image for running Nginx with PHP5. 3 [OK] + dockerfiles/django-uwsgi-nginx Dockerfile and configuration files to buil... 2 [OK] + . . . + +> **Note:** To learn more about trusted builds, check out [this] +(http://blog.docker.io/2013/11/introducing-trusted-builds) blog post. + +### Downloading an image + +Downloading a Docker image is called *pulling*. To do this we hence use the +`docker pull` command. + + # Usage: [sudo] docker pull [image name] + # Example: + docker pull dockerfile/nginx + + Pulling repository dockerfile/nginx + 0ade68db1d05: Pulling dependent layers + 27cf78414709: Download complete + b750fe79269d: Download complete + . . . + +As you can see, Docker will download, one by one, all the layers forming +the final image. This demonstrates the *building block* philosophy of +Docker. + +### Listing available images + +In order to get a full list of available images, you can use the +`docker images` command. + + # Usage: [sudo] docker images + # Example: + docker images + + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + myUserName/nginx latest a0d6c70867d2 41 seconds ago 578.8 MB + nginx latest 173c2dd28ab2 3 minutes ago 578.8 MB + dockerfile/nginx latest 0ade68db1d05 3 weeks ago 578.8 MB + +## Working with containers + +### Docker Containers + +Docker containers are directories on your Docker host that are built +from Docker images. In order to create or start a container, you need an +image. This could be the base `ubuntu` image or an image built and +shared with you or an image you've built yourself. + +### Running a new container from an image + +The easiest way to create a new container is to *run* one from an image. + + # Usage: [sudo] docker run [arguments] .. + # Example: + docker run -d --name nginx_web nginx /usr/sbin/nginx + +This will create a new container from an image called `nginx` which will +launch the command `/usr/sbin/nginx` when the container is run. We've +also given our container a name, `nginx_web`. + +Containers can be run in two modes: + +* Interactive; +* Daemonized; + +An interactive container runs in the foreground and you can connect to +it and interact with it. A daemonized container runs in the background. + +A container will run as long as the process you have launched inside it +is running, for example if the `/usr/bin/nginx` process stops running +the container will also stop. + +### Listing containers + +We can see a list of all the containers on our host using the `docker +ps` command. By default the `docker ps` commands only shows running +containers. But we can also add the `-a` flag to show *all* containers - +both running and stopped. + + # Usage: [sudo] docker ps [-a] + # Example: + docker ps + + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 842a50a13032 dockerfile/nginx:latest nginx 35 minutes ago Up 30 minutes 0.0.0.0:80->80/tcp nginx_web + +### Stopping a container + +You can use the `docker stop` command to stop an active container. This will gracefully +end the active process. + + # Usage: [sudo] docker stop [container ID] + # Example: + docker stop nginx_web + nginx_web + +If the `docker stop` command succeeds it will return the name of +the container it has stopped. + +### Starting a Container + +Stopped containers can be started again. + + # Usage: [sudo] docker start [container ID] + # Example: + docker start nginx_web + nginx_web + +If the `docker start` command succeeds it will return the name of the +freshly started container. + +## Working with the Dockerfile + +The `Dockerfile` holds the set of instructions Docker uses to build a Docker image. + +> **Tip:** Below is a short summary of our full Dockerfile tutorial. In +> order to get a better-grasp of how to work with these automation +> scripts, check out the [Dockerfile step-by-step +> tutorial](http://www.docker.io/learn/dockerfile). + +A `Dockerfile` contains instructions written in the following format: + + # Usage: Instruction [arguments / command] .. + # Example: + FROM ubuntu + +A `#` sign is used to provide a comment: + + # Comments .. + +> **Tip:** The `Dockerfile` is very flexible and provides a powerful set +> of instructions for building applications. To learn more about the +> `Dockerfile` and it's instructions see the [Dockerfile +> Reference](http://docs.docker.io/en/latest/reference/builder). + +### First steps with the Dockerfile + +It's a good idea to add some comments to the start of your `Dockerfile` +to provide explanation and exposition to any future consumers, for +example: + + # + # Dockerfile to install Nginx + # VERSION 2 - EDITION 1 + +The first instruction in any `Dockerfile` must be the `FROM` instruction. The `FROM` instruction specifies the image name that this new image is built from, it is often a base image like `ubuntu`. + + # Base image used is Ubuntu: + FROM ubuntu + +Next, we recommend you use the `MAINTAINER` instruction to tell people who manages this image. + + # Maintainer: O.S. Tezer (@ostezer) + MAINTAINER O.S. Tezer, ostezer@gmail.com + +After this we can add additional instructions that represent the steps +to build our actual image. + +### Our Dockerfile so far + +So far our `Dockerfile` will look like. + + # Dockerfile to install Nginx + # VERSION 2 - EDITION 1 + FROM ubuntu + MAINTAINER O.S. Tezer, ostezer@gmail.com + +Let's install a package and configure an application inside our image. To do this we use a new +instruction: `RUN`. The `RUN` instruction executes commands inside our +image, for example. The instruction is just like running a command on +the command line inside a container. + + RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list + RUN apt-get update + RUN apt-get install -y nginx + RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf + +We can see here that we've *run* four instructions. Each time we run an +instruction a new layer is added to our image. Here's we've added an +Ubuntu package repository, updated the packages, installed the `nginx` +package and then echo'ed some configuration to the default +`/etc/nginx/nginx.conf` configuration file. + +Let's specify another instruction, `CMD`, that tells Docker what command +to run when a container is created from this image. + + CMD /usr/sbin/nginx + +We can now save this file and use it build an image. + +### Using a Dockerfile + +Docker uses the `Dockerfile` to build images. The build process is initiated by the `docker build` command. + + # Use the Dockerfile at the current location + # Usage: [sudo] docker build . + # Example: + docker build -t="my_nginx_image" . + + Uploading context 25.09 kB + Uploading context + Step 0 : FROM ubuntu + ---> 9cd978db300e + Step 1 : MAINTAINER O.S. Tezer, ostezer@gmail.com + ---> Using cache + ---> 467542d0cdd3 + Step 2 : RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list + ---> Using cache + ---> 0a688bd2a48c + Step 3 : RUN apt-get update + ---> Running in de2937e8915a + . . . + Step 10 : CMD /usr/sbin/nginx + ---> Running in b4908b9b9868 + ---> 626e92c5fab1 + Successfully built 626e92c5fab1 + +Here we can see that Docker has executed each instruction in turn and +each instruction has created a new layer in turn and each layer identified +by a new ID. The `-t` flag allows us to specify a name for our new +image, here `my_nginx_image`. + +We can see our new image using the `docker images` command. + + docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + my_nginx_img latest 626e92c5fab1 57 seconds ago 337.6 MB + +## Where to go from here + +### Understanding Docker + +Visit [Understanding Docker](understanding-docker.md) in our Getting Started manual. + +### Learn about parts of Docker and the underlying technology + +Visit [Understanding the Technology](technology.md) in our Getting Started manual. + +### Get the product and go hands-on + +Visit [Get Docker](get-docker.md) in our Getting Started manual. + +### Get the whole story + +[https://www.docker.io/the_whole_story/](https://www.docker.io/the_whole_story/) diff --git a/docs/sources/jsearch.md b/docs/sources/jsearch.md new file mode 100644 index 0000000000..0e2def2f70 --- /dev/null +++ b/docs/sources/jsearch.md @@ -0,0 +1,9 @@ +# Search + +
+ + +
+ +
+
diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.0.md b/docs/sources/reference/api/archive/docker_remote_api_v1.0.md new file mode 100644 index 0000000000..7cb625aa2f --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.0.md @@ -0,0 +1,998 @@ +page_title: Remote API v1.0 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.0](#id1) + +Table of Contents + +- [Docker Remote API v1.0](#docker-remote-api-v1-0) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Get default username and + email](#get-default-username-and-email) + - [Check auth configuration and store + it](#check-auth-configuration-and-store-it) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0" + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0" + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id8) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id9) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id10) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id11) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id12) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id13) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id14) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id15) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id16) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id17) + +#### [List Images](#id18) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id19) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id20) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id21) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + } + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id22) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id23) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id24) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **500** – server error + +#### [Remove an image](#id25) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such image + - **500** – server error + +#### [Search images](#id26) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id27) + +#### [Build an image from Dockerfile via stdin](#id28) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + Query Parameters: + +   + + - **t** – repository name to be applied to the resulting image in + case of success + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Get default username and email](#id29) + + `GET /auth` +: Get the default username and email + + **Example request**: + + GET /auth HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "username":"hannibal", + "email":"hannibal@a-team.com" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration and store it](#id30) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id31) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id32) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id33) + + `POST /commit` +: Create a new image from a container’s changes + > + > **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +## [3. Going further](#id34) + +### [3.1 Inside ‘docker run’](#id35) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id36) + +In this first version of the API, some of the endpoints, like /attach, +/pull or /push uses hijacking to transport stdin, stdout and stderr on +the same socket. This might change in the future. diff --git a/docs/sources/reference/api/docker_remote_api_v1.0.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.0.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.0.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.0.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.1.md b/docs/sources/reference/api/archive/docker_remote_api_v1.1.md new file mode 100644 index 0000000000..8e9e6d57fd --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.1.md @@ -0,0 +1,1008 @@ +page_title: Remote API v1.1 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.1](#id1) + +Table of Contents + +- [Docker Remote API v1.1](#docker-remote-api-v1-1) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Get default username and + email](#get-default-username-and-email) + - [Check auth configuration and store + it](#check-auth-configuration-and-store-it) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0" + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0" + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0" + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id8) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id9) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id10) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id11) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id12) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id13) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id14) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id15) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id16) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id17) + +#### [List Images](#id18) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id19) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id20) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id21) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + } + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id22) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id23) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id24) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id25) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such image + - **500** – server error + +#### [Search images](#id26) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id27) + +#### [Build an image from Dockerfile via stdin](#id28) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + Query Parameters: + +   + + - **t** – tag to be applied to the resulting image in case of + success + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Get default username and email](#id29) + + `GET /auth` +: Get the default username and email + + **Example request**: + + GET /auth HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "username":"hannibal", + "email":"hannibal@a-team.com" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration and store it](#id30) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id31) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id32) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id33) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +## [3. Going further](#id34) + +### [3.1 Inside ‘docker run’](#id35) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id36) + +In this version of the API, /attach uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. diff --git a/docs/sources/reference/api/docker_remote_api_v1.1.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.1.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.1.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.1.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.2.md b/docs/sources/reference/api/archive/docker_remote_api_v1.2.md new file mode 100644 index 0000000000..0966908f50 --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.2.md @@ -0,0 +1,1028 @@ +page_title: Remote API v1.2 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.2](#id1) + +Table of Contents + +- [Docker Remote API v1.2](#docker-remote-api-v1-2) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id8) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id9) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id10) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/e90e34656806/start HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id11) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id12) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id13) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id14) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id15) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id16) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id17) + +#### [List Images](#id18) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id19) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id20) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id21) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id22) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Tag":["ubuntu:latest"], + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id23) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > {{ authConfig }} + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id24) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id25) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **204** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id26) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id27) + +#### [Build an image from Dockerfile via stdin](#id28) + + `POST /build` +: Build an image from Dockerfile + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + Query Parameters: + +   + + - **t** – repository name to be applied to the resulting image in + case of success + - **remote** – resource to fetch, as URI + + Status Codes: + + - **200** – no error + - **500** – server error + +{{ STREAM }} is the raw text output of the build command. It uses the +HTTP Hijack method in order to stream. + +#### [Check auth configuration](#id29) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Status": "Login Succeeded" + } + + Status Codes: + + - **200** – no error + - **204** – no error + - **401** – unauthorized + - **403** – forbidden + - **500** – server error + +#### [Display system-wide information](#id30) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id31) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id32) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +## [3. Going further](#id33) + +### [3.1 Inside ‘docker run’](#id34) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id35) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id36) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + +> docker -d -H="[tcp://192.168.1.9:4243](tcp://192.168.1.9:4243)" +> –api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.2.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.2.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.2.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.2.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.3.md b/docs/sources/reference/api/archive/docker_remote_api_v1.3.md new file mode 100644 index 0000000000..bda1ebce4a --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.3.md @@ -0,0 +1,1110 @@ +page_title: Remote API v1.3 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.3](#id1) + +Table of Contents + +- [Docker Remote API v1.3](#docker-remote-api-v1-3) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "PID":"11935", + "Tty":"pts/2", + "Time":"00:00:00", + "Cmd":"sh" + }, + { + "PID":"12140", + "Tty":"pts/2", + "Time":"00:00:00", + "Cmd":"sleep" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"] + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id18) + +#### [List Images](#id19) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id20) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id21) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id22) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id23) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id24) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + > **Example request**: + > + > POST /images/test/push HTTP/1.1 + > {{ authConfig }} + > + > **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id25) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id26) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id27) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id28) + +#### [Build an image from Dockerfile via stdin](#id29) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. It + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id30) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id31) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "EventsListeners":"0", + "LXCVersion":"0.7.5", + "KernelVersion":"3.8.0-19-generic" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id32) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id33) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id34) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","time":1374067924} + {"status":"start","id":"dfdf82bd3881","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +## [3. Going further](#id35) + +### [3.1 Inside ‘docker run’](#id36) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id37) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id38) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + +> docker -d -H="192.168.1.9:4243" –api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.3.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.3.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.3.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.3.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.4.md b/docs/sources/reference/api/archive/docker_remote_api_v1.4.md new file mode 100644 index 0000000000..6dffd0958e --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.4.md @@ -0,0 +1,1156 @@ +page_title: Remote API v1.4 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.4](#id1) + +Table of Contents + +- [Docker Remote API v1.4](#docker-remote-api-v1-4) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [Copy files or folders from a + container](#copy-files-or-folders-from-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":"", + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Privileged": false, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **409** – conflict between containers and images + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + + Query Parameters: + +   + + - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Copy files or folders from a container](#id18) + + `POST /containers/`(*id*)`/copy` +: Copy files or folders of container `id` + + **Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id19) + +#### [List Images](#id20) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id21) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id22) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id23) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict between containers and images + - **500** – server error + +#### [Get the history of an image](#id24) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id25) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + **Example request**: + + POST /images/test/push HTTP/1.1 + {{ authConfig }} + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +#### [Tag an image into a repository](#id26) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id27) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id28) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id29) + +#### [Build an image from Dockerfile via stdin](#id30) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. It + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + - **nocache** – do not use the cache when building the image + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id31) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id32) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id33) + + `GET /version` +: Show the docker version information + > + > **Example request**: + > + > GET /version HTTP/1.1 + > + > **Example response**: + > + > HTTP/1.1 200 OK + > Content-Type: application/json + > + > { + > "Version":"0.2.2", + > "GitCommit":"5a2a5cc+CHANGES", + > "GoVersion":"go1.0.3" + > } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id34) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id35) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +## [3. Going further](#id36) + +### [3.1 Inside ‘docker run’](#id37) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id38) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id39) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.4.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.4.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.4.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.4.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.5.md b/docs/sources/reference/api/archive/docker_remote_api_v1.5.md new file mode 100644 index 0000000000..198661093a --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.5.md @@ -0,0 +1,1164 @@ +page_title: Remote API v1.5 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.5](#id1) + +Table of Contents + +- [Docker Remote API v1.5](#docker-remote-api-v1-5) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [Copy files or folders from a + container](#copy-files-or-folders-from-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API is replacing rcli +- Default port in the docker daemon is 4243 +- The API tends to be REST, but for some complex commands, like attach + or pull, the HTTP connection is hijacked to transport stdout stdin + and stderr + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "ubuntu:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "ubuntu:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "centos:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "fedora:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Privileged": false, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"ubuntu", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "ubuntu", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + + Query Parameters: + +   + + - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Copy files or folders from a container](#id18) + + `POST /containers/`(*id*)`/copy` +: Copy files or folders of container `id` + + **Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id19) + +#### [List Images](#id20) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"ubuntu", + "Tag":"precise", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"ubuntu", + "Tag":"12.04", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nubuntu",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\ncentos",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\nfedora",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id21) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=ubuntu HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id22) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id23) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/centos/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"centos", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id24) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/fedora/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id25) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + **Example request**: + + POST /images/test/push HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + The `X-Registry-Auth` header can be used to + include a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id26) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id27) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id28) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + Query Parameters: + +   + + - **term** – term to search + + Status Codes: + + - **200** – no error + - **500** – server error + +### [2.3 Misc](#id29) + +#### [Build an image from Dockerfile via stdin](#id30) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. It + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + - **nocache** – do not use the cache when building the image + - **rm** – remove intermediate containers after a successful build + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id31) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id32) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id33) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id34) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "PortSpecs":["22"] + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id35) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"ubuntu:latest","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +## [3. Going further](#id36) + +### [3.1 Inside ‘docker run’](#id37) + +Here are the steps of ‘docker run’ : + +- Create the container +- If the status code is 404, it means the image doesn’t exists: \* Try + to pull it \* Then retry to create the container +- Start the container +- If you are not in detached mode: \* Attach to the container, using + logs=1 (to have stdout and stderr from the container’s start) and + stream=1 +- If in detached mode or only stdin is attached: \* Display the + container’s id + +### [3.2 Hijacking](#id38) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id39) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.5.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.5.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.5.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.5.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.6.md b/docs/sources/reference/api/archive/docker_remote_api_v1.6.md new file mode 100644 index 0000000000..1bac32a6be --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.6.md @@ -0,0 +1,1267 @@ +page_title: Remote API v1.6 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.6](#id1) + +Table of Contents + +- [Docker Remote API v1.6](#docker-remote-api-v1-6) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [Copy files or folders from a + container](#copy-files-or-folders-from-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API has replaced rcli +- The daemon listens on `unix:///var/run/docker.sock` +, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../../use/basics/#bind-docker). +- The API tends to be REST, but for some complex commands, like + `attach` or `pull`, the HTTP + connection is hijacked to transport `stdout, stdin` + and `stderr` + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "ExposedPorts":{}, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{}, + "VolumesFrom":"", + "WorkingDir":"" + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Query Parameters: + +   + + - **name** – container name to use + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + + **More Complex Example request, in 2 steps.** **First, use create to + expose a Private Port, which can be bound back to a Public Port at + startup**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Cmd":[ + "/usr/sbin/sshd","-D" + ], + "Image":"image-with-sshd", + "ExposedPorts":{"22/tcp":{}} + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + **Second, start (using the ID returned above) the image we just + created, mapping the ssh port 22 to something on the host**: + + POST /containers/e90e34656806/start HTTP/1.1 + Content-Type: application/json + + { + "PortBindings": { "22/tcp": [{ "HostPort": "11022" }]} + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain; charset=utf-8 + Content-Length: 0 + + **Now you can ssh into your new container on port 11022.** + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "ExposedPorts": {}, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + + Query Parameters: + +   + + - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":{"lxc.utsname":"docker"}, + "ContainerIDFile": "", + "Privileged": false, + "PortBindings": {"22/tcp": [{HostIp:"", HostPort:""}]}, + "Links": [], + "PublishAllPorts": false + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **signal** – Signal to send to the container (integer). When not + set, SIGKILL is assumed and the call will waits for the + container to exit. + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` +](../../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. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + + - 0: stdin (will be writen on stdout) + - 1: stdout + - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 byets + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Copy files or folders from a container](#id18) + + `POST /containers/`(*id*)`/copy` +: Copy files or folders of container `id` + + **Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id19) + +#### [List Images](#id20) + + `GET /images/`(*format*) +: List images `format` could be json or viz (json + default) + + **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Repository":"base", + "Tag":"ubuntu-12.10", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + }, + { + "Repository":"base", + "Tag":"ubuntu-quantal", + "Id":"b750fe79269d", + "Created":1364102658, + "Size":24653, + "VirtualSize":180116135 + } + ] + + **Example request**: + + GET /images/viz HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: text/plain + + digraph docker { + "d82cbacda43a" -> "074be284591f" + "1496068ca813" -> "08306dc45919" + "08306dc45919" -> "0e7893146ac2" + "b750fe79269d" -> "1496068ca813" + base -> "27cf78414709" [style=invis] + "f71189fff3de" -> "9a33b36209ed" + "27cf78414709" -> "b750fe79269d" + "0e7893146ac2" -> "d6434d954665" + "d6434d954665" -> "d82cbacda43a" + base -> "e9aa60c60128" [style=invis] + "074be284591f" -> "f71189fff3de" + "b750fe79269d" [label="b750fe79269d\nbase",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "e9aa60c60128" [label="e9aa60c60128\nbase2",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + "9a33b36209ed" [label="9a33b36209ed\ntest",shape=box,fillcolor="paleturquoise",style="filled,rounded"]; + base [style=invisible] + } + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create an image](#id21) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id22) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id23) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/base/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "ExposedPorts":{}, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id24) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/base/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id25) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + **Example request**: + + POST /images/test/push HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} ... + + > The `X-Registry-Auth` header can be used to + > include a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Status Codes: + + - **200** – no error :statuscode 404: no such image :statuscode + 500: server error + +#### [Tag an image into a repository](#id26) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id27) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id28) + + `GET /images/search` +: Search for an image in the docker index + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Name":"cespare/sshd", + "Description":"" + }, + { + "Name":"johnfuller/sshd", + "Description":"" + }, + { + "Name":"dhrp/mongodb-sshd", + "Description":"" + } + ] + + :query term: term to search + :statuscode 200: no error + :statuscode 500: server error + +### [2.3 Misc](#id29) + +#### [Build an image from Dockerfile via stdin](#id30) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + The archive must include a file called Dockerfile at its root. It + may include any number of other files, which will be accessible in + the build context (See the ADD build command). + + The Content-type header should be set to "application/tar". + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + - **nocache** – do not use the cache when building the image + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id31) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id32) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id33) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id34) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + Content-Type: application/json + + { + "Cmd": ["cat", "/world"], + "ExposedPorts":{"22/tcp":{}} + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id35) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"base:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"base:latest","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +## [3. Going further](#id36) + +### [3.1 Inside ‘docker run’](#id37) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id38) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id39) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.6.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.6.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.6.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.6.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.7.md b/docs/sources/reference/api/archive/docker_remote_api_v1.7.md new file mode 100644 index 0000000000..0deb2a3fc2 --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.7.md @@ -0,0 +1,1263 @@ +page_title: Remote API v1.7 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.7](#id1) + +Table of Contents + +- [Docker Remote API v1.7](#docker-remote-api-v1-7) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [Copy files or folders from a + container](#copy-files-or-folders-from-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [Get a tarball containing all images and tags in a + repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) + - [Load a tarball with a set of images and tags into + docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API has replaced rcli +- The daemon listens on `unix:///var/run/docker.sock` +, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../../use/basics/#bind-docker). +- The API tends to be REST, but for some complex commands, like + `attach` or `pull`, the HTTP + connection is hijacked to transport `stdout, stdin` + and `stderr` + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "ExposedPorts":{ + "22/tcp": {} + } + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {} + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + + Query Parameters: + +   + + - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":{"lxc.utsname":"docker"}, + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "Privileged":false, + "PublishAllPorts":false + } + + Binds need to reference Volumes that were defined during container + creation. + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` +](../../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. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + + - 0: stdin (will be writen on stdout) + - 1: stdout + - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 byets + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Copy files or folders from a container](#id18) + + `POST /containers/`(*id*)`/copy` +: Copy files or folders of container `id` + + **Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id19) + +#### [List Images](#id20) + + `GET /images/json` +: **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +#### [Create an image](#id21) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Request Headers: + +   + + - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id22) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id23) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/base/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id24) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/base/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id25) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + **Example request**: + + POST /images/test/push HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)"} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Request Headers: + +   + + - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id26) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id27) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id28) + + `GET /images/search` +: Search for an image in the docker index. + + Note + + The response keys have changed from API v1.6 to reflect the JSON + sent by the registry server to the docker daemon’s request. + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + + Query Parameters: + +   + + - **term** – term to search + + Status Codes: + + - **200** – no error + - **500** – server error + +### [2.3 Misc](#id29) + +#### [Build an image from Dockerfile via stdin](#id30) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {{ STREAM }} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../../builder/#dockerbuilder)). + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + - **nocache** – do not use the cache when building the image + + Request Headers: + +   + + - **Content-type** – should be set to + `"application/tar"`. + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id31) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id32) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id33) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id34) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + - **run** – config automatically applied when the image is run. + (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id35) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"base:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"base:latest","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET /images/`(*name*)`/get` +: Get a tarball containing all images and metadata for the repository + specified by `name`. + + **Example request** + + GET /images/ubuntu/get + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + :statuscode 200: no error + :statuscode 500: server error + +#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST /images/load` +: Load a set of images and tags into the docker repository. + + **Example request** + + POST /images/load + + Tarball in body + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + + :statuscode 200: no error + :statuscode 500: server error + +## [3. Going further](#id38) + +### [3.1 Inside ‘docker run’](#id39) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id40) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id41) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.7.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.7.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.7.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.7.rst diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.8.md b/docs/sources/reference/api/archive/docker_remote_api_v1.8.md new file mode 100644 index 0000000000..df767af37d --- /dev/null +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.8.md @@ -0,0 +1,1310 @@ +page_title: Remote API v1.8 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# [Docker Remote API v1.8](#id1) + +Table of Contents + +- [Docker Remote API v1.8](#docker-remote-api-v1-8) + - [1. Brief introduction](#brief-introduction) + - [2. Endpoints](#endpoints) + - [2.1 Containers](#containers) + - [List containers](#list-containers) + - [Create a container](#create-a-container) + - [Inspect a container](#inspect-a-container) + - [List processes running inside a + container](#list-processes-running-inside-a-container) + - [Inspect changes on a container’s + filesystem](#inspect-changes-on-a-container-s-filesystem) + - [Export a container](#export-a-container) + - [Start a container](#start-a-container) + - [Stop a container](#stop-a-container) + - [Restart a container](#restart-a-container) + - [Kill a container](#kill-a-container) + - [Attach to a container](#attach-to-a-container) + - [Wait a container](#wait-a-container) + - [Remove a container](#remove-a-container) + - [Copy files or folders from a + container](#copy-files-or-folders-from-a-container) + - [2.2 Images](#images) + - [List Images](#list-images) + - [Create an image](#create-an-image) + - [Insert a file in an image](#insert-a-file-in-an-image) + - [Inspect an image](#inspect-an-image) + - [Get the history of an + image](#get-the-history-of-an-image) + - [Push an image on the + registry](#push-an-image-on-the-registry) + - [Tag an image into a + repository](#tag-an-image-into-a-repository) + - [Remove an image](#remove-an-image) + - [Search images](#search-images) + - [2.3 Misc](#misc) + - [Build an image from Dockerfile via + stdin](#build-an-image-from-dockerfile-via-stdin) + - [Check auth configuration](#check-auth-configuration) + - [Display system-wide + information](#display-system-wide-information) + - [Show the docker version + information](#show-the-docker-version-information) + - [Create a new image from a container’s + changes](#create-a-new-image-from-a-container-s-changes) + - [Monitor Docker’s events](#monitor-docker-s-events) + - [Get a tarball containing all images and tags in a + repository](#get-a-tarball-containing-all-images-and-tags-in-a-repository) + - [Load a tarball with a set of images and tags into + docker](#load-a-tarball-with-a-set-of-images-and-tags-into-docker) + - [3. Going further](#going-further) + - [3.1 Inside ‘docker run’](#inside-docker-run) + - [3.2 Hijacking](#hijacking) + - [3.3 CORS Requests](#cors-requests) + +## [1. Brief introduction](#id2) + +- The Remote API has replaced rcli +- The daemon listens on `unix:///var/run/docker.sock` +, but you can [*Bind Docker to another host/port or a Unix + socket*](../../../../use/basics/#bind-docker). +- The API tends to be REST, but for some complex commands, like + `attach` or `pull`, the HTTP + connection is hijacked to transport `stdout, stdin` + and `stderr` + +## [2. Endpoints](#id3) + +### [2.1 Containers](#id4) + +#### [List containers](#id5) + + `GET /containers/json` +: List containers + + **Example request**: + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id": "8dfafdbc3a40", + "Image": "base:latest", + "Command": "echo 1", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "9cd87474be90", + "Image": "base:latest", + "Command": "echo 222222", + "Created": 1367854155, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "3176a2479c92", + "Image": "base:latest", + "Command": "echo 3333333333333333", + "Created": 1367854154, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + }, + { + "Id": "4cb07b47f9fb", + "Image": "base:latest", + "Command": "echo 444444444444444444444444444444444", + "Created": 1367854152, + "Status": "Exit 0", + "Ports":[], + "SizeRw":12288, + "SizeRootFs":0 + } + ] + + Query Parameters: + +   + + - **all** – 1/True/true or 0/False/false, Show all containers. + Only running containers are shown by default + - **limit** – Show `limit` last created + containers, include non-running ones. + - **since** – Show only containers created since Id, include + non-running ones. + - **before** – Show only containers created before Id, include + non-running ones. + - **size** – 1/True/true or 0/False/false, Show the containers + sizes + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **500** – server error + +#### [Create a container](#id6) + + `POST /containers/create` +: Create a container + + **Example request**: + + POST /containers/create HTTP/1.1 + Content-Type: application/json + + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "CpuShares":0, + "AttachStdin":false, + "AttachStdout":true, + "AttachStderr":true, + "PortSpecs":null, + "Tty":false, + "OpenStdin":false, + "StdinOnce":false, + "Env":null, + "Cmd":[ + "date" + ], + "Dns":null, + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "VolumesFrom":"", + "WorkingDir":"", + "ExposedPorts":{ + "22/tcp": {} + } + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **Hostname** – Container host name + - **User** – Username or UID + - **Memory** – Memory Limit in bytes + - **CpuShares** – CPU shares (relative weight) + - **AttachStdin** – 1/True/true or 0/False/false, attach to + standard input. Default false + - **AttachStdout** – 1/True/true or 0/False/false, attach to + standard output. Default false + - **AttachStderr** – 1/True/true or 0/False/false, attach to + standard error. Default false + - **Tty** – 1/True/true or 0/False/false, allocate a pseudo-tty. + Default false + - **OpenStdin** – 1/True/true or 0/False/false, keep stdin open + even if not attached. Default false + + Query Parameters: + +   + + - **name** – Assign the specified name to the container. Must + match `/?[a-zA-Z0-9_-]+`. + + Status Codes: + + - **201** – no error + - **404** – no such container + - **406** – impossible to attach (container not running) + - **500** – server error + +#### [Inspect a container](#id7) + + `GET /containers/`(*id*)`/json` +: Return low-level information on the container `id` + + + **Example request**: + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Id": "4fa6e0f0c6786287e131c3852c58a2e01cc697a68231826813597e4994f1d6e2", + "Created": "2013-05-07T14:51:42.041847+02:00", + "Path": "date", + "Args": [], + "Config": { + "Hostname": "4fa6e0f0c678", + "User": "", + "Memory": 0, + "MemorySwap": 0, + "AttachStdin": false, + "AttachStdout": true, + "AttachStderr": true, + "PortSpecs": null, + "Tty": false, + "OpenStdin": false, + "StdinOnce": false, + "Env": null, + "Cmd": [ + "date" + ], + "Dns": null, + "Image": "base", + "Volumes": {}, + "VolumesFrom": "", + "WorkingDir":"" + + }, + "State": { + "Running": false, + "Pid": 0, + "ExitCode": 0, + "StartedAt": "2013-05-07T14:51:42.087658+02:01360", + "Ghost": false + }, + "Image": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "NetworkSettings": { + "IpAddress": "", + "IpPrefixLen": 0, + "Gateway": "", + "Bridge": "", + "PortMapping": null + }, + "SysInitPath": "/home/kitty/go/src/github.com/dotcloud/docker/bin/docker", + "ResolvConfPath": "/etc/resolv.conf", + "Volumes": {}, + "HostConfig": { + "Binds": null, + "ContainerIDFile": "", + "LxcConf": [], + "Privileged": false, + "PortBindings": { + "80/tcp": [ + { + "HostIp": "0.0.0.0", + "HostPort": "49153" + } + ] + }, + "Links": null, + "PublishAllPorts": false + } + } + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [List processes running inside a container](#id8) + + `GET /containers/`(*id*)`/top` +: List processes running inside the container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Titles":[ + "USER", + "PID", + "%CPU", + "%MEM", + "VSZ", + "RSS", + "TTY", + "STAT", + "START", + "TIME", + "COMMAND" + ], + "Processes":[ + ["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"], + ["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"] + ] + } + + Query Parameters: + +   + + - **ps\_args** – ps arguments to use (eg. aux) + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Inspect changes on a container’s filesystem](#id9) + + `GET /containers/`(*id*)`/changes` +: Inspect changes on container `id` ‘s filesystem + + **Example request**: + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Export a container](#id10) + + `GET /containers/`(*id*)`/export` +: Export the contents of container `id` + + **Example request**: + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Start a container](#id11) + + `POST /containers/`(*id*)`/start` +: Start the container `id` + + **Example request**: + + POST /containers/(id)/start HTTP/1.1 + Content-Type: application/json + + { + "Binds":["/tmp:/tmp"], + "LxcConf":{"lxc.utsname":"docker"}, + "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, + "PublishAllPorts":false, + "Privileged":false + } + + **Example response**: + + HTTP/1.1 204 No Content + Content-Type: text/plain + + Json Parameters: + +   + + - **Binds** – Create a bind mount to a directory or file with + [host-path]:[container-path]:[rw|ro]. If a directory + "container-path" is missing, then docker creates a new volume. + - **LxcConf** – Map of custom lxc options + - **PortBindings** – Expose ports from the container, optionally + publishing them via the HostPort flag + - **PublishAllPorts** – 1/True/true or 0/False/false, publish all + exposed ports to the host interfaces. Default false + - **Privileged** – 1/True/true or 0/False/false, give extended + privileges to this container. Default false + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Stop a container](#id12) + + `POST /containers/`(*id*)`/stop` +: Stop the container `id` + + **Example request**: + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Restart a container](#id13) + + `POST /containers/`(*id*)`/restart` +: Restart the container `id` + + **Example request**: + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **t** – number of seconds to wait before killing the container + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Kill a container](#id14) + + `POST /containers/`(*id*)`/kill` +: Kill the container `id` + + **Example request**: + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### [Attach to a container](#id15) + + `POST /containers/`(*id*)`/attach` +: Attach to the container `id` + + **Example request**: + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **logs** – 1/True/true or 0/False/false, return logs. Default + false + - **stream** – 1/True/true or 0/False/false, return stream. + Default false + - **stdin** – 1/True/true or 0/False/false, if stream=true, attach + to stdin. Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log, if stream=true, attach to stdout. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log, if stream=true, attach to stderr. Default false + + Status Codes: + + - **200** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + + **Stream details**: + + When using the TTY setting is enabled in + [`POST /containers/create` +](../../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. + When the TTY is disabled, then the stream is multiplexed to separate + stdout and stderr. + + The format is a **Header** and a **Payload** (frame). + + **HEADER** + + The header will contain the information on which stream write the + stream (stdout or stderr). It also contain the size of the + associated frame encoded on the last 4 bytes (uint32). + + It is encoded on the first 8 bytes like this: + + header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4} + + `STREAM_TYPE` can be: + + - 0: stdin (will be writen on stdout) + - 1: stdout + - 2: stderr + + `SIZE1, SIZE2, SIZE3, SIZE4` are the 4 bytes of + the uint32 size encoded as big endian. + + **PAYLOAD** + + The payload is the raw stream. + + **IMPLEMENTATION** + + The simplest way to implement the Attach protocol is the following: + + 1. Read 8 bytes + 2. chose stdout or stderr depending on the first byte + 3. Extract the frame size from the last 4 byets + 4. Read the extracted size and output it on the correct output + 5. Goto 1) + +#### [Wait a container](#id16) + + `POST /containers/`(*id*)`/wait` +: Block until container `id` stops, then returns + the exit code + + **Example request**: + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +#### [Remove a container](#id17) + + `DELETE /containers/`(*id*) +: Remove the container `id` from the filesystem + + **Example request**: + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 204 OK + + Query Parameters: + +   + + - **v** – 1/True/true or 0/False/false, Remove the volumes + associated to the container. Default false + + Status Codes: + + - **204** – no error + - **400** – bad parameter + - **404** – no such container + - **500** – server error + +#### [Copy files or folders from a container](#id18) + + `POST /containers/`(*id*)`/copy` +: Copy files or folders of container `id` + + **Example request**: + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + +### [2.2 Images](#id19) + +#### [List Images](#id20) + + `GET /images/json` +: **Example request**: + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "RepoTags": [ + "ubuntu:12.04", + "ubuntu:precise", + "ubuntu:latest" + ], + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Created": 1365714795, + "Size": 131506275, + "VirtualSize": 131506275 + }, + { + "RepoTags": [ + "ubuntu:12.10", + "ubuntu:quantal" + ], + "ParentId": "27cf784147099545", + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Created": 1364102658, + "Size": 24653, + "VirtualSize": 180116135 + } + ] + +#### [Create an image](#id21) + + `POST /images/create` +: Create an image, either by pull it from the registry or by importing + it + + **Example request**: + + POST /images/create?fromImage=base HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pulling..."} + {"status":"Pulling", "progress":"1 B/ 100 B", "progressDetail":{"current":1, "total":100}} + {"error":"Invalid..."} + ... + + When using this endpoint to pull an image from the registry, the + `X-Registry-Auth` header can be used to include + a base64-encoded AuthConfig object. + + Query Parameters: + +   + + - **fromImage** – name of the image to pull + - **fromSrc** – source to import, - means stdin + - **repo** – repository + - **tag** – tag + - **registry** – the registry to pull from + + Request Headers: + +   + + - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Insert a file in an image](#id22) + + `POST /images/`(*name*)`/insert` +: Insert a file from `url` in the image + `name` at `path` + + **Example request**: + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} + {"error":"Invalid..."} + ... + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Inspect an image](#id23) + + `GET /images/`(*name*)`/json` +: Return low-level information on the image `name` + + **Example request**: + + GET /images/base/json HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id":"b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "parent":"27cf784147099545", + "created":"2013-03-23T22:24:18.818426-07:00", + "container":"3d67245a8d72ecf13f33dffac9f79dcdf70f75acb84d308770391510e0c23ad0", + "container_config": + { + "Hostname":"", + "User":"", + "Memory":0, + "MemorySwap":0, + "AttachStdin":false, + "AttachStdout":false, + "AttachStderr":false, + "PortSpecs":null, + "Tty":true, + "OpenStdin":true, + "StdinOnce":false, + "Env":null, + "Cmd": ["/bin/bash"] + ,"Dns":null, + "Image":"base", + "Volumes":null, + "VolumesFrom":"", + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Get the history of an image](#id24) + + `GET /images/`(*name*)`/history` +: Return the history of the image `name` + + **Example request**: + + GET /images/base/history HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Push an image on the registry](#id25) + + `POST /images/`(*name*)`/push` +: Push the image `name` on the registry + + **Example request**: + + POST /images/test/push HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} + {"error":"Invalid..."} + ... + + Query Parameters: + +   + + - **registry** – the registry you wan to push, optional + + Request Headers: + +   + + - **X-Registry-Auth** – include a base64-encoded AuthConfig + object. + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### [Tag an image into a repository](#id26) + + `POST /images/`(*name*)`/tag` +: Tag the image `name` into a repository + + **Example request**: + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + + Query Parameters: + +   + + - **repo** – The repository to tag in + - **force** – 1/True/true or 0/False/false, default false + + Status Codes: + + - **201** – no error + - **400** – bad parameter + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Remove an image](#id27) + + `DELETE /images/`(*name*) +: Remove the image `name` from the filesystem + + **Example request**: + + DELETE /images/test HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + Status Codes: + + - **200** – no error + - **404** – no such image + - **409** – conflict + - **500** – server error + +#### [Search images](#id28) + + `GET /images/search` +: Search for an image in the docker index. + + Note + + The response keys have changed from API v1.6 to reflect the JSON + sent by the registry server to the docker daemon’s request. + + **Example request**: + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "wma55/u1210sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "jdswinbank/sshd", + "star_count": 0 + }, + { + "description": "", + "is_official": false, + "is_trusted": false, + "name": "vgauthier/sshd", + "star_count": 0 + } + ... + ] + + Query Parameters: + +   + + - **term** – term to search + + Status Codes: + + - **200** – no error + - **500** – server error + +### [2.3 Misc](#id29) + +#### [Build an image from Dockerfile via stdin](#id30) + + `POST /build` +: Build an image from Dockerfile via stdin + + **Example request**: + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"stream":"Step 1..."} + {"stream":"..."} + {"error":"Error...", "errorDetail":{"code": 123, "message": "Error..."}} + + The stream must be a tar archive compressed with one of the + following algorithms: identity (no compression), gzip, bzip2, xz. + + The archive must include a file called `Dockerfile` + at its root. It may include any number of other files, + which will be accessible in the build context (See the [*ADD build + command*](../../../builder/#dockerbuilder)). + + Query Parameters: + +   + + - **t** – repository name (and optionally a tag) to be applied to + the resulting image in case of success + - **q** – suppress verbose build output + - **nocache** – do not use the cache when building the image + + Request Headers: + +   + + - **Content-type** – should be set to + `"application/tar"`. + - **X-Registry-Auth** – base64-encoded AuthConfig object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Check auth configuration](#id31) + + `POST /auth` +: Get the default username and email + + **Example request**: + + POST /auth HTTP/1.1 + Content-Type: application/json + + { + "username":"hannibal", + "password:"xxxx", + "email":"hannibal@a-team.com", + "serveraddress":"https://index.docker.io/v1/" + } + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **204** – no error + - **500** – server error + +#### [Display system-wide information](#id32) + + `GET /info` +: Display system-wide information + + **Example request**: + + GET /info HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Containers":11, + "Images":16, + "Debug":false, + "NFd": 11, + "NGoroutines":21, + "MemoryLimit":true, + "SwapLimit":false, + "IPv4Forwarding":true + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Show the docker version information](#id33) + + `GET /version` +: Show the docker version information + + **Example request**: + + GET /version HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Create a new image from a container’s changes](#id34) + + `POST /commit` +: Create a new image from a container’s changes + + **Example request**: + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + Query Parameters: + +   + + - **container** – source container + - **repo** – repository + - **tag** – tag + - **m** – commit message + - **author** – author (eg. "John Hannibal Smith + \<[hannibal@a-team.com](mailto:hannibal%40a-team.com)\>") + - **run** – config automatically applied when the image is run. + (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) + + Status Codes: + + - **201** – no error + - **404** – no such container + - **500** – server error + +#### [Monitor Docker’s events](#id35) + + `GET /events` +: Get events from docker, either in real time via streaming, or via + polling (using since) + + **Example request**: + + GET /events?since=1374067924 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"create","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"start","id":"dfdf82bd3881","from":"base:latest","time":1374067924} + {"status":"stop","id":"dfdf82bd3881","from":"base:latest","time":1374067966} + {"status":"destroy","id":"dfdf82bd3881","from":"base:latest","time":1374067970} + + Query Parameters: + +   + + - **since** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Get a tarball containing all images and tags in a repository](#id36) + + `GET /images/`(*name*)`/get` +: Get a tarball containing all images and metadata for the repository + specified by `name`. + + **Example request** + + GET /images/ubuntu/get + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/x-tar + + Binary data stream + + Status Codes: + + - **200** – no error + - **500** – server error + +#### [Load a tarball with a set of images and tags into docker](#id37) + + `POST /images/load` +: Load a set of images and tags into the docker repository. + + **Example request** + + POST /images/load + + Tarball in body + + **Example response**: + + HTTP/1.1 200 OK + + Status Codes: + + - **200** – no error + - **500** – server error + +## [3. Going further](#id38) + +### [3.1 Inside ‘docker run’](#id39) + +Here are the steps of ‘docker run’ : + +- Create the container + +- If the status code is 404, it means the image doesn’t exists: + : - Try to pull it + - Then retry to create the container + +- Start the container + +- If you are not in detached mode: + : - Attach to the container, using logs=1 (to have stdout and + stderr from the container’s start) and stream=1 + +- If in detached mode or only stdin is attached: + : - Display the container’s id + +### [3.2 Hijacking](#id40) + +In this version of the API, /attach, uses hijacking to transport stdin, +stdout and stderr on the same socket. This might change in the future. + +### [3.3 CORS Requests](#id41) + +To enable cross origin requests to the remote api add the flag +"–api-enable-cors" when running docker in daemon mode. + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.8.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.8.rst similarity index 100% rename from docs/sources/reference/api/docker_remote_api_v1.8.rst rename to docs/sources/reference/api/archive/docker_remote_api_v1.8.rst diff --git a/docs/sources/reference/api/docker_io_accounts_api.rst b/docs/sources/reference/api/docker_io_accounts_api.rst index dc5c44d4a8..1ce75ca738 100644 --- a/docs/sources/reference/api/docker_io_accounts_api.rst +++ b/docs/sources/reference/api/docker_io_accounts_api.rst @@ -7,8 +7,6 @@ docker.io Accounts API ====================== -.. contents:: Table of Contents - 1. Endpoints ============ diff --git a/docs/sources/reference/api/docker_io_oauth_api.rst b/docs/sources/reference/api/docker_io_oauth_api.rst index d68dd8d36c..24d2af3adb 100644 --- a/docs/sources/reference/api/docker_io_oauth_api.rst +++ b/docs/sources/reference/api/docker_io_oauth_api.rst @@ -7,8 +7,6 @@ docker.io OAuth API =================== -.. contents:: Table of Contents - 1. Brief introduction ===================== diff --git a/docs/sources/reference/api/docker_remote_api.rst b/docs/sources/reference/api/docker_remote_api.rst index bd5598bcf2..1e90b1bbe3 100644 --- a/docs/sources/reference/api/docker_remote_api.rst +++ b/docs/sources/reference/api/docker_remote_api.rst @@ -98,8 +98,6 @@ v1.8 Full Documentation ------------------ -:doc:`docker_remote_api_v1.8` - What's new ---------- @@ -126,8 +124,6 @@ v1.7 Full Documentation ------------------ -:doc:`docker_remote_api_v1.7` - What's new ---------- @@ -230,8 +226,6 @@ v1.6 Full Documentation ------------------ -:doc:`docker_remote_api_v1.6` - What's new ---------- @@ -250,8 +244,6 @@ v1.5 Full Documentation ------------------ -:doc:`docker_remote_api_v1.5` - What's new ---------- @@ -277,8 +269,6 @@ v1.4 Full Documentation ------------------ -:doc:`docker_remote_api_v1.4` - What's new ---------- @@ -302,8 +292,6 @@ docker v0.5.0 51f6c4a_ Full Documentation ------------------ -:doc:`docker_remote_api_v1.3` - What's new ---------- @@ -344,8 +332,6 @@ docker v0.4.2 2e7649b_ Full Documentation ------------------ -:doc:`docker_remote_api_v1.2` - What's new ---------- @@ -379,8 +365,6 @@ docker v0.4.0 a8ae398_ Full Documentation ------------------ -:doc:`docker_remote_api_v1.1` - What's new ---------- @@ -408,8 +392,6 @@ docker v0.3.4 8d73740_ Full Documentation ------------------ -:doc:`docker_remote_api_v1.0` - What's new ---------- diff --git a/docs/sources/reference/api/docker_remote_api_v1.10.rst b/docs/sources/reference/api/docker_remote_api_v1.10.rst index 3d6af7e939..83e2c3c15b 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.10.rst +++ b/docs/sources/reference/api/docker_remote_api_v1.10.rst @@ -8,8 +8,6 @@ Docker Remote API v1.10 ======================= -.. contents:: Table of Contents - 1. Brief introduction ===================== diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.rst b/docs/sources/reference/api/docker_remote_api_v1.11.rst index 8c14b21c65..556491c49a 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.11.rst +++ b/docs/sources/reference/api/docker_remote_api_v1.11.rst @@ -8,8 +8,6 @@ Docker Remote API v1.11 ======================= -.. contents:: Table of Contents - 1. Brief introduction ===================== diff --git a/docs/sources/reference/api/docker_remote_api_v1.9.rst b/docs/sources/reference/api/docker_remote_api_v1.9.rst index 27812457bb..4bbffcbd36 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.9.rst +++ b/docs/sources/reference/api/docker_remote_api_v1.9.rst @@ -8,8 +8,6 @@ Docker Remote API v1.9 ====================== -.. contents:: Table of Contents - 1. Brief introduction ===================== diff --git a/docs/sources/reference/commandline/cli.rst b/docs/sources/reference/commandline/cli.rst index 366d5bb251..58ec24e066 100644 --- a/docs/sources/reference/commandline/cli.rst +++ b/docs/sources/reference/commandline/cli.rst @@ -4,8 +4,8 @@ .. _cli: -Command Line Help ------------------ +Command Line +============ To list available commands, either run ``docker`` with no parameters or execute ``docker help``:: @@ -20,8 +20,8 @@ To list available commands, either run ``docker`` with no parameters or execute .. _cli_options: -Options -------- +Option types +------------ Single character commandline options can be combined, so rather than typing ``docker run -t -i --name test busybox sh``, you can write @@ -56,11 +56,6 @@ Options like ``--name=""`` expect a string, and they can only be specified once. Options like ``-c=0`` expect an integer, and they can only be specified once. ----- - -Commands --------- - .. _cli_daemon: ``daemon`` diff --git a/docs/sources/reference/run.rst b/docs/sources/reference/run.rst index d2fe449c22..0e6247ea28 100644 --- a/docs/sources/reference/run.rst +++ b/docs/sources/reference/run.rst @@ -20,9 +20,6 @@ than any other ``docker`` command. Every one of the :ref:`example_list` shows running containers, and so here we try to give more in-depth guidance. -.. contents:: Table of Contents - :depth: 2 - .. _run_running: General Form diff --git a/docs/sources/robots.txt b/docs/sources/robots.txt new file mode 100644 index 0000000000..c2a49f4fb8 --- /dev/null +++ b/docs/sources/robots.txt @@ -0,0 +1,2 @@ +User-agent: * +Allow: / diff --git a/docs/sources/toctree.rst b/docs/sources/toctree.rst index d1f98b6a5d..d09bcc313c 100644 --- a/docs/sources/toctree.rst +++ b/docs/sources/toctree.rst @@ -10,7 +10,6 @@ This documentation has the following resources: .. toctree:: :maxdepth: 1 - Introduction installation/index use/index examples/index diff --git a/docs/theme/docker/layout.html b/docs/theme/docker/layout.html index 7d78fb9c3c..0dac9e0680 100755 --- a/docs/theme/docker/layout.html +++ b/docs/theme/docker/layout.html @@ -63,48 +63,6 @@ -
-
-
-
- -
- -
- - -
-
-
- -
- - -
- -
-
-

DOCUMENTATION

-
- - {{ toctree(collapse=False, maxdepth=3) }} -
- -
-
-
-
@@ -114,111 +72,7 @@ {% block body %}{% endblock %} -
Edit this article on GitHub
-
-
- - -
- - - - - - - - - - - - - diff --git a/docs/theme/mkdocs/autoindex.html b/docs/theme/mkdocs/autoindex.html new file mode 100644 index 0000000000..cc4a41ec94 --- /dev/null +++ b/docs/theme/mkdocs/autoindex.html @@ -0,0 +1,12 @@ +# Table of Contents + +{% for nav_item in nav %} + {% if nav_item.children %} +## {{ nav_item.title }} {{ nav_item.url }} + + {% for nav_item in nav_item.children %} +- [{{ nav_item.title }}]({{ nav_item.url }}) + {% endfor %} + + {% endif %} +{% endfor %} diff --git a/docs/theme/mkdocs/base.html b/docs/theme/mkdocs/base.html new file mode 100644 index 0000000000..56a9c70cb0 --- /dev/null +++ b/docs/theme/mkdocs/base.html @@ -0,0 +1,57 @@ + + + + + + + {% if page_description %}{% endif %} + {% if site_author %}{% endif %} + {% if canonical_url %}{% endif %} + + + + + + + {% if page_title != '**HIDDEN** - '+site_name %}{{ page_title }}{% else %}{{ site_name }}{% endif %} + {% if page_title != '**HIDDEN** - Docker' %}{{ page_title }}{% else %}{{ site_name }}{% endif %} + + + + +
+
+
{% include "nav.html" %}
+
+
+
+
+
+ {% include "toc.html" %} +
+
+ {% include "breadcrumbs.html" %} +
+ {{ content }} +
+
+
+
+
+
+
{% include "footer.html" %}
+
+
+ {% include "prev_next.html" %} + + + + + + + + + diff --git a/docs/theme/mkdocs/breadcrumbs.html b/docs/theme/mkdocs/breadcrumbs.html new file mode 100644 index 0000000000..5fa684432f --- /dev/null +++ b/docs/theme/mkdocs/breadcrumbs.html @@ -0,0 +1,15 @@ +
    +
    2. + {% for section in nav %} + {% if section.active %} + {% if section.children %} + {% for page in section.children[:1] %} +
  2. {{ section.title }}
    3. + {% endfor %} + {% endif %} + {% if section.children %} +
  3. {{ current_page.title }}
    4. + {% endif %} + {% endif %} + {% endfor %} +
\ No newline at end of file diff --git a/docs/theme/mkdocs/css/base.css b/docs/theme/mkdocs/css/base.css new file mode 100644 index 0000000000..822bb3ec0b --- /dev/null +++ b/docs/theme/mkdocs/css/base.css @@ -0,0 +1,735 @@ +html, +body { + margin: 0; + font-size: 14px; + background-color: #F0F0F0; + height: 100%; + width: 100%; + font-family: "Cabin", "Helvetica Neue", Helvetica, Arial, sans-serif; +} + +h1, +h2, +h3, +h4, +h5, +h6, +.h1, +.h2, +.h3, +.h4, +.h5, +.h6 { + font-family: "Cabin", "Helvetica Neue", Helvetica, Arial, sans-serif; + font-weight: 500; + line-height: 1.1; + color: inherit; +} + + +/* Content rendering styles */ +#content { + font-size: 1.2em; + line-height: 1.8em; +} +#content h1 { + color: #FF8100; + padding: 0.5em 0em 0em 0em; +} +#content h2 { + color: #FFA242; + padding: 0.5em 0em 0.3em 0em; +} +#content h3 { + color: #FFA242; + padding: 0.7em 0em 0.3em 0em; +} +#content ul { + margin: 1em 0em 1.2em 0.3em; +} +#content li { + margin: 0.5em 0em 0.3em 0em; +} +#content p { + margin-bottom: 1.2em; +} +#content pre { + margin: 2em 0em; + padding: 1em 2em !important; + line-height: 1.8em; + font-size: 1em; +} +#content blockquote { + background: #f2f2f2; + border-left-color: #ccc; +} +#content blockquote p { + line-height: 1.6em; + margin-bottom: 0em !important; +} +#content .search_input { + height: 30px; + color: #5992a3; + font-weight: bold; + padding: 10px 5px; + border: 1px solid #71afc0; + -webkit-border-radius: 3px; + -moz-border-radius: 3px; + border-radius: 3px; + background: #fff; +} +#content .search_input:focus { + background: #fff; + outline: none; + border-color: #71afc0; +} +#content .search_input::-webkit-input-placeholder { + color: #71afc0; +} +/* Content rendering END */ + +/* Fix bootstrap madding (//padding) issue(s) */ +.row { + margin-left: 0; + margin-right: 0; +} +[class^="col-"] > [class^="col-"]:first-child, +[class^="col-"] > [class*=" col-"]:first-child +[class*=" col-"] > [class^="col-"]:first-child, +[class*=" col-"]> [class*=" col-"]:first-child, +.row > [class^="col-"]:first-child, +.row > [class*=" col-"]:first-child{ + padding-left: 0px; +} +[class^="col-"] > [class^="col-"]:last-child, +[class^="col-"] > [class*=" col-"]:last-child +[class*=" col-"] > [class^="col-"]:last-child, +[class*=" col-"]> [class*=" col-"]:last-child, +.row > [class^="col-"]:last-child, +.row > [class*=" col-"]:last-child{ + padding-right: 0px; +} + + +.navbar { + border: none; +} + +/* Previous & Next floating navigation */ +#nav_prev_next { + position: fixed; + bottom: 0; right: 1em; + background: #fff !important; + border: 1px solid #ccc; + border-bottom: none; + list-style: none; + -webkit-border-radius: 7px 7px 0px 0px; + -moz-border-radius: 7px 7px 0px 0px; + border-radius: 7px 7px 0px 0px; +} +#nav_prev_next > li:hover > a { + background: none; +} +#nav_prev_next > li:hover > a > span { + color: #8fb0ba; +} +#nav_prev_next > li.prev { + text-align: right; +} +#nav_prev_next > li.next { + text-align: left; +} +#nav_prev_next > li > a { + padding: 0.5em 0.7em !important; +} +#nav_prev_next > li > a > span { + display: block; + color: #a4c9d4; +} + +/* Scroll to top button */ +#scroll_to_top { + position: fixed; + bottom: 0; left: 1em; + background: #fff !important; + border: 1px solid #ccc; + border-bottom: none; + list-style: none; + -webkit-border-radius: 7px 7px 0px 0px; + -moz-border-radius: 7px 7px 0px 0px; + border-radius: 7px 7px 0px 0px; + font-weight: bold; +} +#scroll_to_top > li:hover > a { + background: none; +} +#scroll_to_top > li:hover > a > span { + color: #8fb0ba; +} +#scroll_to_top > li.prev { + text-align: right; +} +#scroll_to_top > li.next { + text-align: left; +} +#scroll_to_top > li > a { + padding: 0.5em 0.7em !important; +} +#scroll_to_top > li > a > span { + display: block; + color: #a4c9d4; + min-width: 75px; +} + +/* Top navigation from Docker IO */ +#header { + margin-bottom: 0; + width: 100%; + height: 70px; + z-index: 10; + background-color: #f2f2f2; +} +#header .brand > img { + height: 70px; +} +#header ul li a { + padding: 25px 15px 25px 15px; + color: #777777; +} +#header .navbar-nav { + float: right; +} +#header .navbar-inner { + padding-right: 0px; + padding-left: 0px; +} +#header ul li.active { + color: #555555; + background-color: #d8d8d8; +} +#header ul li.active a:hover { + background-color: #d8d8d8; +} +/* Horizontal Thin Sticky Menu */ +#horizontal_thin_menu { + width: 100%; + background-color: #5992a3; + height: 30px; + color: white; + text-align: right; + padding: 5px 10px; +} +#horizontal_thin_menu a { + display: inline-block; + color: white; + padding: 0px 10px; +} + +/* Submenu (dropdown) styling */ +.dd_menu .dd_submenu { + display: none; + position: absolute; + top: 50px; + list-style: none; + margin: 0px; + margin-left: -15px; + font-size: 18px; + overflow-y: auto; + background: #fff; + border: 1px solid #ccc; + border-top: none; + border-bottom: 3px solid #ccc; + -webkit-border-radius: 0px 0px 4px 4px; + -moz-border-radius: 0px 0px 4px 4px; + border-radius: 0px 0px 4px 4px; +} +.dd_menu:hover .dd_submenu { + display: block; + padding: 0px; +} +.dd_menu:hover .dd_submenu > li:first-child { + border: none; +} +.dd_menu:hover .dd_submenu > li { + border-top: 1px solid #ddd; +} +.dd_menu:hover .dd_submenu > li.active > a { + border-color: #b1d5df; + color: #FF8100 !important; +} +.dd_menu:hover .dd_submenu > li:hover { + background: #eee; +} +.dd_menu:hover .dd_submenu > li > a { + padding: 0.6em 0.8em 0.4em 0.8em; + width: 100%; + display: block; +} + +/* Main Docs navigaton menu (horizontal) */ +#nav_menu { + position: relative; + width: 100%; + background-color: #71afc0; + padding: 0px 10px; + color: white; +} +#nav_menu > #docsnav > #nav_search_toggle { + display: none; + margin-top: 10px; +} +#nav_menu > #docsnav > #nav_search { + margin-top: 10px; +} +.search_input { + height: 30px; + color: #5992a3; + font-weight: bold; + padding: 10px 5px; + background: #b1d5df; + border: 1px solid #71afc0; + -webkit-border-radius: 3px; + -moz-border-radius: 3px; + border-radius: 3px; +} +.search_input:focus { + background: #fff; + outline: none; +} +.search_input::-webkit-input-placeholder { + color: #71afc0; +} +#nav_menu > #docsnav > #mobile_menu_button { + display: none; + float: left; + height: 50px; + font-size: 1.2em; + padding: 0em 14px; + padding-top: 12px; +} +#nav_menu > #docsnav > .arrow { + display: none; +} +#nav_menu > #docsnav > #main-nav { + height: 50px; + margin: 0px; + padding: 0em; +} +#nav_menu > #docsnav > #main-nav > li { + display: block; + padding: 0em 1em; + height: 100%; + padding-top: 12px; +} +#nav_menu > #docsnav > #main-nav > li.active { + background: #5992a3; +} +#nav_menu > #docsnav > #main-nav > li:hover { + background: #b1d5df; +} +#nav_menu > #docsnav > #main-nav > li > a { + color: #fff; + font-size: 1.2em; +} +#nav_menu > #docsnav > #main-nav > li:hover > a { + color: #5992a3; +} +#nav_menu > #docsnav > #main-nav > li > a > span > b { + border-top-color: #b1d5df !important; +} +#nav_menu > #docsnav > #main-nav > li:hover > a > span > b { + border-top-color: #71afc0 !important; +} +#nav_menu > #docsnav > #main-nav > li form { + margin-top: -12px; +} + +/* TOC (Left) */ +#toc_table { + margin-right: 1em; +} +#toc_table > h2 { + margin: 0px; + font-size: 1.7em; + font-weight: bold; + color: #4291d1; + text-align: center; +} +#toc_table > h3 { + font-size: 1em; + color: #71afc0; + text-align: center; +} +#toc_table > #toc_navigation { + margin-top: 1.5em !important; + background: #fff; + border-bottom: 3px solid #ddd; + border: 1px solid #eee; + -webkit-border-radius: 4px; + -moz-border-radius: 4px; + border-radius: 4px; +} +#toc_table > #toc_navigation > li { + font-size: 1.2em; + padding-bottom: 0px; + padding: 0.2em 0.5em; + border-bottom: 1px solid #ddd; + text-align: justify; +} +#toc_table > #toc_navigation > li > a { + padding: 0.4em 0.5em 0.4em 0em; +} +#toc_table > #toc_navigation > li > a:hover { + color: #71afc0; + background: none; + text-decoration: underline; +} +#toc_table > #toc_navigation > li > a > .active_icon { + display: none; + text-decoration: none; + width: 1.5em; + margin-top: 0.2em; +} +#toc_table > #toc_navigation > li.active > a > .active_icon { + display: block; + float: left; +} +#toc_table > #toc_navigation > li > a > .passive_icon { + text-decoration: none; + margin-right: 0.3em; + margin-top: 0.2em; +} +#toc_table > #toc_navigation > li.active > a > .passive_icon { + display: none; + float: left; +} + +#toc_table > #toc_navigation > li.active > a { + font-weight: bold; + color: #FF8100; +} +#toc_table .bs-sidenav { + margin: 0; +} + +/* Main content area */ +#content { + margin-left: -15px; + min-height: 500px; +} +ol.breadcrumb { + margin-left: -15px; + background: #fff; + border-bottom: 3px solid #ccc; +} +ol.breadcrumb > li + li:before { + content: "\3E"; +} +ol.breadcrumb > li:last-child > a { + font-weight: bold; +} +#content h1 { + margin-top: 0px; +} + +/* Footer from original CSSs */ +@media (min-width: 960px) { + #footer { + height: 450px; + } + #footer .container { + max-width: 952px; + } + footer, + .footer { + margin-top: 160px; + } + footer .ligaturesymbols, + .footer .ligaturesymbols { + font-size: 30px; + color: black; + } + footer .ligaturesymbols a, + .footer .ligaturesymbols a { + color: black; + } + footer .footerlist, + .footer .footerlist { + float: left; + margin: 3px; + margin-right: 30px; + } + footer .footer-items-right, + .footer .footer-items-right { + text-align: right; + margin-top: -6px; + float: right; + } + footer .footer-licence, + .footer .footer-licence { + line-height: 2em; + } + footer form, + .footer form { + margin-bottom: 0px; + } + .footer-landscape-image { + bottom: 0; + width: 100%; + margin-bottom: 0; + background-image: url('../img/website-footer_clean.svg'); + background-repeat: repeat-x; + height: 450px; + position: relative; + clear: both + } + .social { + margin-left: 0px; + margin-top: 15px; + } + .social .twitter, + .social .github, + .social .googleplus, + .social .facebook, + .social .slideshare, + .social .linkedin, + .social .flickr, + .social .youtube, + .social .reddit { + background: url("../img/social/docker_social_logos.png") no-repeat transparent; + display: inline-block; + height: 32px; + overflow: hidden; + text-indent: 9999px; + width: 32px; + margin-right: 5px; + } + .social :hover { + -webkit-transform: rotate(-10deg); + -moz-transform: rotate(-10deg); + -o-transform: rotate(-10deg); + -ms-transform: rotate(-10deg); + transform: rotate(-10deg); + } + .social .twitter { + background-position: -160px 0px; + } + .social .reddit { + background-position: -256px 0px; + } + .social .github { + background-position: -64px 0px; + } + .social .googleplus { + background-position: -96px 0px; + } + .social .facebook { + background-position: 0px 0px; + } + .social .slideshare { + background-position: -128px 0px; + } + .social .youtube { + background-position: -192px 0px; + } + .social .flickr { + background-position: -32px 0px; + } + .social .linkedin { + background-position: -224px 0px; + } + ul.unstyled, + ol.unstyled { + margin-left: -40px; + list-style: none; + } +} + +/***************************** +* Mobile CSS Adjustments * +*****************************/ + +/* Horizontal nav. (menu & thin menu) convenience fix for Tablets */ +@media (min-width: 768px) and (max-width: 952px) { + + #docsnav, #horizontal_thin_menu { + width: 100% !important; + } + +} + +@media (max-width: 767px) { + + /* TOC Table (Left) */ + #toc_table { + padding: 1em; + margin: 0em -15px 15px 0em; + -webkit-border-radius: 4px; + -moz-border-radius: 4px; + border-radius: 4px; + cursor: pointer; + background: #fff; + border-bottom: 3px solid #ccc; + } + #toc_table > h2 { + margin-bottom: 0.3em; + font-size: 2em; + } + #toc_table > h3 { + display: block; + margin: 0; + } + #toc_table > #toc_navigation { + display: none; + margin-top: 1em !important; + border: none; + background: #f2f2f2; + } + #toc_table > #toc_navigation > li > a > .passive_icon { + display: block; + display: inline-block; + } + #toc_table > #toc_navigation > li > a > .active_icon { + display: none; + } + +} + +/* Container responsiveness fixes to maximise realestate expenditure */ +.container { + width: 100% !important; +} +.container-standard-sized { + max-width: 1050px; +} +.container-better { + max-width: 1050px; +} + +@media (max-width: 900px) { + + #nav_menu { + padding-left: 0px !important; + padding-right: 0px !important; + } + + /* Dropdown Submenu adjust */ + .dd_menu .dd_submenu > li > a { + padding: 1em 0.8em 0.7em 0.8em !important; + min-width: 10em; + } + + /* Disable breadcrumbs */ + ol.breadcrumb { + display: none; + } + + /* Shrink main navigation menu to one item (i.e., form breadcrumbs) */ + #nav_menu > #docsnav > #main-nav > li { + display: none; + } + #nav_menu > #docsnav > #main-nav > li.active { + display: block; + background: #71afc0; + } + #nav_menu > #docsnav > #main-nav > li.active:hover { + background: #b1d5df; + } + #nav_menu > #docsnav > #mobile_menu_button { + display: block; + } + #nav_menu > #docsnav > #mobile_menu_button:hover { + background: #b1d5df; + } + #nav_menu > #docsnav > #mobile_menu_button > b { + border-top-color: #b1d5df !important; + } + #nav_menu > #docsnav > #mobile_menu_button:hover > b { + border-top-color: #71afc0 !important; + } + #nav_menu > #docsnav > .arrow { + display: block; + } + + /* Prev Next for Mobile */ + #nav_prev_next { + background: #f2f2f2; + border-bottom: none; + list-style: none; + -webkit-border-radius: 7px 0px 0px 7px; + -moz-border-radius: 7px 0px 0px 7px; + border-radius: 7px 0px 0px 7px; + border: 1px solid #ccc; + font-weight: bold !important; + } + #nav_prev_next > li > a { + padding: 0.5em 0.7em !important; + } + #nav_prev_next > li > a > span, i { + display: none; + } + + /* Scroll up */ + #scroll_to_top { + background: #f2f2f2; + border-bottom: none; + list-style: none; + -webkit-border-radius: 0px 7px 7px 0px; + -moz-border-radius: 0px 7px 7px 0px; + border-radius: 0px 7px 7px 0px; + border: 1px solid #ccc; + } + #scroll_to_top > li > a { + padding: 0.5em 0.7em !important; + } + #scroll_to_top > li > a > span, i { + display: none; + } + + /* Main Content Clip */ + #content { + max-width: 100%; + } + + /* Thin menu (login - signup) */ + #horizontal_thin_menu { display: none; } + + #header #nav_docker_io { + display: none; + } + + #header #condensed_docker_io_nav { + display: block; + } +} + +@media (min-width: 999px) { + /* Hide in-content search box for desktop */ + #content .search_input { + display: none; + } +} + +@media (max-width: 1025px) { + + /* Search on mobile */ + #nav_menu > #docsnav > #nav_search { + display: none; + } + #nav_menu > #docsnav > #nav_search_toggle { + display: block; + margin-top: 10px; + margin-right: 0.5em; + } + + /* Show in-content search box for desktop */ + #content .search_input { + display: block; + } + + #nav_menu > #docsnav { + padding-left: 0px !important; + padding-right: 0px !important; + } + +} \ No newline at end of file diff --git a/docs/theme/mkdocs/css/bootstrap-custom.css b/docs/theme/mkdocs/css/bootstrap-custom.css new file mode 100644 index 0000000000..6aef1f6fd6 --- /dev/null +++ b/docs/theme/mkdocs/css/bootstrap-custom.css @@ -0,0 +1,7098 @@ +/*! + * Bootstrap v3.0.2 by @fat and @mdo + * Copyright 2013 Twitter, Inc. + * Licensed under http://www.apache.org/licenses/LICENSE-2.0 + * + * Designed and built with all the love in the world by @mdo and @fat. + */ + +/*! normalize.css v2.1.3 | MIT License | git.io/normalize */ + +article, +aside, +details, +figcaption, +figure, +footer, +header, +hgroup, +main, +nav, +section, +summary { + display: block; +} + +audio, +canvas, +video { + display: inline-block; +} + +audio:not([controls]) { + display: none; + height: 0; +} + +[hidden], +template { + display: none; +} + +html { + font-family: sans-serif; + -webkit-text-size-adjust: 100%; + -ms-text-size-adjust: 100%; +} + +body { + margin: 0; +} + +a { + background: transparent; +} + +a:focus { + outline: thin dotted; +} + +a:active, +a:hover { + outline: 0; +} + +h1 { + margin: 0.67em 0; + font-size: 2em; +} + +abbr[title] { + border-bottom: 1px dotted; +} + +b, +strong { + font-weight: bold; +} + +dfn { + font-style: italic; +} + +hr { + height: 0; + -moz-box-sizing: content-box; + box-sizing: content-box; +} + +mark { + color: #000; + background: #ff0; +} + +code, +kbd, +pre, +samp { + font-family: monospace, serif; + font-size: 1em; +} + +pre { + white-space: pre-wrap; +} + +q { + quotes: "\201C" "\201D" "\2018" "\2019"; +} + +small { + font-size: 80%; +} + +sub, +sup { + position: relative; + font-size: 75%; + line-height: 0; + vertical-align: baseline; +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +img { + border: 0; +} + +svg:not(:root) { + overflow: hidden; +} + +figure { + margin: 0; +} + +fieldset { + padding: 0.35em 0.625em 0.75em; + margin: 0 2px; + border: 1px solid #c0c0c0; +} + +legend { + padding: 0; + border: 0; +} + +button, +input, +select, +textarea { + margin: 0; + font-family: inherit; + font-size: 100%; +} + +button, +input { + line-height: normal; +} + +button, +select { + text-transform: none; +} + +button, +html input[type="button"], +input[type="reset"], +input[type="submit"] { + cursor: pointer; + -webkit-appearance: button; +} + +button[disabled], +html input[disabled] { + cursor: default; +} + +input[type="checkbox"], +input[type="radio"] { + padding: 0; + box-sizing: border-box; +} + +input[type="search"] { + -webkit-box-sizing: content-box; + -moz-box-sizing: content-box; + box-sizing: content-box; + -webkit-appearance: textfield; +} + +input[type="search"]::-webkit-search-cancel-button, +input[type="search"]::-webkit-search-decoration { + -webkit-appearance: none; +} + +button::-moz-focus-inner, +input::-moz-focus-inner { + padding: 0; + border: 0; +} + +textarea { + overflow: auto; + vertical-align: top; +} + +table { + border-collapse: collapse; + border-spacing: 0; +} + +@media print { + * { + color: #000 !important; + text-shadow: none !important; + background: transparent !important; + box-shadow: none !important; + } + a, + a:visited { + text-decoration: underline; + } + a[href]:after { + content: " (" attr(href) ")"; + } + abbr[title]:after { + content: " (" attr(title) ")"; + } + a[href^="javascript:"]:after, + a[href^="#"]:after { + content: ""; + } + pre, + blockquote { + border: 1px solid #999; + page-break-inside: avoid; + } + thead { + display: table-header-group; + } + tr, + img { + page-break-inside: avoid; + } + img { + max-width: 100% !important; + } + @page { + margin: 2cm .5cm; + } + p, + h2, + h3 { + orphans: 3; + widows: 3; + } + h2, + h3 { + page-break-after: avoid; + } + select { + background: #fff !important; + } + .navbar { + display: none; + } + .table td, + .table th { + background-color: #fff !important; + } + .btn > .caret, + .dropup > .btn > .caret { + border-top-color: #000 !important; + } + .label { + border: 1px solid #000; + } + .table { + border-collapse: collapse !important; + } + .table-bordered th, + .table-bordered td { + border: 1px solid #ddd !important; + } +} + +*, +*:before, +*:after { + -webkit-box-sizing: border-box; + -moz-box-sizing: border-box; + box-sizing: border-box; +} + +html { + font-size: 62.5%; + -webkit-tap-highlight-color: rgba(0, 0, 0, 0); +} + +body { + font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; + font-size: 14px; + line-height: 1.428571429; + color: #333333; + background-color: #ffffff; +} + +input, +button, +select, +textarea { + font-family: inherit; + font-size: inherit; + line-height: inherit; +} + +a { + color: #428bca; + text-decoration: none; +} + +a:hover, +a:focus { + color: #2a6496; + text-decoration: underline; +} + +a:focus { + outline: thin dotted #333; + outline: 5px auto -webkit-focus-ring-color; + outline-offset: -2px; +} + +img { + vertical-align: middle; +} + +.img-responsive { + display: block; + height: auto; + max-width: 100%; +} + +.img-rounded { + border-radius: 6px; +} + +.img-thumbnail { + display: inline-block; + height: auto; + max-width: 100%; + padding: 4px; + line-height: 1.428571429; + background-color: #ffffff; + border: 1px solid #dddddd; + border-radius: 4px; + -webkit-transition: all 0.2s ease-in-out; + transition: all 0.2s ease-in-out; +} + +.img-circle { + border-radius: 50%; +} + +hr { + margin-top: 20px; + margin-bottom: 20px; + border: 0; + border-top: 1px solid #eeeeee; +} + +.sr-only { + position: absolute; + width: 1px; + height: 1px; + padding: 0; + margin: -1px; + overflow: hidden; + clip: rect(0, 0, 0, 0); + border: 0; +} + +p { + margin: 0 0 10px; +} + +.lead { + margin-bottom: 20px; + font-size: 16px; + font-weight: 200; + line-height: 1.4; +} + +@media (min-width: 768px) { + .lead { + font-size: 21px; + } +} + +small, +.small { + font-size: 85%; +} + +cite { + font-style: normal; +} + +.text-muted { + color: #999999; +} + +.text-primary { + color: #428bca; +} + +.text-primary:hover { + color: #3071a9; +} + +.text-warning { + color: #c09853; +} + +.text-warning:hover { + color: #a47e3c; +} + +.text-danger { + color: #b94a48; +} + +.text-danger:hover { + color: #953b39; +} + +.text-success { + color: #468847; +} + +.text-success:hover { + color: #356635; +} + +.text-info { + color: #3a87ad; +} + +.text-info:hover { + color: #2d6987; +} + +.text-left { + text-align: left; +} + +.text-right { + text-align: right; +} + +.text-center { + text-align: center; +} + +h1, +h2, +h3, +h4, +h5, +h6, +.h1, +.h2, +.h3, +.h4, +.h5, +.h6 { + font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; + font-weight: 500; + line-height: 1.1; + color: inherit; +} + +h1 small, +h2 small, +h3 small, +h4 small, +h5 small, +h6 small, +.h1 small, +.h2 small, +.h3 small, +.h4 small, +.h5 small, +.h6 small, +h1 .small, +h2 .small, +h3 .small, +h4 .small, +h5 .small, +h6 .small, +.h1 .small, +.h2 .small, +.h3 .small, +.h4 .small, +.h5 .small, +.h6 .small { + font-weight: normal; + line-height: 1; + color: #999999; +} + +h1, +h2, +h3 { + margin-top: 20px; + margin-bottom: 10px; +} + +h1 small, +h2 small, +h3 small, +h1 .small, +h2 .small, +h3 .small { + font-size: 65%; +} + +h4, +h5, +h6 { + margin-top: 10px; + margin-bottom: 10px; +} + +h4 small, +h5 small, +h6 small, +h4 .small, +h5 .small, +h6 .small { + font-size: 75%; +} + +h1, +.h1 { + font-size: 36px; +} + +h2, +.h2 { + font-size: 30px; +} + +h3, +.h3 { + font-size: 24px; +} + +h4, +.h4 { + font-size: 18px; +} + +h5, +.h5 { + font-size: 14px; +} + +h6, +.h6 { + font-size: 12px; +} + +.page-header { + padding-bottom: 9px; + margin: 40px 0 20px; + border-bottom: 1px solid #eeeeee; +} + +ul, +ol { + margin-top: 0; + margin-bottom: 10px; +} + +ul ul, +ol ul, +ul ol, +ol ol { + margin-bottom: 0; +} + +.list-unstyled { + padding-left: 0; + list-style: none; +} + +.list-inline { + padding-left: 0; + list-style: none; +} + +.list-inline > li { + display: inline-block; + padding-right: 5px; + padding-left: 5px; +} + +.list-inline > li:first-child { + padding-left: 0; +} + +dl { + margin-bottom: 20px; +} + +dt, +dd { + line-height: 1.428571429; +} + +dt { + font-weight: bold; +} + +dd { + margin-left: 0; +} + +@media (min-width: 768px) { + .dl-horizontal dt { + float: left; + width: 160px; + overflow: hidden; + clear: left; + text-align: right; + text-overflow: ellipsis; + white-space: nowrap; + } + .dl-horizontal dd { + margin-left: 180px; + } + .dl-horizontal dd:before, + .dl-horizontal dd:after { + display: table; + content: " "; + } + .dl-horizontal dd:after { + clear: both; + } + .dl-horizontal dd:before, + .dl-horizontal dd:after { + display: table; + content: " "; + } + .dl-horizontal dd:after { + clear: both; + } +} + +abbr[title], +abbr[data-original-title] { + cursor: help; + border-bottom: 1px dotted #999999; +} + +abbr.initialism { + font-size: 90%; + text-transform: uppercase; +} + +blockquote { + padding: 10px 20px; + margin: 0 0 20px; + border-left: 5px solid #eeeeee; +} + +blockquote p { + font-size: 17.5px; + font-weight: 300; + line-height: 1.25; +} + +blockquote p:last-child { + margin-bottom: 0; +} + +blockquote small { + display: block; + line-height: 1.428571429; + color: #999999; +} + +blockquote small:before { + content: '\2014 \00A0'; +} + +blockquote.pull-right { + padding-right: 15px; + padding-left: 0; + border-right: 5px solid #eeeeee; + border-left: 0; +} + +blockquote.pull-right p, +blockquote.pull-right small, +blockquote.pull-right .small { + text-align: right; +} + +blockquote.pull-right small:before, +blockquote.pull-right .small:before { + content: ''; +} + +blockquote.pull-right small:after, +blockquote.pull-right .small:after { + content: '\00A0 \2014'; +} + +blockquote:before, +blockquote:after { + content: ""; +} + +address { + margin-bottom: 20px; + font-style: normal; + line-height: 1.428571429; +} + +code, +kbd, +pre, +samp { + font-family: Monaco, Menlo, Consolas, "Courier New", monospace; +} + +code { + padding: 2px 4px; + font-size: 90%; + color: #c7254e; + white-space: nowrap; + background-color: #f9f2f4; + border-radius: 4px; +} + +pre { + display: block; + padding: 9.5px; + margin: 0 0 10px; + font-size: 13px; + line-height: 1.428571429; + color: #333333; + word-break: break-all; + word-wrap: break-word; + background-color: #f5f5f5; + border: 1px solid #cccccc; + border-radius: 4px; +} + +pre code { + padding: 0; + font-size: inherit; + color: inherit; + white-space: pre-wrap; + background-color: transparent; + border-radius: 0; +} + +.pre-scrollable { + max-height: 340px; + overflow-y: scroll; +} + +.container { + padding-right: 15px; + padding-left: 15px; + margin-right: auto; + margin-left: auto; +} + +.container:before, +.container:after { + display: table; + content: " "; +} + +.container:after { + clear: both; +} + +.container:before, +.container:after { + display: table; + content: " "; +} + +.container:after { + clear: both; +} + +.row { + margin-right: -15px; + margin-left: -15px; +} + +.row:before, +.row:after { + display: table; + content: " "; +} + +.row:after { + clear: both; +} + +.row:before, +.row:after { + display: table; + content: " "; +} + +.row:after { + clear: both; +} + +.col-xs-1, +.col-sm-1, +.col-md-1, +.col-lg-1, +.col-xs-2, +.col-sm-2, +.col-md-2, +.col-lg-2, +.col-xs-3, +.col-sm-3, +.col-md-3, +.col-lg-3, +.col-xs-4, +.col-sm-4, +.col-md-4, +.col-lg-4, +.col-xs-5, +.col-sm-5, +.col-md-5, +.col-lg-5, +.col-xs-6, +.col-sm-6, +.col-md-6, +.col-lg-6, +.col-xs-7, +.col-sm-7, +.col-md-7, +.col-lg-7, +.col-xs-8, +.col-sm-8, +.col-md-8, +.col-lg-8, +.col-xs-9, +.col-sm-9, +.col-md-9, +.col-lg-9, +.col-xs-10, +.col-sm-10, +.col-md-10, +.col-lg-10, +.col-xs-11, +.col-sm-11, +.col-md-11, +.col-lg-11, +.col-xs-12, +.col-sm-12, +.col-md-12, +.col-lg-12 { + position: relative; + min-height: 1px; + padding-right: 15px; + padding-left: 15px; +} + +.col-xs-1, +.col-xs-2, +.col-xs-3, +.col-xs-4, +.col-xs-5, +.col-xs-6, +.col-xs-7, +.col-xs-8, +.col-xs-9, +.col-xs-10, +.col-xs-11 { + float: left; +} + +.col-xs-12 { + width: 100%; +} + +.col-xs-11 { + width: 91.66666666666666%; +} + +.col-xs-10 { + width: 83.33333333333334%; +} + +.col-xs-9 { + width: 75%; +} + +.col-xs-8 { + width: 66.66666666666666%; +} + +.col-xs-7 { + width: 58.333333333333336%; +} + +.col-xs-6 { + width: 50%; +} + +.col-xs-5 { + width: 41.66666666666667%; +} + +.col-xs-4 { + width: 33.33333333333333%; +} + +.col-xs-3 { + width: 25%; +} + +.col-xs-2 { + width: 16.666666666666664%; +} + +.col-xs-1 { + width: 8.333333333333332%; +} + +.col-xs-pull-12 { + right: 100%; +} + +.col-xs-pull-11 { + right: 91.66666666666666%; +} + +.col-xs-pull-10 { + right: 83.33333333333334%; +} + +.col-xs-pull-9 { + right: 75%; +} + +.col-xs-pull-8 { + right: 66.66666666666666%; +} + +.col-xs-pull-7 { + right: 58.333333333333336%; +} + +.col-xs-pull-6 { + right: 50%; +} + +.col-xs-pull-5 { + right: 41.66666666666667%; +} + +.col-xs-pull-4 { + right: 33.33333333333333%; +} + +.col-xs-pull-3 { + right: 25%; +} + +.col-xs-pull-2 { + right: 16.666666666666664%; +} + +.col-xs-pull-1 { + right: 8.333333333333332%; +} + +.col-xs-pull-0 { + right: 0; +} + +.col-xs-push-12 { + left: 100%; +} + +.col-xs-push-11 { + left: 91.66666666666666%; +} + +.col-xs-push-10 { + left: 83.33333333333334%; +} + +.col-xs-push-9 { + left: 75%; +} + +.col-xs-push-8 { + left: 66.66666666666666%; +} + +.col-xs-push-7 { + left: 58.333333333333336%; +} + +.col-xs-push-6 { + left: 50%; +} + +.col-xs-push-5 { + left: 41.66666666666667%; +} + +.col-xs-push-4 { + left: 33.33333333333333%; +} + +.col-xs-push-3 { + left: 25%; +} + +.col-xs-push-2 { + left: 16.666666666666664%; +} + +.col-xs-push-1 { + left: 8.333333333333332%; +} + +.col-xs-push-0 { + left: 0; +} + +.col-xs-offset-12 { + margin-left: 100%; +} + +.col-xs-offset-11 { + margin-left: 91.66666666666666%; +} + +.col-xs-offset-10 { + margin-left: 83.33333333333334%; +} + +.col-xs-offset-9 { + margin-left: 75%; +} + +.col-xs-offset-8 { + margin-left: 66.66666666666666%; +} + +.col-xs-offset-7 { + margin-left: 58.333333333333336%; +} + +.col-xs-offset-6 { + margin-left: 50%; +} + +.col-xs-offset-5 { + margin-left: 41.66666666666667%; +} + +.col-xs-offset-4 { + margin-left: 33.33333333333333%; +} + +.col-xs-offset-3 { + margin-left: 25%; +} + +.col-xs-offset-2 { + margin-left: 16.666666666666664%; +} + +.col-xs-offset-1 { + margin-left: 8.333333333333332%; +} + +.col-xs-offset-0 { + margin-left: 0; +} + +@media (min-width: 768px) { + .container { + width: 750px; + } + .col-sm-1, + .col-sm-2, + .col-sm-3, + .col-sm-4, + .col-sm-5, + .col-sm-6, + .col-sm-7, + .col-sm-8, + .col-sm-9, + .col-sm-10, + .col-sm-11 { + float: left; + } + .col-sm-12 { + width: 100%; + } + .col-sm-11 { + width: 91.66666666666666%; + } + .col-sm-10 { + width: 83.33333333333334%; + } + .col-sm-9 { + width: 75%; + } + .col-sm-8 { + width: 66.66666666666666%; + } + .col-sm-7 { + width: 58.333333333333336%; + } + .col-sm-6 { + width: 50%; + } + .col-sm-5 { + width: 41.66666666666667%; + } + .col-sm-4 { + width: 33.33333333333333%; + } + .col-sm-3 { + width: 25%; + } + .col-sm-2 { + width: 16.666666666666664%; + } + .col-sm-1 { + width: 8.333333333333332%; + } + .col-sm-pull-12 { + right: 100%; + } + .col-sm-pull-11 { + right: 91.66666666666666%; + } + .col-sm-pull-10 { + right: 83.33333333333334%; + } + .col-sm-pull-9 { + right: 75%; + } + .col-sm-pull-8 { + right: 66.66666666666666%; + } + .col-sm-pull-7 { + right: 58.333333333333336%; + } + .col-sm-pull-6 { + right: 50%; + } + .col-sm-pull-5 { + right: 41.66666666666667%; + } + .col-sm-pull-4 { + right: 33.33333333333333%; + } + .col-sm-pull-3 { + right: 25%; + } + .col-sm-pull-2 { + right: 16.666666666666664%; + } + .col-sm-pull-1 { + right: 8.333333333333332%; + } + .col-sm-pull-0 { + right: 0; + } + .col-sm-push-12 { + left: 100%; + } + .col-sm-push-11 { + left: 91.66666666666666%; + } + .col-sm-push-10 { + left: 83.33333333333334%; + } + .col-sm-push-9 { + left: 75%; + } + .col-sm-push-8 { + left: 66.66666666666666%; + } + .col-sm-push-7 { + left: 58.333333333333336%; + } + .col-sm-push-6 { + left: 50%; + } + .col-sm-push-5 { + left: 41.66666666666667%; + } + .col-sm-push-4 { + left: 33.33333333333333%; + } + .col-sm-push-3 { + left: 25%; + } + .col-sm-push-2 { + left: 16.666666666666664%; + } + .col-sm-push-1 { + left: 8.333333333333332%; + } + .col-sm-push-0 { + left: 0; + } + .col-sm-offset-12 { + margin-left: 100%; + } + .col-sm-offset-11 { + margin-left: 91.66666666666666%; + } + .col-sm-offset-10 { + margin-left: 83.33333333333334%; + } + .col-sm-offset-9 { + margin-left: 75%; + } + .col-sm-offset-8 { + margin-left: 66.66666666666666%; + } + .col-sm-offset-7 { + margin-left: 58.333333333333336%; + } + .col-sm-offset-6 { + margin-left: 50%; + } + .col-sm-offset-5 { + margin-left: 41.66666666666667%; + } + .col-sm-offset-4 { + margin-left: 33.33333333333333%; + } + .col-sm-offset-3 { + margin-left: 25%; + } + .col-sm-offset-2 { + margin-left: 16.666666666666664%; + } + .col-sm-offset-1 { + margin-left: 8.333333333333332%; + } + .col-sm-offset-0 { + margin-left: 0; + } +} + +@media (min-width: 992px) { + .container { + width: 970px; + } + .col-md-1, + .col-md-2, + .col-md-3, + .col-md-4, + .col-md-5, + .col-md-6, + .col-md-7, + .col-md-8, + .col-md-9, + .col-md-10, + .col-md-11 { + float: left; + } + .col-md-12 { + width: 100%; + } + .col-md-11 { + width: 91.66666666666666%; + } + .col-md-10 { + width: 83.33333333333334%; + } + .col-md-9 { + width: 75%; + } + .col-md-8 { + width: 66.66666666666666%; + } + .col-md-7 { + width: 58.333333333333336%; + } + .col-md-6 { + width: 50%; + } + .col-md-5 { + width: 41.66666666666667%; + } + .col-md-4 { + width: 33.33333333333333%; + } + .col-md-3 { + width: 25%; + } + .col-md-2 { + width: 16.666666666666664%; + } + .col-md-1 { + width: 8.333333333333332%; + } + .col-md-pull-12 { + right: 100%; + } + .col-md-pull-11 { + right: 91.66666666666666%; + } + .col-md-pull-10 { + right: 83.33333333333334%; + } + .col-md-pull-9 { + right: 75%; + } + .col-md-pull-8 { + right: 66.66666666666666%; + } + .col-md-pull-7 { + right: 58.333333333333336%; + } + .col-md-pull-6 { + right: 50%; + } + .col-md-pull-5 { + right: 41.66666666666667%; + } + .col-md-pull-4 { + right: 33.33333333333333%; + } + .col-md-pull-3 { + right: 25%; + } + .col-md-pull-2 { + right: 16.666666666666664%; + } + .col-md-pull-1 { + right: 8.333333333333332%; + } + .col-md-pull-0 { + right: 0; + } + .col-md-push-12 { + left: 100%; + } + .col-md-push-11 { + left: 91.66666666666666%; + } + .col-md-push-10 { + left: 83.33333333333334%; + } + .col-md-push-9 { + left: 75%; + } + .col-md-push-8 { + left: 66.66666666666666%; + } + .col-md-push-7 { + left: 58.333333333333336%; + } + .col-md-push-6 { + left: 50%; + } + .col-md-push-5 { + left: 41.66666666666667%; + } + .col-md-push-4 { + left: 33.33333333333333%; + } + .col-md-push-3 { + left: 25%; + } + .col-md-push-2 { + left: 16.666666666666664%; + } + .col-md-push-1 { + left: 8.333333333333332%; + } + .col-md-push-0 { + left: 0; + } + .col-md-offset-12 { + margin-left: 100%; + } + .col-md-offset-11 { + margin-left: 91.66666666666666%; + } + .col-md-offset-10 { + margin-left: 83.33333333333334%; + } + .col-md-offset-9 { + margin-left: 75%; + } + .col-md-offset-8 { + margin-left: 66.66666666666666%; + } + .col-md-offset-7 { + margin-left: 58.333333333333336%; + } + .col-md-offset-6 { + margin-left: 50%; + } + .col-md-offset-5 { + margin-left: 41.66666666666667%; + } + .col-md-offset-4 { + margin-left: 33.33333333333333%; + } + .col-md-offset-3 { + margin-left: 25%; + } + .col-md-offset-2 { + margin-left: 16.666666666666664%; + } + .col-md-offset-1 { + margin-left: 8.333333333333332%; + } + .col-md-offset-0 { + margin-left: 0; + } +} + +@media (min-width: 1200px) { + .container { + width: 1170px; + } + .col-lg-1, + .col-lg-2, + .col-lg-3, + .col-lg-4, + .col-lg-5, + .col-lg-6, + .col-lg-7, + .col-lg-8, + .col-lg-9, + .col-lg-10, + .col-lg-11 { + float: left; + } + .col-lg-12 { + width: 100%; + } + .col-lg-11 { + width: 91.66666666666666%; + } + .col-lg-10 { + width: 83.33333333333334%; + } + .col-lg-9 { + width: 75%; + } + .col-lg-8 { + width: 66.66666666666666%; + } + .col-lg-7 { + width: 58.333333333333336%; + } + .col-lg-6 { + width: 50%; + } + .col-lg-5 { + width: 41.66666666666667%; + } + .col-lg-4 { + width: 33.33333333333333%; + } + .col-lg-3 { + width: 25%; + } + .col-lg-2 { + width: 16.666666666666664%; + } + .col-lg-1 { + width: 8.333333333333332%; + } + .col-lg-pull-12 { + right: 100%; + } + .col-lg-pull-11 { + right: 91.66666666666666%; + } + .col-lg-pull-10 { + right: 83.33333333333334%; + } + .col-lg-pull-9 { + right: 75%; + } + .col-lg-pull-8 { + right: 66.66666666666666%; + } + .col-lg-pull-7 { + right: 58.333333333333336%; + } + .col-lg-pull-6 { + right: 50%; + } + .col-lg-pull-5 { + right: 41.66666666666667%; + } + .col-lg-pull-4 { + right: 33.33333333333333%; + } + .col-lg-pull-3 { + right: 25%; + } + .col-lg-pull-2 { + right: 16.666666666666664%; + } + .col-lg-pull-1 { + right: 8.333333333333332%; + } + .col-lg-pull-0 { + right: 0; + } + .col-lg-push-12 { + left: 100%; + } + .col-lg-push-11 { + left: 91.66666666666666%; + } + .col-lg-push-10 { + left: 83.33333333333334%; + } + .col-lg-push-9 { + left: 75%; + } + .col-lg-push-8 { + left: 66.66666666666666%; + } + .col-lg-push-7 { + left: 58.333333333333336%; + } + .col-lg-push-6 { + left: 50%; + } + .col-lg-push-5 { + left: 41.66666666666667%; + } + .col-lg-push-4 { + left: 33.33333333333333%; + } + .col-lg-push-3 { + left: 25%; + } + .col-lg-push-2 { + left: 16.666666666666664%; + } + .col-lg-push-1 { + left: 8.333333333333332%; + } + .col-lg-push-0 { + left: 0; + } + .col-lg-offset-12 { + margin-left: 100%; + } + .col-lg-offset-11 { + margin-left: 91.66666666666666%; + } + .col-lg-offset-10 { + margin-left: 83.33333333333334%; + } + .col-lg-offset-9 { + margin-left: 75%; + } + .col-lg-offset-8 { + margin-left: 66.66666666666666%; + } + .col-lg-offset-7 { + margin-left: 58.333333333333336%; + } + .col-lg-offset-6 { + margin-left: 50%; + } + .col-lg-offset-5 { + margin-left: 41.66666666666667%; + } + .col-lg-offset-4 { + margin-left: 33.33333333333333%; + } + .col-lg-offset-3 { + margin-left: 25%; + } + .col-lg-offset-2 { + margin-left: 16.666666666666664%; + } + .col-lg-offset-1 { + margin-left: 8.333333333333332%; + } + .col-lg-offset-0 { + margin-left: 0; + } +} + +table { + max-width: 100%; + background-color: transparent; +} + +th { + text-align: left; +} + +.table { + width: 100%; + margin-bottom: 20px; +} + +.table > thead > tr > th, +.table > tbody > tr > th, +.table > tfoot > tr > th, +.table > thead > tr > td, +.table > tbody > tr > td, +.table > tfoot > tr > td { + padding: 8px; + line-height: 1.428571429; + vertical-align: top; + border-top: 1px solid #dddddd; +} + +.table > thead > tr > th { + vertical-align: bottom; + border-bottom: 2px solid #dddddd; +} + +.table > caption + thead > tr:first-child > th, +.table > colgroup + thead > tr:first-child > th, +.table > thead:first-child > tr:first-child > th, +.table > caption + thead > tr:first-child > td, +.table > colgroup + thead > tr:first-child > td, +.table > thead:first-child > tr:first-child > td { + border-top: 0; +} + +.table > tbody + tbody { + border-top: 2px solid #dddddd; +} + +.table .table { + background-color: #ffffff; +} + +.table-condensed > thead > tr > th, +.table-condensed > tbody > tr > th, +.table-condensed > tfoot > tr > th, +.table-condensed > thead > tr > td, +.table-condensed > tbody > tr > td, +.table-condensed > tfoot > tr > td { + padding: 5px; +} + +.table-bordered { + border: 1px solid #dddddd; +} + +.table-bordered > thead > tr > th, +.table-bordered > tbody > tr > th, +.table-bordered > tfoot > tr > th, +.table-bordered > thead > tr > td, +.table-bordered > tbody > tr > td, +.table-bordered > tfoot > tr > td { + border: 1px solid #dddddd; +} + +.table-bordered > thead > tr > th, +.table-bordered > thead > tr > td { + border-bottom-width: 2px; +} + +.table-striped > tbody > tr:nth-child(odd) > td, +.table-striped > tbody > tr:nth-child(odd) > th { + background-color: #f9f9f9; +} + +.table-hover > tbody > tr:hover > td, +.table-hover > tbody > tr:hover > th { + background-color: #f5f5f5; +} + +table col[class*="col-"] { + display: table-column; + float: none; +} + +table td[class*="col-"], +table th[class*="col-"] { + display: table-cell; + float: none; +} + +.table > thead > tr > td.active, +.table > tbody > tr > td.active, +.table > tfoot > tr > td.active, +.table > thead > tr > th.active, +.table > tbody > tr > th.active, +.table > tfoot > tr > th.active, +.table > thead > tr.active > td, +.table > tbody > tr.active > td, +.table > tfoot > tr.active > td, +.table > thead > tr.active > th, +.table > tbody > tr.active > th, +.table > tfoot > tr.active > th { + background-color: #f5f5f5; +} + +.table > thead > tr > td.success, +.table > tbody > tr > td.success, +.table > tfoot > tr > td.success, +.table > thead > tr > th.success, +.table > tbody > tr > th.success, +.table > tfoot > tr > th.success, +.table > thead > tr.success > td, +.table > tbody > tr.success > td, +.table > tfoot > tr.success > td, +.table > thead > tr.success > th, +.table > tbody > tr.success > th, +.table > tfoot > tr.success > th { + background-color: #dff0d8; +} + +.table-hover > tbody > tr > td.success:hover, +.table-hover > tbody > tr > th.success:hover, +.table-hover > tbody > tr.success:hover > td, +.table-hover > tbody > tr.success:hover > th { + background-color: #d0e9c6; +} + +.table > thead > tr > td.danger, +.table > tbody > tr > td.danger, +.table > tfoot > tr > td.danger, +.table > thead > tr > th.danger, +.table > tbody > tr > th.danger, +.table > tfoot > tr > th.danger, +.table > thead > tr.danger > td, +.table > tbody > tr.danger > td, +.table > tfoot > tr.danger > td, +.table > thead > tr.danger > th, +.table > tbody > tr.danger > th, +.table > tfoot > tr.danger > th { + background-color: #f2dede; +} + +.table-hover > tbody > tr > td.danger:hover, +.table-hover > tbody > tr > th.danger:hover, +.table-hover > tbody > tr.danger:hover > td, +.table-hover > tbody > tr.danger:hover > th { + background-color: #ebcccc; +} + +.table > thead > tr > td.warning, +.table > tbody > tr > td.warning, +.table > tfoot > tr > td.warning, +.table > thead > tr > th.warning, +.table > tbody > tr > th.warning, +.table > tfoot > tr > th.warning, +.table > thead > tr.warning > td, +.table > tbody > tr.warning > td, +.table > tfoot > tr.warning > td, +.table > thead > tr.warning > th, +.table > tbody > tr.warning > th, +.table > tfoot > tr.warning > th { + background-color: #fcf8e3; +} + +.table-hover > tbody > tr > td.warning:hover, +.table-hover > tbody > tr > th.warning:hover, +.table-hover > tbody > tr.warning:hover > td, +.table-hover > tbody > tr.warning:hover > th { + background-color: #faf2cc; +} + +@media (max-width: 767px) { + .table-responsive { + width: 100%; + margin-bottom: 15px; + overflow-x: scroll; + overflow-y: hidden; + border: 1px solid #dddddd; + -ms-overflow-style: -ms-autohiding-scrollbar; + -webkit-overflow-scrolling: touch; + } + .table-responsive > .table { + margin-bottom: 0; + } + .table-responsive > .table > thead > tr > th, + .table-responsive > .table > tbody > tr > th, + .table-responsive > .table > tfoot > tr > th, + .table-responsive > .table > thead > tr > td, + .table-responsive > .table > tbody > tr > td, + .table-responsive > .table > tfoot > tr > td { + white-space: nowrap; + } + .table-responsive > .table-bordered { + border: 0; + } + .table-responsive > .table-bordered > thead > tr > th:first-child, + .table-responsive > .table-bordered > tbody > tr > th:first-child, + .table-responsive > .table-bordered > tfoot > tr > th:first-child, + .table-responsive > .table-bordered > thead > tr > td:first-child, + .table-responsive > .table-bordered > tbody > tr > td:first-child, + .table-responsive > .table-bordered > tfoot > tr > td:first-child { + border-left: 0; + } + .table-responsive > .table-bordered > thead > tr > th:last-child, + .table-responsive > .table-bordered > tbody > tr > th:last-child, + .table-responsive > .table-bordered > tfoot > tr > th:last-child, + .table-responsive > .table-bordered > thead > tr > td:last-child, + .table-responsive > .table-bordered > tbody > tr > td:last-child, + .table-responsive > .table-bordered > tfoot > tr > td:last-child { + border-right: 0; + } + .table-responsive > .table-bordered > tbody > tr:last-child > th, + .table-responsive > .table-bordered > tfoot > tr:last-child > th, + .table-responsive > .table-bordered > tbody > tr:last-child > td, + .table-responsive > .table-bordered > tfoot > tr:last-child > td { + border-bottom: 0; + } +} + +fieldset { + padding: 0; + margin: 0; + border: 0; +} + +legend { + display: block; + width: 100%; + padding: 0; + margin-bottom: 20px; + font-size: 21px; + line-height: inherit; + color: #333333; + border: 0; + border-bottom: 1px solid #e5e5e5; +} + +label { + display: inline-block; + margin-bottom: 5px; + font-weight: bold; +} + +input[type="search"] { + -webkit-box-sizing: border-box; + -moz-box-sizing: border-box; + box-sizing: border-box; +} + +input[type="radio"], +input[type="checkbox"] { + margin: 4px 0 0; + margin-top: 1px \9; + /* IE8-9 */ + + line-height: normal; +} + +input[type="file"] { + display: block; +} + +select[multiple], +select[size] { + height: auto; +} + +select optgroup { + font-family: inherit; + font-size: inherit; + font-style: inherit; +} + +input[type="file"]:focus, +input[type="radio"]:focus, +input[type="checkbox"]:focus { + outline: thin dotted #333; + outline: 5px auto -webkit-focus-ring-color; + outline-offset: -2px; +} + +input[type="number"]::-webkit-outer-spin-button, +input[type="number"]::-webkit-inner-spin-button { + height: auto; +} + +output { + display: block; + padding-top: 7px; + font-size: 14px; + line-height: 1.428571429; + color: #555555; + vertical-align: middle; +} + +.form-control { + display: block; + width: 100%; + height: 34px; + padding: 6px 12px; + font-size: 14px; + line-height: 1.428571429; + color: #555555; + vertical-align: middle; + background-color: #ffffff; + background-image: none; + border: 1px solid #cccccc; + border-radius: 4px; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); + -webkit-transition: border-color ease-in-out 0.15s, box-shadow ease-in-out 0.15s; + transition: border-color ease-in-out 0.15s, box-shadow ease-in-out 0.15s; +} + +.form-control:focus { + border-color: #66afe9; + outline: 0; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(102, 175, 233, 0.6); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(102, 175, 233, 0.6); +} + +.form-control:-moz-placeholder { + color: #999999; +} + +.form-control::-moz-placeholder { + color: #999999; +} + +.form-control:-ms-input-placeholder { + color: #999999; +} + +.form-control::-webkit-input-placeholder { + color: #999999; +} + +.form-control[disabled], +.form-control[readonly], +fieldset[disabled] .form-control { + cursor: not-allowed; + background-color: #eeeeee; +} + +textarea.form-control { + height: auto; +} + +.form-group { + margin-bottom: 15px; +} + +.radio, +.checkbox { + display: block; + min-height: 20px; + padding-left: 20px; + margin-top: 10px; + margin-bottom: 10px; + vertical-align: middle; +} + +.radio label, +.checkbox label { + display: inline; + margin-bottom: 0; + font-weight: normal; + cursor: pointer; +} + +.radio input[type="radio"], +.radio-inline input[type="radio"], +.checkbox input[type="checkbox"], +.checkbox-inline input[type="checkbox"] { + float: left; + margin-left: -20px; +} + +.radio + .radio, +.checkbox + .checkbox { + margin-top: -5px; +} + +.radio-inline, +.checkbox-inline { + display: inline-block; + padding-left: 20px; + margin-bottom: 0; + font-weight: normal; + vertical-align: middle; + cursor: pointer; +} + +.radio-inline + .radio-inline, +.checkbox-inline + .checkbox-inline { + margin-top: 0; + margin-left: 10px; +} + +input[type="radio"][disabled], +input[type="checkbox"][disabled], +.radio[disabled], +.radio-inline[disabled], +.checkbox[disabled], +.checkbox-inline[disabled], +fieldset[disabled] input[type="radio"], +fieldset[disabled] input[type="checkbox"], +fieldset[disabled] .radio, +fieldset[disabled] .radio-inline, +fieldset[disabled] .checkbox, +fieldset[disabled] .checkbox-inline { + cursor: not-allowed; +} + +.input-sm { + height: 30px; + padding: 5px 10px; + font-size: 12px; + line-height: 1.5; + border-radius: 3px; +} + +select.input-sm { + height: 30px; + line-height: 30px; +} + +textarea.input-sm { + height: auto; +} + +.input-lg { + height: 45px; + padding: 10px 16px; + font-size: 18px; + line-height: 1.33; + border-radius: 6px; +} + +select.input-lg { + height: 45px; + line-height: 45px; +} + +textarea.input-lg { + height: auto; +} + +.has-warning .help-block, +.has-warning .control-label, +.has-warning .radio, +.has-warning .checkbox, +.has-warning .radio-inline, +.has-warning .checkbox-inline { + color: #c09853; +} + +.has-warning .form-control { + border-color: #c09853; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); +} + +.has-warning .form-control:focus { + border-color: #a47e3c; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #dbc59e; + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #dbc59e; +} + +.has-warning .input-group-addon { + color: #c09853; + background-color: #fcf8e3; + border-color: #c09853; +} + +.has-error .help-block, +.has-error .control-label, +.has-error .radio, +.has-error .checkbox, +.has-error .radio-inline, +.has-error .checkbox-inline { + color: #b94a48; +} + +.has-error .form-control { + border-color: #b94a48; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); +} + +.has-error .form-control:focus { + border-color: #953b39; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #d59392; + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #d59392; +} + +.has-error .input-group-addon { + color: #b94a48; + background-color: #f2dede; + border-color: #b94a48; +} + +.has-success .help-block, +.has-success .control-label, +.has-success .radio, +.has-success .checkbox, +.has-success .radio-inline, +.has-success .checkbox-inline { + color: #468847; +} + +.has-success .form-control { + border-color: #468847; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); +} + +.has-success .form-control:focus { + border-color: #356635; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7aba7b; + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7aba7b; +} + +.has-success .input-group-addon { + color: #468847; + background-color: #dff0d8; + border-color: #468847; +} + +.form-control-static { + margin-bottom: 0; +} + +.help-block { + display: block; + margin-top: 5px; + margin-bottom: 10px; + color: #737373; +} + +@media (min-width: 768px) { + .form-inline .form-group { + display: inline-block; + margin-bottom: 0; + vertical-align: middle; + } + .form-inline .form-control { + display: inline-block; + } + .form-inline .radio, + .form-inline .checkbox { + display: inline-block; + padding-left: 0; + margin-top: 0; + margin-bottom: 0; + } + .form-inline .radio input[type="radio"], + .form-inline .checkbox input[type="checkbox"] { + float: none; + margin-left: 0; + } +} + +.form-horizontal .control-label, +.form-horizontal .radio, +.form-horizontal .checkbox, +.form-horizontal .radio-inline, +.form-horizontal .checkbox-inline { + padding-top: 7px; + margin-top: 0; + margin-bottom: 0; +} + +.form-horizontal .form-group { + margin-right: -15px; + margin-left: -15px; +} + +.form-horizontal .form-group:before, +.form-horizontal .form-group:after { + display: table; + content: " "; +} + +.form-horizontal .form-group:after { + clear: both; +} + +.form-horizontal .form-group:before, +.form-horizontal .form-group:after { + display: table; + content: " "; +} + +.form-horizontal .form-group:after { + clear: both; +} + +.form-horizontal .form-control-static { + padding-top: 7px; +} + +@media (min-width: 768px) { + .form-horizontal .control-label { + text-align: right; + } +} + +.btn { + display: inline-block; + padding: 6px 12px; + margin-bottom: 0; + font-size: 14px; + font-weight: normal; + line-height: 1.428571429; + text-align: center; + white-space: nowrap; + vertical-align: middle; + cursor: pointer; + background-image: none; + border: 1px solid transparent; + border-radius: 4px; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + -o-user-select: none; + user-select: none; +} + +.btn:focus { + outline: thin dotted #333; + outline: 5px auto -webkit-focus-ring-color; + outline-offset: -2px; +} + +.btn:hover, +.btn:focus { + color: #333333; + text-decoration: none; +} + +.btn:active, +.btn.active { + background-image: none; + outline: 0; + -webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); + box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); +} + +.btn.disabled, +.btn[disabled], +fieldset[disabled] .btn { + pointer-events: none; + cursor: not-allowed; + opacity: 0.65; + filter: alpha(opacity=65); + -webkit-box-shadow: none; + box-shadow: none; +} + +.btn-default { + color: #333333; + background-color: #ffffff; + border-color: #cccccc; +} + +.btn-default:hover, +.btn-default:focus, +.btn-default:active, +.btn-default.active, +.open .dropdown-toggle.btn-default { + color: #333333; + background-color: #ebebeb; + border-color: #adadad; +} + +.btn-default:active, +.btn-default.active, +.open .dropdown-toggle.btn-default { + background-image: none; +} + +.btn-default.disabled, +.btn-default[disabled], +fieldset[disabled] .btn-default, +.btn-default.disabled:hover, +.btn-default[disabled]:hover, +fieldset[disabled] .btn-default:hover, +.btn-default.disabled:focus, +.btn-default[disabled]:focus, +fieldset[disabled] .btn-default:focus, +.btn-default.disabled:active, +.btn-default[disabled]:active, +fieldset[disabled] .btn-default:active, +.btn-default.disabled.active, +.btn-default[disabled].active, +fieldset[disabled] .btn-default.active { + background-color: #ffffff; + border-color: #cccccc; +} + +.btn-primary { + color: #ffffff; + background-color: #428bca; + border-color: #357ebd; +} + +.btn-primary:hover, +.btn-primary:focus, +.btn-primary:active, +.btn-primary.active, +.open .dropdown-toggle.btn-primary { + color: #ffffff; + background-color: #3276b1; + border-color: #285e8e; +} + +.btn-primary:active, +.btn-primary.active, +.open .dropdown-toggle.btn-primary { + background-image: none; +} + +.btn-primary.disabled, +.btn-primary[disabled], +fieldset[disabled] .btn-primary, +.btn-primary.disabled:hover, +.btn-primary[disabled]:hover, +fieldset[disabled] .btn-primary:hover, +.btn-primary.disabled:focus, +.btn-primary[disabled]:focus, +fieldset[disabled] .btn-primary:focus, +.btn-primary.disabled:active, +.btn-primary[disabled]:active, +fieldset[disabled] .btn-primary:active, +.btn-primary.disabled.active, +.btn-primary[disabled].active, +fieldset[disabled] .btn-primary.active { + background-color: #428bca; + border-color: #357ebd; +} + +.btn-warning { + color: #ffffff; + background-color: #f0ad4e; + border-color: #eea236; +} + +.btn-warning:hover, +.btn-warning:focus, +.btn-warning:active, +.btn-warning.active, +.open .dropdown-toggle.btn-warning { + color: #ffffff; + background-color: #ed9c28; + border-color: #d58512; +} + +.btn-warning:active, +.btn-warning.active, +.open .dropdown-toggle.btn-warning { + background-image: none; +} + +.btn-warning.disabled, +.btn-warning[disabled], +fieldset[disabled] .btn-warning, +.btn-warning.disabled:hover, +.btn-warning[disabled]:hover, +fieldset[disabled] .btn-warning:hover, +.btn-warning.disabled:focus, +.btn-warning[disabled]:focus, +fieldset[disabled] .btn-warning:focus, +.btn-warning.disabled:active, +.btn-warning[disabled]:active, +fieldset[disabled] .btn-warning:active, +.btn-warning.disabled.active, +.btn-warning[disabled].active, +fieldset[disabled] .btn-warning.active { + background-color: #f0ad4e; + border-color: #eea236; +} + +.btn-danger { + color: #ffffff; + background-color: #d9534f; + border-color: #d43f3a; +} + +.btn-danger:hover, +.btn-danger:focus, +.btn-danger:active, +.btn-danger.active, +.open .dropdown-toggle.btn-danger { + color: #ffffff; + background-color: #d2322d; + border-color: #ac2925; +} + +.btn-danger:active, +.btn-danger.active, +.open .dropdown-toggle.btn-danger { + background-image: none; +} + +.btn-danger.disabled, +.btn-danger[disabled], +fieldset[disabled] .btn-danger, +.btn-danger.disabled:hover, +.btn-danger[disabled]:hover, +fieldset[disabled] .btn-danger:hover, +.btn-danger.disabled:focus, +.btn-danger[disabled]:focus, +fieldset[disabled] .btn-danger:focus, +.btn-danger.disabled:active, +.btn-danger[disabled]:active, +fieldset[disabled] .btn-danger:active, +.btn-danger.disabled.active, +.btn-danger[disabled].active, +fieldset[disabled] .btn-danger.active { + background-color: #d9534f; + border-color: #d43f3a; +} + +.btn-success { + color: #ffffff; + background-color: #5cb85c; + border-color: #4cae4c; +} + +.btn-success:hover, +.btn-success:focus, +.btn-success:active, +.btn-success.active, +.open .dropdown-toggle.btn-success { + color: #ffffff; + background-color: #47a447; + border-color: #398439; +} + +.btn-success:active, +.btn-success.active, +.open .dropdown-toggle.btn-success { + background-image: none; +} + +.btn-success.disabled, +.btn-success[disabled], +fieldset[disabled] .btn-success, +.btn-success.disabled:hover, +.btn-success[disabled]:hover, +fieldset[disabled] .btn-success:hover, +.btn-success.disabled:focus, +.btn-success[disabled]:focus, +fieldset[disabled] .btn-success:focus, +.btn-success.disabled:active, +.btn-success[disabled]:active, +fieldset[disabled] .btn-success:active, +.btn-success.disabled.active, +.btn-success[disabled].active, +fieldset[disabled] .btn-success.active { + background-color: #5cb85c; + border-color: #4cae4c; +} + +.btn-info { + color: #ffffff; + background-color: #5bc0de; + border-color: #46b8da; +} + +.btn-info:hover, +.btn-info:focus, +.btn-info:active, +.btn-info.active, +.open .dropdown-toggle.btn-info { + color: #ffffff; + background-color: #39b3d7; + border-color: #269abc; +} + +.btn-info:active, +.btn-info.active, +.open .dropdown-toggle.btn-info { + background-image: none; +} + +.btn-info.disabled, +.btn-info[disabled], +fieldset[disabled] .btn-info, +.btn-info.disabled:hover, +.btn-info[disabled]:hover, +fieldset[disabled] .btn-info:hover, +.btn-info.disabled:focus, +.btn-info[disabled]:focus, +fieldset[disabled] .btn-info:focus, +.btn-info.disabled:active, +.btn-info[disabled]:active, +fieldset[disabled] .btn-info:active, +.btn-info.disabled.active, +.btn-info[disabled].active, +fieldset[disabled] .btn-info.active { + background-color: #5bc0de; + border-color: #46b8da; +} + +.btn-link { + font-weight: normal; + color: #428bca; + cursor: pointer; + border-radius: 0; +} + +.btn-link, +.btn-link:active, +.btn-link[disabled], +fieldset[disabled] .btn-link { + background-color: transparent; + -webkit-box-shadow: none; + box-shadow: none; +} + +.btn-link, +.btn-link:hover, +.btn-link:focus, +.btn-link:active { + border-color: transparent; +} + +.btn-link:hover, +.btn-link:focus { + color: #2a6496; + text-decoration: underline; + background-color: transparent; +} + +.btn-link[disabled]:hover, +fieldset[disabled] .btn-link:hover, +.btn-link[disabled]:focus, +fieldset[disabled] .btn-link:focus { + color: #999999; + text-decoration: none; +} + +.btn-lg { + padding: 10px 16px; + font-size: 18px; + line-height: 1.33; + border-radius: 6px; +} + +.btn-sm, +.btn-xs { + padding: 5px 10px; + font-size: 12px; + line-height: 1.5; + border-radius: 3px; +} + +.btn-xs { + padding: 1px 5px; +} + +.btn-block { + display: block; + width: 100%; + padding-right: 0; + padding-left: 0; +} + +.btn-block + .btn-block { + margin-top: 5px; +} + +input[type="submit"].btn-block, +input[type="reset"].btn-block, +input[type="button"].btn-block { + width: 100%; +} + +.fade { + opacity: 0; + -webkit-transition: opacity 0.15s linear; + transition: opacity 0.15s linear; +} + +.fade.in { + opacity: 1; +} + +.collapse { + display: none; +} + +.collapse.in { + display: block; +} + +.collapsing { + position: relative; + height: 0; + overflow: hidden; + -webkit-transition: height 0.35s ease; + transition: height 0.35s ease; +} + +@font-face { + font-family: 'Glyphicons Halflings'; + src: url('../fonts/glyphicons-halflings-regular.eot'); + src: url('../fonts/glyphicons-halflings-regular.eot?#iefix') format('embedded-opentype'), url('../fonts/glyphicons-halflings-regular.woff') format('woff'), url('../fonts/glyphicons-halflings-regular.ttf') format('truetype'), url('../fonts/glyphicons-halflings-regular.svg#glyphicons_halflingsregular') format('svg'); +} + +.glyphicon { + position: relative; + top: 1px; + display: inline-block; + font-family: 'Glyphicons Halflings'; + -webkit-font-smoothing: antialiased; + font-style: normal; + font-weight: normal; + line-height: 1; + -moz-osx-font-smoothing: grayscale; +} + +.glyphicon:empty { + width: 1em; +} + +.glyphicon-asterisk:before { + content: "\2a"; +} + +.glyphicon-plus:before { + content: "\2b"; +} + +.glyphicon-euro:before { + content: "\20ac"; +} + +.glyphicon-minus:before { + content: "\2212"; +} + +.glyphicon-cloud:before { + content: "\2601"; +} + +.glyphicon-envelope:before { + content: "\2709"; +} + +.glyphicon-pencil:before { + content: "\270f"; +} + +.glyphicon-glass:before { + content: "\e001"; +} + +.glyphicon-music:before { + content: "\e002"; +} + +.glyphicon-search:before { + content: "\e003"; +} + +.glyphicon-heart:before { + content: "\e005"; +} + +.glyphicon-star:before { + content: "\e006"; +} + +.glyphicon-star-empty:before { + content: "\e007"; +} + +.glyphicon-user:before { + content: "\e008"; +} + +.glyphicon-film:before { + content: "\e009"; +} + +.glyphicon-th-large:before { + content: "\e010"; +} + +.glyphicon-th:before { + content: "\e011"; +} + +.glyphicon-th-list:before { + content: "\e012"; +} + +.glyphicon-ok:before { + content: "\e013"; +} + +.glyphicon-remove:before { + content: "\e014"; +} + +.glyphicon-zoom-in:before { + content: "\e015"; +} + +.glyphicon-zoom-out:before { + content: "\e016"; +} + +.glyphicon-off:before { + content: "\e017"; +} + +.glyphicon-signal:before { + content: "\e018"; +} + +.glyphicon-cog:before { + content: "\e019"; +} + +.glyphicon-trash:before { + content: "\e020"; +} + +.glyphicon-home:before { + content: "\e021"; +} + +.glyphicon-file:before { + content: "\e022"; +} + +.glyphicon-time:before { + content: "\e023"; +} + +.glyphicon-road:before { + content: "\e024"; +} + +.glyphicon-download-alt:before { + content: "\e025"; +} + +.glyphicon-download:before { + content: "\e026"; +} + +.glyphicon-upload:before { + content: "\e027"; +} + +.glyphicon-inbox:before { + content: "\e028"; +} + +.glyphicon-play-circle:before { + content: "\e029"; +} + +.glyphicon-repeat:before { + content: "\e030"; +} + +.glyphicon-refresh:before { + content: "\e031"; +} + +.glyphicon-list-alt:before { + content: "\e032"; +} + +.glyphicon-lock:before { + content: "\e033"; +} + +.glyphicon-flag:before { + content: "\e034"; +} + +.glyphicon-headphones:before { + content: "\e035"; +} + +.glyphicon-volume-off:before { + content: "\e036"; +} + +.glyphicon-volume-down:before { + content: "\e037"; +} + +.glyphicon-volume-up:before { + content: "\e038"; +} + +.glyphicon-qrcode:before { + content: "\e039"; +} + +.glyphicon-barcode:before { + content: "\e040"; +} + +.glyphicon-tag:before { + content: "\e041"; +} + +.glyphicon-tags:before { + content: "\e042"; +} + +.glyphicon-book:before { + content: "\e043"; +} + +.glyphicon-bookmark:before { + content: "\e044"; +} + +.glyphicon-print:before { + content: "\e045"; +} + +.glyphicon-camera:before { + content: "\e046"; +} + +.glyphicon-font:before { + content: "\e047"; +} + +.glyphicon-bold:before { + content: "\e048"; +} + +.glyphicon-italic:before { + content: "\e049"; +} + +.glyphicon-text-height:before { + content: "\e050"; +} + +.glyphicon-text-width:before { + content: "\e051"; +} + +.glyphicon-align-left:before { + content: "\e052"; +} + +.glyphicon-align-center:before { + content: "\e053"; +} + +.glyphicon-align-right:before { + content: "\e054"; +} + +.glyphicon-align-justify:before { + content: "\e055"; +} + +.glyphicon-list:before { + content: "\e056"; +} + +.glyphicon-indent-left:before { + content: "\e057"; +} + +.glyphicon-indent-right:before { + content: "\e058"; +} + +.glyphicon-facetime-video:before { + content: "\e059"; +} + +.glyphicon-picture:before { + content: "\e060"; +} + +.glyphicon-map-marker:before { + content: "\e062"; +} + +.glyphicon-adjust:before { + content: "\e063"; +} + +.glyphicon-tint:before { + content: "\e064"; +} + +.glyphicon-edit:before { + content: "\e065"; +} + +.glyphicon-share:before { + content: "\e066"; +} + +.glyphicon-check:before { + content: "\e067"; +} + +.glyphicon-move:before { + content: "\e068"; +} + +.glyphicon-step-backward:before { + content: "\e069"; +} + +.glyphicon-fast-backward:before { + content: "\e070"; +} + +.glyphicon-backward:before { + content: "\e071"; +} + +.glyphicon-play:before { + content: "\e072"; +} + +.glyphicon-pause:before { + content: "\e073"; +} + +.glyphicon-stop:before { + content: "\e074"; +} + +.glyphicon-forward:before { + content: "\e075"; +} + +.glyphicon-fast-forward:before { + content: "\e076"; +} + +.glyphicon-step-forward:before { + content: "\e077"; +} + +.glyphicon-eject:before { + content: "\e078"; +} + +.glyphicon-chevron-left:before { + content: "\e079"; +} + +.glyphicon-chevron-right:before { + content: "\e080"; +} + +.glyphicon-plus-sign:before { + content: "\e081"; +} + +.glyphicon-minus-sign:before { + content: "\e082"; +} + +.glyphicon-remove-sign:before { + content: "\e083"; +} + +.glyphicon-ok-sign:before { + content: "\e084"; +} + +.glyphicon-question-sign:before { + content: "\e085"; +} + +.glyphicon-info-sign:before { + content: "\e086"; +} + +.glyphicon-screenshot:before { + content: "\e087"; +} + +.glyphicon-remove-circle:before { + content: "\e088"; +} + +.glyphicon-ok-circle:before { + content: "\e089"; +} + +.glyphicon-ban-circle:before { + content: "\e090"; +} + +.glyphicon-arrow-left:before { + content: "\e091"; +} + +.glyphicon-arrow-right:before { + content: "\e092"; +} + +.glyphicon-arrow-up:before { + content: "\e093"; +} + +.glyphicon-arrow-down:before { + content: "\e094"; +} + +.glyphicon-share-alt:before { + content: "\e095"; +} + +.glyphicon-resize-full:before { + content: "\e096"; +} + +.glyphicon-resize-small:before { + content: "\e097"; +} + +.glyphicon-exclamation-sign:before { + content: "\e101"; +} + +.glyphicon-gift:before { + content: "\e102"; +} + +.glyphicon-leaf:before { + content: "\e103"; +} + +.glyphicon-fire:before { + content: "\e104"; +} + +.glyphicon-eye-open:before { + content: "\e105"; +} + +.glyphicon-eye-close:before { + content: "\e106"; +} + +.glyphicon-warning-sign:before { + content: "\e107"; +} + +.glyphicon-plane:before { + content: "\e108"; +} + +.glyphicon-calendar:before { + content: "\e109"; +} + +.glyphicon-random:before { + content: "\e110"; +} + +.glyphicon-comment:before { + content: "\e111"; +} + +.glyphicon-magnet:before { + content: "\e112"; +} + +.glyphicon-chevron-up:before { + content: "\e113"; +} + +.glyphicon-chevron-down:before { + content: "\e114"; +} + +.glyphicon-retweet:before { + content: "\e115"; +} + +.glyphicon-shopping-cart:before { + content: "\e116"; +} + +.glyphicon-folder-close:before { + content: "\e117"; +} + +.glyphicon-folder-open:before { + content: "\e118"; +} + +.glyphicon-resize-vertical:before { + content: "\e119"; +} + +.glyphicon-resize-horizontal:before { + content: "\e120"; +} + +.glyphicon-hdd:before { + content: "\e121"; +} + +.glyphicon-bullhorn:before { + content: "\e122"; +} + +.glyphicon-bell:before { + content: "\e123"; +} + +.glyphicon-certificate:before { + content: "\e124"; +} + +.glyphicon-thumbs-up:before { + content: "\e125"; +} + +.glyphicon-thumbs-down:before { + content: "\e126"; +} + +.glyphicon-hand-right:before { + content: "\e127"; +} + +.glyphicon-hand-left:before { + content: "\e128"; +} + +.glyphicon-hand-up:before { + content: "\e129"; +} + +.glyphicon-hand-down:before { + content: "\e130"; +} + +.glyphicon-circle-arrow-right:before { + content: "\e131"; +} + +.glyphicon-circle-arrow-left:before { + content: "\e132"; +} + +.glyphicon-circle-arrow-up:before { + content: "\e133"; +} + +.glyphicon-circle-arrow-down:before { + content: "\e134"; +} + +.glyphicon-globe:before { + content: "\e135"; +} + +.glyphicon-wrench:before { + content: "\e136"; +} + +.glyphicon-tasks:before { + content: "\e137"; +} + +.glyphicon-filter:before { + content: "\e138"; +} + +.glyphicon-briefcase:before { + content: "\e139"; +} + +.glyphicon-fullscreen:before { + content: "\e140"; +} + +.glyphicon-dashboard:before { + content: "\e141"; +} + +.glyphicon-paperclip:before { + content: "\e142"; +} + +.glyphicon-heart-empty:before { + content: "\e143"; +} + +.glyphicon-link:before { + content: "\e144"; +} + +.glyphicon-phone:before { + content: "\e145"; +} + +.glyphicon-pushpin:before { + content: "\e146"; +} + +.glyphicon-usd:before { + content: "\e148"; +} + +.glyphicon-gbp:before { + content: "\e149"; +} + +.glyphicon-sort:before { + content: "\e150"; +} + +.glyphicon-sort-by-alphabet:before { + content: "\e151"; +} + +.glyphicon-sort-by-alphabet-alt:before { + content: "\e152"; +} + +.glyphicon-sort-by-order:before { + content: "\e153"; +} + +.glyphicon-sort-by-order-alt:before { + content: "\e154"; +} + +.glyphicon-sort-by-attributes:before { + content: "\e155"; +} + +.glyphicon-sort-by-attributes-alt:before { + content: "\e156"; +} + +.glyphicon-unchecked:before { + content: "\e157"; +} + +.glyphicon-expand:before { + content: "\e158"; +} + +.glyphicon-collapse-down:before { + content: "\e159"; +} + +.glyphicon-collapse-up:before { + content: "\e160"; +} + +.glyphicon-log-in:before { + content: "\e161"; +} + +.glyphicon-flash:before { + content: "\e162"; +} + +.glyphicon-log-out:before { + content: "\e163"; +} + +.glyphicon-new-window:before { + content: "\e164"; +} + +.glyphicon-record:before { + content: "\e165"; +} + +.glyphicon-save:before { + content: "\e166"; +} + +.glyphicon-open:before { + content: "\e167"; +} + +.glyphicon-saved:before { + content: "\e168"; +} + +.glyphicon-import:before { + content: "\e169"; +} + +.glyphicon-export:before { + content: "\e170"; +} + +.glyphicon-send:before { + content: "\e171"; +} + +.glyphicon-floppy-disk:before { + content: "\e172"; +} + +.glyphicon-floppy-saved:before { + content: "\e173"; +} + +.glyphicon-floppy-remove:before { + content: "\e174"; +} + +.glyphicon-floppy-save:before { + content: "\e175"; +} + +.glyphicon-floppy-open:before { + content: "\e176"; +} + +.glyphicon-credit-card:before { + content: "\e177"; +} + +.glyphicon-transfer:before { + content: "\e178"; +} + +.glyphicon-cutlery:before { + content: "\e179"; +} + +.glyphicon-header:before { + content: "\e180"; +} + +.glyphicon-compressed:before { + content: "\e181"; +} + +.glyphicon-earphone:before { + content: "\e182"; +} + +.glyphicon-phone-alt:before { + content: "\e183"; +} + +.glyphicon-tower:before { + content: "\e184"; +} + +.glyphicon-stats:before { + content: "\e185"; +} + +.glyphicon-sd-video:before { + content: "\e186"; +} + +.glyphicon-hd-video:before { + content: "\e187"; +} + +.glyphicon-subtitles:before { + content: "\e188"; +} + +.glyphicon-sound-stereo:before { + content: "\e189"; +} + +.glyphicon-sound-dolby:before { + content: "\e190"; +} + +.glyphicon-sound-5-1:before { + content: "\e191"; +} + +.glyphicon-sound-6-1:before { + content: "\e192"; +} + +.glyphicon-sound-7-1:before { + content: "\e193"; +} + +.glyphicon-copyright-mark:before { + content: "\e194"; +} + +.glyphicon-registration-mark:before { + content: "\e195"; +} + +.glyphicon-cloud-download:before { + content: "\e197"; +} + +.glyphicon-cloud-upload:before { + content: "\e198"; +} + +.glyphicon-tree-conifer:before { + content: "\e199"; +} + +.glyphicon-tree-deciduous:before { + content: "\e200"; +} + +.caret { + display: inline-block; + width: 0; + height: 0; + margin-left: 2px; + vertical-align: middle; + border-top: 4px solid #000000; + border-right: 4px solid transparent; + border-bottom: 0 dotted; + border-left: 4px solid transparent; +} + +.dropdown { + position: relative; +} + +.dropdown-toggle:focus { + outline: 0; +} + +.dropdown-menu { + position: absolute; + top: 100%; + left: 0; + z-index: 1000; + display: none; + float: left; + min-width: 160px; + padding: 5px 0; + margin: 2px 0 0; + font-size: 14px; + list-style: none; + background-color: #ffffff; + border: 1px solid #cccccc; + border: 1px solid rgba(0, 0, 0, 0.15); + border-radius: 4px; + -webkit-box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); + box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); + background-clip: padding-box; +} + +.dropdown-menu.pull-right { + right: 0; + left: auto; +} + +.dropdown-menu .divider { + height: 1px; + margin: 9px 0; + overflow: hidden; + background-color: #e5e5e5; +} + +.dropdown-menu > li > a { + display: block; + padding: 3px 20px; + clear: both; + font-weight: normal; + line-height: 1.428571429; + color: #333333; + white-space: nowrap; +} + +.dropdown-menu > li > a:hover, +.dropdown-menu > li > a:focus { + color: #262626; + text-decoration: none; + background-color: #f5f5f5; +} + +.dropdown-menu > .active > a, +.dropdown-menu > .active > a:hover, +.dropdown-menu > .active > a:focus { + color: #ffffff; + text-decoration: none; + background-color: #428bca; + outline: 0; +} + +.dropdown-menu > .disabled > a, +.dropdown-menu > .disabled > a:hover, +.dropdown-menu > .disabled > a:focus { + color: #999999; +} + +.dropdown-menu > .disabled > a:hover, +.dropdown-menu > .disabled > a:focus { + text-decoration: none; + cursor: not-allowed; + background-color: transparent; + background-image: none; + filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); +} + +.open > .dropdown-menu { + display: block; +} + +.open > a { + outline: 0; +} + +.dropdown-header { + display: block; + padding: 3px 20px; + font-size: 12px; + line-height: 1.428571429; + color: #999999; +} + +.dropdown-backdrop { + position: fixed; + top: 0; + right: 0; + bottom: 0; + left: 0; + z-index: 990; +} + +.pull-right > .dropdown-menu { + right: 0; + left: auto; +} + +.dropup .caret, +.navbar-fixed-bottom .dropdown .caret { + border-top: 0 dotted; + border-bottom: 4px solid #000000; + content: ""; +} + +.dropup .dropdown-menu, +.navbar-fixed-bottom .dropdown .dropdown-menu { + top: auto; + bottom: 100%; + margin-bottom: 1px; +} + +@media (min-width: 768px) { + .navbar-right .dropdown-menu { + right: 0; + left: auto; + } +} + +.btn-default .caret { + border-top-color: #333333; +} + +.btn-primary .caret, +.btn-success .caret, +.btn-warning .caret, +.btn-danger .caret, +.btn-info .caret { + border-top-color: #fff; +} + +.dropup .btn-default .caret { + border-bottom-color: #333333; +} + +.dropup .btn-primary .caret, +.dropup .btn-success .caret, +.dropup .btn-warning .caret, +.dropup .btn-danger .caret, +.dropup .btn-info .caret { + border-bottom-color: #fff; +} + +.btn-group, +.btn-group-vertical { + position: relative; + display: inline-block; + vertical-align: middle; +} + +.btn-group > .btn, +.btn-group-vertical > .btn { + position: relative; + float: left; +} + +.btn-group > .btn:hover, +.btn-group-vertical > .btn:hover, +.btn-group > .btn:focus, +.btn-group-vertical > .btn:focus, +.btn-group > .btn:active, +.btn-group-vertical > .btn:active, +.btn-group > .btn.active, +.btn-group-vertical > .btn.active { + z-index: 2; +} + +.btn-group > .btn:focus, +.btn-group-vertical > .btn:focus { + outline: none; +} + +.btn-group .btn + .btn, +.btn-group .btn + .btn-group, +.btn-group .btn-group + .btn, +.btn-group .btn-group + .btn-group { + margin-left: -1px; +} + +.btn-toolbar:before, +.btn-toolbar:after { + display: table; + content: " "; +} + +.btn-toolbar:after { + clear: both; +} + +.btn-toolbar:before, +.btn-toolbar:after { + display: table; + content: " "; +} + +.btn-toolbar:after { + clear: both; +} + +.btn-toolbar .btn-group { + float: left; +} + +.btn-toolbar > .btn + .btn, +.btn-toolbar > .btn-group + .btn, +.btn-toolbar > .btn + .btn-group, +.btn-toolbar > .btn-group + .btn-group { + margin-left: 5px; +} + +.btn-group > .btn:not(:first-child):not(:last-child):not(.dropdown-toggle) { + border-radius: 0; +} + +.btn-group > .btn:first-child { + margin-left: 0; +} + +.btn-group > .btn:first-child:not(:last-child):not(.dropdown-toggle) { + border-top-right-radius: 0; + border-bottom-right-radius: 0; +} + +.btn-group > .btn:last-child:not(:first-child), +.btn-group > .dropdown-toggle:not(:first-child) { + border-bottom-left-radius: 0; + border-top-left-radius: 0; +} + +.btn-group > .btn-group { + float: left; +} + +.btn-group > .btn-group:not(:first-child):not(:last-child) > .btn { + border-radius: 0; +} + +.btn-group > .btn-group:first-child > .btn:last-child, +.btn-group > .btn-group:first-child > .dropdown-toggle { + border-top-right-radius: 0; + border-bottom-right-radius: 0; +} + +.btn-group > .btn-group:last-child > .btn:first-child { + border-bottom-left-radius: 0; + border-top-left-radius: 0; +} + +.btn-group .dropdown-toggle:active, +.btn-group.open .dropdown-toggle { + outline: 0; +} + +.btn-group-xs > .btn { + padding: 5px 10px; + padding: 1px 5px; + font-size: 12px; + line-height: 1.5; + border-radius: 3px; +} + +.btn-group-sm > .btn { + padding: 5px 10px; + font-size: 12px; + line-height: 1.5; + border-radius: 3px; +} + +.btn-group-lg > .btn { + padding: 10px 16px; + font-size: 18px; + line-height: 1.33; + border-radius: 6px; +} + +.btn-group > .btn + .dropdown-toggle { + padding-right: 8px; + padding-left: 8px; +} + +.btn-group > .btn-lg + .dropdown-toggle { + padding-right: 12px; + padding-left: 12px; +} + +.btn-group.open .dropdown-toggle { + -webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); + box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); +} + +.btn-group.open .dropdown-toggle.btn-link { + -webkit-box-shadow: none; + box-shadow: none; +} + +.btn .caret { + margin-left: 0; +} + +.btn-lg .caret { + border-width: 5px 5px 0; + border-bottom-width: 0; +} + +.dropup .btn-lg .caret { + border-width: 0 5px 5px; +} + +.btn-group-vertical > .btn, +.btn-group-vertical > .btn-group { + display: block; + float: none; + width: 100%; + max-width: 100%; +} + +.btn-group-vertical > .btn-group:before, +.btn-group-vertical > .btn-group:after { + display: table; + content: " "; +} + +.btn-group-vertical > .btn-group:after { + clear: both; +} + +.btn-group-vertical > .btn-group:before, +.btn-group-vertical > .btn-group:after { + display: table; + content: " "; +} + +.btn-group-vertical > .btn-group:after { + clear: both; +} + +.btn-group-vertical > .btn-group > .btn { + float: none; +} + +.btn-group-vertical > .btn + .btn, +.btn-group-vertical > .btn + .btn-group, +.btn-group-vertical > .btn-group + .btn, +.btn-group-vertical > .btn-group + .btn-group { + margin-top: -1px; + margin-left: 0; +} + +.btn-group-vertical > .btn:not(:first-child):not(:last-child) { + border-radius: 0; +} + +.btn-group-vertical > .btn:first-child:not(:last-child) { + border-top-right-radius: 4px; + border-bottom-right-radius: 0; + border-bottom-left-radius: 0; +} + +.btn-group-vertical > .btn:last-child:not(:first-child) { + border-top-right-radius: 0; + border-bottom-left-radius: 4px; + border-top-left-radius: 0; +} + +.btn-group-vertical > .btn-group:not(:first-child):not(:last-child) > .btn { + border-radius: 0; +} + +.btn-group-vertical > .btn-group:first-child > .btn:last-child, +.btn-group-vertical > .btn-group:first-child > .dropdown-toggle { + border-bottom-right-radius: 0; + border-bottom-left-radius: 0; +} + +.btn-group-vertical > .btn-group:last-child > .btn:first-child { + border-top-right-radius: 0; + border-top-left-radius: 0; +} + +.btn-group-justified { + display: table; + width: 100%; + border-collapse: separate; + table-layout: fixed; +} + +.btn-group-justified .btn { + display: table-cell; + float: none; + width: 1%; +} + +[data-toggle="buttons"] > .btn > input[type="radio"], +[data-toggle="buttons"] > .btn > input[type="checkbox"] { + display: none; +} + +.input-group { + position: relative; + display: table; + border-collapse: separate; +} + +.input-group.col { + float: none; + padding-right: 0; + padding-left: 0; +} + +.input-group .form-control { + width: 100%; + margin-bottom: 0; +} + +.input-group-lg > .form-control, +.input-group-lg > .input-group-addon, +.input-group-lg > .input-group-btn > .btn { + height: 45px; + padding: 10px 16px; + font-size: 18px; + line-height: 1.33; + border-radius: 6px; +} + +select.input-group-lg > .form-control, +select.input-group-lg > .input-group-addon, +select.input-group-lg > .input-group-btn > .btn { + height: 45px; + line-height: 45px; +} + +textarea.input-group-lg > .form-control, +textarea.input-group-lg > .input-group-addon, +textarea.input-group-lg > .input-group-btn > .btn { + height: auto; +} + +.input-group-sm > .form-control, +.input-group-sm > .input-group-addon, +.input-group-sm > .input-group-btn > .btn { + height: 30px; + padding: 5px 10px; + font-size: 12px; + line-height: 1.5; + border-radius: 3px; +} + +select.input-group-sm > .form-control, +select.input-group-sm > .input-group-addon, +select.input-group-sm > .input-group-btn > .btn { + height: 30px; + line-height: 30px; +} + +textarea.input-group-sm > .form-control, +textarea.input-group-sm > .input-group-addon, +textarea.input-group-sm > .input-group-btn > .btn { + height: auto; +} + +.input-group-addon, +.input-group-btn, +.input-group .form-control { + display: table-cell; +} + +.input-group-addon:not(:first-child):not(:last-child), +.input-group-btn:not(:first-child):not(:last-child), +.input-group .form-control:not(:first-child):not(:last-child) { + border-radius: 0; +} + +.input-group-addon, +.input-group-btn { + width: 1%; + white-space: nowrap; + vertical-align: middle; +} + +.input-group-addon { + padding: 6px 12px; + font-size: 14px; + font-weight: normal; + line-height: 1; + color: #555555; + text-align: center; + background-color: #eeeeee; + border: 1px solid #cccccc; + border-radius: 4px; +} + +.input-group-addon.input-sm { + padding: 5px 10px; + font-size: 12px; + border-radius: 3px; +} + +.input-group-addon.input-lg { + padding: 10px 16px; + font-size: 18px; + border-radius: 6px; +} + +.input-group-addon input[type="radio"], +.input-group-addon input[type="checkbox"] { + margin-top: 0; +} + +.input-group .form-control:first-child, +.input-group-addon:first-child, +.input-group-btn:first-child > .btn, +.input-group-btn:first-child > .dropdown-toggle, +.input-group-btn:last-child > .btn:not(:last-child):not(.dropdown-toggle) { + border-top-right-radius: 0; + border-bottom-right-radius: 0; +} + +.input-group-addon:first-child { + border-right: 0; +} + +.input-group .form-control:last-child, +.input-group-addon:last-child, +.input-group-btn:last-child > .btn, +.input-group-btn:last-child > .dropdown-toggle, +.input-group-btn:first-child > .btn:not(:first-child) { + border-bottom-left-radius: 0; + border-top-left-radius: 0; +} + +.input-group-addon:last-child { + border-left: 0; +} + +.input-group-btn { + position: relative; + white-space: nowrap; +} + +.input-group-btn:first-child > .btn { + margin-right: -1px; +} + +.input-group-btn:last-child > .btn { + margin-left: -1px; +} + +.input-group-btn > .btn { + position: relative; +} + +.input-group-btn > .btn + .btn { + margin-left: -4px; +} + +.input-group-btn > .btn:hover, +.input-group-btn > .btn:active { + z-index: 2; +} + +.nav { + padding-left: 0; + margin-bottom: 0; + list-style: none; +} + +.nav:before, +.nav:after { + display: table; + content: " "; +} + +.nav:after { + clear: both; +} + +.nav:before, +.nav:after { + display: table; + content: " "; +} + +.nav:after { + clear: both; +} + +.nav > li { + position: relative; + display: block; +} + +.nav > li > a { + position: relative; + display: block; + padding: 10px 15px; +} + +.nav > li > a:hover, +.nav > li > a:focus { + text-decoration: none; + background-color: #eeeeee; +} + +.nav > li.disabled > a { + color: #999999; +} + +.nav > li.disabled > a:hover, +.nav > li.disabled > a:focus { + color: #999999; + text-decoration: none; + cursor: not-allowed; + background-color: transparent; +} + +.nav .open > a, +.nav .open > a:hover, +.nav .open > a:focus { + background-color: #eeeeee; + border-color: #428bca; +} + +.nav .open > a .caret, +.nav .open > a:hover .caret, +.nav .open > a:focus .caret { + border-top-color: #2a6496; + border-bottom-color: #2a6496; +} + +.nav .nav-divider { + height: 1px; + margin: 9px 0; + overflow: hidden; + background-color: #e5e5e5; +} + +.nav > li > a > img { + max-width: none; +} + +.nav-tabs { + border-bottom: 1px solid #dddddd; +} + +.nav-tabs > li { + float: left; + margin-bottom: -1px; +} + +.nav-tabs > li > a { + margin-right: 2px; + line-height: 1.428571429; + border: 1px solid transparent; + border-radius: 4px 4px 0 0; +} + +.nav-tabs > li > a:hover { + border-color: #eeeeee #eeeeee #dddddd; +} + +.nav-tabs > li.active > a, +.nav-tabs > li.active > a:hover, +.nav-tabs > li.active > a:focus { + color: #555555; + cursor: default; + background-color: #ffffff; + border: 1px solid #dddddd; + border-bottom-color: transparent; +} + +.nav-tabs.nav-justified { + width: 100%; + border-bottom: 0; +} + +.nav-tabs.nav-justified > li { + float: none; +} + +.nav-tabs.nav-justified > li > a { + margin-bottom: 5px; + text-align: center; +} + +.nav-tabs.nav-justified > .dropdown .dropdown-menu { + top: auto; + left: auto; +} + +@media (min-width: 768px) { + .nav-tabs.nav-justified > li { + display: table-cell; + width: 1%; + } + .nav-tabs.nav-justified > li > a { + margin-bottom: 0; + } +} + +.nav-tabs.nav-justified > li > a { + margin-right: 0; + border-radius: 4px; +} + +.nav-tabs.nav-justified > .active > a, +.nav-tabs.nav-justified > .active > a:hover, +.nav-tabs.nav-justified > .active > a:focus { + border: 1px solid #dddddd; +} + +@media (min-width: 768px) { + .nav-tabs.nav-justified > li > a { + border-bottom: 1px solid #dddddd; + border-radius: 4px 4px 0 0; + } + .nav-tabs.nav-justified > .active > a, + .nav-tabs.nav-justified > .active > a:hover, + .nav-tabs.nav-justified > .active > a:focus { + border-bottom-color: #ffffff; + } +} + +.nav-pills > li { + float: left; +} + +.nav-pills > li > a { + border-radius: 4px; +} + +.nav-pills > li + li { + margin-left: 2px; +} + +.nav-pills > li.active > a, +.nav-pills > li.active > a:hover, +.nav-pills > li.active > a:focus { + color: #ffffff; + background-color: #428bca; +} + +.nav-pills > li.active > a .caret, +.nav-pills > li.active > a:hover .caret, +.nav-pills > li.active > a:focus .caret { + border-top-color: #ffffff; + border-bottom-color: #ffffff; +} + +.nav-stacked > li { + float: none; +} + +.nav-stacked > li + li { + margin-top: 2px; + margin-left: 0; +} + +.nav-justified { + width: 100%; +} + +.nav-justified > li { + float: none; +} + +.nav-justified > li > a { + margin-bottom: 5px; + text-align: center; +} + +.nav-justified > .dropdown .dropdown-menu { + top: auto; + left: auto; +} + +@media (min-width: 768px) { + .nav-justified > li { + display: table-cell; + width: 1%; + } + .nav-justified > li > a { + margin-bottom: 0; + } +} + +.nav-tabs-justified { + border-bottom: 0; +} + +.nav-tabs-justified > li > a { + margin-right: 0; + border-radius: 4px; +} + +.nav-tabs-justified > .active > a, +.nav-tabs-justified > .active > a:hover, +.nav-tabs-justified > .active > a:focus { + border: 1px solid #dddddd; +} + +@media (min-width: 768px) { + .nav-tabs-justified > li > a { + border-bottom: 1px solid #dddddd; + border-radius: 4px 4px 0 0; + } + .nav-tabs-justified > .active > a, + .nav-tabs-justified > .active > a:hover, + .nav-tabs-justified > .active > a:focus { + border-bottom-color: #ffffff; + } +} + +.tab-content > .tab-pane { + display: none; +} + +.tab-content > .active { + display: block; +} + +.nav .caret { + border-top-color: #428bca; + border-bottom-color: #428bca; +} + +.nav a:hover .caret { + border-top-color: #2a6496; + border-bottom-color: #2a6496; +} + +.nav-tabs .dropdown-menu { + margin-top: -1px; + border-top-right-radius: 0; + border-top-left-radius: 0; +} + +.navbar { + position: relative; + min-height: 50px; + margin-bottom: 20px; + border: 1px solid transparent; +} + +.navbar:before, +.navbar:after { + display: table; + content: " "; +} + +.navbar:after { + clear: both; +} + +.navbar:before, +.navbar:after { + display: table; + content: " "; +} + +.navbar:after { + clear: both; +} + +@media (min-width: 768px) { + .navbar { + border-radius: 4px; + } +} + +.navbar-header:before, +.navbar-header:after { + display: table; + content: " "; +} + +.navbar-header:after { + clear: both; +} + +.navbar-header:before, +.navbar-header:after { + display: table; + content: " "; +} + +.navbar-header:after { + clear: both; +} + +@media (min-width: 768px) { + .navbar-header { + float: left; + } +} + +.navbar-collapse { + max-height: 340px; + padding-right: 15px; + padding-left: 15px; + overflow-x: visible; + border-top: 1px solid transparent; + box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1); + -webkit-overflow-scrolling: touch; +} + +.navbar-collapse:before, +.navbar-collapse:after { + display: table; + content: " "; +} + +.navbar-collapse:after { + clear: both; +} + +.navbar-collapse:before, +.navbar-collapse:after { + display: table; + content: " "; +} + +.navbar-collapse:after { + clear: both; +} + +.navbar-collapse.in { + overflow-y: auto; +} + +@media (min-width: 768px) { + .navbar-collapse { + width: auto; + border-top: 0; + box-shadow: none; + } + .navbar-collapse.collapse { + display: block !important; + height: auto !important; + padding-bottom: 0; + overflow: visible !important; + } + .navbar-collapse.in { + overflow-y: auto; + } + .navbar-collapse .navbar-nav.navbar-left:first-child { + margin-left: -15px; + } + .navbar-collapse .navbar-nav.navbar-right:last-child { + margin-right: -15px; + } + .navbar-collapse .navbar-text:last-child { + margin-right: 0; + } +} + +.container > .navbar-header, +.container > .navbar-collapse { + margin-right: -15px; + margin-left: -15px; +} + +@media (min-width: 768px) { + .container > .navbar-header, + .container > .navbar-collapse { + margin-right: 0; + margin-left: 0; + } +} + +.navbar-static-top { + z-index: 1000; + border-width: 0 0 1px; +} + +@media (min-width: 768px) { + .navbar-static-top { + border-radius: 0; + } +} + +.navbar-fixed-top, +.navbar-fixed-bottom { + position: fixed; + right: 0; + left: 0; + z-index: 1030; +} + +@media (min-width: 768px) { + .navbar-fixed-top, + .navbar-fixed-bottom { + border-radius: 0; + } +} + +.navbar-fixed-top { + top: 0; + border-width: 0 0 1px; +} + +.navbar-fixed-bottom { + bottom: 0; + margin-bottom: 0; + border-width: 1px 0 0; +} + +.navbar-brand { + float: left; + padding: 15px 15px; + font-size: 18px; + line-height: 20px; +} + +.navbar-brand:hover, +.navbar-brand:focus { + text-decoration: none; +} + +@media (min-width: 768px) { + .navbar > .container .navbar-brand { + margin-left: -15px; + } +} + +.navbar-toggle { + position: relative; + float: right; + padding: 9px 10px; + margin-top: 8px; + margin-right: 15px; + margin-bottom: 8px; + background-color: transparent; + border: 1px solid transparent; + border-radius: 4px; +} + +.navbar-toggle .icon-bar { + display: block; + width: 22px; + height: 2px; + border-radius: 1px; +} + +.navbar-toggle .icon-bar + .icon-bar { + margin-top: 4px; +} + +@media (min-width: 768px) { + .navbar-toggle { + display: none; + } +} + +.navbar-nav { + margin: 7.5px -15px; +} + +.navbar-nav > li > a { + padding-top: 10px; + padding-bottom: 10px; + line-height: 20px; +} + +@media (max-width: 767px) { + .navbar-nav .open .dropdown-menu { + position: static; + float: none; + width: auto; + margin-top: 0; + background-color: transparent; + border: 0; + box-shadow: none; + } + .navbar-nav .open .dropdown-menu > li > a, + .navbar-nav .open .dropdown-menu .dropdown-header { + padding: 5px 15px 5px 25px; + } + .navbar-nav .open .dropdown-menu > li > a { + line-height: 20px; + } + .navbar-nav .open .dropdown-menu > li > a:hover, + .navbar-nav .open .dropdown-menu > li > a:focus { + background-image: none; + } +} + +@media (min-width: 768px) { + .navbar-nav { + float: left; + margin: 0; + } + .navbar-nav > li { + float: left; + } + .navbar-nav > li > a { + padding-top: 15px; + padding-bottom: 15px; + } +} + +@media (min-width: 768px) { + .navbar-left { + float: left !important; + } + .navbar-right { + float: right !important; + } +} + +.navbar-form { + padding: 10px 15px; + margin-top: 8px; + margin-right: -15px; + margin-bottom: 8px; + margin-left: -15px; + border-top: 1px solid transparent; + border-bottom: 1px solid transparent; + -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.1); + box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.1); +} + +@media (min-width: 768px) { + .navbar-form .form-group { + display: inline-block; + margin-bottom: 0; + vertical-align: middle; + } + .navbar-form .form-control { + display: inline-block; + } + .navbar-form .radio, + .navbar-form .checkbox { + display: inline-block; + padding-left: 0; + margin-top: 0; + margin-bottom: 0; + } + .navbar-form .radio input[type="radio"], + .navbar-form .checkbox input[type="checkbox"] { + float: none; + margin-left: 0; + } +} + +@media (max-width: 767px) { + .navbar-form .form-group { + margin-bottom: 5px; + } +} + +@media (min-width: 768px) { + .navbar-form { + width: auto; + padding-top: 0; + padding-bottom: 0; + margin-right: 0; + margin-left: 0; + border: 0; + -webkit-box-shadow: none; + box-shadow: none; + } +} + +.navbar-nav > li > .dropdown-menu { + margin-top: 0; + border-top-right-radius: 0; + border-top-left-radius: 0; +} + +.navbar-fixed-bottom .navbar-nav > li > .dropdown-menu { + border-bottom-right-radius: 0; + border-bottom-left-radius: 0; +} + +.navbar-nav.pull-right > li > .dropdown-menu, +.navbar-nav > li > .dropdown-menu.pull-right { + right: 0; + left: auto; +} + +.navbar-btn { + margin-top: 8px; + margin-bottom: 8px; +} + +.navbar-text { + float: left; + margin-top: 15px; + margin-bottom: 15px; +} + +@media (min-width: 768px) { + .navbar-text { + margin-right: 15px; + margin-left: 15px; + } +} + +.navbar-default { + background-color: #f8f8f8; + border-color: #e7e7e7; +} + +.navbar-default .navbar-brand { + color: #777777; +} + +.navbar-default .navbar-brand:hover, +.navbar-default .navbar-brand:focus { + color: #5e5e5e; + background-color: transparent; +} + +.navbar-default .navbar-text { + color: #777777; +} + +.navbar-default .navbar-nav > li > a { + color: #777777; +} + +.navbar-default .navbar-nav > li > a:hover, +.navbar-default .navbar-nav > li > a:focus { + color: #333333; + background-color: transparent; +} + +.navbar-default .navbar-nav > .active > a, +.navbar-default .navbar-nav > .active > a:hover, +.navbar-default .navbar-nav > .active > a:focus { + color: #555555; + background-color: #e7e7e7; +} + +.navbar-default .navbar-nav > .disabled > a, +.navbar-default .navbar-nav > .disabled > a:hover, +.navbar-default .navbar-nav > .disabled > a:focus { + color: #cccccc; + background-color: transparent; +} + +.navbar-default .navbar-toggle { + border-color: #dddddd; +} + +.navbar-default .navbar-toggle:hover, +.navbar-default .navbar-toggle:focus { + background-color: #dddddd; +} + +.navbar-default .navbar-toggle .icon-bar { + background-color: #cccccc; +} + +.navbar-default .navbar-collapse, +.navbar-default .navbar-form { + border-color: #e7e7e7; +} + +.navbar-default .navbar-nav > .dropdown > a:hover .caret, +.navbar-default .navbar-nav > .dropdown > a:focus .caret { + border-top-color: #333333; + border-bottom-color: #333333; +} + +.navbar-default .navbar-nav > .open > a, +.navbar-default .navbar-nav > .open > a:hover, +.navbar-default .navbar-nav > .open > a:focus { + color: #555555; + background-color: #e7e7e7; +} + +.navbar-default .navbar-nav > .open > a .caret, +.navbar-default .navbar-nav > .open > a:hover .caret, +.navbar-default .navbar-nav > .open > a:focus .caret { + border-top-color: #555555; + border-bottom-color: #555555; +} + +.navbar-default .navbar-nav > .dropdown > a .caret { + border-top-color: #777777; + border-bottom-color: #777777; +} + +@media (max-width: 767px) { + .navbar-default .navbar-nav .open .dropdown-menu > li > a { + color: #777777; + } + .navbar-default .navbar-nav .open .dropdown-menu > li > a:hover, + .navbar-default .navbar-nav .open .dropdown-menu > li > a:focus { + color: #333333; + background-color: transparent; + } + .navbar-default .navbar-nav .open .dropdown-menu > .active > a, + .navbar-default .navbar-nav .open .dropdown-menu > .active > a:hover, + .navbar-default .navbar-nav .open .dropdown-menu > .active > a:focus { + color: #555555; + background-color: #e7e7e7; + } + .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a, + .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a:hover, + .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a:focus { + color: #cccccc; + background-color: transparent; + } +} + +.navbar-default .navbar-link { + color: #777777; +} + +.navbar-default .navbar-link:hover { + color: #333333; +} + +.navbar-inverse { + background-color: #222222; + border-color: #080808; +} + +.navbar-inverse .navbar-brand { + color: #999999; +} + +.navbar-inverse .navbar-brand:hover, +.navbar-inverse .navbar-brand:focus { + color: #ffffff; + background-color: transparent; +} + +.navbar-inverse .navbar-text { + color: #999999; +} + +.navbar-inverse .navbar-nav > li > a { + color: #999999; +} + +.navbar-inverse .navbar-nav > li > a:hover, +.navbar-inverse .navbar-nav > li > a:focus { + color: #ffffff; + background-color: transparent; +} + +.navbar-inverse .navbar-nav > .active > a, +.navbar-inverse .navbar-nav > .active > a:hover, +.navbar-inverse .navbar-nav > .active > a:focus { + color: #ffffff; + background-color: #080808; +} + +.navbar-inverse .navbar-nav > .disabled > a, +.navbar-inverse .navbar-nav > .disabled > a:hover, +.navbar-inverse .navbar-nav > .disabled > a:focus { + color: #444444; + background-color: transparent; +} + +.navbar-inverse .navbar-toggle { + border-color: #333333; +} + +.navbar-inverse .navbar-toggle:hover, +.navbar-inverse .navbar-toggle:focus { + background-color: #333333; +} + +.navbar-inverse .navbar-toggle .icon-bar { + background-color: #ffffff; +} + +.navbar-inverse .navbar-collapse, +.navbar-inverse .navbar-form { + border-color: #101010; +} + +.navbar-inverse .navbar-nav > .open > a, +.navbar-inverse .navbar-nav > .open > a:hover, +.navbar-inverse .navbar-nav > .open > a:focus { + color: #ffffff; + background-color: #080808; +} + +.navbar-inverse .navbar-nav > .dropdown > a:hover .caret { + border-top-color: #ffffff; + border-bottom-color: #ffffff; +} + +.navbar-inverse .navbar-nav > .dropdown > a .caret { + border-top-color: #999999; + border-bottom-color: #999999; +} + +.navbar-inverse .navbar-nav > .open > a .caret, +.navbar-inverse .navbar-nav > .open > a:hover .caret, +.navbar-inverse .navbar-nav > .open > a:focus .caret { + border-top-color: #ffffff; + border-bottom-color: #ffffff; +} + +@media (max-width: 767px) { + .navbar-inverse .navbar-nav .open .dropdown-menu > .dropdown-header { + border-color: #080808; + } + .navbar-inverse .navbar-nav .open .dropdown-menu > li > a { + color: #999999; + } + .navbar-inverse .navbar-nav .open .dropdown-menu > li > a:hover, + .navbar-inverse .navbar-nav .open .dropdown-menu > li > a:focus { + color: #ffffff; + background-color: transparent; + } + .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a, + .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a:hover, + .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a:focus { + color: #ffffff; + background-color: #080808; + } + .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a, + .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a:hover, + .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a:focus { + color: #444444; + background-color: transparent; + } +} + +.navbar-inverse .navbar-link { + color: #999999; +} + +.navbar-inverse .navbar-link:hover { + color: #ffffff; +} + +.breadcrumb { + padding: 8px 15px; + margin-bottom: 20px; + list-style: none; + background-color: #f5f5f5; + border-radius: 4px; +} + +.breadcrumb > li { + display: inline-block; +} + +.breadcrumb > li + li:before { + padding: 0 5px; + color: #cccccc; + content: "/\00a0"; +} + +.breadcrumb > .active { + color: #999999; +} + +.pagination { + display: inline-block; + padding-left: 0; + margin: 20px 0; + border-radius: 4px; +} + +.pagination > li { + display: inline; +} + +.pagination > li > a, +.pagination > li > span { + position: relative; + float: left; + padding: 6px 12px; + margin-left: -1px; + line-height: 1.428571429; + text-decoration: none; + background-color: #ffffff; + border: 1px solid #dddddd; +} + +.pagination > li:first-child > a, +.pagination > li:first-child > span { + margin-left: 0; + border-bottom-left-radius: 4px; + border-top-left-radius: 4px; +} + +.pagination > li:last-child > a, +.pagination > li:last-child > span { + border-top-right-radius: 4px; + border-bottom-right-radius: 4px; +} + +.pagination > li > a:hover, +.pagination > li > span:hover, +.pagination > li > a:focus, +.pagination > li > span:focus { + background-color: #eeeeee; +} + +.pagination > .active > a, +.pagination > .active > span, +.pagination > .active > a:hover, +.pagination > .active > span:hover, +.pagination > .active > a:focus, +.pagination > .active > span:focus { + z-index: 2; + color: #ffffff; + cursor: default; + background-color: #428bca; + border-color: #428bca; +} + +.pagination > .disabled > span, +.pagination > .disabled > span:hover, +.pagination > .disabled > span:focus, +.pagination > .disabled > a, +.pagination > .disabled > a:hover, +.pagination > .disabled > a:focus { + color: #999999; + cursor: not-allowed; + background-color: #ffffff; + border-color: #dddddd; +} + +.pagination-lg > li > a, +.pagination-lg > li > span { + padding: 10px 16px; + font-size: 18px; +} + +.pagination-lg > li:first-child > a, +.pagination-lg > li:first-child > span { + border-bottom-left-radius: 6px; + border-top-left-radius: 6px; +} + +.pagination-lg > li:last-child > a, +.pagination-lg > li:last-child > span { + border-top-right-radius: 6px; + border-bottom-right-radius: 6px; +} + +.pagination-sm > li > a, +.pagination-sm > li > span { + padding: 5px 10px; + font-size: 12px; +} + +.pagination-sm > li:first-child > a, +.pagination-sm > li:first-child > span { + border-bottom-left-radius: 3px; + border-top-left-radius: 3px; +} + +.pagination-sm > li:last-child > a, +.pagination-sm > li:last-child > span { + border-top-right-radius: 3px; + border-bottom-right-radius: 3px; +} + +.pager { + padding-left: 0; + margin: 20px 0; + text-align: center; + list-style: none; +} + +.pager:before, +.pager:after { + display: table; + content: " "; +} + +.pager:after { + clear: both; +} + +.pager:before, +.pager:after { + display: table; + content: " "; +} + +.pager:after { + clear: both; +} + +.pager li { + display: inline; +} + +.pager li > a, +.pager li > span { + display: inline-block; + padding: 5px 14px; + background-color: #ffffff; + border: 1px solid #dddddd; + border-radius: 15px; +} + +.pager li > a:hover, +.pager li > a:focus { + text-decoration: none; + background-color: #eeeeee; +} + +.pager .next > a, +.pager .next > span { + float: right; +} + +.pager .previous > a, +.pager .previous > span { + float: left; +} + +.pager .disabled > a, +.pager .disabled > a:hover, +.pager .disabled > a:focus, +.pager .disabled > span { + color: #999999; + cursor: not-allowed; + background-color: #ffffff; +} + +.label { + display: inline; + padding: .2em .6em .3em; + font-size: 75%; + font-weight: bold; + line-height: 1; + color: #ffffff; + text-align: center; + white-space: nowrap; + vertical-align: baseline; + border-radius: .25em; +} + +.label[href]:hover, +.label[href]:focus { + color: #ffffff; + text-decoration: none; + cursor: pointer; +} + +.label:empty { + display: none; +} + +.label-default { + background-color: #999999; +} + +.label-default[href]:hover, +.label-default[href]:focus { + background-color: #808080; +} + +.label-primary { + background-color: #428bca; +} + +.label-primary[href]:hover, +.label-primary[href]:focus { + background-color: #3071a9; +} + +.label-success { + background-color: #5cb85c; +} + +.label-success[href]:hover, +.label-success[href]:focus { + background-color: #449d44; +} + +.label-info { + background-color: #5bc0de; +} + +.label-info[href]:hover, +.label-info[href]:focus { + background-color: #31b0d5; +} + +.label-warning { + background-color: #f0ad4e; +} + +.label-warning[href]:hover, +.label-warning[href]:focus { + background-color: #ec971f; +} + +.label-danger { + background-color: #d9534f; +} + +.label-danger[href]:hover, +.label-danger[href]:focus { + background-color: #c9302c; +} + +.badge { + display: inline-block; + min-width: 10px; + padding: 3px 7px; + font-size: 12px; + font-weight: bold; + line-height: 1; + color: #ffffff; + text-align: center; + white-space: nowrap; + vertical-align: baseline; + background-color: #999999; + border-radius: 10px; +} + +.badge:empty { + display: none; +} + +a.badge:hover, +a.badge:focus { + color: #ffffff; + text-decoration: none; + cursor: pointer; +} + +.btn .badge { + position: relative; + top: -1px; +} + +a.list-group-item.active > .badge, +.nav-pills > .active > a > .badge { + color: #428bca; + background-color: #ffffff; +} + +.nav-pills > li > a > .badge { + margin-left: 3px; +} + +.jumbotron { + padding: 30px; + margin-bottom: 30px; + font-size: 21px; + font-weight: 200; + line-height: 2.1428571435; + color: inherit; + background-color: #eeeeee; +} + +.jumbotron h1 { + line-height: 1; + color: inherit; +} + +.jumbotron p { + line-height: 1.4; +} + +.container .jumbotron { + border-radius: 6px; +} + +@media screen and (min-width: 768px) { + .jumbotron { + padding-top: 48px; + padding-bottom: 48px; + } + .container .jumbotron { + padding-right: 60px; + padding-left: 60px; + } + .jumbotron h1 { + font-size: 63px; + } +} + +.thumbnail { + display: inline-block; + display: block; + height: auto; + max-width: 100%; + padding: 4px; + margin-bottom: 20px; + line-height: 1.428571429; + background-color: #ffffff; + border: 1px solid #dddddd; + border-radius: 4px; + -webkit-transition: all 0.2s ease-in-out; + transition: all 0.2s ease-in-out; +} + +.thumbnail > img { + display: block; + height: auto; + max-width: 100%; + margin-right: auto; + margin-left: auto; +} + +a.thumbnail:hover, +a.thumbnail:focus, +a.thumbnail.active { + border-color: #428bca; +} + +.thumbnail .caption { + padding: 9px; + color: #333333; +} + +.alert { + padding: 15px; + margin-bottom: 20px; + border: 1px solid transparent; + border-radius: 4px; +} + +.alert h4 { + margin-top: 0; + color: inherit; +} + +.alert .alert-link { + font-weight: bold; +} + +.alert > p, +.alert > ul { + margin-bottom: 0; +} + +.alert > p + p { + margin-top: 5px; +} + +.alert-dismissable { + padding-right: 35px; +} + +.alert-dismissable .close { + position: relative; + top: -2px; + right: -21px; + color: inherit; +} + +.alert-success { + color: #468847; + background-color: #dff0d8; + border-color: #d6e9c6; +} + +.alert-success hr { + border-top-color: #c9e2b3; +} + +.alert-success .alert-link { + color: #356635; +} + +.alert-info { + color: #3a87ad; + background-color: #d9edf7; + border-color: #bce8f1; +} + +.alert-info hr { + border-top-color: #a6e1ec; +} + +.alert-info .alert-link { + color: #2d6987; +} + +.alert-warning { + color: #c09853; + background-color: #fcf8e3; + border-color: #faebcc; +} + +.alert-warning hr { + border-top-color: #f7e1b5; +} + +.alert-warning .alert-link { + color: #a47e3c; +} + +.alert-danger { + color: #b94a48; + background-color: #f2dede; + border-color: #ebccd1; +} + +.alert-danger hr { + border-top-color: #e4b9c0; +} + +.alert-danger .alert-link { + color: #953b39; +} + +@-webkit-keyframes progress-bar-stripes { + from { + background-position: 40px 0; + } + to { + background-position: 0 0; + } +} + +@-moz-keyframes progress-bar-stripes { + from { + background-position: 40px 0; + } + to { + background-position: 0 0; + } +} + +@-o-keyframes progress-bar-stripes { + from { + background-position: 0 0; + } + to { + background-position: 40px 0; + } +} + +@keyframes progress-bar-stripes { + from { + background-position: 40px 0; + } + to { + background-position: 0 0; + } +} + +.progress { + height: 20px; + margin-bottom: 20px; + overflow: hidden; + background-color: #f5f5f5; + border-radius: 4px; + -webkit-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1); + box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1); +} + +.progress-bar { + float: left; + width: 0; + height: 100%; + font-size: 12px; + line-height: 20px; + color: #ffffff; + text-align: center; + background-color: #428bca; + -webkit-box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.15); + box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.15); + -webkit-transition: width 0.6s ease; + transition: width 0.6s ease; +} + +.progress-striped .progress-bar { + background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent)); + background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: -moz-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-size: 40px 40px; +} + +.progress.active .progress-bar { + -webkit-animation: progress-bar-stripes 2s linear infinite; + animation: progress-bar-stripes 2s linear infinite; +} + +.progress-bar-success { + background-color: #5cb85c; +} + +.progress-striped .progress-bar-success { + background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent)); + background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: -moz-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); +} + +.progress-bar-info { + background-color: #5bc0de; +} + +.progress-striped .progress-bar-info { + background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent)); + background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: -moz-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); +} + +.progress-bar-warning { + background-color: #f0ad4e; +} + +.progress-striped .progress-bar-warning { + background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent)); + background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: -moz-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); +} + +.progress-bar-danger { + background-color: #d9534f; +} + +.progress-striped .progress-bar-danger { + background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent)); + background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: -moz-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); + background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); +} + +.media, +.media-body { + overflow: hidden; + zoom: 1; +} + +.media, +.media .media { + margin-top: 15px; +} + +.media:first-child { + margin-top: 0; +} + +.media-object { + display: block; +} + +.media-heading { + margin: 0 0 5px; +} + +.media > .pull-left { + margin-right: 10px; +} + +.media > .pull-right { + margin-left: 10px; +} + +.media-list { + padding-left: 0; + list-style: none; +} + +.list-group { + padding-left: 0; + margin-bottom: 20px; +} + +.list-group-item { + position: relative; + display: block; + padding: 10px 15px; + margin-bottom: -1px; + background-color: #ffffff; + border: 1px solid #dddddd; +} + +.list-group-item:first-child { + border-top-right-radius: 4px; + border-top-left-radius: 4px; +} + +.list-group-item:last-child { + margin-bottom: 0; + border-bottom-right-radius: 4px; + border-bottom-left-radius: 4px; +} + +.list-group-item > .badge { + float: right; +} + +.list-group-item > .badge + .badge { + margin-right: 5px; +} + +a.list-group-item { + color: #555555; +} + +a.list-group-item .list-group-item-heading { + color: #333333; +} + +a.list-group-item:hover, +a.list-group-item:focus { + text-decoration: none; + background-color: #f5f5f5; +} + +a.list-group-item.active, +a.list-group-item.active:hover, +a.list-group-item.active:focus { + z-index: 2; + color: #ffffff; + background-color: #428bca; + border-color: #428bca; +} + +a.list-group-item.active .list-group-item-heading, +a.list-group-item.active:hover .list-group-item-heading, +a.list-group-item.active:focus .list-group-item-heading { + color: inherit; +} + +a.list-group-item.active .list-group-item-text, +a.list-group-item.active:hover .list-group-item-text, +a.list-group-item.active:focus .list-group-item-text { + color: #e1edf7; +} + +.list-group-item-heading { + margin-top: 0; + margin-bottom: 5px; +} + +.list-group-item-text { + margin-bottom: 0; + line-height: 1.3; +} + +.panel { + margin-bottom: 20px; + background-color: #ffffff; + border: 1px solid transparent; + border-radius: 4px; + -webkit-box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05); + box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05); +} + +.panel-body { + padding: 15px; +} + +.panel-body:before, +.panel-body:after { + display: table; + content: " "; +} + +.panel-body:after { + clear: both; +} + +.panel-body:before, +.panel-body:after { + display: table; + content: " "; +} + +.panel-body:after { + clear: both; +} + +.panel > .list-group { + margin-bottom: 0; +} + +.panel > .list-group .list-group-item { + border-width: 1px 0; +} + +.panel > .list-group .list-group-item:first-child { + border-top-right-radius: 0; + border-top-left-radius: 0; +} + +.panel > .list-group .list-group-item:last-child { + border-bottom: 0; +} + +.panel-heading + .list-group .list-group-item:first-child { + border-top-width: 0; +} + +.panel > .table, +.panel > .table-responsive { + margin-bottom: 0; +} + +.panel > .panel-body + .table, +.panel > .panel-body + .table-responsive { + border-top: 1px solid #dddddd; +} + +.panel > .table-bordered, +.panel > .table-responsive > .table-bordered { + border: 0; +} + +.panel > .table-bordered > thead > tr > th:first-child, +.panel > .table-responsive > .table-bordered > thead > tr > th:first-child, +.panel > .table-bordered > tbody > tr > th:first-child, +.panel > .table-responsive > .table-bordered > tbody > tr > th:first-child, +.panel > .table-bordered > tfoot > tr > th:first-child, +.panel > .table-responsive > .table-bordered > tfoot > tr > th:first-child, +.panel > .table-bordered > thead > tr > td:first-child, +.panel > .table-responsive > .table-bordered > thead > tr > td:first-child, +.panel > .table-bordered > tbody > tr > td:first-child, +.panel > .table-responsive > .table-bordered > tbody > tr > td:first-child, +.panel > .table-bordered > tfoot > tr > td:first-child, +.panel > .table-responsive > .table-bordered > tfoot > tr > td:first-child { + border-left: 0; +} + +.panel > .table-bordered > thead > tr > th:last-child, +.panel > .table-responsive > .table-bordered > thead > tr > th:last-child, +.panel > .table-bordered > tbody > tr > th:last-child, +.panel > .table-responsive > .table-bordered > tbody > tr > th:last-child, +.panel > .table-bordered > tfoot > tr > th:last-child, +.panel > .table-responsive > .table-bordered > tfoot > tr > th:last-child, +.panel > .table-bordered > thead > tr > td:last-child, +.panel > .table-responsive > .table-bordered > thead > tr > td:last-child, +.panel > .table-bordered > tbody > tr > td:last-child, +.panel > .table-responsive > .table-bordered > tbody > tr > td:last-child, +.panel > .table-bordered > tfoot > tr > td:last-child, +.panel > .table-responsive > .table-bordered > tfoot > tr > td:last-child { + border-right: 0; +} + +.panel > .table-bordered > thead > tr:last-child > th, +.panel > .table-responsive > .table-bordered > thead > tr:last-child > th, +.panel > .table-bordered > tbody > tr:last-child > th, +.panel > .table-responsive > .table-bordered > tbody > tr:last-child > th, +.panel > .table-bordered > tfoot > tr:last-child > th, +.panel > .table-responsive > .table-bordered > tfoot > tr:last-child > th, +.panel > .table-bordered > thead > tr:last-child > td, +.panel > .table-responsive > .table-bordered > thead > tr:last-child > td, +.panel > .table-bordered > tbody > tr:last-child > td, +.panel > .table-responsive > .table-bordered > tbody > tr:last-child > td, +.panel > .table-bordered > tfoot > tr:last-child > td, +.panel > .table-responsive > .table-bordered > tfoot > tr:last-child > td { + border-bottom: 0; +} + +.panel-heading { + padding: 10px 15px; + border-bottom: 1px solid transparent; + border-top-right-radius: 3px; + border-top-left-radius: 3px; +} + +.panel-heading > .dropdown .dropdown-toggle { + color: inherit; +} + +.panel-title { + margin-top: 0; + margin-bottom: 0; + font-size: 16px; +} + +.panel-title > a { + color: inherit; +} + +.panel-footer { + padding: 10px 15px; + background-color: #f5f5f5; + border-top: 1px solid #dddddd; + border-bottom-right-radius: 3px; + border-bottom-left-radius: 3px; +} + +.panel-group .panel { + margin-bottom: 0; + overflow: hidden; + border-radius: 4px; +} + +.panel-group .panel + .panel { + margin-top: 5px; +} + +.panel-group .panel-heading { + border-bottom: 0; +} + +.panel-group .panel-heading + .panel-collapse .panel-body { + border-top: 1px solid #dddddd; +} + +.panel-group .panel-footer { + border-top: 0; +} + +.panel-group .panel-footer + .panel-collapse .panel-body { + border-bottom: 1px solid #dddddd; +} + +.panel-default { + border-color: #dddddd; +} + +.panel-default > .panel-heading { + color: #333333; + background-color: #f5f5f5; + border-color: #dddddd; +} + +.panel-default > .panel-heading + .panel-collapse .panel-body { + border-top-color: #dddddd; +} + +.panel-default > .panel-heading > .dropdown .caret { + border-color: #333333 transparent; +} + +.panel-default > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #dddddd; +} + +.panel-primary { + border-color: #428bca; +} + +.panel-primary > .panel-heading { + color: #ffffff; + background-color: #428bca; + border-color: #428bca; +} + +.panel-primary > .panel-heading + .panel-collapse .panel-body { + border-top-color: #428bca; +} + +.panel-primary > .panel-heading > .dropdown .caret { + border-color: #ffffff transparent; +} + +.panel-primary > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #428bca; +} + +.panel-success { + border-color: #d6e9c6; +} + +.panel-success > .panel-heading { + color: #468847; + background-color: #dff0d8; + border-color: #d6e9c6; +} + +.panel-success > .panel-heading + .panel-collapse .panel-body { + border-top-color: #d6e9c6; +} + +.panel-success > .panel-heading > .dropdown .caret { + border-color: #468847 transparent; +} + +.panel-success > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #d6e9c6; +} + +.panel-warning { + border-color: #faebcc; +} + +.panel-warning > .panel-heading { + color: #c09853; + background-color: #fcf8e3; + border-color: #faebcc; +} + +.panel-warning > .panel-heading + .panel-collapse .panel-body { + border-top-color: #faebcc; +} + +.panel-warning > .panel-heading > .dropdown .caret { + border-color: #c09853 transparent; +} + +.panel-warning > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #faebcc; +} + +.panel-danger { + border-color: #ebccd1; +} + +.panel-danger > .panel-heading { + color: #b94a48; + background-color: #f2dede; + border-color: #ebccd1; +} + +.panel-danger > .panel-heading + .panel-collapse .panel-body { + border-top-color: #ebccd1; +} + +.panel-danger > .panel-heading > .dropdown .caret { + border-color: #b94a48 transparent; +} + +.panel-danger > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #ebccd1; +} + +.panel-info { + border-color: #bce8f1; +} + +.panel-info > .panel-heading { + color: #3a87ad; + background-color: #d9edf7; + border-color: #bce8f1; +} + +.panel-info > .panel-heading + .panel-collapse .panel-body { + border-top-color: #bce8f1; +} + +.panel-info > .panel-heading > .dropdown .caret { + border-color: #3a87ad transparent; +} + +.panel-info > .panel-footer + .panel-collapse .panel-body { + border-bottom-color: #bce8f1; +} + +.well { + min-height: 20px; + padding: 19px; + margin-bottom: 20px; + background-color: #f5f5f5; + border: 1px solid #e3e3e3; + border-radius: 4px; + -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); + box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); +} + +.well blockquote { + border-color: #ddd; + border-color: rgba(0, 0, 0, 0.15); +} + +.well-lg { + padding: 24px; + border-radius: 6px; +} + +.well-sm { + padding: 9px; + border-radius: 3px; +} + +.close { + float: right; + font-size: 21px; + font-weight: bold; + line-height: 1; + color: #000000; + text-shadow: 0 1px 0 #ffffff; + opacity: 0.2; + filter: alpha(opacity=20); +} + +.close:hover, +.close:focus { + color: #000000; + text-decoration: none; + cursor: pointer; + opacity: 0.5; + filter: alpha(opacity=50); +} + +button.close { + padding: 0; + cursor: pointer; + background: transparent; + border: 0; + -webkit-appearance: none; +} + +.modal-open { + overflow: hidden; +} + +.modal { + position: fixed; + top: 0; + right: 0; + bottom: 0; + left: 0; + z-index: 1040; + display: none; + overflow: auto; + overflow-y: scroll; +} + +.modal.fade .modal-dialog { + -webkit-transform: translate(0, -25%); + -ms-transform: translate(0, -25%); + transform: translate(0, -25%); + -webkit-transition: -webkit-transform 0.3s ease-out; + -moz-transition: -moz-transform 0.3s ease-out; + -o-transition: -o-transform 0.3s ease-out; + transition: transform 0.3s ease-out; +} + +.modal.in .modal-dialog { + -webkit-transform: translate(0, 0); + -ms-transform: translate(0, 0); + transform: translate(0, 0); +} + +.modal-dialog { + position: relative; + z-index: 1050; + width: auto; + padding: 10px; + margin-right: auto; + margin-left: auto; +} + +.modal-content { + position: relative; + background-color: #ffffff; + border: 1px solid #999999; + border: 1px solid rgba(0, 0, 0, 0.2); + border-radius: 6px; + outline: none; + -webkit-box-shadow: 0 3px 9px rgba(0, 0, 0, 0.5); + box-shadow: 0 3px 9px rgba(0, 0, 0, 0.5); + background-clip: padding-box; +} + +.modal-backdrop { + position: fixed; + top: 0; + right: 0; + bottom: 0; + left: 0; + z-index: 1030; + background-color: #000000; +} + +.modal-backdrop.fade { + opacity: 0; + filter: alpha(opacity=0); +} + +.modal-backdrop.in { + opacity: 0.5; + filter: alpha(opacity=50); +} + +.modal-header { + min-height: 16.428571429px; + padding: 15px; + border-bottom: 1px solid #e5e5e5; +} + +.modal-header .close { + margin-top: -2px; +} + +.modal-title { + margin: 0; + line-height: 1.428571429; +} + +.modal-body { + position: relative; + padding: 20px; +} + +.modal-footer { + padding: 19px 20px 20px; + margin-top: 15px; + text-align: right; + border-top: 1px solid #e5e5e5; +} + +.modal-footer:before, +.modal-footer:after { + display: table; + content: " "; +} + +.modal-footer:after { + clear: both; +} + +.modal-footer:before, +.modal-footer:after { + display: table; + content: " "; +} + +.modal-footer:after { + clear: both; +} + +.modal-footer .btn + .btn { + margin-bottom: 0; + margin-left: 5px; +} + +.modal-footer .btn-group .btn + .btn { + margin-left: -1px; +} + +.modal-footer .btn-block + .btn-block { + margin-left: 0; +} + +@media screen and (min-width: 768px) { + .modal-dialog { + width: 600px; + padding-top: 30px; + padding-bottom: 30px; + } + .modal-content { + -webkit-box-shadow: 0 5px 15px rgba(0, 0, 0, 0.5); + box-shadow: 0 5px 15px rgba(0, 0, 0, 0.5); + } +} + +.tooltip { + position: absolute; + z-index: 1030; + display: block; + font-size: 12px; + line-height: 1.4; + opacity: 0; + filter: alpha(opacity=0); + visibility: visible; +} + +.tooltip.in { + opacity: 0.9; + filter: alpha(opacity=90); +} + +.tooltip.top { + padding: 5px 0; + margin-top: -3px; +} + +.tooltip.right { + padding: 0 5px; + margin-left: 3px; +} + +.tooltip.bottom { + padding: 5px 0; + margin-top: 3px; +} + +.tooltip.left { + padding: 0 5px; + margin-left: -3px; +} + +.tooltip-inner { + max-width: 200px; + padding: 3px 8px; + color: #ffffff; + text-align: center; + text-decoration: none; + background-color: #000000; + border-radius: 4px; +} + +.tooltip-arrow { + position: absolute; + width: 0; + height: 0; + border-color: transparent; + border-style: solid; +} + +.tooltip.top .tooltip-arrow { + bottom: 0; + left: 50%; + margin-left: -5px; + border-top-color: #000000; + border-width: 5px 5px 0; +} + +.tooltip.top-left .tooltip-arrow { + bottom: 0; + left: 5px; + border-top-color: #000000; + border-width: 5px 5px 0; +} + +.tooltip.top-right .tooltip-arrow { + right: 5px; + bottom: 0; + border-top-color: #000000; + border-width: 5px 5px 0; +} + +.tooltip.right .tooltip-arrow { + top: 50%; + left: 0; + margin-top: -5px; + border-right-color: #000000; + border-width: 5px 5px 5px 0; +} + +.tooltip.left .tooltip-arrow { + top: 50%; + right: 0; + margin-top: -5px; + border-left-color: #000000; + border-width: 5px 0 5px 5px; +} + +.tooltip.bottom .tooltip-arrow { + top: 0; + left: 50%; + margin-left: -5px; + border-bottom-color: #000000; + border-width: 0 5px 5px; +} + +.tooltip.bottom-left .tooltip-arrow { + top: 0; + left: 5px; + border-bottom-color: #000000; + border-width: 0 5px 5px; +} + +.tooltip.bottom-right .tooltip-arrow { + top: 0; + right: 5px; + border-bottom-color: #000000; + border-width: 0 5px 5px; +} + +.popover { + position: absolute; + top: 0; + left: 0; + z-index: 1010; + display: none; + max-width: 276px; + padding: 1px; + text-align: left; + white-space: normal; + background-color: #ffffff; + border: 1px solid #cccccc; + border: 1px solid rgba(0, 0, 0, 0.2); + border-radius: 6px; + -webkit-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); + box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); + background-clip: padding-box; +} + +.popover.top { + margin-top: -10px; +} + +.popover.right { + margin-left: 10px; +} + +.popover.bottom { + margin-top: 10px; +} + +.popover.left { + margin-left: -10px; +} + +.popover-title { + padding: 8px 14px; + margin: 0; + font-size: 14px; + font-weight: normal; + line-height: 18px; + background-color: #f7f7f7; + border-bottom: 1px solid #ebebeb; + border-radius: 5px 5px 0 0; +} + +.popover-content { + padding: 9px 14px; +} + +.popover .arrow, +.popover .arrow:after { + position: absolute; + display: block; + width: 0; + height: 0; + border-color: transparent; + border-style: solid; +} + +.popover .arrow { + border-width: 11px; +} + +.popover .arrow:after { + border-width: 10px; + content: ""; +} + +.popover.top .arrow { + bottom: -11px; + left: 50%; + margin-left: -11px; + border-top-color: #999999; + border-top-color: rgba(0, 0, 0, 0.25); + border-bottom-width: 0; +} + +.popover.top .arrow:after { + bottom: 1px; + margin-left: -10px; + border-top-color: #ffffff; + border-bottom-width: 0; + content: " "; +} + +.popover.right .arrow { + top: 50%; + left: -11px; + margin-top: -11px; + border-right-color: #999999; + border-right-color: rgba(0, 0, 0, 0.25); + border-left-width: 0; +} + +.popover.right .arrow:after { + bottom: -10px; + left: 1px; + border-right-color: #ffffff; + border-left-width: 0; + content: " "; +} + +.popover.bottom .arrow { + top: -11px; + left: 50%; + margin-left: -11px; + border-bottom-color: #999999; + border-bottom-color: rgba(0, 0, 0, 0.25); + border-top-width: 0; +} + +.popover.bottom .arrow:after { + top: 1px; + margin-left: -10px; + border-bottom-color: #ffffff; + border-top-width: 0; + content: " "; +} + +.popover.left .arrow { + top: 50%; + right: -11px; + margin-top: -11px; + border-left-color: #999999; + border-left-color: rgba(0, 0, 0, 0.25); + border-right-width: 0; +} + +.popover.left .arrow:after { + right: 1px; + bottom: -10px; + border-left-color: #ffffff; + border-right-width: 0; + content: " "; +} + +.carousel { + position: relative; +} + +.carousel-inner { + position: relative; + width: 100%; + overflow: hidden; +} + +.carousel-inner > .item { + position: relative; + display: none; + -webkit-transition: 0.6s ease-in-out left; + transition: 0.6s ease-in-out left; +} + +.carousel-inner > .item > img, +.carousel-inner > .item > a > img { + display: block; + height: auto; + max-width: 100%; + line-height: 1; +} + +.carousel-inner > .active, +.carousel-inner > .next, +.carousel-inner > .prev { + display: block; +} + +.carousel-inner > .active { + left: 0; +} + +.carousel-inner > .next, +.carousel-inner > .prev { + position: absolute; + top: 0; + width: 100%; +} + +.carousel-inner > .next { + left: 100%; +} + +.carousel-inner > .prev { + left: -100%; +} + +.carousel-inner > .next.left, +.carousel-inner > .prev.right { + left: 0; +} + +.carousel-inner > .active.left { + left: -100%; +} + +.carousel-inner > .active.right { + left: 100%; +} + +.carousel-control { + position: absolute; + top: 0; + bottom: 0; + left: 0; + width: 15%; + font-size: 20px; + color: #ffffff; + text-align: center; + text-shadow: 0 1px 2px rgba(0, 0, 0, 0.6); + opacity: 0.5; + filter: alpha(opacity=50); +} + +.carousel-control.left { + background-image: -webkit-gradient(linear, 0 top, 100% top, from(rgba(0, 0, 0, 0.5)), to(rgba(0, 0, 0, 0.0001))); + background-image: -webkit-linear-gradient(left, color-stop(rgba(0, 0, 0, 0.5) 0), color-stop(rgba(0, 0, 0, 0.0001) 100%)); + background-image: -moz-linear-gradient(left, rgba(0, 0, 0, 0.5) 0, rgba(0, 0, 0, 0.0001) 100%); + background-image: linear-gradient(to right, rgba(0, 0, 0, 0.5) 0, rgba(0, 0, 0, 0.0001) 100%); + background-repeat: repeat-x; + filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#80000000', endColorstr='#00000000', GradientType=1); +} + +.carousel-control.right { + right: 0; + left: auto; + background-image: -webkit-gradient(linear, 0 top, 100% top, from(rgba(0, 0, 0, 0.0001)), to(rgba(0, 0, 0, 0.5))); + background-image: -webkit-linear-gradient(left, color-stop(rgba(0, 0, 0, 0.0001) 0), color-stop(rgba(0, 0, 0, 0.5) 100%)); + background-image: -moz-linear-gradient(left, rgba(0, 0, 0, 0.0001) 0, rgba(0, 0, 0, 0.5) 100%); + background-image: linear-gradient(to right, rgba(0, 0, 0, 0.0001) 0, rgba(0, 0, 0, 0.5) 100%); + background-repeat: repeat-x; + filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#00000000', endColorstr='#80000000', GradientType=1); +} + +.carousel-control:hover, +.carousel-control:focus { + color: #ffffff; + text-decoration: none; + opacity: 0.9; + filter: alpha(opacity=90); +} + +.carousel-control .icon-prev, +.carousel-control .icon-next, +.carousel-control .glyphicon-chevron-left, +.carousel-control .glyphicon-chevron-right { + position: absolute; + top: 50%; + z-index: 5; + display: inline-block; +} + +.carousel-control .icon-prev, +.carousel-control .glyphicon-chevron-left { + left: 50%; +} + +.carousel-control .icon-next, +.carousel-control .glyphicon-chevron-right { + right: 50%; +} + +.carousel-control .icon-prev, +.carousel-control .icon-next { + width: 20px; + height: 20px; + margin-top: -10px; + margin-left: -10px; + font-family: serif; +} + +.carousel-control .icon-prev:before { + content: '\2039'; +} + +.carousel-control .icon-next:before { + content: '\203a'; +} + +.carousel-indicators { + position: absolute; + bottom: 10px; + left: 50%; + z-index: 15; + width: 60%; + padding-left: 0; + margin-left: -30%; + text-align: center; + list-style: none; +} + +.carousel-indicators li { + display: inline-block; + width: 10px; + height: 10px; + margin: 1px; + text-indent: -999px; + cursor: pointer; + background-color: #000 \9; + background-color: rgba(0, 0, 0, 0); + border: 1px solid #ffffff; + border-radius: 10px; +} + +.carousel-indicators .active { + width: 12px; + height: 12px; + margin: 0; + background-color: #ffffff; +} + +.carousel-caption { + position: absolute; + right: 15%; + bottom: 20px; + left: 15%; + z-index: 10; + padding-top: 20px; + padding-bottom: 20px; + color: #ffffff; + text-align: center; + text-shadow: 0 1px 2px rgba(0, 0, 0, 0.6); +} + +.carousel-caption .btn { + text-shadow: none; +} + +@media screen and (min-width: 768px) { + .carousel-control .glyphicons-chevron-left, + .carousel-control .glyphicons-chevron-right, + .carousel-control .icon-prev, + .carousel-control .icon-next { + width: 30px; + height: 30px; + margin-top: -15px; + margin-left: -15px; + font-size: 30px; + } + .carousel-caption { + right: 20%; + left: 20%; + padding-bottom: 30px; + } + .carousel-indicators { + bottom: 20px; + } +} + +.clearfix:before, +.clearfix:after { + display: table; + content: " "; +} + +.clearfix:after { + clear: both; +} + +.center-block { + display: block; + margin-right: auto; + margin-left: auto; +} + +.pull-right { + float: right !important; +} + +.pull-left { + float: left !important; +} + +.hide { + display: none !important; +} + +.show { + display: block !important; +} + +.invisible { + visibility: hidden; +} + +.text-hide { + font: 0/0 a; + color: transparent; + text-shadow: none; + background-color: transparent; + border: 0; +} + +.hidden { + display: none !important; + visibility: hidden !important; +} + +.affix { + position: fixed; +} + +@-ms-viewport { + width: device-width; +} + +.visible-xs, +tr.visible-xs, +th.visible-xs, +td.visible-xs { + display: none !important; +} + +@media (max-width: 767px) { + .visible-xs { + display: block !important; + } + tr.visible-xs { + display: table-row !important; + } + th.visible-xs, + td.visible-xs { + display: table-cell !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .visible-xs.visible-sm { + display: block !important; + } + tr.visible-xs.visible-sm { + display: table-row !important; + } + th.visible-xs.visible-sm, + td.visible-xs.visible-sm { + display: table-cell !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .visible-xs.visible-md { + display: block !important; + } + tr.visible-xs.visible-md { + display: table-row !important; + } + th.visible-xs.visible-md, + td.visible-xs.visible-md { + display: table-cell !important; + } +} + +@media (min-width: 1200px) { + .visible-xs.visible-lg { + display: block !important; + } + tr.visible-xs.visible-lg { + display: table-row !important; + } + th.visible-xs.visible-lg, + td.visible-xs.visible-lg { + display: table-cell !important; + } +} + +.visible-sm, +tr.visible-sm, +th.visible-sm, +td.visible-sm { + display: none !important; +} + +@media (max-width: 767px) { + .visible-sm.visible-xs { + display: block !important; + } + tr.visible-sm.visible-xs { + display: table-row !important; + } + th.visible-sm.visible-xs, + td.visible-sm.visible-xs { + display: table-cell !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .visible-sm { + display: block !important; + } + tr.visible-sm { + display: table-row !important; + } + th.visible-sm, + td.visible-sm { + display: table-cell !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .visible-sm.visible-md { + display: block !important; + } + tr.visible-sm.visible-md { + display: table-row !important; + } + th.visible-sm.visible-md, + td.visible-sm.visible-md { + display: table-cell !important; + } +} + +@media (min-width: 1200px) { + .visible-sm.visible-lg { + display: block !important; + } + tr.visible-sm.visible-lg { + display: table-row !important; + } + th.visible-sm.visible-lg, + td.visible-sm.visible-lg { + display: table-cell !important; + } +} + +.visible-md, +tr.visible-md, +th.visible-md, +td.visible-md { + display: none !important; +} + +@media (max-width: 767px) { + .visible-md.visible-xs { + display: block !important; + } + tr.visible-md.visible-xs { + display: table-row !important; + } + th.visible-md.visible-xs, + td.visible-md.visible-xs { + display: table-cell !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .visible-md.visible-sm { + display: block !important; + } + tr.visible-md.visible-sm { + display: table-row !important; + } + th.visible-md.visible-sm, + td.visible-md.visible-sm { + display: table-cell !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .visible-md { + display: block !important; + } + tr.visible-md { + display: table-row !important; + } + th.visible-md, + td.visible-md { + display: table-cell !important; + } +} + +@media (min-width: 1200px) { + .visible-md.visible-lg { + display: block !important; + } + tr.visible-md.visible-lg { + display: table-row !important; + } + th.visible-md.visible-lg, + td.visible-md.visible-lg { + display: table-cell !important; + } +} + +.visible-lg, +tr.visible-lg, +th.visible-lg, +td.visible-lg { + display: none !important; +} + +@media (max-width: 767px) { + .visible-lg.visible-xs { + display: block !important; + } + tr.visible-lg.visible-xs { + display: table-row !important; + } + th.visible-lg.visible-xs, + td.visible-lg.visible-xs { + display: table-cell !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .visible-lg.visible-sm { + display: block !important; + } + tr.visible-lg.visible-sm { + display: table-row !important; + } + th.visible-lg.visible-sm, + td.visible-lg.visible-sm { + display: table-cell !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .visible-lg.visible-md { + display: block !important; + } + tr.visible-lg.visible-md { + display: table-row !important; + } + th.visible-lg.visible-md, + td.visible-lg.visible-md { + display: table-cell !important; + } +} + +@media (min-width: 1200px) { + .visible-lg { + display: block !important; + } + tr.visible-lg { + display: table-row !important; + } + th.visible-lg, + td.visible-lg { + display: table-cell !important; + } +} + +.hidden-xs { + display: block !important; +} + +tr.hidden-xs { + display: table-row !important; +} + +th.hidden-xs, +td.hidden-xs { + display: table-cell !important; +} + +@media (max-width: 767px) { + .hidden-xs, + tr.hidden-xs, + th.hidden-xs, + td.hidden-xs { + display: none !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .hidden-xs.hidden-sm, + tr.hidden-xs.hidden-sm, + th.hidden-xs.hidden-sm, + td.hidden-xs.hidden-sm { + display: none !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .hidden-xs.hidden-md, + tr.hidden-xs.hidden-md, + th.hidden-xs.hidden-md, + td.hidden-xs.hidden-md { + display: none !important; + } +} + +@media (min-width: 1200px) { + .hidden-xs.hidden-lg, + tr.hidden-xs.hidden-lg, + th.hidden-xs.hidden-lg, + td.hidden-xs.hidden-lg { + display: none !important; + } +} + +.hidden-sm { + display: block !important; +} + +tr.hidden-sm { + display: table-row !important; +} + +th.hidden-sm, +td.hidden-sm { + display: table-cell !important; +} + +@media (max-width: 767px) { + .hidden-sm.hidden-xs, + tr.hidden-sm.hidden-xs, + th.hidden-sm.hidden-xs, + td.hidden-sm.hidden-xs { + display: none !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .hidden-sm, + tr.hidden-sm, + th.hidden-sm, + td.hidden-sm { + display: none !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .hidden-sm.hidden-md, + tr.hidden-sm.hidden-md, + th.hidden-sm.hidden-md, + td.hidden-sm.hidden-md { + display: none !important; + } +} + +@media (min-width: 1200px) { + .hidden-sm.hidden-lg, + tr.hidden-sm.hidden-lg, + th.hidden-sm.hidden-lg, + td.hidden-sm.hidden-lg { + display: none !important; + } +} + +.hidden-md { + display: block !important; +} + +tr.hidden-md { + display: table-row !important; +} + +th.hidden-md, +td.hidden-md { + display: table-cell !important; +} + +@media (max-width: 767px) { + .hidden-md.hidden-xs, + tr.hidden-md.hidden-xs, + th.hidden-md.hidden-xs, + td.hidden-md.hidden-xs { + display: none !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .hidden-md.hidden-sm, + tr.hidden-md.hidden-sm, + th.hidden-md.hidden-sm, + td.hidden-md.hidden-sm { + display: none !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .hidden-md, + tr.hidden-md, + th.hidden-md, + td.hidden-md { + display: none !important; + } +} + +@media (min-width: 1200px) { + .hidden-md.hidden-lg, + tr.hidden-md.hidden-lg, + th.hidden-md.hidden-lg, + td.hidden-md.hidden-lg { + display: none !important; + } +} + +.hidden-lg { + display: block !important; +} + +tr.hidden-lg { + display: table-row !important; +} + +th.hidden-lg, +td.hidden-lg { + display: table-cell !important; +} + +@media (max-width: 767px) { + .hidden-lg.hidden-xs, + tr.hidden-lg.hidden-xs, + th.hidden-lg.hidden-xs, + td.hidden-lg.hidden-xs { + display: none !important; + } +} + +@media (min-width: 768px) and (max-width: 991px) { + .hidden-lg.hidden-sm, + tr.hidden-lg.hidden-sm, + th.hidden-lg.hidden-sm, + td.hidden-lg.hidden-sm { + display: none !important; + } +} + +@media (min-width: 992px) and (max-width: 1199px) { + .hidden-lg.hidden-md, + tr.hidden-lg.hidden-md, + th.hidden-lg.hidden-md, + td.hidden-lg.hidden-md { + display: none !important; + } +} + +@media (min-width: 1200px) { + .hidden-lg, + tr.hidden-lg, + th.hidden-lg, + td.hidden-lg { + display: none !important; + } +} + +.visible-print, +tr.visible-print, +th.visible-print, +td.visible-print { + display: none !important; +} + +@media print { + .visible-print { + display: block !important; + } + tr.visible-print { + display: table-row !important; + } + th.visible-print, + td.visible-print { + display: table-cell !important; + } + .hidden-print, + tr.hidden-print, + th.hidden-print, + td.hidden-print { + display: none !important; + } +} \ No newline at end of file diff --git a/docs/theme/mkdocs/css/bootstrap-custom.min.css b/docs/theme/mkdocs/css/bootstrap-custom.min.css new file mode 100644 index 0000000000..74ffc98dc4 --- /dev/null +++ b/docs/theme/mkdocs/css/bootstrap-custom.min.css @@ -0,0 +1,7 @@ +/*! + * Bootstrap v3.0.2 by @fat and @mdo + * Copyright 2013 Twitter, Inc. + * Licensed under http://www.apache.org/licenses/LICENSE-2.0 + * + * Designed and built with all the love in the world by @mdo and @fat. + *//*! normalize.css v2.1.3 | MIT License | git.io/normalize */article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}html{font-family:sans-serif;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a{background:transparent}a:focus{outline:thin dotted}a:active,a:hover{outline:0}h1{margin:.67em 0;font-size:2em}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}dfn{font-style:italic}hr{height:0;-moz-box-sizing:content-box;box-sizing:content-box}mark{color:#000;background:#ff0}code,kbd,pre,samp{font-family:monospace,serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}small{font-size:80%}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:0}fieldset{padding:.35em .625em .75em;margin:0 2px;border:1px solid silver}legend{padding:0;border:0}button,input,select,textarea{margin:0;font-family:inherit;font-size:100%}button,input{line-height:normal}button,select{text-transform:none}button,html input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button}button[disabled],html input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{padding:0;box-sizing:border-box}input[type="search"]{-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;-webkit-appearance:textfield}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{padding:0;border:0}textarea{overflow:auto;vertical-align:top}table{border-collapse:collapse;border-spacing:0}@media print{*{color:#000 !important;text-shadow:none !important;background:transparent !important;box-shadow:none !important}a,a:visited{text-decoration:underline}a[href]:after{content:" (" attr(href) ")"}abbr[title]:after{content:" (" attr(title) ")"}a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{border:1px solid #999;page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:2cm .5cm}p,h2,h3{orphans:3;widows:3}h2,h3{page-break-after:avoid}select{background:#fff !important}.navbar{display:none}.table td,.table th{background-color:#fff !important}.btn>.caret,.dropup>.btn>.caret{border-top-color:#000 !important}.label{border:1px solid #000}.table{border-collapse:collapse !important}.table-bordered th,.table-bordered td{border:1px solid #ddd !important}}*,*:before,*:after{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:62.5%;-webkit-tap-highlight-color:rgba(0,0,0,0)}body{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:14px;line-height:1.428571429;color:#333;background-color:#fff}input,button,select,textarea{font-family:inherit;font-size:inherit;line-height:inherit}a{color:#428bca;text-decoration:none}a:hover,a:focus{color:#2a6496;text-decoration:underline}a:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}img{vertical-align:middle}.img-responsive{display:block;height:auto;max-width:100%}.img-rounded{border-radius:6px}.img-thumbnail{display:inline-block;height:auto;max-width:100%;padding:4px;line-height:1.428571429;background-color:#fff;border:1px solid #ddd;border-radius:4px;-webkit-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.img-circle{border-radius:50%}hr{margin-top:20px;margin-bottom:20px;border:0;border-top:1px solid #eee}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}p{margin:0 0 10px}.lead{margin-bottom:20px;font-size:16px;font-weight:200;line-height:1.4}@media(min-width:768px){.lead{font-size:21px}}small,.small{font-size:85%}cite{font-style:normal}.text-muted{color:#999}.text-primary{color:#428bca}.text-primary:hover{color:#3071a9}.text-warning{color:#c09853}.text-warning:hover{color:#a47e3c}.text-danger{color:#b94a48}.text-danger:hover{color:#953b39}.text-success{color:#468847}.text-success:hover{color:#356635}.text-info{color:#3a87ad}.text-info:hover{color:#2d6987}.text-left{text-align:left}.text-right{text-align:right}.text-center{text-align:center}h1,h2,h3,h4,h5,h6,.h1,.h2,.h3,.h4,.h5,.h6{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-weight:500;line-height:1.1;color:inherit}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small,.h1 small,.h2 small,.h3 small,.h4 small,.h5 small,.h6 small,h1 .small,h2 .small,h3 .small,h4 .small,h5 .small,h6 .small,.h1 .small,.h2 .small,.h3 .small,.h4 .small,.h5 .small,.h6 .small{font-weight:normal;line-height:1;color:#999}h1,h2,h3{margin-top:20px;margin-bottom:10px}h1 small,h2 small,h3 small,h1 .small,h2 .small,h3 .small{font-size:65%}h4,h5,h6{margin-top:10px;margin-bottom:10px}h4 small,h5 small,h6 small,h4 .small,h5 .small,h6 .small{font-size:75%}h1,.h1{font-size:36px}h2,.h2{font-size:30px}h3,.h3{font-size:24px}h4,.h4{font-size:18px}h5,.h5{font-size:14px}h6,.h6{font-size:12px}.page-header{padding-bottom:9px;margin:40px 0 20px;border-bottom:1px solid #eee}ul,ol{margin-top:0;margin-bottom:10px}ul ul,ol ul,ul ol,ol ol{margin-bottom:0}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline>li{display:inline-block;padding-right:5px;padding-left:5px}.list-inline>li:first-child{padding-left:0}dl{margin-bottom:20px}dt,dd{line-height:1.428571429}dt{font-weight:bold}dd{margin-left:0}@media(min-width:768px){.dl-horizontal dt{float:left;width:160px;overflow:hidden;clear:left;text-align:right;text-overflow:ellipsis;white-space:nowrap}.dl-horizontal dd{margin-left:180px}.dl-horizontal dd:before,.dl-horizontal dd:after{display:table;content:" "}.dl-horizontal dd:after{clear:both}.dl-horizontal dd:before,.dl-horizontal dd:after{display:table;content:" "}.dl-horizontal dd:after{clear:both}}abbr[title],abbr[data-original-title]{cursor:help;border-bottom:1px dotted #999}abbr.initialism{font-size:90%;text-transform:uppercase}blockquote{padding:10px 20px;margin:0 0 20px;border-left:5px solid #eee}blockquote p{font-size:17.5px;font-weight:300;line-height:1.25}blockquote p:last-child{margin-bottom:0}blockquote small{display:block;line-height:1.428571429;color:#999}blockquote small:before{content:'\2014 \00A0'}blockquote.pull-right{padding-right:15px;padding-left:0;border-right:5px solid #eee;border-left:0}blockquote.pull-right p,blockquote.pull-right small,blockquote.pull-right .small{text-align:right}blockquote.pull-right small:before,blockquote.pull-right .small:before{content:''}blockquote.pull-right small:after,blockquote.pull-right .small:after{content:'\00A0 \2014'}blockquote:before,blockquote:after{content:""}address{margin-bottom:20px;font-style:normal;line-height:1.428571429}code,kbd,pre,samp{font-family:Monaco,Menlo,Consolas,"Courier New",monospace}code{padding:2px 4px;font-size:90%;color:#c7254e;white-space:nowrap;background-color:#f9f2f4;border-radius:4px}pre{display:block;padding:9.5px;margin:0 0 10px;font-size:13px;line-height:1.428571429;color:#333;word-break:break-all;word-wrap:break-word;background-color:#f5f5f5;border:1px solid #ccc;border-radius:4px}pre code{padding:0;font-size:inherit;color:inherit;white-space:pre-wrap;background-color:transparent;border-radius:0}.pre-scrollable{max-height:340px;overflow-y:scroll}.container{padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}.container:before,.container:after{display:table;content:" "}.container:after{clear:both}.container:before,.container:after{display:table;content:" "}.container:after{clear:both}.row{margin-right:-15px;margin-left:-15px}.row:before,.row:after{display:table;content:" "}.row:after{clear:both}.row:before,.row:after{display:table;content:" "}.row:after{clear:both}.col-xs-1,.col-sm-1,.col-md-1,.col-lg-1,.col-xs-2,.col-sm-2,.col-md-2,.col-lg-2,.col-xs-3,.col-sm-3,.col-md-3,.col-lg-3,.col-xs-4,.col-sm-4,.col-md-4,.col-lg-4,.col-xs-5,.col-sm-5,.col-md-5,.col-lg-5,.col-xs-6,.col-sm-6,.col-md-6,.col-lg-6,.col-xs-7,.col-sm-7,.col-md-7,.col-lg-7,.col-xs-8,.col-sm-8,.col-md-8,.col-lg-8,.col-xs-9,.col-sm-9,.col-md-9,.col-lg-9,.col-xs-10,.col-sm-10,.col-md-10,.col-lg-10,.col-xs-11,.col-sm-11,.col-md-11,.col-lg-11,.col-xs-12,.col-sm-12,.col-md-12,.col-lg-12{position:relative;min-height:1px;padding-right:15px;padding-left:15px}.col-xs-1,.col-xs-2,.col-xs-3,.col-xs-4,.col-xs-5,.col-xs-6,.col-xs-7,.col-xs-8,.col-xs-9,.col-xs-10,.col-xs-11{float:left}.col-xs-12{width:100%}.col-xs-11{width:91.66666666666666%}.col-xs-10{width:83.33333333333334%}.col-xs-9{width:75%}.col-xs-8{width:66.66666666666666%}.col-xs-7{width:58.333333333333336%}.col-xs-6{width:50%}.col-xs-5{width:41.66666666666667%}.col-xs-4{width:33.33333333333333%}.col-xs-3{width:25%}.col-xs-2{width:16.666666666666664%}.col-xs-1{width:8.333333333333332%}.col-xs-pull-12{right:100%}.col-xs-pull-11{right:91.66666666666666%}.col-xs-pull-10{right:83.33333333333334%}.col-xs-pull-9{right:75%}.col-xs-pull-8{right:66.66666666666666%}.col-xs-pull-7{right:58.333333333333336%}.col-xs-pull-6{right:50%}.col-xs-pull-5{right:41.66666666666667%}.col-xs-pull-4{right:33.33333333333333%}.col-xs-pull-3{right:25%}.col-xs-pull-2{right:16.666666666666664%}.col-xs-pull-1{right:8.333333333333332%}.col-xs-pull-0{right:0}.col-xs-push-12{left:100%}.col-xs-push-11{left:91.66666666666666%}.col-xs-push-10{left:83.33333333333334%}.col-xs-push-9{left:75%}.col-xs-push-8{left:66.66666666666666%}.col-xs-push-7{left:58.333333333333336%}.col-xs-push-6{left:50%}.col-xs-push-5{left:41.66666666666667%}.col-xs-push-4{left:33.33333333333333%}.col-xs-push-3{left:25%}.col-xs-push-2{left:16.666666666666664%}.col-xs-push-1{left:8.333333333333332%}.col-xs-push-0{left:0}.col-xs-offset-12{margin-left:100%}.col-xs-offset-11{margin-left:91.66666666666666%}.col-xs-offset-10{margin-left:83.33333333333334%}.col-xs-offset-9{margin-left:75%}.col-xs-offset-8{margin-left:66.66666666666666%}.col-xs-offset-7{margin-left:58.333333333333336%}.col-xs-offset-6{margin-left:50%}.col-xs-offset-5{margin-left:41.66666666666667%}.col-xs-offset-4{margin-left:33.33333333333333%}.col-xs-offset-3{margin-left:25%}.col-xs-offset-2{margin-left:16.666666666666664%}.col-xs-offset-1{margin-left:8.333333333333332%}.col-xs-offset-0{margin-left:0}@media(min-width:768px){.container{width:750px}.col-sm-1,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-10,.col-sm-11{float:left}.col-sm-12{width:100%}.col-sm-11{width:91.66666666666666%}.col-sm-10{width:83.33333333333334%}.col-sm-9{width:75%}.col-sm-8{width:66.66666666666666%}.col-sm-7{width:58.333333333333336%}.col-sm-6{width:50%}.col-sm-5{width:41.66666666666667%}.col-sm-4{width:33.33333333333333%}.col-sm-3{width:25%}.col-sm-2{width:16.666666666666664%}.col-sm-1{width:8.333333333333332%}.col-sm-pull-12{right:100%}.col-sm-pull-11{right:91.66666666666666%}.col-sm-pull-10{right:83.33333333333334%}.col-sm-pull-9{right:75%}.col-sm-pull-8{right:66.66666666666666%}.col-sm-pull-7{right:58.333333333333336%}.col-sm-pull-6{right:50%}.col-sm-pull-5{right:41.66666666666667%}.col-sm-pull-4{right:33.33333333333333%}.col-sm-pull-3{right:25%}.col-sm-pull-2{right:16.666666666666664%}.col-sm-pull-1{right:8.333333333333332%}.col-sm-pull-0{right:0}.col-sm-push-12{left:100%}.col-sm-push-11{left:91.66666666666666%}.col-sm-push-10{left:83.33333333333334%}.col-sm-push-9{left:75%}.col-sm-push-8{left:66.66666666666666%}.col-sm-push-7{left:58.333333333333336%}.col-sm-push-6{left:50%}.col-sm-push-5{left:41.66666666666667%}.col-sm-push-4{left:33.33333333333333%}.col-sm-push-3{left:25%}.col-sm-push-2{left:16.666666666666664%}.col-sm-push-1{left:8.333333333333332%}.col-sm-push-0{left:0}.col-sm-offset-12{margin-left:100%}.col-sm-offset-11{margin-left:91.66666666666666%}.col-sm-offset-10{margin-left:83.33333333333334%}.col-sm-offset-9{margin-left:75%}.col-sm-offset-8{margin-left:66.66666666666666%}.col-sm-offset-7{margin-left:58.333333333333336%}.col-sm-offset-6{margin-left:50%}.col-sm-offset-5{margin-left:41.66666666666667%}.col-sm-offset-4{margin-left:33.33333333333333%}.col-sm-offset-3{margin-left:25%}.col-sm-offset-2{margin-left:16.666666666666664%}.col-sm-offset-1{margin-left:8.333333333333332%}.col-sm-offset-0{margin-left:0}}@media(min-width:992px){.container{width:970px}.col-md-1,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-10,.col-md-11{float:left}.col-md-12{width:100%}.col-md-11{width:91.66666666666666%}.col-md-10{width:83.33333333333334%}.col-md-9{width:75%}.col-md-8{width:66.66666666666666%}.col-md-7{width:58.333333333333336%}.col-md-6{width:50%}.col-md-5{width:41.66666666666667%}.col-md-4{width:33.33333333333333%}.col-md-3{width:25%}.col-md-2{width:16.666666666666664%}.col-md-1{width:8.333333333333332%}.col-md-pull-12{right:100%}.col-md-pull-11{right:91.66666666666666%}.col-md-pull-10{right:83.33333333333334%}.col-md-pull-9{right:75%}.col-md-pull-8{right:66.66666666666666%}.col-md-pull-7{right:58.333333333333336%}.col-md-pull-6{right:50%}.col-md-pull-5{right:41.66666666666667%}.col-md-pull-4{right:33.33333333333333%}.col-md-pull-3{right:25%}.col-md-pull-2{right:16.666666666666664%}.col-md-pull-1{right:8.333333333333332%}.col-md-pull-0{right:0}.col-md-push-12{left:100%}.col-md-push-11{left:91.66666666666666%}.col-md-push-10{left:83.33333333333334%}.col-md-push-9{left:75%}.col-md-push-8{left:66.66666666666666%}.col-md-push-7{left:58.333333333333336%}.col-md-push-6{left:50%}.col-md-push-5{left:41.66666666666667%}.col-md-push-4{left:33.33333333333333%}.col-md-push-3{left:25%}.col-md-push-2{left:16.666666666666664%}.col-md-push-1{left:8.333333333333332%}.col-md-push-0{left:0}.col-md-offset-12{margin-left:100%}.col-md-offset-11{margin-left:91.66666666666666%}.col-md-offset-10{margin-left:83.33333333333334%}.col-md-offset-9{margin-left:75%}.col-md-offset-8{margin-left:66.66666666666666%}.col-md-offset-7{margin-left:58.333333333333336%}.col-md-offset-6{margin-left:50%}.col-md-offset-5{margin-left:41.66666666666667%}.col-md-offset-4{margin-left:33.33333333333333%}.col-md-offset-3{margin-left:25%}.col-md-offset-2{margin-left:16.666666666666664%}.col-md-offset-1{margin-left:8.333333333333332%}.col-md-offset-0{margin-left:0}}@media(min-width:1200px){.container{width:1170px}.col-lg-1,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-10,.col-lg-11{float:left}.col-lg-12{width:100%}.col-lg-11{width:91.66666666666666%}.col-lg-10{width:83.33333333333334%}.col-lg-9{width:75%}.col-lg-8{width:66.66666666666666%}.col-lg-7{width:58.333333333333336%}.col-lg-6{width:50%}.col-lg-5{width:41.66666666666667%}.col-lg-4{width:33.33333333333333%}.col-lg-3{width:25%}.col-lg-2{width:16.666666666666664%}.col-lg-1{width:8.333333333333332%}.col-lg-pull-12{right:100%}.col-lg-pull-11{right:91.66666666666666%}.col-lg-pull-10{right:83.33333333333334%}.col-lg-pull-9{right:75%}.col-lg-pull-8{right:66.66666666666666%}.col-lg-pull-7{right:58.333333333333336%}.col-lg-pull-6{right:50%}.col-lg-pull-5{right:41.66666666666667%}.col-lg-pull-4{right:33.33333333333333%}.col-lg-pull-3{right:25%}.col-lg-pull-2{right:16.666666666666664%}.col-lg-pull-1{right:8.333333333333332%}.col-lg-pull-0{right:0}.col-lg-push-12{left:100%}.col-lg-push-11{left:91.66666666666666%}.col-lg-push-10{left:83.33333333333334%}.col-lg-push-9{left:75%}.col-lg-push-8{left:66.66666666666666%}.col-lg-push-7{left:58.333333333333336%}.col-lg-push-6{left:50%}.col-lg-push-5{left:41.66666666666667%}.col-lg-push-4{left:33.33333333333333%}.col-lg-push-3{left:25%}.col-lg-push-2{left:16.666666666666664%}.col-lg-push-1{left:8.333333333333332%}.col-lg-push-0{left:0}.col-lg-offset-12{margin-left:100%}.col-lg-offset-11{margin-left:91.66666666666666%}.col-lg-offset-10{margin-left:83.33333333333334%}.col-lg-offset-9{margin-left:75%}.col-lg-offset-8{margin-left:66.66666666666666%}.col-lg-offset-7{margin-left:58.333333333333336%}.col-lg-offset-6{margin-left:50%}.col-lg-offset-5{margin-left:41.66666666666667%}.col-lg-offset-4{margin-left:33.33333333333333%}.col-lg-offset-3{margin-left:25%}.col-lg-offset-2{margin-left:16.666666666666664%}.col-lg-offset-1{margin-left:8.333333333333332%}.col-lg-offset-0{margin-left:0}}table{max-width:100%;background-color:transparent}th{text-align:left}.table{width:100%;margin-bottom:20px}.table>thead>tr>th,.table>tbody>tr>th,.table>tfoot>tr>th,.table>thead>tr>td,.table>tbody>tr>td,.table>tfoot>tr>td{padding:8px;line-height:1.428571429;vertical-align:top;border-top:1px solid #ddd}.table>thead>tr>th{vertical-align:bottom;border-bottom:2px solid #ddd}.table>caption+thead>tr:first-child>th,.table>colgroup+thead>tr:first-child>th,.table>thead:first-child>tr:first-child>th,.table>caption+thead>tr:first-child>td,.table>colgroup+thead>tr:first-child>td,.table>thead:first-child>tr:first-child>td{border-top:0}.table>tbody+tbody{border-top:2px solid #ddd}.table .table{background-color:#fff}.table-condensed>thead>tr>th,.table-condensed>tbody>tr>th,.table-condensed>tfoot>tr>th,.table-condensed>thead>tr>td,.table-condensed>tbody>tr>td,.table-condensed>tfoot>tr>td{padding:5px}.table-bordered{border:1px solid #ddd}.table-bordered>thead>tr>th,.table-bordered>tbody>tr>th,.table-bordered>tfoot>tr>th,.table-bordered>thead>tr>td,.table-bordered>tbody>tr>td,.table-bordered>tfoot>tr>td{border:1px solid #ddd}.table-bordered>thead>tr>th,.table-bordered>thead>tr>td{border-bottom-width:2px}.table-striped>tbody>tr:nth-child(odd)>td,.table-striped>tbody>tr:nth-child(odd)>th{background-color:#f9f9f9}.table-hover>tbody>tr:hover>td,.table-hover>tbody>tr:hover>th{background-color:#f5f5f5}table col[class*="col-"]{display:table-column;float:none}table td[class*="col-"],table th[class*="col-"]{display:table-cell;float:none}.table>thead>tr>td.active,.table>tbody>tr>td.active,.table>tfoot>tr>td.active,.table>thead>tr>th.active,.table>tbody>tr>th.active,.table>tfoot>tr>th.active,.table>thead>tr.active>td,.table>tbody>tr.active>td,.table>tfoot>tr.active>td,.table>thead>tr.active>th,.table>tbody>tr.active>th,.table>tfoot>tr.active>th{background-color:#f5f5f5}.table>thead>tr>td.success,.table>tbody>tr>td.success,.table>tfoot>tr>td.success,.table>thead>tr>th.success,.table>tbody>tr>th.success,.table>tfoot>tr>th.success,.table>thead>tr.success>td,.table>tbody>tr.success>td,.table>tfoot>tr.success>td,.table>thead>tr.success>th,.table>tbody>tr.success>th,.table>tfoot>tr.success>th{background-color:#dff0d8}.table-hover>tbody>tr>td.success:hover,.table-hover>tbody>tr>th.success:hover,.table-hover>tbody>tr.success:hover>td,.table-hover>tbody>tr.success:hover>th{background-color:#d0e9c6}.table>thead>tr>td.danger,.table>tbody>tr>td.danger,.table>tfoot>tr>td.danger,.table>thead>tr>th.danger,.table>tbody>tr>th.danger,.table>tfoot>tr>th.danger,.table>thead>tr.danger>td,.table>tbody>tr.danger>td,.table>tfoot>tr.danger>td,.table>thead>tr.danger>th,.table>tbody>tr.danger>th,.table>tfoot>tr.danger>th{background-color:#f2dede}.table-hover>tbody>tr>td.danger:hover,.table-hover>tbody>tr>th.danger:hover,.table-hover>tbody>tr.danger:hover>td,.table-hover>tbody>tr.danger:hover>th{background-color:#ebcccc}.table>thead>tr>td.warning,.table>tbody>tr>td.warning,.table>tfoot>tr>td.warning,.table>thead>tr>th.warning,.table>tbody>tr>th.warning,.table>tfoot>tr>th.warning,.table>thead>tr.warning>td,.table>tbody>tr.warning>td,.table>tfoot>tr.warning>td,.table>thead>tr.warning>th,.table>tbody>tr.warning>th,.table>tfoot>tr.warning>th{background-color:#fcf8e3}.table-hover>tbody>tr>td.warning:hover,.table-hover>tbody>tr>th.warning:hover,.table-hover>tbody>tr.warning:hover>td,.table-hover>tbody>tr.warning:hover>th{background-color:#faf2cc}@media(max-width:767px){.table-responsive{width:100%;margin-bottom:15px;overflow-x:scroll;overflow-y:hidden;border:1px solid #ddd;-ms-overflow-style:-ms-autohiding-scrollbar;-webkit-overflow-scrolling:touch}.table-responsive>.table{margin-bottom:0}.table-responsive>.table>thead>tr>th,.table-responsive>.table>tbody>tr>th,.table-responsive>.table>tfoot>tr>th,.table-responsive>.table>thead>tr>td,.table-responsive>.table>tbody>tr>td,.table-responsive>.table>tfoot>tr>td{white-space:nowrap}.table-responsive>.table-bordered{border:0}.table-responsive>.table-bordered>thead>tr>th:first-child,.table-responsive>.table-bordered>tbody>tr>th:first-child,.table-responsive>.table-bordered>tfoot>tr>th:first-child,.table-responsive>.table-bordered>thead>tr>td:first-child,.table-responsive>.table-bordered>tbody>tr>td:first-child,.table-responsive>.table-bordered>tfoot>tr>td:first-child{border-left:0}.table-responsive>.table-bordered>thead>tr>th:last-child,.table-responsive>.table-bordered>tbody>tr>th:last-child,.table-responsive>.table-bordered>tfoot>tr>th:last-child,.table-responsive>.table-bordered>thead>tr>td:last-child,.table-responsive>.table-bordered>tbody>tr>td:last-child,.table-responsive>.table-bordered>tfoot>tr>td:last-child{border-right:0}.table-responsive>.table-bordered>tbody>tr:last-child>th,.table-responsive>.table-bordered>tfoot>tr:last-child>th,.table-responsive>.table-bordered>tbody>tr:last-child>td,.table-responsive>.table-bordered>tfoot>tr:last-child>td{border-bottom:0}}fieldset{padding:0;margin:0;border:0}legend{display:block;width:100%;padding:0;margin-bottom:20px;font-size:21px;line-height:inherit;color:#333;border:0;border-bottom:1px solid #e5e5e5}label{display:inline-block;margin-bottom:5px;font-weight:bold}input[type="search"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type="radio"],input[type="checkbox"]{margin:4px 0 0;margin-top:1px \9;line-height:normal}input[type="file"]{display:block}select[multiple],select[size]{height:auto}select optgroup{font-family:inherit;font-size:inherit;font-style:inherit}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}input[type="number"]::-webkit-outer-spin-button,input[type="number"]::-webkit-inner-spin-button{height:auto}output{display:block;padding-top:7px;font-size:14px;line-height:1.428571429;color:#555;vertical-align:middle}.form-control{display:block;width:100%;height:34px;padding:6px 12px;font-size:14px;line-height:1.428571429;color:#555;vertical-align:middle;background-color:#fff;background-image:none;border:1px solid #ccc;border-radius:4px;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-webkit-transition:border-color ease-in-out .15s,box-shadow ease-in-out .15s;transition:border-color ease-in-out .15s,box-shadow ease-in-out .15s}.form-control:focus{border-color:#66afe9;outline:0;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(102,175,233,0.6);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(102,175,233,0.6)}.form-control:-moz-placeholder{color:#999}.form-control::-moz-placeholder{color:#999}.form-control:-ms-input-placeholder{color:#999}.form-control::-webkit-input-placeholder{color:#999}.form-control[disabled],.form-control[readonly],fieldset[disabled] .form-control{cursor:not-allowed;background-color:#eee}textarea.form-control{height:auto}.form-group{margin-bottom:15px}.radio,.checkbox{display:block;min-height:20px;padding-left:20px;margin-top:10px;margin-bottom:10px;vertical-align:middle}.radio label,.checkbox label{display:inline;margin-bottom:0;font-weight:normal;cursor:pointer}.radio input[type="radio"],.radio-inline input[type="radio"],.checkbox input[type="checkbox"],.checkbox-inline input[type="checkbox"]{float:left;margin-left:-20px}.radio+.radio,.checkbox+.checkbox{margin-top:-5px}.radio-inline,.checkbox-inline{display:inline-block;padding-left:20px;margin-bottom:0;font-weight:normal;vertical-align:middle;cursor:pointer}.radio-inline+.radio-inline,.checkbox-inline+.checkbox-inline{margin-top:0;margin-left:10px}input[type="radio"][disabled],input[type="checkbox"][disabled],.radio[disabled],.radio-inline[disabled],.checkbox[disabled],.checkbox-inline[disabled],fieldset[disabled] input[type="radio"],fieldset[disabled] input[type="checkbox"],fieldset[disabled] .radio,fieldset[disabled] .radio-inline,fieldset[disabled] .checkbox,fieldset[disabled] .checkbox-inline{cursor:not-allowed}.input-sm{height:30px;padding:5px 10px;font-size:12px;line-height:1.5;border-radius:3px}select.input-sm{height:30px;line-height:30px}textarea.input-sm{height:auto}.input-lg{height:45px;padding:10px 16px;font-size:18px;line-height:1.33;border-radius:6px}select.input-lg{height:45px;line-height:45px}textarea.input-lg{height:auto}.has-warning .help-block,.has-warning .control-label,.has-warning .radio,.has-warning .checkbox,.has-warning .radio-inline,.has-warning .checkbox-inline{color:#c09853}.has-warning .form-control{border-color:#c09853;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.has-warning .form-control:focus{border-color:#a47e3c;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #dbc59e;box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #dbc59e}.has-warning .input-group-addon{color:#c09853;background-color:#fcf8e3;border-color:#c09853}.has-error .help-block,.has-error .control-label,.has-error .radio,.has-error .checkbox,.has-error .radio-inline,.has-error .checkbox-inline{color:#b94a48}.has-error .form-control{border-color:#b94a48;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.has-error .form-control:focus{border-color:#953b39;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #d59392;box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #d59392}.has-error .input-group-addon{color:#b94a48;background-color:#f2dede;border-color:#b94a48}.has-success .help-block,.has-success .control-label,.has-success .radio,.has-success .checkbox,.has-success .radio-inline,.has-success .checkbox-inline{color:#468847}.has-success .form-control{border-color:#468847;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.has-success .form-control:focus{border-color:#356635;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7aba7b;box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7aba7b}.has-success .input-group-addon{color:#468847;background-color:#dff0d8;border-color:#468847}.form-control-static{margin-bottom:0}.help-block{display:block;margin-top:5px;margin-bottom:10px;color:#737373}@media(min-width:768px){.form-inline .form-group{display:inline-block;margin-bottom:0;vertical-align:middle}.form-inline .form-control{display:inline-block}.form-inline .radio,.form-inline .checkbox{display:inline-block;padding-left:0;margin-top:0;margin-bottom:0}.form-inline .radio input[type="radio"],.form-inline .checkbox input[type="checkbox"]{float:none;margin-left:0}}.form-horizontal .control-label,.form-horizontal .radio,.form-horizontal .checkbox,.form-horizontal .radio-inline,.form-horizontal .checkbox-inline{padding-top:7px;margin-top:0;margin-bottom:0}.form-horizontal .form-group{margin-right:-15px;margin-left:-15px}.form-horizontal .form-group:before,.form-horizontal .form-group:after{display:table;content:" "}.form-horizontal .form-group:after{clear:both}.form-horizontal .form-group:before,.form-horizontal .form-group:after{display:table;content:" "}.form-horizontal .form-group:after{clear:both}.form-horizontal .form-control-static{padding-top:7px}@media(min-width:768px){.form-horizontal .control-label{text-align:right}}.btn{display:inline-block;padding:6px 12px;margin-bottom:0;font-size:14px;font-weight:normal;line-height:1.428571429;text-align:center;white-space:nowrap;vertical-align:middle;cursor:pointer;background-image:none;border:1px solid transparent;border-radius:4px;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;-o-user-select:none;user-select:none}.btn:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}.btn:hover,.btn:focus{color:#333;text-decoration:none}.btn:active,.btn.active{background-image:none;outline:0;-webkit-box-shadow:inset 0 3px 5px rgba(0,0,0,0.125);box-shadow:inset 0 3px 5px rgba(0,0,0,0.125)}.btn.disabled,.btn[disabled],fieldset[disabled] .btn{pointer-events:none;cursor:not-allowed;opacity:.65;filter:alpha(opacity=65);-webkit-box-shadow:none;box-shadow:none}.btn-default{color:#333;background-color:#fff;border-color:#ccc}.btn-default:hover,.btn-default:focus,.btn-default:active,.btn-default.active,.open .dropdown-toggle.btn-default{color:#333;background-color:#ebebeb;border-color:#adadad}.btn-default:active,.btn-default.active,.open .dropdown-toggle.btn-default{background-image:none}.btn-default.disabled,.btn-default[disabled],fieldset[disabled] .btn-default,.btn-default.disabled:hover,.btn-default[disabled]:hover,fieldset[disabled] .btn-default:hover,.btn-default.disabled:focus,.btn-default[disabled]:focus,fieldset[disabled] .btn-default:focus,.btn-default.disabled:active,.btn-default[disabled]:active,fieldset[disabled] .btn-default:active,.btn-default.disabled.active,.btn-default[disabled].active,fieldset[disabled] .btn-default.active{background-color:#fff;border-color:#ccc}.btn-primary{color:#fff;background-color:#428bca;border-color:#357ebd}.btn-primary:hover,.btn-primary:focus,.btn-primary:active,.btn-primary.active,.open .dropdown-toggle.btn-primary{color:#fff;background-color:#3276b1;border-color:#285e8e}.btn-primary:active,.btn-primary.active,.open .dropdown-toggle.btn-primary{background-image:none}.btn-primary.disabled,.btn-primary[disabled],fieldset[disabled] .btn-primary,.btn-primary.disabled:hover,.btn-primary[disabled]:hover,fieldset[disabled] .btn-primary:hover,.btn-primary.disabled:focus,.btn-primary[disabled]:focus,fieldset[disabled] .btn-primary:focus,.btn-primary.disabled:active,.btn-primary[disabled]:active,fieldset[disabled] .btn-primary:active,.btn-primary.disabled.active,.btn-primary[disabled].active,fieldset[disabled] .btn-primary.active{background-color:#428bca;border-color:#357ebd}.btn-warning{color:#fff;background-color:#f0ad4e;border-color:#eea236}.btn-warning:hover,.btn-warning:focus,.btn-warning:active,.btn-warning.active,.open .dropdown-toggle.btn-warning{color:#fff;background-color:#ed9c28;border-color:#d58512}.btn-warning:active,.btn-warning.active,.open .dropdown-toggle.btn-warning{background-image:none}.btn-warning.disabled,.btn-warning[disabled],fieldset[disabled] .btn-warning,.btn-warning.disabled:hover,.btn-warning[disabled]:hover,fieldset[disabled] .btn-warning:hover,.btn-warning.disabled:focus,.btn-warning[disabled]:focus,fieldset[disabled] .btn-warning:focus,.btn-warning.disabled:active,.btn-warning[disabled]:active,fieldset[disabled] .btn-warning:active,.btn-warning.disabled.active,.btn-warning[disabled].active,fieldset[disabled] .btn-warning.active{background-color:#f0ad4e;border-color:#eea236}.btn-danger{color:#fff;background-color:#d9534f;border-color:#d43f3a}.btn-danger:hover,.btn-danger:focus,.btn-danger:active,.btn-danger.active,.open .dropdown-toggle.btn-danger{color:#fff;background-color:#d2322d;border-color:#ac2925}.btn-danger:active,.btn-danger.active,.open .dropdown-toggle.btn-danger{background-image:none}.btn-danger.disabled,.btn-danger[disabled],fieldset[disabled] .btn-danger,.btn-danger.disabled:hover,.btn-danger[disabled]:hover,fieldset[disabled] .btn-danger:hover,.btn-danger.disabled:focus,.btn-danger[disabled]:focus,fieldset[disabled] .btn-danger:focus,.btn-danger.disabled:active,.btn-danger[disabled]:active,fieldset[disabled] .btn-danger:active,.btn-danger.disabled.active,.btn-danger[disabled].active,fieldset[disabled] .btn-danger.active{background-color:#d9534f;border-color:#d43f3a}.btn-success{color:#fff;background-color:#5cb85c;border-color:#4cae4c}.btn-success:hover,.btn-success:focus,.btn-success:active,.btn-success.active,.open .dropdown-toggle.btn-success{color:#fff;background-color:#47a447;border-color:#398439}.btn-success:active,.btn-success.active,.open .dropdown-toggle.btn-success{background-image:none}.btn-success.disabled,.btn-success[disabled],fieldset[disabled] .btn-success,.btn-success.disabled:hover,.btn-success[disabled]:hover,fieldset[disabled] .btn-success:hover,.btn-success.disabled:focus,.btn-success[disabled]:focus,fieldset[disabled] .btn-success:focus,.btn-success.disabled:active,.btn-success[disabled]:active,fieldset[disabled] .btn-success:active,.btn-success.disabled.active,.btn-success[disabled].active,fieldset[disabled] .btn-success.active{background-color:#5cb85c;border-color:#4cae4c}.btn-info{color:#fff;background-color:#5bc0de;border-color:#46b8da}.btn-info:hover,.btn-info:focus,.btn-info:active,.btn-info.active,.open .dropdown-toggle.btn-info{color:#fff;background-color:#39b3d7;border-color:#269abc}.btn-info:active,.btn-info.active,.open .dropdown-toggle.btn-info{background-image:none}.btn-info.disabled,.btn-info[disabled],fieldset[disabled] .btn-info,.btn-info.disabled:hover,.btn-info[disabled]:hover,fieldset[disabled] .btn-info:hover,.btn-info.disabled:focus,.btn-info[disabled]:focus,fieldset[disabled] .btn-info:focus,.btn-info.disabled:active,.btn-info[disabled]:active,fieldset[disabled] .btn-info:active,.btn-info.disabled.active,.btn-info[disabled].active,fieldset[disabled] .btn-info.active{background-color:#5bc0de;border-color:#46b8da}.btn-link{font-weight:normal;color:#428bca;cursor:pointer;border-radius:0}.btn-link,.btn-link:active,.btn-link[disabled],fieldset[disabled] .btn-link{background-color:transparent;-webkit-box-shadow:none;box-shadow:none}.btn-link,.btn-link:hover,.btn-link:focus,.btn-link:active{border-color:transparent}.btn-link:hover,.btn-link:focus{color:#2a6496;text-decoration:underline;background-color:transparent}.btn-link[disabled]:hover,fieldset[disabled] .btn-link:hover,.btn-link[disabled]:focus,fieldset[disabled] .btn-link:focus{color:#999;text-decoration:none}.btn-lg{padding:10px 16px;font-size:18px;line-height:1.33;border-radius:6px}.btn-sm,.btn-xs{padding:5px 10px;font-size:12px;line-height:1.5;border-radius:3px}.btn-xs{padding:1px 5px}.btn-block{display:block;width:100%;padding-right:0;padding-left:0}.btn-block+.btn-block{margin-top:5px}input[type="submit"].btn-block,input[type="reset"].btn-block,input[type="button"].btn-block{width:100%}.fade{opacity:0;-webkit-transition:opacity .15s linear;transition:opacity .15s linear}.fade.in{opacity:1}.collapse{display:none}.collapse.in{display:block}.collapsing{position:relative;height:0;overflow:hidden;-webkit-transition:height .35s ease;transition:height .35s ease}@font-face{font-family:'Glyphicons Halflings';src:url('../fonts/glyphicons-halflings-regular.eot');src:url('../fonts/glyphicons-halflings-regular.eot?#iefix') format('embedded-opentype'),url('../fonts/glyphicons-halflings-regular.woff') format('woff'),url('../fonts/glyphicons-halflings-regular.ttf') format('truetype'),url('../fonts/glyphicons-halflings-regular.svg#glyphicons_halflingsregular') format('svg')}.glyphicon{position:relative;top:1px;display:inline-block;font-family:'Glyphicons Halflings';-webkit-font-smoothing:antialiased;font-style:normal;font-weight:normal;line-height:1;-moz-osx-font-smoothing:grayscale}.glyphicon:empty{width:1em}.glyphicon-asterisk:before{content:"\2a"}.glyphicon-plus:before{content:"\2b"}.glyphicon-euro:before{content:"\20ac"}.glyphicon-minus:before{content:"\2212"}.glyphicon-cloud:before{content:"\2601"}.glyphicon-envelope:before{content:"\2709"}.glyphicon-pencil:before{content:"\270f"}.glyphicon-glass:before{content:"\e001"}.glyphicon-music:before{content:"\e002"}.glyphicon-search:before{content:"\e003"}.glyphicon-heart:before{content:"\e005"}.glyphicon-star:before{content:"\e006"}.glyphicon-star-empty:before{content:"\e007"}.glyphicon-user:before{content:"\e008"}.glyphicon-film:before{content:"\e009"}.glyphicon-th-large:before{content:"\e010"}.glyphicon-th:before{content:"\e011"}.glyphicon-th-list:before{content:"\e012"}.glyphicon-ok:before{content:"\e013"}.glyphicon-remove:before{content:"\e014"}.glyphicon-zoom-in:before{content:"\e015"}.glyphicon-zoom-out:before{content:"\e016"}.glyphicon-off:before{content:"\e017"}.glyphicon-signal:before{content:"\e018"}.glyphicon-cog:before{content:"\e019"}.glyphicon-trash:before{content:"\e020"}.glyphicon-home:before{content:"\e021"}.glyphicon-file:before{content:"\e022"}.glyphicon-time:before{content:"\e023"}.glyphicon-road:before{content:"\e024"}.glyphicon-download-alt:before{content:"\e025"}.glyphicon-download:before{content:"\e026"}.glyphicon-upload:before{content:"\e027"}.glyphicon-inbox:before{content:"\e028"}.glyphicon-play-circle:before{content:"\e029"}.glyphicon-repeat:before{content:"\e030"}.glyphicon-refresh:before{content:"\e031"}.glyphicon-list-alt:before{content:"\e032"}.glyphicon-lock:before{content:"\e033"}.glyphicon-flag:before{content:"\e034"}.glyphicon-headphones:before{content:"\e035"}.glyphicon-volume-off:before{content:"\e036"}.glyphicon-volume-down:before{content:"\e037"}.glyphicon-volume-up:before{content:"\e038"}.glyphicon-qrcode:before{content:"\e039"}.glyphicon-barcode:before{content:"\e040"}.glyphicon-tag:before{content:"\e041"}.glyphicon-tags:before{content:"\e042"}.glyphicon-book:before{content:"\e043"}.glyphicon-bookmark:before{content:"\e044"}.glyphicon-print:before{content:"\e045"}.glyphicon-camera:before{content:"\e046"}.glyphicon-font:before{content:"\e047"}.glyphicon-bold:before{content:"\e048"}.glyphicon-italic:before{content:"\e049"}.glyphicon-text-height:before{content:"\e050"}.glyphicon-text-width:before{content:"\e051"}.glyphicon-align-left:before{content:"\e052"}.glyphicon-align-center:before{content:"\e053"}.glyphicon-align-right:before{content:"\e054"}.glyphicon-align-justify:before{content:"\e055"}.glyphicon-list:before{content:"\e056"}.glyphicon-indent-left:before{content:"\e057"}.glyphicon-indent-right:before{content:"\e058"}.glyphicon-facetime-video:before{content:"\e059"}.glyphicon-picture:before{content:"\e060"}.glyphicon-map-marker:before{content:"\e062"}.glyphicon-adjust:before{content:"\e063"}.glyphicon-tint:before{content:"\e064"}.glyphicon-edit:before{content:"\e065"}.glyphicon-share:before{content:"\e066"}.glyphicon-check:before{content:"\e067"}.glyphicon-move:before{content:"\e068"}.glyphicon-step-backward:before{content:"\e069"}.glyphicon-fast-backward:before{content:"\e070"}.glyphicon-backward:before{content:"\e071"}.glyphicon-play:before{content:"\e072"}.glyphicon-pause:before{content:"\e073"}.glyphicon-stop:before{content:"\e074"}.glyphicon-forward:before{content:"\e075"}.glyphicon-fast-forward:before{content:"\e076"}.glyphicon-step-forward:before{content:"\e077"}.glyphicon-eject:before{content:"\e078"}.glyphicon-chevron-left:before{content:"\e079"}.glyphicon-chevron-right:before{content:"\e080"}.glyphicon-plus-sign:before{content:"\e081"}.glyphicon-minus-sign:before{content:"\e082"}.glyphicon-remove-sign:before{content:"\e083"}.glyphicon-ok-sign:before{content:"\e084"}.glyphicon-question-sign:before{content:"\e085"}.glyphicon-info-sign:before{content:"\e086"}.glyphicon-screenshot:before{content:"\e087"}.glyphicon-remove-circle:before{content:"\e088"}.glyphicon-ok-circle:before{content:"\e089"}.glyphicon-ban-circle:before{content:"\e090"}.glyphicon-arrow-left:before{content:"\e091"}.glyphicon-arrow-right:before{content:"\e092"}.glyphicon-arrow-up:before{content:"\e093"}.glyphicon-arrow-down:before{content:"\e094"}.glyphicon-share-alt:before{content:"\e095"}.glyphicon-resize-full:before{content:"\e096"}.glyphicon-resize-small:before{content:"\e097"}.glyphicon-exclamation-sign:before{content:"\e101"}.glyphicon-gift:before{content:"\e102"}.glyphicon-leaf:before{content:"\e103"}.glyphicon-fire:before{content:"\e104"}.glyphicon-eye-open:before{content:"\e105"}.glyphicon-eye-close:before{content:"\e106"}.glyphicon-warning-sign:before{content:"\e107"}.glyphicon-plane:before{content:"\e108"}.glyphicon-calendar:before{content:"\e109"}.glyphicon-random:before{content:"\e110"}.glyphicon-comment:before{content:"\e111"}.glyphicon-magnet:before{content:"\e112"}.glyphicon-chevron-up:before{content:"\e113"}.glyphicon-chevron-down:before{content:"\e114"}.glyphicon-retweet:before{content:"\e115"}.glyphicon-shopping-cart:before{content:"\e116"}.glyphicon-folder-close:before{content:"\e117"}.glyphicon-folder-open:before{content:"\e118"}.glyphicon-resize-vertical:before{content:"\e119"}.glyphicon-resize-horizontal:before{content:"\e120"}.glyphicon-hdd:before{content:"\e121"}.glyphicon-bullhorn:before{content:"\e122"}.glyphicon-bell:before{content:"\e123"}.glyphicon-certificate:before{content:"\e124"}.glyphicon-thumbs-up:before{content:"\e125"}.glyphicon-thumbs-down:before{content:"\e126"}.glyphicon-hand-right:before{content:"\e127"}.glyphicon-hand-left:before{content:"\e128"}.glyphicon-hand-up:before{content:"\e129"}.glyphicon-hand-down:before{content:"\e130"}.glyphicon-circle-arrow-right:before{content:"\e131"}.glyphicon-circle-arrow-left:before{content:"\e132"}.glyphicon-circle-arrow-up:before{content:"\e133"}.glyphicon-circle-arrow-down:before{content:"\e134"}.glyphicon-globe:before{content:"\e135"}.glyphicon-wrench:before{content:"\e136"}.glyphicon-tasks:before{content:"\e137"}.glyphicon-filter:before{content:"\e138"}.glyphicon-briefcase:before{content:"\e139"}.glyphicon-fullscreen:before{content:"\e140"}.glyphicon-dashboard:before{content:"\e141"}.glyphicon-paperclip:before{content:"\e142"}.glyphicon-heart-empty:before{content:"\e143"}.glyphicon-link:before{content:"\e144"}.glyphicon-phone:before{content:"\e145"}.glyphicon-pushpin:before{content:"\e146"}.glyphicon-usd:before{content:"\e148"}.glyphicon-gbp:before{content:"\e149"}.glyphicon-sort:before{content:"\e150"}.glyphicon-sort-by-alphabet:before{content:"\e151"}.glyphicon-sort-by-alphabet-alt:before{content:"\e152"}.glyphicon-sort-by-order:before{content:"\e153"}.glyphicon-sort-by-order-alt:before{content:"\e154"}.glyphicon-sort-by-attributes:before{content:"\e155"}.glyphicon-sort-by-attributes-alt:before{content:"\e156"}.glyphicon-unchecked:before{content:"\e157"}.glyphicon-expand:before{content:"\e158"}.glyphicon-collapse-down:before{content:"\e159"}.glyphicon-collapse-up:before{content:"\e160"}.glyphicon-log-in:before{content:"\e161"}.glyphicon-flash:before{content:"\e162"}.glyphicon-log-out:before{content:"\e163"}.glyphicon-new-window:before{content:"\e164"}.glyphicon-record:before{content:"\e165"}.glyphicon-save:before{content:"\e166"}.glyphicon-open:before{content:"\e167"}.glyphicon-saved:before{content:"\e168"}.glyphicon-import:before{content:"\e169"}.glyphicon-export:before{content:"\e170"}.glyphicon-send:before{content:"\e171"}.glyphicon-floppy-disk:before{content:"\e172"}.glyphicon-floppy-saved:before{content:"\e173"}.glyphicon-floppy-remove:before{content:"\e174"}.glyphicon-floppy-save:before{content:"\e175"}.glyphicon-floppy-open:before{content:"\e176"}.glyphicon-credit-card:before{content:"\e177"}.glyphicon-transfer:before{content:"\e178"}.glyphicon-cutlery:before{content:"\e179"}.glyphicon-header:before{content:"\e180"}.glyphicon-compressed:before{content:"\e181"}.glyphicon-earphone:before{content:"\e182"}.glyphicon-phone-alt:before{content:"\e183"}.glyphicon-tower:before{content:"\e184"}.glyphicon-stats:before{content:"\e185"}.glyphicon-sd-video:before{content:"\e186"}.glyphicon-hd-video:before{content:"\e187"}.glyphicon-subtitles:before{content:"\e188"}.glyphicon-sound-stereo:before{content:"\e189"}.glyphicon-sound-dolby:before{content:"\e190"}.glyphicon-sound-5-1:before{content:"\e191"}.glyphicon-sound-6-1:before{content:"\e192"}.glyphicon-sound-7-1:before{content:"\e193"}.glyphicon-copyright-mark:before{content:"\e194"}.glyphicon-registration-mark:before{content:"\e195"}.glyphicon-cloud-download:before{content:"\e197"}.glyphicon-cloud-upload:before{content:"\e198"}.glyphicon-tree-conifer:before{content:"\e199"}.glyphicon-tree-deciduous:before{content:"\e200"}.caret{display:inline-block;width:0;height:0;margin-left:2px;vertical-align:middle;border-top:4px solid #000;border-right:4px solid transparent;border-bottom:0 dotted;border-left:4px solid transparent}.dropdown{position:relative}.dropdown-toggle:focus{outline:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:160px;padding:5px 0;margin:2px 0 0;font-size:14px;list-style:none;background-color:#fff;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.15);border-radius:4px;-webkit-box-shadow:0 6px 12px rgba(0,0,0,0.175);box-shadow:0 6px 12px rgba(0,0,0,0.175);background-clip:padding-box}.dropdown-menu.pull-right{right:0;left:auto}.dropdown-menu .divider{height:1px;margin:9px 0;overflow:hidden;background-color:#e5e5e5}.dropdown-menu>li>a{display:block;padding:3px 20px;clear:both;font-weight:normal;line-height:1.428571429;color:#333;white-space:nowrap}.dropdown-menu>li>a:hover,.dropdown-menu>li>a:focus{color:#262626;text-decoration:none;background-color:#f5f5f5}.dropdown-menu>.active>a,.dropdown-menu>.active>a:hover,.dropdown-menu>.active>a:focus{color:#fff;text-decoration:none;background-color:#428bca;outline:0}.dropdown-menu>.disabled>a,.dropdown-menu>.disabled>a:hover,.dropdown-menu>.disabled>a:focus{color:#999}.dropdown-menu>.disabled>a:hover,.dropdown-menu>.disabled>a:focus{text-decoration:none;cursor:not-allowed;background-color:transparent;background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.open>.dropdown-menu{display:block}.open>a{outline:0}.dropdown-header{display:block;padding:3px 20px;font-size:12px;line-height:1.428571429;color:#999}.dropdown-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:990}.pull-right>.dropdown-menu{right:0;left:auto}.dropup .caret,.navbar-fixed-bottom .dropdown .caret{border-top:0 dotted;border-bottom:4px solid #000;content:""}.dropup .dropdown-menu,.navbar-fixed-bottom .dropdown .dropdown-menu{top:auto;bottom:100%;margin-bottom:1px}@media(min-width:768px){.navbar-right .dropdown-menu{right:0;left:auto}}.btn-default .caret{border-top-color:#333}.btn-primary .caret,.btn-success .caret,.btn-warning .caret,.btn-danger .caret,.btn-info .caret{border-top-color:#fff}.dropup .btn-default .caret{border-bottom-color:#333}.dropup .btn-primary .caret,.dropup .btn-success .caret,.dropup .btn-warning .caret,.dropup .btn-danger .caret,.dropup .btn-info .caret{border-bottom-color:#fff}.btn-group,.btn-group-vertical{position:relative;display:inline-block;vertical-align:middle}.btn-group>.btn,.btn-group-vertical>.btn{position:relative;float:left}.btn-group>.btn:hover,.btn-group-vertical>.btn:hover,.btn-group>.btn:focus,.btn-group-vertical>.btn:focus,.btn-group>.btn:active,.btn-group-vertical>.btn:active,.btn-group>.btn.active,.btn-group-vertical>.btn.active{z-index:2}.btn-group>.btn:focus,.btn-group-vertical>.btn:focus{outline:0}.btn-group .btn+.btn,.btn-group .btn+.btn-group,.btn-group .btn-group+.btn,.btn-group .btn-group+.btn-group{margin-left:-1px}.btn-toolbar:before,.btn-toolbar:after{display:table;content:" "}.btn-toolbar:after{clear:both}.btn-toolbar:before,.btn-toolbar:after{display:table;content:" "}.btn-toolbar:after{clear:both}.btn-toolbar .btn-group{float:left}.btn-toolbar>.btn+.btn,.btn-toolbar>.btn-group+.btn,.btn-toolbar>.btn+.btn-group,.btn-toolbar>.btn-group+.btn-group{margin-left:5px}.btn-group>.btn:not(:first-child):not(:last-child):not(.dropdown-toggle){border-radius:0}.btn-group>.btn:first-child{margin-left:0}.btn-group>.btn:first-child:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn:last-child:not(:first-child),.btn-group>.dropdown-toggle:not(:first-child){border-bottom-left-radius:0;border-top-left-radius:0}.btn-group>.btn-group{float:left}.btn-group>.btn-group:not(:first-child):not(:last-child)>.btn{border-radius:0}.btn-group>.btn-group:first-child>.btn:last-child,.btn-group>.btn-group:first-child>.dropdown-toggle{border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:last-child>.btn:first-child{border-bottom-left-radius:0;border-top-left-radius:0}.btn-group .dropdown-toggle:active,.btn-group.open .dropdown-toggle{outline:0}.btn-group-xs>.btn{padding:5px 10px;padding:1px 5px;font-size:12px;line-height:1.5;border-radius:3px}.btn-group-sm>.btn{padding:5px 10px;font-size:12px;line-height:1.5;border-radius:3px}.btn-group-lg>.btn{padding:10px 16px;font-size:18px;line-height:1.33;border-radius:6px}.btn-group>.btn+.dropdown-toggle{padding-right:8px;padding-left:8px}.btn-group>.btn-lg+.dropdown-toggle{padding-right:12px;padding-left:12px}.btn-group.open .dropdown-toggle{-webkit-box-shadow:inset 0 3px 5px rgba(0,0,0,0.125);box-shadow:inset 0 3px 5px rgba(0,0,0,0.125)}.btn-group.open .dropdown-toggle.btn-link{-webkit-box-shadow:none;box-shadow:none}.btn .caret{margin-left:0}.btn-lg .caret{border-width:5px 5px 0;border-bottom-width:0}.dropup .btn-lg .caret{border-width:0 5px 5px}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{display:block;float:none;width:100%;max-width:100%}.btn-group-vertical>.btn-group:before,.btn-group-vertical>.btn-group:after{display:table;content:" "}.btn-group-vertical>.btn-group:after{clear:both}.btn-group-vertical>.btn-group:before,.btn-group-vertical>.btn-group:after{display:table;content:" "}.btn-group-vertical>.btn-group:after{clear:both}.btn-group-vertical>.btn-group>.btn{float:none}.btn-group-vertical>.btn+.btn,.btn-group-vertical>.btn+.btn-group,.btn-group-vertical>.btn-group+.btn,.btn-group-vertical>.btn-group+.btn-group{margin-top:-1px;margin-left:0}.btn-group-vertical>.btn:not(:first-child):not(:last-child){border-radius:0}.btn-group-vertical>.btn:first-child:not(:last-child){border-top-right-radius:4px;border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn:last-child:not(:first-child){border-top-right-radius:0;border-bottom-left-radius:4px;border-top-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child):not(:last-child)>.btn{border-radius:0}.btn-group-vertical>.btn-group:first-child>.btn:last-child,.btn-group-vertical>.btn-group:first-child>.dropdown-toggle{border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:last-child>.btn:first-child{border-top-right-radius:0;border-top-left-radius:0}.btn-group-justified{display:table;width:100%;border-collapse:separate;table-layout:fixed}.btn-group-justified .btn{display:table-cell;float:none;width:1%}[data-toggle="buttons"]>.btn>input[type="radio"],[data-toggle="buttons"]>.btn>input[type="checkbox"]{display:none}.input-group{position:relative;display:table;border-collapse:separate}.input-group.col{float:none;padding-right:0;padding-left:0}.input-group .form-control{width:100%;margin-bottom:0}.input-group-lg>.form-control,.input-group-lg>.input-group-addon,.input-group-lg>.input-group-btn>.btn{height:45px;padding:10px 16px;font-size:18px;line-height:1.33;border-radius:6px}select.input-group-lg>.form-control,select.input-group-lg>.input-group-addon,select.input-group-lg>.input-group-btn>.btn{height:45px;line-height:45px}textarea.input-group-lg>.form-control,textarea.input-group-lg>.input-group-addon,textarea.input-group-lg>.input-group-btn>.btn{height:auto}.input-group-sm>.form-control,.input-group-sm>.input-group-addon,.input-group-sm>.input-group-btn>.btn{height:30px;padding:5px 10px;font-size:12px;line-height:1.5;border-radius:3px}select.input-group-sm>.form-control,select.input-group-sm>.input-group-addon,select.input-group-sm>.input-group-btn>.btn{height:30px;line-height:30px}textarea.input-group-sm>.form-control,textarea.input-group-sm>.input-group-addon,textarea.input-group-sm>.input-group-btn>.btn{height:auto}.input-group-addon,.input-group-btn,.input-group .form-control{display:table-cell}.input-group-addon:not(:first-child):not(:last-child),.input-group-btn:not(:first-child):not(:last-child),.input-group .form-control:not(:first-child):not(:last-child){border-radius:0}.input-group-addon,.input-group-btn{width:1%;white-space:nowrap;vertical-align:middle}.input-group-addon{padding:6px 12px;font-size:14px;font-weight:normal;line-height:1;color:#555;text-align:center;background-color:#eee;border:1px solid #ccc;border-radius:4px}.input-group-addon.input-sm{padding:5px 10px;font-size:12px;border-radius:3px}.input-group-addon.input-lg{padding:10px 16px;font-size:18px;border-radius:6px}.input-group-addon input[type="radio"],.input-group-addon input[type="checkbox"]{margin-top:0}.input-group .form-control:first-child,.input-group-addon:first-child,.input-group-btn:first-child>.btn,.input-group-btn:first-child>.dropdown-toggle,.input-group-btn:last-child>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.input-group-addon:first-child{border-right:0}.input-group .form-control:last-child,.input-group-addon:last-child,.input-group-btn:last-child>.btn,.input-group-btn:last-child>.dropdown-toggle,.input-group-btn:first-child>.btn:not(:first-child){border-bottom-left-radius:0;border-top-left-radius:0}.input-group-addon:last-child{border-left:0}.input-group-btn{position:relative;white-space:nowrap}.input-group-btn:first-child>.btn{margin-right:-1px}.input-group-btn:last-child>.btn{margin-left:-1px}.input-group-btn>.btn{position:relative}.input-group-btn>.btn+.btn{margin-left:-4px}.input-group-btn>.btn:hover,.input-group-btn>.btn:active{z-index:2}.nav{padding-left:0;margin-bottom:0;list-style:none}.nav:before,.nav:after{display:table;content:" "}.nav:after{clear:both}.nav:before,.nav:after{display:table;content:" "}.nav:after{clear:both}.nav>li{position:relative;display:block}.nav>li>a{position:relative;display:block;padding:10px 15px}.nav>li>a:hover,.nav>li>a:focus{text-decoration:none;background-color:#eee}.nav>li.disabled>a{color:#999}.nav>li.disabled>a:hover,.nav>li.disabled>a:focus{color:#999;text-decoration:none;cursor:not-allowed;background-color:transparent}.nav .open>a,.nav .open>a:hover,.nav .open>a:focus{background-color:#eee;border-color:#428bca}.nav .open>a .caret,.nav .open>a:hover .caret,.nav .open>a:focus .caret{border-top-color:#2a6496;border-bottom-color:#2a6496}.nav .nav-divider{height:1px;margin:9px 0;overflow:hidden;background-color:#e5e5e5}.nav>li>a>img{max-width:none}.nav-tabs{border-bottom:1px solid #ddd}.nav-tabs>li{float:left;margin-bottom:-1px}.nav-tabs>li>a{margin-right:2px;line-height:1.428571429;border:1px solid transparent;border-radius:4px 4px 0 0}.nav-tabs>li>a:hover{border-color:#eee #eee #ddd}.nav-tabs>li.active>a,.nav-tabs>li.active>a:hover,.nav-tabs>li.active>a:focus{color:#555;cursor:default;background-color:#fff;border:1px solid #ddd;border-bottom-color:transparent}.nav-tabs.nav-justified{width:100%;border-bottom:0}.nav-tabs.nav-justified>li{float:none}.nav-tabs.nav-justified>li>a{margin-bottom:5px;text-align:center}.nav-tabs.nav-justified>.dropdown .dropdown-menu{top:auto;left:auto}@media(min-width:768px){.nav-tabs.nav-justified>li{display:table-cell;width:1%}.nav-tabs.nav-justified>li>a{margin-bottom:0}}.nav-tabs.nav-justified>li>a{margin-right:0;border-radius:4px}.nav-tabs.nav-justified>.active>a,.nav-tabs.nav-justified>.active>a:hover,.nav-tabs.nav-justified>.active>a:focus{border:1px solid #ddd}@media(min-width:768px){.nav-tabs.nav-justified>li>a{border-bottom:1px solid #ddd;border-radius:4px 4px 0 0}.nav-tabs.nav-justified>.active>a,.nav-tabs.nav-justified>.active>a:hover,.nav-tabs.nav-justified>.active>a:focus{border-bottom-color:#fff}}.nav-pills>li{float:left}.nav-pills>li>a{border-radius:4px}.nav-pills>li+li{margin-left:2px}.nav-pills>li.active>a,.nav-pills>li.active>a:hover,.nav-pills>li.active>a:focus{color:#fff;background-color:#428bca}.nav-pills>li.active>a .caret,.nav-pills>li.active>a:hover .caret,.nav-pills>li.active>a:focus .caret{border-top-color:#fff;border-bottom-color:#fff}.nav-stacked>li{float:none}.nav-stacked>li+li{margin-top:2px;margin-left:0}.nav-justified{width:100%}.nav-justified>li{float:none}.nav-justified>li>a{margin-bottom:5px;text-align:center}.nav-justified>.dropdown .dropdown-menu{top:auto;left:auto}@media(min-width:768px){.nav-justified>li{display:table-cell;width:1%}.nav-justified>li>a{margin-bottom:0}}.nav-tabs-justified{border-bottom:0}.nav-tabs-justified>li>a{margin-right:0;border-radius:4px}.nav-tabs-justified>.active>a,.nav-tabs-justified>.active>a:hover,.nav-tabs-justified>.active>a:focus{border:1px solid #ddd}@media(min-width:768px){.nav-tabs-justified>li>a{border-bottom:1px solid #ddd;border-radius:4px 4px 0 0}.nav-tabs-justified>.active>a,.nav-tabs-justified>.active>a:hover,.nav-tabs-justified>.active>a:focus{border-bottom-color:#fff}}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.nav .caret{border-top-color:#428bca;border-bottom-color:#428bca}.nav a:hover .caret{border-top-color:#2a6496;border-bottom-color:#2a6496}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-right-radius:0;border-top-left-radius:0}.navbar{position:relative;min-height:50px;margin-bottom:20px;border:1px solid transparent}.navbar:before,.navbar:after{display:table;content:" "}.navbar:after{clear:both}.navbar:before,.navbar:after{display:table;content:" "}.navbar:after{clear:both}@media(min-width:768px){.navbar{border-radius:4px}}.navbar-header:before,.navbar-header:after{display:table;content:" "}.navbar-header:after{clear:both}.navbar-header:before,.navbar-header:after{display:table;content:" "}.navbar-header:after{clear:both}@media(min-width:768px){.navbar-header{float:left}}.navbar-collapse{max-height:340px;padding-right:15px;padding-left:15px;overflow-x:visible;border-top:1px solid transparent;box-shadow:inset 0 1px 0 rgba(255,255,255,0.1);-webkit-overflow-scrolling:touch}.navbar-collapse:before,.navbar-collapse:after{display:table;content:" "}.navbar-collapse:after{clear:both}.navbar-collapse:before,.navbar-collapse:after{display:table;content:" "}.navbar-collapse:after{clear:both}.navbar-collapse.in{overflow-y:auto}@media(min-width:768px){.navbar-collapse{width:auto;border-top:0;box-shadow:none}.navbar-collapse.collapse{display:block !important;height:auto !important;padding-bottom:0;overflow:visible !important}.navbar-collapse.in{overflow-y:auto}.navbar-collapse .navbar-nav.navbar-left:first-child{margin-left:-15px}.navbar-collapse .navbar-nav.navbar-right:last-child{margin-right:-15px}.navbar-collapse .navbar-text:last-child{margin-right:0}}.container>.navbar-header,.container>.navbar-collapse{margin-right:-15px;margin-left:-15px}@media(min-width:768px){.container>.navbar-header,.container>.navbar-collapse{margin-right:0;margin-left:0}}.navbar-static-top{z-index:1000;border-width:0 0 1px}@media(min-width:768px){.navbar-static-top{border-radius:0}}.navbar-fixed-top,.navbar-fixed-bottom{position:fixed;right:0;left:0;z-index:1030}@media(min-width:768px){.navbar-fixed-top,.navbar-fixed-bottom{border-radius:0}}.navbar-fixed-top{top:0;border-width:0 0 1px}.navbar-fixed-bottom{bottom:0;margin-bottom:0;border-width:1px 0 0}.navbar-brand{float:left;padding:15px 15px;font-size:18px;line-height:20px}.navbar-brand:hover,.navbar-brand:focus{text-decoration:none}@media(min-width:768px){.navbar>.container .navbar-brand{margin-left:-15px}}.navbar-toggle{position:relative;float:right;padding:9px 10px;margin-top:8px;margin-right:15px;margin-bottom:8px;background-color:transparent;border:1px solid transparent;border-radius:4px}.navbar-toggle .icon-bar{display:block;width:22px;height:2px;border-radius:1px}.navbar-toggle .icon-bar+.icon-bar{margin-top:4px}@media(min-width:768px){.navbar-toggle{display:none}}.navbar-nav{margin:7.5px -15px}.navbar-nav>li>a{padding-top:10px;padding-bottom:10px;line-height:20px}@media(max-width:767px){.navbar-nav .open .dropdown-menu{position:static;float:none;width:auto;margin-top:0;background-color:transparent;border:0;box-shadow:none}.navbar-nav .open .dropdown-menu>li>a,.navbar-nav .open .dropdown-menu .dropdown-header{padding:5px 15px 5px 25px}.navbar-nav .open .dropdown-menu>li>a{line-height:20px}.navbar-nav .open .dropdown-menu>li>a:hover,.navbar-nav .open .dropdown-menu>li>a:focus{background-image:none}}@media(min-width:768px){.navbar-nav{float:left;margin:0}.navbar-nav>li{float:left}.navbar-nav>li>a{padding-top:15px;padding-bottom:15px}}@media(min-width:768px){.navbar-left{float:left !important}.navbar-right{float:right !important}}.navbar-form{padding:10px 15px;margin-top:8px;margin-right:-15px;margin-bottom:8px;margin-left:-15px;border-top:1px solid transparent;border-bottom:1px solid transparent;-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.1);box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.1)}@media(min-width:768px){.navbar-form .form-group{display:inline-block;margin-bottom:0;vertical-align:middle}.navbar-form .form-control{display:inline-block}.navbar-form .radio,.navbar-form .checkbox{display:inline-block;padding-left:0;margin-top:0;margin-bottom:0}.navbar-form .radio input[type="radio"],.navbar-form .checkbox input[type="checkbox"]{float:none;margin-left:0}}@media(max-width:767px){.navbar-form .form-group{margin-bottom:5px}}@media(min-width:768px){.navbar-form{width:auto;padding-top:0;padding-bottom:0;margin-right:0;margin-left:0;border:0;-webkit-box-shadow:none;box-shadow:none}}.navbar-nav>li>.dropdown-menu{margin-top:0;border-top-right-radius:0;border-top-left-radius:0}.navbar-fixed-bottom .navbar-nav>li>.dropdown-menu{border-bottom-right-radius:0;border-bottom-left-radius:0}.navbar-nav.pull-right>li>.dropdown-menu,.navbar-nav>li>.dropdown-menu.pull-right{right:0;left:auto}.navbar-btn{margin-top:8px;margin-bottom:8px}.navbar-text{float:left;margin-top:15px;margin-bottom:15px}@media(min-width:768px){.navbar-text{margin-right:15px;margin-left:15px}}.navbar-default{background-color:#f8f8f8;border-color:#e7e7e7}.navbar-default .navbar-brand{color:#777}.navbar-default .navbar-brand:hover,.navbar-default .navbar-brand:focus{color:#5e5e5e;background-color:transparent}.navbar-default .navbar-text{color:#777}.navbar-default .navbar-nav>li>a{color:#777}.navbar-default .navbar-nav>li>a:hover,.navbar-default .navbar-nav>li>a:focus{color:#333;background-color:transparent}.navbar-default .navbar-nav>.active>a,.navbar-default .navbar-nav>.active>a:hover,.navbar-default .navbar-nav>.active>a:focus{color:#555;background-color:#e7e7e7}.navbar-default .navbar-nav>.disabled>a,.navbar-default .navbar-nav>.disabled>a:hover,.navbar-default .navbar-nav>.disabled>a:focus{color:#ccc;background-color:transparent}.navbar-default .navbar-toggle{border-color:#ddd}.navbar-default .navbar-toggle:hover,.navbar-default .navbar-toggle:focus{background-color:#ddd}.navbar-default .navbar-toggle .icon-bar{background-color:#ccc}.navbar-default .navbar-collapse,.navbar-default .navbar-form{border-color:#e7e7e7}.navbar-default .navbar-nav>.dropdown>a:hover .caret,.navbar-default .navbar-nav>.dropdown>a:focus .caret{border-top-color:#333;border-bottom-color:#333}.navbar-default .navbar-nav>.open>a,.navbar-default .navbar-nav>.open>a:hover,.navbar-default .navbar-nav>.open>a:focus{color:#555;background-color:#e7e7e7}.navbar-default .navbar-nav>.open>a .caret,.navbar-default .navbar-nav>.open>a:hover .caret,.navbar-default .navbar-nav>.open>a:focus .caret{border-top-color:#555;border-bottom-color:#555}.navbar-default .navbar-nav>.dropdown>a .caret{border-top-color:#777;border-bottom-color:#777}@media(max-width:767px){.navbar-default .navbar-nav .open .dropdown-menu>li>a{color:#777}.navbar-default .navbar-nav .open .dropdown-menu>li>a:hover,.navbar-default .navbar-nav .open .dropdown-menu>li>a:focus{color:#333;background-color:transparent}.navbar-default .navbar-nav .open .dropdown-menu>.active>a,.navbar-default .navbar-nav .open .dropdown-menu>.active>a:hover,.navbar-default .navbar-nav .open .dropdown-menu>.active>a:focus{color:#555;background-color:#e7e7e7}.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a,.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a:hover,.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a:focus{color:#ccc;background-color:transparent}}.navbar-default .navbar-link{color:#777}.navbar-default .navbar-link:hover{color:#333}.navbar-inverse{background-color:#222;border-color:#080808}.navbar-inverse .navbar-brand{color:#999}.navbar-inverse .navbar-brand:hover,.navbar-inverse .navbar-brand:focus{color:#fff;background-color:transparent}.navbar-inverse .navbar-text{color:#999}.navbar-inverse .navbar-nav>li>a{color:#999}.navbar-inverse .navbar-nav>li>a:hover,.navbar-inverse .navbar-nav>li>a:focus{color:#fff;background-color:transparent}.navbar-inverse .navbar-nav>.active>a,.navbar-inverse .navbar-nav>.active>a:hover,.navbar-inverse .navbar-nav>.active>a:focus{color:#fff;background-color:#080808}.navbar-inverse .navbar-nav>.disabled>a,.navbar-inverse .navbar-nav>.disabled>a:hover,.navbar-inverse .navbar-nav>.disabled>a:focus{color:#444;background-color:transparent}.navbar-inverse .navbar-toggle{border-color:#333}.navbar-inverse .navbar-toggle:hover,.navbar-inverse .navbar-toggle:focus{background-color:#333}.navbar-inverse .navbar-toggle .icon-bar{background-color:#fff}.navbar-inverse .navbar-collapse,.navbar-inverse .navbar-form{border-color:#101010}.navbar-inverse .navbar-nav>.open>a,.navbar-inverse .navbar-nav>.open>a:hover,.navbar-inverse .navbar-nav>.open>a:focus{color:#fff;background-color:#080808}.navbar-inverse .navbar-nav>.dropdown>a:hover .caret{border-top-color:#fff;border-bottom-color:#fff}.navbar-inverse .navbar-nav>.dropdown>a .caret{border-top-color:#999;border-bottom-color:#999}.navbar-inverse .navbar-nav>.open>a .caret,.navbar-inverse .navbar-nav>.open>a:hover .caret,.navbar-inverse .navbar-nav>.open>a:focus .caret{border-top-color:#fff;border-bottom-color:#fff}@media(max-width:767px){.navbar-inverse .navbar-nav .open .dropdown-menu>.dropdown-header{border-color:#080808}.navbar-inverse .navbar-nav .open .dropdown-menu>li>a{color:#999}.navbar-inverse .navbar-nav .open .dropdown-menu>li>a:hover,.navbar-inverse .navbar-nav .open .dropdown-menu>li>a:focus{color:#fff;background-color:transparent}.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a,.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a:hover,.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a:focus{color:#fff;background-color:#080808}.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a,.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a:hover,.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a:focus{color:#444;background-color:transparent}}.navbar-inverse .navbar-link{color:#999}.navbar-inverse .navbar-link:hover{color:#fff}.breadcrumb{padding:8px 15px;margin-bottom:20px;list-style:none;background-color:#f5f5f5;border-radius:4px}.breadcrumb>li{display:inline-block}.breadcrumb>li+li:before{padding:0 5px;color:#ccc;content:"/\00a0"}.breadcrumb>.active{color:#999}.pagination{display:inline-block;padding-left:0;margin:20px 0;border-radius:4px}.pagination>li{display:inline}.pagination>li>a,.pagination>li>span{position:relative;float:left;padding:6px 12px;margin-left:-1px;line-height:1.428571429;text-decoration:none;background-color:#fff;border:1px solid #ddd}.pagination>li:first-child>a,.pagination>li:first-child>span{margin-left:0;border-bottom-left-radius:4px;border-top-left-radius:4px}.pagination>li:last-child>a,.pagination>li:last-child>span{border-top-right-radius:4px;border-bottom-right-radius:4px}.pagination>li>a:hover,.pagination>li>span:hover,.pagination>li>a:focus,.pagination>li>span:focus{background-color:#eee}.pagination>.active>a,.pagination>.active>span,.pagination>.active>a:hover,.pagination>.active>span:hover,.pagination>.active>a:focus,.pagination>.active>span:focus{z-index:2;color:#fff;cursor:default;background-color:#428bca;border-color:#428bca}.pagination>.disabled>span,.pagination>.disabled>span:hover,.pagination>.disabled>span:focus,.pagination>.disabled>a,.pagination>.disabled>a:hover,.pagination>.disabled>a:focus{color:#999;cursor:not-allowed;background-color:#fff;border-color:#ddd}.pagination-lg>li>a,.pagination-lg>li>span{padding:10px 16px;font-size:18px}.pagination-lg>li:first-child>a,.pagination-lg>li:first-child>span{border-bottom-left-radius:6px;border-top-left-radius:6px}.pagination-lg>li:last-child>a,.pagination-lg>li:last-child>span{border-top-right-radius:6px;border-bottom-right-radius:6px}.pagination-sm>li>a,.pagination-sm>li>span{padding:5px 10px;font-size:12px}.pagination-sm>li:first-child>a,.pagination-sm>li:first-child>span{border-bottom-left-radius:3px;border-top-left-radius:3px}.pagination-sm>li:last-child>a,.pagination-sm>li:last-child>span{border-top-right-radius:3px;border-bottom-right-radius:3px}.pager{padding-left:0;margin:20px 0;text-align:center;list-style:none}.pager:before,.pager:after{display:table;content:" "}.pager:after{clear:both}.pager:before,.pager:after{display:table;content:" "}.pager:after{clear:both}.pager li{display:inline}.pager li>a,.pager li>span{display:inline-block;padding:5px 14px;background-color:#fff;border:1px solid #ddd;border-radius:15px}.pager li>a:hover,.pager li>a:focus{text-decoration:none;background-color:#eee}.pager .next>a,.pager .next>span{float:right}.pager .previous>a,.pager .previous>span{float:left}.pager .disabled>a,.pager .disabled>a:hover,.pager .disabled>a:focus,.pager .disabled>span{color:#999;cursor:not-allowed;background-color:#fff}.label{display:inline;padding:.2em .6em .3em;font-size:75%;font-weight:bold;line-height:1;color:#fff;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25em}.label[href]:hover,.label[href]:focus{color:#fff;text-decoration:none;cursor:pointer}.label:empty{display:none}.label-default{background-color:#999}.label-default[href]:hover,.label-default[href]:focus{background-color:gray}.label-primary{background-color:#428bca}.label-primary[href]:hover,.label-primary[href]:focus{background-color:#3071a9}.label-success{background-color:#5cb85c}.label-success[href]:hover,.label-success[href]:focus{background-color:#449d44}.label-info{background-color:#5bc0de}.label-info[href]:hover,.label-info[href]:focus{background-color:#31b0d5}.label-warning{background-color:#f0ad4e}.label-warning[href]:hover,.label-warning[href]:focus{background-color:#ec971f}.label-danger{background-color:#d9534f}.label-danger[href]:hover,.label-danger[href]:focus{background-color:#c9302c}.badge{display:inline-block;min-width:10px;padding:3px 7px;font-size:12px;font-weight:bold;line-height:1;color:#fff;text-align:center;white-space:nowrap;vertical-align:baseline;background-color:#999;border-radius:10px}.badge:empty{display:none}a.badge:hover,a.badge:focus{color:#fff;text-decoration:none;cursor:pointer}.btn .badge{position:relative;top:-1px}a.list-group-item.active>.badge,.nav-pills>.active>a>.badge{color:#428bca;background-color:#fff}.nav-pills>li>a>.badge{margin-left:3px}.jumbotron{padding:30px;margin-bottom:30px;font-size:21px;font-weight:200;line-height:2.1428571435;color:inherit;background-color:#eee}.jumbotron h1{line-height:1;color:inherit}.jumbotron p{line-height:1.4}.container .jumbotron{border-radius:6px}@media screen and (min-width:768px){.jumbotron{padding-top:48px;padding-bottom:48px}.container .jumbotron{padding-right:60px;padding-left:60px}.jumbotron h1{font-size:63px}}.thumbnail{display:inline-block;display:block;height:auto;max-width:100%;padding:4px;margin-bottom:20px;line-height:1.428571429;background-color:#fff;border:1px solid #ddd;border-radius:4px;-webkit-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.thumbnail>img{display:block;height:auto;max-width:100%;margin-right:auto;margin-left:auto}a.thumbnail:hover,a.thumbnail:focus,a.thumbnail.active{border-color:#428bca}.thumbnail .caption{padding:9px;color:#333}.alert{padding:15px;margin-bottom:20px;border:1px solid transparent;border-radius:4px}.alert h4{margin-top:0;color:inherit}.alert .alert-link{font-weight:bold}.alert>p,.alert>ul{margin-bottom:0}.alert>p+p{margin-top:5px}.alert-dismissable{padding-right:35px}.alert-dismissable .close{position:relative;top:-2px;right:-21px;color:inherit}.alert-success{color:#468847;background-color:#dff0d8;border-color:#d6e9c6}.alert-success hr{border-top-color:#c9e2b3}.alert-success .alert-link{color:#356635}.alert-info{color:#3a87ad;background-color:#d9edf7;border-color:#bce8f1}.alert-info hr{border-top-color:#a6e1ec}.alert-info .alert-link{color:#2d6987}.alert-warning{color:#c09853;background-color:#fcf8e3;border-color:#faebcc}.alert-warning hr{border-top-color:#f7e1b5}.alert-warning .alert-link{color:#a47e3c}.alert-danger{color:#b94a48;background-color:#f2dede;border-color:#ebccd1}.alert-danger hr{border-top-color:#e4b9c0}.alert-danger .alert-link{color:#953b39}@-webkit-keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}@-moz-keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}@-o-keyframes progress-bar-stripes{from{background-position:0 0}to{background-position:40px 0}}@keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}.progress{height:20px;margin-bottom:20px;overflow:hidden;background-color:#f5f5f5;border-radius:4px;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);box-shadow:inset 0 1px 2px rgba(0,0,0,0.1)}.progress-bar{float:left;width:0;height:100%;font-size:12px;line-height:20px;color:#fff;text-align:center;background-color:#428bca;-webkit-box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);-webkit-transition:width .6s ease;transition:width .6s ease}.progress-striped .progress-bar{background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-size:40px 40px}.progress.active .progress-bar{-webkit-animation:progress-bar-stripes 2s linear infinite;animation:progress-bar-stripes 2s linear infinite}.progress-bar-success{background-color:#5cb85c}.progress-striped .progress-bar-success{background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.progress-bar-info{background-color:#5bc0de}.progress-striped .progress-bar-info{background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.progress-bar-warning{background-color:#f0ad4e}.progress-striped .progress-bar-warning{background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.progress-bar-danger{background-color:#d9534f}.progress-striped .progress-bar-danger{background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.media,.media-body{overflow:hidden;zoom:1}.media,.media .media{margin-top:15px}.media:first-child{margin-top:0}.media-object{display:block}.media-heading{margin:0 0 5px}.media>.pull-left{margin-right:10px}.media>.pull-right{margin-left:10px}.media-list{padding-left:0;list-style:none}.list-group{padding-left:0;margin-bottom:20px}.list-group-item{position:relative;display:block;padding:10px 15px;margin-bottom:-1px;background-color:#fff;border:1px solid #ddd}.list-group-item:first-child{border-top-right-radius:4px;border-top-left-radius:4px}.list-group-item:last-child{margin-bottom:0;border-bottom-right-radius:4px;border-bottom-left-radius:4px}.list-group-item>.badge{float:right}.list-group-item>.badge+.badge{margin-right:5px}a.list-group-item{color:#555}a.list-group-item .list-group-item-heading{color:#333}a.list-group-item:hover,a.list-group-item:focus{text-decoration:none;background-color:#f5f5f5}a.list-group-item.active,a.list-group-item.active:hover,a.list-group-item.active:focus{z-index:2;color:#fff;background-color:#428bca;border-color:#428bca}a.list-group-item.active .list-group-item-heading,a.list-group-item.active:hover .list-group-item-heading,a.list-group-item.active:focus .list-group-item-heading{color:inherit}a.list-group-item.active .list-group-item-text,a.list-group-item.active:hover .list-group-item-text,a.list-group-item.active:focus .list-group-item-text{color:#e1edf7}.list-group-item-heading{margin-top:0;margin-bottom:5px}.list-group-item-text{margin-bottom:0;line-height:1.3}.panel{margin-bottom:20px;background-color:#fff;border:1px solid transparent;border-radius:4px;-webkit-box-shadow:0 1px 1px rgba(0,0,0,0.05);box-shadow:0 1px 1px rgba(0,0,0,0.05)}.panel-body{padding:15px}.panel-body:before,.panel-body:after{display:table;content:" "}.panel-body:after{clear:both}.panel-body:before,.panel-body:after{display:table;content:" "}.panel-body:after{clear:both}.panel>.list-group{margin-bottom:0}.panel>.list-group .list-group-item{border-width:1px 0}.panel>.list-group .list-group-item:first-child{border-top-right-radius:0;border-top-left-radius:0}.panel>.list-group .list-group-item:last-child{border-bottom:0}.panel-heading+.list-group .list-group-item:first-child{border-top-width:0}.panel>.table,.panel>.table-responsive{margin-bottom:0}.panel>.panel-body+.table,.panel>.panel-body+.table-responsive{border-top:1px solid #ddd}.panel>.table-bordered,.panel>.table-responsive>.table-bordered{border:0}.panel>.table-bordered>thead>tr>th:first-child,.panel>.table-responsive>.table-bordered>thead>tr>th:first-child,.panel>.table-bordered>tbody>tr>th:first-child,.panel>.table-responsive>.table-bordered>tbody>tr>th:first-child,.panel>.table-bordered>tfoot>tr>th:first-child,.panel>.table-responsive>.table-bordered>tfoot>tr>th:first-child,.panel>.table-bordered>thead>tr>td:first-child,.panel>.table-responsive>.table-bordered>thead>tr>td:first-child,.panel>.table-bordered>tbody>tr>td:first-child,.panel>.table-responsive>.table-bordered>tbody>tr>td:first-child,.panel>.table-bordered>tfoot>tr>td:first-child,.panel>.table-responsive>.table-bordered>tfoot>tr>td:first-child{border-left:0}.panel>.table-bordered>thead>tr>th:last-child,.panel>.table-responsive>.table-bordered>thead>tr>th:last-child,.panel>.table-bordered>tbody>tr>th:last-child,.panel>.table-responsive>.table-bordered>tbody>tr>th:last-child,.panel>.table-bordered>tfoot>tr>th:last-child,.panel>.table-responsive>.table-bordered>tfoot>tr>th:last-child,.panel>.table-bordered>thead>tr>td:last-child,.panel>.table-responsive>.table-bordered>thead>tr>td:last-child,.panel>.table-bordered>tbody>tr>td:last-child,.panel>.table-responsive>.table-bordered>tbody>tr>td:last-child,.panel>.table-bordered>tfoot>tr>td:last-child,.panel>.table-responsive>.table-bordered>tfoot>tr>td:last-child{border-right:0}.panel>.table-bordered>thead>tr:last-child>th,.panel>.table-responsive>.table-bordered>thead>tr:last-child>th,.panel>.table-bordered>tbody>tr:last-child>th,.panel>.table-responsive>.table-bordered>tbody>tr:last-child>th,.panel>.table-bordered>tfoot>tr:last-child>th,.panel>.table-responsive>.table-bordered>tfoot>tr:last-child>th,.panel>.table-bordered>thead>tr:last-child>td,.panel>.table-responsive>.table-bordered>thead>tr:last-child>td,.panel>.table-bordered>tbody>tr:last-child>td,.panel>.table-responsive>.table-bordered>tbody>tr:last-child>td,.panel>.table-bordered>tfoot>tr:last-child>td,.panel>.table-responsive>.table-bordered>tfoot>tr:last-child>td{border-bottom:0}.panel-heading{padding:10px 15px;border-bottom:1px solid transparent;border-top-right-radius:3px;border-top-left-radius:3px}.panel-heading>.dropdown .dropdown-toggle{color:inherit}.panel-title{margin-top:0;margin-bottom:0;font-size:16px}.panel-title>a{color:inherit}.panel-footer{padding:10px 15px;background-color:#f5f5f5;border-top:1px solid #ddd;border-bottom-right-radius:3px;border-bottom-left-radius:3px}.panel-group .panel{margin-bottom:0;overflow:hidden;border-radius:4px}.panel-group .panel+.panel{margin-top:5px}.panel-group .panel-heading{border-bottom:0}.panel-group .panel-heading+.panel-collapse .panel-body{border-top:1px solid #ddd}.panel-group .panel-footer{border-top:0}.panel-group .panel-footer+.panel-collapse .panel-body{border-bottom:1px solid #ddd}.panel-default{border-color:#ddd}.panel-default>.panel-heading{color:#333;background-color:#f5f5f5;border-color:#ddd}.panel-default>.panel-heading+.panel-collapse .panel-body{border-top-color:#ddd}.panel-default>.panel-heading>.dropdown .caret{border-color:#333 transparent}.panel-default>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#ddd}.panel-primary{border-color:#428bca}.panel-primary>.panel-heading{color:#fff;background-color:#428bca;border-color:#428bca}.panel-primary>.panel-heading+.panel-collapse .panel-body{border-top-color:#428bca}.panel-primary>.panel-heading>.dropdown .caret{border-color:#fff transparent}.panel-primary>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#428bca}.panel-success{border-color:#d6e9c6}.panel-success>.panel-heading{color:#468847;background-color:#dff0d8;border-color:#d6e9c6}.panel-success>.panel-heading+.panel-collapse .panel-body{border-top-color:#d6e9c6}.panel-success>.panel-heading>.dropdown .caret{border-color:#468847 transparent}.panel-success>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#d6e9c6}.panel-warning{border-color:#faebcc}.panel-warning>.panel-heading{color:#c09853;background-color:#fcf8e3;border-color:#faebcc}.panel-warning>.panel-heading+.panel-collapse .panel-body{border-top-color:#faebcc}.panel-warning>.panel-heading>.dropdown .caret{border-color:#c09853 transparent}.panel-warning>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#faebcc}.panel-danger{border-color:#ebccd1}.panel-danger>.panel-heading{color:#b94a48;background-color:#f2dede;border-color:#ebccd1}.panel-danger>.panel-heading+.panel-collapse .panel-body{border-top-color:#ebccd1}.panel-danger>.panel-heading>.dropdown .caret{border-color:#b94a48 transparent}.panel-danger>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#ebccd1}.panel-info{border-color:#bce8f1}.panel-info>.panel-heading{color:#3a87ad;background-color:#d9edf7;border-color:#bce8f1}.panel-info>.panel-heading+.panel-collapse .panel-body{border-top-color:#bce8f1}.panel-info>.panel-heading>.dropdown .caret{border-color:#3a87ad transparent}.panel-info>.panel-footer+.panel-collapse .panel-body{border-bottom-color:#bce8f1}.well{min-height:20px;padding:19px;margin-bottom:20px;background-color:#f5f5f5;border:1px solid #e3e3e3;border-radius:4px;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.05);box-shadow:inset 0 1px 1px rgba(0,0,0,0.05)}.well blockquote{border-color:#ddd;border-color:rgba(0,0,0,0.15)}.well-lg{padding:24px;border-radius:6px}.well-sm{padding:9px;border-radius:3px}.close{float:right;font-size:21px;font-weight:bold;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.2;filter:alpha(opacity=20)}.close:hover,.close:focus{color:#000;text-decoration:none;cursor:pointer;opacity:.5;filter:alpha(opacity=50)}button.close{padding:0;cursor:pointer;background:transparent;border:0;-webkit-appearance:none}.modal-open{overflow:hidden}.modal{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;display:none;overflow:auto;overflow-y:scroll}.modal.fade .modal-dialog{-webkit-transform:translate(0,-25%);-ms-transform:translate(0,-25%);transform:translate(0,-25%);-webkit-transition:-webkit-transform .3s ease-out;-moz-transition:-moz-transform .3s ease-out;-o-transition:-o-transform .3s ease-out;transition:transform .3s ease-out}.modal.in .modal-dialog{-webkit-transform:translate(0,0);-ms-transform:translate(0,0);transform:translate(0,0)}.modal-dialog{position:relative;z-index:1050;width:auto;padding:10px;margin-right:auto;margin-left:auto}.modal-content{position:relative;background-color:#fff;border:1px solid #999;border:1px solid rgba(0,0,0,0.2);border-radius:6px;outline:0;-webkit-box-shadow:0 3px 9px rgba(0,0,0,0.5);box-shadow:0 3px 9px rgba(0,0,0,0.5);background-clip:padding-box}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1030;background-color:#000}.modal-backdrop.fade{opacity:0;filter:alpha(opacity=0)}.modal-backdrop.in{opacity:.5;filter:alpha(opacity=50)}.modal-header{min-height:16.428571429px;padding:15px;border-bottom:1px solid #e5e5e5}.modal-header .close{margin-top:-2px}.modal-title{margin:0;line-height:1.428571429}.modal-body{position:relative;padding:20px}.modal-footer{padding:19px 20px 20px;margin-top:15px;text-align:right;border-top:1px solid #e5e5e5}.modal-footer:before,.modal-footer:after{display:table;content:" "}.modal-footer:after{clear:both}.modal-footer:before,.modal-footer:after{display:table;content:" "}.modal-footer:after{clear:both}.modal-footer .btn+.btn{margin-bottom:0;margin-left:5px}.modal-footer .btn-group .btn+.btn{margin-left:-1px}.modal-footer .btn-block+.btn-block{margin-left:0}@media screen and (min-width:768px){.modal-dialog{width:600px;padding-top:30px;padding-bottom:30px}.modal-content{-webkit-box-shadow:0 5px 15px rgba(0,0,0,0.5);box-shadow:0 5px 15px rgba(0,0,0,0.5)}}.tooltip{position:absolute;z-index:1030;display:block;font-size:12px;line-height:1.4;opacity:0;filter:alpha(opacity=0);visibility:visible}.tooltip.in{opacity:.9;filter:alpha(opacity=90)}.tooltip.top{padding:5px 0;margin-top:-3px}.tooltip.right{padding:0 5px;margin-left:3px}.tooltip.bottom{padding:5px 0;margin-top:3px}.tooltip.left{padding:0 5px;margin-left:-3px}.tooltip-inner{max-width:200px;padding:3px 8px;color:#fff;text-align:center;text-decoration:none;background-color:#000;border-radius:4px}.tooltip-arrow{position:absolute;width:0;height:0;border-color:transparent;border-style:solid}.tooltip.top .tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-top-color:#000;border-width:5px 5px 0}.tooltip.top-left .tooltip-arrow{bottom:0;left:5px;border-top-color:#000;border-width:5px 5px 0}.tooltip.top-right .tooltip-arrow{right:5px;bottom:0;border-top-color:#000;border-width:5px 5px 0}.tooltip.right .tooltip-arrow{top:50%;left:0;margin-top:-5px;border-right-color:#000;border-width:5px 5px 5px 0}.tooltip.left .tooltip-arrow{top:50%;right:0;margin-top:-5px;border-left-color:#000;border-width:5px 0 5px 5px}.tooltip.bottom .tooltip-arrow{top:0;left:50%;margin-left:-5px;border-bottom-color:#000;border-width:0 5px 5px}.tooltip.bottom-left .tooltip-arrow{top:0;left:5px;border-bottom-color:#000;border-width:0 5px 5px}.tooltip.bottom-right .tooltip-arrow{top:0;right:5px;border-bottom-color:#000;border-width:0 5px 5px}.popover{position:absolute;top:0;left:0;z-index:1010;display:none;max-width:276px;padding:1px;text-align:left;white-space:normal;background-color:#fff;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.2);border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0,0,0,0.2);box-shadow:0 5px 10px rgba(0,0,0,0.2);background-clip:padding-box}.popover.top{margin-top:-10px}.popover.right{margin-left:10px}.popover.bottom{margin-top:10px}.popover.left{margin-left:-10px}.popover-title{padding:8px 14px;margin:0;font-size:14px;font-weight:normal;line-height:18px;background-color:#f7f7f7;border-bottom:1px solid #ebebeb;border-radius:5px 5px 0 0}.popover-content{padding:9px 14px}.popover .arrow,.popover .arrow:after{position:absolute;display:block;width:0;height:0;border-color:transparent;border-style:solid}.popover .arrow{border-width:11px}.popover .arrow:after{border-width:10px;content:""}.popover.top .arrow{bottom:-11px;left:50%;margin-left:-11px;border-top-color:#999;border-top-color:rgba(0,0,0,0.25);border-bottom-width:0}.popover.top .arrow:after{bottom:1px;margin-left:-10px;border-top-color:#fff;border-bottom-width:0;content:" "}.popover.right .arrow{top:50%;left:-11px;margin-top:-11px;border-right-color:#999;border-right-color:rgba(0,0,0,0.25);border-left-width:0}.popover.right .arrow:after{bottom:-10px;left:1px;border-right-color:#fff;border-left-width:0;content:" "}.popover.bottom .arrow{top:-11px;left:50%;margin-left:-11px;border-bottom-color:#999;border-bottom-color:rgba(0,0,0,0.25);border-top-width:0}.popover.bottom .arrow:after{top:1px;margin-left:-10px;border-bottom-color:#fff;border-top-width:0;content:" "}.popover.left .arrow{top:50%;right:-11px;margin-top:-11px;border-left-color:#999;border-left-color:rgba(0,0,0,0.25);border-right-width:0}.popover.left .arrow:after{right:1px;bottom:-10px;border-left-color:#fff;border-right-width:0;content:" "}.carousel{position:relative}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner>.item{position:relative;display:none;-webkit-transition:.6s ease-in-out left;transition:.6s ease-in-out left}.carousel-inner>.item>img,.carousel-inner>.item>a>img{display:block;height:auto;max-width:100%;line-height:1}.carousel-inner>.active,.carousel-inner>.next,.carousel-inner>.prev{display:block}.carousel-inner>.active{left:0}.carousel-inner>.next,.carousel-inner>.prev{position:absolute;top:0;width:100%}.carousel-inner>.next{left:100%}.carousel-inner>.prev{left:-100%}.carousel-inner>.next.left,.carousel-inner>.prev.right{left:0}.carousel-inner>.active.left{left:-100%}.carousel-inner>.active.right{left:100%}.carousel-control{position:absolute;top:0;bottom:0;left:0;width:15%;font-size:20px;color:#fff;text-align:center;text-shadow:0 1px 2px rgba(0,0,0,0.6);opacity:.5;filter:alpha(opacity=50)}.carousel-control.left{background-image:-webkit-gradient(linear,0 top,100% top,from(rgba(0,0,0,0.5)),to(rgba(0,0,0,0.0001)));background-image:-webkit-linear-gradient(left,color-stop(rgba(0,0,0,0.5) 0),color-stop(rgba(0,0,0,0.0001) 100%));background-image:-moz-linear-gradient(left,rgba(0,0,0,0.5) 0,rgba(0,0,0,0.0001) 100%);background-image:linear-gradient(to right,rgba(0,0,0,0.5) 0,rgba(0,0,0,0.0001) 100%);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#80000000',endColorstr='#00000000',GradientType=1)}.carousel-control.right{right:0;left:auto;background-image:-webkit-gradient(linear,0 top,100% top,from(rgba(0,0,0,0.0001)),to(rgba(0,0,0,0.5)));background-image:-webkit-linear-gradient(left,color-stop(rgba(0,0,0,0.0001) 0),color-stop(rgba(0,0,0,0.5) 100%));background-image:-moz-linear-gradient(left,rgba(0,0,0,0.0001) 0,rgba(0,0,0,0.5) 100%);background-image:linear-gradient(to right,rgba(0,0,0,0.0001) 0,rgba(0,0,0,0.5) 100%);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#00000000',endColorstr='#80000000',GradientType=1)}.carousel-control:hover,.carousel-control:focus{color:#fff;text-decoration:none;opacity:.9;filter:alpha(opacity=90)}.carousel-control .icon-prev,.carousel-control .icon-next,.carousel-control .glyphicon-chevron-left,.carousel-control .glyphicon-chevron-right{position:absolute;top:50%;z-index:5;display:inline-block}.carousel-control .icon-prev,.carousel-control .glyphicon-chevron-left{left:50%}.carousel-control .icon-next,.carousel-control .glyphicon-chevron-right{right:50%}.carousel-control .icon-prev,.carousel-control .icon-next{width:20px;height:20px;margin-top:-10px;margin-left:-10px;font-family:serif}.carousel-control .icon-prev:before{content:'\2039'}.carousel-control .icon-next:before{content:'\203a'}.carousel-indicators{position:absolute;bottom:10px;left:50%;z-index:15;width:60%;padding-left:0;margin-left:-30%;text-align:center;list-style:none}.carousel-indicators li{display:inline-block;width:10px;height:10px;margin:1px;text-indent:-999px;cursor:pointer;background-color:#000 \9;background-color:rgba(0,0,0,0);border:1px solid #fff;border-radius:10px}.carousel-indicators .active{width:12px;height:12px;margin:0;background-color:#fff}.carousel-caption{position:absolute;right:15%;bottom:20px;left:15%;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center;text-shadow:0 1px 2px rgba(0,0,0,0.6)}.carousel-caption .btn{text-shadow:none}@media screen and (min-width:768px){.carousel-control .glyphicons-chevron-left,.carousel-control .glyphicons-chevron-right,.carousel-control .icon-prev,.carousel-control .icon-next{width:30px;height:30px;margin-top:-15px;margin-left:-15px;font-size:30px}.carousel-caption{right:20%;left:20%;padding-bottom:30px}.carousel-indicators{bottom:20px}}.clearfix:before,.clearfix:after{display:table;content:" "}.clearfix:after{clear:both}.center-block{display:block;margin-right:auto;margin-left:auto}.pull-right{float:right !important}.pull-left{float:left !important}.hide{display:none !important}.show{display:block !important}.invisible{visibility:hidden}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.hidden{display:none !important;visibility:hidden !important}.affix{position:fixed}@-ms-viewport{width:device-width}.visible-xs,tr.visible-xs,th.visible-xs,td.visible-xs{display:none !important}@media(max-width:767px){.visible-xs{display:block !important}tr.visible-xs{display:table-row !important}th.visible-xs,td.visible-xs{display:table-cell !important}}@media(min-width:768px) and (max-width:991px){.visible-xs.visible-sm{display:block !important}tr.visible-xs.visible-sm{display:table-row !important}th.visible-xs.visible-sm,td.visible-xs.visible-sm{display:table-cell !important}}@media(min-width:992px) and (max-width:1199px){.visible-xs.visible-md{display:block !important}tr.visible-xs.visible-md{display:table-row !important}th.visible-xs.visible-md,td.visible-xs.visible-md{display:table-cell !important}}@media(min-width:1200px){.visible-xs.visible-lg{display:block !important}tr.visible-xs.visible-lg{display:table-row !important}th.visible-xs.visible-lg,td.visible-xs.visible-lg{display:table-cell !important}}.visible-sm,tr.visible-sm,th.visible-sm,td.visible-sm{display:none !important}@media(max-width:767px){.visible-sm.visible-xs{display:block !important}tr.visible-sm.visible-xs{display:table-row !important}th.visible-sm.visible-xs,td.visible-sm.visible-xs{display:table-cell !important}}@media(min-width:768px) and (max-width:991px){.visible-sm{display:block !important}tr.visible-sm{display:table-row !important}th.visible-sm,td.visible-sm{display:table-cell !important}}@media(min-width:992px) and (max-width:1199px){.visible-sm.visible-md{display:block !important}tr.visible-sm.visible-md{display:table-row !important}th.visible-sm.visible-md,td.visible-sm.visible-md{display:table-cell !important}}@media(min-width:1200px){.visible-sm.visible-lg{display:block !important}tr.visible-sm.visible-lg{display:table-row !important}th.visible-sm.visible-lg,td.visible-sm.visible-lg{display:table-cell !important}}.visible-md,tr.visible-md,th.visible-md,td.visible-md{display:none !important}@media(max-width:767px){.visible-md.visible-xs{display:block !important}tr.visible-md.visible-xs{display:table-row !important}th.visible-md.visible-xs,td.visible-md.visible-xs{display:table-cell !important}}@media(min-width:768px) and (max-width:991px){.visible-md.visible-sm{display:block !important}tr.visible-md.visible-sm{display:table-row !important}th.visible-md.visible-sm,td.visible-md.visible-sm{display:table-cell !important}}@media(min-width:992px) and (max-width:1199px){.visible-md{display:block !important}tr.visible-md{display:table-row !important}th.visible-md,td.visible-md{display:table-cell !important}}@media(min-width:1200px){.visible-md.visible-lg{display:block !important}tr.visible-md.visible-lg{display:table-row !important}th.visible-md.visible-lg,td.visible-md.visible-lg{display:table-cell !important}}.visible-lg,tr.visible-lg,th.visible-lg,td.visible-lg{display:none !important}@media(max-width:767px){.visible-lg.visible-xs{display:block !important}tr.visible-lg.visible-xs{display:table-row !important}th.visible-lg.visible-xs,td.visible-lg.visible-xs{display:table-cell !important}}@media(min-width:768px) and (max-width:991px){.visible-lg.visible-sm{display:block !important}tr.visible-lg.visible-sm{display:table-row !important}th.visible-lg.visible-sm,td.visible-lg.visible-sm{display:table-cell !important}}@media(min-width:992px) and (max-width:1199px){.visible-lg.visible-md{display:block !important}tr.visible-lg.visible-md{display:table-row !important}th.visible-lg.visible-md,td.visible-lg.visible-md{display:table-cell !important}}@media(min-width:1200px){.visible-lg{display:block !important}tr.visible-lg{display:table-row !important}th.visible-lg,td.visible-lg{display:table-cell !important}}.hidden-xs{display:block !important}tr.hidden-xs{display:table-row !important}th.hidden-xs,td.hidden-xs{display:table-cell !important}@media(max-width:767px){.hidden-xs,tr.hidden-xs,th.hidden-xs,td.hidden-xs{display:none !important}}@media(min-width:768px) and (max-width:991px){.hidden-xs.hidden-sm,tr.hidden-xs.hidden-sm,th.hidden-xs.hidden-sm,td.hidden-xs.hidden-sm{display:none !important}}@media(min-width:992px) and (max-width:1199px){.hidden-xs.hidden-md,tr.hidden-xs.hidden-md,th.hidden-xs.hidden-md,td.hidden-xs.hidden-md{display:none !important}}@media(min-width:1200px){.hidden-xs.hidden-lg,tr.hidden-xs.hidden-lg,th.hidden-xs.hidden-lg,td.hidden-xs.hidden-lg{display:none !important}}.hidden-sm{display:block !important}tr.hidden-sm{display:table-row !important}th.hidden-sm,td.hidden-sm{display:table-cell !important}@media(max-width:767px){.hidden-sm.hidden-xs,tr.hidden-sm.hidden-xs,th.hidden-sm.hidden-xs,td.hidden-sm.hidden-xs{display:none !important}}@media(min-width:768px) and (max-width:991px){.hidden-sm,tr.hidden-sm,th.hidden-sm,td.hidden-sm{display:none !important}}@media(min-width:992px) and (max-width:1199px){.hidden-sm.hidden-md,tr.hidden-sm.hidden-md,th.hidden-sm.hidden-md,td.hidden-sm.hidden-md{display:none !important}}@media(min-width:1200px){.hidden-sm.hidden-lg,tr.hidden-sm.hidden-lg,th.hidden-sm.hidden-lg,td.hidden-sm.hidden-lg{display:none !important}}.hidden-md{display:block !important}tr.hidden-md{display:table-row !important}th.hidden-md,td.hidden-md{display:table-cell !important}@media(max-width:767px){.hidden-md.hidden-xs,tr.hidden-md.hidden-xs,th.hidden-md.hidden-xs,td.hidden-md.hidden-xs{display:none !important}}@media(min-width:768px) and (max-width:991px){.hidden-md.hidden-sm,tr.hidden-md.hidden-sm,th.hidden-md.hidden-sm,td.hidden-md.hidden-sm{display:none !important}}@media(min-width:992px) and (max-width:1199px){.hidden-md,tr.hidden-md,th.hidden-md,td.hidden-md{display:none !important}}@media(min-width:1200px){.hidden-md.hidden-lg,tr.hidden-md.hidden-lg,th.hidden-md.hidden-lg,td.hidden-md.hidden-lg{display:none !important}}.hidden-lg{display:block !important}tr.hidden-lg{display:table-row !important}th.hidden-lg,td.hidden-lg{display:table-cell !important}@media(max-width:767px){.hidden-lg.hidden-xs,tr.hidden-lg.hidden-xs,th.hidden-lg.hidden-xs,td.hidden-lg.hidden-xs{display:none !important}}@media(min-width:768px) and (max-width:991px){.hidden-lg.hidden-sm,tr.hidden-lg.hidden-sm,th.hidden-lg.hidden-sm,td.hidden-lg.hidden-sm{display:none !important}}@media(min-width:992px) and (max-width:1199px){.hidden-lg.hidden-md,tr.hidden-lg.hidden-md,th.hidden-lg.hidden-md,td.hidden-lg.hidden-md{display:none !important}}@media(min-width:1200px){.hidden-lg,tr.hidden-lg,th.hidden-lg,td.hidden-lg{display:none !important}}.visible-print,tr.visible-print,th.visible-print,td.visible-print{display:none !important}@media print{.visible-print{display:block !important}tr.visible-print{display:table-row !important}th.visible-print,td.visible-print{display:table-cell !important}.hidden-print,tr.hidden-print,th.hidden-print,td.hidden-print{display:none !important}} \ No newline at end of file diff --git a/docs/theme/mkdocs/css/prettify-1.0.css b/docs/theme/mkdocs/css/prettify-1.0.css new file mode 100644 index 0000000000..e0df245523 --- /dev/null +++ b/docs/theme/mkdocs/css/prettify-1.0.css @@ -0,0 +1,28 @@ +.com { color: #93a1a1; } +.lit { color: #195f91; } +.pun, .opn, .clo { color: #93a1a1; } +.fun { color: #dc322f; } +.str, .atv { color: #D14; } +.kwd, .prettyprint .tag { color: #1e347b; } +.typ, .atn, .dec, .var { color: teal; } +.pln { color: #48484c; } + +.prettyprint { + padding: 8px; +} +.prettyprint.linenums { + -webkit-box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0; + -moz-box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0; + box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0; +} + +/* Specify class=linenums on a pre to get line numbering */ +ol.linenums { + margin: 0 0 0 33px; /* IE indents via margin-left */ +} +ol.linenums li { + padding-left: 12px; + color: #bebec5; + line-height: 20px; + text-shadow: 0 1px 0 #fff; +} diff --git a/docs/theme/mkdocs/docker_io_nav.html b/docs/theme/mkdocs/docker_io_nav.html new file mode 100644 index 0000000000..814e1f5976 --- /dev/null +++ b/docs/theme/mkdocs/docker_io_nav.html @@ -0,0 +1,38 @@ + +
+
+ sign up + login +
+
\ No newline at end of file diff --git a/docs/theme/mkdocs/fonts/fontawesome-webfont.eot b/docs/theme/mkdocs/fonts/fontawesome-webfont.eot new file mode 100755 index 0000000000000000000000000000000000000000..7c79c6a6bc9a128a2a8eaffbe49a4338625fdbc2 GIT binary patch literal 38205 zcmZ^IWlSYp%;vqo1upLH?(XjH?(XhB4DRmk?(Q(SyX)W#I)m#B?7N%&@gNzPg3A9y|F{1i{C~vS%_!vmy8pvq0i*!V z04IP4KosB&umrgOcXRyD0su$=wg0R&z!TsAFa@~%hfn~t{zKgUi?RJbIV1oM026@a zKV<`u{HH7cRsj2daa8}Gnk4^EMF2odUHbodF(eRY6Og71NK*#{I$+FQ#4RkN>Xu5t zDV|CZ0erHH%7mJ7f9C(hMgfc`(&`gnuuiqhEZtN@Gm6qm9jtBTu`bUstuVt`VE1U^ zQeRP-GNx@G1O+8HnNjpn78T|1$sHu=pO{n+?Hbd%?rXh*b{x)ZZ9Ey*heliTM$ph9 zeSOvxJI7sn2z_VOStQwpj}H7Y+@M&VY|#ngtbu=`HY)^$pT2Bh?F%Qz)A!hd^bxco z(ph?3k$*g}cpvrc9fcXhjj;5WPot~Co6>e-hv7*v=?ht4ZzfafOKSl*nvanjGNp%5 zqVHEAb0A25 ztDEMbuMI$uR5*rQ;Ex2f;9~>x3rZo2m^kwR6UQRPZz@Czx8NQJM6qF(2xu!inpqCE zp&p-KF}@yM;D2@511uFKw|p7`rR5E%Q=P-zPeXA1Ktriy6is`S1oMudP6;lGGo*>+ z8#MeQ*S6fE;37Z&V&V2oyeT_l1gp@&a)ah*E|M@ELRv^E70jhArQEOCVR(XrnfK5q zp=6hd;d{^XAPeI<#-L-CBvNu5_(Jtd*&!2*tS%|-yzds5)A{0f(w};Y^KBe@AdynU zQL37Co!%Eq%0_)~bcR`#k94J}qgc4SSR@Ul!8_*tW{Z3Z>U6}ivNUHWn8P$)EbfkT z@k>R%?c7o_o;AP3>Pi=p)K`@mYLKBdm&H(%0ai{ls$|XAptE5F3tx6U{?(i@T>GA3 z^_!F+A*NF}bxUB`5ssZLyE(_w@^Dbsgs-6_CGq92Gx|oi!cA-HhDACy{4K)xs|&hF z>LTWj1(w}4LTGz@)0q87y$|wm>pEPvgpR{F10WY$v~2DYt@t>2Z4;zPN_He3aPb@z ziE0^tt>sf2&yu8qR?@PaDB@HEgBHaU>ZnpXEB^D(;d~K@`H3P(?)J@Vn z@CfT^4qS#V(v@+Tim_UUz_Xd-$p=1fq8#h)@{UE|bVYBR`b>ehNCJ;D5bU7L26}ay zF9bjM0OWm1Ao>6*BK&HtwoOBWueI2fo{G7Y(GD|!_MzfV9ur=<&-+oRNRfybM70FE ziI3L556BV<%TDstB!_UPon6HAw*b{&kueNsC+=#&J+)243^;t8PopRU4eb)@)UjTC z%|J@gDtLqz=z5jdArpDBF8$;L=m(uEBXxr?n&v3{9kTU@&#yiW%YPB)RIU}%aSn`6 z$@EM;F;6}0Oe=&L&gfL&?rfC)Kx@IRPdd3jy;|W(cPJI&mJ)b22%#Jh)6+MBXi}{R zv^IAae*Q9Ff|}Y>L3KPUWC=0h^@i;U8!M>_cS{w^1mL3n#)V zzLDJBVg}IArNIql9*}a_j5k%x5~ySF{kx7~rG&ilzkAtDE&P%=41?qbzUVW>mJ;wI zG5?8dPhnkm~3cU8v`qiyh&L1E1^VPh=!%X+Uo>1c96Q;$2#!T1Ajyyr?xG>dq*93%MpnA#<7B$B#7=HPXzf=n$eqoJt`+9|FBhvLb+Wa z4m8GHx>=pcMvH?ROyEX%6zNvTMAD1qZ;AsG_0HNgMRs*xMPr|7Ah1x>6n>WIU!Rbx zAYDQVirff^+o%FmVd0B_;=cS=Pb5fBM{XhmuA5{$CX^gd>K>tNd;Lue-*M39)i8u$ zvloM|Alu~~`DW*t3*x9MP(pP*a$yx_Za4IsuM$&kOP znIjBTyD&_q?33=(F8vwuz4}#@VC5b=BR^1qta#WB)w-2XWN|LD`9AlpS}&US6%rj_ zR)6|i3w@-sbdLY*wIZzMyd+h(eZ#``O&@Bi9YU38yi!ozx7p}(2j2!@LD^z z=Hq^=#||B`(#WvR3+)d*sr80BN|Ky6Jt`#Qjwg11 zG(HT7qi~b5*RMzyF*&HHxNqS2WkJBe>I_J0^)kQLmlNmelxf#>?%GJIl_lQcfQhMcCHR zpjs9>tRLYo;~E98pm1*t7SyL+0x}cVhI- z>CT#lG-N@6SO=jawi;8;(_?PT(9ie_1fvY;Jk2=I_w!E z!Y^R`3t#8*m?I|Ud>4es$FXWl2HUO$%~7*kxDsbkG4Q&Gd8^ez857WVF=K{GnKur# zV9TxY3P)fpjfiFra;dkVwPR>95jhb+kD|;*iA+l2Oqxik?B99KpfozgmzxwxSylWb zg)%DWt{5oQP7NgLljJDmH3}IPvoJ+PtxxycCnYT&69cDw>&}In&F09a^uTC0WeDa( zEL8Nxmcz5q4LfwxV%sU0hvQRh+z2C;vEp+E2B3SEF-f|#6-mSx*mK)c0$fDM7kPz8 z?`_-7=l0}C#Zht53SIt`Y4vfg!7WuL-bBA!&v`K(@{u2PXiuNAgvs0jjDCI?mYq<; z@mZQ{ZtFKytujvz#Oopf6!|7kA*r+I0ob}^W8~7^gRdfY+9S_F(zSHB!HwR(Y{(zI z-ibb7)VpopINsALOXkwt^<)cm?aV--LZ?;j*$ezC^n=3iBOB=!JGQ8>rYy~O6p6Wf zY~=*?XKaLp<&Qo6W*RX!e1xBb&9_ct3YV5z_iE#2JViml)_rvMZsp2wS_7iXxJvew%gf;mkQY%&1+`Gi*e*2*B>O@GO()_#LH6z(C{)jcjQ~2H z)FMk)q>Sp8;Wk^A>(}J1pqse|RN~jF+6{lt1bbson9)wiI+YmW7Np-sVNxH|T&AA! zBI7Xjs!)N);7)_r(h`BeuV_SgPbsHm*uRBUVktIpforWVBjVz-avd%1F&mvltBvF? zfNt|pMlEQ@*r7Zr@j1anSI{yWHPQ$!*)ikAEYb7Vw$0#qFN1VR2OI)KFA*m1z+qk`Qy*pW{`d{N@Nn-0){$edMYF#Lln)aUBU%x zpbeNn0tProp-?4C-fLh&EA7jUs3uXR>mE(WMi;sRvb?M`LI&#S!`abZ>*?LAUzBEv z;)Sf?7eJk&T&RX^Zw74e7XPe{@Ple&hu)^v@rLAWVA)heayJ-&0YhI9ste5a#M@pF z()}*Gekga)6xf{ah%_;p~T z+j{vjFu{}Ns1UWUeQeT)f!3d>d;a(X|5DX!wu&XZ9eRYc!uzZQ6r{8oI2ArhVA%G? zHyb=YT19dD63$YpPa%n8ND7_Z+Jr5NQ>dEfM3VIVW%dBxo*UEF9g+=Z` z3D|>we0$`qMMT%+#&?bKsMuGo8^3qSNM2?u$wL0_nc8UkL68&{gP*hNYcXSBRb%cB?pVTSk*kfIOciI=QQrZ1JZwiYyN9#?{qgO7Q!32 zgX+p(BAS0u%GTgED?@bG%^)gzHm;AuU5;tPf-`#gsCDOP-I(3&c+iFWwqT)~_?WRs z0IY9YJeXjU!Nm%OqKuR|k8Mk;_D%MBlM=Kp?lshdEZwvMKMFR{C5D4la_j_TyeaQ~ zdSvtTk@H$=sJHwFks8_|tO%{fojwPmtKj`Q1zQ>HauCfT53_ze)l zTG-M87<=xxy| zDdO)&IMC;(lZM18FVB?v=R|Rw@)!k9^%zF2N_oFCDrd~Y_ws}mz~dKX%-kV41cU}} zQ~qUWCv|=_P_%uplL?G&6J|d>Wk_c3gKFN@F)jA%#ii3cI4UcpfE7lu4V5L?>N`$! zk)h#WZ(15(Finwk1ceGKs3lJx3!EAjUatNdO{TJTR0f@n1S1an1=2=8TU1Ml9{F^EsNZr(g5=z%U97>sgM zril2uR`W@#-Wt5t4Bn5Yz{|T;kcFdy!DE^@u598ty3OaS54s~Hb)tkY7zz6}Z_G@k z&5BO9g?I?$$5+Ud9=`SC0y?M!A2=yUZ(a`GKLJ%Ec-W*#J(z zal~$;zmv0W6y8{yxu3p}rN~roYmS7RdYm}J=#D391J6{cb%T#4)$PQp>Q8-uV-c7&nmY~uoMX$~7PY5dy=uY?@pM1GFC@wI|v|Qrw-=$Sf4{wk5&4_=sF>gnp z*P({nvArrS(l#^E8wXB^60 zjj8eIprA~2PY#gR{Q)B%m?ITG#X@32;je#;)B6g}9@Lo{@=*J&tl^#@&d70hV zqvdqNZSrNvD`pj@qo;n?u+SB3dYiht9J6DcMtae}KQt|F%fb$wYUmT-k7u?}UG8yl z)Fn}2q?zp*uBGX@u7bNWI76Nt7RMm)!sbX2Hz;8bW%E3gv$UWV_F%`6i4Cp7qpcfJ zDggycgt){-@q3Xf(|fbVc=5I>92_~)!?urM`!cFbfKnO~Et7=kL&!+Ci3&hjX#21i zKFjJr(e$x^2(e2@eFplc?uR%6Bo=N#WU7i-P3r}$20vvC5=maef9!lE`8^MhF~c2C zpe=9m1d%QT;koR$`WI=uIaOv;*&wjp4F`WIs*eFc#p^<+tI9=knDS`Y5Hk`w5F|r_ z4?}k75;f>g@CXGS58Xp^u#Y!M9~*|c8HAWY>=({SS*)Ox9&@4z<~uD-@;AQcA~6`) znp0N7D_`!W=)@bxJMyWUz#U*pQ{cN0!i%$t+J2M;9RU6#E3;dfkcw9t9*NT*lcI1S zbVTz`ZG|Ev(sHZt5`F5KoNfAh|<`q^eO8loN$OjJIl2#PXtQA)~wGv&f^-Al_TjJ58Pa+M5kmz-NhD0 z>XD-aM~}AOprfr!hqfUw;f(eLw$1NUyo!L*Yc&h>8ZR3PcRsr zpYsNmhGRf-y508v%`$L8SaCUt#Le-|`Pk(FB`->6b$q*QiU>;5;ZO^-`(W`&3^SQ( zkqH=nN4>YBjf+!y{$c`$oM{CvIf05nmqxq36o*w@|2|2@sQgRAPEnrIYoiG6NcTuA zi20@ezU2fusTA{G1B8BuLkp+2=rSrPB@K@xP~VI_i<*3sk11&W&=Hk2t3r5-zDpV6 z#dQ?z6_e_cU_h5fCw*a;JR+eAljWPV_Vci#Oh=B8idNeaXLW~$1j{iF5rJu`*b1F% zh*c0OefvNb3TPm=QtqJnS&kg0IhUac=EH`4_JOdO2>dyQq`rdoW9z5}NrSU|aEVe@ z!0U9?EzH~X@v58!f-M3vXUndSwO;G6qI#e7_sY;FZ`~pD{4qHs6Dq@w0jvTvuB-~N z8+2+lf)Uo1oXzp{W-SR*n2#9tSW9am$`FVl_l@Qnkpcu$B>@qN%5&yQ1Sw+BnKemL zRfpwW%f=D?SAe7)%1{97X=s}IQA|YiL6S9K$N>{4hvtXo3ypJsGLwUJwmpXvvPb`i zPkFFE0I#G&1qC%RlILTgZcE(q9+YC<%6We|>5Vf%t>CBZCH(2j~p;r3-+a*1_ko zbDXT3(;;8uXXy6+1Dk)LQsHjW_wQy>RZ=1Ndb*^$3dPZD;?iXgYVT4mXTRmuV@H@d z+u^8>gmn-Ztx&?PG9OW)by86jFo4ZHASsxOGZ=Hk?0FLtV$3cds2baN$3E4A#Cl31p{Ux18pUuLY!{ z4`cJ3-aWj(HRT`W2eeMg9XCNOM0LZ3*_F@?(ptb*MXl6wMq(2O8`(E*p^_64!N@mh zN}T6Iy|eL?DEPiQ3hfe{h(y80^dA*EwBR9&WeP}~^-1)Q!~NsxR;~NduFokawu-+X zBk?;o@e$fU1Ti{AzikyOdXzd22eX9kBS`pQkdEjn{K^EqmgG`{$d@+XqZ9O6SY_gu zVF`tjkVmDrsCq}^dc~hYd`tGM!y0j&M8QMw%5XSu{5J^=s>#z|3VD@{Gx!}uptysk zT-+YXFP4p2TEnMWl(`?Zi-2;tKPjKmJ|@->q=`h8(^8lcI;rt9Vh4rL1X0bU&<>to zQ6;sD%}9Rgx_URn9|V~;>{Y$#W1I~`l^ZP`I}3}K2ERDD$UwHe2|PEk(Z?gSX5)<+ zdUVERMQ8fU8wU?*Omoc^6-f@ZzMlOCCI4JZ6pFU7w%(&U3w2ffD{wNRM)kBsFp1D~ z$hptcdV!tgO9it8id@_=mRh|S1`n@*{P87e8yPYawPY3Ej4zfgPmjpJt2xkQ)}yWE z8!BwmbeSH$?$nPCXocC}BuHU>8G_#JzpON-o8dHDrRT}GC=zG4n-7RYj5gxvKZ=Te zSOn$?;)Y`Oh+*oP4+?!cN|V?jhT*7k+1UwXf3vmw_`8RK38Xw0v`a;iv1{x~`@aLM%hM*qtStGVzXCYf`q* z_(Exk=MfFjEUpAv%V>G@&>gR|FJndsyiouJU(}m+h$7w~k3( zW%y9pi}!Z98ob(Mvpx~OfountwA-jxjjOYhbyE7{fri?p4n@6qdH^jr7&38fVczz`O5|rS zdy!`@=)KgM`o`*xTGX6Xu3ZvA3j2C&@tIF-vj3*NrQ~{bnX;X!<-Ae3z#`X$V(A?- zR>Eba34!GF`jUademjbn#TO6DETFmI1 zzS4Ag!l8Mt{T_^WuF)6(;xNHm4}e?OJGCJrNUFcL`Kh&jmc&pBdHbLT;X{(%Yck+$ z9rjdgp4HO5J=y1e6o0fXPkuh0x`e&vK^jbN zLp|T>34R?^3!C<1=U?}@-t=y2v*M`L27Wk8BFOxfx|1;Xni@||$FAh)b)?sBW> zzw>aD<;V80(-5HXqbXyvg-F(qA6|AbNFJ@SK>r2 z1KK76v~3*m5M?RO@~rZr4@<>T$Pxjuw=^e(_#E?V8&W8b5hz8G9Og?S%wxe24~VR& z0*ZpRTVmJdRbj=qb<5uLm(abvLXYTU9@-jw)?ms&mfc8AE!QY0D)J>g-lmy@O#5rY z6WLsH{weaGczE8jONV{}7m$23_L)sEBHTLA?Zbb6s1(3*q~4x|K72BGM_9-U=s9sU39y!~V5p@k##Z1v$ zRm8R`n7%GrkuQ9-DMesZFZqp1B@nB$^Rq%jm}XzRNYPx9EK!;LbE>VkX}0H7VYmtx zJjuxDl_{Gm<0co4N93{5g1C}PR|$ebo?XxyrGGPoPNS1T35K!QkOYXJjNv~{hQ<}) zj=PwUzrPmNOe$M3S>%bIQ{zQ?gB@@uBh3V44xG940Al0GE|aM6Jr(w5h1=03lZIFbBq;fVp3GD+(ARJ!+=|3t4d~)LXIZ2?0`BfXcHj8 zbFHKWn9noh6O;9%f2%6a{o=6@ySg)Fj7Dl80r{ry(Q=;~OrOv@ysCr@xCg4Q?h) z0>WslwOatjzulyT&7q=aiqW`VEU)869Tu$`L`7jXD3k3&LeBAPXqa?S`Pd|7 z2qFA79}#)cd|QZvZPO?h+Y&M#*`{8bO5oYngy#14(vLt|k0Chlj3L@1ZEP_ANPmHY|$QXQ!wD`4GueT7t zb9DaP`^6}`7+hfI+Lt3byh=*|2RmW|5RYL%|k;X#f~6nsc z*CEiAl#o!);6?bZ&&7Cuw=)?`YsI9rCORFy;ceZau=(}DK+fzi?8WFD6_MBMG$ml= zMsh-4ss&nJ$hgT~NSX41@Jwctel6t^3f!aS7D~w?`X92Uy{}4vADR1Y?ObuRR)4U} z2pv1}O4qjvl5YamQNHtoGN&HSZttO^zz9Oa6hS-=n2);DK{SzE6Q+vde1;^FCjSC9$*dy_*- zJ%hTbBmFU~CdErX%Nyeb$#OsI&ESCeA;@k@I4(q&7^1U1`s(G-VP}*LfJS{r7`{#t z3XBp#j3T)A zE{aoA15z}9lo-8(YRQ(SblP(l(>v_To=WdGwoOA(@uxpNPV2il0IpNJ2f3e-`Bpo!hL?RGM5E3eh8=8p>5^l_lXR9EPYY1}o z(k*0k1kU9Jyl--}Xw&XwA1P8^Q?cdv!cZY&l&Kq>B9GCGmdj4wHT^9dwMXYPap)$` zHcW`T%JL;fA%H>*c_mB?l#JLN?qHDW%PHjlUn{q>GpoUxp}-?hslNMUVKQVajYo`7 z>$&QaAbR9@gn)v*X_q1S^FTc3n^;^>(C45_gJ;x8ksNA!J8?Eww{X(y5t1#x)f`Qv z$afQ#`DUDiAP+HE#XzFQfSdoe-ssF`yXbms&A6+g4ZQu2BGnb5t5;(%?va?q$&kRJ6O8P9QtkTz$f0HLozGu3sL1T)XQ$jv*TKZZcy0*t| zK_TQs!%2>%4P>HGk!Wh`(xKdSBv*e;=wIYw7-Vd3f_575 z(1=MApsGiLJ4hjLR@)szko>7!=Mo)iqa96vMJ&dRf?a3#D;$evQ z{_YY+Q+@rn5PCc^9*jnFAMTfUSH-g22#!1STP2Pao1A(Ln%MXc8bY?jv~j`xipY2wT{IOb13X&AJk-5nTR+wl5td2i1=+j94+tN z#ltppQ4jMkmI!9MfaNY_6h(w`qsE!^;@090RmQ!EZH8N8Qs0vKiosb!dcr~y0z;3Y zc?m2$yi;?v#SgG}?w`?N$lDPxJUGnrqzyF6ECSA6iHE zMmXjfI#M|SwM2gyozz_z3C})%JT?s!dVF)l`84z(f|d!j{UQ}Ap@rBDEw3W{Itg{I zNJZsRdQPFi!zloCuI^&>(+Blj{~CtNs_W>xFkZX125*_wJ98t$i=ehjc`5@(yd(2u zT?>W>QqvI(U(%#Yz#1J9RBWcyAngI(;j%jXs@elcsgk zjas-ld1lL{O~fH~9q|_tC9}!DV`;gM=*! z8ip;mpc5sz9uI7RwZ8;>dJ+ele$aWeoXuWdAdG)CWRFuFEcP@LxmdwxSkc?z&}UJ_ z08WXvLj!wjn}~#TCX9NPIc`2z*W@bg%&xvOIewG`y0STb1mq~gp%uS^6(Q2#as80L z|18VSW315517}JcsqYkA`{6di;aW;2wkA=R*}KLiI|h=(ZGMB;EvE)S-hI2->&k0% z9XqG;&yK?V5qPfiI~0EURzMh8%w+%yGtpQbwTJUzWxcJ04&k#-5q-L>x4-B58gbL6 z2xm7dvGamFUVE4Zr@ae^f-=YsOjlm-GtAO}f{z+x7G{VW%aDvWBS9C{t6kOzj6H0^ z8YEmZmqmb$bHtEg+s8(GP#b=%AwIf3^lBpJg*Iv)ludv@gk@!u2{OHFA6|f=Fq7aj zD+OB~lm_FIcUcWY;}m@2*m(lKDEH|8!o1JKb|~q19`#wLQ_GD~ON#)q2!G}Hvt*)$ zd9t^xsn0=5lknsVSWEoU0229mEB7LcH>W7Vgsl%_@8?~uWwUD} z`XxhMRw~@(gYFi7+syt*GUAJxp0gKYG=_J&X?gwDFQyc*lF^iqR$g!<7wKhv-j6q& zzvr-n4l-w3hE0T=>}pxf__W3O`L&E&t$3^wrU9$^^ zTq~O8NYqYbldSWw*?>enK`TBbRn4&WcxtJ4QS?lHx}AtuYG_I?@`rj4X*rCV_~hukuD?XojV7i&{J2ZIr-*=BAMJ&k0JU9NIq# zkz0mMp78F9fe^?!Lg>!&0Zv9yf1mgsQlc6Q2-;;B1cw%=UqR+R=4DvR@&Cl2mBVKp z^$`k`%+4)*RPDpZ+$`m!LPH4&7pOZJ^plAKLhYLIT;iCK$q`45h2sKPP+o4cvJ{4+ zpZ%hK0QCWZEa(A+(-JPhPI>g+A@NBZ4C1@Z-ovz)*y?$kP0pSY@G|23zIIL@AFT2F zs-71oJ&Y}5MHOWGq@sArAoRIn$v&m}RBSsfUX8-fT)OITeMh~nx83g&vx-Oqcgs|* z0bOZp(4vsA!q{KcO(H5w3TQmzrO>)0VYDJ+$~Uf)iS6H$2*$^fsf}xz&Yd&Y5X0HZ zjHgQtaD};It7$bx3Z?b+Fq}>o!)(VO$Jw!?$W@^;heX|Rh=zOW3}!StFr>yb+lI=g zJcd3Yp$`6a*px@(a0;3x=(&u1`w?jX71o9Wt9FhHFEp(_D{=3x62uA}6M*ayf6r`9 z{auu7q^{SrEDhaj2Rnth^rvap#Bh}zQhGPu7Cg6vIMx20KW7#nSo9ih-fDL||8rD| z?F30se51-f=q|`|T*15_ITLh-woarjY*hr4YRGl)Q{BK8@AEZqf4Nti}!Cu+IxrT8t+nm2+GO*-^Y=+7-}W$WHpXp&=F_>|8~SXJ;k>(5GYwS}>~9;4YWl$R5|{36(|VO1 zwA-mm_p+urSKUi)o32KYVnVxTZ^R6m7W2CBzih2-%sCYD18CZgOx?(EU;#>TVzC z00(zo?At;%HQ60Bfd^w)H!PbA>p26=*O9x30bYiwULWM8Z1)w>k0~~hV*-x2hl`^5 zwvGQLmgWW69OCf}RVH|!GS^Kqj3uFc*8R z>e>_(uv`W0+l#JF-(pIhARC;Vf_Ng2GxaJ;u7u6$exj3mrNpQ&j8R5-_%w#@_dyFn zvfSFh;%61eB05sSi z`Yhwg!&_DQtF z@0MJfCj_nYMS;n0llhGVkt;VYD^)vdca2fi&Jxmb>Q(!TcrtN+d|{4d!pqNB58zvq zN6-gHE(cK#CVr}E+uMbADdD5Fx1CzLaF1G$h-i^8M~qM+U23HtrBU;fPGThCE3r#% zopji+n%!Bnw33WI6yuFBU6F8W<0iVBzZHiZWi_U8T>yt@>h4K-BC1D$QCEsYhW~%%K(pj127tbyQhk7Ay!gYzjdO6Jt%k64wTo!kNfR0(2(dmneO zNT(;B$nIq^p)NRYG&JB=)I$JLR%< zzmjY5$0?7q491IWEL@6lbW(tFH3cm-iZR96WL+7riuoI&%Wvc%f~Rk&UVc2OqyLh0 zt)zq%Ry*TI#p1L$g8ypa{k};(6X(P$bCI95$H>}a^Py)5qYzY!9`U4vuN1P2rcC?$ zlVNL5_VeCzjsC-y)gptp;v=bE95bAGZY=oqD|OdI`#wjEs&x1K_?Vh-aSb&0BW~pF zs_jI6Q42NGbW9u1-kcK!^Cb(GHYHzs2!5ZWm;*f(d>Rf96ldZ=5^gw|n50nHT?n#+ zm;B|@@%4;pV=36ej{7<&-t{k{6hYExI-_M{D1Igphg@gvS5->f7_GdMA|ZD`{{(7& znEZjFK$xuM77w{$+D~*8T*P3WT1s#b5Q4u3&1k}6%e}2$Kk#&_wV}x|e-b-#^-6Fz zYTo-I_g zT!2Be5zcJp=#oOI`tRcwDTDphmGbYOy+Sz4xg5n@({V^nWI{v3uHv~MNTwqAD3yoo zXuN)7AcX>t?kRET5$a=B0h5q9xBQG;s!LDHZ2bYy^Icm_ej+o+SP5`$Jv1f%z~3yf zP$(J&Gv_JQaf`vy|1lauI~cJY`u7{0h;ONdWBoh;0Zu|S9*(5HDdOq;z-DAQ83$ua z$3$3P{qZ%b;Tr8TR6eMpX;~)9WQyE7>E&uHhlxf)j?>=2#ILCvT8Y37Yr(th(MYRWZ!h1J(B(s@fbpan5 zN!;*SXL=%wfQf*u8edjrRe}VIxd)(`@`S8pv<^cB3GPr~O5j%vV+_XR*J?o$HB+kn z4Y9}N78Xe-Kgh_5F}hK3)kB?}_`hl5D_2M)#Dg!nVO|fcgZS;a%r)26Q2> z5s+VrrE-t79bfCeEzP8gG@&>rv>9OLf`*wCd+8eHPnwf^d1b6*BBP#@uy{NcJURbR zn?^PGElmeWUbqANIGDFOsRx{weXt5hSaGCZ5!UuYo_#03-SBZvVyOHi@C7fKc={u! zy4obhWSV$($=o?lSk|VBEosrdiomxzXx0$?t32;oPxD`smBja5{XM|GkytzG7HB+i zI+_xONpRW*Wd-t^I!(3t7vo7RQW9G!Ly6#|(XcAj8qJ;fwg=fURXgNm3T~Jf)b?{AxFghlwu)YxhxEJiZS)NI7FL&!Il2W z_|u~DS1!2t%?WR4WaN05$M-KE7P>R_b}bE5?Q~_J7SKG$*`2s}@rt`P6VF%tDnv(# zFb5Oy28(nbPf?AV@MPu!z;Cr6lx{K#EY5&jGQ`6&(#r#JWGyDOXM1CKL7XH!)0WSWHc&>o0D5 zS0bJEzjr@awn>pb_vpmH0}$;w3^y;zi#CF!#oTN1wYo5-P zBKPi8elw+db`nlW#MhUR`Gybz1|~kx)*uH6Wzad z+4w^?sTHI3FOWV(vrBcNKzGJ*RG`C3rwb)b3H zG2>8)%R{9^uPtgBJe49tAcmer5+`{{ckMtKLJJ}L`+>$>9w!FziW(a1tEOp!jk`8- ziUe|c5+g``wWAGqkR+FCJMleG!nIX)1Exf!WgJwMv=+^n(5_Xq)Sv@`bj(;%W)Gzc z@2ZB@YYM(l#Z<}C#p@me^!LN74(|KfT%uUcU|}+(B_v$!tp1Ij*ivQ!BtjAZ7^_ZW zOr<@(=633BJO%nWl+>z3PW^{!OSd>f(E@ozDI;uR>SxQS=K;IGAvIp9NAeyXR&TQA zszK87!&H|)M~H~41*VL%r0>+ZHg4H8u5s|WOK6Tf0x0}ee<|?ixzaq?qNg0;gBD_S zA(=kCH%5uabf_=}GKd!2$Hm|v=pM*BBGu$WN8UeUKFk(Gu)XRKFBbyA5bdb9su7m6 z&HoE9K+nHtmRW0-n>^F2HS2=1!7d-&=XPeK!D&joa2^FQ1^fOmsnrrI8pg#BK6(W`PW8j-?^%>Y%1# zJ?EQ-4xVGt)JO^*IJ8ZpC%76145J*l%rM_c)PW==CPc^UnFSlp1Zig~W&`_FpnF1Xi-ZmVYk(M)eBG z?*xE7f!3hW&5p7p?Q*68}WEeih55*V?c8|1V$59nxh+M6$Er*@mi zJXApP#GbfKPF`P$tQWePqVvkuTI#?in8t{3n!IC%v?}j4r2w!9kASC#R=ij+*9OHG z#-mmxq*0CxB=RJDD0w~`DJD0d)6Y1526{m8RLF~s$q&f?Eg3~%@3_}Mp{;>m*~d5x zoZNOGoqVK!^*FDEN9}TgK*FJ@=_DSdb4rO|99j7}i zg2nv#36Zvh+*I&0=IS9z8w?l?ItCn>+5A{|YTrTa@BDjBwGKeFmbB{yd@O+>t25QCl;N0D7+GD{+rcr@YAL>3O#8Ao8#IgKqSs++?_8G5&SD8{oeu=_d^ zPQH8nD;}21YI&})RXV>w;%I=wYD<|FyXHY^?LKFo-x=#7y?7wKIv3- z^qm1Qe@X)2nhgT%=@9hxADhYWm^{Tc@-FZ!qeoY1fk_A4>jqT()5WL8QpDkH*#t3V z^q6CIQ=9(-bT*R}(w0_YQ)=so&l84Kl+Z5n_IM4D?fNXDU3A8N-eIYMzQd4^ov#`b z=OMNrM+ovoct55A6Xn^vCn>bwjWsr@k4zjGJVJ*ReuHoK9v2Q2k`mb`A}H-Rl?HqUD-6VE}d{ zKiY)If#boCCP?xG(~-F)BEZ^#M6w8VRAdwTF}}APoU|_`X>tS2)FX#}h+&5MjMjD_ zNb#H_>vxTmnK@S6zz3gUX{Kpb!u(?ki2ZQLB(z3*C~FZY%k+?>R6`9}a17CzKq3IY z6og`t1{o-1@G2?dYR}K$O(bYXbAjQ}KI5~Pqd(1cX102Xv!a@YQ0^N~#8EJ8PR60Z&V|tu8sG~O zUg01sgSE;DQ>mer!Ua2@c@G^BO&6vD@JGmi z&U46(LZ0n^Cm*K{l&cM()za{B2i_ zza!H;u&@;2AN1^9oaU4d1gFo9wWGCeFu5eYJeffpbny^_WC#XJ0Az(?c(*5u!ww*2 z>4*TRoV`h4lCeIr_;@H>rQhFv7}IeGP#9+H$ufm90V#rx)8afQ7Sk}Jj=ZAuQdNny zrWg}qxG6*Hz%)puO@?vnTI;SMggHx7pQ*lXs2EJt0_EYo7q10Uj)2(Y7Mn$zM0 z2;K!2GTt_#I{tVG*R7UlY{@JXLCXhHjyR5jquHnq%~}aRseT#fK(n8n7gEsrC|t9Y zeQwgw{od@g)ecMG4f=c`u!$W98mz;RR17*_1`sMe6pt1vuof<`Rq6V{GN8pd>>HUc#MOtPD5%F% zRl!K!W7Fk2A||J}`DHS*>7KUI?Vov+c2P`yJ4_5MQ4$6eKwPqOdmn zV5adY8IlxSSb6$&EFypH8%8qJNf`X8ODmSwVUgNf07D@1u`==`G1{lR)nCn*?Uaze z8ERJpU?O{DDgeEP3u+nP(dnk&8#Nh(@(X06EOCgvgMvge;pb%p$82x+-$;n}lc5hp zpG$z+hc#3mp?-|6fOKsTDN`FHP^?NB*PUqO*%1{BycWECs%9*x09AB^as8SPBrK=W2-Zg zeLhUvw{SegHUv^P*pRj|RI9YJEHbq?Ik3&E3*mcMp;4|kJ_Bkh?XXo*kz9jEw%|O> zAdP*cBGgJ0uz2SQmQ0E}jenNSVxtW1dv@lN9q4kNGh`W~&}NT9s@F#3veFQcWS1y` zA_lDmAZ+3-4aow?Kq??1S3;p;E5vHNBm@9?+>D8%mIOHPL?$WL5dLlAqP=Q83Q;yu zS{b-J7yI6|9OiA4X@erlLErB|?E4i*3?#}l>`N$&p8gV=Pvqr?ED=fjrWz>1E z6FUJJmx8-a{V8)|W_~tK!M1E{FWA%5M5f8uw@Dd8EY07aYO(d)}rCQOWY65heABPXqQErYW-2fDnrkO ztE2rPTq!g!0x0Atth5e&kuT<(yv#_BF(!)`^SNmJ#{k`<*_prG*ZZNUVx-d-uMkDp zqEKQI!9SFjt0+Qtg)D(CiD&TKLOfrp4g}VXzzU~20OcdVBM3yKcE_5dW@g&?l+>7{ zIv^^qF0z7I(G0j-EA8yVXg&h}`xcAvUJz~!1AmeAS2x5(3a!zyC&<5RnWQK-hqOd_ zc&(bTi8g`G!B9S3vE>@j!HHKS)Cp5?@`OBIP{t;Eh`m;7d7&DDdR06-zI@Q&Zv-Q6 z{oV+P!PH+yFCt{2@6g%lc(b9)+5om{bif=Jxh)rOjZS!2`BEG>Gcw_ZNM5K%vaD(tF!1aj%Rtq_uY^j?pqW2L}L|!!!mNkhB4gzT$Kjv@yA= zJwzG=JTL{22aiBJS5s73{;d*vfJdsGM)K*(8akWp3Y}5?>v&b&zt{&0_g|ruU3^hPfd@fw*3_UfnMaL&{H+@!#6amQ70ET-< zu|Ypz1`Fs?6q8c@vmF*bieE)i2%3jEB6eIxnYLdXs1Ypzl<5;IWn&Y#J>jBb*0aw# zs58CR#-X+&j1K(EE-YHLf{8VZe`mqWH?1F!a9p_HrTLM<2Dz}*rq39~1`Q$QRL-C%0vP5VD zRJBqG!^prX8%vOQ8Rl>)Y*PKEMEU0X1_6a1L<0{AEQ-YAIDy89oQcuUb}=VR@rBu8 zxS^a4jNSU>db0Cx46A4zlb0|pv~5w4(c?Y5GGSaDXCX!{au9dzE*%e(k-{o;TUrAT z?EJxOx1|o@G_ipNNf%>syK^T4yFdxqVnuN^N4mazcURzTMGoA%!Qlgre8$qF+&32E zmkbg_VtL~+4@!v(%fsYHoQpl|MfFJc(u-m!lnD4mQvMeM{-EE5VUY#LUo|A1)_fqy z4e46XLQ%odYP%q#{E9P%MIfveEH?7bM{63%dxtUDP6Pti6c6&Ic?%n#Vdik-WhiVY zI1v_rMF!~t6aU1NDHo8)**-``MT3o*Cj=*f;-8UE;caqdzezL2pO{6hFHn3kOji;( z4EIkc;b@F){zhYjuyu&-O=+d7{`fV5Vs^gS}r zSlnz8Ufy^}Z1`vtnigWm!4?Xime#mJM~<5aKp>h-1zL~HA9X?et-KMkR!ZBBSEup} z<0}P0xUD5UK^yKajIh)6%pnU3$6^cnUjs^(WJkRmGGqQn|94Rz9JC3vPHbpaH}2+m z;UNGc>@|wGTc zn*CC)q?r!38f)2vsgP0}p({#+tte3(dAODUxSkY_Xp6WM(ycQlk>? zi90?Q2y`8f__Bj69I2m_C6sx+$`Ci73zahi4QQ#f7PvCCC--9`@nmIR8rm3^al&0+?ciPZVSfYtY_kBWwX) zp6!T*Elqhf2}~d$8UgO(P0b9H5-m$5i?4DAMEqWaKU51A8=pheK>-U2!brk25D-jZ zlt!DGCN4@pZHe4wRFY$vCjp@%m`2U*lR~5YgMq$kDT+Gx%+D)Pl*Kww`z8%2&`4$& z;gM`8E+{mJ79N7i?emDeL75VTddW}~l79wxVj=@)O1g*oiONH*B7l$$y;QYF{U(f> zbN(Gh22oA$&m}bHx+8Rjz-V4F>1U-sch#wX4$9!Kzf5y?qR6C`%nZ>}i}kNDb=8MW z&@a*la2TgL*_*dnu}`!`tjs3A4frq7=1b0>#>CJTQ;TuLj;|$=Zs#f^#Eso-jzS$n z_#5!N4U<;jYQLfw*}|AGJSzorKs?F-nS@Mo2Cgtjfd;|)WyyXl#t9AVro(Ji)cy#C zI*Tm3cyJh71DShm3fl-!FhCYgK3#Ij0GMny<3MrthIShbB%$A#=jA#HrY>sg)ScIG z>%2(!sh#7(gR&Kv>OZ1q8Sy~2k{-pOw?&-2w*&!cc>&HmLJI@LA&hvKQ3rw;t$`5v zDM*QOIQTChL~kTeu@e*oe=}fE4M$fJA?WR$j+b2PnAyXL(~Vfi`fRoplMeQJ8|Z48UpB~H_8y!d!9pe^6HHD1aUz1_pVYE?jJ+3wcV#7-iw5}o<8 z&AS4Hqy}IF1q{@n(RIvtR6r~&ga8N*@PIlq++i^l|0TDP=;Hq{UyzJ1OVA?6n0 z4QlwkniuXNq0ABZ=3(Ppe^{zWhR61~>Ga27j`Gh254B8-5?STtj!x0X&@q<+fDe)I zaFC3whx5$L`U8{1!ImV2V7Ukv0HLU&fWmrCtO=I2{4MEXZUW% z>9&DLp7LW-HLm7|q{-=nhk~AF6Uzu9Nc$}fQ7bZ)bmUmWU$Hcst&8(uYZeln08gBQ zNRYG0F+E}(L%f@lr$~e7laWe?ngZ6Ds&l|Oe4)ol>_v$V8oJi=6}sJ`EHD946S7pG zs{9ZZr*dt~6UahCj`Op3_JBwW-Q3Bx z|2mRHEuG2CBLVydoBRbJs&_OEv%Wc{5qVaKF18Lc)8n72VHMq4pd}P_Ao+qtQk-mH7em4XOK1+uveEcxLlJ9YyE+iI{!6(Zpc#W~ z%a(LBj{H92-)(`>k@G)^M(jDoLS`@#rbmtnbE)AMo)UTE9rs6T`Fo>R8Tt4bvx`{1(3U}|7q1)xk?AJ;`EsNSj zoot2O!X5_KVP^7>_5!!0H|+N7rH!CY!%5`+ELrOV^?*o~@zJcQuwG06Z&tI-HhTsc z{HWxvNl%VcCoL?if#}y70(3J$`vO8uHU5v75-j7>4w`m>&<7C{nO$X@v(ftV+O*RF)vL#5k^C_^Q%7jjvhR_`)>;Vm+FN|}p z)gymTb9zD5+%icdKC_YHs{l#h9$}Xif)Na9*4p^K@+qRX%9X%h#k+0}fpO6S!m_)2 zx#?$Kec=qO+g5YPdDNb+U4OQ6C0grZf2?JpM}Vk?5ugl9v4p9TqU(R zwehj_SZigl-5|e(BU4I7ot2wHR*M82NJvq#Hemw_Xa!TNSl3#@p-SQx!!Bh?;U2=7 z@7dSC57Ir9kjC3}RhAS{@d#5;1lAS-%N7?X#!ObJ0Q*{#tTKA}X@K(n=oZ40Z8w8j z-H`WFqR5_0%?P&?uV7fD7Ec!bHO2o|x_Vq&66q%du~yNeGg0!a>Cm6Um`808R+Vy0 zFcc69fue?5SA_LF0IxD)W+9-i;G^-Xx(;_@LU#@?kqaCzaFYoyp+cfr&4F^A(ku%? z6b?(lBjCjpw!f^kq;XMRRB{s&WiuQZ@C8d=aq;rB*j0$LOJL}5oV3T`iqZx-PFA*P zxGk`xy)Z(el4?S)0Ki~l*Ubb&k>#cW)6$Ia&5IF?khaEE(;Y?*!LU^}UtLKUw4t{* zc+q~-)bHIzLx@az>jYuL!j~kJaFKFvUR#Ptw#H8#MwEttL32Z4mJ-=K$}Y6L{*L7k zErl;};dP94!}>%8k|o{K%71cf!xyuL{1}bwW}&^qar3-BZKY%;;+f`ci;jQ$4CR^l z)Ya4}O@PFoWsHJW0C{#(t!RP_t`>p?-61{8QJO*~IGFe&CZ%I2zxRnz7+UWuaody- ze6`-on7{<}gW(jCawHQDlYK0-p<`#B58DL+Yl5)ZFcFHK=g5%Ihx58Q$b(o&9%6mCUc^N6v-aAsc ze7TH23DIau58oINcMYJz$zY9a#lDJxq(}hYYA@{%ZE*XTH3u+jmi# z*(?MSVWH2l(OGhB7(Znaj)rjuOi=dh)PIZ^c9TOu0Qv^LFaWl;!T@^PSg={7;ipP- zuK66IeGU`|=NLR{fJD)xb|)=a$8Q!APZ)r&Pl{eK&4c3FoiAJ}IC^goa(@a&XJ$y* zBU3yIMiVK^+^WzU*d{~CS!Q>^d|;i%U>&AFX#fjR(mdSox5_4DWD2m!X!?IkdWbo5U6=| zVPgD^i0w!^S(2L$NHLC>Y%%^q&e@Fk)Muh17!6Urj6@{4C=bT4U_BON11L58s4?PX zF>gdjJ+lvaLS<2FIbxZE+8HVvQCQu*xjBXz&tUJk*c!DIxB28dyFa)SVJTL3D*E5qWqDE7Z`i`Zd*P#PzBqVkyZ z5q%lpV%R|9YCX->J21*3l(8x(<>|n|+n(5AL8=bd1Ry}5wzdQOPW?S;wSfddz=AO+ z!7U^Bjn3$aR_-W+pLpTYsJ*&TzW2{|A>&*in$F9@WI@OArgp_)KHSg33^s( z5~`f2W7b3(+uN`9F+<@5e(Z;3i8qzYNWT|_tjG`ta71e>%F+7AVNV<6Y1}AA&v=Qvs%_gNXx=;*d6MyF0m?T?Un#o31OYwfPZID zZzNh_l4ob41SEtA6oCx7@U6ZIRZ^n0mlJ+8srg`Hxk>aaN5?3Sa|R2;Fj)4moM}UZ zEINtcya{S%&jwoJHO-jj#smn)wjD|WBYNOQlC58nohb2jW;kgbrh(W-)7%G?UyuRK zq#$@)8N|iVL4v!PW4=H@SyOn2@C5{mEGbK_y07%OMkOEMw_}S1z9K~+0eY|#i8L&r z`O$RIAgy_)#!?I{oEbyMwk#>y%Ly`D_c7-lEIxv6s@cGjum~#fakjfVOI#U6$FnS# z9LblHni{IC@p|&viO{*&-8yhv3?c^*I5y;d!(m?ftBs~fM6gn*^zmpW!m?BIcZ98y zTqmBGxINDRj1|tUYb{rhbEx^-$3jOeD1p&73z1b@8nXhKR@@6Nk?lHQ;uBp!ZM%lR zX)|>lLL}?SKA$WH=y@juIcC&!NIHkhOSXnQF*6fAANb7#OM0K-N#muPPZKP~#BHNVp!*5$Nou5LQxB$Zth)w9_gP8MVrYqkOc0 zkHJ$*X%k9xA2m3onQgoigKInz1YaP>Q0Z%VmU+=VfXd_X^0KA0ut4QcWJ^5hJ`6ua zuCpX!n_L+Hpv)nsrl<;kD+}s7la&>tnX#9|>Eg-?JD66St-s=I(J>+j%4L(%SpzF; zS>fk{L`;%*6VFrQ3Ob9LtAU*f7iP)Dxg*8$LpW0nngO&4DGN6Ga zz4D*cG5Y9&*aaW$)`_wl00W@7hzU=vjJ^jKrN|OdB_=|R$)IErcOzU3PXGzP91Hvi z1Hl^^bMsoP8b8*4*}h*`t?5K5o9(L2m_g(;hR6-;>4-nw1Y$essv5)r@mv=#!+mVN zy369O0e5E`5Do^y)Vq4weGDxy==KBE3$&*InScmzgD^d?bg~3>CN7J|hGT#TVq6_H>LXckc$bjRTuVCLUusB6cyzAmf)Ai!_ z#NL7-QejN*Es8S0`o8uSvn&U&yki0>-hGK8%rLOTKyd0wIP}F1=VeljySB4p zAC4tj&8X^{G3FU9TSGOf;e}0Tv1%pb3~bca5GaMH!j^hyKwv2Kkoa#D z;0KmE9^Cr~I>STVp^-DAxC0TX-;T}}5|Tj*&`S6NN=L#tauE?ESk}Y5B?#=6kBD_1 z?hI+lp^#}^Q@oV0SQ}71VqQ0ZWKiZx2cPjU$b?FL&64ep_D%dLZb(=#sQzpHc3_4q zOhFO*A~K*YaSpn7Q^k2$pduQ{R0s?AbcoR~WCYX27hsSq3kKuCmN9KIkwi;E^UrCo z6naP;$%&f&33H(+k6xX;W_o;%+j1sjpg`HqnUg@1&UA@RUDky%TBv-aSXR#SThC9Z zqE0FlL_fE&{ra&uWBs~jX6h&ozJOS-)u3kQ#;1c@bDs8CKdCQ!N)GOMNgPylAM5tB^Tg+x(7axuJy z94GC-zN&g^t1IzBVrkMB9GRjbPOmR0msE+i@AmGVDVox*h+UJysK8Q6=M6dl39=$S zs98&3*h(IP@Y3j|uAJ-d52&RW5E-^N#YWVn{i{27&cWY1_5isF1~i1p&!Ps62gUYd zyxX*Z73$wL|Fz8)_&gFPC#22_m*i9$rLK1YI6@mD*C{G-FlpZYw;i0twe}~AGSfQw z!C0U7L)gp|46XKQ2ep-=RAnwz&dX%Kk=HGRLSn&OW)TMJsy_rj{=1K*&{WXgo*Gc2 zn_nd;t5X*425l}ot30tixWqiA1b!O>c$yy8v)-dFG&L_|65kx4v;YrKVbDI5MHG^R z3el>MOrP7Pj_VrxAhHnyw9!6MCYp9Y1WKWQNh1Zq!Na3sjangyjt@GKro}*W!(I9< zGoj<@=PAKtkg`gB0Ul92Sa+2KJcXg)VL`sCP+QUac}1(GXjdOh0|Rh6EcQPvaEBBi z96an|jEZcYCz24@lz{N2E9Mw#5P;LjI&F=`q~&C7<<)zftjMP@-ieh?ELQcxyhY}# znQ;OSr;t7=q*m{7x~Y88brlsasSa|N%ZuqZnvZIfWvI|-gru{fY0`zn1&Uy9_%Flv zaahF3-!VeC_alhq|Hd7K$NqU#`$(ja5uK6goYrYc9T*cpY^LA_d#(g-s}_hO33!{W zu<;{BC^|VSP^6c|Mx%YvyHsRkzATp8cR(dvA_PUU;>Z~!pgDpzIf!)KvnNFQg2ht9 zM5x*Ffz4G3I?7qoSRr`TivVfRJHd zoJFkEZXfR_Xa$IP;eqzNtvG}ta$SJG&5q4E9gjFE`b*4zE`c%F9HiNZg=JB9(&1{0 zWyr5e$4?g5fi3p+E_BhcYfTh#xGL@-T5T6GH2&F@G&x9)s}12;tzbIaBnvJ$ICaP& ze^nu_1xDfs08>W02FLy635_!IVp;=mhx=QG(k_I zyz44f$^wBYtxB;?Q+L5tvdZh$lFC%@zB?seOIsPAd)7I%!%cw$0D5N!$csEp_%82T z7%1q7K9@w$*S3fTfD8*O_c9H!4uLR$?~8yH_N?EHi{OZ9Y6u7tNkB8xFye@Hy(f;E zy1z0c!an5ClOL9O*+xdH(g?FVCq4%2v4P>XWh({1DkWn~aTXvyP$$oZ`H1u^3@5_j z^`+Zb)|k^Jk!jyz6cunPNEhJ+e^=0dy~U?z$w;8q^|o69JE4ZgJ?kzX4v3@%!{UG6 zu8jx)Li+`<$4Jr70=lW!pVL;v42Vv@+hYx8p4PZTGK!^yK|7RV37)0~2@DJZdm(_Y zWJlV3VBKqk^aw#!Y6ZVl`Rw8zfFUKIMW*0MAmsXzCsH;$_L7IkIfemz5C8}r{r$5D zd{=>IW55BM`8323BGh@z_Wg;tF$51pm=?>I1e?->(hQ|5Q~@HSp6wiM@!z_77*y4n>&`>+j z06xsW@8mRfTozfzz zZ2VlioyxFOLUDBtNoW9stu=ZI4!wsq5=5lHqz<%jQa%WSQ`Dh2B7$2V*<%y{Bqxpr zSK58v zG`SZEQ=|FhA?yJWAsF#gP|xxo3%&nV;a#u9ktlmGOm__!Pz{@VFc|zlsp0ySPu9M? zeaA(C1_wjnsTOhtF-JbpXI+W;8kXGymUz#ppCbUharZ^hLiJ|XU6AwdX=E@`DCkYi z3=}IaC6LkaY~Mqf;N}WLQnyNY<~v!EXk*v|JTf7ph3gU?8Z$A`?Ib|sGDwT&^;jYf z@DX@RLt?)HeKs6-^j?MdWop25`Z*SF_ySTGf+sOT6k#+1Cdoz0C2SltLr1lF;7$^= z?_{OrkFfcWGFgmd(*g@hxl6Gk{Q-XpIj0_6N=__4;69cAsXC+(FRCEY!m+F99IQ-h z1HkwQFlgL2WujwMNFk-Q3r2G;=5^fQHnrRd1G`-$qwpTjGsy}kBbxZ1Dr*#^Ql3RQ ztw$2#r?j~|sOZDDgb;a??gQuu9g9|#=*5hMt?@;l<|9ZCj1 zEcQqS#+J4WAnm_GsU-apwifKKT0X_oO;%S{=_oixDKMnfR#Oy=sa^o1lAjj6pe#zD z(w>71(70IF1Ps95E?yfF;RSSxE~(cug}_ChZD73;>RsK;YhLDP99uish%65nL|wUk z?wifwh;p@{U>OP2NYG0V_h`krC&UzFK53YewW4tCLz~K}yAe7vj9t&o30)KecRGszp2)O(re$IL+ zTFc*{gB=R3l0c!5`xArP0!JG*7)Xp)xg(CFiId6ztZ9+lf*m;#X?Sd+9!5^XepPlm z*BBRwM;+;Lnu&1cW$STl2=-bVP+bvO?VH`;75SKt@9gK zP=cW+lc`mCkoPcV_vszRmD@ex;T!wypI}$sw zSGkxS?#QQ--pnkXWY5NRFV5JZXxqG^`-*(f^#8A^j*cg=Q%EwvQ`n(iguOCU;vEN- zU@zIu0Stu`e?$pkytDqWx9in z*8g$Cq2g$-73Ta+OPoY!HRt5%7`zn?w&ua|(q`eHe*@sk&k`J?f3S72vLk}OA5cI5 zg*}x#yD71X0Gc@0j*;{@`>Ay{JS;HKi`ejso$^(&<{_@iN#8Q2QNO{J1{d~yo_1Pt>@V3Of?LefzId^#%f zyI?dh=n-Xd$mZBb8^9jWI4Ic0Yprv6TnmL0!a^CP#1Dv;TJIV0?1yu8+3rAtP#o?tr>?)Kz|DPY8472R0<|)qKOh0N-uY? zS&<-XyFRE!FFIs42kXNOVLG+K5iKBhV;cT%dqH%71kDgp)& zsgH%$$>utLqrN0_%%VK`;T9?hB)#ddsz`*2dmc9sm|w;-jCV@k;dgQ5m`sG9am$^N zZD7LSP||v>+9wG9AU6Z}%(dV<5jE4cLHkZ%)wx3X&AUmByS}`;)eFW@-42@?xiAs$ zUD#%yNQ&~RHEfPg1B)$?mBQw74TAIh`(0_S0jCS01)VNl+_IwgHLH@%qQh~!1 z0m1J#M%#181prie;{Iw`tcURn`FnB)u=|+MfosUgz+FYVBR`nS(3$e`9#cn0$fCW-{J- zKV70+l`gtvv@?pyCR?*Lt6sBYMFG-59y7P=SB=e znfRUiJj{hf^3dX+Nh}7xaD@Sn6Ca&T(u;o*fYu$urJ>lL!}}XwE0sQaf0?B>Lyt2} zVy#S4W}<1IVC(V+brX(#pBBmxQVOkZ=N~UORTS^?L5OVy4q>5yH34u8o5L4QqBNrX z!^UL!N5JFLNH!*Ei|~J=ECL)M_I!Sm2%9@WW|fvo&?u1v;jBW>IiM{R?6#etr_OVI zIQU&g6E1zW?kwuekEum?T%FjO7V1Q*h_LxLugHDNzqf$Q$Ae5xLa)JzWGHe{CZCQR zy1M;5&tk?0$|yGqfA>VKQl`K!O_QSX`$k4-0vCsQb9_!QwD9RjUu6!ie^~`!zxDX+ zf`K`#*U1MwJ(tgaiC~Ts6ug;b&hl+0412lNDn~fqdp!GdQ=2xB48v0l#V=e z-Zzy}H!z6qYkF0QIkQl*QW0Hwl;>%)y%oUdn#@N04uw9;0I2{h>Kksto%Gz=xnhgB z(YeZSjkYBO3BdYSv<0h};;DWjja)bq&Nr`_1N|zs3hw- zBNC#^WvvX>*R>2&{Jngq>f=lOCRO2GkFp!K7B#3-DVb;Dqk;iwzE<{dn~!|EcjC445>}()P{b< zz^8$<1M&7iz-aM5WDn6INCyA~X0J`n1P*oSK4CzvaFP42tD@&CoV$h|wupoLVU1mn zM$rgRiW7j@v+q{ib}?Hy6%sR)N!DCD2d>M=Vw8qZwpj7u_l8XhK(`7YN%?hUOcx5z3~@%eZ%$4vBxE_@q%u#}-1&pb$uV$*w=4)7;V|ZE5$An? z{9I;)2{=%L3P7i6YKN9$XLEdik#MMHU1S`PDU>vzxV1ANl`#~+Z7z948>~;zO@QH~ zQz`Ok=3%}-%mDYofnd6^5xE}vgClw1%oVuSe(y4S6ro{UJSJtz&cq9*;l328SEN0J ziREB3u>~nC3&n$^XmHnHao*#Xk3C>C6drl7{t7X8TVMt$0>gh7W2y;UfzHci5^E{A zAjoDwhU<$3Nf$+sDx)#@<{^$4RrO=IWjOsz6tKiD`|7ptclbNuMTurBxGQk;8EI=7 zP{QGVgCKjDSi>VyS%65N60zB!ZF-~Khd}XW<;qT)1{FR!9p&*4P%4py_sRs4A)>S^ zE@m-VKUc z!OHht{0<^eb_VU1#JXr9c77(D7hEdo+{6e*O$7S@*M{{GUMNIvWD$AqQ z&=#rOB=m@f09RTZ$vHXq+2f3{Tg&lO6GQca64!0=Aw5UE$l1pJSEU4%g$TpG9kKHIqV!5 zgeI`@2h{R>Z3Njj-G~4Lv*!?(VmAOFbH2j73`2+{U>f<1lxjT|;a-gfDPi=*#Pf9ldF&jevss!IsT^wf9EB1|385PE*HNG`qdf@G z1_m(bjwjzQW&azHfE|co3j-|^%=7{`4EHyFl}=C>HYA&4^3g?+i*I=b%s}}^8mB;l zh_!__{Zdy3=!|9@UW4(FrDYKrMZC?tZl~{q+CodO8-*y(hRh4hOK$GguBQ!f+tM?Z z`M3v{_ok4+;-Zr=Dzi1bPOQ39yGDpO^@@jVf$N6EX1)nkqCTNH#!vSt^@eyqAre-M z#C&S)u>XXeEKi}tDL~`T#6OgH#$g>>YhBZsNLr<9Zb0yh+-2C&Ar_5e3SJ_h#+$_= zmV4BVq4~PWPuncYsg;H|!n}|+cpyoIM774v zO^--5^f&-+{-;gsBT{H`)h7P&H7s@2!yT4Rk%lk|bb(1`V2F2t#L9DrR)aF&m)D{6 z*h~Y;W8X>Q8#;~v^rqD_q#p-Jx8Jb1!bs+VfewgnX`Rp0clH>+LJJEFLX&Z(9s?%% zQRO$<@Xc-+H6Ui1JKUym+-IFW&|OG!B#+gRl#z+)cx(k3OdM@aCyS$}OF$98TO?6_ z#;Mk^JQGrumPEUJ6Voflg1Q%H&UF7YFA3A78q?qTf2xXD*gn#OI_j0tEiU?!{O$}O zWj`g-VXyO9eZ8}k^C`V$c2(JQ={2~wt0nNC44eFvtO}(PCTm!q6}7$mWRE} zw!{JyaK*sQQc$>zr+Mk(A*dC%a}1f|g@+12-H$_gG3_80Sk-6uWY=;5|z`tFl0=f;#mvlGQ?zli^lD$F? z4C6mPY;}ZO!ghjx((8e3Wq!ob4Yvh2R}FF`%K4=VT-FoBtPwG{hl2|uJp#RTG!5kW z+dn9haS~>!qX0{xE@(jLur?H9`H5?dL0zIZT95I@J1-Z}>(q$Z-$R zgTrU<6Z)YW0)Efkr~;NL?7bK7rD#f~3iaa2oGV2|W;?|ByTi?Q;H6Cd((zGs?*{Q$ zqusfyzr098LnDxsBq(-oE~!X4oI|J+S_lteX$SyxV)05`L(MJShk!f)Sei_c$fz4y z{0hOQ7YeMa{Jn~oa2_EA+plYBfq@8;)`abAB-7HW7eP?IAoLL(fuVIJCMeTG?!4r$ zget<&RS@b5FuU`@EB3j}r(n-kLq%22p>bUgVaz?qKk9fOVu{EP-u}7yzJftMZiGg= zPDo7C9UVkE+XcDe_-clr*6u6RVmP3E0t<~wRJf#q-DHzwFhIG)Wx8ni@k30GP*DM|iyK_C#|&%$4$fe|X^3MP=RDL7}@U9SPeHP^N^^sb+1 zp9V2PcFt(@!BR_4!3Eksgk+W$yxv`LRVFeUHfV$v|Gz$m8G+0Y;KMtL7$C8sD&6A^ z8tt3^oyl$j9a`u{^a%e3wlpLpx}o~xJo6k3IAsLJ;0rFHy+=p7$G=cTy<>2ZLJ%Vw zh&s^MSO%6!AovQlBxTyI1!)bagEXAh#COP3Ga5GgI0E|EQKd9qYk8pG@EJMB5F#Ii z(?Zz7?-n5H1*R4AMOltZkSDu<`T+(YBfTzV(scN>_RL@AQ2z|k%$yh<9O^O%+V8H$p^x5B!&fqwM6W5HnQtZ%KgZtYJ;%-J0K`*@RNKb6 za)5XeBeyWXQX7bMpeB$(j!NVcJUvC$v^lklNjy;sn*rn15LkysA=j$g(w$pEBSLVkBB%Y88T_Bl_`FrHJ77>&`7rX90BsbvmY4IU3Ik@&d# z%V0^5Ss$(ec@&20WsU~UsdY+9r8`n&L4}b7D_!|ZNIF?#uzG?vZ&9QH2taFUa;U!) zpOopLPK<+Q2gz_+$(3+r(Is<7@|e>CBxI;{!w8eo0cxTh{@wKG1UN$!2ns5)0UiL` zS^ZJ)5peyp?GBBBF*FkE7F|35xS~-n6BFO}dnnw4UWgx2sQ|l$#kyW0O)N#s;Uh*| zBq}TXPIUZqvNQ-;&gm}{CS;h{G9Rz~#K^@VmI~y?PW@S+Bsvi^Q1QsarV|4NkOenG z+EwQX+zdIWNy2FjLjxNE0_x~>##mpRZP38KfcC8+Dk+IlBLT!>3HlPDT^PRuv#vR5 z;W~d@MG}Ja(g*~_Y`}dqie{ADK#J>}C)kdxy%WoW_3lEWpJ9`UK1P&|j*Pj2GCp zWO8?>j97(h8LiI1Fdak=rg+nF*6O7Q*-Lrtn}jy=mm??!+jXvgS}lbgqg!qHo(L5q zGnw$|r3yz`YrF|Ad6pj8!nvd{nc@)iIy2xJ3fg)d z;X;~y_gH9gr0i!OO-bO5xJUadI~D@^(*)GM85dI6=x`j^3T)idi0ST+0ZHy8e!Uew zAAn&6zXu95(GS12jO_}Eh>tLc_}5U3-GD4k6Y``J#UQCk{HX;)60)9Z53kunrzrXk z#FWflWssd;p@KC%(t9ig7xte~4F-jBIEQ>Q%xYxLyW(aav*v!r)YQuY6DY8U#_N@j z!q^OtWE{nwF}tm>Bko_+iRyxQ#u>ftBx#bmPU@1G*XHG4((<1qwqs3)v|2=Z93W^B>lK@N%1DWH4 zh-s>K6QbdX`{5=`X|U0dH8iO2L!8lTwZ5@G8LRCq07R^VY0X_96LH$gDf*#fC7 z*>*NZ#d$6hNI@Vnr~2GoDt(H}Td9 z#W+(W!}0*A3t{vR__%C4|h><<(a9k0mV89;2~y0GLbaWqfqb&Wdz+2 z3KG|Q9N3(hLI)18PI36QP$0m+oB}7zoK=gipwZ35Mh;wUPl5W9?igb(VyT3ff#^g0x^$1zxXFf!HQkK zS{puhkV&Ig{Nc*%cR(7`rnp9-8`s!kd}3fgASbXLHq zzATe?n}agP1VU6Md0b$;cBXcE9cL zVR4aVL`QsTXbZup5SGk+Wr>#~gv45ic1M~gy+@flV56X0T5vuO>3d#i*x44r;fBGWnXCgZ3w))l+TvRFz}E-@;kRK zoigNz#0I2Hp_bTx1F_l5jZz64O~lS1P(WMWYSqKy^>86z9$jj&NP;0v^krWlV2lDa zP)$LNhM)yw-Z@FZ&jhPn_K}kk7NtaQTMLI*fkKFk*aH0la&yH3TI*q9T~3T_;;Z1Y z+t*=2kKrg5fZVHPu=(nkezaBSUU)z>3|Fc`_?=El@VefO=oo!#-O*%@N=lG=0J@+x zqR5msA@8Z}2t#rRsTFu+X>W@II`HJr3KsRvHSa8Cte4vW%zrVOWb$(gIya=L&F$o8 zC!W)pomoa``&sOPNNy)jWAuZ?Rn%oh!j=Lkb>4hg*+KkM6IiJPh%is>)uF2#S2@}I zC)f9Fwm<%b41e=g!jkwC>*Hj*LPdKyL|oQ*K~DOA6erODf?pG%!i`9Ev{G_4KG-z55hx3fZ+5}ux zFll&T+^*}r;D#@5E_TJGY{}FywEI5_<gk-VGiT)19+e5*NrCbeBIB}VH$^_t0a~>~ zjTLN?6QB}6UB2u@JG%2%H!9(dsA_mf^+gn0)Jdgh;*=@P?aGNXsLTneKH&8AIwx8} zPiEIK;(Xd9%UyTw%bNqwQp9dR@lAY=E=_w>b_JZYYy?BicG)gTXLb^MH(wyr(xVwiY5GrR^@E#4%k`@6b9;KCHZZ z%L?u_GUh+{HCeE#LOvoSNMb+~aAnpUfvf!mZfG}eWeau!ARQ1TjWEb8dkAp39Vj~U zv@iG5SJew&N^U1T(A+vFra=^5vu2PrEM!F6TUH}CoL6JJZcM2#mC?`?XOy`@g)wL5 zKteUGP|MIw*v4}(AQ()W033j#<$fR)qHJ+JC5vlZwg>X zD_$6PGfZir)_HHmiaBCg4}{=Z6jOaWzLqhEi4eguCgSCnrqG0wgwkGg8&Y13uzZDN z#*>x?-GL|;`zd%;0YvDoArwX`WKaa#Rx8dVrbIP~RV6UPt-Cnt>|lp53j8Tr@fshj z@l7;VkOrIjJ`Gw^xsa&sS_)x;0c)Qi5k%+ds3yD$Bf#3c>MM?6fiA+19}qV*hiFgG zt0D4Fz=E)~Kg6+=(-{WUX(TkALind7oaCB#Yea=&TcAKDj@j5}@WE42@&fFrUg&=Y zymO9hZh!_3`Jm&_bFz{+Ym%+~jJE}KoP&fWh9{OYUVA&h0L%n|X^!?3kRZeNcv|ZN z?lr6BvY@e{w^7Zst)uFD>Kop?J#{8%t0xUE8)5DgL{V`|a-epGv(n-Pq*F|(>>0NK z>f%sQQiXmM7F7W&B(Rd8P8lYmaS23{uO+NYkda|K6kBPt}dP~TV`5-bc z2sk3(hh$&~q!HdAbcAFdkXRhNJgjhlc~JNf)FY_IE*O|*V9OD?15Jj2400KoH0WjV zp9Z28gk1q~1j!ICB)~&(kO2Y$H3-uWTpXk`NMvC7Ln4MJ40Ippe!-$cfQ2v#LKDm= z&`_YDK@);zg4PDO3WOC1Ens|rssL&N><9P?;5C3LK(zsD0=@?T2pj$Xj{m!S>;D7& z|L{IieNpqEupdodiF~W@|1tRQ@muAWsJ?#vX!z*%yTG4P{5E=f;iJZ7(0Ajn@T#4z4zC7QD2%3Ff)Ocg-i0?QXz&0ASR~&F~(D z4+FO)zwl+Ru{)gF&e(R9ye*gahqMOOdS_{`p&TZbN3} zO4>MqZ5rdExMe&rj;N5jxiq|QdR&K4@n$r5YVhF7^ggha6Y%&gcSaJzeSVDx4g+gLDYO6l@O(c_MRFWi2fFL0*d2lr) z8n#&-XQxbsNQp1-1>ZE|25lV(ItxN336wT|AOUA~<$G#-Lm;EUflWQ2PaKt!V0)2@ zjJ^F|+4&{1156y1XVhq>2He_=DqEeIy1hpzgCD+R&0^9)0J$9*>C2In3%|&ElmRjaUw6#F0}I9dQeSkV z^RzLX`Af@FJ2@Woj(}VlLHkjbhA`x+CcA>^#@fP__w;dyboTg56DwFGCb^;j5X8cR zLI{`Gb#h_5wKMp3fnJO4ppzx@>y2a(Io#{*0K_;QW;p`_@ys!fAt{OENE;VuFUsbC z40h0pe4(G)dKLkoLJvYaa^3p$CM(sf4-6kw&$s8>k>#d3MdQwty-GY+EW*B82yv!H z8Fn=-o&)#nl90Ts0VOSU&X&>=kMHhvbI0fY{(po}wG&vZJ1Jm_MJ znZg=Dkqpd@MdosKGVTZb?tb%;6?47t(q~qaF@Efi<-zN6t1FL;l|p`+*eXW$PP8xU zwWe{O_Xtuc+^SR3q|qm4G$l~R@qD`i7bMI(4}Xz8p=K+^y_=BS%Lg9Q6@x9R42G{_ z3ujo$F#cfmIf!D-V!92kt)M)q0D%-tAve2&X~N~C(5xJOS!o9sX5A#7=E-d828}6u zEb|K&T5zgCoJb4p$9EH%f$C+G{LUH~tv){r`^C=p-iX<)ZyiuM4Ejlj;Qv_AJ(c<1^(u_O? z!9h&{iHbJXecG1W(?@=BXRrQfFq_r>Ns)O5dSc{+eKeE=LOWeoQOS>{1I3Ae^qV~& zMVyz(&kg>Lss1J>_F3JQ!_(JMF8oZMFC>f!8((o%fP?>WM~N{K#TOxx2Vhi)P6SnG z)VYfB8mattOu)u&z%DmUTfB(}1hry-W*%Yg>w+FF)KGK#rMv?{gx4!L8ZvRY&?8aA z;?n6XbgqHq_MOB=vo=uJ@dBJizk1;t-NhFZbHOU^dIl=QTGU~9L~Nxz!`v4c?YE}^ z4+HBd(|2gGF>P2X@V2WdAP`hl5OzNW-tpn--;vOvJ>heyF11A#Oo;gW?0Uow;-T@b z87P-Fkc% z~9spB&5E0V2-wEC_4B>(&?nod9X8@&nMmf`& zo$*$@gQu^K+>qXKi|&%C5CBQn7X`%)XlLO0#_N}~Ut#AR2aZTmd*lP))3~cX>ZY-5 z)zaJ>3=Mgmg{PR(r*IL{;-cKyzQcsI%^R(R*z=GO28L`>2+IhR4ekE+4 zM+Gjxzqe4kWU~R-5>VMZT-3ZM(po&(PI(v(&1dv(86XaN;BvHm}^fU38+P=hf%-Z4PrXG}u{ z^{g=)0^+lVS>{0*NjXNV8&_q+Y)FC5rw3J)qxWAWsHWI1Q7czoL5fLjuNaLok>pJ0 zQivnSZfgD;R3V$T#E<_`Og=^fL87?6@mL~$cPHC8+zk`RkkHzqC2ee!6OOT25}?Au z8lo5|NxX-eBv?+_Jl(h9D~;e6g@3JwzU4b}rUS0FtbaUHZZ$m{NtvL!ESZJHISL z#$q3276qW>>e0K9BC6Lm!PDcC*mJ>96;}jV-`)zxB`?jOs*Xw=t0)s{mG?QRw~8qt zfu=rKWTTDPq=!y;1b*tE3H@nBXu_aSH~}ouMp}xlRsiQy|?8 z+=eFuOFpAznJa$ z9HP}Oq&hZZjUr$CB~(eAM!iJ*;=b?Yrx6h>^|H)MP==A9VPv1#j0hS{CaVQ1a0U*_ zOPt|Q3|tBH4>cTq2$K@~xI!3~L_nbiL8%UpJy?`vZOB>f8|q^o(U}ch?lcb}gFn9* z1|~O!l8`0`5O(Y2Oh~*GnI51ZmY26LDazLJ5qc&Ez{Mb8VGH2izKeuw*Z=?k00000 E0QL`y%>V!Z literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/fonts/fontawesome-webfont.svg b/docs/theme/mkdocs/fonts/fontawesome-webfont.svg new file mode 100755 index 0000000000..45fdf33830 --- /dev/null +++ b/docs/theme/mkdocs/fonts/fontawesome-webfont.svg @@ -0,0 +1,414 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/theme/mkdocs/fonts/fontawesome-webfont.ttf b/docs/theme/mkdocs/fonts/fontawesome-webfont.ttf new file mode 100755 index 0000000000000000000000000000000000000000..e89738de5eaf8fca33a2f2cdc5cb4929caa62b71 GIT binary patch literal 80652 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 qx{Kk=rVu5YQ9XR<GPS>b$X_& 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 z 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
V$fDV|Iw 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

!oRptb@n+ zj;Sj1EzP&rTH|dsUF5T#cGro6G4AR2oYP4A6C$$HZsMhb-}MgVJ|9Df9nr7lJz}vl z148Mpnh9;=>i)2Bv@-|m)b&vQU&MMd0hk@(3OOg^&bfmPD_5YKI;h1GgnmUyKMvNS z*Dl@jFEe{GgQYV82Q5l}U@Y#R&i56es!fO#KF~6>m8^j5_VYi$aL3MIurDD=iV!Y# zw)C$KqzsWw6ml!_bkB58+Pnr)j72yJ19dZ;QpeC@=Ysqc6~m1XlxJ}t=Y?#A9ovZP z4*s&io?KSB=5X_Mq0Qr!nZ-97Pc{p8>NN2hw6L1$?|*wdwE()u@GV+8cRmVu4i|nF z2YCia`{H&dzX+@+F~z3}&2HZ~A$J#(3rizQU8HeGveHLO?>XOiq=P#{F`>io&|}#} z+qQJb#$=b8bg=Ps!{v58DK!Z#EWBz+L4AD9zp%|)i>xTf3e{0+~^1&1o6#K zwr3ZRDa!hJPfU|eB7lm6qeNDi)%|oq=$rtSjhii9m6^WZH{st=9fQ#dhr52sEKcDV z){U(4C-G#*1B4TJGjp`CK?-PIECS&zl`y!FXqtN(X=qEa*gBq3^TFm}Cpj!nLubX7V)$@?A?AU0HyDi|)^#d;oP?m&OB|M4~*^s!BC_{@R=DqVy`) z^iz3jFK^wAHbnd?@;r6FdFZxmHA=CJY>9NY7`vW2a@8_3y<&DFpgBkW@T`=eFK8oO zT(y#eS}lrO`ZBfcPaK>$9u2=+_Mtg1J;2yBN4^5}D8XEx0WdGci3PQk{1UaBgCLjA8J&l$QM)18CRi~T;S54ZH(@Xo~$ZF&Js?~!|%D|ZX{Jj z*pc-L3P~#WkVf!P51DxQ^K}CDD=Y?hNA?;=vpqJIB;E8gGMv4?>|>Zb{znXRL*?)Qk_|}2j?T(SeEif3wmvZ0!0BKWR*&#M-@We+n zd!Y-D_)%BP<+!zHM-WgMA-<|E26O*5#V&wF-H?7K{bi0t!Ja@<#T11p`z7kR9bL^I zxiX|bgk@gG;U~e3#Vwfd>bW+G#e;04x)I0s4A&VgI(Fju_0T|cY>fvK^f~+n#M)-I zKA?@0B{P@33F-*DS_^ETL0XcaOIRdDW5V4B_zY`Nd?M#7>oeG!Z^6Ba-dCk{J;lsy ziiSUhyO+>s{C7)Dns`2Rf*jY`gHkmU5gRa2MLAKjTZu0mAO#oAut#vEzYF_C!?|MG zQb|RYeITrDng~^K9yR@$=Tu)pB6?55gtAr{5~EPTj*pnXeR>Z%m;6GME0_TE(4-rw zME3E8f@iqWlgt=}U9DMBcpA3%b9qbF|E~5M9NWd;*ghbr%TH)&^)5!yC%XZ`v?wJT zr0zUE{g^+XtUw(UkwXI0C z{Oks!jZS1P^C2&m%)dTuRCl66MJ9OSvo;iOkk@*49_fS4UK2sIg}$oN5`T)WV_j~$ z#*y;(_hW2|toQ1WCxQ6-vCr-?6*3i$CB?T(Iy(Uu4B{Jjn3Fs5)HYKiwn<7UMvAhM ztl~cib)k*j3wl0-&k>Du))lCI$!YL3LpY?I>g)lzF_iS&;YrENcF9RH%gj>X+UNtpO7cW z=y9bt%UHUm14b%KvB>fmkT=b_ zigd)xBgK2#{h33=bql4K;;83zkU~UB12jdN28+Nt#W^PWf(SsT=lZwNXYAXwH8p+D z2T-wD1`6V}x`JJU5)g?l{KfbY3U{K*jkF9_;!&pOj7b7b<4O5g2XbEfm_g;#Ldp;i zD-*QR?1x>UX&lEA{7w}jiYCK zu00NA=#@FmB`CEgOPGL>*m* z6L!@dqJzFD(40JE-qoB9C0HFL3|4tOJ91pPVZFhw7eu;Rz0}w$sh&XNz#XOq2TvIr zi{~9k7L7M7L#!M~crc`I6W5)r$aG3}pV7pj%;E`lEP-KW&v?w!L}n}ma35b;S~Q7u zWn6QD1W4v?bv$l;!Bx=gbOuF)QJieN_M$nWNG4939a7d{0~7Bj<(#O7(pw&_f1Hi_ z;$$f3(K$+laQ-ssV9rcZ7sUxH?h(ODxMpu8`~q0R@3V<5ZUR7N0B>X7i^k1P11+>c z0#{3cU70M%f?eOzWe+MNx@4`O6KfNE}>-%Ay*gOP`j%nlT#j2qpj#O3UrUg4^id>oy3kT*kQp^XA&x9M7QbcQ+v;w05OGe_zv}@RU3qi z$Z4ZBchBcVa$fo1DFN}YOT80bTTwDSQdcHnV+giyD-Lt zKm&qZyc%9CTM%PKoN%g{XgsPsNM}kO0}&4>JwWdya=9)5Ash~^0(uV>M^ySibGCwz z5$PN+Ml%p$>JJ^#x6tLs0KGyLupO&M$44kv!@+P4tPv-(Q) znW!s-B&%k8 zp97OXN@#wwog-#6l6D~%M86snd|3)a+4OKr(u$6rle32G24##}>NW&kj7TOs3VXJL zc4+@7K%h<|@DEF@-){fDoU^iaDFf32}t$^lA zpl+iL|J2M+g9i#^{QP|PQi<;e0S?)xbB1g1_`<>Y)*w#P&y}I!c21Uq3LcPcH;4bqI0F zG%ZQswtudr3r3w}tQ`@KXB^ZxMGFdmidyI|W43A#-3$(6N2%hin*4IsSIG5R3xLv0o-OG?OH@C^*jHSMd|)m^=k z8q!UF2K{Nd9S!5tX!S5^0(g18+nY#vy3{(tRE6@P4?zeK<>TM)kmGd_VPnQA7kRXf zk$~)TlH+gOn7m=j2vbKXB-!=9II_qaR7Fbv(Ms=PC#2#w`w#W z=rj4$Sqg431ZfI;P81F=%2aAK&1MMC_yLxuW9PMtShb@O%)R9~IY2N4HjJUXmwXHl z=J7qh5e!n|i23lJ3Aori$qjbqY+@PGGUPbj6mN#$9u42-kWv1HK)Xf*7du4zI&Ap; z+W-ZUfh=WXWVbD>z!yT90&Ktv@`?P+^ljzwm*P~Gn%)O?gB56rc2k8*yqZ4@7nX_L)j_!4bYw280A2s4z^0{)=R3vJz7Qz(N>0jX`Il$M5BbQk_^? zmb=2DwO)gQyg->t3JD)mBx;B)gI6cNIfElwxl5wF%+%+FNg$PFXf~%ubeSK6L2;*k z-ZS~l5;+l-wl6{w7Dyq}{-FV>Nn6E;24mwA6(n)DhTzooXGRi@WQFLUlc&&iO=I^T zivywJNawc^=E=0XFqsVRR01*cO<5HEij|eEmVK8g?IfsAJNmq~EgQff zwRv%UW^p&6vzpem6AVaGtc3Q>G5wiRktPK3ep>JKPbd%NiVnQsT{NC%oJLL-qJ!8- zP-h)BwRyVw&H(-~!h9FwJlK~Tt)s~GW9=N{%H zkHahpK^rHdVncAWv!My;Py*&Okv>@=Pj<^*TyrRLzrxUph})=cnGJ9$3I}j$lr?}= zz=2t)jatn_^K@B=I_NPS=#K1BtCqqQnsGNTQfmt49zY^Or3XLIkcNQ*9`Dm{tm+te zGzr-e8FMH~?kI6@V_qIbW6`2CEQp*Gn9!4LSZEWt8?F-u?T9E8^I{i=*dP+gY2|H` zMGdiKCZIJ#i3pZ4sls`onRd=e0U%n#Ca`${WrC4WU~lwxS=8N0NZz6!0k>0lr7=-Wgf`_F=oh+|pA(=&dOHWYHAe`np>Wv*)f@;~V6i<7s3mijc zZ4@C`gzXJ?yt*=6ewBc>XeQn}>W!UeP|~t^p?bStnK{#S5dlPbxd9>u#Kz1>gvttK zd3?&C7ALU8TXCu$a(pA?no^B&vR|6~ij}sirp*p(@KQZ_I24%eSY5CJm0AN|Z&CLzOTfN7OG#0F=>!FqSk3<=Di4`u1Z0Ib8selOlzIIm3id zjw-_NQX_~=kIB1OdIh4uG&6)a$uAeQ-?@5aMkFz+U%>fER>c2C))6vM$q`s74=$Kg ziBjcvbZ75zzxgoHpoIECg8=M24@g-g`GL-3<#WPqoB05WJPdl z87W0Pv(0o1vBq6^KzM1C(IlMdk&y!2xc`xZBy4 zbk(td%vXIm4b=}{q%u%bFrCz%#{%S}5bPliB~ozxLV*SG38`@jJQSBCAc+;i@e`;N zt0M8yifw!cxT+TeLU39XDrBSe#GhY&)-T|b;$R9NG^AMHI2^Lq9 zN)VG}(M5cuIe|8Czv84=B1p?kNhb&-+kCJ~Cp@^WbcRlQNgg+8V1=ctJWBX)kq0fd zAfF&H0wQim;D^RNLt*)8>Blbt34>^ZniMi^9|qnB%ES;E!kSQ!IK8Y>A1x=m76zre zZ2g#{aC_l);B}ZbGf3Y$5Pf?Ha!#0t3<5F`ED$p<#rl0e5CFtqc!!Oi7M~UH7I8~> zKcNUu8%}Z~Bb?-HK-;xoKCjL8>_&0cLO;{MS&3$vA|)_!KSn*s%ug690fdLcraD7- fD&x8tjE$WbXjs&snU8)|^B;s6yTptcKAzx$Qp3K0 literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.svg b/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.svg new file mode 100644 index 0000000000..e3e2dc739d --- /dev/null +++ b/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.svg @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.ttf b/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.ttf new file mode 100644 index 0000000000000000000000000000000000000000..67fa00bf83801d2fa568546b982c80d27f6ef74e GIT binary patch literal 41280 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

PBK;&Wcg|NX{>QR@W3{K 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 literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.woff b/docs/theme/mkdocs/fonts/glyphicons-halflings-regular.woff new file mode 100644 index 0000000000000000000000000000000000000000..8c54182aa5d4d1ab3c9171976b615c1dcb1dc187 GIT binary patch literal 23320 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 mX4Rts +

 + \ No newline at end of file diff --git a/docs/theme/mkdocs/img/docs_nav_menu_arrow_1x.png b/docs/theme/mkdocs/img/docs_nav_menu_arrow_1x.png new file mode 100644 index 0000000000000000000000000000000000000000..9c209dd5ecd3d1b7b9731fee65b9bdbc9ee5999e GIT binary patch literal 481 zcmV<70UrK|P)2Igu-_F-hNE-M3ZLsx6?P<>2}gI&98HA;l@X8qQ+Ep zR;^U?kz-XIa9W7!q1vl%fbq7fH5=HK1U*p?cduuv4QRq6!yd1|=q$mZg**}59ugrt zQ0P8OFea=m3A7BOGrhLO(}A;smIM_)3R(u6>+p4~8We_GmvMcGfjgfulhqfulg9Jp9hnn@^86)YB|rFF%Gr zi{r)DiVs;hGsBcji{r=LgjjgR2A)}V=YX-=-RB|&!Pd;8qrkF&X|RZHjRo6og$LCY z-CnX_d(Zi#Bv@32e^h@lU=hHmx0v^FuapEk1~>_9C~z{^5a6V+LyL~mkPi(h3Dy@l z8(1GpEbV|K3)pYK(N1#^mdFye4>()ccfeW0zIqr1d$r~p4%-Dz_6s1y62-u_@f2VH X5?YvSp~f|!00000NkvXXu0mjf70J;+ literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/img/favicon.png b/docs/theme/mkdocs/img/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..ee01a5ee8a9ea542f17123ed9c587510a2e26aef GIT binary patch literal 1475 zcmV;!1w8tRP)+(fofHYbct z7*K_dWFwmr35jN}Fd7pRjiT8b<4YG~_HK!0x)@EIj7*}LWu##SsR%e!jR>VYCg?1bo3s&Wq=Fp7Z;D&i6dO=Q)oO5$YSi5ceL*k{DJLkk$3kJZT{rY7j31U11z*grKSiAPVO#SF|u>ah6@nZo* znTD^7uUP$^M8L03ldH=i=`1QNGc`F*ICULuG|ln+1|;`C`=jEjri~lctbC@g|HP$_ zj?Y;I)}+EjX{>WtZLr$lY=YAo=LcY8M8J6|H&>1gO-+qaN7s(2ZQoio)wT6!yOi?h zbzuGGXF9dmywX;@Tzk7Xhtmde4kdzk0V=X!6P%wyDTRqD3pQ@qvJ!l(qkOP;-{8L! z78bPFTyt}r&JlKP+I;58zV$y;>Muo*pNLd$0VuXDeyP~;>21zh(&duM8y}ZSV{A;R zR3xz$6PC$pL#8f=PGYL9_ia75JvK>4YqgJ?qm56&%Auo7T6%8qx!s#)Ac%PXjIw{&`Lv)Au$G*L?lWfnJflDdp=P^ zlS)z`5_l{pFGM=jERQC%@F06h26GQ8Fd~&kzz?Z$S)Z}g7 zzTM*#7IPmD3)rAQ?a!SxZEhE85-A2|4fgT1|fRF6Hk^V`?%|LiwY>8$w3 z!YGri6TnL%w4XwZhl(Q-XK}_uJBtTMkU}|!3o9gk3I+JpQm93Z2%-tn4YF`)<3w90 zm%}Q{_P=@}J302IUoHKkb@*i8?~e`)19)PBO&3>gTDqX6Ku&vzOKRJJ0&YAj)UGXx z7-ro0PaGgoI)&C9|B6mWRYodhnlB8{e)j0@zPI0c>((kza>Rs{o}^kve1GQoQL_}) zZ8oJ)z+@D1rCLTQ#lpeA9r*fzKkc9Gb}uz~^+@LYX~ruNrF6hY+@p9X_BfGyOVrKWNI5X3W-lNpG6vQJRZh7& zu7q}WZ&WQRQH)fpU>z8r=FzhhPQUYFUvKZxxeU{9oH#Moa&_o8>9B+g6C4_+J)F`= z9MkMV9vT^-T_*?%rEch2qm+WgBGYB0TmdKG1vE}wrt{Rnm;btN&rjzP2T&rymUZje zFD-lQkk|34&IG~p42`~~BV*{Nke6%{6Vn7+OcqvUKp! zkH5R;weQbm{Y?M>PdwHA_~)M9`et{}=2p)bQmGWp`38PBJjILs!zis#2v}DWwzjrf zsJ$zUArns1cH!?Mi!UDE{pWpeyf&ZkEdT(^*KB-rL(dmpdFu1sj}{geYI`J(R|dxT z<$Gf@Gt^AipcEQMU8P9V=(+Kh(KEkpzxeJ;e>n8+h1(Io1)!E+WjB6t=L-)$vg)fH zot+OaDir*DLzcHcDDkV)S1E=uei9Oti)6~zuho~Xp3F~N-nVFEaPQv3htJ=x@SFfQ zfcTw{tX|%}Wa-1Xy6mRFsCC82R;Qz6zi*@Cb=A^PS dzXxy+;Gc5Vg6*aX&Q$;a002ovPDHLkV1knE)4Biv literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/img/logo.png b/docs/theme/mkdocs/img/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..dce5155683639c0d5c6160f9d2170d670da94192 GIT binary patch literal 13924 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 IT4fCOKM4~1IsgCw literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/img/social/docker_social_logos.png b/docs/theme/mkdocs/img/social/docker_social_logos.png new file mode 100644 index 0000000000000000000000000000000000000000..5bde45636554609d2b3522f5f6d3e5d8ed32458e GIT binary patch literal 3130 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 + + + +Layer 1 + + + + + + + + + + + + + + + diff --git a/docs/theme/mkdocs/js/base.js b/docs/theme/mkdocs/js/base.js new file mode 100644 index 0000000000..f0ee5edb12 --- /dev/null +++ b/docs/theme/mkdocs/js/base.js @@ -0,0 +1,80 @@ +$(document).ready(function () +{ + + // Tipue Search activation + $('#tipue_search_input').tipuesearch({ + 'mode': 'json', + 'contentLocation': '/search_content.json' + }); + + prettyPrint(); + + // Resizing + resizeMenuDropdown(); + checkToScrollTOC(); + $(window).resize(function() { + if(this.resizeTO) + { + clearTimeout(this.resizeTO); + } + this.resizeTO = setTimeout(function () + { + resizeMenuDropdown(); + checkToScrollTOC(); + }, 500); + }); + + /* Auto scroll */ + $('#nav_menu').scrollToFixed({ + dontSetWidth: true, + }); + + /* Toggle TOC view for Mobile */ + $('#toc_table').on('click', function () + { + if ( $(window).width() <= 991 ) + { + $('#toc_table > #toc_navigation').slideToggle(); + } + }) + + /* Follow TOC links (ScrollSpy) */ + $('body').scrollspy({ + target: '#toc_table', + }); + + /* Prevent disabled link clicks */ + $("li.disabled a").click(function () + { + event.preventDefault(); + }); + +}); + +function resizeMenuDropdown () +{ + $('.dd_menu > .dd_submenu').css("max-height", ($('body').height() - 160) + 'px'); +} + +// https://github.com/bigspotteddog/ScrollToFixed +function checkToScrollTOC () +{ + if ( $(window).width() >= 768 ) + { + if ( ($('#toc_table').height() + 100) >= $(window).height() ) + { + $('#toc_table').trigger('detach.ScrollToFixed'); + $('#toc_navigation > li.active').removeClass('active'); + } + else + { + $('#toc_table').scrollToFixed({ + marginTop: $('#nav_menu').height() + 14, + limit: function () { return $('#footer').offset().top - 450; }, + zIndex: 1, + minWidth: 768, + removeOffsets: true, + }); + } + } +} \ No newline at end of file diff --git a/docs/theme/mkdocs/js/bootstrap-3.0.3.min.js b/docs/theme/mkdocs/js/bootstrap-3.0.3.min.js new file mode 100644 index 0000000000..1a6258efcb --- /dev/null +++ b/docs/theme/mkdocs/js/bootstrap-3.0.3.min.js @@ -0,0 +1,7 @@ +/*! + * Bootstrap v3.0.3 (http://getbootstrap.com) + * Copyright 2013 Twitter, Inc. + * Licensed under http://www.apache.org/licenses/LICENSE-2.0 + */ + +if("undefined"==typeof jQuery)throw new Error("Bootstrap requires jQuery");+function(a){"use strict";function b(){var a=document.createElement("bootstrap"),b={WebkitTransition:"webkitTransitionEnd",MozTransition:"transitionend",OTransition:"oTransitionEnd otransitionend",transition:"transitionend"};for(var c in b)if(void 0!==a.style[c])return{end:b[c]}}a.fn.emulateTransitionEnd=function(b){var c=!1,d=this;a(this).one(a.support.transition.end,function(){c=!0});var e=function(){c||a(d).trigger(a.support.transition.end)};return setTimeout(e,b),this},a(function(){a.support.transition=b()})}(jQuery),+function(a){"use strict";var b='[data-dismiss="alert"]',c=function(c){a(c).on("click",b,this.close)};c.prototype.close=function(b){function c(){f.trigger("closed.bs.alert").remove()}var d=a(this),e=d.attr("data-target");e||(e=d.attr("href"),e=e&&e.replace(/.*(?=#[^\s]*$)/,""));var f=a(e);b&&b.preventDefault(),f.length||(f=d.hasClass("alert")?d:d.parent()),f.trigger(b=a.Event("close.bs.alert")),b.isDefaultPrevented()||(f.removeClass("in"),a.support.transition&&f.hasClass("fade")?f.one(a.support.transition.end,c).emulateTransitionEnd(150):c())};var d=a.fn.alert;a.fn.alert=function(b){return this.each(function(){var d=a(this),e=d.data("bs.alert");e||d.data("bs.alert",e=new c(this)),"string"==typeof b&&e[b].call(d)})},a.fn.alert.Constructor=c,a.fn.alert.noConflict=function(){return a.fn.alert=d,this},a(document).on("click.bs.alert.data-api",b,c.prototype.close)}(jQuery),+function(a){"use strict";var b=function(c,d){this.$element=a(c),this.options=a.extend({},b.DEFAULTS,d)};b.DEFAULTS={loadingText:"loading..."},b.prototype.setState=function(a){var b="disabled",c=this.$element,d=c.is("input")?"val":"html",e=c.data();a+="Text",e.resetText||c.data("resetText",c[d]()),c[d](e[a]||this.options[a]),setTimeout(function(){"loadingText"==a?c.addClass(b).attr(b,b):c.removeClass(b).removeAttr(b)},0)},b.prototype.toggle=function(){var a=this.$element.closest('[data-toggle="buttons"]'),b=!0;if(a.length){var c=this.$element.find("input");"radio"===c.prop("type")&&(c.prop("checked")&&this.$element.hasClass("active")?b=!1:a.find(".active").removeClass("active")),b&&c.prop("checked",!this.$element.hasClass("active")).trigger("change")}b&&this.$element.toggleClass("active")};var c=a.fn.button;a.fn.button=function(c){return this.each(function(){var d=a(this),e=d.data("bs.button"),f="object"==typeof c&&c;e||d.data("bs.button",e=new b(this,f)),"toggle"==c?e.toggle():c&&e.setState(c)})},a.fn.button.Constructor=b,a.fn.button.noConflict=function(){return a.fn.button=c,this},a(document).on("click.bs.button.data-api","[data-toggle^=button]",function(b){var c=a(b.target);c.hasClass("btn")||(c=c.closest(".btn")),c.button("toggle"),b.preventDefault()})}(jQuery),+function(a){"use strict";var b=function(b,c){this.$element=a(b),this.$indicators=this.$element.find(".carousel-indicators"),this.options=c,this.paused=this.sliding=this.interval=this.$active=this.$items=null,"hover"==this.options.pause&&this.$element.on("mouseenter",a.proxy(this.pause,this)).on("mouseleave",a.proxy(this.cycle,this))};b.DEFAULTS={interval:5e3,pause:"hover",wrap:!0},b.prototype.cycle=function(b){return b||(this.paused=!1),this.interval&&clearInterval(this.interval),this.options.interval&&!this.paused&&(this.interval=setInterval(a.proxy(this.next,this),this.options.interval)),this},b.prototype.getActiveIndex=function(){return this.$active=this.$element.find(".item.active"),this.$items=this.$active.parent().children(),this.$items.index(this.$active)},b.prototype.to=function(b){var c=this,d=this.getActiveIndex();return b>this.$items.length-1||0>b?void 0:this.sliding?this.$element.one("slid.bs.carousel",function(){c.to(b)}):d==b?this.pause().cycle():this.slide(b>d?"next":"prev",a(this.$items[b]))},b.prototype.pause=function(b){return b||(this.paused=!0),this.$element.find(".next, .prev").length&&a.support.transition.end&&(this.$element.trigger(a.support.transition.end),this.cycle(!0)),this.interval=clearInterval(this.interval),this},b.prototype.next=function(){return this.sliding?void 0:this.slide("next")},b.prototype.prev=function(){return this.sliding?void 0:this.slide("prev")},b.prototype.slide=function(b,c){var d=this.$element.find(".item.active"),e=c||d[b](),f=this.interval,g="next"==b?"left":"right",h="next"==b?"first":"last",i=this;if(!e.length){if(!this.options.wrap)return;e=this.$element.find(".item")[h]()}this.sliding=!0,f&&this.pause();var j=a.Event("slide.bs.carousel",{relatedTarget:e[0],direction:g});if(!e.hasClass("active")){if(this.$indicators.length&&(this.$indicators.find(".active").removeClass("active"),this.$element.one("slid.bs.carousel",function(){var b=a(i.$indicators.children()[i.getActiveIndex()]);b&&b.addClass("active")})),a.support.transition&&this.$element.hasClass("slide")){if(this.$element.trigger(j),j.isDefaultPrevented())return;e.addClass(b),e[0].offsetWidth,d.addClass(g),e.addClass(g),d.one(a.support.transition.end,function(){e.removeClass([b,g].join(" ")).addClass("active"),d.removeClass(["active",g].join(" ")),i.sliding=!1,setTimeout(function(){i.$element.trigger("slid.bs.carousel")},0)}).emulateTransitionEnd(600)}else{if(this.$element.trigger(j),j.isDefaultPrevented())return;d.removeClass("active"),e.addClass("active"),this.sliding=!1,this.$element.trigger("slid.bs.carousel")}return f&&this.cycle(),this}};var c=a.fn.carousel;a.fn.carousel=function(c){return this.each(function(){var d=a(this),e=d.data("bs.carousel"),f=a.extend({},b.DEFAULTS,d.data(),"object"==typeof c&&c),g="string"==typeof c?c:f.slide;e||d.data("bs.carousel",e=new b(this,f)),"number"==typeof c?e.to(c):g?e[g]():f.interval&&e.pause().cycle()})},a.fn.carousel.Constructor=b,a.fn.carousel.noConflict=function(){return a.fn.carousel=c,this},a(document).on("click.bs.carousel.data-api","[data-slide], [data-slide-to]",function(b){var c,d=a(this),e=a(d.attr("data-target")||(c=d.attr("href"))&&c.replace(/.*(?=#[^\s]+$)/,"")),f=a.extend({},e.data(),d.data()),g=d.attr("data-slide-to");g&&(f.interval=!1),e.carousel(f),(g=d.attr("data-slide-to"))&&e.data("bs.carousel").to(g),b.preventDefault()}),a(window).on("load",function(){a('[data-ride="carousel"]').each(function(){var b=a(this);b.carousel(b.data())})})}(jQuery),+function(a){"use strict";var b=function(c,d){this.$element=a(c),this.options=a.extend({},b.DEFAULTS,d),this.transitioning=null,this.options.parent&&(this.$parent=a(this.options.parent)),this.options.toggle&&this.toggle()};b.DEFAULTS={toggle:!0},b.prototype.dimension=function(){var a=this.$element.hasClass("width");return a?"width":"height"},b.prototype.show=function(){if(!this.transitioning&&!this.$element.hasClass("in")){var b=a.Event("show.bs.collapse");if(this.$element.trigger(b),!b.isDefaultPrevented()){var c=this.$parent&&this.$parent.find("> .panel > .in");if(c&&c.length){var d=c.data("bs.collapse");if(d&&d.transitioning)return;c.collapse("hide"),d||c.data("bs.collapse",null)}var e=this.dimension();this.$element.removeClass("collapse").addClass("collapsing")[e](0),this.transitioning=1;var f=function(){this.$element.removeClass("collapsing").addClass("in")[e]("auto"),this.transitioning=0,this.$element.trigger("shown.bs.collapse")};if(!a.support.transition)return f.call(this);var g=a.camelCase(["scroll",e].join("-"));this.$element.one(a.support.transition.end,a.proxy(f,this)).emulateTransitionEnd(350)[e](this.$element[0][g])}}},b.prototype.hide=function(){if(!this.transitioning&&this.$element.hasClass("in")){var b=a.Event("hide.bs.collapse");if(this.$element.trigger(b),!b.isDefaultPrevented()){var c=this.dimension();this.$element[c](this.$element[c]())[0].offsetHeight,this.$element.addClass("collapsing").removeClass("collapse").removeClass("in"),this.transitioning=1;var d=function(){this.transitioning=0,this.$element.trigger("hidden.bs.collapse").removeClass("collapsing").addClass("collapse")};return a.support.transition?(this.$element[c](0).one(a.support.transition.end,a.proxy(d,this)).emulateTransitionEnd(350),void 0):d.call(this)}}},b.prototype.toggle=function(){this[this.$element.hasClass("in")?"hide":"show"]()};var c=a.fn.collapse;a.fn.collapse=function(c){return this.each(function(){var d=a(this),e=d.data("bs.collapse"),f=a.extend({},b.DEFAULTS,d.data(),"object"==typeof c&&c);e||d.data("bs.collapse",e=new b(this,f)),"string"==typeof c&&e[c]()})},a.fn.collapse.Constructor=b,a.fn.collapse.noConflict=function(){return a.fn.collapse=c,this},a(document).on("click.bs.collapse.data-api","[data-toggle=collapse]",function(b){var c,d=a(this),e=d.attr("data-target")||b.preventDefault()||(c=d.attr("href"))&&c.replace(/.*(?=#[^\s]+$)/,""),f=a(e),g=f.data("bs.collapse"),h=g?"toggle":d.data(),i=d.attr("data-parent"),j=i&&a(i);g&&g.transitioning||(j&&j.find('[data-toggle=collapse][data-parent="'+i+'"]').not(d).addClass("collapsed"),d[f.hasClass("in")?"addClass":"removeClass"]("collapsed")),f.collapse(h)})}(jQuery),+function(a){"use strict";function b(){a(d).remove(),a(e).each(function(b){var d=c(a(this));d.hasClass("open")&&(d.trigger(b=a.Event("hide.bs.dropdown")),b.isDefaultPrevented()||d.removeClass("open").trigger("hidden.bs.dropdown"))})}function c(b){var c=b.attr("data-target");c||(c=b.attr("href"),c=c&&/#/.test(c)&&c.replace(/.*(?=#[^\s]*$)/,""));var d=c&&a(c);return d&&d.length?d:b.parent()}var d=".dropdown-backdrop",e="[data-toggle=dropdown]",f=function(b){a(b).on("click.bs.dropdown",this.toggle)};f.prototype.toggle=function(d){var e=a(this);if(!e.is(".disabled, :disabled")){var f=c(e),g=f.hasClass("open");if(b(),!g){if("ontouchstart"in document.documentElement&&!f.closest(".navbar-nav").length&&a('
').insertAfter(a(this)).on("click",b),f.trigger(d=a.Event("show.bs.dropdown")),d.isDefaultPrevented())return;f.toggleClass("open").trigger("shown.bs.dropdown"),e.focus()}return!1}},f.prototype.keydown=function(b){if(/(38|40|27)/.test(b.keyCode)){var d=a(this);if(b.preventDefault(),b.stopPropagation(),!d.is(".disabled, :disabled")){var f=c(d),g=f.hasClass("open");if(!g||g&&27==b.keyCode)return 27==b.which&&f.find(e).focus(),d.click();var h=a("[role=menu] li:not(.divider):visible a",f);if(h.length){var i=h.index(h.filter(":focus"));38==b.keyCode&&i>0&&i--,40==b.keyCode&&i').appendTo(document.body),this.$element.on("click.dismiss.modal",a.proxy(function(a){a.target===a.currentTarget&&("static"==this.options.backdrop?this.$element[0].focus.call(this.$element[0]):this.hide.call(this))},this)),d&&this.$backdrop[0].offsetWidth,this.$backdrop.addClass("in"),!b)return;d?this.$backdrop.one(a.support.transition.end,b).emulateTransitionEnd(150):b()}else!this.isShown&&this.$backdrop?(this.$backdrop.removeClass("in"),a.support.transition&&this.$element.hasClass("fade")?this.$backdrop.one(a.support.transition.end,b).emulateTransitionEnd(150):b()):b&&b()};var c=a.fn.modal;a.fn.modal=function(c,d){return this.each(function(){var e=a(this),f=e.data("bs.modal"),g=a.extend({},b.DEFAULTS,e.data(),"object"==typeof c&&c);f||e.data("bs.modal",f=new b(this,g)),"string"==typeof c?f[c](d):g.show&&f.show(d)})},a.fn.modal.Constructor=b,a.fn.modal.noConflict=function(){return a.fn.modal=c,this},a(document).on("click.bs.modal.data-api",'[data-toggle="modal"]',function(b){var c=a(this),d=c.attr("href"),e=a(c.attr("data-target")||d&&d.replace(/.*(?=#[^\s]+$)/,"")),f=e.data("modal")?"toggle":a.extend({remote:!/#/.test(d)&&d},e.data(),c.data());b.preventDefault(),e.modal(f,this).one("hide",function(){c.is(":visible")&&c.focus()})}),a(document).on("show.bs.modal",".modal",function(){a(document.body).addClass("modal-open")}).on("hidden.bs.modal",".modal",function(){a(document.body).removeClass("modal-open")})}(jQuery),+function(a){"use strict";var b=function(a,b){this.type=this.options=this.enabled=this.timeout=this.hoverState=this.$element=null,this.init("tooltip",a,b)};b.DEFAULTS={animation:!0,placement:"top",selector:!1,template:'
',trigger:"hover focus",title:"",delay:0,html:!1,container:!1},b.prototype.init=function(b,c,d){this.enabled=!0,this.type=b,this.$element=a(c),this.options=this.getOptions(d);for(var e=this.options.trigger.split(" "),f=e.length;f--;){var g=e[f];if("click"==g)this.$element.on("click."+this.type,this.options.selector,a.proxy(this.toggle,this));else if("manual"!=g){var h="hover"==g?"mouseenter":"focus",i="hover"==g?"mouseleave":"blur";this.$element.on(h+"."+this.type,this.options.selector,a.proxy(this.enter,this)),this.$element.on(i+"."+this.type,this.options.selector,a.proxy(this.leave,this))}}this.options.selector?this._options=a.extend({},this.options,{trigger:"manual",selector:""}):this.fixTitle()},b.prototype.getDefaults=function(){return b.DEFAULTS},b.prototype.getOptions=function(b){return b=a.extend({},this.getDefaults(),this.$element.data(),b),b.delay&&"number"==typeof b.delay&&(b.delay={show:b.delay,hide:b.delay}),b},b.prototype.getDelegateOptions=function(){var b={},c=this.getDefaults();return this._options&&a.each(this._options,function(a,d){c[a]!=d&&(b[a]=d)}),b},b.prototype.enter=function(b){var c=b instanceof this.constructor?b:a(b.currentTarget)[this.type](this.getDelegateOptions()).data("bs."+this.type);return clearTimeout(c.timeout),c.hoverState="in",c.options.delay&&c.options.delay.show?(c.timeout=setTimeout(function(){"in"==c.hoverState&&c.show()},c.options.delay.show),void 0):c.show()},b.prototype.leave=function(b){var c=b instanceof this.constructor?b:a(b.currentTarget)[this.type](this.getDelegateOptions()).data("bs."+this.type);return clearTimeout(c.timeout),c.hoverState="out",c.options.delay&&c.options.delay.hide?(c.timeout=setTimeout(function(){"out"==c.hoverState&&c.hide()},c.options.delay.hide),void 0):c.hide()},b.prototype.show=function(){var b=a.Event("show.bs."+this.type);if(this.hasContent()&&this.enabled){if(this.$element.trigger(b),b.isDefaultPrevented())return;var c=this.tip();this.setContent(),this.options.animation&&c.addClass("fade");var d="function"==typeof this.options.placement?this.options.placement.call(this,c[0],this.$element[0]):this.options.placement,e=/\s?auto?\s?/i,f=e.test(d);f&&(d=d.replace(e,"")||"top"),c.detach().css({top:0,left:0,display:"block"}).addClass(d),this.options.container?c.appendTo(this.options.container):c.insertAfter(this.$element);var g=this.getPosition(),h=c[0].offsetWidth,i=c[0].offsetHeight;if(f){var j=this.$element.parent(),k=d,l=document.documentElement.scrollTop||document.body.scrollTop,m="body"==this.options.container?window.innerWidth:j.outerWidth(),n="body"==this.options.container?window.innerHeight:j.outerHeight(),o="body"==this.options.container?0:j.offset().left;d="bottom"==d&&g.top+g.height+i-l>n?"top":"top"==d&&g.top-l-i<0?"bottom":"right"==d&&g.right+h>m?"left":"left"==d&&g.left-h

'}),b.prototype=a.extend({},a.fn.tooltip.Constructor.prototype),b.prototype.constructor=b,b.prototype.getDefaults=function(){return b.DEFAULTS},b.prototype.setContent=function(){var a=this.tip(),b=this.getTitle(),c=this.getContent();a.find(".popover-title")[this.options.html?"html":"text"](b),a.find(".popover-content")[this.options.html?"html":"text"](c),a.removeClass("fade top bottom left right in"),a.find(".popover-title").html()||a.find(".popover-title").hide()},b.prototype.hasContent=function(){return this.getTitle()||this.getContent()},b.prototype.getContent=function(){var a=this.$element,b=this.options;return a.attr("data-content")||("function"==typeof b.content?b.content.call(a[0]):b.content)},b.prototype.arrow=function(){return this.$arrow=this.$arrow||this.tip().find(".arrow")},b.prototype.tip=function(){return this.$tip||(this.$tip=a(this.options.template)),this.$tip};var c=a.fn.popover;a.fn.popover=function(c){return this.each(function(){var d=a(this),e=d.data("bs.popover"),f="object"==typeof c&&c;e||d.data("bs.popover",e=new b(this,f)),"string"==typeof c&&e[c]()})},a.fn.popover.Constructor=b,a.fn.popover.noConflict=function(){return a.fn.popover=c,this}}(jQuery),+function(a){"use strict";function b(c,d){var e,f=a.proxy(this.process,this);this.$element=a(c).is("body")?a(window):a(c),this.$body=a("body"),this.$scrollElement=this.$element.on("scroll.bs.scroll-spy.data-api",f),this.options=a.extend({},b.DEFAULTS,d),this.selector=(this.options.target||(e=a(c).attr("href"))&&e.replace(/.*(?=#[^\s]+$)/,"")||"")+" .nav li > a",this.offsets=a([]),this.targets=a([]),this.activeTarget=null,this.refresh(),this.process()}b.DEFAULTS={offset:10},b.prototype.refresh=function(){var b=this.$element[0]==window?"offset":"position";this.offsets=a([]),this.targets=a([]);var c=this;this.$body.find(this.selector).map(function(){var d=a(this),e=d.data("target")||d.attr("href"),f=/^#\w/.test(e)&&a(e);return f&&f.length&&[[f[b]().top+(!a.isWindow(c.$scrollElement.get(0))&&c.$scrollElement.scrollTop()),e]]||null}).sort(function(a,b){return a[0]-b[0]}).each(function(){c.offsets.push(this[0]),c.targets.push(this[1])})},b.prototype.process=function(){var a,b=this.$scrollElement.scrollTop()+this.options.offset,c=this.$scrollElement[0].scrollHeight||this.$body[0].scrollHeight,d=c-this.$scrollElement.height(),e=this.offsets,f=this.targets,g=this.activeTarget;if(b>=d)return g!=(a=f.last()[0])&&this.activate(a);for(a=e.length;a--;)g!=f[a]&&b>=e[a]&&(!e[a+1]||b<=e[a+1])&&this.activate(f[a])},b.prototype.activate=function(b){this.activeTarget=b,a(this.selector).parents(".active").removeClass("active");var c=this.selector+'[data-target="'+b+'"],'+this.selector+'[href="'+b+'"]',d=a(c).parents("li").addClass("active");d.parent(".dropdown-menu").length&&(d=d.closest("li.dropdown").addClass("active")),d.trigger("activate.bs.scrollspy")};var c=a.fn.scrollspy;a.fn.scrollspy=function(c){return this.each(function(){var d=a(this),e=d.data("bs.scrollspy"),f="object"==typeof c&&c;e||d.data("bs.scrollspy",e=new b(this,f)),"string"==typeof c&&e[c]()})},a.fn.scrollspy.Constructor=b,a.fn.scrollspy.noConflict=function(){return a.fn.scrollspy=c,this},a(window).on("load",function(){a('[data-spy="scroll"]').each(function(){var b=a(this);b.scrollspy(b.data())})})}(jQuery),+function(a){"use strict";var b=function(b){this.element=a(b)};b.prototype.show=function(){var b=this.element,c=b.closest("ul:not(.dropdown-menu)"),d=b.data("target");if(d||(d=b.attr("href"),d=d&&d.replace(/.*(?=#[^\s]*$)/,"")),!b.parent("li").hasClass("active")){var e=c.find(".active:last a")[0],f=a.Event("show.bs.tab",{relatedTarget:e});if(b.trigger(f),!f.isDefaultPrevented()){var g=a(d);this.activate(b.parent("li"),c),this.activate(g,g.parent(),function(){b.trigger({type:"shown.bs.tab",relatedTarget:e})})}}},b.prototype.activate=function(b,c,d){function e(){f.removeClass("active").find("> .dropdown-menu > .active").removeClass("active"),b.addClass("active"),g?(b[0].offsetWidth,b.addClass("in")):b.removeClass("fade"),b.parent(".dropdown-menu")&&b.closest("li.dropdown").addClass("active"),d&&d()}var f=c.find("> .active"),g=d&&a.support.transition&&f.hasClass("fade");g?f.one(a.support.transition.end,e).emulateTransitionEnd(150):e(),f.removeClass("in")};var c=a.fn.tab;a.fn.tab=function(c){return this.each(function(){var d=a(this),e=d.data("bs.tab");e||d.data("bs.tab",e=new b(this)),"string"==typeof c&&e[c]()})},a.fn.tab.Constructor=b,a.fn.tab.noConflict=function(){return a.fn.tab=c,this},a(document).on("click.bs.tab.data-api",'[data-toggle="tab"], [data-toggle="pill"]',function(b){b.preventDefault(),a(this).tab("show")})}(jQuery),+function(a){"use strict";var b=function(c,d){this.options=a.extend({},b.DEFAULTS,d),this.$window=a(window).on("scroll.bs.affix.data-api",a.proxy(this.checkPosition,this)).on("click.bs.affix.data-api",a.proxy(this.checkPositionWithEventLoop,this)),this.$element=a(c),this.affixed=this.unpin=null,this.checkPosition()};b.RESET="affix affix-top affix-bottom",b.DEFAULTS={offset:0},b.prototype.checkPositionWithEventLoop=function(){setTimeout(a.proxy(this.checkPosition,this),1)},b.prototype.checkPosition=function(){if(this.$element.is(":visible")){var c=a(document).height(),d=this.$window.scrollTop(),e=this.$element.offset(),f=this.options.offset,g=f.top,h=f.bottom;"object"!=typeof f&&(h=g=f),"function"==typeof g&&(g=f.top()),"function"==typeof h&&(h=f.bottom());var i=null!=this.unpin&&d+this.unpin<=e.top?!1:null!=h&&e.top+this.$element.height()>=c-h?"bottom":null!=g&&g>=d?"top":!1;this.affixed!==i&&(this.unpin&&this.$element.css("top",""),this.affixed=i,this.unpin="bottom"==i?e.top-d:null,this.$element.removeClass(b.RESET).addClass("affix"+(i?"-"+i:"")),"bottom"==i&&this.$element.offset({top:document.body.offsetHeight-h-this.$element.height()}))}};var c=a.fn.affix;a.fn.affix=function(c){return this.each(function(){var d=a(this),e=d.data("bs.affix"),f="object"==typeof c&&c;e||d.data("bs.affix",e=new b(this,f)),"string"==typeof c&&e[c]()})},a.fn.affix.Constructor=b,a.fn.affix.noConflict=function(){return a.fn.affix=c,this},a(window).on("load",function(){a('[data-spy="affix"]').each(function(){var b=a(this),c=b.data();c.offset=c.offset||{},c.offsetBottom&&(c.offset.bottom=c.offsetBottom),c.offsetTop&&(c.offset.top=c.offsetTop),b.affix(c)})})}(jQuery); \ No newline at end of file diff --git a/docs/theme/mkdocs/js/jquery-scrolltofixed-min.js b/docs/theme/mkdocs/js/jquery-scrolltofixed-min.js new file mode 100644 index 0000000000..5382c04485 --- /dev/null +++ b/docs/theme/mkdocs/js/jquery-scrolltofixed-min.js @@ -0,0 +1,8 @@ +/* + * ScrollToFixed + * https://github.com/bigspotteddog/ScrollToFixed + * + * Copyright (c) 2011 Joseph Cava-Lynch + * MIT license + */ +(function(a){a.isScrollToFixed=function(b){return !!a(b).data("ScrollToFixed")};a.ScrollToFixed=function(d,i){var l=this;l.$el=a(d);l.el=d;l.$el.data("ScrollToFixed",l);var c=false;var F=l.$el;var G;var D;var e;var C=0;var q=0;var j=-1;var f=-1;var t=null;var y;var g;function u(){F.trigger("preUnfixed.ScrollToFixed");k();F.trigger("unfixed.ScrollToFixed");f=-1;C=F.offset().top;q=F.offset().left;if(l.options.offsets){q+=(F.offset().left-F.position().left)}if(j==-1){j=q}G=F.css("position");c=true;if(l.options.bottom!=-1){F.trigger("preFixed.ScrollToFixed");w();F.trigger("fixed.ScrollToFixed")}}function n(){var H=l.options.limit;if(!H){return 0}if(typeof(H)==="function"){return H.apply(F)}return H}function p(){return G==="fixed"}function x(){return G==="absolute"}function h(){return !(p()||x())}function w(){if(!p()){t.css({display:F.css("display"),width:F.outerWidth(true),height:F.outerHeight(true),"float":F.css("float")});cssOptions={position:"fixed",top:l.options.bottom==-1?s():"",bottom:l.options.bottom==-1?"":l.options.bottom,"margin-left":"0px"};if(!l.options.dontSetWidth){cssOptions.width=F.width()}F.css(cssOptions);F.addClass(l.options.baseClassName);if(l.options.className){F.addClass(l.options.className)}G="fixed"}}function b(){var I=n();var H=q;if(l.options.removeOffsets){H="";I=I-C}cssOptions={position:"absolute",top:I,left:H,"margin-left":"0px",bottom:""};if(!l.options.dontSetWidth){cssOptions.width=F.width()}F.css(cssOptions);G="absolute"}function k(){if(!h()){f=-1;t.css("display","none");F.css({width:"",position:D,left:"",top:e,"margin-left":""});F.removeClass("scroll-to-fixed-fixed");if(l.options.className){F.removeClass(l.options.className)}G=null}}function v(H){if(H!=f){F.css("left",q-H);f=H}}function s(){var H=l.options.marginTop;if(!H){return 0}if(typeof(H)==="function"){return H.apply(F)}return H}function z(){if(!a.isScrollToFixed(F)){return}var J=c;if(!c){u()}var H=a(window).scrollLeft();var K=a(window).scrollTop();var I=n();if(l.options.minWidth&&a(window).width()l.options.maxWidth){if(!h()||!J){o();F.trigger("preUnfixed.ScrollToFixed");k();F.trigger("unfixed.ScrollToFixed")}}else{if(l.options.bottom==-1){if(I>0&&K>=I-s()){if(!x()||!J){o();F.trigger("preAbsolute.ScrollToFixed");b();F.trigger("unfixed.ScrollToFixed")}}else{if(K>=C-s()){if(!p()||!J){o();F.trigger("preFixed.ScrollToFixed");w();f=-1;F.trigger("fixed.ScrollToFixed")}v(H)}else{if(!h()||!J){o();F.trigger("preUnfixed.ScrollToFixed");k();F.trigger("unfixed.ScrollToFixed")}}}}else{if(I>0){if(K+a(window).height()-F.outerHeight(true)>=I-(s()||-m())){if(p()){o();F.trigger("preUnfixed.ScrollToFixed");if(D==="absolute"){b()}else{k()}F.trigger("unfixed.ScrollToFixed")}}else{if(!p()){o();F.trigger("preFixed.ScrollToFixed");w()}v(H);F.trigger("fixed.ScrollToFixed")}}else{v(H)}}}}}function m(){if(!l.options.bottom){return 0}return l.options.bottom}function o(){var H=F.css("position");if(H=="absolute"){F.trigger("postAbsolute.ScrollToFixed")}else{if(H=="fixed"){F.trigger("postFixed.ScrollToFixed")}else{F.trigger("postUnfixed.ScrollToFixed")}}}var B=function(H){if(F.is(":visible")){c=false;z()}};var E=function(H){z()};var A=function(){var I=document.body;if(document.createElement&&I&&I.appendChild&&I.removeChild){var K=document.createElement("div");if(!K.getBoundingClientRect){return null}K.innerHTML="x";K.style.cssText="position:fixed;top:100px;";I.appendChild(K);var L=I.style.height,M=I.scrollTop;I.style.height="3000px";I.scrollTop=500;var H=K.getBoundingClientRect().top;I.style.height=L;var J=(H===100);I.removeChild(K);I.scrollTop=M;return J}return null};var r=function(H){H=H||window.event;if(H.preventDefault){H.preventDefault()}H.returnValue=false};l.init=function(){l.options=a.extend({},a.ScrollToFixed.defaultOptions,i);l.$el.css("z-index",l.options.zIndex);t=a("
");G=F.css("position");D=F.css("position");e=F.css("top");if(h()){l.$el.after(t)}a(window).bind("resize.ScrollToFixed",B);a(window).bind("scroll.ScrollToFixed",E);if(l.options.preFixed){F.bind("preFixed.ScrollToFixed",l.options.preFixed)}if(l.options.postFixed){F.bind("postFixed.ScrollToFixed",l.options.postFixed)}if(l.options.preUnfixed){F.bind("preUnfixed.ScrollToFixed",l.options.preUnfixed)}if(l.options.postUnfixed){F.bind("postUnfixed.ScrollToFixed",l.options.postUnfixed)}if(l.options.preAbsolute){F.bind("preAbsolute.ScrollToFixed",l.options.preAbsolute)}if(l.options.postAbsolute){F.bind("postAbsolute.ScrollToFixed",l.options.postAbsolute)}if(l.options.fixed){F.bind("fixed.ScrollToFixed",l.options.fixed)}if(l.options.unfixed){F.bind("unfixed.ScrollToFixed",l.options.unfixed)}if(l.options.spacerClass){t.addClass(l.options.spacerClass)}F.bind("resize.ScrollToFixed",function(){t.height(F.height())});F.bind("scroll.ScrollToFixed",function(){F.trigger("preUnfixed.ScrollToFixed");k();F.trigger("unfixed.ScrollToFixed");z()});F.bind("detach.ScrollToFixed",function(H){r(H);F.trigger("preUnfixed.ScrollToFixed");k();F.trigger("unfixed.ScrollToFixed");a(window).unbind("resize.ScrollToFixed",B);a(window).unbind("scroll.ScrollToFixed",E);F.unbind(".ScrollToFixed");t.remove();l.$el.removeData("ScrollToFixed")});B()};l.init()};a.ScrollToFixed.defaultOptions={marginTop:0,limit:0,bottom:-1,zIndex:1000,baseClassName:"scroll-to-fixed-fixed"};a.fn.scrollToFixed=function(b){return this.each(function(){(new a.ScrollToFixed(this,b))})}})(jQuery); diff --git a/docs/theme/mkdocs/js/prettify-1.0.min.js b/docs/theme/mkdocs/js/prettify-1.0.min.js new file mode 100644 index 0000000000..eef5ad7e6a --- /dev/null +++ b/docs/theme/mkdocs/js/prettify-1.0.min.js @@ -0,0 +1,28 @@ +var q=null;window.PR_SHOULD_USE_CONTINUATION=!0; +(function(){function L(a){function m(a){var f=a.charCodeAt(0);if(f!==92)return f;var b=a.charAt(1);return(f=r[b])?f:"0"<=b&&b<="7"?parseInt(a.substring(1),8):b==="u"||b==="x"?parseInt(a.substring(2),16):a.charCodeAt(1)}function e(a){if(a<32)return(a<16?"\\x0":"\\x")+a.toString(16);a=String.fromCharCode(a);if(a==="\\"||a==="-"||a==="["||a==="]")a="\\"+a;return a}function h(a){for(var f=a.substring(1,a.length-1).match(/\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\[0-3][0-7]{0,2}|\\[0-7]{1,2}|\\[\S\s]|[^\\]/g),a= +[],b=[],o=f[0]==="^",c=o?1:0,i=f.length;c122||(d<65||j>90||b.push([Math.max(65,j)|32,Math.min(d,90)|32]),d<97||j>122||b.push([Math.max(97,j)&-33,Math.min(d,122)&-33]))}}b.sort(function(a,f){return a[0]-f[0]||f[1]-a[1]});f=[];j=[NaN,NaN];for(c=0;ci[0]&&(i[1]+1>i[0]&&b.push("-"),b.push(e(i[1])));b.push("]");return b.join("")}function y(a){for(var f=a.source.match(/\[(?:[^\\\]]|\\[\S\s])*]|\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\\d+|\\[^\dux]|\(\?[!:=]|[()^]|[^()[\\^]+/g),b=f.length,d=[],c=0,i=0;c=2&&a==="["?f[c]=h(j):a!=="\\"&&(f[c]=j.replace(/[A-Za-z]/g,function(a){a=a.charCodeAt(0);return"["+String.fromCharCode(a&-33,a|32)+"]"}));return f.join("")}for(var t=0,s=!1,l=!1,p=0,d=a.length;p=5&&"lang-"===b.substring(0,5))&&!(o&&typeof o[1]==="string"))c=!1,b="src";c||(r[f]=b)}i=d;d+=f.length;if(c){c=o[1];var j=f.indexOf(c),k=j+c.length;o[2]&&(k=f.length-o[2].length,j=k-c.length);b=b.substring(5);B(l+i,f.substring(0,j),e,p);B(l+i+j,c,C(b,c),p);B(l+i+k,f.substring(k),e,p)}else p.push(l+i,b)}a.e=p}var h={},y;(function(){for(var e=a.concat(m), +l=[],p={},d=0,g=e.length;d=0;)h[n.charAt(k)]=r;r=r[1];n=""+r;p.hasOwnProperty(n)||(l.push(r),p[n]=q)}l.push(/[\S\s]/);y=L(l)})();var t=m.length;return e}function u(a){var m=[],e=[];a.tripleQuotedStrings?m.push(["str",/^(?:'''(?:[^'\\]|\\[\S\s]|''?(?=[^']))*(?:'''|$)|"""(?:[^"\\]|\\[\S\s]|""?(?=[^"]))*(?:"""|$)|'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$))/,q,"'\""]):a.multiLineStrings?m.push(["str",/^(?:'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$)|`(?:[^\\`]|\\[\S\s])*(?:`|$))/, +q,"'\"`"]):m.push(["str",/^(?:'(?:[^\n\r'\\]|\\.)*(?:'|$)|"(?:[^\n\r"\\]|\\.)*(?:"|$))/,q,"\"'"]);a.verbatimStrings&&e.push(["str",/^@"(?:[^"]|"")*(?:"|$)/,q]);var h=a.hashComments;h&&(a.cStyleComments?(h>1?m.push(["com",/^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/,q,"#"]):m.push(["com",/^#(?:(?:define|elif|else|endif|error|ifdef|include|ifndef|line|pragma|undef|warning)\b|[^\n\r]*)/,q,"#"]),e.push(["str",/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h|[a-z]\w*)>/,q])):m.push(["com",/^#[^\n\r]*/, +q,"#"]));a.cStyleComments&&(e.push(["com",/^\/\/[^\n\r]*/,q]),e.push(["com",/^\/\*[\S\s]*?(?:\*\/|$)/,q]));a.regexLiterals&&e.push(["lang-regex",/^(?:^^\.?|[!+-]|!=|!==|#|%|%=|&|&&|&&=|&=|\(|\*|\*=|\+=|,|-=|->|\/|\/=|:|::|;|<|<<|<<=|<=|=|==|===|>|>=|>>|>>=|>>>|>>>=|[?@[^]|\^=|\^\^|\^\^=|{|\||\|=|\|\||\|\|=|~|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\s*(\/(?=[^*/])(?:[^/[\\]|\\[\S\s]|\[(?:[^\\\]]|\\[\S\s])*(?:]|$))+\/)/]);(h=a.types)&&e.push(["typ",h]);a=(""+a.keywords).replace(/^ | $/g, +"");a.length&&e.push(["kwd",RegExp("^(?:"+a.replace(/[\s,]+/g,"|")+")\\b"),q]);m.push(["pln",/^\s+/,q," \r\n\t\xa0"]);e.push(["lit",/^@[$_a-z][\w$@]*/i,q],["typ",/^(?:[@_]?[A-Z]+[a-z][\w$@]*|\w+_t\b)/,q],["pln",/^[$_a-z][\w$@]*/i,q],["lit",/^(?:0x[\da-f]+|(?:\d(?:_\d+)*\d*(?:\.\d*)?|\.\d\+)(?:e[+-]?\d+)?)[a-z]*/i,q,"0123456789"],["pln",/^\\[\S\s]?/,q],["pun",/^.[^\s\w"-$'./@\\`]*/,q]);return x(m,e)}function D(a,m){function e(a){switch(a.nodeType){case 1:if(k.test(a.className))break;if("BR"===a.nodeName)h(a), +a.parentNode&&a.parentNode.removeChild(a);else for(a=a.firstChild;a;a=a.nextSibling)e(a);break;case 3:case 4:if(p){var b=a.nodeValue,d=b.match(t);if(d){var c=b.substring(0,d.index);a.nodeValue=c;(b=b.substring(d.index+d[0].length))&&a.parentNode.insertBefore(s.createTextNode(b),a.nextSibling);h(a);c||a.parentNode.removeChild(a)}}}}function h(a){function b(a,d){var e=d?a.cloneNode(!1):a,f=a.parentNode;if(f){var f=b(f,1),g=a.nextSibling;f.appendChild(e);for(var h=g;h;h=g)g=h.nextSibling,f.appendChild(h)}return e} +for(;!a.nextSibling;)if(a=a.parentNode,!a)return;for(var a=b(a.nextSibling,0),e;(e=a.parentNode)&&e.nodeType===1;)a=e;d.push(a)}var k=/(?:^|\s)nocode(?:\s|$)/,t=/\r\n?|\n/,s=a.ownerDocument,l;a.currentStyle?l=a.currentStyle.whiteSpace:window.getComputedStyle&&(l=s.defaultView.getComputedStyle(a,q).getPropertyValue("white-space"));var p=l&&"pre"===l.substring(0,3);for(l=s.createElement("LI");a.firstChild;)l.appendChild(a.firstChild);for(var d=[l],g=0;g=0;){var h=m[e];A.hasOwnProperty(h)?window.console&&console.warn("cannot override language handler %s",h):A[h]=a}}function C(a,m){if(!a||!A.hasOwnProperty(a))a=/^\s*=o&&(h+=2);e>=c&&(a+=2)}}catch(w){"console"in window&&console.log(w&&w.stack?w.stack:w)}}var v=["break,continue,do,else,for,if,return,while"],w=[[v,"auto,case,char,const,default,double,enum,extern,float,goto,int,long,register,short,signed,sizeof,static,struct,switch,typedef,union,unsigned,void,volatile"], +"catch,class,delete,false,import,new,operator,private,protected,public,this,throw,true,try,typeof"],F=[w,"alignof,align_union,asm,axiom,bool,concept,concept_map,const_cast,constexpr,decltype,dynamic_cast,explicit,export,friend,inline,late_check,mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast,template,typeid,typename,using,virtual,where"],G=[w,"abstract,boolean,byte,extends,final,finally,implements,import,instanceof,null,native,package,strictfp,super,synchronized,throws,transient"], +H=[G,"as,base,by,checked,decimal,delegate,descending,dynamic,event,fixed,foreach,from,group,implicit,in,interface,internal,into,is,lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,var"],w=[w,"debugger,eval,export,function,get,null,set,undefined,var,with,Infinity,NaN"],I=[v,"and,as,assert,class,def,del,elif,except,exec,finally,from,global,import,in,is,lambda,nonlocal,not,or,pass,print,raise,try,with,yield,False,True,None"], +J=[v,"alias,and,begin,case,class,def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,rescue,retry,self,super,then,true,undef,unless,until,when,yield,BEGIN,END"],v=[v,"case,done,elif,esac,eval,fi,function,in,local,set,then,until"],K=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float)\d*)/,N=/\S/,O=u({keywords:[F,H,w,"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END"+ +I,J,v],hashComments:!0,cStyleComments:!0,multiLineStrings:!0,regexLiterals:!0}),A={};k(O,["default-code"]);k(x([],[["pln",/^[^]*(?:>|$)/],["com",/^<\!--[\S\s]*?(?:--\>|$)/],["lang-",/^<\?([\S\s]+?)(?:\?>|$)/],["lang-",/^<%([\S\s]+?)(?:%>|$)/],["pun",/^(?:<[%?]|[%?]>)/],["lang-",/^]*>([\S\s]+?)<\/xmp\b[^>]*>/i],["lang-js",/^]*>([\S\s]*?)(<\/script\b[^>]*>)/i],["lang-css",/^]*>([\S\s]*?)(<\/style\b[^>]*>)/i],["lang-in.tag",/^(<\/?[a-z][^<>]*>)/i]]), +["default-markup","htm","html","mxml","xhtml","xml","xsl"]);k(x([["pln",/^\s+/,q," \t\r\n"],["atv",/^(?:"[^"]*"?|'[^']*'?)/,q,"\"'"]],[["tag",/^^<\/?[a-z](?:[\w-.:]*\w)?|\/?>$/i],["atn",/^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],["lang-uq.val",/^=\s*([^\s"'>]*(?:[^\s"'/>]|\/(?=\s)))/],["pun",/^[/<->]+/],["lang-js",/^on\w+\s*=\s*"([^"]+)"/i],["lang-js",/^on\w+\s*=\s*'([^']+)'/i],["lang-js",/^on\w+\s*=\s*([^\s"'>]+)/i],["lang-css",/^style\s*=\s*"([^"]+)"/i],["lang-css",/^style\s*=\s*'([^']+)'/i],["lang-css", +/^style\s*=\s*([^\s"'>]+)/i]]),["in.tag"]);k(x([],[["atv",/^[\S\s]+/]]),["uq.val"]);k(u({keywords:F,hashComments:!0,cStyleComments:!0,types:K}),["c","cc","cpp","cxx","cyc","m"]);k(u({keywords:"null,true,false"}),["json"]);k(u({keywords:H,hashComments:!0,cStyleComments:!0,verbatimStrings:!0,types:K}),["cs"]);k(u({keywords:G,cStyleComments:!0}),["java"]);k(u({keywords:v,hashComments:!0,multiLineStrings:!0}),["bsh","csh","sh"]);k(u({keywords:I,hashComments:!0,multiLineStrings:!0,tripleQuotedStrings:!0}), +["cv","py"]);k(u({keywords:"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END",hashComments:!0,multiLineStrings:!0,regexLiterals:!0}),["perl","pl","pm"]);k(u({keywords:J,hashComments:!0,multiLineStrings:!0,regexLiterals:!0}),["rb"]);k(u({keywords:w,cStyleComments:!0,regexLiterals:!0}),["js"]);k(u({keywords:"all,and,by,catch,class,else,extends,false,finally,for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,true,try,unless,until,when,while,yes", +hashComments:3,cStyleComments:!0,multilineStrings:!0,tripleQuotedStrings:!0,regexLiterals:!0}),["coffee"]);k(x([],[["str",/^[\S\s]+/]]),["regex"]);window.prettyPrintOne=function(a,m,e){var h=document.createElement("PRE");h.innerHTML=a;e&&D(h,e);E({g:m,i:e,h:h});return h.innerHTML};window.prettyPrint=function(a){function m(){for(var e=window.PR_SHOULD_USE_CONTINUATION?l.now()+250:Infinity;p=0){var k=k.match(g),f,b;if(b= +!k){b=n;for(var o=void 0,c=b.firstChild;c;c=c.nextSibling)var i=c.nodeType,o=i===1?o?b:c:i===3?N.test(c.nodeValue)?b:o:o;b=(f=o===b?void 0:o)&&"CODE"===f.tagName}b&&(k=f.className.match(g));k&&(k=k[1]);b=!1;for(o=n.parentNode;o;o=o.parentNode)if((o.tagName==="pre"||o.tagName==="code"||o.tagName==="xmp")&&o.className&&o.className.indexOf("prettyprint")>=0){b=!0;break}b||((b=(b=n.className.match(/\blinenums\b(?::(\d+))?/))?b[1]&&b[1].length?+b[1]:!0:!1)&&D(n,b),d={g:k,h:n,i:b},E(d))}}p +
+ Sections +
    +
  • + Home +
    • + {% for menu in nav %} + {% if menu.title != '**HIDDEN**' %} +
  • + {% if menu.children %} + {% for item in menu.children[:1] %} + {{ menu.title }} + {% endfor %} + {% endif %} +
    • + {% endif %} + {% endfor %} +
+ + + + + + + +
+
+ diff --git a/docs/theme/mkdocs/prev_next.html b/docs/theme/mkdocs/prev_next.html new file mode 100644 index 0000000000..693bfbcaa4 --- /dev/null +++ b/docs/theme/mkdocs/prev_next.html @@ -0,0 +1,22 @@ + + + \ No newline at end of file diff --git a/docs/theme/mkdocs/tipuesearch/img/loader.gif b/docs/theme/mkdocs/tipuesearch/img/loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..9c97738a27ad26d4e63494485484f1b5e4a5c73a GIT binary patch literal 4178 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 literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/tipuesearch/img/search.png b/docs/theme/mkdocs/tipuesearch/img/search.png new file mode 100755 index 0000000000000000000000000000000000000000..9ab0f2c1a9f40c054fed086a64cb2ab7ba724761 GIT binary patch literal 315 zcmV-B0mS}^P)|UX@)ym@P)sFZqOjDlbtD@DH35!L1E2W_&u0{f_NIL zil}i$KwUj4H1diKK%czE_aH>)*yp84^_$axL=!|BBHien5w*%bq5-K29(cfItiOr|LBuI+Y9Z% zMNiSzqlrARG8;`wev05vGw%A&4>=;%)S@d*Bl6!wb&1HoRGM-|PTrska!4noh06c{ N002ovPDHLkV1n?|fk*%V literal 0 HcmV?d00001 diff --git a/docs/theme/mkdocs/tipuesearch/tipuesearch.css b/docs/theme/mkdocs/tipuesearch/tipuesearch.css new file mode 100755 index 0000000000..d5847d22dc --- /dev/null +++ b/docs/theme/mkdocs/tipuesearch/tipuesearch.css @@ -0,0 +1,136 @@ + +/* +Tipue Search 3.1 +Copyright (c) 2013 Tipue +Tipue Search is released under the MIT License +http://www.tipue.com/search +*/ + +#tipue_search_button +{ + width: 70px; + height: 36px; + border: 0; + border-radius: 1px; + background: #75a8fb url('img/search.png') no-repeat center; + outline: none; +} +#tipue_search_button:hover +{ + background-color: #5193fb; +} + +#tipue_search_content +{ + clear: left; + max-width: 650px; + padding: 25px 0 13px 0; + margin: 0; +} +#tipue_search_loading +{ + padding-top: 60px; + background: #fff url('img/loader.gif') no-repeat left; +} + +#tipue_search_warning_head +{ + font: 300 16px/1.6 'Open Sans', sans-serif; +} +#tipue_search_warning +{ + font: 13px/1.6 'Open Sans', sans-serif; + margin: 7px 0; +} +#tipue_search_warning a +{ + font-weight: 300; + text-decoration: none; +} +#tipue_search_warning a:hover +{ +} +#tipue_search_results_count +{ + font: 13px/1.6 'Open Sans', sans-serif; +} +.tipue_search_content_title +{ + font: 300 23px/1.6 'Open Sans', sans-serif; + text-rendering: optimizelegibility; + margin-top: 23px; +} +.tipue_search_content_title a +{ + text-decoration: none; +} +.tipue_search_content_title a:hover +{ +} +.tipue_search_content_text +{ + font: 13px/1.7 'Open Sans', sans-serif; + padding: 13px 0; + word-break: break-all; + word-break: break-word; + -webkit-hyphens: auto; + -moz-hyphens: auto; + hyphens: auto; +} +.tipue_search_content_loc +{ + font: 300 13px/1.7 'Open Sans', sans-serif; + word-break: break-all; + word-break: break-word; + -webkit-hyphens: auto; + -moz-hyphens: auto; + hyphens: auto; +} +.tipue_search_content_loc a +{ + text-decoration: none; +} +.tipue_search_content_loc a:hover +{ +} +#tipue_search_foot +{ + margin: 51px 0 21px 0; +} +#tipue_search_foot_boxes +{ + padding: 0; + margin: 0; + font: 12px/1 'Open Sans', sans-serif; +} +#tipue_search_foot_boxes li +{ + list-style: none; + margin: 0; + padding: 0; + display: inline; +} +#tipue_search_foot_boxes li a +{ + padding: 9px 15px 10px 15px; + background-color: #f1f1f1; + border: 1px solid #dcdcdc; + border-radius: 1px; + margin-right: 7px; + text-decoration: none; + text-align: center; +} +#tipue_search_foot_boxes li.current +{ + padding: 9px 15px 10px 15px; + background: #fff; + border: 1px solid #dcdcdc; + border-radius: 1px; + margin-right: 7px; + text-align: center; +} +#tipue_search_foot_boxes li a:hover +{ + border: 1px solid #ccc; + background-color: #f3f3f3; +} diff --git a/docs/theme/mkdocs/tipuesearch/tipuesearch.js b/docs/theme/mkdocs/tipuesearch/tipuesearch.js new file mode 100644 index 0000000000..01c09f2b8c --- /dev/null +++ b/docs/theme/mkdocs/tipuesearch/tipuesearch.js @@ -0,0 +1,383 @@ + +/* +Tipue Search 3.1 +Copyright (c) 2013 Tipue +Tipue Search is released under the MIT License +http://www.tipue.com/search +*/ + + +(function($) { + + $.fn.tipuesearch = function(options) { + + var set = $.extend( { + + 'show' : 7, + 'newWindow' : false, + 'showURL' : true, + 'minimumLength' : 3, + 'descriptiveWords' : 25, + 'highlightTerms' : true, + 'highlightEveryTerm' : false, + 'mode' : 'static', + 'liveDescription' : '*', + 'liveContent' : '*', + 'contentLocation' : 'tipuesearch/tipuesearch_content.json' + + }, options); + + return this.each(function() { + + var tipuesearch_in = { + pages: [] + }; + $.ajaxSetup({ + async: false + }); + + if (set.mode == 'live') + { + for (var i = 0; i < tipuesearch_pages.length; i++) + { + $.get(tipuesearch_pages[i], '', + function (html) + { + var cont = $(set.liveContent, html).text(); + cont = cont.replace(/\s+/g, ' '); + var desc = $(set.liveDescription, html).text(); + desc = desc.replace(/\s+/g, ' '); + + var t_1 = html.toLowerCase().indexOf(''); + var t_2 = html.toLowerCase().indexOf('', t_1 + 7); + if (t_1 != -1 && t_2 != -1) + { + var tit = html.slice(t_1 + 7, t_2); + } + else + { + var tit = 'No title'; + } + + tipuesearch_in.pages.push({ + "title": tit, + "text": desc, + "tags": cont, + "loc": tipuesearch_pages[i] + }); + } + ); + } + } + + if (set.mode == 'json') + { + $.getJSON(set.contentLocation, + function(json) + { + tipuesearch_in = $.extend({}, json); + } + ); + } + + if (set.mode == 'static') + { + tipuesearch_in = $.extend({}, tipuesearch); + } + + var tipue_search_w = ''; + if (set.newWindow) + { + tipue_search_w = ' target="_blank"'; + } + + function getURLP(name) + { + return decodeURIComponent((new RegExp('[?|&]' + name + '=' + '([^&;]+?)(&|#|;|$)').exec(location.search)||[,""])[1].replace(/\+/g, '%20')) || null; + } + if (getURLP('q')) + { + $('#tipue_search_input').val(getURLP('q')); + getTipueSearch(0, true); + } + + $('#tipue_search_button').click(function() + { + getTipueSearch(0, true); + }); + $(this).keyup(function(event) + { + if(event.keyCode == '13') + { + getTipueSearch(0, true); + } + }); + + function getTipueSearch(start, replace) + { + $('#tipue_search_content').hide(); + var out = ''; + var results = ''; + var show_replace = false; + var show_stop = false; + + var d = $('#tipue_search_input').val().toLowerCase(); + d = $.trim(d); + var d_w = d.split(' '); + d = ''; + for (var i = 0; i < d_w.length; i++) + { + var a_w = true; + for (var f = 0; f < tipuesearch_stop_words.length; f++) + { + if (d_w[i] == tipuesearch_stop_words[f]) + { + a_w = false; + show_stop = true; + } + } + if (a_w) + { + d = d + ' ' + d_w[i]; + } + } + d = $.trim(d); + d_w = d.split(' '); + + if (d.length >= set.minimumLength) + { + if (replace) + { + var d_r = d; + for (var i = 0; i < d_w.length; i++) + { + for (var f = 0; f < tipuesearch_replace.words.length; f++) + { + if (d_w[i] == tipuesearch_replace.words[f].word) + { + d = d.replace(d_w[i], tipuesearch_replace.words[f].replace_with); + show_replace = true; + } + } + } + d_w = d.split(' '); + } + + var d_t = d; + for (var i = 0; i < d_w.length; i++) + { + for (var f = 0; f < tipuesearch_stem.words.length; f++) + { + if (d_w[i] == tipuesearch_stem.words[f].word) + { + d_t = d_t + ' ' + tipuesearch_stem.words[f].stem; + } + } + } + d_w = d_t.split(' '); + + var c = 0; + found = new Array(); + for (var i = 0; i < tipuesearch_in.pages.length; i++) + { + var score = 1000000000; + var s_t = tipuesearch_in.pages[i].text; + for (var f = 0; f < d_w.length; f++) + { + var pat = new RegExp(d_w[f], 'i'); + if (tipuesearch_in.pages[i].title.search(pat) != -1) + { + score -= (200000 - i); + } + if (tipuesearch_in.pages[i].text.search(pat) != -1) + { + score -= (150000 - i); + } + + if (set.highlightTerms) + { + if (set.highlightEveryTerm) + { + var patr = new RegExp('(' + d_w[f] + ')', 'gi'); + } + else + { + var patr = new RegExp('(' + d_w[f] + ')', 'i'); + } + s_t = s_t.replace(patr, "$1"); + } + if (tipuesearch_in.pages[i].tags.search(pat) != -1) + { + score -= (100000 - i); + } + + } + if (score < 1000000000) + { + found[c++] = score + '^' + tipuesearch_in.pages[i].title + '^' + s_t + '^' + tipuesearch_in.pages[i].loc; + } + } + + if (c != 0) + { + if (show_replace == 1) + { + out += '
Showing results for ' + d + '
'; + out += '
Search for ' + d_r + '
'; + } + if (c == 1) + { + out += '
1 result
'; + } + else + { + c_c = c.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","); + out += '
' + c_c + ' results
'; + } + + found.sort(); + var l_o = 0; + for (var i = 0; i < found.length; i++) + { + var fo = found[i].split('^'); + if (l_o >= start && l_o < set.show + start) + { + out += '
' + fo[1] + '
'; + + var t = fo[2]; + var t_d = ''; + var t_w = t.split(' '); + if (t_w.length < set.descriptiveWords) + { + t_d = t; + } + else + { + for (var f = 0; f < set.descriptiveWords; f++) + { + t_d += t_w[f] + ' '; + } + } + t_d = $.trim(t_d); + if (t_d.charAt(t_d.length - 1) != '.') + { + t_d += ' ...'; + } + out += '
' + t_d + '
'; + + if (set.showURL) + { + out += '
' + fo[3] + '
'; + } + } + l_o++; + } + + if (c > set.show) + { + var pages = Math.ceil(c / set.show); + var page = (start / set.show); + out += '
    '; + + if (start > 0) + { + out += '
  • « Prev
    • '; + } + + if (page <= 2) + { + var p_b = pages; + if (pages > 3) + { + p_b = 3; + } + for (var f = 0; f < p_b; f++) + { + if (f == page) + { + out += '
  • ' + (f + 1) + '
    • '; + } + else + { + out += '
  • ' + (f + 1) + '
    • '; + } + } + } + else + { + var p_b = pages + 2; + if (p_b > pages) + { + p_b = pages; + } + for (var f = page; f < p_b; f++) + { + if (f == page) + { + out += '
  • ' + (f + 1) + '
    • '; + } + else + { + out += '
  • ' + (f + 1) + '
    • '; + } + } + } + + if (page + 1 != pages) + { + out += '
  • Next »
    • '; + } + + out += '
'; + } + } + else + { + out += '
Nothing found
'; + } + } + else + { + if (show_stop) + { + out += '
Nothing found
Common words are largely ignored
'; + } + else + { + out += '
Search too short
'; + if (set.minimumLength == 1) + { + out += '
Should be one character or more
'; + } + else + { + out += '
Should be ' + set.minimumLength + ' characters or more
'; + } + } + } + + $('#tipue_search_content').html(out); + $('#tipue_search_content').slideDown(200); + + $('#tipue_search_replaced').click(function() + { + getTipueSearch(0, false); + }); + + $('.tipue_search_foot_box').click(function() + { + var id_v = $(this).attr('id'); + var id_a = id_v.split('_'); + + getTipueSearch(parseInt(id_a[0]), id_a[1]); + }); + } + + }); + }; + +})(jQuery); + + + + diff --git a/docs/theme/mkdocs/tipuesearch/tipuesearch.min.js b/docs/theme/mkdocs/tipuesearch/tipuesearch.min.js new file mode 100644 index 0000000000..bfc66f1f64 --- /dev/null +++ b/docs/theme/mkdocs/tipuesearch/tipuesearch.min.js @@ -0,0 +1,12 @@ +(function($){$.fn.tipuesearch=function(options){var set=$.extend({"show":7,"newWindow":false,"showURL":true,"minimumLength":3,"descriptiveWords":25,"highlightTerms":true,"highlightEveryTerm":false,"mode":"static","liveDescription":"*","liveContent":"*","contentLocation":"tipuesearch/tipuesearch_content.json"},options);return this.each(function(){var tipuesearch_in={pages:[]};$.ajaxSetup({async:false});if(set.mode=="live")for(var i=0;i");var t_2=html.toLowerCase().indexOf("",t_1+7);if(t_1!=-1&&t_2!=-1)var tit=html.slice(t_1+7,t_2);else var tit="No title";tipuesearch_in.pages.push({"title":tit,"text":desc,"tags":cont,"loc":tipuesearch_pages[i]})});if(set.mode=="json")$.getJSON(set.contentLocation,function(json){tipuesearch_in=$.extend({},json)}); +if(set.mode=="static")tipuesearch_in=$.extend({},tipuesearch);var tipue_search_w="";if(set.newWindow)tipue_search_w=' target="_blank"';function getURLP(name){return decodeURIComponent(((new RegExp("[?|&]"+name+"="+"([^&;]+?)(&|#|;|$)")).exec(location.search)||[,""])[1].replace(/\+/g,"%20"))||null}if(getURLP("q")){$("#tipue_search_input").val(getURLP("q"));getTipueSearch(0,true)}$("#tipue_search_button").click(function(){getTipueSearch(0,true)});$(this).keyup(function(event){if(event.keyCode=="13")getTipueSearch(0, +true)});function getTipueSearch(start,replace){$("#tipue_search_content").hide();var out="";var results="";var show_replace=false;var show_stop=false;var d=$("#tipue_search_input").val().toLowerCase();d=$.trim(d);var d_w=d.split(" ");d="";for(var i=0;i=set.minimumLength){if(replace){var d_r=d;for(var i= +0;i$1")}if(tipuesearch_in.pages[i].tags.search(pat)!=-1)score-=1E5-i}if(score<1E9)found[c++]=score+"^"+tipuesearch_in.pages[i].title+"^"+s_t+"^"+tipuesearch_in.pages[i].loc}if(c!= +0){if(show_replace==1){out+='
Showing results for '+d+"
";out+='
Search for '+d_r+"
"}if(c==1)out+='
1 result
';else{c_c=c.toString().replace(/\B(?=(\d{3})+(?!\d))/g,",");out+='
'+c_c+" results
"}found.sort();var l_o=0;for(var i=0;i= +start&&l_o"+fo[1]+"
";var t=fo[2];var t_d="";var t_w=t.split(" ");if(t_w.length";if(set.showURL)out+='
"+fo[3]+ +"
"}l_o++}if(c>set.show){var pages=Math.ceil(c/set.show);var page=start/set.show;out+='
    ';if(start>0)out+='
  • « Prev
    • ';if(page<=2){var p_b=pages;if(pages>3)p_b=3;for(var f=0;f'+(f+1)+"";else out+='
  • '+(f+1)+"
    • "}else{var p_b=pages+2;if(p_b>pages)p_b=pages;for(var f=page;f'+(f+1)+"";else out+='
  • '+(f+1)+"
    • "}if(page+1!=pages)out+='
  • Next »
    • ';out+="
"}}else out+='
Nothing found
'}else if(show_stop)out+= +'
Nothing found
Common words are largely ignored
';else{out+='
Search too short
';if(set.minimumLength==1)out+='
Should be one character or more
';else out+='
Should be '+set.minimumLength+" characters or more
"}$("#tipue_search_content").html(out);$("#tipue_search_content").slideDown(200);$("#tipue_search_replaced").click(function(){getTipueSearch(0, +false)});$(".tipue_search_foot_box").click(function(){var id_v=$(this).attr("id");var id_a=id_v.split("_");getTipueSearch(parseInt(id_a[0]),id_a[1])})}})}})(jQuery); diff --git a/docs/theme/mkdocs/tipuesearch/tipuesearch_content.js b/docs/theme/mkdocs/tipuesearch/tipuesearch_content.js new file mode 100644 index 0000000000..f20d45a42b --- /dev/null +++ b/docs/theme/mkdocs/tipuesearch/tipuesearch_content.js @@ -0,0 +1,13 @@ +var tipuesearch = {"pages": [ + {"title": "Tipue Search, a site search engine jQuery plugin", "text": "Tipue Search is a site search engine jQuery plugin. Tipue Search is open source and released under the MIT License, which means it's free for both commercial and non-commercial use. Tipue Search is responsive and works on all reasonably modern browsers.", "tags": "JavaScript", "loc": "http://www.tipue.com/search"}, + {"title": "Tipue Search Static mode demo", "text": "This is a demo of Tipue Search Static mode.", "tags": "", "loc": "http://www.tipue.com/search/demos/static"}, + {"title": "Tipue Image Search demo", "text": "This is a demo of Tipue Image Search.", "tags": "", "loc": "http://www.tipue.com/search/demos/images"}, + {"title": "Tipue Search docs", "text": "If you haven't already done so, download Tipue Search. Copy the tipuesearch folder to your site.", "tags": "documentation", "loc": "http://www.tipue.com/search/docs"}, + {"title": "Tipue drop, a search suggestion box jQuery plugin", "text": "Tipue drop is a search suggestion box jQuery plugin. Tipue drop is open source and released under the MIT License, which means it's free for both commercial and non-commercial use. Tipue drop is responsive and works on all reasonably modern browsers.", "tags": "JavaScript", "loc": "http://www.tipue.com/drop"}, + {"title": "Tipue drop demo", "text": "Tipue drop demo. Tipue drop is a search suggestion box jQuery plugin.", "tags": "JavaScript", "loc": "http://www.tipue.com/drop/demo"}, + {"title": "Support plans", "text": "Stuck? We offer a range of flexible support plans for our jQuery plugins.", "tags": "", "loc": "http://www.tipue.com/support"}, + {"title": "About Tipue", "text": "Tipue is a small web development studio based in North London. We've been around for over a decade. We like Perl, MySQL and jQuery.", "tags": "", "loc": "http://www.tipue.com/about"} +]}; + + + diff --git a/docs/theme/mkdocs/tipuesearch/tipuesearch_set.js b/docs/theme/mkdocs/tipuesearch/tipuesearch_set.js new file mode 100644 index 0000000000..6bda3fad66 --- /dev/null +++ b/docs/theme/mkdocs/tipuesearch/tipuesearch_set.js @@ -0,0 +1,23 @@ + +/* +Tipue Search 3.1 +Copyright (c) 2013 Tipue +Tipue Search is released under the MIT License +http://www.tipue.com/search +*/ + + +var tipuesearch_stop_words = ["and", "be", "by", "do", "for", "he", "how", "if", "is", "it", "my", "not", "of", "or", "the", "to", "up", "what", "when"]; + +var tipuesearch_replace = {"words": [ + {"word": "tipua", replace_with: "tipue"}, + {"word": "javscript", replace_with: "javascript"} +]}; + +var tipuesearch_stem = {"words": [ + {"word": "e-mail", stem: "email"}, + {"word": "javascript", stem: "script"}, + {"word": "javascript", stem: "js"} +]}; + + diff --git a/docs/theme/mkdocs/toc.html b/docs/theme/mkdocs/toc.html new file mode 100644 index 0000000000..5b7de24ffc --- /dev/null +++ b/docs/theme/mkdocs/toc.html @@ -0,0 +1,13 @@ +