From 2a2c694758d6a48125cc9adf446f2054b52db201 Mon Sep 17 00:00:00 2001 From: Vincent Batts Date: Mon, 10 Mar 2014 16:11:03 -0400 Subject: [PATCH 001/436] registry: make certain headers optional For a pull-only, static registry, there only a couple of headers that need to be optional (that are presently required. * X-Docker-Registry-Version * X-Docker-Size * X-Docker-Endpoints Docker-DCO-1.1-Signed-off-by: Vincent Batts (github: vbatts) --- registry/registry.go | 53 +++++++++++++++++++++++++++++++------------- 1 file changed, 38 insertions(+), 15 deletions(-) diff --git a/registry/registry.go b/registry/registry.go index dbf5d539ff..30079e9aa9 100644 --- a/registry/registry.go +++ b/registry/registry.go @@ -25,12 +25,8 @@ var ( errLoginRequired = errors.New("Authentication is required.") ) -func pingRegistryEndpoint(endpoint string) (bool, error) { - if endpoint == IndexServerAddress() { - // Skip the check, we now this one is valid - // (and we never want to fallback to http in case of error) - return false, nil - } +// reuse this chunk of code +func newClient() *http.Client { httpDial := func(proto string, addr string) (net.Conn, error) { // Set the connect timeout to 5 seconds conn, err := net.DialTimeout(proto, addr, time.Duration(5)*time.Second) @@ -42,17 +38,39 @@ func pingRegistryEndpoint(endpoint string) (bool, error) { return conn, nil } httpTransport := &http.Transport{Dial: httpDial} - client := &http.Client{Transport: httpTransport} + return &http.Client{Transport: httpTransport} +} + +// Have an API to access the version of the registry +func getRegistryVersion(endpoint string) (string, error) { + + client := newClient() + resp, err := client.Get(endpoint + "_version") + if err != nil { + return "", err + } + defer resp.Body.Close() + + if hdr := resp.Header.Get("X-Docker-Registry-Version"); hdr != "" { + return hdr, nil + } + versionBody, err := ioutil.ReadAll(resp.Body) + return string(versionBody), err +} + +func pingRegistryEndpoint(endpoint string) (bool, error) { + if endpoint == IndexServerAddress() { + // Skip the check, we now this one is valid + // (and we never want to fallback to http in case of error) + return false, nil + } + client := newClient() resp, err := client.Get(endpoint + "_ping") if err != nil { return false, err } defer resp.Body.Close() - if resp.Header.Get("X-Docker-Registry-Version") == "" { - return false, errors.New("This does not look like a Registry server (\"X-Docker-Registry-Version\" header not found in the response)") - } - standalone := resp.Header.Get("X-Docker-Registry-Standalone") utils.Debugf("Registry standalone header: '%s'", standalone) // If the header is absent, we assume true for compatibility with earlier @@ -223,9 +241,13 @@ func (r *Registry) GetRemoteImageJSON(imgID, registry string, token []string) ([ return nil, -1, utils.NewHTTPRequestError(fmt.Sprintf("HTTP code %d", res.StatusCode), res) } - imageSize, err := strconv.Atoi(res.Header.Get("X-Docker-Size")) - if err != nil { - return nil, -1, err + // if the size header is not present, then set it to '-1' + imageSize := -1 + if hdr := res.Header.Get("X-Docker-Size"); hdr != "" { + imageSize, err = strconv.Atoi(hdr) + if err != nil { + return nil, -1, err + } } jsonString, err := ioutil.ReadAll(res.Body) @@ -336,7 +358,8 @@ func (r *Registry) GetRepositoryData(remote string) (*RepositoryData, error) { endpoints = append(endpoints, fmt.Sprintf("%s://%s/v1/", urlScheme, ep)) } } else { - return nil, fmt.Errorf("Index response didn't contain any endpoints") + // Assume the endpoint is on the same host + endpoints = append(endpoints, fmt.Sprintf("%s://%s/v1/", urlScheme, req.URL.Host)) } checksumsJSON, err := ioutil.ReadAll(res.Body) From 2b855afaeedcab3117876815ec2f8d4450a742b5 Mon Sep 17 00:00:00 2001 From: Vincent Batts Date: Tue, 11 Mar 2014 23:36:51 -0400 Subject: [PATCH 002/436] registry: Info collection roll version and standalone information into the _ping. And to support Headers they are checked after the JSON is loaded (if there is anything to load). To stay backwards compatible, if the _ping contents are not able to unmarshal to RegistryInfo, do not stop, but continue with the same behavior. Docker-DCO-1.1-Signed-off-by: Vincent Batts (github: vbatts) --- registry/registry.go | 84 +++++++++++++++++++++++--------------------- 1 file changed, 43 insertions(+), 41 deletions(-) diff --git a/registry/registry.go b/registry/registry.go index 30079e9aa9..6040d75003 100644 --- a/registry/registry.go +++ b/registry/registry.go @@ -25,8 +25,12 @@ var ( errLoginRequired = errors.New("Authentication is required.") ) -// reuse this chunk of code -func newClient() *http.Client { +func pingRegistryEndpoint(endpoint string) (RegistryInfo, error) { + if endpoint == IndexServerAddress() { + // Skip the check, we now this one is valid + // (and we never want to fallback to http in case of error) + return RegistryInfo{Standalone: false}, nil + } httpDial := func(proto string, addr string) (net.Conn, error) { // Set the connect timeout to 5 seconds conn, err := net.DialTimeout(proto, addr, time.Duration(5)*time.Second) @@ -38,51 +42,44 @@ func newClient() *http.Client { return conn, nil } httpTransport := &http.Transport{Dial: httpDial} - return &http.Client{Transport: httpTransport} -} - -// Have an API to access the version of the registry -func getRegistryVersion(endpoint string) (string, error) { - - client := newClient() - resp, err := client.Get(endpoint + "_version") - if err != nil { - return "", err - } - defer resp.Body.Close() - - if hdr := resp.Header.Get("X-Docker-Registry-Version"); hdr != "" { - return hdr, nil - } - versionBody, err := ioutil.ReadAll(resp.Body) - return string(versionBody), err -} - -func pingRegistryEndpoint(endpoint string) (bool, error) { - if endpoint == IndexServerAddress() { - // Skip the check, we now this one is valid - // (and we never want to fallback to http in case of error) - return false, nil - } - client := newClient() + client := &http.Client{Transport: httpTransport} resp, err := client.Get(endpoint + "_ping") if err != nil { - return false, err + return RegistryInfo{Standalone: false}, err } defer resp.Body.Close() + jsonString, err := ioutil.ReadAll(resp.Body) + if err != nil { + return RegistryInfo{Standalone: false}, fmt.Errorf("Error while reading the http response: %s", err) + } + + // If the header is absent, we assume true for compatibility with earlier + // versions of the registry. default to true + info := RegistryInfo{ + Standalone: true, + } + if err := json.Unmarshal(jsonString, &info); err != nil { + utils.Debugf("Error unmarshalling the _ping RegistryInfo: %s", err) + // don't stop here. Just assume sane defaults + } + if hdr := resp.Header.Get("X-Docker-Registry-Version"); hdr != "" { + utils.Debugf("Registry version header: '%s'", hdr) + info.Version = hdr + } + utils.Debugf("RegistryInfo.Version: %q", info.Version) + standalone := resp.Header.Get("X-Docker-Registry-Standalone") utils.Debugf("Registry standalone header: '%s'", standalone) - // If the header is absent, we assume true for compatibility with earlier - // versions of the registry - if standalone == "" { - return true, nil - // Accepted values are "true" (case-insensitive) and "1". - } else if strings.EqualFold(standalone, "true") || standalone == "1" { - return true, nil + // Accepted values are "true" (case-insensitive) and "1". + if strings.EqualFold(standalone, "true") || standalone == "1" { + info.Standalone = true + } else if len(standalone) > 0 { + // there is a header set, and it is not "true" or "1", so assume fails + info.Standalone = false } - // Otherwise, not standalone - return false, nil + utils.Debugf("RegistryInfo.Standalone: %q", info.Standalone) + return info, nil } func validateRepositoryName(repositoryName string) error { @@ -688,6 +685,11 @@ type ImgData struct { Tag string `json:",omitempty"` } +type RegistryInfo struct { + Version string `json:"version"` + Standalone bool `json:"standalone"` +} + type Registry struct { client *http.Client authConfig *AuthConfig @@ -716,11 +718,11 @@ func NewRegistry(authConfig *AuthConfig, factory *utils.HTTPRequestFactory, inde // If we're working with a standalone private registry over HTTPS, send Basic Auth headers // alongside our requests. if indexEndpoint != IndexServerAddress() && strings.HasPrefix(indexEndpoint, "https://") { - standalone, err := pingRegistryEndpoint(indexEndpoint) + info, err := pingRegistryEndpoint(indexEndpoint) if err != nil { return nil, err } - if standalone { + if info.Standalone { utils.Debugf("Endpoint %s is eligible for private registry registry. Enabling decorator.", indexEndpoint) dec := utils.NewHTTPAuthDecorator(authConfig.Username, authConfig.Password) factory.AddDecorator(dec) From cea43f8a2da49dc9de35979829ff1876d48aea2c Mon Sep 17 00:00:00 2001 From: Vincent Batts Date: Thu, 3 Apr 2014 10:54:54 -0400 Subject: [PATCH 003/436] docker daemon: show info about the server For combing through logs, have an intro line with information about the running instance of the docker daemon. Docker-DCO-1.1-Signed-off-by: Vincent Batts (github: vbatts) --- docker/docker.go | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docker/docker.go b/docker/docker.go index e96c173d30..a4cbe8d865 100644 --- a/docker/docker.go +++ b/docker/docker.go @@ -157,6 +157,13 @@ func main() { } }() + // TODO actually have a resolved graphdriver to show? + log.Printf("docker daemon: %s %s; execdriver: %s; graphdriver: %s", + dockerversion.VERSION, + dockerversion.GITCOMMIT, + *flExecDriver, + *flGraphDriver) + // Serve api job := eng.Job("serveapi", flHosts.GetAll()...) job.SetenvBool("Logging", true) From 81370b5b0fc6788bbde32fd9f39c6eee1bcb0c2e Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Fri, 4 Apr 2014 00:37:50 -0600 Subject: [PATCH 004/436] Add new validate-dco and validate-gofmt bundlescripts for DCO and gofmt validation Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- .travis.yml | 12 ++-------- hack/make.sh | 6 +++++ hack/make/.validate | 33 ++++++++++++++++++++++++++++ hack/make/validate-dco | 47 ++++++++++++++++++++++++++++++++++++++++ hack/make/validate-gofmt | 30 +++++++++++++++++++++++++ 5 files changed, 118 insertions(+), 10 deletions(-) create mode 100644 hack/make/.validate create mode 100644 hack/make/validate-dco create mode 100644 hack/make/validate-gofmt diff --git a/.travis.yml b/.travis.yml index b8e4d43fcc..85aaec13f5 100644 --- a/.travis.yml +++ b/.travis.yml @@ -12,19 +12,11 @@ before_script: - env | sort - sudo apt-get update -qq - sudo apt-get install -qq python-yaml - - git remote add upstream git://github.com/dotcloud/docker.git - - upstream=master; - if [ "$TRAVIS_PULL_REQUEST" != false ]; then - upstream=$TRAVIS_BRANCH; - fi; - git fetch --append --no-tags upstream refs/heads/$upstream:refs/remotes/upstream/$upstream -# sometimes we have upstream master already as origin/master (PRs), but other times we don't, so let's just make sure we have a completely unambiguous way to specify "upstream master" from here out -# but if it's a PR against non-master, we need that upstream branch instead :) - sudo pip install -r docs/requirements.txt script: - - hack/travis/dco.py - - hack/travis/gofmt.py + - hack/make.sh validate-dco + - hack/make.sh validate-gofmt - make -sC docs SPHINXOPTS=-qW docs man # vim:set sw=2 ts=2: diff --git a/hack/make.sh b/hack/make.sh index e81271370d..4db4349518 100755 --- a/hack/make.sh +++ b/hack/make.sh @@ -40,13 +40,19 @@ echo # List of bundles to create when no argument is passed DEFAULT_BUNDLES=( + validate-dco + validate-gofmt + binary + test test-integration test-integration-cli + dynbinary dyntest dyntest-integration + cover cross tgz diff --git a/hack/make/.validate b/hack/make/.validate new file mode 100644 index 0000000000..cf6be53a68 --- /dev/null +++ b/hack/make/.validate @@ -0,0 +1,33 @@ +#!/bin/bash + +if [ -z "$VALIDATE_UPSTREAM" ]; then + # this is kind of an expensive check, so let's not do this twice if we + # are running more than one validate bundlescript + + VALIDATE_REPO='https://github.com/dotcloud/docker.git' + VALIDATE_BRANCH='master' + + if [ "$TRAVIS" = 'true' -a "$TRAVIS_PULL_REQUEST" != 'false' ]; then + VALIDATE_REPO="https://github.com/${TRAVIS_REPO_SLUG}.git" + VALIDATE_BRANCH="${TRAVIS_BRANCH}" + fi + + VALIDATE_HEAD="$(git rev-parse --verify HEAD)" + + git fetch -q "$VALIDATE_REPO" "refs/heads/$VALIDATE_BRANCH" + VALIDATE_UPSTREAM="$(git rev-parse --verify FETCH_HEAD)" + + VALIDATE_COMMIT_LOG="$VALIDATE_UPSTREAM..$VALIDATE_HEAD" + VALIDATE_COMMIT_DIFF="$VALIDATE_UPSTREAM...$VALIDATE_HEAD" + + validate_diff() { + if [ "$VALIDATE_UPSTREAM" != "$VALIDATE_HEAD" ]; then + git diff "$VALIDATE_COMMIT_DIFF" "$@" + fi + } + validate_log() { + if [ "$VALIDATE_UPSTREAM" != "$VALIDATE_HEAD" ]; then + git log "$VALIDATE_COMMIT_LOG" "$@" + fi + } +fi diff --git a/hack/make/validate-dco b/hack/make/validate-dco new file mode 100644 index 0000000000..6dbbe2250f --- /dev/null +++ b/hack/make/validate-dco @@ -0,0 +1,47 @@ +#!/bin/bash + +source "$(dirname "$BASH_SOURCE")/.validate" + +adds=$(validate_diff --numstat | awk '{ s += $1 } END { print s }') +dels=$(validate_diff --numstat | awk '{ s += $2 } END { print s }') +notDocs="$(validate_diff --numstat | awk '$3 !~ /^docs\// { print $3 }')" + +: ${adds:=0} +: ${dels:=0} + +if [ $adds -eq 0 -a $dels -eq 0 ]; then + echo '0 adds, 0 deletions; nothing to validate! :)' +elif [ -z "$notDocs" -a $adds -le 1 -a $dels -le 1 ]; then + echo 'Congratulations! DCO small-patch-exception material!' +else + dcoPrefix='Docker-DCO-1.1-Signed-off-by:' + dcoRegex="^$dcoPrefix ([^<]+) <([^<>@]+@[^<>]+)> \\(github: (\S+)\\)$" + commits=( $(validate_log --format='format:%H%n') ) + badCommits=() + for commit in "${commits[@]}"; do + if [ -z "$(git log -1 --format='format:' --name-status "$commit")" ]; then + # no content (ie, Merge commit, etc) + continue + fi + if ! git log -1 --format='format:%B' "$commit" | grep -qE "$dcoRegex"; then + badCommits+=( "$commit" ) + fi + done + if [ ${#badCommits[@]} -eq 0 ]; then + echo "Congratulations! All commits are properly signed with the DCO!" + else + { + echo "These commits do not have a proper '$dcoPrefix' marker:" + for commit in "${badCommits[@]}"; do + echo " - $commit" + done + echo + echo 'Please amend each commit to include a properly formatted DCO marker.' + echo + echo 'Visit the following URL for information about the Docker DCO:' + echo ' https://github.com/dotcloud/docker/blob/master/CONTRIBUTING.md#sign-your-work' + echo + } >&2 + false + fi +fi diff --git a/hack/make/validate-gofmt b/hack/make/validate-gofmt new file mode 100644 index 0000000000..8fc88cc559 --- /dev/null +++ b/hack/make/validate-gofmt @@ -0,0 +1,30 @@ +#!/bin/bash + +source "$(dirname "$BASH_SOURCE")/.validate" + +IFS=$'\n' +files=( $(validate_diff --diff-filter=ACMR --name-only -- '*.go' | grep -v '^vendor/' || true) ) +unset IFS + +badFiles=() +for f in "${files[@]}"; do + # we use "git show" here to validate that what's committed is formatted + if [ "$(git show "$VALIDATE_HEAD:$f" | gofmt -s -l)" ]; then + badFiles+=( "$f" ) + fi +done + +if [ ${#badFiles[@]} -eq 0 ]; then + echo 'Congratulations! All Go source files are properly formatted.' +else + { + echo "These files are not properly gofmt'd:" + for f in "${badFiles[@]}"; do + echo " - $f" + done + echo + echo 'Please reformat the above files using "gofmt -s -w" and commit the result.' + echo + } >&2 + false +fi From 919fe7a3a19d79dcbc92050325f46d7a7eb50ebc Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Fri, 4 Apr 2014 00:46:47 -0600 Subject: [PATCH 005/436] Remove the old Travis-specific files that are no longer necessary Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- .travis.yml | 2 -- hack/travis/dco.py | 54 -------------------------------------------- hack/travis/env.py | 21 ----------------- hack/travis/gofmt.py | 31 ------------------------- 4 files changed, 108 deletions(-) delete mode 100755 hack/travis/dco.py delete mode 100644 hack/travis/env.py delete mode 100755 hack/travis/gofmt.py diff --git a/.travis.yml b/.travis.yml index 85aaec13f5..832a8dd477 100644 --- a/.travis.yml +++ b/.travis.yml @@ -10,8 +10,6 @@ install: true before_script: - env | sort - - sudo apt-get update -qq - - sudo apt-get install -qq python-yaml - sudo pip install -r docs/requirements.txt script: diff --git a/hack/travis/dco.py b/hack/travis/dco.py deleted file mode 100755 index f873940815..0000000000 --- a/hack/travis/dco.py +++ /dev/null @@ -1,54 +0,0 @@ -#!/usr/bin/env python -import re -import subprocess -import yaml - -from env import commit_range - -commit_format = '-%n hash: "%h"%n author: %aN <%aE>%n message: |%n%w(0,2,2).%B' - -gitlog = subprocess.check_output([ - 'git', 'log', '--reverse', - '--format=format:'+commit_format, - '..'.join(commit_range), '--', -]) - -commits = yaml.load(gitlog) -if not commits: - exit(0) # what? how can we have no commits? - -DCO = 'Docker-DCO-1.1-Signed-off-by:' - -p = re.compile(r'^{0} ([^<]+) <([^<>@]+@[^<>]+)> \(github: (\S+)\)$'.format(re.escape(DCO)), re.MULTILINE|re.UNICODE) - -failed_commits = 0 - -for commit in commits: - commit['message'] = commit['message'][1:] - # trim off our '.' that exists just to prevent fun YAML parsing issues - # see https://github.com/dotcloud/docker/pull/3836#issuecomment-33723094 - # and https://travis-ci.org/dotcloud/docker/builds/17926783 - - commit['stat'] = subprocess.check_output([ - 'git', 'log', '--format=format:', '--max-count=1', - '--name-status', commit['hash'], '--', - ]) - if commit['stat'] == '': - print 'Commit {0} has no actual changed content, skipping.'.format(commit['hash']) - continue - - m = p.search(commit['message']) - if not m: - print 'Commit {1} does not have a properly formatted "{0}" marker.'.format(DCO, commit['hash']) - failed_commits += 1 - continue # print ALL the commits that don't have a proper DCO - - (name, email, github) = m.groups() - - # TODO verify that "github" is the person who actually made this commit via the GitHub API - -if failed_commits > 0: - exit(failed_commits) - -print 'All commits have a valid "{0}" marker.'.format(DCO) -exit(0) diff --git a/hack/travis/env.py b/hack/travis/env.py deleted file mode 100644 index 9830b8df34..0000000000 --- a/hack/travis/env.py +++ /dev/null @@ -1,21 +0,0 @@ -import os -import subprocess - -if 'TRAVIS' not in os.environ: - print 'TRAVIS is not defined; this should run in TRAVIS. Sorry.' - exit(127) - -if os.environ['TRAVIS_PULL_REQUEST'] != 'false': - commit_range = ['upstream/' + os.environ['TRAVIS_BRANCH'], 'FETCH_HEAD'] -else: - try: - subprocess.check_call([ - 'git', 'log', '-1', '--format=format:', - os.environ['TRAVIS_COMMIT_RANGE'], '--', - ]) - commit_range = os.environ['TRAVIS_COMMIT_RANGE'].split('...') - if len(commit_range) == 1: # if it didn't split, it must have been separated by '..' instead - commit_range = commit_range[0].split('..') - except subprocess.CalledProcessError: - print 'TRAVIS_COMMIT_RANGE is invalid. This seems to be a force push. We will just assume it must be against upstream master and compare all commits in between.' - commit_range = ['upstream/master', 'HEAD'] diff --git a/hack/travis/gofmt.py b/hack/travis/gofmt.py deleted file mode 100755 index dc724bc90e..0000000000 --- a/hack/travis/gofmt.py +++ /dev/null @@ -1,31 +0,0 @@ -#!/usr/bin/env python -import subprocess - -from env import commit_range - -files = subprocess.check_output([ - 'git', 'diff', '--diff-filter=ACMR', - '--name-only', '...'.join(commit_range), '--', -]) - -exit_status = 0 - -for filename in files.split('\n'): - if filename.startswith('vendor/'): - continue # we can't be changing our upstream vendors for gofmt, so don't even check them - - if filename.endswith('.go'): - try: - out = subprocess.check_output(['gofmt', '-s', '-l', filename]) - if out != '': - print out, - exit_status = 1 - except subprocess.CalledProcessError: - exit_status = 1 - -if exit_status != 0: - print 'Reformat the files listed above with "gofmt -s -w" and try again.' - exit(exit_status) - -print 'All files pass gofmt.' -exit(0) From ea2fba5ce04d3eb2a8959b8f5116604faae1e88a Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Sat, 15 Feb 2014 14:11:15 -0800 Subject: [PATCH 006/436] Engine: optional Logging field to disable custom logging in engine. * The default behavior is preserved * This disables the use of the `TEST` environment variable in engine. Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- engine/engine.go | 14 +++++++++----- engine/job.go | 8 ++------ 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/engine/engine.go b/engine/engine.go index 685924077c..6a54b3591e 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -44,6 +44,7 @@ type Engine struct { Stdout io.Writer Stderr io.Writer Stdin io.Reader + Logging bool } func (eng *Engine) Root() string { @@ -96,6 +97,7 @@ func New(root string) (*Engine, error) { Stdout: os.Stdout, Stderr: os.Stderr, Stdin: os.Stdin, + Logging: true, } eng.Register("commands", func(job *Job) Status { for _, name := range eng.commands() { @@ -137,7 +139,9 @@ func (eng *Engine) Job(name string, args ...string) *Job { Stderr: NewOutput(), env: &Env{}, } - job.Stderr.Add(utils.NopWriteCloser(eng.Stderr)) + if eng.Logging { + job.Stderr.Add(utils.NopWriteCloser(eng.Stderr)) + } handler, exists := eng.handlers[name] if exists { job.handler = handler @@ -188,9 +192,9 @@ func (eng *Engine) ParseJob(input string) (*Job, error) { } func (eng *Engine) Logf(format string, args ...interface{}) (n int, err error) { - if os.Getenv("TEST") == "" { - prefixedFormat := fmt.Sprintf("[%s] %s\n", eng, strings.TrimRight(format, "\n")) - return fmt.Fprintf(eng.Stderr, prefixedFormat, args...) + if !eng.Logging { + return 0, nil } - return 0, nil + prefixedFormat := fmt.Sprintf("[%s] %s\n", eng, strings.TrimRight(format, "\n")) + return fmt.Fprintf(eng.Stderr, prefixedFormat, args...) } diff --git a/engine/job.go b/engine/job.go index e83e18e4d7..50d64011f9 100644 --- a/engine/job.go +++ b/engine/job.go @@ -3,7 +3,6 @@ package engine import ( "fmt" "io" - "os" "strings" "time" ) @@ -189,11 +188,8 @@ func (job *Job) Environ() map[string]string { } func (job *Job) Logf(format string, args ...interface{}) (n int, err error) { - if os.Getenv("TEST") == "" { - prefixedFormat := fmt.Sprintf("[%s] %s\n", job, strings.TrimRight(format, "\n")) - return fmt.Fprintf(job.Stderr, prefixedFormat, args...) - } - return 0, nil + prefixedFormat := fmt.Sprintf("[%s] %s\n", job, strings.TrimRight(format, "\n")) + return fmt.Fprintf(job.Stderr, prefixedFormat, args...) } func (job *Job) Printf(format string, args ...interface{}) (n int, err error) { From ab248675aa9f32c269e0ecbaf78af29583481379 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Mon, 7 Apr 2014 21:32:17 -0600 Subject: [PATCH 007/436] Add contrib/man to our generated deb Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- hack/make/ubuntu | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/hack/make/ubuntu b/hack/make/ubuntu index 403a6c7652..d7a4b16473 100644 --- a/hack/make/ubuntu +++ b/hack/make/ubuntu @@ -46,6 +46,18 @@ bundle_ubuntu() { mkdir -p $DIR/etc/fish/completions cp contrib/completion/fish/docker.fish $DIR/etc/fish/completions/ + # Include contributed man pages + manRoot="$DIR/usr/share/man" + mkdir -p "$manRoot" + for manDir in contrib/man/man*; do + manBase="$(basename "$manDir")" # "man1" + for manFile in "$manDir"/*; do + manName="$(basename "$manFile")" # "docker-build.1" + mkdir -p "$manRoot/$manBase" + gzip -c "$manFile" > "$manRoot/$manBase/$manName.gz" + done + done + # Copy the binary # This will fail if the binary bundle hasn't been built mkdir -p $DIR/usr/bin From 7908725e3f8b3c8a69fc6533f28c6789e4669eb0 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Mon, 7 Apr 2014 21:38:09 -0600 Subject: [PATCH 008/436] Fix a few minor man formatting consistency issues Some flags ended with a colon, some didn't. For man pages, the prevailing normal practice is not to end the flags lines with colons. Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- contrib/man/man1/docker-attach.1 | 4 +-- contrib/man/man1/docker-build.1 | 6 ++-- contrib/man/man1/docker-images.1 | 8 +++--- contrib/man/man1/docker-inspect.1 | 2 +- contrib/man/man1/docker-rm.1 | 6 ++-- contrib/man/man1/docker-rmi.1 | 2 +- contrib/man/man1/docker-run.1 | 48 +++++++++++++++---------------- contrib/man/man1/docker-tag.1 | 2 +- 8 files changed, 39 insertions(+), 39 deletions(-) diff --git a/contrib/man/man1/docker-attach.1 b/contrib/man/man1/docker-attach.1 index f0879d7507..94198933e3 100644 --- a/contrib/man/man1/docker-attach.1 +++ b/contrib/man/man1/docker-attach.1 @@ -15,10 +15,10 @@ If you \fBdocker run\fR a container in detached mode (\fB-d\fR), you can reattac You can detach from the container again (and leave it running) with CTRL-c (for a quiet exit) or CTRL-\ to get a stacktrace of the Docker client when it quits. When you detach from the container the exit code will be returned to the client. .SH "OPTIONS" .TP -.B --no-stdin=\fItrue\fR|\fIfalse\fR: +.B --no-stdin=\fItrue\fR|\fIfalse\fR When set to true, do not attach to stdin. The default is \fIfalse\fR. .TP -.B --sig-proxy=\fItrue\fR|\fIfalse\fR: +.B --sig-proxy=\fItrue\fR|\fIfalse\fR When set to true, proxify all received signal to the process (even in non-tty mode). The default is \fItrue\fR. .sp .SH EXAMPLES diff --git a/contrib/man/man1/docker-build.1 b/contrib/man/man1/docker-build.1 index 6546b7be2a..6d0a4c2e38 100644 --- a/contrib/man/man1/docker-build.1 +++ b/contrib/man/man1/docker-build.1 @@ -19,13 +19,13 @@ If the absolute path is provided instead of ‘.’, only the files and director When a single Dockerfile is given as URL, then no context is set. When a Git repository is set as URL, the repository is used as context. .SH "OPTIONS" .TP -.B -q, --quiet=\fItrue\fR|\fIfalse\fR: +.B -q, --quiet=\fItrue\fR|\fIfalse\fR When set to true, suppress verbose build output. Default is \fIfalse\fR. .TP -.B --rm=\fItrue\fr|\fIfalse\fR: +.B --rm=\fItrue\fr|\fIfalse\fR When true, remove intermediate containers that are created during the build process. The default is true. .TP -.B -t, --tag=\fItag\fR: +.B -t, --tag=\fItag\fR Tag to be applied to the resulting image on successful completion of the build. .TP .B --no-cache=\fItrue\fR|\fIfalse\fR diff --git a/contrib/man/man1/docker-images.1 b/contrib/man/man1/docker-images.1 index e540ba2b79..d88e2446c8 100644 --- a/contrib/man/man1/docker-images.1 +++ b/contrib/man/man1/docker-images.1 @@ -20,16 +20,16 @@ By default, intermediate images, used during builds, are not listed. Some of the The title REPOSITORY for the first title may seem confusing. It is essentially the image name. However, because you can tag a specific image, and multiple tags (image instances) can be associated with a single name, the name is really a repository for all tagged images of the same name. .SH "OPTIONS" .TP -.B -a, --all=\fItrue\fR|\fIfalse\fR: +.B -a, --all=\fItrue\fR|\fIfalse\fR When set to true, also include all intermediate images in the list. The default is false. .TP -.B --no-trunc=\fItrue\fR|\fIfalse\fR: +.B --no-trunc=\fItrue\fR|\fIfalse\fR When set to true, list the full image ID and not the truncated ID. The default is false. .TP -.B -q, --quiet=\fItrue\fR|\fIfalse\fR: +.B -q, --quiet=\fItrue\fR|\fIfalse\fR When set to true, list the complete image ID as part of the output. The default is false. .TP -.B -t, --tree=\fItrue\fR|\fIfalse\fR: +.B -t, --tree=\fItrue\fR|\fIfalse\fR When set to true, list the images in a tree dependency tree (hierarchy) format. The default is false. .TP .B -v, --viz=\fItrue\fR|\fIfalse\fR diff --git a/contrib/man/man1/docker-inspect.1 b/contrib/man/man1/docker-inspect.1 index 225125e564..3d1e18ba53 100644 --- a/contrib/man/man1/docker-inspect.1 +++ b/contrib/man/man1/docker-inspect.1 @@ -12,7 +12,7 @@ CONTAINER|IMAGE [CONTAINER|IMAGE...] This displays all the information available in Docker for a given container or image. By default, this will render all results in a JSON array. If a format is specified, the given template will be executed for each result. .SH "OPTIONS" .TP -.B -f, --format="": +.B -f, --format="" The text/template package of Go describes all the details of the format. See examples section .SH EXAMPLES .sp diff --git a/contrib/man/man1/docker-rm.1 b/contrib/man/man1/docker-rm.1 index b06e014d3b..4ec84571bb 100644 --- a/contrib/man/man1/docker-rm.1 +++ b/contrib/man/man1/docker-rm.1 @@ -14,13 +14,13 @@ CONTAINER [CONTAINER...] This will remove one or more containers from the host node. The container name or ID can be used. This does not remove images. You cannot remove a running container unless you use the \fB-f\fR option. To see all containers on a host use the \fBdocker ps -a\fR command. .SH "OPTIONS" .TP -.B -f, --force=\fItrue\fR|\fIfalse\fR: +.B -f, --force=\fItrue\fR|\fIfalse\fR When set to true, force the removal of the container. The default is \fIfalse\fR. .TP -.B -l, --link=\fItrue\fR|\fIfalse\fR: +.B -l, --link=\fItrue\fR|\fIfalse\fR When set to true, remove the specified link and not the underlying container. The default is \fIfalse\fR. .TP -.B -v, --volumes=\fItrue\fR|\fIfalse\fR: +.B -v, --volumes=\fItrue\fR|\fIfalse\fR When set to true, remove the volumes associated to the container. The default is \fIfalse\fR. .SH EXAMPLES .sp diff --git a/contrib/man/man1/docker-rmi.1 b/contrib/man/man1/docker-rmi.1 index 6f33446ecd..a4b5c05e7f 100644 --- a/contrib/man/man1/docker-rmi.1 +++ b/contrib/man/man1/docker-rmi.1 @@ -12,7 +12,7 @@ IMAGE [IMAGE...] This will remove one or more images from the host node. This does not remove images from a registry. You cannot remove an image of a running container unless you use the \fB-f\fR option. To see all images on a host use the \fBdocker images\fR command. .SH "OPTIONS" .TP -.B -f, --force=\fItrue\fR|\fIfalse\fR: +.B -f, --force=\fItrue\fR|\fIfalse\fR When set to true, force the removal of the image. The default is \fIfalse\fR. .SH EXAMPLES .sp diff --git a/contrib/man/man1/docker-run.1 b/contrib/man/man1/docker-run.1 index fd449374e3..ba191e1b40 100644 --- a/contrib/man/man1/docker-run.1 +++ b/contrib/man/man1/docker-run.1 @@ -30,69 +30,69 @@ If the \fIIMAGE\fR is not already loaded then \fBdocker run\fR will pull the \fI .SH "OPTIONS" .TP -.B -a, --attach=\fIstdin\fR|\fIstdout\fR|\fIstderr\fR: +.B -a, --attach=\fIstdin\fR|\fIstdout\fR|\fIstderr\fR Attach to stdin, stdout or stderr. In foreground mode (the default when -d is not specified), \fBdocker run\fR can start the process in the container and attach the console to the process’s standard input, output, and standard error. It can even pretend to be a TTY (this is what most commandline executables expect) and pass along signals. The \fB-a\fR option can be set for each of stdin, stdout, and stderr. .TP -.B -c, --cpu-shares=0: +.B -c, --cpu-shares=0 CPU shares in relative weight. You can increase the priority of a container with the -c option. By default, all containers run at 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 \fBdocker run\fR. .TP -.B -m, --memory=\fImemory-limit\fR: +.B -m, --memory=\fImemory-limit\fR Allows you to constrain the memory available to a container. If the host supports swap memory, then the -m memory setting can be larger than physical RAM. The memory limit format: , where unit = b, k, m or g. .TP -.B --cidfile=\fIfile\fR: +.B --cidfile=\fIfile\fR Write the container ID to the file specified. .TP -.B -d, --detach=\fItrue\fR|\fIfalse\fR: +.B -d, --detach=\fItrue\fR|\fIfalse\fR Detached mode. This runs the container in the background. It outputs the new container's id and and error messages. At any time you can run \fBdocker ps\fR in the other shell to view a list of the running containers. You can reattach to a detached container with \fBdocker attach\fR. If you choose to run a container in the detached mode, then you cannot use the -rm option. .TP -.B --dns=\fIIP-address\fR: +.B --dns=\fIIP-address\fR Set custom DNS servers. This option can be used to override the DNS configuration passed to the container. Typically this is necessary when the host DNS configuration is invalid for the container (eg. 127.0.0.1). When this is the case the \fB-dns\fR flags is necessary for every run. .TP -.B -e, --env=\fIenvironment\fR: +.B -e, --env=\fIenvironment\fR Set environment variables. This option allows you to specify arbitrary environment variables that are available for the process that will be launched inside of the container. .TP -.B --entrypoint=\ficommand\fR: +.B --entrypoint=\ficommand\fR This option allows you to overwrite the default entrypoint of the image that is set in the Dockerfile. The ENTRYPOINT of an image is similar to a COMMAND because it specifies what executable to run when the container starts, but it is (purposely) more difficult to override. The ENTRYPOINT gives a container its default nature or behavior, so that when you set an ENTRYPOINT you can run the container as if it were that binary, complete with default options, and you can pass in more options via the COMMAND. But, sometimes an operator may want to run something else inside the container, so you can override the default ENTRYPOINT at runtime by using a \fB--entrypoint\fR and a string to specify the new ENTRYPOINT. .TP -.B --expose=\fIport\fR: +.B --expose=\fIport\fR Expose a port from the container without publishing it to your host. A containers port can be exposed to other containers in three ways: 1) The developer can expose the port using the EXPOSE parameter of the Dockerfile, 2) the operator can use the \fB--expose\fR option with \fBdocker run\fR, or 3) the container can be started with the \fB--link\fR. .TP -.B -P, --publish-all=\fItrue\fR|\fIfalse\fR: +.B -P, --publish-all=\fItrue\fR|\fIfalse\fR When set to true publish all exposed ports to the host interfaces. The default is false. If the operator uses -P (or -p) then Docker will make the exposed port accessible on the host 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 \fBdocker port\fR. .TP -.B -p, --publish=[]: +.B -p, --publish=[] Publish a container's port to the host (format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort) (use 'docker port' to see the actual mapping) .TP -.B -h , --hostname=\fIhostname\fR: +.B -h , --hostname=\fIhostname\fR Sets the container host name that is available inside the container. .TP -.B -i , --interactive=\fItrue\fR|\fIfalse\fR: +.B -i , --interactive=\fItrue\fR|\fIfalse\fR When set to true, keep stdin open even if not attached. The default is false. .TP -.B --link=\fIname\fR:\fIalias\fR: +.B --link=\fIname\fR:\fIalias\fR Add link to another container. The format is name:alias. If the operator uses \fB--link\fR 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. .TP -.B -n, --networking=\fItrue\fR|\fIfalse\fR: +.B -n, --networking=\fItrue\fR|\fIfalse\fR By default, all containers have networking enabled (true) and can make outgoing connections. The operator can disable networking with \fB--networking\fR to false. This disables all incoming and outgoing networking. In cases like this, I/O can only be performed through files or by using STDIN/STDOUT. Also by default, the container will use the same DNS servers as the host. but you canThe operator may override this with \fB-dns\fR. .TP -.B --name=\fIname\fR: +.B --name=\fIname\fR Assign a name to the container. The operator can identify a container in three ways: .sp .nf @@ -104,37 +104,37 @@ Name (“jonah”) The UUID identifiers come from the Docker daemon, and if a name is not assigned to the container with \fB--name\fR then the daemon will also generate a random string name. The name is useful when defining links (see \fB--link\fR) (or any other place you need to identify a container). This works for both background and foreground Docker containers. .TP -.B --privileged=\fItrue\fR|\fIfalse\fR: +.B --privileged=\fItrue\fR|\fIfalse\fR Give extended privileges to this container. By default, Docker containers are “unprivileged” (=false) and cannot, for example, run a Docker daemon inside the Docker container. This is because by default a container is not allowed to access any devices. A “privileged” container is given access to all devices. When the operator executes \fBdocker run -privileged\fR, Docker will enable access to all devices on the host as well as set some configuration in AppArmor (\fB???\fR) to allow the container nearly all the same access to the host as processes running outside of a container on the host. .TP -.B --rm=\fItrue\fR|\fIfalse\fR: +.B --rm=\fItrue\fR|\fIfalse\fR If set to \fItrue\fR the container is automatically removed when it exits. The default is \fIfalse\fR. This option is incompatible with \fB-d\fR. .TP -.B --sig-proxy=\fItrue\fR|\fIfalse\fR: +.B --sig-proxy=\fItrue\fR|\fIfalse\fR When set to true, proxify all received signals to the process (even in non-tty mode). The default is true. .TP -.B -t, --tty=\fItrue\fR|\fIfalse\fR: +.B -t, --tty=\fItrue\fR|\fIfalse\fR When set to true Docker can allocate a pseudo-tty and attach to the standard input of any container. This can be used, for example, to run a throwaway interactive shell. The default is value is false. .TP -.B -u, --user=\fIusername\fR,\fRuid\fR: +.B -u, --user=\fIusername\fR,\fRuid\fR Set a username or UID for the container. .TP -.B -v, --volume=\fIvolume\fR: +.B -v, --volume=\fIvolume\fR Bind mount a volume to the container. The \fB-v\fR option can be used one or more times to add one or more mounts to a container. These mounts can then be used in other containers using the \fB--volumes-from\fR option. See examples. .TP -.B --volumes-from=\fIcontainer-id\fR: +.B --volumes-from=\fIcontainer-id\fR Will mount volumes from the specified container identified by container-id. Once a volume is mounted in a one container it can be shared with other containers using the \fB--volumes-from\fR option when running those other containers. The volumes can be shared even if the original container with the mount is not running. .TP -.B -w, --workdir=\fIdirectory\fR: +.B -w, --workdir=\fIdirectory\fR Working directory inside the container. The default working directory for running binaries within a container is the root directory (/). The developer can set a different default with the Dockerfile WORKDIR instruction. The operator can override the working directory by using the \fB-w\fR option. .TP diff --git a/contrib/man/man1/docker-tag.1 b/contrib/man/man1/docker-tag.1 index df85a1e8c1..eaff32cebd 100644 --- a/contrib/man/man1/docker-tag.1 +++ b/contrib/man/man1/docker-tag.1 @@ -12,7 +12,7 @@ docker-tag \- Tag an image in the repository This will tag an image in the repository. .SH "OPTIONS" .TP -.B -f, --force=\fItrue\fR|\fIfalse\fR: +.B -f, --force=\fItrue\fR|\fIfalse\fR When set to true, force the tag name. The default is \fIfalse\fR. .TP .B REGISTRYHOST: From 5737c2eb9878e36ee9476e0fd105bcd494252d12 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Mon, 7 Apr 2014 22:53:42 -0600 Subject: [PATCH 009/436] Update check-config.sh with more kernel configs and more reliable cgroup hierarchy/subsystem check Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- contrib/check-config.sh | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/contrib/check-config.sh b/contrib/check-config.sh index 53bf708404..cbdb90bcce 100755 --- a/contrib/check-config.sh +++ b/contrib/check-config.sh @@ -98,12 +98,16 @@ echo echo 'Generally Necessary:' echo -n '- ' -cgroupCpuDir="$(awk '/[, ]cpu([, ]|$)/ && $8 == "cgroup" { print $5 }' /proc/$$/mountinfo | head -n1)" -cgroupDir="$(dirname "$cgroupCpuDir")" -if [ -d "$cgroupDir/cpu" ]; then +cgroupSubsystemDir="$(awk '/[, ](cpu|cpuacct|cpuset|devices|freezer|memory)([, ]|$)/ && $8 == "cgroup" { print $5 }' /proc/$$/mountinfo | head -n1)" +cgroupDir="$(dirname "$cgroupSubsystemDir")" +if [ -d "$cgroupDir/cpu" -o -d "$cgroupDir/cpuacct" -o -d "$cgroupDir/cpuset" -o -d "$cgroupDir/devices" -o -d "$cgroupDir/freezer" -o -d "$cgroupDir/memory" ]; then echo "$(wrap_good 'cgroup hierarchy' 'properly mounted') [$cgroupDir]" else - echo "$(wrap_bad 'cgroup hierarchy' 'single mountpoint!') [$cgroupCpuDir]" + if [ "$cgroupSubsystemDir" ]; then + echo "$(wrap_bad 'cgroup hierarchy' 'single mountpoint!') [$cgroupSubsystemDir]" + else + echo "$(wrap_bad 'cgroup hierarchy' 'nonexistent??')" + fi echo " $(wrap_color '(see https://github.com/tianon/cgroupfs-mount)' yellow)" fi @@ -112,7 +116,8 @@ flags=( DEVPTS_MULTIPLE_INSTANCES CGROUPS CGROUP_DEVICE MACVLAN VETH BRIDGE - IP_NF_TARGET_MASQUERADE NETFILTER_XT_MATCH_{ADDRTYPE,CONNTRACK} + NF_NAT_IPV4 IP_NF_TARGET_MASQUERADE + NETFILTER_XT_MATCH_{ADDRTYPE,CONNTRACK} NF_NAT NF_NAT_NEEDED ) check_flags "${flags[@]}" From a67f3504425a6c3f210aa8117025518d4a2109f1 Mon Sep 17 00:00:00 2001 From: almoehi Date: Mon, 24 Mar 2014 18:08:14 +0100 Subject: [PATCH 010/436] Added reactive-docker to list of remote API clients Docker-DCO-1.1-Signed-off-by: H. Rapp (github: almoehi) --- docs/sources/reference/api/remote_api_client_libraries.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sources/reference/api/remote_api_client_libraries.rst b/docs/sources/reference/api/remote_api_client_libraries.rst index 4a445db36f..c94c68cd48 100644 --- a/docs/sources/reference/api/remote_api_client_libraries.rst +++ b/docs/sources/reference/api/remote_api_client_libraries.rst @@ -51,3 +51,5 @@ and we will add the libraries here. +----------------------+----------------+--------------------------------------------+----------+ | Perl | Eixo::Docker | https://github.com/alambike/eixo-docker | Active | +----------------------+----------------+--------------------------------------------+----------+ +| Scala | reactive-docker| https://github.com/almoehi/reactive-docker | Active | ++----------------------+----------------+--------------------------------------------+----------+ From 0a6d42e2085b9cd1d057779a5b0a80cd49292c37 Mon Sep 17 00:00:00 2001 From: Vincent Batts Date: Tue, 8 Apr 2014 12:39:25 -0400 Subject: [PATCH 011/436] docker save: fix filemode permissions currently the files created are not readable. This makes the files and directories permissions more sane. Docker-DCO-1.1-Signed-off-by: Vincent Batts (github: vbatts) --- server/server.go | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/server/server.go b/server/server.go index 9cabf17889..ba84408f7e 100644 --- a/server/server.go +++ b/server/server.go @@ -340,7 +340,7 @@ func (srv *Server) ImageExport(job *engine.Job) engine.Status { rootRepoMap[name] = rootRepo rootRepoJson, _ := json.Marshal(rootRepoMap) - if err := ioutil.WriteFile(path.Join(tempdir, "repositories"), rootRepoJson, os.ModeAppend); err != nil { + if err := ioutil.WriteFile(path.Join(tempdir, "repositories"), rootRepoJson, os.FileMode(0644)); err != nil { return job.Error(err) } } else { @@ -369,7 +369,7 @@ func (srv *Server) exportImage(img *image.Image, tempdir string) error { for i := img; i != nil; { // temporary directory tmpImageDir := path.Join(tempdir, i.ID) - if err := os.Mkdir(tmpImageDir, os.ModeDir); err != nil { + if err := os.Mkdir(tmpImageDir, os.FileMode(0755)); err != nil { if os.IsExist(err) { return nil } @@ -379,7 +379,7 @@ func (srv *Server) exportImage(img *image.Image, tempdir string) error { var version = "1.0" var versionBuf = []byte(version) - if err := ioutil.WriteFile(path.Join(tmpImageDir, "VERSION"), versionBuf, os.ModeAppend); err != nil { + if err := ioutil.WriteFile(path.Join(tmpImageDir, "VERSION"), versionBuf, os.FileMode(0644)); err != nil { return err } @@ -388,7 +388,7 @@ func (srv *Server) exportImage(img *image.Image, tempdir string) error { if err != nil { return err } - if err := ioutil.WriteFile(path.Join(tmpImageDir, "json"), b, os.ModeAppend); err != nil { + if err := ioutil.WriteFile(path.Join(tmpImageDir, "json"), b, os.FileMode(0644)); err != nil { return err } From e8aa24c71a53b27d68e2468aaa3be056596b88ed Mon Sep 17 00:00:00 2001 From: unclejack Date: Wed, 9 Apr 2014 02:02:15 +0300 Subject: [PATCH 012/436] Change version to v0.10.0 Docker-DCO-1.1-Signed-off-by: Cristian Staretu (github: unclejack) --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index 78bc1abd14..29b2d3ea50 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.10.0 +0.10.0-dev From 1e6f21dc9e7b172b28d364741abb92540938c51a Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Tue, 8 Apr 2014 18:08:20 -0700 Subject: [PATCH 013/436] Make remote API unit tests easier to read and write Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- api/server/server_unit_test.go | 142 +++++++++++++++------------------ 1 file changed, 65 insertions(+), 77 deletions(-) diff --git a/api/server/server_unit_test.go b/api/server/server_unit_test.go index 3dbba640ff..561f47d343 100644 --- a/api/server/server_unit_test.go +++ b/api/server/server_unit_test.go @@ -1,6 +1,8 @@ package server import ( + "bytes" + "encoding/json" "fmt" "github.com/dotcloud/docker/api" "github.com/dotcloud/docker/engine" @@ -57,15 +59,8 @@ func TesthttpError(t *testing.T) { } func TestGetVersion(t *testing.T) { - tmp, err := utils.TestDirectory("") - if err != nil { - t.Fatal(err) - } - defer os.RemoveAll(tmp) - eng, err := engine.New(tmp) - if err != nil { - t.Fatal(err) - } + eng := tmpEngine(t) + defer rmEngine(eng) var called bool eng.Register("version", func(job *engine.Job) engine.Status { called = true @@ -80,49 +75,22 @@ func TestGetVersion(t *testing.T) { } return engine.StatusOK }) - - r := httptest.NewRecorder() - req, err := http.NewRequest("GET", "/version", nil) - if err != nil { - t.Fatal(err) - } - // FIXME getting the version should require an actual running Server - if err := ServeRequest(eng, api.APIVERSION, r, req); err != nil { - t.Fatal(err) - } + r := serveRequest("GET", "/version", nil, eng, t) if !called { t.Fatalf("handler was not called") } - out := engine.NewOutput() - v, err := out.AddEnv() - if err != nil { - t.Fatal(err) + v := readEnv(r.Body, t) + if v.Get("Version") != "42.1" { + t.Fatalf("%#v\n", v) } - if _, err := io.Copy(out, r.Body); err != nil { - t.Fatal(err) - } - out.Close() - expected := "42.1" - if result := v.Get("Version"); result != expected { - t.Errorf("Expected version %s, %s found", expected, result) - } - expected = "application/json" - if result := r.HeaderMap.Get("Content-Type"); result != expected { - t.Errorf("Expected Content-Type %s, %s found", expected, result) + if r.HeaderMap.Get("Content-Type") != "application/json" { + t.Fatalf("%#v\n", r) } } func TestGetInfo(t *testing.T) { - tmp, err := utils.TestDirectory("") - if err != nil { - t.Fatal(err) - } - defer os.RemoveAll(tmp) - eng, err := engine.New(tmp) - if err != nil { - t.Fatal(err) - } - + eng := tmpEngine(t) + defer rmEngine(eng) var called bool eng.Register("info", func(job *engine.Job) engine.Status { called = true @@ -134,47 +102,67 @@ func TestGetInfo(t *testing.T) { } return engine.StatusOK }) - - r := httptest.NewRecorder() - req, err := http.NewRequest("GET", "/info", nil) - if err != nil { - t.Fatal(err) - } - // FIXME getting the version should require an actual running Server - if err := ServeRequest(eng, api.APIVERSION, r, req); err != nil { - t.Fatal(err) - } + r := serveRequest("GET", "/info", nil, eng, t) if !called { t.Fatalf("handler was not called") } + v := readEnv(r.Body, t) + if v.GetInt("Images") != 42000 { + t.Fatalf("%#v\n", v) + } + if v.GetInt("Containers") != 1 { + t.Fatalf("%#v\n", v) + } + if r.HeaderMap.Get("Content-Type") != "application/json" { + t.Fatalf("%#v\n", r) + } +} - out := engine.NewOutput() - i, err := out.AddEnv() +func serveRequest(method, target string, body io.Reader, eng *engine.Engine, t *testing.T) *httptest.ResponseRecorder { + r := httptest.NewRecorder() + req, err := http.NewRequest(method, target, body) if err != nil { t.Fatal(err) } - if _, err := io.Copy(out, r.Body); err != nil { + if err := ServeRequest(eng, api.APIVERSION, r, req); err != nil { + t.Fatal(err) + } + return r +} + +func tmpEngine(t *testing.T) *engine.Engine { + tmp, err := utils.TestDirectory("") + if err != nil { + t.Fatal(err) + } + eng, err := engine.New(tmp) + if err != nil { + t.Fatal(err) + } + return eng +} + +func rmEngine(eng *engine.Engine) { + os.RemoveAll(eng.Root()) +} + +func readEnv(src io.Reader, t *testing.T) *engine.Env { + out := engine.NewOutput() + v, err := out.AddEnv() + if err != nil { + t.Fatal(err) + } + if _, err := io.Copy(out, src); err != nil { t.Fatal(err) } out.Close() - { - expected := 42000 - result := i.GetInt("Images") - if expected != result { - t.Fatalf("%#v\n", result) - } - } - { - expected := 1 - result := i.GetInt("Containers") - if expected != result { - t.Fatalf("%#v\n", result) - } - } - { - expected := "application/json" - if result := r.HeaderMap.Get("Content-Type"); result != expected { - t.Fatalf("%#v\n", result) - } - } + return v +} + +func toJson(data interface{}, t *testing.T) io.Reader { + var buf bytes.Buffer + if err := json.NewEncoder(&buf).Encode(data); err != nil { + t.Fatal(err) + } + return &buf } From a43a600a2cb516813a045e3b90e8a9ae81d8a783 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Tue, 8 Apr 2014 19:17:30 -0700 Subject: [PATCH 014/436] Update dns and volumes-from docs Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- docs/sources/reference/api/docker_remote_api_v1.10.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) 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 98827c9eb2..3d6af7e939 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.10.rst +++ b/docs/sources/reference/api/docker_remote_api_v1.10.rst @@ -129,12 +129,10 @@ Create a container "Cmd":[ "date" ], - "Dns":null, "Image":"base", "Volumes":{ "/tmp": {} }, - "VolumesFrom":"", "WorkingDir":"", "DisableNetwork": false, "ExposedPorts":{ @@ -203,10 +201,8 @@ Inspect a container "Cmd": [ "date" ], - "Dns": null, "Image": "base", "Volumes": {}, - "VolumesFrom": "", "WorkingDir":"" }, @@ -386,6 +382,8 @@ Start a container "PortBindings":{ "22/tcp": [{ "HostPort": "11022" }] }, "PublishAllPorts":false, "Privileged":false + "Dns": ["8.8.8.8"], + "VolumesFrom: ["parent", "other:ro"] } **Example response**: @@ -793,10 +791,8 @@ Inspect an image "StdinOnce":false, "Env":null, "Cmd": ["/bin/bash"] - ,"Dns":null, "Image":"base", "Volumes":null, - "VolumesFrom":"", "WorkingDir":"" }, "Size": 6824592 From 87f0d63fb2ede63d263d8e8285b83a7f7d12bbf3 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Wed, 9 Apr 2014 10:22:17 +0000 Subject: [PATCH 015/436] Check for apparmor enabled on host to populate profile Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/apparmor/apparmor.go | 2 +- runtime/execdriver/native/create.go | 5 ++++- runtime/execdriver/native/template/default_template.go | 8 +++++--- 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/pkg/libcontainer/apparmor/apparmor.go b/pkg/libcontainer/apparmor/apparmor.go index a6d57d4f09..5de241dd97 100644 --- a/pkg/libcontainer/apparmor/apparmor.go +++ b/pkg/libcontainer/apparmor/apparmor.go @@ -17,7 +17,7 @@ func IsEnabled() bool { } func ApplyProfile(pid int, name string) error { - if !IsEnabled() || name == "" { + if name == "" { return nil } diff --git a/runtime/execdriver/native/create.go b/runtime/execdriver/native/create.go index 71fab3e064..12546145f9 100644 --- a/runtime/execdriver/native/create.go +++ b/runtime/execdriver/native/create.go @@ -6,6 +6,7 @@ import ( "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/libcontainer" + "github.com/dotcloud/docker/pkg/libcontainer/apparmor" "github.com/dotcloud/docker/runtime/execdriver" "github.com/dotcloud/docker/runtime/execdriver/native/configuration" "github.com/dotcloud/docker/runtime/execdriver/native/template" @@ -80,7 +81,9 @@ func (d *driver) setPrivileged(container *libcontainer.Container) error { c.Enabled = true } container.Cgroups.DeviceAccess = true - container.Context["apparmor_profile"] = "unconfined" + if apparmor.IsEnabled() { + container.Context["apparmor_profile"] = "unconfined" + } return nil } diff --git a/runtime/execdriver/native/template/default_template.go b/runtime/execdriver/native/template/default_template.go index a1ecb04d76..d3c433a317 100644 --- a/runtime/execdriver/native/template/default_template.go +++ b/runtime/execdriver/native/template/default_template.go @@ -3,6 +3,7 @@ package template import ( "github.com/dotcloud/docker/pkg/cgroups" "github.com/dotcloud/docker/pkg/libcontainer" + "github.com/dotcloud/docker/pkg/libcontainer/apparmor" ) // New returns the docker default configuration for libcontainer @@ -36,10 +37,11 @@ func New() *libcontainer.Container { Parent: "docker", DeviceAccess: false, }, - Context: libcontainer.Context{ - "apparmor_profile": "docker-default", - }, + Context: libcontainer.Context{}, } container.CapabilitiesMask.Get("MKNOD").Enabled = true + if apparmor.IsEnabled() { + container.Context["apparmor_profile"] = "docker-default" + } return container } From 986cf931c38b8cdc51da44af0313502ca1156cfc Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Wed, 9 Apr 2014 10:53:32 +0000 Subject: [PATCH 016/436] Change shm mode to 1777 Fixes #5126 Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/nsinit/mount.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/libcontainer/nsinit/mount.go b/pkg/libcontainer/nsinit/mount.go index 3b0cf13bc9..dd6b1c8a43 100644 --- a/pkg/libcontainer/nsinit/mount.go +++ b/pkg/libcontainer/nsinit/mount.go @@ -208,7 +208,7 @@ func mountSystem(rootfs string, mountLabel string) error { }{ {source: "proc", path: filepath.Join(rootfs, "proc"), device: "proc", flags: defaultMountFlags}, {source: "sysfs", path: filepath.Join(rootfs, "sys"), device: "sysfs", flags: defaultMountFlags}, - {source: "shm", path: filepath.Join(rootfs, "dev", "shm"), device: "tmpfs", flags: defaultMountFlags, data: label.FormatMountLabel("mode=1755,size=65536k", mountLabel)}, + {source: "shm", path: filepath.Join(rootfs, "dev", "shm"), device: "tmpfs", flags: defaultMountFlags, data: label.FormatMountLabel("mode=1777,size=65536k", mountLabel)}, {source: "devpts", path: filepath.Join(rootfs, "dev", "pts"), device: "devpts", flags: syscall.MS_NOSUID | syscall.MS_NOEXEC, data: label.FormatMountLabel("newinstance,ptmxmode=0666,mode=620,gid=5", mountLabel)}, } { if err := os.MkdirAll(m.path, 0755); err != nil && !os.IsExist(err) { From 63c303eecdbaf4dc7967fd51b82cd447c778cecc Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Wed, 9 Apr 2014 11:55:08 +0000 Subject: [PATCH 017/436] Revert "Support hairpin NAT without going through docker server" This reverts commit b39d02b611f1cc0af283f417b73bf0d36f26277a. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/iptables/iptables.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/iptables/iptables.go b/pkg/iptables/iptables.go index 1f25952bd9..4cdd67ef7c 100644 --- a/pkg/iptables/iptables.go +++ b/pkg/iptables/iptables.go @@ -66,6 +66,7 @@ func (c *Chain) Forward(action Action, ip net.IP, port int, proto, dest_addr str "-p", proto, "-d", daddr, "--dport", strconv.Itoa(port), + "!", "-i", c.Bridge, "-j", "DNAT", "--to-destination", net.JoinHostPort(dest_addr, strconv.Itoa(dest_port))); err != nil { return err From 59c1b2880be8fb9d9a632fa42a10097c1580591a Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Wed, 9 Apr 2014 15:41:14 +0200 Subject: [PATCH 018/436] Fix libcontainer network support on rhel6 It seems that netlink in older kernels, including RHEL6, does not support RTM_SETLINK with IFLA_MASTER. It just silently ignores it, reporting no error, causing netlink.NetworkSetMaster() to not do anything yet return no error. We fix this by introducing and using AddToBridge() in a very similar manner to CreateBridge(), which use the old ioctls directly. This fixes https://github.com/dotcloud/docker/issues/4668 Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: alexlarsson) --- pkg/libcontainer/network/network.go | 2 +- pkg/netlink/netlink_linux.go | 30 +++++++++++++++++++++++++++++ pkg/netlink/netlink_unsupported.go | 4 ++++ 3 files changed, 35 insertions(+), 1 deletion(-) diff --git a/pkg/libcontainer/network/network.go b/pkg/libcontainer/network/network.go index 8c7a4b618e..f8dee45278 100644 --- a/pkg/libcontainer/network/network.go +++ b/pkg/libcontainer/network/network.go @@ -50,7 +50,7 @@ func SetInterfaceMaster(name, master string) error { if err != nil { return err } - return netlink.NetworkSetMaster(iface, masterIface) + return netlink.AddToBridge(iface, masterIface) } func SetDefaultGateway(ip string) error { diff --git a/pkg/netlink/netlink_linux.go b/pkg/netlink/netlink_linux.go index f4aa92ed34..6de293d42a 100644 --- a/pkg/netlink/netlink_linux.go +++ b/pkg/netlink/netlink_linux.go @@ -19,6 +19,7 @@ const ( VETH_INFO_PEER = 1 IFLA_NET_NS_FD = 28 SIOC_BRADDBR = 0x89a0 + SIOC_BRADDIF = 0x89a2 ) var nextSeqNr int @@ -28,6 +29,11 @@ type ifreqHwaddr struct { IfruHwaddr syscall.RawSockaddr } +type ifreqIndex struct { + IfrnName [16]byte + IfruIndex int32 +} + func nativeEndian() binary.ByteOrder { var x uint32 = 0x01020304 if *(*byte)(unsafe.Pointer(&x)) == 0x01 { @@ -842,6 +848,30 @@ func CreateBridge(name string, setMacAddr bool) error { return nil } +// Add a slave to abridge device. This is more backward-compatible than +// netlink.NetworkSetMaster and works on RHEL 6. +func AddToBridge(iface, master *net.Interface) error { + s, err := syscall.Socket(syscall.AF_INET6, syscall.SOCK_STREAM, syscall.IPPROTO_IP) + if err != nil { + // ipv6 issue, creating with ipv4 + s, err = syscall.Socket(syscall.AF_INET, syscall.SOCK_STREAM, syscall.IPPROTO_IP) + if err != nil { + return err + } + } + defer syscall.Close(s) + + ifr := ifreqIndex{} + copy(ifr.IfrnName[:], master.Name) + ifr.IfruIndex = int32(iface.Index) + + if _, _, err := syscall.Syscall(syscall.SYS_IOCTL, uintptr(s), SIOC_BRADDIF, uintptr(unsafe.Pointer(&ifr))); err != 0 { + return err + } + + return nil +} + func setBridgeMacAddress(s int, name string) error { ifr := ifreqHwaddr{} ifr.IfruHwaddr.Family = syscall.ARPHRD_ETHER diff --git a/pkg/netlink/netlink_unsupported.go b/pkg/netlink/netlink_unsupported.go index 00a3b3fae8..8a5531b9ef 100644 --- a/pkg/netlink/netlink_unsupported.go +++ b/pkg/netlink/netlink_unsupported.go @@ -63,3 +63,7 @@ func NetworkLinkDown(iface *net.Interface) error { func CreateBridge(name string, setMacAddr bool) error { return ErrNotImplemented } + +func AddToBridge(iface, master *net.Interface) error { + return ErrNotImplemented +} From 3d9cd1e5f102d5e59011ec4baca2662f3dacbad4 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Wed, 9 Apr 2014 11:13:54 -0600 Subject: [PATCH 019/436] Fix spurious mtab symlink error when /etc doesn't exist yet symlink /proc/mounts /var/lib/docker/btrfs/subvolumes/1763d6602b8b871f0a79754f1cb0a31b3928bb95de5232b1b8c15c60fa1017f6-init/etc/mtab: no such file or directory Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- graph/graph.go | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/graph/graph.go b/graph/graph.go index 5b08ce3cf1..9ebfc3daa6 100644 --- a/graph/graph.go +++ b/graph/graph.go @@ -272,15 +272,15 @@ func SetupInitLayer(initLayer string) error { if _, err := os.Stat(path.Join(initLayer, pth)); err != nil { if os.IsNotExist(err) { + if err := os.MkdirAll(path.Join(initLayer, path.Dir(pth)), 0755); err != nil { + return err + } switch typ { case "dir": if err := os.MkdirAll(path.Join(initLayer, pth), 0755); err != nil { return err } case "file": - if err := os.MkdirAll(path.Join(initLayer, path.Dir(pth)), 0755); err != nil { - return err - } f, err := os.OpenFile(path.Join(initLayer, pth), os.O_CREATE, 0755) if err != nil { return err From b298960aed8155e7dbedb6602cdbb42eacee83f7 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Mon, 7 Apr 2014 22:14:19 -0600 Subject: [PATCH 020/436] Update bundlescripts to use "set -e" consistently "set -e" is already inherited here from make.sh, but explicit is always better than implicit (hence the "set -e" in the first place!) Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- hack/make/binary | 1 + hack/make/cover | 1 + hack/make/cross | 1 + hack/make/dynbinary | 1 + hack/make/dyntest | 3 +-- hack/make/dyntest-integration | 3 +-- hack/make/test | 3 +-- hack/make/test-integration | 3 +-- hack/make/test-integration-cli | 3 +-- 9 files changed, 9 insertions(+), 10 deletions(-) diff --git a/hack/make/binary b/hack/make/binary index 041e4d1ee8..b97069a856 100755 --- a/hack/make/binary +++ b/hack/make/binary @@ -1,4 +1,5 @@ #!/bin/bash +set -e DEST=$1 diff --git a/hack/make/cover b/hack/make/cover index 6dc71d1c7e..ca772d03bc 100644 --- a/hack/make/cover +++ b/hack/make/cover @@ -1,4 +1,5 @@ #!/bin/bash +set -e DEST="$1" diff --git a/hack/make/cross b/hack/make/cross index e8f90e29b7..32fbbc38f9 100644 --- a/hack/make/cross +++ b/hack/make/cross @@ -1,4 +1,5 @@ #!/bin/bash +set -e DEST=$1 diff --git a/hack/make/dynbinary b/hack/make/dynbinary index 75cffe3dcc..426b9cb566 100644 --- a/hack/make/dynbinary +++ b/hack/make/dynbinary @@ -1,4 +1,5 @@ #!/bin/bash +set -e DEST=$1 diff --git a/hack/make/dyntest b/hack/make/dyntest index 744db3e999..56f624b1f5 100644 --- a/hack/make/dyntest +++ b/hack/make/dyntest @@ -1,10 +1,9 @@ #!/bin/bash +set -e DEST=$1 INIT=$DEST/../dynbinary/dockerinit-$VERSION -set -e - if [ ! -x "$INIT" ]; then echo >&2 'error: dynbinary must be run before dyntest' false diff --git a/hack/make/dyntest-integration b/hack/make/dyntest-integration index ef7e6a5a41..03d7cbef95 100644 --- a/hack/make/dyntest-integration +++ b/hack/make/dyntest-integration @@ -1,10 +1,9 @@ #!/bin/bash +set -e DEST=$1 INIT=$DEST/../dynbinary/dockerinit-$VERSION -set -e - if [ ! -x "$INIT" ]; then echo >&2 'error: dynbinary must be run before dyntest-integration' false diff --git a/hack/make/test b/hack/make/test index 39ba5cd3a5..183ce95c24 100644 --- a/hack/make/test +++ b/hack/make/test @@ -1,9 +1,8 @@ #!/bin/bash +set -e DEST=$1 -set -e - RED=$'\033[31m' GREEN=$'\033[32m' TEXTRESET=$'\033[0m' # reset the foreground colour diff --git a/hack/make/test-integration b/hack/make/test-integration index 0af4c23c48..4c2bccaead 100644 --- a/hack/make/test-integration +++ b/hack/make/test-integration @@ -1,9 +1,8 @@ #!/bin/bash +set -e DEST=$1 -set -e - bundle_test_integration() { LDFLAGS="$LDFLAGS $LDFLAGS_STATIC_DOCKER" go_test_dir ./integration \ "-coverpkg $(find_dirs '*.go' | sed 's,^\.,github.com/dotcloud/docker,g' | paste -d, -s)" diff --git a/hack/make/test-integration-cli b/hack/make/test-integration-cli index b0506d261a..6e8b38892e 100644 --- a/hack/make/test-integration-cli +++ b/hack/make/test-integration-cli @@ -1,9 +1,8 @@ #!/bin/bash +set -e DEST=$1 -set -e - DOCKER_GRAPHDRIVER=${DOCKER_GRAPHDRIVER:-vfs} DOCKER_EXECDRIVER=${DOCKER_EXECDRIVER:-native} From 18bea2495d0bcc354a2538cb161081cb56e5c6f7 Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Sat, 1 Mar 2014 07:45:56 +0900 Subject: [PATCH 021/436] Use LLVM Clang explicitly on FreeBSD Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- hack/make.sh | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/hack/make.sh b/hack/make.sh index 4db4349518..c78671ae7c 100755 --- a/hack/make.sh +++ b/hack/make.sh @@ -107,6 +107,16 @@ LDFLAGS_STATIC_DOCKER=" -extldflags \"$EXTLDFLAGS_STATIC_DOCKER\" " +if [ "$(uname -s)" = 'FreeBSD' ]; then + # Tell cgo the compiler is Clang, not GCC + # https://code.google.com/p/go/source/browse/src/cmd/cgo/gcc.go?spec=svne77e74371f2340ee08622ce602e9f7b15f29d8d3&r=e6794866ebeba2bf8818b9261b54e2eef1c9e588#752 + export CC=clang + + # "-extld clang" is a workaround for + # https://code.google.com/p/go/issues/detail?id=6845 + LDFLAGS="$LDFLAGS -extld clang" +fi + HAVE_GO_TEST_COVER= if \ go help testflag | grep -- -cover > /dev/null \ From 66baf56601f4fc1e8f5f2863d227283954b73a77 Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Fri, 21 Mar 2014 14:31:39 +0900 Subject: [PATCH 022/436] Unlike GNU find, FreeBSD's find needs a path before an expression Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- hack/make.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hack/make.sh b/hack/make.sh index c78671ae7c..f3264c9ce3 100755 --- a/hack/make.sh +++ b/hack/make.sh @@ -152,7 +152,7 @@ go_test_dir() { # holding certain files ($1 parameter), and prints their paths on standard # output, one per line. find_dirs() { - find -not \( \ + find . -not \( \ \( \ -wholename './vendor' \ -o -wholename './integration' \ From 1c90a4dd9a83526ca3837ab9231ff6a9af07e072 Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Fri, 21 Mar 2014 00:52:00 +0900 Subject: [PATCH 023/436] Support FreeBSD on pkg/system/utimes_*.go Implement system.LUtimesNano and system.UtimesNano. The latter might be removed in future because it's basically same as os.Chtimes. That's why the test is mainly focusing LUtimesNano. Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- pkg/system/utimes_freebsd.go | 24 ++++++++++++ pkg/system/utimes_test.go | 64 ++++++++++++++++++++++++++++++++ pkg/system/utimes_unsupported.go | 2 +- 3 files changed, 89 insertions(+), 1 deletion(-) create mode 100644 pkg/system/utimes_freebsd.go create mode 100644 pkg/system/utimes_test.go diff --git a/pkg/system/utimes_freebsd.go b/pkg/system/utimes_freebsd.go new file mode 100644 index 0000000000..ceaa044c1c --- /dev/null +++ b/pkg/system/utimes_freebsd.go @@ -0,0 +1,24 @@ +package system + +import ( + "syscall" + "unsafe" +) + +func LUtimesNano(path string, ts []syscall.Timespec) error { + var _path *byte + _path, err := syscall.BytePtrFromString(path) + if err != nil { + return err + } + + if _, _, err := syscall.Syscall(syscall.SYS_LUTIMES, uintptr(unsafe.Pointer(_path)), uintptr(unsafe.Pointer(&ts[0])), 0); err != 0 && err != syscall.ENOSYS { + return err + } + + return nil +} + +func UtimesNano(path string, ts []syscall.Timespec) error { + return syscall.UtimesNano(path, ts) +} diff --git a/pkg/system/utimes_test.go b/pkg/system/utimes_test.go new file mode 100644 index 0000000000..38e4020cb5 --- /dev/null +++ b/pkg/system/utimes_test.go @@ -0,0 +1,64 @@ +package system + +import ( + "io/ioutil" + "os" + "path/filepath" + "syscall" + "testing" +) + +func prepareFiles(t *testing.T) (string, string, string) { + dir, err := ioutil.TempDir("", "docker-system-test") + if err != nil { + t.Fatal(err) + } + + file := filepath.Join(dir, "exist") + if err := ioutil.WriteFile(file, []byte("hello"), 0644); err != nil { + t.Fatal(err) + } + + invalid := filepath.Join(dir, "doesnt-exist") + + symlink := filepath.Join(dir, "symlink") + if err := os.Symlink(file, symlink); err != nil { + t.Fatal(err) + } + + return file, invalid, symlink +} + +func TestLUtimesNano(t *testing.T) { + file, invalid, symlink := prepareFiles(t) + + before, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + + ts := []syscall.Timespec{{0, 0}, {0, 0}} + if err := LUtimesNano(symlink, ts); err != nil { + t.Fatal(err) + } + + symlinkInfo, err := os.Lstat(symlink) + if err != nil { + t.Fatal(err) + } + if before.ModTime().Unix() == symlinkInfo.ModTime().Unix() { + t.Fatal("The modification time of the symlink should be different") + } + + fileInfo, err := os.Stat(file) + if err != nil { + t.Fatal(err) + } + if before.ModTime().Unix() != fileInfo.ModTime().Unix() { + t.Fatal("The modification time of the file should be same") + } + + if err := LUtimesNano(invalid, ts); err == nil { + t.Fatal("Doesn't return an error on a non-existing file") + } +} diff --git a/pkg/system/utimes_unsupported.go b/pkg/system/utimes_unsupported.go index d247ba283e..9a8cf9cd4a 100644 --- a/pkg/system/utimes_unsupported.go +++ b/pkg/system/utimes_unsupported.go @@ -1,4 +1,4 @@ -// +build !linux +// +build !linux,!freebsd package system From 057d347eafaea9a0044b70e516ace504904a5ba4 Mon Sep 17 00:00:00 2001 From: Jonathan Pares Date: Wed, 9 Apr 2014 11:27:04 +0200 Subject: [PATCH 024/436] Update mac.rst to add homebrew instructions. Explain how to install boot2docker and docker by using homebrew. Docker-DCO-1.1-Signed-off-by: Jonathan Pares (github: jonathanpa) --- docs/sources/installation/mac.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/sources/installation/mac.rst b/docs/sources/installation/mac.rst index 9ce3961f7e..d5243625a7 100644 --- a/docs/sources/installation/mac.rst +++ b/docs/sources/installation/mac.rst @@ -41,6 +41,18 @@ that is used for the job. .. _GitHub page: https://github.com/boot2docker/boot2docker +With Homebrew +~~~~~~~~~~~~~ + +If you are using Homebrew on your machine, simply run the following command to install ``boot2docker``: + +.. code-block:: bash + + brew install boot2docker + +Manual installation +~~~~~~~~~~~~~~~~~~~ + Open up a new terminal window, if you have not already. Run the following commands to get boot2docker: @@ -61,6 +73,18 @@ Docker OS X Client The ``docker`` daemon is accessed using the ``docker`` client. +With Homebrew +~~~~~~~~~~~~~ + +Run the following command to install the ``docker`` client: + +.. code-block:: bash + + brew install docker + +Manual installation +~~~~~~~~~~~~~~~~~~~ + Run the following commands to get it downloaded and set up: .. code-block:: bash From 7931be5cba784b36a145af7ed0153ade6474dabd Mon Sep 17 00:00:00 2001 From: unclejack Date: Thu, 10 Apr 2014 14:43:25 +0300 Subject: [PATCH 025/436] delete containers during build after every step This commit changes the way docker build cleans up containers. Containers get cleaned up right away after they've been committed and they've become an image. When the build fails, only the last container of the failing step is left behind. Docker-DCO-1.1-Signed-off-by: Cristian Staretu (github: unclejack) --- server/buildfile.go | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/server/buildfile.go b/server/buildfile.go index b4a860ad4d..bf7631abfb 100644 --- a/server/buildfile.go +++ b/server/buildfile.go @@ -69,6 +69,7 @@ func (b *buildFile) clearTmp(containers map[string]struct{}) { if err := b.runtime.Destroy(tmp); err != nil { fmt.Fprintf(b.outStream, "Error removing intermediate container %s: %s\n", utils.TruncateID(c), err.Error()) } else { + delete(containers, c) fmt.Fprintf(b.outStream, "Removing intermediate container %s\n", utils.TruncateID(c)) } } @@ -780,14 +781,13 @@ func (b *buildFile) Build(context io.Reader) (string, error) { } if err := b.BuildStep(fmt.Sprintf("%d", stepN), line); err != nil { return "", err + } else if b.rm { + b.clearTmp(b.tmpContainers) } stepN += 1 } if b.image != "" { fmt.Fprintf(b.outStream, "Successfully built %s\n", utils.TruncateID(b.image)) - if b.rm { - b.clearTmp(b.tmpContainers) - } return b.image, nil } return "", fmt.Errorf("No image was generated. This may be because the Dockerfile does not, like, do anything.\n") From e625cee28dc62d7fbc5172e0e9c01708e2bd7fc4 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Mon, 7 Apr 2014 17:00:01 +1000 Subject: [PATCH 026/436] add some more text to the cli docs Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/reference/commandline/cli.rst | 60 +++++++++++++++++----- 1 file changed, 48 insertions(+), 12 deletions(-) diff --git a/docs/sources/reference/commandline/cli.rst b/docs/sources/reference/commandline/cli.rst index c0df5f8175..37118c53f5 100644 --- a/docs/sources/reference/commandline/cli.rst +++ b/docs/sources/reference/commandline/cli.rst @@ -148,9 +148,14 @@ TMPDIR and the data directory can be set like this: --no-stdin=false: Do not attach stdin --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) +The ``attach`` command will allow you to view or interact with any +running container, detached (``-d``) or interactive (``-i``). You can +attach to the same container at the same time - screen sharing style, +or quickly view the progress of your daemonized process. + You can detach from the container again (and leave it running) with -``CTRL-c`` (for a quiet exit) or ``CTRL-\`` to get a stacktrace of -the Docker client when it quits. When you detach from the container's +``CTRL-C`` (for a quiet exit) or ``CTRL-\`` to get a stacktrace of +the Docker client when it quits. When you detach from the container's process the exit code will be returned to the client. To stop a container, use ``docker stop``. @@ -211,6 +216,8 @@ Examples: --no-cache: Do not use the cache when building the image. --rm=true: Remove intermediate containers after a successful build +Use this command to build Docker images from a ``Dockerfile`` and a "context". + The files at ``PATH`` or ``URL`` are called the "context" of the build. The build process may refer to any of the files in the context, for example when using an :ref:`ADD ` instruction. @@ -317,6 +324,12 @@ by using the ``git://`` schema. -m, --message="": Commit message -a, --author="": Author (eg. "John Hannibal Smith " +It can be useful to commit a container's file changes or settings into a new image. +This allows you debug a container by running an interactive shell, or to export +a working dataset to another server. +Generally, it is better to use Dockerfiles to manage your images in a documented +and maintainable way. + .. _cli_commit_examples: Commit an existing container @@ -562,7 +575,7 @@ Listing the full length image IDs Create an empty filesystem image and import the contents of the tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it. -At this time, the URL must start with ``http`` and point to a single +URLs must start with ``http`` and point to a single file archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, or .txz) containing a root filesystem. If you would like to import from a local directory or archive, you can use the ``-`` parameter to take the data from *stdin*. @@ -625,6 +638,8 @@ preserved. Kernel Version: 3.8.0-33-generic WARNING: No swap limit support +When sending issue reports, please use ``docker version`` and ``docker info`` to +ensure we know how your setup is configured. .. _cli_inspect: @@ -788,10 +803,7 @@ Restores both images and tags. -f, --follow=false: Follow log output -The ``docker logs`` command is a convenience which batch-retrieves whatever -logs are present at the time of execution. This does not guarantee execution -order when combined with a ``docker run`` (i.e. your run may not have generated -any logs at the time you execute ``docker logs``). +The ``docker logs`` command batch-retrieves all logs present at the time of execution. The ``docker logs --follow`` command combines ``docker logs`` and ``docker attach``: it will first return all logs from the beginning and then continue streaming @@ -839,9 +851,6 @@ Running ``docker ps`` showing 2 linked containers. CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db - fd2645e2e2b5 busybox:latest top 10 days ago Ghost insane_ptolemy - -The last container is marked as a ``Ghost`` container. It is a container that was running when the docker daemon was restarted (upgraded, or ``-H`` settings changed). The container is still running, but as this docker daemon process is not able to manage it, you can't attach to it. To bring them out of ``Ghost`` Status, you need to use ``docker kill`` or ``docker restart``. ``docker ps`` will show only running containers by default. To see all containers: ``docker ps -a`` @@ -856,6 +865,23 @@ The last container is marked as a ``Ghost`` container. It is a container that wa Pull an image or a repository from the registry +Most of your images will be created on top of a base image from the +(https://index.docker.io). + +The Docker Index contains many pre-built images that you can ``pull`` and try +without needing to define and configure your own. + +To download a particular image, or set of images (i.e., a repository), +use ``docker pull``: + +.. code-block:: bash + + $ docker pull debian + # will pull all the images in the debian repository + $ docker pull debian:testing + # will pull only the image named debian:testing and any intermediate layers + # it is based on. (typically the empty `scratch` image, a MAINTAINERs layer, + # and the un-tared base. .. _cli_push: @@ -868,6 +894,7 @@ The last container is marked as a ``Ghost`` container. It is a container that wa Push an image or a repository to the registry +Use ``docker push`` to share your images on public or private registries. .. _cli_restart: @@ -926,7 +953,7 @@ network communication. .. code-block:: bash - $ sudo docker rm `docker ps -a -q` + $ sudo docker rm $(docker ps -a -q) This command will delete all stopped containers. The command ``docker ps -a -q`` will return all @@ -1022,7 +1049,8 @@ The ``docker run`` command first ``creates`` a writeable container layer over the specified image, and then ``starts`` it using the specified command. That is, ``docker run`` is equivalent to the API ``/containers/create`` then ``/containers/(id)/start``. -Once the container is stopped it still exists and can be started back up. See ``docker ps -a`` to view a list of all containers. +A stopped container can be restarted with all its previous changes intact using +``docker start``. See ``docker ps -a`` to view a list of all containers. The ``docker run`` command can be used in combination with ``docker commit`` to :ref:`change the command that a container runs `. @@ -1270,6 +1298,8 @@ This example shows 5 containers that might be set up to test a web application c Produces a tarred repository to the standard output stream. Contains all parent layers, and all tags + versions, or specified repo:tag. +It is used to create a backup that can then be used with ``docker load`` + .. code-block:: bash $ sudo docker save busybox > busybox.tar @@ -1297,6 +1327,9 @@ Contains all parent layers, and all tags + versions, or specified repo:tag. -s, --stars=0: Only displays with at least xxx stars -t, --trusted=false: Only show trusted builds +See :ref:`searching_central_index` for more details on finding shared images +from the commandline. + .. _cli_start: ``start`` @@ -1339,6 +1372,9 @@ The main process inside the container will receive SIGTERM, and after a grace pe -f, --force=false: Force +You can group your images together using names and +tags, and then upload them to :ref:`working_with_the_repository`. + .. _cli_top: ``top`` From c5226d94fab4e261fe2407262d9b5177326d4062 Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Thu, 10 Apr 2014 22:07:29 +0900 Subject: [PATCH 027/436] Avoid "invalid memory address or nil pointer dereference" panic libcontainer.GetNamespace returns nil on FreeBSD because libcontainer.namespaceList is empty. In this case, Namespaces#Get should return nil instead of being panic. Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- pkg/libcontainer/types.go | 2 +- pkg/libcontainer/types_test.go | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/pkg/libcontainer/types.go b/pkg/libcontainer/types.go index ffeb55a022..d4818c3ffe 100644 --- a/pkg/libcontainer/types.go +++ b/pkg/libcontainer/types.go @@ -68,7 +68,7 @@ func (n Namespaces) Contains(ns string) bool { func (n Namespaces) Get(ns string) *Namespace { for _, nsp := range n { - if nsp.Key == ns { + if nsp != nil && nsp.Key == ns { return nsp } } diff --git a/pkg/libcontainer/types_test.go b/pkg/libcontainer/types_test.go index 9735937b76..dd31298fdf 100644 --- a/pkg/libcontainer/types_test.go +++ b/pkg/libcontainer/types_test.go @@ -18,6 +18,15 @@ func TestNamespacesContains(t *testing.T) { if !ns.Contains("NEWPID") { t.Fatal("namespaces should contain NEWPID but does not") } + + withNil := Namespaces{ + GetNamespace("UNDEFINED"), // this element will be nil + GetNamespace("NEWPID"), + } + + if !withNil.Contains("NEWPID") { + t.Fatal("namespaces should contain NEWPID but does not") + } } func TestCapabilitiesContains(t *testing.T) { From 336199a877014143bac462e98cae7f59525a0556 Mon Sep 17 00:00:00 2001 From: Daniel Norberg Date: Tue, 8 Apr 2014 14:07:02 -0400 Subject: [PATCH 028/436] net: do not create -b/--bridge specified bridge If the bridge specified using -b/--bridge doesn't exist, fail instead of attempting to create it. This is consistent with the docker documentation on -b/--bridge: "Attach containers to a pre existing network bridge". It is also less surprising in an environment where the operator expected the bridge to be properly set up before docker starts and expects docker to fail fast if the bridge was not up instead of masking this error and coming up in some potentially broken state. With this patch, docker still creates docker0 if needed and no bridge was explicitly specified. Docker-DCO-1.1-Signed-off-by: Daniel Norberg (github: danielnorberg) --- runtime/networkdriver/bridge/driver.go | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/runtime/networkdriver/bridge/driver.go b/runtime/networkdriver/bridge/driver.go index f7c3bc6b01..092aa9a23f 100644 --- a/runtime/networkdriver/bridge/driver.go +++ b/runtime/networkdriver/bridge/driver.go @@ -68,12 +68,20 @@ func InitDriver(job *engine.Job) engine.Status { } bridgeIface = job.Getenv("BridgeIface") + usingDefaultBridge := false if bridgeIface == "" { + usingDefaultBridge = true bridgeIface = DefaultNetworkBridge } addr, err := networkdriver.GetIfaceAddr(bridgeIface) if err != nil { + // If we're not using the default bridge, fail without trying to create it + if !usingDefaultBridge { + job.Logf("bridge not found: %s", bridgeIface) + job.Error(err) + return engine.StatusErr + } // If the iface is not found, try to create it job.Logf("creating new bridge for %s", bridgeIface) if err := createBridge(bridgeIP); err != nil { From d4746d3ea0b8d4888b21b808237199ae22525b07 Mon Sep 17 00:00:00 2001 From: Daniel Norberg Date: Thu, 10 Apr 2014 11:15:56 -0400 Subject: [PATCH 029/436] bridge driver: clean up error returns Docker-DCO-1.1-Signed-off-by: Daniel Norberg (github: danielnorberg) --- runtime/networkdriver/bridge/driver.go | 46 +++++++++----------------- 1 file changed, 15 insertions(+), 31 deletions(-) diff --git a/runtime/networkdriver/bridge/driver.go b/runtime/networkdriver/bridge/driver.go index 092aa9a23f..b8568c7c40 100644 --- a/runtime/networkdriver/bridge/driver.go +++ b/runtime/networkdriver/bridge/driver.go @@ -79,21 +79,18 @@ func InitDriver(job *engine.Job) engine.Status { // If we're not using the default bridge, fail without trying to create it if !usingDefaultBridge { job.Logf("bridge not found: %s", bridgeIface) - job.Error(err) - return engine.StatusErr + return job.Error(err) } // If the iface is not found, try to create it job.Logf("creating new bridge for %s", bridgeIface) if err := createBridge(bridgeIP); err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } job.Logf("getting iface addr") addr, err = networkdriver.GetIfaceAddr(bridgeIface) if err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } network = addr.(*net.IPNet) } else { @@ -109,8 +106,7 @@ func InitDriver(job *engine.Job) engine.Status { // Configure iptables for link support if enableIPTables { if err := setupIPTables(addr, icc); err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } } @@ -123,15 +119,13 @@ func InitDriver(job *engine.Job) engine.Status { // We can always try removing the iptables if err := iptables.RemoveExistingChain("DOCKER"); err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } if enableIPTables { chain, err := iptables.NewChain("DOCKER", bridgeIface) if err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } portmapper.SetIptablesChain(chain) } @@ -148,8 +142,7 @@ func InitDriver(job *engine.Job) engine.Status { "link": LinkContainers, } { if err := job.Eng.Register(name, f); err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } } return engine.StatusOK @@ -310,8 +303,7 @@ func Allocate(job *engine.Job) engine.Status { ip, err = ipallocator.RequestIP(bridgeNetwork, nil) } if err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } out := engine.Env{} @@ -395,8 +387,7 @@ func AllocatePort(job *engine.Job) engine.Status { // host ip, proto, and host port hostPort, err = portallocator.RequestPort(ip, proto, hostPort) if err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } var ( @@ -414,9 +405,7 @@ func AllocatePort(job *engine.Job) engine.Status { if err := portmapper.Map(container, ip, hostPort); err != nil { portallocator.ReleasePort(ip, proto, hostPort) - - job.Error(err) - return engine.StatusErr + return job.Error(err) } network.PortMappings = append(network.PortMappings, host) @@ -425,8 +414,7 @@ func AllocatePort(job *engine.Job) engine.Status { out.SetInt("HostPort", hostPort) if _, err := out.WriteTo(job.Stdout); err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } return engine.StatusOK } @@ -453,11 +441,9 @@ func LinkContainers(job *engine.Job) engine.Status { "--dport", port, "-d", childIP, "-j", "ACCEPT"); !ignoreErrors && err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } else if len(output) != 0 { - job.Errorf("Error toggle iptables forward: %s", output) - return engine.StatusErr + return job.Errorf("Error toggle iptables forward: %s", output) } if output, err := iptables.Raw(action, "FORWARD", @@ -467,11 +453,9 @@ func LinkContainers(job *engine.Job) engine.Status { "--sport", port, "-d", parentIP, "-j", "ACCEPT"); !ignoreErrors && err != nil { - job.Error(err) - return engine.StatusErr + return job.Error(err) } else if len(output) != 0 { - job.Errorf("Error toggle iptables forward: %s", output) - return engine.StatusErr + return job.Errorf("Error toggle iptables forward: %s", output) } } return engine.StatusOK From 66dd4ea4e280e4acc133872401bf8a79c80510f3 Mon Sep 17 00:00:00 2001 From: Isabel Jimenez Date: Sun, 23 Mar 2014 16:14:40 -0700 Subject: [PATCH 030/436] Adding timestamp end to events endpoint. Modifying api docs. Docker-DCO-1.1-Signed-off-by: Isabel Jimenez (github: jimenez) --- api/client/commands.go | 30 +- api/common.go | 2 +- api/server/server.go | 1 + .../reference/api/docker_remote_api.rst | 21 +- .../reference/api/docker_remote_api_v1.11.rst | 1286 +++++++++++++++++ docs/sources/reference/commandline/cli.rst | 4 +- server/server.go | 34 +- 7 files changed, 1350 insertions(+), 28 deletions(-) create mode 100644 docs/sources/reference/api/docker_remote_api_v1.11.rst diff --git a/api/client/commands.go b/api/client/commands.go index 53b8822d69..862c55001a 100644 --- a/api/client/commands.go +++ b/api/client/commands.go @@ -1484,7 +1484,8 @@ func (cli *DockerCli) CmdCommit(args ...string) error { func (cli *DockerCli) CmdEvents(args ...string) error { cmd := cli.Subcmd("events", "[OPTIONS]", "Get real time events from the server") - since := cmd.String([]string{"#since", "-since"}, "", "Show previously created events and then stream.") + since := cmd.String([]string{"#since", "-since"}, "", "Show all events created since timestamp") + until := cmd.String([]string{"-until"}, "", "Stream events until this timestamp") if err := cmd.Parse(args); err != nil { return nil } @@ -1493,22 +1494,27 @@ func (cli *DockerCli) CmdEvents(args ...string) error { cmd.Usage() return nil } - - v := url.Values{} - if *since != "" { - loc := time.FixedZone(time.Now().Zone()) + var ( + v = url.Values{} + loc = time.FixedZone(time.Now().Zone()) + ) + var setTime = func(key, value string) { format := "2006-01-02 15:04:05 -0700 MST" - if len(*since) < len(format) { - format = format[:len(*since)] + if len(value) < len(format) { + format = format[:len(value)] } - - if t, err := time.ParseInLocation(format, *since, loc); err == nil { - v.Set("since", strconv.FormatInt(t.Unix(), 10)) + if t, err := time.ParseInLocation(format, value, loc); err == nil { + v.Set(key, strconv.FormatInt(t.Unix(), 10)) } else { - v.Set("since", *since) + v.Set(key, value) } } - + if *since != "" { + setTime("since", *since) + } + if *until != "" { + setTime("until", *until) + } if err := cli.stream("GET", "/events?"+v.Encode(), nil, cli.out, nil); err != nil { return err } diff --git a/api/common.go b/api/common.go index 44bd901379..af4ced4f6e 100644 --- a/api/common.go +++ b/api/common.go @@ -10,7 +10,7 @@ import ( ) const ( - APIVERSION version.Version = "1.10" + APIVERSION version.Version = "1.11" DEFAULTHTTPHOST = "127.0.0.1" DEFAULTUNIXSOCKET = "/var/run/docker.sock" ) diff --git a/api/server/server.go b/api/server/server.go index 93dd2094b6..4b2578eb74 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -246,6 +246,7 @@ func getEvents(eng *engine.Engine, version version.Version, w http.ResponseWrite var job = eng.Job("events", r.RemoteAddr) streamJSON(job, w, true) job.Setenv("since", r.Form.Get("since")) + job.Setenv("until", r.Form.Get("until")) return job.Run() } diff --git a/docs/sources/reference/api/docker_remote_api.rst b/docs/sources/reference/api/docker_remote_api.rst index 7fa8468f3c..bd5598bcf2 100644 --- a/docs/sources/reference/api/docker_remote_api.rst +++ b/docs/sources/reference/api/docker_remote_api.rst @@ -28,15 +28,30 @@ Docker Remote API 2. Versions =========== -The current version of the API is 1.10 +The current version of the API is 1.11 Calling /images//insert is the same as calling -/v1.10/images//insert +/v1.11/images//insert You can still call an old version of the api using -/v1.0/images//insert +/v1.11/images//insert +v1.11 +***** + +Full Documentation +------------------ + +:doc:`docker_remote_api_v1.11` + +What's new +---------- + +.. http:get:: /events + + **New!** You can now use the ``-until`` parameter to close connection after timestamp. + v1.10 ***** diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.rst b/docs/sources/reference/api/docker_remote_api_v1.11.rst new file mode 100644 index 0000000000..8c14b21c65 --- /dev/null +++ b/docs/sources/reference/api/docker_remote_api_v1.11.rst @@ -0,0 +1,1286 @@ +:title: Remote API v1.11 +:description: API Documentation for Docker +:keywords: API, Docker, rcli, REST, documentation + +:orphan: + +======================= +Docker Remote API v1.11 +======================= + +.. contents:: Table of Contents + +1. Brief introduction +===================== + +- The Remote API has replaced rcli +- The daemon listens on ``unix:///var/run/docker.sock``, but you can + :ref:`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 +============ + +2.1 Containers +-------------- + +List containers +*************** + +.. http:get:: /containers/json + + List containers + + **Example request**: + + .. sourcecode:: http + + GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default + :query limit: Show ``limit`` last created containers, include non-running ones. + :query since: Show only containers created since Id, include non-running ones. + :query before: Show only containers created before Id, include non-running ones. + :query size: 1/True/true or 0/False/false, Show the containers sizes + :statuscode 200: no error + :statuscode 400: bad parameter + :statuscode 500: server error + + +Create a container +****************** + +.. http:post:: /containers/create + + Create a container + + **Example request**: + + .. sourcecode:: http + + 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":"", + "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + :jsonparam config: the container's configuration + :query name: Assign the specified name to the container. Must match ``/?[a-zA-Z0-9_-]+``. + :statuscode 201: no error + :statuscode 404: no such container + :statuscode 406: impossible to attach (container not running) + :statuscode 500: server error + + +Inspect a container +******************* + +.. http:get:: /containers/(id)/json + + Return low-level information on the container ``id`` + + **Example request**: + + .. sourcecode:: http + + GET /containers/4fa6e0f0c678/json HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 + } + } + + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +List processes running inside a container +***************************************** + +.. http:get:: /containers/(id)/top + + List processes running inside the container ``id`` + + **Example request**: + + .. sourcecode:: http + + GET /containers/4fa6e0f0c678/top HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 ps_args: ps arguments to use (eg. aux) + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Inspect changes on a container's filesystem +******************************************* + +.. http:get:: /containers/(id)/changes + + Inspect changes on container ``id`` 's filesystem + + **Example request**: + + .. sourcecode:: http + + GET /containers/4fa6e0f0c678/changes HTTP/1.1 + + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Path":"/dev", + "Kind":0 + }, + { + "Path":"/dev/kmsg", + "Kind":1 + }, + { + "Path":"/test", + "Kind":1 + } + ] + + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Export a container +****************** + +.. http:get:: /containers/(id)/export + + Export the contents of container ``id`` + + **Example request**: + + .. sourcecode:: http + + GET /containers/4fa6e0f0c678/export HTTP/1.1 + + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Start a container +***************** + +.. http:post:: /containers/(id)/start + + Start the container ``id`` + + **Example request**: + + .. sourcecode:: http + + 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**: + + .. sourcecode:: http + + HTTP/1.1 204 No Content + Content-Type: text/plain + + :jsonparam hostConfig: the container's host configuration (optional) + :statuscode 204: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Stop a container +**************** + +.. http:post:: /containers/(id)/stop + + Stop the container ``id`` + + **Example request**: + + .. sourcecode:: http + + POST /containers/e90e34656806/stop?t=5 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 204 OK + + :query t: number of seconds to wait before killing the container + :statuscode 204: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Restart a container +******************* + +.. http:post:: /containers/(id)/restart + + Restart the container ``id`` + + **Example request**: + + .. sourcecode:: http + + POST /containers/e90e34656806/restart?t=5 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 204 OK + + :query t: number of seconds to wait before killing the container + :statuscode 204: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Kill a container +**************** + +.. http:post:: /containers/(id)/kill + + Kill the container ``id`` + + **Example request**: + + .. sourcecode:: http + + POST /containers/e90e34656806/kill HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 204 OK + + :statuscode 204: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Attach to a container +********************* + +.. http:post:: /containers/(id)/attach + + Attach to the container ``id`` + + **Example request**: + + .. sourcecode:: http + + POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + :query logs: 1/True/true or 0/False/false, return logs. Default false + :query stream: 1/True/true or 0/False/false, return stream. Default false + :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false + :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false + :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false + :statuscode 200: no error + :statuscode 400: bad parameter + :statuscode 404: no such container + :statuscode 500: server error + + **Stream details**: + + When using the TTY setting is enabled in + :http: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 +**************** + +.. http:post:: /containers/(id)/wait + + Block until container ``id`` stops, then returns the exit code + + **Example request**: + + .. sourcecode:: http + + POST /containers/16253994b7c4/wait HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + {"StatusCode":0} + + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Remove a container +******************* + +.. http:delete:: /containers/(id) + + Remove the container ``id`` from the filesystem + + **Example request**: + + .. sourcecode:: http + + DELETE /containers/16253994b7c4?v=1 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 204 OK + + :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false + :query force: 1/True/true or 0/False/false, Removes the container even if it was running. Default false + :statuscode 204: no error + :statuscode 400: bad parameter + :statuscode 404: no such container + :statuscode 500: server error + + +Copy files or folders from a container +************************************** + +.. http:post:: /containers/(id)/copy + + Copy files or folders of container ``id`` + + **Example request**: + + .. sourcecode:: http + + POST /containers/4fa6e0f0c678/copy HTTP/1.1 + Content-Type: application/json + + { + "Resource":"test.txt" + } + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/octet-stream + + {{ STREAM }} + + :statuscode 200: no error + :statuscode 404: no such container + :statuscode 500: server error + + +2.2 Images +---------- + +List Images +*********** + +.. http:get:: /images/json + + **Example request**: + + .. sourcecode:: http + + GET /images/json?all=0 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 +*************** + +.. http:post:: /images/create + + Create an image, either by pull it from the registry or by importing it + + **Example request**: + + .. sourcecode:: http + + POST /images/create?fromImage=base HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 fromImage: name of the image to pull + :query fromSrc: source to import, - means stdin + :query repo: repository + :query tag: tag + :query registry: the registry to pull from + :reqheader X-Registry-Auth: base64-encoded AuthConfig object + :statuscode 200: no error + :statuscode 500: server error + + + +Insert a file in an image +************************* + +.. http:post:: /images/(name)/insert + + Insert a file from ``url`` in the image ``name`` at ``path`` + + **Example request**: + + .. sourcecode:: http + + POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Inserting..."} + {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} + {"error":"Invalid..."} + ... + + :statuscode 200: no error + :statuscode 500: server error + + +Inspect an image +**************** + +.. http:get:: /images/(name)/json + + Return low-level information on the image ``name`` + + **Example request**: + + .. sourcecode:: http + + GET /images/base/json HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 + } + + :statuscode 200: no error + :statuscode 404: no such image + :statuscode 500: server error + + +Get the history of an image +*************************** + +.. http:get:: /images/(name)/history + + Return the history of the image ``name`` + + **Example request**: + + .. sourcecode:: http + + GET /images/base/history HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "Id":"b750fe79269d", + "Created":1364102658, + "CreatedBy":"/bin/bash" + }, + { + "Id":"27cf78414709", + "Created":1364068391, + "CreatedBy":"" + } + ] + + :statuscode 200: no error + :statuscode 404: no such image + :statuscode 500: server error + + +Push an image on the registry +***************************** + +.. http:post:: /images/(name)/push + + Push the image ``name`` on the registry + + **Example request**: + + .. sourcecode:: http + + POST /images/test/push HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + {"status":"Pushing..."} + {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} + {"error":"Invalid..."} + ... + + :query registry: the registry you wan to push, optional + :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. + :statuscode 200: no error + :statuscode 404: no such image + :statuscode 500: server error + + +Tag an image into a repository +****************************** + +.. http:post:: /images/(name)/tag + + Tag the image ``name`` into a repository + + **Example request**: + + .. sourcecode:: http + + POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 201 OK + + :query repo: The repository to tag in + :query force: 1/True/true or 0/False/false, default false + :statuscode 201: no error + :statuscode 400: bad parameter + :statuscode 404: no such image + :statuscode 409: conflict + :statuscode 500: server error + + +Remove an image +*************** + +.. http:delete:: /images/(name) + + Remove the image ``name`` from the filesystem + + **Example request**: + + .. sourcecode:: http + + DELETE /images/test HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-type: application/json + + [ + {"Untagged":"3e2f21a89f"}, + {"Deleted":"3e2f21a89f"}, + {"Deleted":"53b4f83ac9"} + ] + + :query force: 1/True/true or 0/False/false, default false + :query noprune: 1/True/true or 0/False/false, default false + :statuscode 200: no error + :statuscode 404: no such image + :statuscode 409: conflict + :statuscode 500: server error + + +Search images +************* + +.. http: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**: + + .. sourcecode:: http + + GET /images/search?term=sshd HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 term: term to search + :statuscode 200: no error + :statuscode 500: server error + + +2.3 Misc +-------- + +Build an image from Dockerfile via stdin +**************************************** + +.. http:post:: /build + + Build an image from Dockerfile via stdin + + **Example request**: + + .. sourcecode:: http + + POST /build HTTP/1.1 + + {{ STREAM }} + + **Example response**: + + .. sourcecode:: http + + 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 :ref:`ADD build command + `). + + :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success + :query q: suppress verbose build output + :query nocache: do not use the cache when building the image + :reqheader Content-type: should be set to ``"application/tar"``. + :reqheader X-Registry-Config: base64-encoded ConfigFile object + :statuscode 200: no error + :statuscode 500: server error + + + +Check auth configuration +************************ + +.. http:post:: /auth + + Get the default username and email + + **Example request**: + + .. sourcecode:: http + + 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**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + + :statuscode 200: no error + :statuscode 204: no error + :statuscode 500: server error + + +Display system-wide information +******************************* + +.. http:get:: /info + + Display system-wide information + + **Example request**: + + .. sourcecode:: http + + GET /info HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + 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 + } + + :statuscode 200: no error + :statuscode 500: server error + + +Show the docker version information +*********************************** + +.. http:get:: /version + + Show the docker version information + + **Example request**: + + .. sourcecode:: http + + GET /version HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "Version":"0.2.2", + "GitCommit":"5a2a5cc+CHANGES", + "GoVersion":"go1.0.3" + } + + :statuscode 200: no error + :statuscode 500: server error + + +Create a new image from a container's changes +********************************************* + +.. http:post:: /commit + + Create a new image from a container's changes + + **Example request**: + + .. sourcecode:: http + + POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 + + **Example response**: + + .. sourcecode:: http + + HTTP/1.1 201 OK + Content-Type: application/vnd.docker.raw-stream + + {"Id":"596069db4bf5"} + + :query container: source container + :query repo: repository + :query tag: tag + :query m: commit message + :query author: author (eg. "John Hannibal Smith ") + :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) + :statuscode 201: no error + :statuscode 404: no such container + :statuscode 500: server error + + +Monitor Docker's events +*********************** + +.. http:get:: /events + + Get events from docker, either in real time via streaming, or via polling (using `since`) + + **Example request**: + + .. sourcecode:: http + + GET /events?since=1374067924 + + **Example response**: + + .. sourcecode:: http + + 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 since: timestamp used for polling + :query until: timestamp used for polling + :statuscode 200: no error + :statuscode 500: server error + +Get a tarball containing all images and tags in a repository +************************************************************ + +.. http:get:: /images/(name)/get + + Get a tarball containing all images and metadata for the repository specified by ``name``. + + **Example request** + + .. sourcecode:: http + + 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 +******************************************************** + +.. http:post:: /images/load + + Load a set of images and tags into the docker repository. + + **Example request** + + .. sourcecode:: http + + 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 +================ + +3.1 Inside 'docker run' +----------------------- + +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 +------------- + +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 +----------------- + +To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. + +.. code-block:: bash + + docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/commandline/cli.rst b/docs/sources/reference/commandline/cli.rst index 64dff1e1c2..8c9bf84e67 100644 --- a/docs/sources/reference/commandline/cli.rst +++ b/docs/sources/reference/commandline/cli.rst @@ -490,7 +490,9 @@ For example: Get real time events from the server - --since="": Show previously created events and then stream. + --since="": Show all events created since timestamp + (either seconds since epoch, or date string as below) + --until="": Show events created before timestamp (either seconds since epoch, or date string as below) .. _cli_events_example: diff --git a/server/server.go b/server/server.go index fae50094c2..64393183fd 100644 --- a/server/server.go +++ b/server/server.go @@ -220,8 +220,10 @@ func (srv *Server) Events(job *engine.Job) engine.Status { } var ( - from = job.Args[0] - since = job.GetenvInt64("since") + from = job.Args[0] + since = job.GetenvInt64("since") + until = job.GetenvInt64("until") + timeout = time.NewTimer(time.Unix(until, 0).Sub(time.Now())) ) sendEvent := func(event *utils.JSONMessage) error { b, err := json.Marshal(event) @@ -250,9 +252,9 @@ func (srv *Server) Events(job *engine.Job) engine.Status { srv.Unlock() job.Stdout.Write(nil) // flush if since != 0 { - // If since, send previous events that happened after the timestamp + // If since, send previous events that happened after the timestamp and until timestamp for _, event := range srv.GetEvents() { - if event.Time >= since { + if event.Time >= since && (event.Time <= until || until == 0) { err := sendEvent(&event) if err != nil && err.Error() == "JSON error" { continue @@ -264,13 +266,23 @@ func (srv *Server) Events(job *engine.Job) engine.Status { } } } - for event := range listener { - err := sendEvent(&event) - if err != nil && err.Error() == "JSON error" { - continue - } - if err != nil { - return job.Error(err) + + // If no until, disable timeout + if until == 0 { + timeout.Stop() + } + for { + select { + case event := <-listener: + err := sendEvent(&event) + if err != nil && err.Error() == "JSON error" { + continue + } + if err != nil { + return job.Error(err) + } + case <-timeout.C: + return engine.StatusOK } } return engine.StatusOK From b9731bccf2b2cc8c06ef8bdb41f72ca4791e63db Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Thu, 10 Apr 2014 22:29:03 +0000 Subject: [PATCH 031/436] refactor build job to know only configFile Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/server/server.go | 11 ++++++++--- integration/buildfile_test.go | 6 +++--- server/buildfile.go | 18 +++--------------- server/server.go | 19 ++++++++++++------- 4 files changed, 26 insertions(+), 28 deletions(-) diff --git a/api/server/server.go b/api/server/server.go index de75ad7c16..a734490c01 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -829,8 +829,6 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite return fmt.Errorf("Multipart upload for build is no longer supported. Please upgrade your docker client.") } var ( - authEncoded = r.Header.Get("X-Registry-Auth") - authConfig = ®istry.AuthConfig{} configFileEncoded = r.Header.Get("X-Registry-Config") configFile = ®istry.ConfigFile{} job = eng.Job("build") @@ -840,14 +838,22 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite // Both headers will be parsed and sent along to the daemon, but if a non-empty // ConfigFile is present, any value provided as an AuthConfig directly will // be overridden. See BuildFile::CmdFrom for details. + // /* + var ( + authEncoded = r.Header.Get("X-Registry-Auth") + authConfig = ®istry.AuthConfig{} + ) if version.LessThan("1.9") && authEncoded != "" { authJson := base64.NewDecoder(base64.URLEncoding, strings.NewReader(authEncoded)) if err := json.NewDecoder(authJson).Decode(authConfig); err != nil { // for a pull it is not an error if no auth was given // to increase compatibility with the existing api it is defaulting to be empty authConfig = ®istry.AuthConfig{} + } else { + configFile.Configs[authConfig.ServerAddress] = *authConfig } } + // */ if configFileEncoded != "" { configFileJson := base64.NewDecoder(base64.URLEncoding, strings.NewReader(configFileEncoded)) @@ -870,7 +876,6 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite job.Setenv("q", r.FormValue("q")) job.Setenv("nocache", r.FormValue("nocache")) job.Setenv("rm", r.FormValue("rm")) - job.SetenvJson("authConfig", authConfig) job.SetenvJson("configFile", configFile) if err := job.Run(); err != nil { diff --git a/integration/buildfile_test.go b/integration/buildfile_test.go index bb864a5a12..0c5335426c 100644 --- a/integration/buildfile_test.go +++ b/integration/buildfile_test.go @@ -394,7 +394,7 @@ func buildImage(context testContextTemplate, t *testing.T, eng *engine.Engine, u } dockerfile := constructDockerfile(context.dockerfile, ip, port) - buildfile := server.NewBuildFile(srv, ioutil.Discard, ioutil.Discard, false, useCache, false, ioutil.Discard, utils.NewStreamFormatter(false), nil, nil) + buildfile := server.NewBuildFile(srv, ioutil.Discard, ioutil.Discard, false, useCache, false, ioutil.Discard, utils.NewStreamFormatter(false), nil) id, err := buildfile.Build(context.Archive(dockerfile, t)) if err != nil { return nil, err @@ -828,7 +828,7 @@ func TestForbiddenContextPath(t *testing.T) { } dockerfile := constructDockerfile(context.dockerfile, ip, port) - buildfile := server.NewBuildFile(srv, ioutil.Discard, ioutil.Discard, false, true, false, ioutil.Discard, utils.NewStreamFormatter(false), nil, nil) + buildfile := server.NewBuildFile(srv, ioutil.Discard, ioutil.Discard, false, true, false, ioutil.Discard, utils.NewStreamFormatter(false), nil) _, err = buildfile.Build(context.Archive(dockerfile, t)) if err == nil { @@ -874,7 +874,7 @@ func TestBuildADDFileNotFound(t *testing.T) { } dockerfile := constructDockerfile(context.dockerfile, ip, port) - buildfile := server.NewBuildFile(mkServerFromEngine(eng, t), ioutil.Discard, ioutil.Discard, false, true, false, ioutil.Discard, utils.NewStreamFormatter(false), nil, nil) + buildfile := server.NewBuildFile(mkServerFromEngine(eng, t), ioutil.Discard, ioutil.Discard, false, true, false, ioutil.Discard, utils.NewStreamFormatter(false), nil) _, err = buildfile.Build(context.Archive(dockerfile, t)) if err == nil { diff --git a/server/buildfile.go b/server/buildfile.go index bf7631abfb..7cd1e9971b 100644 --- a/server/buildfile.go +++ b/server/buildfile.go @@ -49,7 +49,6 @@ type buildFile struct { utilizeCache bool rm bool - authConfig *registry.AuthConfig configFile *registry.ConfigFile tmpContainers map[string]struct{} @@ -80,20 +79,10 @@ func (b *buildFile) CmdFrom(name string) error { if err != nil { if b.runtime.Graph().IsNotExist(err) { remote, tag := utils.ParseRepositoryTag(name) - pullRegistryAuth := b.authConfig - if len(b.configFile.Configs) > 0 { - // The request came with a full auth config file, we prefer to use that - endpoint, _, err := registry.ResolveRepositoryName(remote) - if err != nil { - return err - } - resolvedAuth := b.configFile.ResolveAuthConfig(endpoint) - pullRegistryAuth = &resolvedAuth - } job := b.srv.Eng.Job("pull", remote, tag) job.SetenvBool("json", b.sf.Json()) job.SetenvBool("parallel", true) - job.SetenvJson("authConfig", pullRegistryAuth) + job.SetenvJson("configFile", b.configFile) job.Stdout.Add(b.outOld) if err := job.Run(); err != nil { return err @@ -832,7 +821,7 @@ func stripComments(raw []byte) string { return strings.Join(out, "\n") } -func NewBuildFile(srv *Server, outStream, errStream io.Writer, verbose, utilizeCache, rm bool, outOld io.Writer, sf *utils.StreamFormatter, auth *registry.AuthConfig, authConfigFile *registry.ConfigFile) BuildFile { +func NewBuildFile(srv *Server, outStream, errStream io.Writer, verbose, utilizeCache, rm bool, outOld io.Writer, sf *utils.StreamFormatter, configFile *registry.ConfigFile) BuildFile { return &buildFile{ runtime: srv.runtime, srv: srv, @@ -845,8 +834,7 @@ func NewBuildFile(srv *Server, outStream, errStream io.Writer, verbose, utilizeC utilizeCache: utilizeCache, rm: rm, sf: sf, - authConfig: auth, - configFile: authConfigFile, + configFile: configFile, outOld: outOld, } } diff --git a/server/server.go b/server/server.go index 85806d68f4..6d7295efbd 100644 --- a/server/server.go +++ b/server/server.go @@ -448,12 +448,10 @@ func (srv *Server) Build(job *engine.Job) engine.Status { suppressOutput = job.GetenvBool("q") noCache = job.GetenvBool("nocache") rm = job.GetenvBool("rm") - authConfig = ®istry.AuthConfig{} configFile = ®istry.ConfigFile{} tag string context io.ReadCloser ) - job.GetenvJson("authConfig", authConfig) job.GetenvJson("configFile", configFile) repoName, tag = utils.ParseRepositoryTag(repoName) @@ -506,7 +504,7 @@ func (srv *Server) Build(job *engine.Job) engine.Status { Writer: job.Stdout, StreamFormatter: sf, }, - !suppressOutput, !noCache, rm, job.Stdout, sf, authConfig, configFile) + !suppressOutput, !noCache, rm, job.Stdout, sf, configFile) id, err := b.Build(context) if err != nil { return job.Error(err) @@ -1386,16 +1384,23 @@ func (srv *Server) ImagePull(job *engine.Job) engine.Status { localName = job.Args[0] tag string sf = utils.NewStreamFormatter(job.GetenvBool("json")) - authConfig = ®istry.AuthConfig{} + authConfig registry.AuthConfig + configFile = ®istry.ConfigFile{} metaHeaders map[string][]string ) if len(job.Args) > 1 { tag = job.Args[1] } - job.GetenvJson("authConfig", authConfig) + job.GetenvJson("configFile", configFile) job.GetenvJson("metaHeaders", metaHeaders) + endpoint, _, err := registry.ResolveRepositoryName(localName) + if err != nil { + return job.Error(err) + } + authConfig = configFile.ResolveAuthConfig(endpoint) + c, err := srv.poolAdd("pull", localName+":"+tag) if err != nil { if c != nil { @@ -1414,12 +1419,12 @@ func (srv *Server) ImagePull(job *engine.Job) engine.Status { return job.Error(err) } - endpoint, err := registry.ExpandAndVerifyRegistryUrl(hostname) + endpoint, err = registry.ExpandAndVerifyRegistryUrl(hostname) if err != nil { return job.Error(err) } - r, err := registry.NewRegistry(authConfig, srv.HTTPRequestFactory(metaHeaders), endpoint) + r, err := registry.NewRegistry(&authConfig, srv.HTTPRequestFactory(metaHeaders), endpoint) if err != nil { return job.Error(err) } From 69fbf8e31f0b74c61c7e7fe1bd34bbb1aaf813b6 Mon Sep 17 00:00:00 2001 From: Justin Simonelis Date: Fri, 11 Apr 2014 08:51:50 -0400 Subject: [PATCH 032/436] terms update: FQIN must include a tag change: A fully qualified image name must include a tag. Recommitting changes for PR: https://github.com/dotcloud/docker/pull/5145 since SvenDowideit suggested I would need to sign my commit for it to be accepted. Docker-DCO-1.1-Signed-off-by: Justin Simonelis (github: jsimonelis) --- docs/sources/terms/repository.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/terms/repository.rst b/docs/sources/terms/repository.rst index e4fe4b8fd1..04f3950f36 100644 --- a/docs/sources/terms/repository.rst +++ b/docs/sources/terms/repository.rst @@ -19,9 +19,9 @@ using one of three different commands: A `Fully Qualified Image Name` (FQIN) can be made up of 3 parts: -``[registry_hostname[:port]/][user_name/](repository_name[:version_tag])`` +``[registry_hostname[:port]/][user_name/](repository_name:version_tag)`` -``version_tag`` defaults to ``latest``, ``username`` and ``registry_hostname`` default to an empty string. +``username`` and ``registry_hostname`` default to an empty string. When ``registry_hostname`` is an empty string, then ``docker push`` will push to ``index.docker.io:80``. If you create a new repository which you want to share, you will need to set at least the From 031fcb31d3a81fbd5c5ab8d898d53fbd486413e6 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Wed, 9 Apr 2014 11:43:19 +0000 Subject: [PATCH 033/436] Setup cgroups for all subsystems Fixes #5117 Fixes #5118 Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- integration-cli/docker_cli_top_test.go | 28 ++++++++++++++++++-- pkg/cgroups/apply_raw.go | 36 ++++++++++++++------------ 2 files changed, 45 insertions(+), 19 deletions(-) diff --git a/integration-cli/docker_cli_top_test.go b/integration-cli/docker_cli_top_test.go index 73d590cf06..d75ec54217 100644 --- a/integration-cli/docker_cli_top_test.go +++ b/integration-cli/docker_cli_top_test.go @@ -7,7 +7,7 @@ import ( "testing" ) -func TestTop(t *testing.T) { +func TestTopNonPrivileged(t *testing.T) { runCmd := exec.Command(dockerBinary, "run", "-i", "-d", "busybox", "sleep", "20") out, _, err := runCommandWithOutput(runCmd) errorOut(err, t, fmt.Sprintf("failed to start the container: %v", err)) @@ -28,5 +28,29 @@ func TestTop(t *testing.T) { t.Fatal("top should've listed sleep 20 in the process list") } - logDone("top - sleep process should be listed") + logDone("top - sleep process should be listed in non privileged mode") +} + +func TestTopPrivileged(t *testing.T) { + runCmd := exec.Command(dockerBinary, "run", "--privileged", "-i", "-d", "busybox", "sleep", "20") + out, _, err := runCommandWithOutput(runCmd) + errorOut(err, t, fmt.Sprintf("failed to start the container: %v", err)) + + cleanedContainerID := stripTrailingCharacters(out) + + topCmd := exec.Command(dockerBinary, "top", cleanedContainerID) + out, _, err = runCommandWithOutput(topCmd) + errorOut(err, t, fmt.Sprintf("failed to run top: %v %v", out, err)) + + killCmd := exec.Command(dockerBinary, "kill", cleanedContainerID) + _, err = runCommand(killCmd) + errorOut(err, t, fmt.Sprintf("failed to kill container: %v", err)) + + deleteContainer(cleanedContainerID) + + if !strings.Contains(out, "sleep 20") { + t.Fatal("top should've listed sleep 20 in the process list") + } + + logDone("top - sleep process should be listed in privileged mode") } diff --git a/pkg/cgroups/apply_raw.go b/pkg/cgroups/apply_raw.go index 220f08f1dc..f4fea133c5 100644 --- a/pkg/cgroups/apply_raw.go +++ b/pkg/cgroups/apply_raw.go @@ -78,17 +78,17 @@ func (raw *rawCgroup) join(subsystem string, pid int) (string, error) { } func (raw *rawCgroup) setupDevices(c *Cgroup, pid int) (err error) { - if !c.DeviceAccess { - dir, err := raw.join("devices", pid) + dir, err := raw.join("devices", pid) + if err != nil { + return err + } + defer func() { if err != nil { - return err + os.RemoveAll(dir) } + }() - defer func() { - if err != nil { - os.RemoveAll(dir) - } - }() + if !c.DeviceAccess { if err := writeFile(dir, "devices.deny", "a"); err != nil { return err @@ -132,16 +132,17 @@ func (raw *rawCgroup) setupDevices(c *Cgroup, pid int) (err error) { } func (raw *rawCgroup) setupMemory(c *Cgroup, pid int) (err error) { - if c.Memory != 0 || c.MemorySwap != 0 { - dir, err := raw.join("memory", pid) + dir, err := raw.join("memory", pid) + if err != nil && (c.Memory != 0 || c.MemorySwap != 0) { + return err + } + defer func() { if err != nil { - return err + os.RemoveAll(dir) } - defer func() { - if err != nil { - os.RemoveAll(dir) - } - }() + }() + + if c.Memory != 0 || c.MemorySwap != 0 { if c.Memory != 0 { if err := writeFile(dir, "memory.limit_in_bytes", strconv.FormatInt(c.Memory, 10)); err != nil { @@ -178,9 +179,10 @@ func (raw *rawCgroup) setupCpu(c *Cgroup, pid int) (err error) { } func (raw *rawCgroup) setupCpuset(c *Cgroup, pid int) (err error) { + // we don't want to join this cgroup unless it is specified if c.CpusetCpus != "" { dir, err := raw.join("cpuset", pid) - if err != nil { + if err != nil && c.CpusetCpus != "" { return err } defer func() { From 505184d2dcb5d21834bcb2b108564fbdab733953 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 11 Apr 2014 17:27:19 +0000 Subject: [PATCH 034/436] Join cpuacct, freezer, perf_event, and blkio groups Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/cgroups/apply_raw.go | 54 +++++++++++++++++++++++++++++++--------- 1 file changed, 42 insertions(+), 12 deletions(-) diff --git a/pkg/cgroups/apply_raw.go b/pkg/cgroups/apply_raw.go index f4fea133c5..1700294bea 100644 --- a/pkg/cgroups/apply_raw.go +++ b/pkg/cgroups/apply_raw.go @@ -39,19 +39,21 @@ func rawApply(c *Cgroup, pid int) (ActiveCgroup, error) { root: cgroupRoot, cgroup: cgroup, } + for _, g := range []func(*Cgroup, int) error{ + raw.setupDevices, + raw.setupMemory, + raw.setupCpu, + raw.setupCpuset, + raw.setupCpuacct, + raw.setupBlkio, + raw.setupPerfevent, + raw.setupFreezer, + } { + if err := g(c, pid); err != nil { + return nil, err + } + } - if err := raw.setupDevices(c, pid); err != nil { - return nil, err - } - if err := raw.setupMemory(c, pid); err != nil { - return nil, err - } - if err := raw.setupCpu(c, pid); err != nil { - return nil, err - } - if err := raw.setupCpuset(c, pid); err != nil { - return nil, err - } return raw, nil } @@ -198,6 +200,30 @@ func (raw *rawCgroup) setupCpuset(c *Cgroup, pid int) (err error) { return nil } +func (raw *rawCgroup) setupCpuacct(c *Cgroup, pid int) error { + // we just want to join this group even though we don't set anything + _, err := raw.join("cpuacct", pid) + return err +} + +func (raw *rawCgroup) setupBlkio(c *Cgroup, pid int) error { + // we just want to join this group even though we don't set anything + _, err := raw.join("blkio", pid) + return err +} + +func (raw *rawCgroup) setupPerfevent(c *Cgroup, pid int) error { + // we just want to join this group even though we don't set anything + _, err := raw.join("perf_event", pid) + return err +} + +func (raw *rawCgroup) setupFreezer(c *Cgroup, pid int) error { + // we just want to join this group even though we don't set anything + _, err := raw.join("freezer", pid) + return err +} + func (raw *rawCgroup) Cleanup() error { get := func(subsystem string) string { path, _ := raw.path(subsystem) @@ -209,6 +235,10 @@ func (raw *rawCgroup) Cleanup() error { get("devices"), get("cpu"), get("cpuset"), + get("cpuacct"), + get("blkio"), + get("perf_event"), + get("freezer"), } { if path != "" { os.RemoveAll(path) From 4ddfffcab3edf3d05ee8319e87410fe747979a04 Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Thu, 10 Apr 2014 20:08:56 +0200 Subject: [PATCH 035/436] Join memory and cpu cgroup in systemd too Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: alexlarsson) Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: crosbymichael) --- pkg/cgroups/apply_systemd.go | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/pkg/cgroups/apply_systemd.go b/pkg/cgroups/apply_systemd.go index c689d5753e..a9b3a8d301 100644 --- a/pkg/cgroups/apply_systemd.go +++ b/pkg/cgroups/apply_systemd.go @@ -107,6 +107,12 @@ func systemdApply(c *Cgroup, pid int) (ActiveCgroup, error) { })}) } + // Always enable accounting, this gets us the same behaviour as the raw implementation, + // plus the kernel has some problems with joining the memory cgroup at a later time. + properties = append(properties, + systemd1.Property{"MemoryAccounting", dbus.MakeVariant(true)}, + systemd1.Property{"CPUAccounting", dbus.MakeVariant(true)}) + if c.Memory != 0 { properties = append(properties, systemd1.Property{"MemoryLimit", dbus.MakeVariant(uint64(c.Memory))}) From 4f169c2db512d2ea9ed5729df375896a1ee90347 Mon Sep 17 00:00:00 2001 From: Paul Nasrat Date: Fri, 11 Apr 2014 16:39:58 -0400 Subject: [PATCH 036/436] Enable construction of TruncIndex from id array. Fixes #5166 Current graph.restore is essentially O(n^2 log n) due to how suffixarray creation works. Rather than create/append/create new this supports creation from a seed array of ids. Functional testing shows this eliminates the hang on Creating image graph reported on list. Docker-DCO-1.1-Signed-off-by: Paul Nasrat (github: pnasrat) --- graph/graph.go | 6 ++++-- runtime/runtime.go | 2 +- utils/utils.go | 11 ++++++++--- utils/utils_test.go | 3 ++- 4 files changed, 15 insertions(+), 7 deletions(-) diff --git a/graph/graph.go b/graph/graph.go index 9ebfc3daa6..eeac8ecd27 100644 --- a/graph/graph.go +++ b/graph/graph.go @@ -40,7 +40,7 @@ func NewGraph(root string, driver graphdriver.Driver) (*Graph, error) { graph := &Graph{ Root: abspath, - idIndex: utils.NewTruncIndex(), + idIndex: utils.NewTruncIndex([]string{}), driver: driver, } if err := graph.restore(); err != nil { @@ -54,12 +54,14 @@ func (graph *Graph) restore() error { if err != nil { return err } + var ids = []string{} for _, v := range dir { id := v.Name() if graph.driver.Exists(id) { - graph.idIndex.Add(id) + ids = append(ids, id) } } + graph.idIndex = utils.NewTruncIndex(ids) utils.Debugf("Restored %d elements", len(dir)) return nil } diff --git a/runtime/runtime.go b/runtime/runtime.go index 98903cfa08..d612b48de0 100644 --- a/runtime/runtime.go +++ b/runtime/runtime.go @@ -779,7 +779,7 @@ func NewRuntimeFromDirectory(config *daemonconfig.Config, eng *engine.Engine) (* containers: list.New(), graph: g, repositories: repositories, - idIndex: utils.NewTruncIndex(), + idIndex: utils.NewTruncIndex([]string{}), sysInfo: sysInfo, volumes: volumes, config: config, diff --git a/utils/utils.go b/utils/utils.go index 1fe2e87b4f..8b6db8c464 100644 --- a/utils/utils.go +++ b/utils/utils.go @@ -426,12 +426,17 @@ type TruncIndex struct { bytes []byte } -func NewTruncIndex() *TruncIndex { - return &TruncIndex{ - index: suffixarray.New([]byte{' '}), +func NewTruncIndex(ids []string) (idx *TruncIndex) { + idx = &TruncIndex{ ids: make(map[string]bool), bytes: []byte{' '}, } + for _, id := range ids { + idx.ids[id] = true + idx.bytes = append(idx.bytes, []byte(id+" ")...) + } + idx.index = suffixarray.New(idx.bytes) + return } func (idx *TruncIndex) Add(id string) error { diff --git a/utils/utils_test.go b/utils/utils_test.go index 177d3667e1..4781871267 100644 --- a/utils/utils_test.go +++ b/utils/utils_test.go @@ -138,7 +138,8 @@ func TestRaceWriteBroadcaster(t *testing.T) { // Test the behavior of TruncIndex, an index for querying IDs from a non-conflicting prefix. func TestTruncIndex(t *testing.T) { - index := NewTruncIndex() + ids := []string{} + index := NewTruncIndex(ids) // Get on an empty index if _, err := index.Get("foobar"); err == nil { t.Fatal("Get on an empty index should return an error") From e3e078ca2fc4ce76461a40533add9f33afcd1abe Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Sat, 12 Apr 2014 06:42:53 +0900 Subject: [PATCH 037/436] Add the test to reproduce the issue even in "make test" Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- utils/fs_test.go | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/utils/fs_test.go b/utils/fs_test.go index dd5d97be40..9affc00e91 100644 --- a/utils/fs_test.go +++ b/utils/fs_test.go @@ -1,6 +1,8 @@ package utils import ( + "io/ioutil" + "os" "path/filepath" "testing" ) @@ -26,6 +28,29 @@ func TestFollowSymLinkNormal(t *testing.T) { } } +func TestFollowSymLinkUnderLinkedDir(t *testing.T) { + dir, err := ioutil.TempDir("", "docker-fs-test") + if err != nil { + t.Fatal(err) + } + + os.Mkdir(filepath.Join(dir, "realdir"), 0700) + os.Symlink("realdir", filepath.Join(dir, "linkdir")) + + linkDir := filepath.Join(dir, "linkdir", "foo") + dirUnderLinkDir := filepath.Join(dir, "linkdir", "foo", "bar") + os.MkdirAll(dirUnderLinkDir, 0700) + + rewrite, err := FollowSymlinkInScope(dirUnderLinkDir, linkDir) + if err != nil { + t.Fatal(err) + } + + if rewrite != dirUnderLinkDir { + t.Fatalf("Expected %s got %s", dirUnderLinkDir, rewrite) + } +} + func TestFollowSymLinkRandomString(t *testing.T) { if _, err := FollowSymlinkInScope("toto", "testdata"); err == nil { t.Fatal("Random string should fail but didn't") From 0f724863468733847306f47835739f480a7fac63 Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Fri, 11 Apr 2014 07:47:53 +0900 Subject: [PATCH 038/436] Fix utils.FollowSymlinkInScope's infinite loop bug fs_test.go doesn't finish if Docker's code is placed under a directory which has symlinks between / and the directory. For example, the below doesn't finish before the change. /home -> usr/home FollowSymlinkInScope("/home/bob/foo/bar", "/home/bob/foo") Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- utils/fs.go | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/utils/fs.go b/utils/fs.go index 92864e5e16..46f64903b3 100644 --- a/utils/fs.go +++ b/utils/fs.go @@ -62,6 +62,15 @@ func FollowSymlinkInScope(link, root string) (string, error) { prev = filepath.Clean(prev) for { + if !strings.HasPrefix(prev, root) { + // Don't resolve symlinks outside of root. For example, + // we don't have to check /home in the below. + // + // /home -> usr/home + // FollowSymlinkInScope("/home/bob/foo/bar", "/home/bob/foo") + break + } + stat, err := os.Lstat(prev) if err != nil { if os.IsNotExist(err) { From 26845ef1ae97be3904b2fd85fa06f9a97ccee67c Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Barth Date: Sat, 12 Apr 2014 02:09:06 +0000 Subject: [PATCH 039/436] Docs: add some example log lines that indicate a lack of memory when running the test suite Docker-DCO-1.1-Signed-off-by: Jean-Baptiste Barth (github: jbbarth) --- docs/sources/contributing/devenvironment.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/sources/contributing/devenvironment.rst b/docs/sources/contributing/devenvironment.rst index 42e6f9be84..fbd47cbed7 100644 --- a/docs/sources/contributing/devenvironment.rst +++ b/docs/sources/contributing/devenvironment.rst @@ -127,6 +127,15 @@ You can use this to select certain tests to run, eg. TESTFLAGS='-run ^TestBuild$' make test +If the output indicates "FAIL" and you see errors like this: + +.. code-block:: text + + server.go:1302 Error: Insertion failed because database is full: database or disk is full + + utils_test.go:179: Error copy: exit status 1 (cp: writing '/tmp/docker-testd5c9-[...]': No space left on device + +Then you likely don't have enough memory available the test suite. 2GB is recommended. Step 6: Use Docker ------------------- From 0a0e49d406d10ce7c79952c78162768dd05ee875 Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Barth Date: Sat, 12 Apr 2014 10:57:19 +0000 Subject: [PATCH 040/436] Docs: improve installation/ubuntulinux memory and swap accounting section Docker-DCO-1.1-Signed-off-by: Jean-Baptiste Barth (github: jbbarth) --- docs/sources/installation/ubuntulinux.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/sources/installation/ubuntulinux.rst b/docs/sources/installation/ubuntulinux.rst index 51f303e88a..3e4b2a9855 100644 --- a/docs/sources/installation/ubuntulinux.rst +++ b/docs/sources/installation/ubuntulinux.rst @@ -234,7 +234,7 @@ To install the latest version of docker, use the standard ``apt-get`` method: Memory and Swap Accounting ^^^^^^^^^^^^^^^^^^^^^^^^^^ -If want to enable memory and swap accounting, you must add the following +If you want to enable memory and swap accounting, you must add the following command-line parameters to your kernel:: cgroup_enable=memory swapaccount=1 @@ -249,7 +249,12 @@ And replace it by the following one:: GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" -Then run ``update-grub``, and reboot. +Then run ``sudo update-grub``, and reboot. + +These parameters will help you get rid of the following warnings:: + + WARNING: Your kernel does not support cgroup swap limit. + WARNING: Your kernel does not support swap limit capabilities. Limitation discarded. Troubleshooting ^^^^^^^^^^^^^^^ From 449f92f11ed34d4475fa24e2561b02cc263722bf Mon Sep 17 00:00:00 2001 From: unclejack Date: Sat, 12 Apr 2014 03:49:49 +0300 Subject: [PATCH 041/436] cli integ: don't fetch busybox if it exists Don't make calls to the registry if the image exists already. Docker-DCO-1.1-Signed-off-by: Cristian Staretu (github: unclejack) --- hack/make/test-integration-cli | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/hack/make/test-integration-cli b/hack/make/test-integration-cli index 6e8b38892e..93330d7b09 100644 --- a/hack/make/test-integration-cli +++ b/hack/make/test-integration-cli @@ -29,8 +29,11 @@ bundle_test_integration_cli() { # pull the busybox image before running the tests sleep 2 - ( set -x; docker pull busybox ) + if ! docker inspect busybox &> /dev/null; then + ( set -x; docker pull busybox ) + fi + bundle_test_integration_cli DOCKERD_PID=$(set -x; cat $DEST/docker.pid) From 5f4bc4f916f433a4ba258980a6c2fbdbd76d64f3 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Sun, 13 Apr 2014 14:20:04 +0000 Subject: [PATCH 042/436] Use apparmor_parser directly The current load script does alot of things. If it does not find the parser loaded on the system it will just exit 0 and not load the profile. We think it should fail loudly if it cannot load the profile and apparmor is enabled on the system. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/apparmor/apparmor.go | 8 +++-- pkg/libcontainer/apparmor/setup.go | 48 +++++++++------------------ 2 files changed, 21 insertions(+), 35 deletions(-) diff --git a/pkg/libcontainer/apparmor/apparmor.go b/pkg/libcontainer/apparmor/apparmor.go index 5de241dd97..0987398124 100644 --- a/pkg/libcontainer/apparmor/apparmor.go +++ b/pkg/libcontainer/apparmor/apparmor.go @@ -8,12 +8,16 @@ package apparmor import "C" import ( "io/ioutil" + "os" "unsafe" ) func IsEnabled() bool { - buf, err := ioutil.ReadFile("/sys/module/apparmor/parameters/enabled") - return err == nil && len(buf) > 1 && buf[0] == 'Y' + if _, err := os.Stat("/sys/kernel/security/apparmor"); err == nil { + buf, err := ioutil.ReadFile("/sys/module/apparmor/parameters/enabled") + return err == nil && len(buf) > 1 && buf[0] == 'Y' + } + return false } func ApplyProfile(pid int, name string) error { diff --git a/pkg/libcontainer/apparmor/setup.go b/pkg/libcontainer/apparmor/setup.go index 548e72f550..e32e8156ca 100644 --- a/pkg/libcontainer/apparmor/setup.go +++ b/pkg/libcontainer/apparmor/setup.go @@ -14,8 +14,6 @@ const ( ) const DefaultProfile = ` -# AppArmor profile from lxc for containers. - #include profile docker-default flags=(attach_disconnected,mediate_deleted) { #include @@ -24,43 +22,28 @@ profile docker-default flags=(attach_disconnected,mediate_deleted) { file, umount, - # ignore DENIED message on / remount - deny mount options=(ro, remount) -> /, - - # allow tmpfs mounts everywhere mount fstype=tmpfs, - - # allow mqueue mounts everywhere mount fstype=mqueue, - - # allow fuse mounts everywhere mount fstype=fuse.*, - - # allow bind mount of /lib/init/fstab for lxcguest - mount options=(rw, bind) /lib/init/fstab.lxc/ -> /lib/init/fstab/, - - # deny writes in /proc/sys/fs but allow binfmt_misc to be mounted mount fstype=binfmt_misc -> /proc/sys/fs/binfmt_misc/, - deny @{PROC}/sys/fs/** wklx, - - # allow efivars to be mounted, writing to it will be blocked though mount fstype=efivarfs -> /sys/firmware/efi/efivars/, + mount fstype=fusectl -> /sys/fs/fuse/connections/, + mount fstype=securityfs -> /sys/kernel/security/, + mount fstype=debugfs -> /sys/kernel/debug/, + mount fstype=proc -> /proc/, + mount fstype=sysfs -> /sys/, - # block some other dangerous paths + deny @{PROC}/sys/fs/** wklx, deny @{PROC}/sysrq-trigger rwklx, deny @{PROC}/mem rwklx, deny @{PROC}/kmem rwklx, deny @{PROC}/sys/kernel/[^s][^h][^m]* wklx, deny @{PROC}/sys/kernel/*/** wklx, - # deny writes in /sys except for /sys/fs/cgroup, also allow - # fusectl, securityfs and debugfs to be mounted there (read-only) - mount fstype=fusectl -> /sys/fs/fuse/connections/, - mount fstype=securityfs -> /sys/kernel/security/, - mount fstype=debugfs -> /sys/kernel/debug/, + deny mount options=(ro, remount) -> /, deny mount fstype=debugfs -> /var/lib/ureadahead/debugfs/, - mount fstype=proc -> /proc/, - mount fstype=sysfs -> /sys/, + deny mount fstype=devpts, + deny /sys/[^f]*/** wklx, deny /sys/f[^s]*/** wklx, deny /sys/fs/[^c]*/** wklx, @@ -68,12 +51,6 @@ profile docker-default flags=(attach_disconnected,mediate_deleted) { deny /sys/fs/cg[^r]*/** wklx, deny /sys/firmware/efi/efivars/** rwklx, deny /sys/kernel/security/** rwklx, - mount options=(move) /sys/fs/cgroup/cgmanager/ -> /sys/fs/cgroup/cgmanager.lower/, - - # the container may never be allowed to mount devpts. If it does, it - # will remount the host's devpts. We could allow it to do it with - # the newinstance option (but, right now, we don't). - deny mount fstype=devpts, } ` @@ -101,11 +78,13 @@ func InstallDefaultProfile(backupPath string) error { return err } defer f.Close() + src, err := os.Open(DefaultProfilePath) if err != nil { return err } defer src.Close() + if _, err := io.Copy(f, src); err != nil { return err } @@ -120,7 +99,10 @@ func InstallDefaultProfile(backupPath string) error { return err } - output, err := exec.Command("/lib/init/apparmor-profile-load", "docker").CombinedOutput() + // the current functionality of the load script is the exit 0 if the parser does not exist. + // we think we should fail loudly if you have apparmor enabled but not the parser to load + // the profile for use. + output, err := exec.Command("/sbin/apparmor_parser", "-r", "-W", "docker").CombinedOutput() if err != nil { return fmt.Errorf("Error loading docker profile: %s (%s)", err, output) } From 052cc5a6378ee4bbe1ef79e5632e2439d68ddbde Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Sun, 13 Apr 2014 23:33:25 +0000 Subject: [PATCH 043/436] Move apparmor to top level pkg Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/{libcontainer => }/apparmor/apparmor.go | 0 pkg/{libcontainer => }/apparmor/apparmor_disabled.go | 0 pkg/{libcontainer => }/apparmor/setup.go | 0 pkg/libcontainer/nsinit/init.go | 2 +- runtime/execdriver/native/create.go | 2 +- runtime/execdriver/native/driver.go | 2 +- runtime/execdriver/native/template/default_template.go | 2 +- 7 files changed, 4 insertions(+), 4 deletions(-) rename pkg/{libcontainer => }/apparmor/apparmor.go (100%) rename pkg/{libcontainer => }/apparmor/apparmor_disabled.go (100%) rename pkg/{libcontainer => }/apparmor/setup.go (100%) diff --git a/pkg/libcontainer/apparmor/apparmor.go b/pkg/apparmor/apparmor.go similarity index 100% rename from pkg/libcontainer/apparmor/apparmor.go rename to pkg/apparmor/apparmor.go diff --git a/pkg/libcontainer/apparmor/apparmor_disabled.go b/pkg/apparmor/apparmor_disabled.go similarity index 100% rename from pkg/libcontainer/apparmor/apparmor_disabled.go rename to pkg/apparmor/apparmor_disabled.go diff --git a/pkg/libcontainer/apparmor/setup.go b/pkg/apparmor/setup.go similarity index 100% rename from pkg/libcontainer/apparmor/setup.go rename to pkg/apparmor/setup.go diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index b6c02eafd5..0e85c0e4be 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -8,9 +8,9 @@ import ( "runtime" "syscall" + "github.com/dotcloud/docker/pkg/apparmor" "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/libcontainer" - "github.com/dotcloud/docker/pkg/libcontainer/apparmor" "github.com/dotcloud/docker/pkg/libcontainer/capabilities" "github.com/dotcloud/docker/pkg/libcontainer/network" "github.com/dotcloud/docker/pkg/libcontainer/utils" diff --git a/runtime/execdriver/native/create.go b/runtime/execdriver/native/create.go index 12546145f9..ac67839e4b 100644 --- a/runtime/execdriver/native/create.go +++ b/runtime/execdriver/native/create.go @@ -4,9 +4,9 @@ import ( "fmt" "os" + "github.com/dotcloud/docker/pkg/apparmor" "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/libcontainer" - "github.com/dotcloud/docker/pkg/libcontainer/apparmor" "github.com/dotcloud/docker/runtime/execdriver" "github.com/dotcloud/docker/runtime/execdriver/native/configuration" "github.com/dotcloud/docker/runtime/execdriver/native/template" diff --git a/runtime/execdriver/native/driver.go b/runtime/execdriver/native/driver.go index d18865e508..c99cae31dd 100644 --- a/runtime/execdriver/native/driver.go +++ b/runtime/execdriver/native/driver.go @@ -3,9 +3,9 @@ package native import ( "encoding/json" "fmt" + "github.com/dotcloud/docker/pkg/apparmor" "github.com/dotcloud/docker/pkg/cgroups" "github.com/dotcloud/docker/pkg/libcontainer" - "github.com/dotcloud/docker/pkg/libcontainer/apparmor" "github.com/dotcloud/docker/pkg/libcontainer/nsinit" "github.com/dotcloud/docker/pkg/system" "github.com/dotcloud/docker/runtime/execdriver" diff --git a/runtime/execdriver/native/template/default_template.go b/runtime/execdriver/native/template/default_template.go index d3c433a317..c354637fcb 100644 --- a/runtime/execdriver/native/template/default_template.go +++ b/runtime/execdriver/native/template/default_template.go @@ -1,9 +1,9 @@ package template import ( + "github.com/dotcloud/docker/pkg/apparmor" "github.com/dotcloud/docker/pkg/cgroups" "github.com/dotcloud/docker/pkg/libcontainer" - "github.com/dotcloud/docker/pkg/libcontainer/apparmor" ) // New returns the docker default configuration for libcontainer From 6c26a87901d12188dfd9986d9211f6077a286f9d Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Sun, 13 Apr 2014 23:37:12 +0000 Subject: [PATCH 044/436] Ignore is not exist error Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/apparmor/setup.go | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/pkg/apparmor/setup.go b/pkg/apparmor/setup.go index e32e8156ca..349476219b 100644 --- a/pkg/apparmor/setup.go +++ b/pkg/apparmor/setup.go @@ -99,11 +99,15 @@ func InstallDefaultProfile(backupPath string) error { return err } - // the current functionality of the load script is the exit 0 if the parser does not exist. - // we think we should fail loudly if you have apparmor enabled but not the parser to load - // the profile for use. output, err := exec.Command("/sbin/apparmor_parser", "-r", "-W", "docker").CombinedOutput() - if err != nil { + if err != nil && !os.IsNotExist(err) { + if e, ok := err.(*exec.Error); ok { + // keeping with the current profile load code, if the parser does not exist then + // just return + if e.Err == exec.ErrNotFound || os.IsNotExist(e.Err) { + return nil + } + } return fmt.Errorf("Error loading docker profile: %s (%s)", err, output) } return nil From 184728e7bcf9af3224f53e8d5d38d44b08de24ec Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 00:02:01 +0000 Subject: [PATCH 045/436] Ignore not exist errors for joining default subsystems Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/cgroups/apply_raw.go | 26 +++++++++++++++++--------- pkg/cgroups/cgroups.go | 10 +++++++--- 2 files changed, 24 insertions(+), 12 deletions(-) diff --git a/pkg/cgroups/apply_raw.go b/pkg/cgroups/apply_raw.go index 1700294bea..471d3fcf53 100644 --- a/pkg/cgroups/apply_raw.go +++ b/pkg/cgroups/apply_raw.go @@ -135,6 +135,7 @@ func (raw *rawCgroup) setupDevices(c *Cgroup, pid int) (err error) { func (raw *rawCgroup) setupMemory(c *Cgroup, pid int) (err error) { dir, err := raw.join("memory", pid) + // only return an error for memory if it was not specified if err != nil && (c.Memory != 0 || c.MemorySwap != 0) { return err } @@ -145,7 +146,6 @@ func (raw *rawCgroup) setupMemory(c *Cgroup, pid int) (err error) { }() if c.Memory != 0 || c.MemorySwap != 0 { - if c.Memory != 0 { if err := writeFile(dir, "memory.limit_in_bytes", strconv.FormatInt(c.Memory, 10)); err != nil { return err @@ -202,26 +202,34 @@ func (raw *rawCgroup) setupCpuset(c *Cgroup, pid int) (err error) { func (raw *rawCgroup) setupCpuacct(c *Cgroup, pid int) error { // we just want to join this group even though we don't set anything - _, err := raw.join("cpuacct", pid) - return err + if _, err := raw.join("cpuacct", pid); err != nil && err != ErrNotFound { + return err + } + return nil } func (raw *rawCgroup) setupBlkio(c *Cgroup, pid int) error { // we just want to join this group even though we don't set anything - _, err := raw.join("blkio", pid) - return err + if _, err := raw.join("blkio", pid); err != nil && err != ErrNotFound { + return err + } + return nil } func (raw *rawCgroup) setupPerfevent(c *Cgroup, pid int) error { // we just want to join this group even though we don't set anything - _, err := raw.join("perf_event", pid) - return err + if _, err := raw.join("perf_event", pid); err != nil && err != ErrNotFound { + return err + } + return nil } func (raw *rawCgroup) setupFreezer(c *Cgroup, pid int) error { // we just want to join this group even though we don't set anything - _, err := raw.join("freezer", pid) - return err + if _, err := raw.join("freezer", pid); err != nil && err != ErrNotFound { + return err + } + return nil } func (raw *rawCgroup) Cleanup() error { diff --git a/pkg/cgroups/cgroups.go b/pkg/cgroups/cgroups.go index 5fe10346df..e5e8f82db6 100644 --- a/pkg/cgroups/cgroups.go +++ b/pkg/cgroups/cgroups.go @@ -2,7 +2,7 @@ package cgroups import ( "bufio" - "fmt" + "errors" "github.com/dotcloud/docker/pkg/mount" "io" "io/ioutil" @@ -11,6 +11,10 @@ import ( "strings" ) +var ( + ErrNotFound = errors.New("mountpoint not found") +) + type Cgroup struct { Name string `json:"name,omitempty"` Parent string `json:"parent,omitempty"` @@ -44,7 +48,7 @@ func FindCgroupMountpoint(subsystem string) (string, error) { } } } - return "", fmt.Errorf("cgroup mountpoint not found for %s", subsystem) + return "", ErrNotFound } // Returns the relative path to the cgroup docker is running in. @@ -82,7 +86,7 @@ func parseCgroupFile(subsystem string, r io.Reader) (string, error) { } } } - return "", fmt.Errorf("cgroup '%s' not found in /proc/self/cgroup", subsystem) + return "", ErrNotFound } func writeFile(dir, file, data string) error { From 84a76f27962d4f4b3871abe925ca17024bdeea73 Mon Sep 17 00:00:00 2001 From: Paul Nasrat Date: Sun, 13 Apr 2014 22:34:22 -0400 Subject: [PATCH 046/436] Add benchmark tests for TruncIndex. Compare add vs new. Some historical data in PR #5172. Docker-DCO-1.1-Signed-off-by: Paul Nasrat (github: pnasrat) --- utils/utils_test.go | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/utils/utils_test.go b/utils/utils_test.go index 4781871267..501ae67c2c 100644 --- a/utils/utils_test.go +++ b/utils/utils_test.go @@ -219,6 +219,25 @@ func assertIndexGet(t *testing.T, index *TruncIndex, input, expectedResult strin } } +func BenchmarkTruncIndexAdd(b *testing.B) { + ids := []string{"banana", "bananaa", "bananab"} + b.ResetTimer() + for i := 0; i < b.N; i++ { + index := NewTruncIndex([]string{}) + for _, id := range ids { + index.Add(id) + } + } +} + +func BenchmarkTruncIndexNew(b *testing.B) { + ids := []string{"banana", "bananaa", "bananab"} + b.ResetTimer() + for i := 0; i < b.N; i++ { + NewTruncIndex(ids) + } +} + func assertKernelVersion(t *testing.T, a, b *KernelVersionInfo, result int) { if r := CompareKernelVersion(a, b); r != result { t.Fatalf("Unexpected kernel version comparison result. Found %d, expected %d", r, result) From 3061a6a2ab0395c626f9acaa2e5d9c17152b0475 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 05:22:45 +0000 Subject: [PATCH 047/436] Generate imports based on what is avaliable Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/apparmor/gen.go | 92 +++++++++++++++++++++++++++++++++++++++++++ pkg/apparmor/setup.go | 61 +++++++--------------------- 2 files changed, 107 insertions(+), 46 deletions(-) create mode 100644 pkg/apparmor/gen.go diff --git a/pkg/apparmor/gen.go b/pkg/apparmor/gen.go new file mode 100644 index 0000000000..bf9be2ae0b --- /dev/null +++ b/pkg/apparmor/gen.go @@ -0,0 +1,92 @@ +package apparmor + +import ( + "io" + "os" + "text/template" +) + +type data struct { + Name string + Imports []string + InnerImports []string +} + +const baseTemplate = ` +{{range $value := .Imports}} +{{$value}} +{{end}} + +profile {{.Name}} flags=(attach_disconnected,mediate_deleted) { +{{range $value := .InnerImports}} + {{$value}} +{{end}} + + network, + capability, + file, + umount, + + mount fstype=tmpfs, + mount fstype=mqueue, + mount fstype=fuse.*, + mount fstype=binfmt_misc -> /proc/sys/fs/binfmt_misc/, + mount fstype=efivarfs -> /sys/firmware/efi/efivars/, + mount fstype=fusectl -> /sys/fs/fuse/connections/, + mount fstype=securityfs -> /sys/kernel/security/, + mount fstype=debugfs -> /sys/kernel/debug/, + mount fstype=proc -> /proc/, + mount fstype=sysfs -> /sys/, + + deny @{PROC}/sys/fs/** wklx, + deny @{PROC}/sysrq-trigger rwklx, + deny @{PROC}/mem rwklx, + deny @{PROC}/kmem rwklx, + deny @{PROC}/sys/kernel/[^s][^h][^m]* wklx, + deny @{PROC}/sys/kernel/*/** wklx, + + deny mount options=(ro, remount) -> /, + deny mount fstype=debugfs -> /var/lib/ureadahead/debugfs/, + deny mount fstype=devpts, + + deny /sys/[^f]*/** wklx, + deny /sys/f[^s]*/** wklx, + deny /sys/fs/[^c]*/** wklx, + deny /sys/fs/c[^g]*/** wklx, + deny /sys/fs/cg[^r]*/** wklx, + deny /sys/firmware/efi/efivars/** rwklx, + deny /sys/kernel/security/** rwklx, +} +` + +func generateProfile(out io.Writer) error { + compiled, err := template.New("apparmor_profile").Parse(baseTemplate) + if err != nil { + return err + } + data := &data{ + Name: "docker-default", + } + if tuntablesExists() { + data.Imports = append(data.Imports, "#include ") + } + if abstrctionsEsists() { + data.InnerImports = append(data.InnerImports, "#include ") + } + if err := compiled.Execute(out, data); err != nil { + return err + } + return nil +} + +// check if the tunables/global exist +func tuntablesExists() bool { + _, err := os.Stat("/etc/apparmor.d/tunables/global") + return err == nil +} + +// check if abstractions/base exist +func abstrctionsEsists() bool { + _, err := os.Stat("/etc/apparmor.d/abstractions/base") + return err == nil +} diff --git a/pkg/apparmor/setup.go b/pkg/apparmor/setup.go index 349476219b..2401f63414 100644 --- a/pkg/apparmor/setup.go +++ b/pkg/apparmor/setup.go @@ -3,7 +3,6 @@ package apparmor import ( "fmt" "io" - "io/ioutil" "os" "os/exec" "path" @@ -13,47 +12,6 @@ const ( DefaultProfilePath = "/etc/apparmor.d/docker" ) -const DefaultProfile = ` -#include -profile docker-default flags=(attach_disconnected,mediate_deleted) { - #include - network, - capability, - file, - umount, - - mount fstype=tmpfs, - mount fstype=mqueue, - mount fstype=fuse.*, - mount fstype=binfmt_misc -> /proc/sys/fs/binfmt_misc/, - mount fstype=efivarfs -> /sys/firmware/efi/efivars/, - mount fstype=fusectl -> /sys/fs/fuse/connections/, - mount fstype=securityfs -> /sys/kernel/security/, - mount fstype=debugfs -> /sys/kernel/debug/, - mount fstype=proc -> /proc/, - mount fstype=sysfs -> /sys/, - - deny @{PROC}/sys/fs/** wklx, - deny @{PROC}/sysrq-trigger rwklx, - deny @{PROC}/mem rwklx, - deny @{PROC}/kmem rwklx, - deny @{PROC}/sys/kernel/[^s][^h][^m]* wklx, - deny @{PROC}/sys/kernel/*/** wklx, - - deny mount options=(ro, remount) -> /, - deny mount fstype=debugfs -> /var/lib/ureadahead/debugfs/, - deny mount fstype=devpts, - - deny /sys/[^f]*/** wklx, - deny /sys/f[^s]*/** wklx, - deny /sys/fs/[^c]*/** wklx, - deny /sys/fs/c[^g]*/** wklx, - deny /sys/fs/cg[^r]*/** wklx, - deny /sys/firmware/efi/efivars/** rwklx, - deny /sys/kernel/security/** rwklx, -} -` - func InstallDefaultProfile(backupPath string) error { if !IsEnabled() { return nil @@ -95,15 +53,26 @@ func InstallDefaultProfile(backupPath string) error { return err } - if err := ioutil.WriteFile(DefaultProfilePath, []byte(DefaultProfile), 0644); err != nil { + f, err := os.OpenFile(DefaultProfilePath, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0644) + if err != nil { return err } + if err := generateProfile(f); err != nil { + f.Close() + return err + } + f.Close() - output, err := exec.Command("/sbin/apparmor_parser", "-r", "-W", "docker").CombinedOutput() + cmd := exec.Command("/sbin/apparmor_parser", "-r", "-W", "docker") + // to use the parser directly we have to make sure we are in the correct + // dir with the profile + cmd.Dir = "/etc/apparmor.d" + + output, err := cmd.CombinedOutput() if err != nil && !os.IsNotExist(err) { if e, ok := err.(*exec.Error); ok { - // keeping with the current profile load code, if the parser does not exist then - // just return + // keeping with the current profile load code, if the parser does not + // exist then just return if e.Err == exec.ErrNotFound || os.IsNotExist(e.Err) { return nil } From f00ca72baa6c43de35d622caa728587a752d6e5e Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 06:15:31 +0000 Subject: [PATCH 048/436] Move network settings into separate file Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- runtime/container.go | 36 ------------------------------- runtime/network_settings.go | 42 +++++++++++++++++++++++++++++++++++++ 2 files changed, 42 insertions(+), 36 deletions(-) create mode 100644 runtime/network_settings.go diff --git a/runtime/container.go b/runtime/container.go index c8053b146c..f2d4ddc79d 100644 --- a/runtime/container.go +++ b/runtime/container.go @@ -76,42 +76,6 @@ type Container struct { activeLinks map[string]*links.Link } -// FIXME: move deprecated port stuff to nat to clean up the core. -type PortMapping map[string]string // Deprecated - -type NetworkSettings struct { - IPAddress string - IPPrefixLen int - Gateway string - Bridge string - PortMapping map[string]PortMapping // Deprecated - Ports nat.PortMap -} - -func (settings *NetworkSettings) PortMappingAPI() *engine.Table { - var outs = engine.NewTable("", 0) - for port, bindings := range settings.Ports { - p, _ := nat.ParsePort(port.Port()) - if len(bindings) == 0 { - out := &engine.Env{} - out.SetInt("PublicPort", p) - out.Set("Type", port.Proto()) - outs.Add(out) - continue - } - for _, binding := range bindings { - out := &engine.Env{} - h, _ := nat.ParsePort(binding.HostPort) - out.SetInt("PrivatePort", p) - out.SetInt("PublicPort", h) - out.Set("Type", port.Proto()) - out.Set("IP", binding.HostIp) - outs.Add(out) - } - } - return outs -} - // Inject the io.Reader at the given path. Note: do not close the reader func (container *Container) Inject(file io.Reader, pth string) error { if err := container.Mount(); err != nil { diff --git a/runtime/network_settings.go b/runtime/network_settings.go new file mode 100644 index 0000000000..dc009e246d --- /dev/null +++ b/runtime/network_settings.go @@ -0,0 +1,42 @@ +package runtime + +import ( + "github.com/dotcloud/docker/engine" + "github.com/dotcloud/docker/nat" +) + +// FIXME: move deprecated port stuff to nat to clean up the core. +type PortMapping map[string]string // Deprecated + +type NetworkSettings struct { + IPAddress string + IPPrefixLen int + Gateway string + Bridge string + PortMapping map[string]PortMapping // Deprecated + Ports nat.PortMap +} + +func (settings *NetworkSettings) PortMappingAPI() *engine.Table { + var outs = engine.NewTable("", 0) + for port, bindings := range settings.Ports { + p, _ := nat.ParsePort(port.Port()) + if len(bindings) == 0 { + out := &engine.Env{} + out.SetInt("PublicPort", p) + out.Set("Type", port.Proto()) + outs.Add(out) + continue + } + for _, binding := range bindings { + out := &engine.Env{} + h, _ := nat.ParsePort(binding.HostPort) + out.SetInt("PrivatePort", p) + out.SetInt("PublicPort", h) + out.Set("Type", port.Proto()) + out.Set("IP", binding.HostIp) + outs.Add(out) + } + } + return outs +} From c99ba05c844d4099b85c653edc0c0f5122ccb522 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 06:40:49 +0000 Subject: [PATCH 049/436] Refactor container start to make it more manageable Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- runtime/container.go | 337 +++++++++++++++++++++++-------------------- runtime/volumes.go | 7 +- 2 files changed, 190 insertions(+), 154 deletions(-) diff --git a/runtime/container.go b/runtime/container.go index f2d4ddc79d..a9b81819d6 100644 --- a/runtime/container.go +++ b/runtime/container.go @@ -322,7 +322,7 @@ func (container *Container) Attach(stdin io.ReadCloser, stdinCloser io.Closer, s }) } -func populateCommand(c *Container) { +func populateCommand(c *Container, env []string) { var ( en *execdriver.Network driverConfig = make(map[string][]string) @@ -366,6 +366,7 @@ func populateCommand(c *Container) { Resources: resources, } c.command.SysProcAttr = &syscall.SysProcAttr{Setsid: true} + c.command.Env = env } func (container *Container) ArgsAsString() string { @@ -387,186 +388,50 @@ func (container *Container) Start() (err error) { if container.State.IsRunning() { return nil } - + // if we encounter and error during start we need to ensure that any other + // setup has been cleaned up properly defer func() { if err != nil { container.cleanup() } }() - if container.ResolvConfPath == "" { - if err := container.setupContainerDns(); err != nil { - return err - } + if err := container.setupContainerDns(); err != nil { + return err } - if err := container.Mount(); err != nil { return err } - - if container.runtime.config.DisableNetwork { - container.Config.NetworkDisabled = true - container.buildHostnameAndHostsFiles("127.0.1.1") - } else { - if err := container.allocateNetwork(); err != nil { - return err - } - container.buildHostnameAndHostsFiles(container.NetworkSettings.IPAddress) + if err := container.initializeNetworking(); err != nil { + return err } - - // Make sure the config is compatible with the current kernel - if container.Config.Memory > 0 && !container.runtime.sysInfo.MemoryLimit { - log.Printf("WARNING: Your kernel does not support memory limit capabilities. Limitation discarded.\n") - container.Config.Memory = 0 - } - if container.Config.Memory > 0 && !container.runtime.sysInfo.SwapLimit { - log.Printf("WARNING: Your kernel does not support swap limit capabilities. Limitation discarded.\n") - container.Config.MemorySwap = -1 - } - - if container.runtime.sysInfo.IPv4ForwardingDisabled { - log.Printf("WARNING: IPv4 forwarding is disabled. Networking will not work") - } - + container.verifyRuntimeSettings() if err := prepareVolumesForContainer(container); err != nil { return err } - - // Setup environment - env := []string{ - "HOME=/", - "PATH=" + DefaultPathEnv, - "HOSTNAME=" + container.Config.Hostname, - } - - if container.Config.Tty { - env = append(env, "TERM=xterm") - } - - // Init any links between the parent and children - runtime := container.runtime - - children, err := runtime.Children(container.Name) + linkedEnv, err := container.setupLinkedContainers() if err != nil { return err } - - if len(children) > 0 { - container.activeLinks = make(map[string]*links.Link, len(children)) - - // If we encounter an error make sure that we rollback any network - // config and ip table changes - rollback := func() { - for _, link := range container.activeLinks { - link.Disable() - } - container.activeLinks = nil - } - - for linkAlias, child := range children { - if !child.State.IsRunning() { - return fmt.Errorf("Cannot link to a non running container: %s AS %s", child.Name, linkAlias) - } - - link, err := links.NewLink( - container.NetworkSettings.IPAddress, - child.NetworkSettings.IPAddress, - linkAlias, - child.Config.Env, - child.Config.ExposedPorts, - runtime.eng) - - if err != nil { - rollback() - return err - } - - container.activeLinks[link.Alias()] = link - if err := link.Enable(); err != nil { - rollback() - return err - } - - for _, envVar := range link.ToEnv() { - env = append(env, envVar) - } - } - } - - // because the env on the container can override certain default values - // we need to replace the 'env' keys where they match and append anything - // else. - env = utils.ReplaceOrAppendEnvValues(env, container.Config.Env) + env := container.createRuntimeEnvironment(linkedEnv) + // TODO: This is only needed for lxc so we should look for a way to + // remove this dep if err := container.generateEnvConfig(env); err != nil { return err } - - if container.Config.WorkingDir != "" { - container.Config.WorkingDir = path.Clean(container.Config.WorkingDir) - - pthInfo, err := os.Stat(path.Join(container.basefs, container.Config.WorkingDir)) - if err != nil { - if !os.IsNotExist(err) { - return err - } - if err := os.MkdirAll(path.Join(container.basefs, container.Config.WorkingDir), 0755); err != nil { - return err - } - } - if pthInfo != nil && !pthInfo.IsDir() { - return fmt.Errorf("Cannot mkdir: %s is not a directory", container.Config.WorkingDir) - } - } - - envPath, err := container.EnvConfigPath() - if err != nil { + if err := container.setupWorkingDirectory(); err != nil { return err } - - populateCommand(container) - container.command.Env = env - - if err := setupMountsForContainer(container, envPath); err != nil { + populateCommand(container, env) + if err := setupMountsForContainer(container); err != nil { return err } - - // Setup logging of stdout and stderr to disk - if err := container.runtime.LogToDisk(container.stdout, container.logPath("json"), "stdout"); err != nil { - return err - } - if err := container.runtime.LogToDisk(container.stderr, container.logPath("json"), "stderr"); err != nil { + if err := container.startLoggingToDisk(); err != nil { return err } container.waitLock = make(chan struct{}) - callbackLock := make(chan struct{}) - callback := func(command *execdriver.Command) { - container.State.SetRunning(command.Pid()) - if command.Tty { - // The callback is called after the process Start() - // so we are in the parent process. In TTY mode, stdin/out/err is the PtySlace - // which we close here. - if c, ok := command.Stdout.(io.Closer); ok { - c.Close() - } - } - if err := container.ToDisk(); err != nil { - utils.Debugf("%s", err) - } - close(callbackLock) - } - - // We use a callback here instead of a goroutine and an chan for - // syncronization purposes - cErr := utils.Go(func() error { return container.monitor(callback) }) - - // Start should not return until the process is actually running - select { - case <-callbackLock: - case err := <-cErr: - return err - } - return nil + return container.waitForStart() } func (container *Container) Run() error { @@ -1146,6 +1011,9 @@ func (container *Container) DisableLink(name string) { } func (container *Container) setupContainerDns() error { + if container.ResolvConfPath == "" { + return nil + } var ( config = container.hostConfig runtime = container.runtime @@ -1191,3 +1059,166 @@ func (container *Container) setupContainerDns() error { } return nil } + +func (container *Container) initializeNetworking() error { + if container.runtime.config.DisableNetwork { + container.Config.NetworkDisabled = true + container.buildHostnameAndHostsFiles("127.0.1.1") + } else { + if err := container.allocateNetwork(); err != nil { + return err + } + container.buildHostnameAndHostsFiles(container.NetworkSettings.IPAddress) + } + return nil +} + +// Make sure the config is compatible with the current kernel +func (container *Container) verifyRuntimeSettings() { + if container.Config.Memory > 0 && !container.runtime.sysInfo.MemoryLimit { + log.Printf("WARNING: Your kernel does not support memory limit capabilities. Limitation discarded.\n") + container.Config.Memory = 0 + } + if container.Config.Memory > 0 && !container.runtime.sysInfo.SwapLimit { + log.Printf("WARNING: Your kernel does not support swap limit capabilities. Limitation discarded.\n") + container.Config.MemorySwap = -1 + } + if container.runtime.sysInfo.IPv4ForwardingDisabled { + log.Printf("WARNING: IPv4 forwarding is disabled. Networking will not work") + } +} + +func (container *Container) setupLinkedContainers() ([]string, error) { + var ( + env []string + runtime = container.runtime + ) + children, err := runtime.Children(container.Name) + if err != nil { + return nil, err + } + + if len(children) > 0 { + container.activeLinks = make(map[string]*links.Link, len(children)) + + // If we encounter an error make sure that we rollback any network + // config and ip table changes + rollback := func() { + for _, link := range container.activeLinks { + link.Disable() + } + container.activeLinks = nil + } + + for linkAlias, child := range children { + if !child.State.IsRunning() { + return nil, fmt.Errorf("Cannot link to a non running container: %s AS %s", child.Name, linkAlias) + } + + link, err := links.NewLink( + container.NetworkSettings.IPAddress, + child.NetworkSettings.IPAddress, + linkAlias, + child.Config.Env, + child.Config.ExposedPorts, + runtime.eng) + + if err != nil { + rollback() + return nil, err + } + + container.activeLinks[link.Alias()] = link + if err := link.Enable(); err != nil { + rollback() + return nil, err + } + + for _, envVar := range link.ToEnv() { + env = append(env, envVar) + } + } + } + return env, nil +} + +func (container *Container) createRuntimeEnvironment(linkedEnv []string) []string { + // Setup environment + env := []string{ + "HOME=/", + "PATH=" + DefaultPathEnv, + "HOSTNAME=" + container.Config.Hostname, + } + if container.Config.Tty { + env = append(env, "TERM=xterm") + } + env = append(env, linkedEnv...) + // because the env on the container can override certain default values + // we need to replace the 'env' keys where they match and append anything + // else. + env = utils.ReplaceOrAppendEnvValues(env, container.Config.Env) + + return env +} + +func (container *Container) setupWorkingDirectory() error { + if container.Config.WorkingDir != "" { + container.Config.WorkingDir = path.Clean(container.Config.WorkingDir) + + pthInfo, err := os.Stat(path.Join(container.basefs, container.Config.WorkingDir)) + if err != nil { + if !os.IsNotExist(err) { + return err + } + if err := os.MkdirAll(path.Join(container.basefs, container.Config.WorkingDir), 0755); err != nil { + return err + } + } + if pthInfo != nil && !pthInfo.IsDir() { + return fmt.Errorf("Cannot mkdir: %s is not a directory", container.Config.WorkingDir) + } + } + return nil +} + +func (container *Container) startLoggingToDisk() error { + // Setup logging of stdout and stderr to disk + if err := container.runtime.LogToDisk(container.stdout, container.logPath("json"), "stdout"); err != nil { + return err + } + if err := container.runtime.LogToDisk(container.stderr, container.logPath("json"), "stderr"); err != nil { + return err + } + return nil +} + +func (container *Container) waitForStart() error { + callbackLock := make(chan struct{}) + callback := func(command *execdriver.Command) { + container.State.SetRunning(command.Pid()) + if command.Tty { + // The callback is called after the process Start() + // so we are in the parent process. In TTY mode, stdin/out/err is the PtySlace + // which we close here. + if c, ok := command.Stdout.(io.Closer); ok { + c.Close() + } + } + if err := container.ToDisk(); err != nil { + utils.Debugf("%s", err) + } + close(callbackLock) + } + + // We use a callback here instead of a goroutine and an chan for + // syncronization purposes + cErr := utils.Go(func() error { return container.monitor(callback) }) + + // Start should not return until the process is actually running + select { + case <-callbackLock: + case err := <-cErr: + return err + } + return nil +} diff --git a/runtime/volumes.go b/runtime/volumes.go index 004f1bb024..38326ad687 100644 --- a/runtime/volumes.go +++ b/runtime/volumes.go @@ -33,7 +33,12 @@ func prepareVolumesForContainer(container *Container) error { return nil } -func setupMountsForContainer(container *Container, envPath string) error { +func setupMountsForContainer(container *Container) error { + envPath, err := container.EnvConfigPath() + if err != nil { + return err + } + mounts := []execdriver.Mount{ {container.runtime.sysInitPath, "/.dockerinit", false, true}, {envPath, "/.dockerenv", false, true}, From 71b241cbfe5b0100ee2ee0fd0e651beccd965746 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 06:54:40 +0000 Subject: [PATCH 050/436] Remove container.When method Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- runtime/container.go | 4 ---- runtime/history.go | 2 +- 2 files changed, 1 insertion(+), 5 deletions(-) diff --git a/runtime/container.go b/runtime/container.go index a9b81819d6..a2b75d2394 100644 --- a/runtime/container.go +++ b/runtime/container.go @@ -112,10 +112,6 @@ func (container *Container) Inject(file io.Reader, pth string) error { return nil } -func (container *Container) When() time.Time { - return container.Created -} - func (container *Container) FromDisk() error { data, err := ioutil.ReadFile(container.jsonPath()) if err != nil { diff --git a/runtime/history.go b/runtime/history.go index 835ac9c11e..bce3d7005a 100644 --- a/runtime/history.go +++ b/runtime/history.go @@ -14,7 +14,7 @@ func (history *History) Len() int { func (history *History) Less(i, j int) bool { containers := *history - return containers[j].When().Before(containers[i].When()) + return containers[j].Created.Before(containers[i].Created) } func (history *History) Swap(i, j int) { From 35a88f2c291c882e49f7c448c1581dfdd3e35a9c Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 06:58:04 +0000 Subject: [PATCH 051/436] Fix resolvconf logic Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- runtime/container.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/runtime/container.go b/runtime/container.go index a2b75d2394..6918f1c184 100644 --- a/runtime/container.go +++ b/runtime/container.go @@ -1007,7 +1007,7 @@ func (container *Container) DisableLink(name string) { } func (container *Container) setupContainerDns() error { - if container.ResolvConfPath == "" { + if container.ResolvConfPath != "" { return nil } var ( From 9bd7d09871d8495d06af94a8d866404569d75b8e Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 07:08:54 +0000 Subject: [PATCH 052/436] Remove ArgsAsString because its a util function Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- runtime/container.go | 12 ------------ server/server.go | 12 +++++++++++- 2 files changed, 11 insertions(+), 13 deletions(-) diff --git a/runtime/container.go b/runtime/container.go index 6918f1c184..ac22800803 100644 --- a/runtime/container.go +++ b/runtime/container.go @@ -365,18 +365,6 @@ func populateCommand(c *Container, env []string) { c.command.Env = env } -func (container *Container) ArgsAsString() string { - var args []string - for _, arg := range container.Args { - if strings.Contains(arg, " ") { - args = append(args, fmt.Sprintf("'%s'", arg)) - } else { - args = append(args, arg) - } - } - return strings.Join(args, " ") -} - func (container *Container) Start() (err error) { container.Lock() defer container.Unlock() diff --git a/server/server.go b/server/server.go index 2de7dbc872..613df9a32f 100644 --- a/server/server.go +++ b/server/server.go @@ -1063,7 +1063,17 @@ func (srv *Server) Containers(job *engine.Job) engine.Status { out.SetList("Names", names[container.ID]) out.Set("Image", srv.runtime.Repositories().ImageName(container.Image)) if len(container.Args) > 0 { - out.Set("Command", fmt.Sprintf("\"%s %s\"", container.Path, container.ArgsAsString())) + args := []string{} + for _, arg := range container.Args { + if strings.Contains(arg, " ") { + args = append(args, fmt.Sprintf("'%s'", arg)) + } else { + args = append(args, arg) + } + } + argsAsString := strings.Join(args, " ") + + out.Set("Command", fmt.Sprintf("\"%s %s\"", container.Path, argsAsString)) } else { out.Set("Command", fmt.Sprintf("\"%s\"", container.Path)) } From 39103e72a3ca4ff739a4986c4e4849339e08aaf3 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 14 Apr 2014 12:43:01 +0000 Subject: [PATCH 053/436] Fix unmount when host volume is removed Fixes #5244 Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- integration-cli/docker_cli_rm_test.go | 27 +++++++++++++++++++++++++++ server/server.go | 11 +++++++---- 2 files changed, 34 insertions(+), 4 deletions(-) create mode 100644 integration-cli/docker_cli_rm_test.go diff --git a/integration-cli/docker_cli_rm_test.go b/integration-cli/docker_cli_rm_test.go new file mode 100644 index 0000000000..5b35e8fa47 --- /dev/null +++ b/integration-cli/docker_cli_rm_test.go @@ -0,0 +1,27 @@ +package main + +import ( + "os" + "os/exec" + "testing" +) + +func TestRemoveContainerWithRemovedVolume(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "--name", "losemyvolumes", "-v", "/tmp/testing:/test", "busybox", "true") + if _, err := runCommand(cmd); err != nil { + t.Fatal(err) + } + + if err := os.Remove("/tmp/testing"); err != nil { + t.Fatal(err) + } + + cmd = exec.Command(dockerBinary, "rm", "-v", "losemyvolumes") + if _, err := runCommand(cmd); err != nil { + t.Fatal(err) + } + + deleteAllContainers() + + logDone("rm - removed volume") +} diff --git a/server/server.go b/server/server.go index 2de7dbc872..182505a680 100644 --- a/server/server.go +++ b/server/server.go @@ -1867,13 +1867,16 @@ func (srv *Server) ContainerDestroy(job *engine.Job) engine.Status { for _, bind := range container.HostConfig().Binds { source := strings.Split(bind, ":")[0] // TODO: refactor all volume stuff, all of it - // this is very important that we eval the link - // or comparing the keys to container.Volumes will not work + // it is very important that we eval the link or comparing the keys to container.Volumes will not work + // + // eval symlink can fail, ref #5244 if we receive an is not exist error we can ignore it p, err := filepath.EvalSymlinks(source) - if err != nil { + if err != nil && !os.IsNotExist(err) { return job.Error(err) } - source = p + if p != "" { + source = p + } binds[source] = struct{}{} } From e9c3e397436221528312c0d3b291ae5a12862ed2 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 11 Apr 2014 23:59:12 +0000 Subject: [PATCH 054/436] rename configFile to auth in the job Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/server/server.go | 4 +--- server/buildfile.go | 2 +- server/server.go | 4 ++-- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/api/server/server.go b/api/server/server.go index a734490c01..279d297965 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -838,7 +838,6 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite // Both headers will be parsed and sent along to the daemon, but if a non-empty // ConfigFile is present, any value provided as an AuthConfig directly will // be overridden. See BuildFile::CmdFrom for details. - // /* var ( authEncoded = r.Header.Get("X-Registry-Auth") authConfig = ®istry.AuthConfig{} @@ -853,7 +852,6 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite configFile.Configs[authConfig.ServerAddress] = *authConfig } } - // */ if configFileEncoded != "" { configFileJson := base64.NewDecoder(base64.URLEncoding, strings.NewReader(configFileEncoded)) @@ -876,7 +874,7 @@ func postBuild(eng *engine.Engine, version version.Version, w http.ResponseWrite job.Setenv("q", r.FormValue("q")) job.Setenv("nocache", r.FormValue("nocache")) job.Setenv("rm", r.FormValue("rm")) - job.SetenvJson("configFile", configFile) + job.SetenvJson("auth", configFile) if err := job.Run(); err != nil { if !job.Stdout.Used() { diff --git a/server/buildfile.go b/server/buildfile.go index 7cd1e9971b..6340999cda 100644 --- a/server/buildfile.go +++ b/server/buildfile.go @@ -82,7 +82,7 @@ func (b *buildFile) CmdFrom(name string) error { job := b.srv.Eng.Job("pull", remote, tag) job.SetenvBool("json", b.sf.Json()) job.SetenvBool("parallel", true) - job.SetenvJson("configFile", b.configFile) + job.SetenvJson("auth", b.configFile) job.Stdout.Add(b.outOld) if err := job.Run(); err != nil { return err diff --git a/server/server.go b/server/server.go index 6d7295efbd..2de7dbc872 100644 --- a/server/server.go +++ b/server/server.go @@ -452,7 +452,7 @@ func (srv *Server) Build(job *engine.Job) engine.Status { tag string context io.ReadCloser ) - job.GetenvJson("configFile", configFile) + job.GetenvJson("auth", configFile) repoName, tag = utils.ParseRepositoryTag(repoName) if remoteURL == "" { @@ -1392,7 +1392,7 @@ func (srv *Server) ImagePull(job *engine.Job) engine.Status { tag = job.Args[1] } - job.GetenvJson("configFile", configFile) + job.GetenvJson("auth", configFile) job.GetenvJson("metaHeaders", metaHeaders) endpoint, _, err := registry.ResolveRepositoryName(localName) From 7bb72fa080d13c3b90d624cb77530632c7705c56 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Mon, 14 Apr 2014 13:35:54 -0600 Subject: [PATCH 055/436] Fetch the "busybox" image source so we can build locally instead of pulling during the integration tests Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- Dockerfile | 3 +++ hack/make/test-integration-cli | 6 +++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index ec95bad293..ab82dfa700 100644 --- a/Dockerfile +++ b/Dockerfile @@ -82,6 +82,9 @@ RUN go get code.google.com/p/go.tools/cmd/cover # TODO replace FPM with some very minimal debhelper stuff RUN gem install --no-rdoc --no-ri fpm --version 1.0.2 +# Get the "busybox" image source so we can build locally instead of pulling +RUN git clone https://github.com/jpetazzo/docker-busybox.git /docker-busybox + # Setup s3cmd config RUN /bin/echo -e '[default]\naccess_key=$AWS_ACCESS_KEY\nsecret_key=$AWS_SECRET_KEY' > /.s3cfg diff --git a/hack/make/test-integration-cli b/hack/make/test-integration-cli index 93330d7b09..703c9cd95c 100644 --- a/hack/make/test-integration-cli +++ b/hack/make/test-integration-cli @@ -31,7 +31,11 @@ bundle_test_integration_cli() { sleep 2 if ! docker inspect busybox &> /dev/null; then - ( set -x; docker pull busybox ) + if [ -d /docker-busybox ]; then + ( set -x; docker build -t busybox /docker-busybox ) + else + ( set -x; docker pull busybox ) + fi fi bundle_test_integration_cli From d61fce9af770f0adaf4f178a5217dd46a02dd201 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Mon, 14 Apr 2014 23:15:38 +0000 Subject: [PATCH 056/436] allow dot in repo name Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- registry/registry.go | 9 ++------- registry/registry_test.go | 7 +++++++ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/registry/registry.go b/registry/registry.go index 817c08afa9..451f30f670 100644 --- a/registry/registry.go +++ b/registry/registry.go @@ -101,17 +101,12 @@ func ResolveRepositoryName(reposName string) (string, string, error) { return "", "", ErrInvalidRepositoryName } nameParts := strings.SplitN(reposName, "/", 2) - if !strings.Contains(nameParts[0], ".") && !strings.Contains(nameParts[0], ":") && - nameParts[0] != "localhost" { + if len(nameParts) == 1 || (!strings.Contains(nameParts[0], ".") && !strings.Contains(nameParts[0], ":") && + nameParts[0] != "localhost") { // This is a Docker Index repos (ex: samalba/hipache or ubuntu) err := validateRepositoryName(reposName) return IndexServerAddress(), reposName, err } - if len(nameParts) < 2 { - // There is a dot in repos name (and no registry address) - // Is it a Registry address without repos name? - return "", "", ErrInvalidRepositoryName - } hostname := nameParts[0] reposName = nameParts[1] if strings.Contains(hostname, "index.docker.io") { diff --git a/registry/registry_test.go b/registry/registry_test.go index c072da41c5..cb56502fc1 100644 --- a/registry/registry_test.go +++ b/registry/registry_test.go @@ -146,6 +146,13 @@ func TestResolveRepositoryName(t *testing.T) { } assertEqual(t, ep, u, "Expected endpoint to be "+u) assertEqual(t, repo, "private/moonbase", "Expected endpoint to be private/moonbase") + + ep, repo, err = ResolveRepositoryName("ubuntu-12.04-base") + if err != nil { + t.Fatal(err) + } + assertEqual(t, ep, IndexServerAddress(), "Expected endpoint to be "+IndexServerAddress()) + assertEqual(t, repo, "ubuntu-12.04-base", "Expected endpoint to be ubuntu-12.04-base") } func TestPushRegistryTag(t *testing.T) { From 6a2bdc6eb769ffd1d8438f321953dde8b341b783 Mon Sep 17 00:00:00 2001 From: Eivind Uggedal Date: Sun, 13 Apr 2014 14:52:21 +0000 Subject: [PATCH 057/436] contrib: mkimage script for alpine linux Docker-DCO-1.1-Signed-off-by: Eivind Uggedal (github: uggedal) --- contrib/mkimage-alpine.sh | 82 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100755 contrib/mkimage-alpine.sh diff --git a/contrib/mkimage-alpine.sh b/contrib/mkimage-alpine.sh new file mode 100755 index 0000000000..7444ffafb9 --- /dev/null +++ b/contrib/mkimage-alpine.sh @@ -0,0 +1,82 @@ +#!/bin/sh + +set -e + +[ $(id -u) -eq 0 ] || { + printf >&2 '%s requires root\n' "$0" + exit 1 +} + +usage() { + printf >&2 '%s: [-r release] [-m mirror] [-s]\n' "$0" + exit 1 +} + +tmp() { + TMP=$(mktemp -d /tmp/alpine-docker-XXXXXXXXXX) + ROOTFS=$(mktemp -d /tmp/alpine-docker-rootfs-XXXXXXXXXX) + trap "rm -rf $TMP $ROOTFS" EXIT TERM INT +} + +apkv() { + curl -s $REPO/$ARCH/APKINDEX.tar.gz | tar -Oxz | + grep '^P:apk-tools-static$' -A1 | tail -n1 | cut -d: -f2 +} + +getapk() { + curl -s $REPO/$ARCH/apk-tools-static-$(apkv).apk | + tar -xz -C $TMP sbin/apk.static +} + +mkbase() { + $TMP/sbin/apk.static --repository $REPO --update-cache --allow-untrusted \ + --root $ROOTFS --initdb add alpine-base +} + +conf() { + printf '%s\n' $REPO > $ROOTFS/etc/apk/repositories +} + +pack() { + local id + id=$(tar --numeric-owner -C $ROOTFS -c . | docker import - alpine:$REL) + + docker tag $id alpine:latest + docker run -i -t alpine printf 'alpine:%s with id=%s created!\n' $REL $id +} + +save() { + [ $SAVE -eq 1 ] || return + + tar --numeric-owner -C $ROOTFS -c . | xz > rootfs.tar.xz +} + +while getopts "hr:m:s" opt; do + case $opt in + r) + REL=$OPTARG + ;; + m) + MIRROR=$OPTARG + ;; + s) + SAVE=1 + ;; + *) + usage + ;; + esac +done + +REL=${REL:-edge} +MIRROR=${MIRROR:-http://nl.alpinelinux.org/alpine} +SAVE=${SAVE:-0} +REPO=$MIRROR/$REL/main +ARCH=$(uname -m) + +tmp +getapk +mkbase +conf +pack +save From 32d8b5da5080cf4ef9f27636d1ee52c8b79eb890 Mon Sep 17 00:00:00 2001 From: "O.S.Tezer" Date: Tue, 15 Apr 2014 04:10:25 +0300 Subject: [PATCH 058/436] Adding myself to the MAINTAINERS file. Docker-DCO-1.1-Signed-off-by: O.S. Tezer (github: ostezer) --- docs/MAINTAINERS | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/MAINTAINERS b/docs/MAINTAINERS index 52505fab00..afbbde4099 100644 --- a/docs/MAINTAINERS +++ b/docs/MAINTAINERS @@ -1,2 +1,3 @@ James Turnbull (@jamtur01) Sven Dowideit (@SvenDowideit) +O.S. Tezer (@OSTezer) From dceea17805258520b1218eb1a2bb394c8b9c0a03 Mon Sep 17 00:00:00 2001 From: Dan McPherson Date: Tue, 15 Apr 2014 17:35:36 -0400 Subject: [PATCH 059/436] Fixing typos Docker-DCO-1.1-Signed-off-by: Dan McPherson (github: danmcp) --- runtime/networkdriver/bridge/driver.go | 2 +- server/server.go | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/runtime/networkdriver/bridge/driver.go b/runtime/networkdriver/bridge/driver.go index b8568c7c40..ee8d76d447 100644 --- a/runtime/networkdriver/bridge/driver.go +++ b/runtime/networkdriver/bridge/driver.go @@ -32,7 +32,7 @@ var ( // This is to use the same gateway IPs as the /24 ranges, which predate the /16 ranges. // In theory this shouldn't matter - in practice there's bound to be a few scripts relying // on the internal addressing or other stupid things like that. - // The shouldn't, but hey, let's not break them unless we really have to. + // They shouldn't, but hey, let's not break them unless we really have to. "172.17.42.1/16", // Don't use 172.16.0.0/16, it conflicts with EC2 DNS 172.16.0.23 "10.0.42.1/16", // Don't even try using the entire /8, that's too intrusive "10.1.42.1/16", diff --git a/server/server.go b/server/server.go index 2de7dbc872..241a094a37 100644 --- a/server/server.go +++ b/server/server.go @@ -1277,7 +1277,7 @@ func (srv *Server) pullRepository(r *registry.Registry, out io.Writer, localName for _, ep := range repoData.Endpoints { out.Write(sf.FormatProgress(utils.TruncateID(img.ID), fmt.Sprintf("Pulling image (%s) from %s, endpoint: %s", img.Tag, localName, ep), nil)) if err := srv.pullImage(r, out, img.ID, ep, repoData.Tokens, sf); err != nil { - // Its not ideal that only the last error is returned, it would be better to concatenate the errors. + // It's not ideal that only the last error is returned, it would be better to concatenate the errors. // As the error is also given to the output stream the user will see the error. lastErr = err out.Write(sf.FormatProgress(utils.TruncateID(img.ID), fmt.Sprintf("Error pulling image (%s) from %s, endpoint: %s, %s", img.Tag, localName, ep, err), nil)) From 936a03bfddb24cd45f5f12c20a961bf2ae6ede93 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Tue, 15 Apr 2014 06:01:25 +0000 Subject: [PATCH 060/436] 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 @@ + + + +-
+- +- +-
+- +- +-
+- +- +- + +
+ +@@ -114,111 +72,7 @@ + {% block body %}{% endblock %} + + +- +
+-
+-
+- +- +-
+- +- +- +- +- +- +- +- +- +- +- +- +- + + + 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 @@ -
- - -
- - -
- - -
@@ -114,111 +72,7 @@ {% block body %}{% endblock %} -
-
-
- - -
- - - - - - - - - - - - - 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 @@ + \ 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 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 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 zcmd4434B!5y$62Jx!dgfl1wJaOp=*N2qchXlCUL1*hxS(1pzUj2!bdoh~hR1qKGRh zwYF;1y3o}w_SLrdruJ!H7kRd|tG>S2R@?Wq7TP{rA#?eEf9K95lK|TG|33fEKg+%6 z+hTSaAdmL)uWh^R%I%Bq{=#vIHGE2vyyxxQ zu>PXwf4+35#HOMTl7@fkt@MNGkN*dqzrXxudarck;ms?=9TzfXbVcIGGxh+E^d!f> ztp1kWBdO@h9ZDcN>E)O$)*L%OUQ<(5(?2L3bseob+I4i% z(X~e}J$l2@yN*6`^z%o*bo9v4Umbn#sBz47tm;_Pv94o_j;%d*>9HG*-F57d|CLTs zlc>gL3N=cjYLt$8j>eB>jxIjhe{|c??9qFU4jg^^^s&K$J;*W3T~FTeWV|2+Pm&&ML33QxpS<_UX3 zo}ee-@q2t8ugBw&J>0`QlKZ6FaOd4a?i23g?ho95bN|)-zJuoA|NMsm7K+s}nqB%Y z{lQI|ivK_S=vvsKmRk#edAb%6i2hSQfN{*f8@=C#{(3MdvZPB=N8B5iy>ag#%Ndz% zd|;azJHAbmj*E8`hfQQA(J-EOQqrDKvr;880iAi{Eunx`8?Q;WwYSE-ESYZWVy*F( zDyBWrn7@r>BFSWAC`(6{$=}vkS07fh;rcptPAzWdrDR(Yf3n1{ZmbPgSS%G{s_+g8 z?`TBE8*uTOCf?S?TU)|jb#%6^y@R#4wuCfk)~1cCHg1}Q(}asx@ZVV6;lsib{$)h;3&X! zv#^nE>r1k8t{W+F*LfUs0DkxY35 zA&hmqcN%Y!F$Y>O5DtZ_l&QR>OYUgz=wcmSb8^yNnjQ>PHkL5{@qN#TZq2kl zV*Di$^E=g?)6Z1RVL6_0`tSSJtJ;*Bj-~)(fu@d{DcY;wYCkW#w&!@JXYJY^HP^E? zCQEfyNA@&MoHS`-XZ2cas^9s{_6MI-Cq)uIUm`L|ee%J^d;3q| zxwSnC)nU#t^(_m0Cn*@xCMAs)wp8(Omy8LeF_j-`^X2cc)%HzmHU_(Hx@>V>-Qvq` z>KZiO%HNyy@l}?(^Dn$><{N)&oS&(y%gk^5+Z+G+R{j~Y?$2TF2BjKgP>~{l@+5#xb#STNuZ8r?=WCN#*;G43z#WbeP}pXPs)z27Nc6N(s* z7!KVTtaQBluA?%jx!7OW`ifw}I-h-~p~09u-%4wQ;KqEnm7v$k5_U|!oKTDHICC?U z%UO%D>hNJ>6>FK#cCl;NcSO4y&fF{>U=3aD2IJ-~<7dX|?|etL6`R@eA+4k~0kR8WvKfSYMJobh>0d z!tvr{#Gs=xQsl%)QZ6lGj9fo`gtklOnC+PFB5q~+|H?r@3FXkQznBmY53W~ekX>W(B9tH3|SwvWJ~1XLheJ)N0I z(>o?V_Wu8Me(d|W)LC!j>N`8@S%!`yX`U_3UsHzz6Au-Z2`g~&4=#RcvTJE15t5HKCG3gq~ zrQNE0NeW>%!QQ27HO-7A+qxMxD=QAwOuIFjAAehPar8FhU^GezmgM(PUjEZ!aVvTo z+f4ar)c6Iz7iCcIr6=E0eaZm|+(=!(&9s`76^CY2-C-SFe<+|^nd%cY8^1JuY1YJ& zNEP13l7-rTiL2s0XS!=XLA99lj7d|~VsD&Yr5kF;8J`tNS3NtP z3km=mX{w2Vehi0vgtJWyPIUIJBgSuye>Z-6WY=Q{8ZWMnxyP;FvgG!|uO7aA$(Hrw z+_CD-;|@HQ&-QKV!ynInl1lD6!lIx2D(l%Ab2W~;IJV%Y*K9&@JhkbXpDu`9Jg(6d z+iJYP7vu#V=X4}m3WTqqe@p2FDIs8{2q`V01X>50LF_ODG-LDB`qKNS2O{^EnaD-4lj8PxQryhw9Ovnz(^f)Ef8uU z2*Uc*F(U!YNG;Z=rsJ1-f#sUgX(1$2M8Sf-$E7Al%LWLdqj6bc7WX_~h3j9O9*_O&uJZbsHf!YGkkdK3@Lg87({WRsC>(L4Fb~li4zjJka)fxa zJ<+n#5wRuivR)E)-_{cKI=|)#Zn4_0Xty~X_TcLBmPr*n=oDp}nkFxCIBd?kyKP%a z3)^)xWl9 z2=r7xK?qCFaWA6%eUW<(OS^n>tOSf)XGrI(tU^jX@g7V5_k36_LmfzD;9cZ2Bt60U(mW+|v56fMdYE1^I$# zYn;WCDXavVH)nd^#bB7oM%}kFw5ay^Kq2z{plQ z*kp&z*ff+Sx=PK|ch*OZe~qcIBxv>_<;k*S^aT##S!CCW3BP%kt1v!dz`J42aRDEB3Q^9 zD21}(34VTQ(IZF1Jhn)Zz6j{i3uu>ET5e**HtBLu3lZPM0<{ndq;MH6#$^pcf*PO; zMvz-W$VC(*%z=WTFr*hN%2>epb!UK;F`wfv4j+HNDW7rrSOAxeqqrVmK4(7D6k(59 z>H=&TuDEgKDHL&|2wN7Yv#`e^JgPA4Vt%KQQyd--xMIJPNp#^Pj`Q2Qlz>0#cjjo8 zb50~ryxS#YuAmFBly%H=0lx0*)XAQmQFc zVkB8gwmsEZe;gBw3IE}(Q$9K6HufsO;~U;;BjaoL8JTLYcN~)dnc$I_H0~)Ok20lF zEH*-E-`3fATPOE6R2mt-pXDkWQY&S}~TyokXyw@6buLX;*ub6eMzw9v-7(QKA+|L8-TdVjzepa!yjpUdH3-BzoS z^RN#-q^Xcm5ON2MJ89*!I0RmDT*l@V565YbFRc3xzln{*{*Zi$V6!2au+0Bx*H7*XCt+j>rd*JFSa16?@c(S!c!QKzj4ghXs#(BNfx8MKW zBJs8JwfVZoW#4CImaWG3K089H-N*b}ZU%&_l97od>r+*??<+P0u+n#%g zsAHWhdSusS8*aiP8m2FSuj{0_Xk|d>QoN=P1j~p30GtQ5SzQ}+72XTOe%Vit(OY{CQQmf*S4a-!rCL=&B z(CJbN?hlE3G6w2QX%r&SuPF&0CF^DV!xjJeG^zaQE{7S&Sbe7~`Fyx7${c(L58e zQHg&n=5!keg~5Y?YTC|+Ni!3LPbVIMqgMshgqEEacs{gm38lO<&kG^fB@*scroW@{W9O-ROG z?Ki$`92a<4V+*lVm4Oqq!r4Ns(=2x7h2|P0c!?=lQP+gi*9Iv8O(X`OOKxkDF*?Ne zobDYgd-fcgJCZD`sVSrXWW;TobD9?$z6W_|Am$cJq`G6!Mus~mfQn}2SD_BIBt{9=O676JNwgjI2{$qRA*qp zvSkYbovCER>AZt|+W4^(V4Bja^`^ROZ@>N8x+WyW%^&~$qtIa-G4fN@WF!@+bhkh8 zwI|x$m4OtXf9h9_Hsi+CxKkHaoJx6QHS@3*=2;ynM>brCBC90_4WiIPkRH+w+RqOe zN(FF1EwlrzVyy;i(|-KN@y|g0(=VMF60C3?yj!}~TkDMnThnx%epwbjau%!?u^sde zS&;zAY~an5J+Sao@ENtSReJH*(HOgzJIJ)h-SLtH00GoIooB1?3c{;3Nd zItcmYsr^Vn(q;B#D)b#vYpu7{|Nr8@8$Yqw+Un|u@z>RLLv?kx_zn@U-bhFpUq!UIUk>Ec_WYcV*tuLL-w-b>i$yiSh=vxZ!f`sbB z-=>;v02>IL2n8amC4Bu+tzcQvxVok)_R|ElFqg}#JPB|&a9k?c0rhlyvZITWpoS78Q5&7WEiJ5reQ7B^2Lk}GYoL%= zdn%+7>()ZDog}I(uyQ4NZDW1N_=Eq-8ABTu-W@FqX$*TJcLcTYc#EuZIVuOoDNI+C zI>q0tFbn6dkY@2Z{egH2Qe!9oV8P;$@m}5B^M*cAVYl1Lu9iPh*=}Lub)G!&2gTvy z{mybFh(vw>iA|?mQEDd78@ej9V#}hL)08Hcr9!g@Ds0IuNn5?eUZd4*tFbnz&RR9H zBWbC%S^^P^BN0!PhnOZ?w=EdDYUgaXr(#ZZM1DO~>#m~xQcw#9Q43}gLkhU~n2-ZN zSIk-+8nHbWxKEwL8t%nvp~o20mvgBjMit)x|{(&v217kK;Gm%Ge*DDkEd}3 zEcC!xm-842CmxLU*PoOw7i%S}X9dq3hdfu3$P5EU7$6d8bf|e|%Z9~Ok|{^`$n)Pj zbm+Z9@*t5+$Fp=CZ1rzQb1A*S-a;nkyjT2|&-h^`Q0)lX6-|y- zd2IoUi~3Kv3m6l4zz+$=258kmIHE^D78r%v8a=4{12SEsE6Br81A-H=yVLljW!mAz zZ!?>~I$A&okdQ`<6<~_!8j=WO#3+Sdi03dcjeVKjpH3tjrYu|h^nwZ|^TwVpeCh1v zpJ`hJI}?`wEuRox*yL5LTveEj*?p~5%N0oAuA89xRMrq!uySK#dh&$v<1*cm>%O>Z zO=Ym9XTkiNmu`P)`A_5S*wT4(F1w;K@(28nZKh;Nq5U>8jB7UBSrvR=yRd(vYP`*;+HPhnDTHj9A0I9 zUwx&cqSImVx$JtSCuC{Z7`6G?^i)mH{qZ@BE4tRvo=G?yR%Lu>da}{Mn7+e%c4ZViB0LPC|dWSDQ?y(zK%Ro0605Cgn)Hvx}3u07gM+AOX_w zkpve4C?F}UF31K#B34<&_qDw-vEY2y_hr!QjHD)jLV?bWz1 za6@1U{(bSqi%T==jTI_t<;-KTFcx_@ec_at-z_(uUAC~DyA{sWb*Tr9uNWV{uPIfo z+dPWJHbKSg*(@$4q(rQ7Ptp;r%^hQ(?YewTNKu(qVYg1aDDIC`cv-_aCwLp zzmL_AXI7`3hCXU58T#XYKJA3l> zv2a47oQfj}bB~LhhNHNbrF#mFIgz3RyXYg5{~xv6G>w$e7}0LgC>2Lx6(n*T$N%eg zkF|yPsQl>hE*4my+5|EWAjXcl7&dJ%nBi$iu?x{ z2ftGj%|0QHinvmm9w{RalF0@=9;Ji-BYRfTUkOT$Q~OxZF_@NeWa$HlDaDXu`|weD z)=wQ25=a-Cs2=)9yU343sRq+51u4TSMuiR~ojH9{&~~Dal923rLE_K^7Wz~a8B{Ww z&TvSVQjk&kjID=u<}*7F9oorrI}fq@d=(C7iiA<)ysDqw_f+xDp`A~%1AY}62U7+I zJ_z)c4!@QvsR`EvAJpCg_ASjYkl>ra5eYsTFHVL_xFce_d3M{twrvB-w&Pir8Q|b# zJ`f$%GU(}jrPh{;hYD`X!%RLWin5sBd4h^L6+99f}e!kWQ(MMn=A)U zAjLaUdayOf+CarI@Hn7s!Q!KRUdVeHI03TS2(c}z-&vjISA}eP{?|H=yh?9p14B8Z zUwtR>l+piGU3)tDP6DO2WaWVnm9mAX)c1`3p&T3FgXzRmY~aac@_!&z5qz1Tv31DS zMoCm$z(-h9LclJY#vtrq+_>M>s!2{I zYjl@PtYN67JwZBoGJlc58$jk$C5K^&5nz>}sIJr~dK83K0HP*H>|Qfg8m}$UE|H?nvgB=pa{W}siM-Fvh3iT%GguL@o^=lx>; z6V@Be^{V|1{nP+slcg?c9$ID2rj*27hB}ykG-wld0`d&8Fzg@i{<-` zL1oPvV{i>@@g9t_epJ)h&vV1|NQK~+4u zhQ-!IQ42X9(Y%r_0IOI3=q_E|S>6$+z zRy|qvcj=_bArOavE}&+MU6f8b{gH*8Hf>w6cfM%E;}8D9$coiJU>v@3=L9)yQ9L$V zX!5vPJy<(+(Pg(kw|M|4BjRUSKd&|N#eVvo6>6kLDfaTGew(w*W3jR~j4bfQxZLi2 z#5K?ckHqy#+;;WeUAdxtjswo~89U-m~%dGnMrGy#Pjk^B_V zmR$w8Wcg{@LX#uvigl>K^jWfHYOmA7YJe zI{s=n9uKP%!+c%7${C2Lxk$i?R2{*T*jEHkO?G!Cg*J>MOpPj0FU6f+*dItV&g76V z1b)pJ&Z!wP(E#rzjwNY&55X=l5!R#o)VENrBjrccGxDs4XEAo+;jV=ttEC~7{vmN(Hc`<9+{#fpHLj)Nd9eTcO~l4NgU1bOrQL!VpqQp zib+yUYF})TFh>{Clp6kaemgWrcOVVJ5D~Q z^rB8sKjecYq+-~LVDp})?U-e;_|57^a!dOlcUVjWQBca@2J(2{ZyU8X`l3 z!ZKqBCZ5TXguooG(a*5PF(lMTyU2d2(5_-@PHjVp@6l=BYJ$lrZz=76qtMm1H8T=; zL)Zn0K6KS|1i=Ogr#OaMVYNs06d3hV8d164|J-wa|0;h)gc6YoBu~A$=ZzS1s)}zl0NU8}YaCa@jC(V+kyrbM#+k?(iPn;jyOUHEk1n>nCMH%%UO0z z>j#QY`}pTq9$fm9GT()oV^&#NTRhnmitd5??kC*r}T6#G;# zT{4>ua-y&#TH0ZnA=XK;L!+!AC74DR4QTuOh2bC?SJFX#O5+DyJ}yy7B#fLm`Q*Eh zF_YgK+uo5i(hMI&X~g#gMiv-qQ}zODLySC{h&;4W71rlt+aHv#vZ#wET>Bzi;ca&u1rSmPQ3G&xc}HYiM#26F&DUrAx`u3aCK}v z5XBiDFVsi4Yh=C%cTL3z2uCAvAX#O!28fAe3N0efEC^aMGBB5Io|*; znm#!N-*Pp!BJbKaaM^bcoHJC;|9tC{V5ij>OsjqaADrKikrhxvC#!sg?|y7=-hJ+h z1KA#I_y(psW-K8JT^i~i=~ohErf-5MqY3uB9yQZHd2 zvjZa~Xp3ZD8@!%alE$wWbO-JULWg8MMCtqzV+|Kq%teyO5p!I#pgnWsn^55C(m=2- zc&&s31%G#_6ye;};fuGT2`1lW5MwsD{u3X+e0^7~s(RfXhwgC8H>Mxw-yH;Z#wB>& z`%#L>5l40V**gX{bj;Fft?q!=8o^Fk`P6szvipbKFk7%?rwBtNM2*2;N z&8GHYeSp@@0(J;^#d;j(7lv2JFaTl1RM?0Z{hjqWI5G4KuZ97UVXzgE$y@i7tD=12 zT^#R{O_6XaY>I zy0Q0#)#3Ig+TkVzzd}|0UQ?E8H^PXK&+) zOL6<-#w)_ZyY=IEnDis^28kc{4fX92q8$_?LW8qXYst__)tzbG_lR*${^0d6!=uONX5J;|nf-!1;nR z;Aa={tq#p%(H!~vY;JI`5@f>Qp(NlYC%k*B$?74I_QJLiviuMzi+0vZL^FH<;r2qr zb8Cy~r-q?6ndySL5uA8v{a|qk(va@Lkaobx)kSmBI-~R3H$)mSllep!x+h^|kYM?>=wK^lWze7D}H+0pF!brYsPI zmJ3$apq9uww+rYAb{>=fIg39EKmqTa$Y+f=ezOaUzARX=Hn5NBUybl&pvidW^`8#j zf4loY*wftDRarGI;N=!s?pn|l<<=D+dtqzGSHAqE2U50Fpe9w8>W+D2*iv0^=+?;y6u&ad)|$TZN008T^SNbfDq%}` z!`3x>whKNF>jv^OH>^@6@(ZNtFn2F#qXGiyrouwdsRDzCQ&kG-ltwgcC#6Ye_4l7O zX{N$f-LY>~hnee<&D?;{A<#kbFWPh7vU&4XxAtclYgoShrq8Y~URir{;R+2o=rOw`ynAzQsbu|GY)=^OFN;>mcZ!a(H*m zl+Fg^cfe||twYm&W80aacA6VEAOpqB7ROtJ7c0s7{osYbwWA#Qx&XvrY1RQkn>Q|6 zu^xSSn(rIw1-q49Y^>Ql$>wwH@{GUx*vdfQzRXUduRN7Uv*#g zJIv!<=W)Q7hue&a``>C|?@!n>rzW%HvoGxNz4y&8U%4&wC9oPacOKx=qXM4d1X0-a zKLRJoFe@FlDg}-OMVWU@qh6w3BEioP=-Z6|I)(Xwx=JWE z8X376kOPuHLlCBjbXbK#M(rP;>3eKI^=5U4BD*!?zm0rab@p3b+-*HPWarF=w8md# zvZ1(OFP3$A_{RtOa%z8DuJ5t@Jin`7W3rPC8Tl8zu6`@G4;|J$PRBYcOT#KDY=IYY z)~P-^(3c^pAjN6ISe|NoO%~*2b$ym}CFFl`({em9<_syfuqYSThlMu3e8!`ERRiZnEi zMP$Jc5#>1f%D2H?2YMl9o^VB!WU&lY2fq~-8LZDFXYwY7KrAnja($5jo!gQVAv zZSGvv*4NV0Hl<=}p$K_k7u^e~$VqA9qG{vGVoj9|GpDaO@9J4*9b+yQpHiyVJU5|Z zUPGl2lMK0_{?0-DonuVaUE!Lh>8bO+BJN{DguAA^vsj>NT6a^|)}B>YFFvO=E*>6r z#Vn3-!@43p4A3EwrXWbbnrJF;STdDPwkK&1R68gfLl?uQsp!&C3!KaK52%x zLXlNwgU_NqG1yR6Wqc3<> zX3R4ldkN$@#175VmNt!RS~{)S%u>K3auYXm6bxx3$8*{58ZSKe9P9b6C;_NVh7=`4 zj1ZpS7mXAxeT)VU;<$pz<`P{_!7K{Odzd(O@dmU)eAILyQ)mUZN;_K`=7elaJYN3f@5 z0o&xm4S7;s!3skuoXKlZSF7N+rh`~5z!4z5Lq^vHGgzgBaffH2xbNL8e_x!wA1goc zF4NUA`9XrCAt{m!CHNPAAb?8pl)LSU&Xg}kl4;>vBA)4$bB0uwkay{oWj4=5GN+HY zT4yP82a---bts`HX)S^l&tfe=*Dw~&q57mqd3)BJ$gJ73XAQ%V53JcE59CE&&e7Ev zOi7D#x&rn1rEw!o^AX@&xu@3x|%IUO3Bou zjYC7ZwMV8KUr<@$#WB2mUUjXpy>)J+s=Ailfis&jaQ-}FyQX-RlE#p1N8&l`h0w^s z3I;#~@E~+6q+!6!1ZE`S0hI9^1dUi~rRrPC7Sy%MFWV?!S&23m>sRP;@c@1>ek`L) za?X4gy@N11KzEb|8DMM59fZF4v=xqMgG*iy(!bC+ybB$I|0c~HOntCJ_XS1*?35_xct%NR#)2>jcL0W$O{82u=(lp6e? zog*^kiBbmb({!kWb>iqClK~k^rzE7yuv-UW0liA65afU0gi`Hefe?YFX3Q#|F?;%& z71yda{rarR)y?S(=U0ZDk>HkD+wYB(-T(P*|8~cQN#ME1!JIDRZfYw5gVIxFYBJ6sl}dnsEbubsQ|6Ni@jtP>a?dFs%p_WOl2qN7$|owN|! z*9Kd~SdZQT)Qa%S)t#4q;lVw-cQcLMU)m79`Sq=nQm@~0=kC|@xA1G(`=xKw#hgl* zQ;M5Zf%m1LH|Rnuh=VNQTG|Wv1D4Zq$&-v}o=}X^avb2Mmxclm0wsCC=jvJOi~2h2 zU4MeN@WI!H4pJ;rC0mG7IP@m@0cJI6=-)E=>$Gfd`nUw+AIL=0z5Gj2-`XCcGwM4n zB6Q8ri&H}FSVPY}CB5Ejv zaXMM@)1;GB5-8n=Z5~%(3RHAety1I+Ow9ZZ;}(;t8J*>CulHJ0HH~ur8_`AM>ZAE} z&mMl_l^0mcz!R_RW*79!O*OIgUZ+i4y!_nB^0P2eTRg78kB7zCki6?-HBIzz{kTO@ z{^;&ko)};)FTC=^;b)D9`{hOid-1NfX$zOG>Ou3xT61Hq9R(iuVqR{P4ofEr{i4`J zX8+JLki&&(BB>SFgMxPoupc%l5H({176Bmw+e1|JcZVy&$P|MW;T@=v#)?KR1tdf7 z5iyX!d4OI4)kqsC#jXs6fpg$82Xh>hhanckEC2k%a#lc*d=TNRu)UZ^BkQt$!XB*Y z)b;RAzuk6aqTcS%!(X@iSh%L)D&1+f-J{#OJYmO!HrH^`(A8A5rm?iB#X&_K)7)V@ zit_9O4qvOXi(C3!fk433XW_e)R-fa62b|tkMd|7++-Pmkl&h6iuk(R_w0t2X(@8Z|;YOPb5vwvXF_=jxVQDy%lwqR{wc8S~nQ zi`uOYOVw5SDxd3;rcp&beW8gpVeZWj-r;dqlwV%1$aB{QIS;O#D=WxWxIMU08KxWX zXFm_O<~Hy-bT3@#mXH23PZ9hI94u(;gpfyhC>TbHz>(l4i5RCOXd=-A#qPzz)IoMs zX#{D)i$kl8(Tc4DtYYm_xT9|x-}u*aR$cc{U5jk@b1(y3m0<``=cx?ZuDk1-Y&N@r z&F0hYy3Q7?^whyIg8VK~EZ}IVd+54V=NQMnJEiI|R=@rFz2Tb<%KMG~d3T>@WxW*~ zE$kUJMVGO8CWDFkvUxw+x&PgL`||s){^7i``b03PG2B!%O_yCBrd#V*diE%*majRw zcVX|`pAOUW*dBHGD{dW$nuAqZ8*c;hN!AW?SRe(^QxY?xUtO@Nq}xbzV2RK&p??j5 zg)vAYBtAJAfh_^uOD<@n426vX=&3g4sYNZuK!2t`QkG~4btuX5@pTO;#658)Dx1R- z)gSM^CZ|@_`qBY+tT8*ungo^m**ojb>;J~J+e5}6AzbFG+c0HPSvc94YF)l}&ctUo zJ@^z=o#ffpg;Tyib^Y4NRkt*TXQ?f*bZwn4pVf4?#mnbE9jWrnUl41VT|V8**3_N5 zAYQj{W-zp2;r_=aG}iZ~c{bf!w!1f7e$Ae7i5a)=IPZc70T)D{0=WTC>ySVp{=h!qkX`Q5q$w(Sf?HcBtUOu}ewqU-eDsuMH z`P^%9>smhRtE)}NTGUzL##^q6tX)6#`%@OSY<%#7^RAjTdqyI@e%U#}mW8|FM@ger zKYsip`_zRSLcy5}>*5QD#yj~rIinJv4{Ga_;K_1kY_Mc?@c2uo21hPkmlW@LGHOF` z2EqNqc^3&8lo8k~z@ng4Nsvk~SBM3zWgBPqui13h z!x;FPdMQJ^S_oq6k(tH>n->Zuuv2)IETkU9EDskmwQfAind(MFEHdGw=vaj;NmW=3 zD9EeX6nVg(A0(5?j9_hYq>796E3sh2X_~{s#+)*1d-4$Vz>U$)TVRehNQ$wT$zZb> z$oKqU!6sh7x(w$GARxE3WmM!9;#~glyWhRf z=4_uocQTtgkI(+IP>PqVuodSu6j zp8OqbPtsRA>0y3lDeXr%T2hFfx0Ag-^rJ*dz)XrFmqEaQC{I{~DVfF*aNsTQhr~2` zfq@1=-QkaeS2dQka<79`sC~vIk>tY{&|W6ON48z?Fdtx$yugekgQM|zFte2oZv}fR z8M*c)E}8Ku4e2FJHrhid6nHd6F&f4a;$;7UsUJ3WF4~t;IgmQ0+@VCLIbz++MFVKU zOv`OE7F-r{`)q!@soUgtJc}tLqe$LwLWm4XUKA`^F_X&0CoeTnMm#4}ob(*2I7Qnr z*AQ?@8FWLepi^MbI^3r=h?y|8?dSyX{5XV-2Wk_SLdxktkX?CbCpqH_m}R0TkQACQ zTe!CK5V3Hl14Y(K?i|CA%X22=T1>DOI5{hLa19!<`51X1SuCtXIv&umGX)X(9~(E> zMPN%7b~v;Ig>*`wWFX(Bg0PAJ1rRGZYxcbbC#A#6w@*q7?mV1bcIPXXk4q;jr_b!& z;d2dPN_OYwze-=J)5S%m6^SIL3``Mnud1utnK&A&DMAJ3+X7-q!c3xG7xi*aY4gZg|#;U zlD0d6KQu&xfPH)lCh# zMKzmM$Nw(Hja|bt4Ik<7PT?^HU+Q@I(9S`RH)Ly@yn5Y?hO-hAqMK96^IksBlfI&I zeB!Kz%(~T+>#f0wJu|}osewSyqd9av)M&FgyXMWLU>u>)ps-vA^81?AVYlEv?a;M| zsy9O`tgEuxpxf*a>e_cWG&uRH9+>CbxooqP$z1*-p$%>cdjGg?f>zdk*6y>fIeYcx z*7~xtNW>nSV7+`bF5JAhy-ceE)!Nt)t5;;J%cZKe&Tu%{?1X!A@@6>{mf=i+7J$hW zemQ`-92UIWT<^sggT?b`xj_}laN0Xajsq+(EC7vz`6yV%LtjaB3nSX4G}_>2f)`9@ z()0_0>@yt+tR8S^w1lvy;s{*t>p<*Z z!AhBB#e+b$MC%EavRM|72^a$ze51?muvu(2#p+)anD+arjT>in?wiqnTowzoCL#VuNe)gP2552f++V7_L`vOZA*tmjV1RfuM zdHnv0s_2ABcy%b@W7dh`vQYb^`TzaLo9YJ|!YjsChN|l({EP+mKWTj9M928b%FE`L ztqj*c)^OQRj(l~-)ai>R+BPf?uL|3|URy}3f0)Ju^h&{&0-9*xDD)l!VNz*Od!~r2 zAc7WKok`b`G?K;#ga)KBRru}%@sE_`lbE?Kb|$QR<5%9 z^w!Rn@)Z>>-B)W*#@uqHYx2y=Ha*Dt{%s$xaaCA-oh{P>uF7#r`Q$nNIhxGsD^`@Z zbhhd~dzD-}@hs-eE?jS2T%BpHShIFR&>nzSm4D9Ua%EhlD=@94(`T)4)$o1)*2jXn z4RyOJWp^xTuk}H0V&Z&ZGh*7_kKUV3ad1=mNBm6I{;KGCL)(lh755nOD;g+z9nnG| z_%dUzXhIeQQCmlt`9C!H3Pfb=>2uFzPdm;Sg+)4%WCzba+t{qG`tW!x0=@+RG)q;Tx{ps|lRu?R^fi>%c_!Z%1ou-)@~{~s`kaj@M*sd*~ zc|Pm=#7~VMebzYkW^Ln}&tCjgbv)WQZrgpc7WFI|e+^sxvgPpJJNmcwCoVou*|dJP zD|)k$fA3$m-mBcsuV1Iy!(ZH?B<1mUEnC_9z?W^wy1j=l3QoSV+h(qdpO0e5|xWW4_Sit>MUpNdrc-gvzbj`s-9o-i(3 zh-e@`{^xg{i)3G!x{%#_;)kXw5uql5p9H;=K*rqNX>$hkD*_yn^TY^`A^bA6Y!YTt zNr<3?1&;Yq0#LRh_Kut@`VCMFpIm2sN%X_#DKrn>31BM7&fU;zk(9L&?>4`XqHj#mxYMseX72QVfMY+CvMj4YY(63d$K}C6r~iZm zr{R7CjPhschv>WlUZ!s;A-eCdhc2igB2X}mSkFR=Hx+grh&itg-{Df-$UO(F4}8pY z*yY=}-&c8Sc^wZK-*~GWR#XvnfYn`o#jV`Q1HS0pkpy#m35K%Q|E#<=;ETwRPyg4~ zzwuM%5njB;OVL0uUj7!F9pZK6w^sVR&Regz+<4>hia?;Y{AX-8tNfCaCCcvxv*G;d zH@+-1e=*DZ{cgxJw56C<1GTW?}m&l3+@XpkAMc^tne=-T)-_ZhV9Pd^bBb)df zd&OYjRSl!{xwbx9WPNRqv0pIl$rl4YKM`tvU*N?jjpK&U@4~YYG?}4ZFL)WawS!ov zV>8iVphW0QVb$qK7WU?`1EOkT4#=3#JceO3Nz4L0jpx<=+pBDj`fsKk)s+ojpJ;1v z=+%K+Z;g&?uuc4WLuIui{mpuZt?KqMr5Y-4y|uDobQzu<^B51&WA=uT%Ev`VSKVN9 zRPWzkWw(tgBjzP5U`U62VbfUIqcH3v7Z&r^l%|31DwRDJG^e6Fgl>fE_-b#>Oyn_D$|ZY(zMg_o8bE=U|%FQD#Y7avmMLh5+S z;ZIF1h#X_KFf0mPWqd}hv%aReJ9+&RA$C=%;4v^cy{vKO^!?+5nI%igC+D-7OsT-J zFMaWYU6V~|%WGV}4&KXqkI1Ml7FeS%h$my{05mS+`>O%P+7^CfCxNHU_7D z>V+HcdX};2a$Grd@y8zA#I6cGaecD8xu)J(JA;?GDuQKU8;hlTvpieYGA=I58eftL zfx?a_!_#LrE=x}iEQCGouqd)DcJ|Ut#^h}%US_&?>g-S4q4r%A3Qq2N@ZyaRPMfuB zZ*8V)X|Q8~j6wAJtuTxz$ZCaLTfml590>}Y04bIZ=0?*A(Gs4;sEVNs{lz}7)I zUKmgCNKn-Y{fN*@f*3&#Fx4f~+S7`5KNv>hhBBGFn0Bjrx=C-EY>J<0&LQFw9C2Z; z+h@>Rw=cNn)-iJ}#LiP^^9&$yUIB0|${E16mgMKkI(fPn+WagNRIBt42h{>#W7x#L zXUb=)1rF(eH4fq_Bn~G()R$7UO+pjUDyUV_C}0S(R&R}qCWhdj z*iq{Fr>dfEvoVHE$dBJIG?i^$&75PKwgE-a`a)wOBMn7qV~nHR2p?8xR|=aI+9euB zgEj2kDn80Es$I&dJs*Amb+9Bwc25bkTT6!G6 zI{i~=sIyQluMMH@j&=yJLWm?QN@(Gv3(PW0)lik~NTC`Mc2MjgRUPKNFc{hpe2KMGTN4M0Mq{Zl7$q%OlR~e$WNHmHn(mOr zq`1mLAp1Z?gwU>zwq!@BL%bYVkJ{Mzrw-0@KS02|i9RWBIV8)@#wQkj^SZ#jQC0iX7Hsm&?_{R*=3X9F*Rozj&&d*i5&ee#Df(Wo$?NepMIka+wHwLXAQe{NflsU6% z+zxRIBNcg#jyPUWzB?3zI>jf3WSQxWnp;;nj0ekA89h^N+-}hkc@jTv9e!mluM)%; zbs2`+3Td=zg=AW-mUV>h3~{e4`e~y7{DULJWhZV z$Ix5LWYw+$yj2?_apDWI9Lg3Aky~NUU`60ftD;%`vgT5CuhW7!nL&*!G)8L3U9MWJ zPN!96_~?`tripbs6t`N2v9ytsgAXsTVuZqgyK?5XxR?W>H&xw=DACNOFwCnGP}Fk8 zDl>)a77Qqc+Z{m@tjwjW9;+g2nnROa7|F$VAi$DUmD3=fPeSJa>)<86A-6XIG$z-Fn_bf<X~j}>pSeswiai#x7;04^a=|o zHdzXu3~D!k_twGB!iup-<%>wx!n(HuDjeATlAIHvY9Un}`;FJJc|{`9 z-^eP`5K?4)M{evN9gQ)Ivh+8UDT=wU1GBf!lmQtmso=k_g?xr&l!&KZ3_Az9*8E0P zi+U}-`{WnV=3tR(`03+Msx(gd1-|R#&qqX{Imr*3ZT1Iz{{}+=eG!d^m^rdjB)d}@ zhv6|Gg(Yc-5b`RBcykb*k*rxTX9aa6^#76}DUg)W_p?cD%^=e2hYDQ!00MXh&pi5I z3G44!t4i6tWW-GI$p8@?0~mrqGDd}bo&*j9YpI__JtHg*t=Pz5=w`NuBnsrA174Bj zAoLZJYFr@J5w>!s6rAJ=Rv~d9ei09fyQ*wF%r3YGod%I3J`{A1@v!mmJv2b1fr9qw z9(DmP_#+NSJ-UFHS>9?~!b9Q7|;*yG03lx9S&g z2w#aT#@!2P_+)8@v`ku!t_wS^w1>1bU}!)Hfrk-&9rN|-g4Jm8E7m9lmnE|A5eBz- zmKRF!C6901yL8)iTJP0UXZEPd=+9l-dKT}!ZSUe9Tj6upLuQ;j`J93^sT|+7bnnK; zm#956r(WHwU1u5#azNpdMQq);#&Du?f8KS5Ph+bs!p797E_@+7|LCG6*Qz`AS0=)Z zCdBjmI$D>Co8tS9>Me{SF zN22wq%KM_xS1TIEmXdEg`@UsYU$gAUvXv{(*>&~uSC@~;;}eIdJtkK>BIWM-PTg-u z8g{M!Q4u*1<-bQFT5%wnLZOQ4(S`DF9$j`|+1dZG?CNXJS-BE5kIvG%z*@}$cU54F z1YAHpAOwLxqYCxS6bI_rHy=Hb1G>CxJ4eL7M;Mzrr+@RohMS&Y*+<`mW8IA#nxI7`cA~EsZ zB0@lmq&3oJ>1t`ObO&yc#1>XDDv%tR-ePrQje|G`4N4jDr3v(wtYAU4(j_8a+ex)6 zsBQWJXkpTUEL70BNfOp!r)h1GK}%E41v~=NWkfweB~&y1@Dzf0!i*WUAl*T4m7fy) zIJ<bgFWYnPZRf1A>+6^9Ik0S&)wyez(>iO}fjvvt>uN*e z+57I@vuwSNl9o&Pmt0jd^0O{|Znre2adYkAvU3nxxuN)Ov@(KDXfy1?z@_Owo|qeFgb>z;9S;=l){ z*y{q8=7{V8S;YQ3#xogX$>sePsI@&x#K>jXgSX4rG_VN)f6=~Cji?X_Sb^Y+5+p(& z**FA(#%DgDj~0lyy%jMx5F64@n+QR#*h_{pn!x|00m={3mmnB@3WB`;XHCl*KVgm7 zVsZR8HqFSA$3K_q<)52L1s6=$eikcya{>>e4&!U}KQVs7KV$sF_!PdKH$ZOQ_!5p( z-#_#>C2QsYZA?;5?oqE(uOod2c`X6lOu?h+tR(WL2##0X*y-ktwOq^2@i&K`mRHNMSxQTG)~ zS5D`%FZ|e!M=q2tSAO!*UtOMm+~)91xAF5A9^8C!-_T#XmuHrC^Vwy|%2C;m4gEiK{lgY8LcUti zW04jM6b(hIrcKn;^qA49KP*2w?p`q@oth;ycU&APof9cKu(wZ_q{VSE2U;^DnfkO8 z^gEzvik@S>!VV3&_^8$uHEv_CkBx|2&=Zm$#kK+UXsKrHxT!)MeX+E_t3pS}?h&W_ z01V*Fxs-o1_6i$`bd702pWL+W)xW~}Yns#ttbK`e9ngVTHA48BZqrkcKBOTT5g)LE zddeS+3!y6sBx`UNLVvzaYCzjYcn4rdyRuUK-&WPDEpeB(v#Dz{oYp|NY~{7mn{3C&AtI6|43)`Tu!rgp-*)z4*b^gHU3 zi?5yLs{l{=KY(m8KR9{7|DU06X@Cnq#sM0b@sRo831Zd6+f((G}2m25mpZIv36j}4j( z;C=Nq(4g@E8s1cNzlZRAGc8BzL@rXqqENp@K`qic>gu|&5uIobG}rDcTrg*AenUPJ zniI{)VZ~5_UGPkp^bfra@_w(r&L)I^kP0?6IokinDX1=M@ z)?IMu{%zZvTRb*fKcvzFhupsB+hh9Y2r0a}cxS?e<~qsHpj78{-N{vTg3y<&XhxL~NFa@zFmU3ak= z$8(BK?8)>E+}_FeMa6wK6k17W0?SmC_w#zy5m3%ib+?Z?AKfvaV(w zp81BXm$8}InMH{X2Tt9Q#)WV~9tcB^Q9}r~F;>KVq)G502hIW(@e-wgk>D(Q>Dw%_ z4rpg3juR(fH+a$EP-|#^;^pPb^Yih?c0T`nb2I+L->0vnzL`D{zssL}tB#(g=riiT;) zg!eRU!GI}(9~hZd_ybdHN?I);B)R*${0d8c)2#ooUah#pv*|jgC1i?;C2XscFoAw0Y5=wuX+8! zTOPc6UCUI9E`nIW)&)5$?9!`pCL8-~ZqW&zJE`zHv2j;_dU*3oyBm9UUD?t5&7di$ z9SgmF%Q?6F=H9&zeY~(Gylrtob^GS|Q>x_diR+fIoqyr}UfFd6V#W~PpQ)V#l_OV1 zrE+u?HiR#!92sSaF_i|0kxP}%_v*{sYnqS!dE%u{ukAgy>zvYAGt6$upw`%{e{uiK z_wQfZOqKJ*t6Jv!miz3_&|^F<0i56^iwYl$HL%zp=iRkq%DA3OuV`O&XHadhl-a$` z)w|VpmA%|qWY00^<==gH%j$=MQTN{#o>#LpG1j~K-1fDtLGcZQDU`*^I%af~ zRkV+F*a2@ zlYQqRbxTeMJGyd5?cCnp%ANyrc3+vF3T}UJ%DnbXQzle5cvfJL|~-hkLbp`M02S`iMdZr((3Y9evH-jHK2a+cexH1<$k@5Xs`leX+m zG_C8dzc|#guKnCq-m!_LHRmnd%Z}~eKWSz~dwWGFo=C()*WN1sSJRG5yPG4y{zv;s7K452_o-6#ymjR42ds~zQd zO>VwvMv0kpt|c>eAKpEqMA-=?YY(4H5>1klhd+e+88j^F*J8_(J*@xgu82z>c>mgi zJ7><^c~IHOCCE382V}k#6DO1O2<0{c@dE8)2}va;5xD{%KqYQX!La}`lbnF%ADgHj ziJioA_^}h-`?W;&__G)&BH_T{SuWh9Q5gs%We{KBH)F%N9|@h|b;`2|RZ>Vw{JSLg zku1(1266@hi||q9LsBC9Jv@Oj%8X|d%Ckd}LL8w%NboYlX#-DFI8UbVKzU54@E_;D zhhlYryANDzXem4qY@z)g-4lKA|3u1#3jm$a12@oYUO-Bo>;rm_)N?ZF90{R7ylX!& z%&A?V!5i7CkOoO49cm|D-r-`7YPR2IwZs|PkbeiC`^vs!*)O7YKpTqaJ6^`G=sWbg z(w>>Vf;Usag$L2NAdyk>e?;``4su8rH1jPEdaM?-ny33@rEVxLxrsu&Yhv|AHPg& z9DJYHG0|TY{nv_;%Brf$l1qOdV+&>-tdUP9w3T^94o6X5r8e=AujIzInZ4b-&mV`s z>v|kn!9StI2m_!bf}9+|C66>zplpx|-1d;e2Dce^nAQOgJ6C?1En}3b&Xm=6RnxwxbjUsJ z2bM)xiPIW1M52SAL6mWNSXXFpUn^o4xZVuCizi=&29j$k6^K|rDwVoTENq9-OW^`q`_Mk ziAUB05TC4ur3~M)z+{5=*$h#<+vw5jNd;MK##fC2d>^)0$t~bB_}1ySqEu(Nb@wS% zDe4j<4i|g{pBtnLqKvj=^?@^BhQZD3nX|3}JO*M!$rlD|Vl-nx&D@dk7GyR)24Ycr zt%HL7$#a|o1Tmws`}}-Opt?ePesj0Y)ph#;m#s`#&VNZM;6pz7adJ}>Vb zrg@rPa^0u$Q#7uLE}#KG7d*87!CQ#rbArv+Vr-M_UQ}m`5<)u04FQIM9T`wLpyHiR6ePH9uQ>%NH z%x+sB)#$GI8*}{aC&S=kZu=Rq#U5p`haXO_54;X8(6*J?wHT^HZIpW9OAr~@mt!%2 z?-v&%aq-5_CtLEI=&@j*C zEHGGlpLpeo53c^(SHL!${Nk$-8!o;0b@SXo)qOB5y&dB4_GD;iiR`>|T3&1A5NQAqrVQ@)sSb{in6v}%w; z7jq-#7E3Tdc9XZhb}Q_4Ggr>c1@9?d204?MTNm>RtwKC`&C^x{^@`qys=ymmJ?G-b`H=HsMU4Q76d3-LJjVW zIxTdX;t7_f^hki`aCW~UYB!&WDv{fN;CX;xo>YSL-vV^A7`~;j7@@Z_hA7}gqo3SX zS_{CKqI>#Skl#<6)CIVIehPgI*9FCdL1rhj73)C{h=jsd^1L-RAT2CK-*M#yaTOfm z7|o9*o#M+}+;Zuyf$tu9PhuGrhLKB1CBWmLsoP0v;(zeg!y$zlA)|AGA*CUhFc7?S4q%t`D!ldH>{nx)E|oN{wpg{!N(%T>{4F3-uSl$x8$S1-Qd zneRVy!(tJQ;51iM<88s|wUc+wDleb4bMpDKjAh2#Zn)t#>}H*R$EK?3TdH&GB7s1p zHqYy;s4lCmEvv5ZdGl)NT3v4Smg!ZS?pX2grt#x9JH+b;BuyGJuxc)&V^oP%f#DKti~TMtPKgC4pFD#B*e+D0d zmYLq<_W3<;*XNsIpMUfq?DNxG3&=h{s*GqlCCwrrZ-#u7A#G!PfiXN=8R;`8C;4U+A(-|$01{+vA5IHI1%=+ zN#k<%v5EU~)*cQb=qU)*9p6uAf}YQy>x3=CDEFsbTmS?JGPP^Rfde}_cOTxe#9G_= zvTJ1v@X5MbR=QqpE$HnnXiXemyEw0eW_d~8VnX2ZR{Y|=k^ z_gx^Wp)H8-Nv7KZy3Gv#29O=C-30*a7T9LF+N;{jO=9S|LL_qSR6kl;(qkM235Qb{pzL8ZmeAT*`^r`AXlt}529YAF z+Ld9%`5ev-@VGz>B;pL{SZRIgn4#VwAks^a!|@{42vGxvcA#B|L*5FHCR~1;J)KgV*D`=XsnQpsTdad4%C3J0>d`> z_^5LzOVcZRh_bly94Bdsmyao0#U;?(RDw(|86=v_@nBL?kAO70kMp8vgmqkN&rAl+W~;;gX%WkpM{t z6oxFz4Vtu(UovN&QTz^AeF@tnnmanF#=BSQkLTEFh-I|W)NgR;SNlpclrJ6YvX4#}ro z8JjEt>IgbYUf%ypWArOV)ZmR$GDsvicrwYymDsPikM;C$2D+cN{J4C0`Vig~sy0CD zPa=&Gq1c(5VYeEJOF$on$;VWiVb7er`_g@g-c%evnlMf>y$L3pFTDz{!M6&xhQ(H~ zL#LhW(pcZ}%dkURbU#MKj|wc+w6!mT`{wQf1GHWZ9U=nU-=DEfCy5OBoi92Q{yxPj z!ylbSCTT(YW0N6ulHJS5ogqcwV z&qu;1`#M$sT3jBNhR#q$*h`4}OLERe>Oa}vH_ZJ7agmWH#Tjbz@s~1%;Jz6CRNADJ zP4aed&_&*k}kB9L;+<$O24wD4k!dQ)04Ok9slF9GNeFF*k zcN3`jd-@WIzW$zIFxlUq3AZ)2nZP260oKFR2pdWS@jv7$i$2Ku27>)ToiFLr zVL!n7g18D^H`s_QCE(!_XQmYc+LH;6!ad}E?8W~W<%dZ;YgV}w z70pnQU>H}Te$!+Ug;OTh=yJ*ZO4;Ze_?A*Ce12rfgapc>lxp+?LgUDS3E-h;i2syo zfQ>(fBvefQAu}V-4X9_*nJx-j4Ap=&lq(Qh_XZBC4F-8TyP6$1VgutLrd|1(oA#XiXWc#waFCwugwTx5zJby1j0Wl}zOHNL>V#oj=<&U9Ir zp;UpYg2Gc)OR5OHfND1SGL>tF>KjsxGlizwGwt9yo45YUs5uCq*sF1eJyU4{vp=pSg<}f+wRamPUl?Nd;5Db!1!ygR>Qv+l)*1+a01Vzq) z4H7pY&LDTY$m|v~5gki&SF{`HD{w0+rGg%s>kBDg8leV&=0dE?2r4`R0t|wO%7%-) zti%HH!hso7SJ#3lyJ}b;eVV_u{bV0dMEU1W;`8dBJ_VAhPuys;^&!3%c5wj(QqXb5 zo?(Txb8v1C@i{$MrKng~W>CN+)&eaed0=?VSPyAcIK9<|i=B=sVc$lw6>0%9wFVp; zhOzZlajnsSq9Gon!iqm1;grbR1sH0i6Y(mZ_hZrx7FAIx zKogz))C7HOER;5|r;v@McKR|73-u}K?9=*taYis09OO4hv?aQgS$~Wuk4hD^Fk3zg zBKb8pHU^7;(+G>5c$55V%4^HB+n$!aSL(}3l>5EYz!30_^qNkwYgp5V*40*lgnaVh zrX`q`Iyxs+OnQMk^9`bEW0#!l+DImQEOLmbT6?&mc%W;e2<_1se-ILMd1IH*Po{pp zJRV*P=2yA>4A-g1r5tX5LKs@cw-ks!NlZQevtZ8iP0sd z2R3${aX4Vy1VyD7q%~LZ(o`cRv%iu`jAi$73#)5;ULc-c`F~UgBQ=6ckw*=&zvI{ z+UcS0)T{JRySSJhTHV9rDh5B`Str@$eDqR%Sk@TjKBAdX$^AUDhnuMQZDv6HUQIs> z9-imOWiAm0BT^ef=^7_DM8bGSLu6JRm^5pGaB){%CR&jb*Jib=)#29Vn{K;f`2aaq zsgTQEMagr8pWYK^eczVS11fQ40 zyr+3q1-(BgKde<143rp|{IZU{WcVUS5$vGq&lfQ#T16*}U9kOENMz39mMul^O=@w9 zXMnCUr)6GC4sC?nh7O-QaM76CCp|Lh*3yd(B$gk#a?S&Dt~|6nG0+m-f8!4iFP)jZ z|G-siL#NwdyluQbeTz}m;9;v_a zP4NleYHgHnj!%HLpFbPix3sUSB1rAZcvf<6z56qP^efdl)#xu zoB=3Q*(!vfMX==yp!7p&amjz=!pP6$pG9;&e@>+?Xa58Hb97^?eX@a1bpc{I{;_GR z9{xxk{OI9T*fZ&)huwU5K9H@_2e-@Q|G@?H=VC~Y`RvJIewpx>MGa&_v%)YQ)$aoOQ);M zK~)9)|FmvKcqxN=E%D$aIJ-PWt8Of3GHrQI8$_Zxuex*I}nb zQ_y<;H8dg_f2@oGsmP{+9WM-0Oz;+=YB2#th{KY!IH23eIusJ=A(!6CZ@$@o=|9SX3zi2DzN8bFE_?N%l>~g9b%+<~ce_6Q9z zLB2-vnp(|fiEUF3gm0X&0#{Rw6ctli@bZ+6Z}R!by{X$BH;XYP?Q0 z%9mVyV^igp&4zbTtS5!2uPW{QN^f3fAkdhHbUlQCoDaZ|L!At>0wBtv-kXyx<{ zDq#o_#J^JL6;tm>CGEv(gC~&c_k;}&ms(}E1sqnb^sSSsu%HfmghZgM7*1DOrv-{# z@Wqrn8+@?EO@np+h9kbjmR*lnZlV zx|o|fDkU=po58*jmI`t1zc5Pm`p*a8*QLU(zr|lq|L{Fx4;Jst>F0Vq?*7-{QJO4V ze&RlYd_JJ){$I}-8h`}XJ zz7?KTMAq6eVW4w=a&B2IB-z@s^sa7Y{rKr6F*`r?@u#F``ED}b_S7!Uk>9;6T3XyX z!Jo6ZmIQTN5^IN#Wvd@pV3CsMS?P-zc^y^&l?72DQQ#b%3xuC-;6#Wf(Ns|s$R3xM zgjKF@sP+JIdx&9FlVXxjwHP6XL6b<{`}LH31qfeJB}^1^PfKnh1m;461t{xTui$cU z`qgUENDh6JJ#$KBFq@3BR}DGf5Pm6IRO9z$saqyZq_v~ zb;~F6Cuy)C=D;=i@iZO~o9Py=%X&@fAIhuQEvHmQ-_Qq{{*;Q31q7O6NYrEnGY{}I zP<wD4m;$J15AMqV$M(8_|yWS+rb=ZI3fAtPu(cef{XYA@^{>8lr&PRtXJMQ z;$sR;=)pu8#Jsce*fc&jGLr%NIHG9et4B&KK1CpxkSGZuo@g5<-VS7I7KDBuI2s?{ zu;zl;q_WtUdYoC^duBFOpW8CNG(6etFq!W)t98)jb=|XP4)bLm@ClRax|^B<9`C#y zdqKomKKI6Ops}(fk(YChO}ERCZ)S$p-dj*$E^iAor}HVd7Wuf)NKqzlW*UQCC2a@X znX`VTi%@cMy)U$CT(?F^y>Wo6!>DWhT;{-r;W9r?^+%;u{UnLdhRU!Un|zdk^uMQh zGC2{uL1l`GQDs?GWxqZ@m&NF7F_z0BWQ~om-~hdwHj*Z#qGOS^oNB3nx4uqQNVp*p zcbL!%!UTx~kPN37j)yp)Lrq2u1*^(nB$b%4i0}UP{2)5HJ7Yhz~e| zdV}>2Sx&z2+||fGBe-!z)a6{u*sf<^5k5@GqEtKcoSC&vV`?fao;Ci++%*?oRW)tV z^m_4w`|lqt(VN^Z---KKnAsk9Pl^J2(^T@_1M+9`uZ8XQXy|TgENu>TDdSB|c?!insMEx+Qz!M=>m+{7I{hsrOXA2nb*;bfstGGrPL;l* zO22tEP|i-TQTv*X#?Ba32tYQFw=To{5ka|C5kfffkm`kx04$>*M;Lfwl63+3?s3g$ zR%6a!GTN9@McZsR7I7@%I7x6hQoL|l?x3n{Od<9X_OvdlPQA_j9eZ(t!OqdZ;ftVk z1HuX{K6%s*1&Z_ZgG!eh>l%1!R*qCLauNHpj)fdN*kd2|I)$%kYyX zxp>x?DdnA!3xmvKEWE6@qGeuqOnCk5c^BnJ@+%@;%MR-!dNYtRg@TB9cv)AZ0@p8^ z-?bih&1*?~P{{!P>I;{Zd&X6DmCjkho}NuV?Tpy86sa*x@#9eyQ3S4jR|V6@ zvYP~j)AFuBmainBzWc#9Gp@em%lhpKC@yX`HuXYZyzq=-##Ck z^iGl>)~i=^C{8Ux0@-M; zZ=3q8_;^aS;K98+=S=Zy0e9=4GH2)B2Nx)W5Z@ynNi~Fb5hi-*h4eFc<)tvcr|6r0Qou5{qQ8d=5+2 z@ywIl45h}lhm3YT$`&Rm&-_J zT2LYdxsv!JgqV4XqJmVRc!P`IHUZC8loLkFDbl*Mk>ieS^mNi8nPUTiaa?IyLe zVf>ng9GEC9tiobs{UU&jO=@L$_sIP=y_WR|4&y5C<68y?Xrzn5wGZZRsBD@V(uK9A zYM&uEZTtjBNg35GRA6)nJpc`+x)q%Ya(-J23;0mo0BHz48-Jm~#US556Kl@rwLM+TJD&p8uVu<`Us#N-ZWDf}z1l;&b%JCe5BQ zYaTHHwY@tcKTjZ!L){yshpc9JyyjL^_O`4)3xF6Rw~IxHvm&wV02;G=mt1L zA7q*z-ZM%=j4FdzepWH+~Hh68Nu+sCw^XA7qY^}srSEqJb|56j*sRE-RI73=B-s^mpI1f&srlt6cX;4&{f_^EL{KTQGabEI<2!#br0& z{{N{}bDL1%2W+yLx$vNa8Q;F$ zYce2TDR=_#yd$PR<2u#_Hl2-gp8jo_iajks@JL_83|Lpa$LS%-EQ zURM=apCoJ8))mjyGyAJ5PO;=Ddj=0xMWry(BbASBzHTV7M5k*MzQT8ll#-PA85(+U zKO>yBk{Bhxh6277kgFX-VN5+7Ha)NTh%z zJsvoJ(^Mut7~fFQXmf)1;`$n}3#3!8CvqI(ykcFDT)g^=ivn^#UJ6HJJ3a}Oma)&Q z2e6ydGI;mYpp5sjWI;3{B#r$R7nr@_ek1z>#~A#&dS8{69IH z<77A!S7pz%k8qE|is2sR=G&d(mD#gtnC@#p-Q9{O9P?_)@ti{<@b*L64dRl(5Q90% zmQzSyz;3#=wxNf;VX@2a*v%F@Fnr~cLQoz^4T#C5xw*IIcI7S=`mzhg9=Wx)r-A*4 znI5s2>5)`I2r|q~c|hn{iYIQ(&0X4)UDE7!${}B9ihD*^Yc)W>PIGP?pyPC!MIPgF zkb~r>K2#b)@EmjmOy=0AVc)|BfSo@k?;!5uEryNHUOp3{E;jFSTzNV1_Yn5p4& z0`ZS~7mi4)MZp>rSR<>%V3r%|3tGc9MB zRe2<3@d2ew8VnrgC`vK9m82aGuiWo!cgp=v!4q&yh_e+?~~wsDa#{`WsnE(@%)6X15aq-BXGG z1P{{#iUb?H75Qf1B@!F5K1DP6NSjz4ApJ?Zi+jjKs)oOumau=x7!uNWl|xcA=MyfJ z1k&vFh_8i3lTj_1oxT7%!1VyWmcOOn-<6DY9k zeyN(hY111-pE@A>knZJWD>wunbO7?Mu`gfdC@RQxBVCNyZ2I#Nlbh1cAe9pG=rHv= zPV*+SbKF>mWwXWc22*+Qee)4A$s)ZHGRY)20y$u_KhkM3SvMN3+pb2+7&Tsifmf5E=#u-pSB!S(VDbmw6V`^%i>y%xtG9{&90 zBNO!M+@kL3zj9dinw|0$$M7JE%2c($ws`|G({h}^)HcL&lIJ3N0GUe0QlD{*ctD#~ z=uo=)Azc&Df2jMY8t`@`_ea2@X~Z{va>QZTZ+5m{+SQq(wp&+gZC1UoX-_0F`_lYK zS8ZLad}d|)n2H?x^LIJT`z?-f>pGep8oOz>&T27>-ul*sCCe_hmqeyjRK^>6>L99Pm zDGZg^G!EAxEAm%~j&PoLL8reg76>B^thX}SI(|{Q&-S3tTG0l)0f08+p+pVfzGL8m zl@5exCSZHWvQ=~+X7XqWW$6M?)J#@ zsc+a_POCG_X7@)xfU?0B!rThb(&fxfw)9@>2#4twt1D*Q^c7t9g|KwME%>AAfDtlCg zO?6mSo1OC=mR_?{Xt&vH4tZg8p>L6$-Rrbj?5XcL&Ak@Ke5ZLeFgKnyJBgPeVG?x! z3=s}#iAJy#5C+1b;gSsv#vy7#ct+{z#2q{&=N?F=FlVq0sh8wO*uSZrWUbSDf5t35 zKvxD3P9JzlT>a8cIl=ChcmLN#qn+1q;bxS5o5ev21X3ZOY&sxZ+Tf9$r@9a$!x?tM zqzed3M6`u!Vqv-fpj+jFA|r}?#E4Dc0sQe>_iBAdeA;inen0j`yU_O<)%CH^ zb+o%+G4hbvuJ)_XVXM#6`gZ%Y%h?6zs{L2n3`hn+()V%^pE? zUJ9Z#vQnsFzhFm`$sk5)>Q@`SZj^ntux;|dxuB*W&Uj*c; z1jKy+hgP?0=mbjxPFgk6^^TjjZ8d9aW^TP~&h1?#w>u^~Un*#N^Y{a}QrL zY5l}Xk96uJ8wA3^Gd1iGV+Eb}GB)_R@Y$fYpy|BST}2H=IVO!DKgvY4$>xV6#}}cR zkQZ418PsSDDCpjT3WZPSW81F8L=LNDAZox&6$#nN)DQoS40uBjA)|S+IH#I5REw&? z0a7jyHUp&%NwSo+T7Ico;nnziNv5izdGnQ6=2_~X5#K&L%mh1gsropzq756u!FR9= z&r(#BwGg(AU6@J+$SUosIha2+kPG5rEfyK1N=y4caIr`+TySX#rqMV<#4)8>z+A#W z3Aq`V3OC&tN798jCZ4v2_RboobpLlIn9FN96S&_mhSV0$e}$O%*#+&$3O( z^@rqcCdUUC3-$8#8mrNwcYpDQJTR^DpOw?(cPGAo&-+sEZ!2w*ixrwq=4SwzpkY(@ z&_p@W=eXi8=LmL(9yrrZ!AqwXtkWGDMmso+J{Jbg+|^PrTVsF`kV;bD3E1L9PS6SK z=O?FB`~=&cGu3(+j6Ro8o8bz` z!85mp&^M~iBU)ovvl1Mt;N~+m1=~FI`&k=+k9qa0>ABuP-n|iW)_{5oT;titd<2d- zq12QRqv-h8?Aeum_jj@CK-m;Rw`?bOZF>lU1;&h@R^FPKwh z(`h$pCG)n0-rVcYUvubtLgnVo>~XD6Z8Mo2jSHSjZ62EMLv^p`p3TE`|8hDvs(Q{Z zYmTo`_t&!P_v0^V2q|6plMkJ#_JgCVsjfL=d(iq$a(e>nJLy+}1E}=6;)pRCT^hpx z=}3_8jB=i7w1ksPdCp*OK_^260(ihys6vn#keR(_b;AGGv7} zsMCQ|rV?|{+}uwu!8?V(P%s8AENCkWPH$;w85h|&VY*Nd@B>33;ukK@i3q~x#KMrH zIZ_fUYj!!^1=YpP`M&7%vOp<oB$@JDx<&+A))0Jz~>h*p{ zsI#iqms1q=hcBJ6@XmJo^r9;gjry3?Zm$rDVPj+*8g6=!5aBbr96hWnUc}0@ zU}UUB?v-m*-&8%J`VmG+8~|rpH)ec2z|;!e@Bu>(fp8o+Yw@&kt|qOPw__l1gB@-m zwve<3bVV`ZK@Q*!tpGGZP*`<+ZCx$pUZUWRYF10m%F$4eBZWe}1``Gl`DmPhZP&&q z!!_PjgTheU9=B&G3ONGN;IRo1tB_@kU(5*d83z#YmOMKQ19{K3x2Im{nu;_89kEDA zuW3iZ9G8c+X-#9op^lDV(HN8Vq#&9C@!CAMD{oc6eMO;9!{o~o3Bm0&w3l9m)Pf&f zRW{z>asdYXY9V?xAi!NI^EuOM;xlzYZP+-Kh1_{nH37FfP*auXKGxB}p`|-CM!cPU zo~{1-%U#uo_IS9krsji*@?v)X#NF}@#pSuSC@Ylz;S;O{%(vlCt-EAQ5&P)w;u81M z`aFxrQ5+34UEUOkMspjdkFW7FliMgZ+*wm|XKhOS&fKylwbiO_DqDE;@p+}qblhAz z4-t;VKmM_Isdsh#PcPonm=}%aHS%4cnQfN;TwoJ?4C!nm4mg_Wvb9Bgb^tHw&sZyl z$Hx+2*X&YVt-3??7?;1XCQwL-8q8m9b)<%{ZS6IoGjvO)^WqpCaT-r`k$9L77=)ys z*0Jb$3^xc^)jU(LRukky1ksr^DuR53uo@AaPI;1QoSCslj0#aDFM#t;AEDyQF|Wtt zjj=iBoHN+CPJU_4N)}waI3LN2*EgxZW9#6nJ!c8XTE&xrSVw0p zH!n6}G6WDI)wf`Q@C(0XQRA~I|FeyY&3+s=JtMr&j|cs$cC55iMsn9qVo&ErCUit| zbE6#-BDrkVl6ZB6S+|6VjzB&u`p*szEBAC(RCFHh?oR!LeJo#D;ueE!y}YB!7isB! zVT!+@?l-A5W9#b!bImn|q6rIE&x+L4L}neuE*=Qz#UH&fVZs{|Qwu-b+SH|SyER=+ z8$YIFt;?mwv1Eb4`|r#;^}ykVr-bJ2e(wx*gtKmvYJUy9Qw9K7Rwy-)z7lrwT&jZm<+%7|kvAf~R?ER$J zFaFGEOnu6_j0S_}lM-F&BfKE!BO@L2~kRm+3yHr?;CCn&h(cM6Rr`>&b&ZHvWR zB+fR4Q!zmfg&{bzx0&#twyQ=?7e!A3T?F|u!>XuKEC?C1CGsNCItkQqK9(ux1_fEB zM>C=eRQa;1pfD7&SrO_EMZ93O+SX3`{owB3Pg-ZQScUYtxF>zSWU8GdTncvfBk*qr>xZF1t-VNG9xeqd> z31h`^tC8gy?uao;78$YwNh#t~;}0%gNDLlvA}f4fszrQ?oxCZ`c8Gn0zlMb_)iy_X zIF_3KGvT}$sUz$dyKbkvNoe13^N#(uuv^%YR7V))8Au%#)-D=r@(a&FCd{mfiroyFVNeqCU>qrZxaLwe8j*-c2 zvKWvIYsh&NJw|=*kwufdU4*PdBuG5=+@aM56s@W zb+&ZT?5!6HSG9HSerqSQ_II|WF7}7R?8z@4d+dwHgd6Y69Wy5PK0Nf%@aUNR zBPar~gR&sOs~JlGRNP<&Drg>I4Z!qqf)guJgZm^$V{l}@TqfZ zI5q)N7(!7Fy*TBCs4qec5rDWWb=%^xyxeHfl==;p7niq96QvuMF1h4A*W|J)`5pPA z(u#y5e`$U5dvCYJmoCs*&1FRke(}QUib-=4uAHF8@du%Pz^$ z>vfe?T0@~fH>}s@nzSUUah%Bs_?rJ3=KW(eiaVpvfS$_>tQrI=Yr`FZ;kZ&H& z?nDcseFe&#SqDznS&N*-AXHX{8Tm)o@C-NUqOL1mKA4@P2u*^3Xf}z1KC*GFElOfs9NMI zn8O;~evR4%%~g)e>C?h+rPk)8L~SfbTDw+by1ij`pkjq{{955BaZi1yEnq6Ny2j>r zUi-5mb*-z=*yYMyVs=H{@K>uIo(1qqK*OnK!ta~bB+w~jw}tYXcuvlBy3>3vH4=Ey zI0h-RHYmWQ#`sqq!o)6)I{>& zvV#bodyRQ{Rbx9ZgVDLPrFCXU>p1pdc9ULqtifx~&0oP{$5{BBapOvgz2B18&nzt| zinv@Bv!p()O~g|PA%&ra=mS+c-@<5>neds-EZ<`=TMY7DW}V(OphTiUNV3UE#6~7< zPNy_L%A1oxyoG!-R614X(fEZd8m0(n%gaK$(28O?}+`?G7v zra%2o(xH*{X-GQ+-3a(4O+OW3RH=l$XbM0wW>*0Xgm?1(R&PRkMtQ_wdRURv6D|}H zLZNWC#6NQh3%^5#2a~Lf1R8cAkS>pUQ*7Sl$*Ls_#<$F#U32TrH*VVa$mBJ>h2_gv zP1@dFTRST}{($^$UVd9$U8F;tHuZ6aq=Ibxu3gUugP}s4sQ>Zap@aGPg@xmb5*;<& zn|8h^UD7gbT3emNsJVIlx-p^+ZrekC@t6}L)^sD*a#&I$a7m!(d1Ws=lv+T4n&jX% za*+}oscqeeX#78^3xs%T`{2jBgqy_+2j3U&Lj8$mVTP%9<84;>|I`EfZ3(VdlQ)*e zC8hUjWpz{7JcRCpQAKx>o)Y3ES}GbRBTn2-L5k$14rhS60`eIGb;BT~6 z(CZC)*zusp6Z8(AENO09(A+G|N|aA)UeJ7?xwNF2O|3`>kFHA&u1Kz*q&1nflb5}@ zY_isD(z3(!dvi%?vy|th_bC5<(Oe?WDQ#{pWsjCLJ5#GF5`UtzKPlTpg>XB&x&DQ1 z+g_;OYu0K^`$|gonKW8+>gLQ-rAbur|yq$=ZoR~y3#^aB=%C-|g?SZg@QjkuR%X<@ z9cDAL6y|s&$z_aLn>0F&Cnu6?Fgn0%*mFF#bq=N+v z8wwe`O_{;6z@G1O$AdM6db2|?!RwblTkl7!l>*!cL`qHz;|PgS_0ez6rSh|v%T)D=1c4!uS2L>)Gl)6j5EaZ}5b_*i2s z7z&9NX0iHh0qK0^WExb3Sw*8+BhO(vz+CAJ0<#&A!3*6j$hSLu)|`MX&rql>Rgb;U zzw=|k9&NfPDDn=>RKkY=Qt5#o>1o(yY-@Ow^c7n+Hp`{ zjVrL06$qkH&+?p}d{$Br71LGX4bUt@MTW&65WyYUx3QFGndTT|oXl<&h z@OA2JIzg@1*4nI-qdHARPKP&-IkyJgYZm(*k)Tm5vHJzMurRCZM>?dC77ef>3buNQ zIR=b&9X$JBuMUXnzX=+hU}a{rMl!3RY%qyTI`NVz$LsOHbJ!s{rv_|Vhd$4PVT?}7 z4dyV`Y{sxQ*^S3#%p-3qoN8jjnT=^3)N_ zy!wf|#!pg*s=_&_R*um)b&{!|CO=@rBA3B|OCqj32n|IAkV0BvQCJRnF)D`1a2|t} zON_>(5UtQ&B}FhO3CKiH9fhK}l|h|Rrv^!)6UiBk(Nmo60DB3(Id#ZLmVslFR3*y= z!B%(E?yJJqXFuH6;tt9`l@GH;UDY=pxHKA(9IG$hd7wYYD#W+n_{qXC8*Uo>I~H_d z)^lG>pS5?(gi9thTi+88F}ekhSkfwhUH8PiovV7G5{Q zcv!fxs`Xs0W#_w#7vIs{X)!bPFW5ig#LlYM~ue%Ondf@LQPFGVK5yDu$0Q2 zb7znQxJ7j64927rNwNc}vF(>s#NQ9nmR%<#>4e)$Ma%F_Q8X{-rJ?jv55WHd2r%5r z12-SHlLiy_Dj$+6Fo2wKcmi>grV=xaX3xaRkn=}P-k-`p*CR@(y`rz89kv+#=jDIO zt0`^(IO>$uEV+6LaGd0xz5lUy?|(3Of|RoP`{eVj4uD#JN~wVX`ssIA*&X}jhf5oZ z^L#A1Zk?R;i9PhdUZt#%EeDXvhP-OQp;FsG+jPb~%&us&O!*`gViywtd*pvO2IwY$ zEad@S8ZkkcNPwB&Gq{nLAy?!>u?K z0@x^zw^GjNJq3PnD88}C>V!dgSW-4>K^%3cxh?6zc8D>=+?lEi&gii zt#;EFUzlz9l~pUhnoP>C@~imOX8z&}6Yuk+`um7;aA1V0B1FrGlxaBCLsrTN&%nwv zuh$iE)|j9$$l(?zz{UBvuHk9ZjUS+v=-p0JI?9vEh#uUu_#g>~+ z9I9~?Sc);H6@9T{GcKjxfaf1qdWNb;YZ*q{kflTx>V&W=dj{i|6Dpd{8f=Ac^VmA3 z8cfh7Zsla(9)`ofOcqqZQ+=8q=mXl}o2J63FNMHMl#qr2kUKF=083Dr9;AS1f$I{% z{UM42@jEmeLKqZjFdYVYFzC_r0P&*ZH5i)f951R}iT34VlQrj0X|hQ;ul4_`q6(R&HjxqyI1yQva2L&u&tVUoq#0+?C@u`5(4><-(Yfw69 zM)MgY7ZOL19zyU&Ah&3Dd5`+W%rw~x>1rsWDOzjI#D7EHj)J{%2hL6 zQDg6v;&!vCP%n6#M!&#JYI{Mbv37CP*jiXwpcf>6>5|so9R@4RJNPH4t$K1FRh@cB z^SOE&^vy)|DiM*o23BxYWJnH%w1eu-W1?9RFJA=tjV2?)$l)YI92>=@ zI&extAX4bUF`K-3Efl>9FbVRiuWbGgJjqzpE~ph`F9q5A7h99z#=R<_23WXl>EN@ zUvKTXCix&+Jav4zq_J2vnrnVpQC=>nEe6xLrJY;nB_F(UYT^cq3By2WYH8bIwg6<#(YQuf)_rLM zzK$}q^_cN>-x#%dR!?e6!0)II%z3JFLfoM#XsFcq0bns~ci0TAh!Z}(DhlC`L2#$6 z^$75%B*aC?NDN|WN2H^4!NV^+|L}ny7lwZ<-;sLd7+k!i__0?~PqL!>3%k1)esS>N z7wQ%{Fesn5;#bV~T{hvDsS^2vU#(zA2HBtUe<@>%LT5<2s7s)KK_nith{U35R8WUt z^#wh)2v8^h0aozV(XpD2)lf3UE7XwoB@09wkf>IyK^B_I8ah;85?s{XyP|tmv(3Iq zKJuCqDOQfM(p5#1yB95AFgLXMrTv@Ra^iliXHw^~ISUfynu(V!U(iw$@~8ol5SY|Z zYl+rOxuCg7t#QGo3AxBpS+{7}<()#TW#;^O)0^yeZ?(oZt!w+%>)3a?wzdRCOMZ^Q z@Sgl{=8xvEw~kvJI&<07-E%8l;hEFR_VzJR5bb#lQ@2dawL8Z&wY61QZI?{ZxF$^9 zxak|6Ia9jMSu}TI9efFv__f})cw>R!oq5@umV5{1k9gx%T5nTDRH%a8%nkqHzryxO zUf3=ko5Z;+3Z#Qt4r(|%{YBs^rZ6wkU$@L2Cl97RnY~5&<;jxF-RMMf>bHYgs8rClzow^(gBx zJF|h|PmAb+)*4}pNHNOVC=;lXfmA;ArKJ^z>_wS4P_8E(F6L++el!mtsiJotLDZL&koA%;!_`kmrnBt0xYObF z6~0_^F8Fe{st#1Z%ULpTX^wiV13>-COsED**bl=NE-u?zfMH z#mLsxp;cFw=9ZOu^Ylg$+P=!bxQTW572BL9cSn`o2x?(3Dsq>!l+G*MyS?}7kybl# z@BGT~F40+1Kfg*_F}-%lOn0!tH+%eQ=;k8-x3a5&v!lA|bME`x_p!T4^PK=oNJ9uA zY<82)hZHtp2}wvoNMlGs!ppq(?t5?Y=FLpzW50l~4IiaIDMri>u|-5gtcW!#(we3b z5h)_piY?-=h_PaeNU^rH@{7U$xihob1*|{c?wxz?x#ymH?z!ilduQg(On(+DsR!m| zvI_(*9-cGxqLsy^pFPrBnNyfPeaj>F;3XXkPmkZ5#$7r1XxxMtOO0s*NK6yS@RUxS zuD~B)p|oNm9PZ*i2d4-8^hPE%JqD)q@h59>`+i1p?5k&vf9;X>sozedb8W?$-;d*| z?Lg8{$DEn?c1jo>r=-G)lV3Y?{Hxf%TvU>w@P&;TzoVqy6Tx>raPIfPeTpAie~;mO8eXHHKb*@F z(Eji_kp2JX6WSl5SDb#<6Wd`wVDH4?8{K-TQQ@m+ zLS?IRY3i}F;_uj2pl75 zClU7|W+4OzMtv1JxRn2tGcyuK8(vLzQ~JZVj6V8c>NRG_K`5?Sq3f>$4Yj_BPe;0 z7vV-#dm`G2`Dwg^E;**HKnOnArk|1SS9vH0UMo}`A@3sBqv{&dc`Lmiz_>;X>^O){3BW5ywLa2(5ma&wXHpGX($ zhi!m^7}NR@xDJ($@#B0z19%aqP&F}J*hn4L0^o=C*TC|3luLdKOu1YfiG}g5-{g6jv|=T$m@&o zs6WABB9D)PS28mWAbI81ze`xF2P@cxGT8if&BNPG@*h z0G`uH#9Rl{f5dMF_LKd8|IXF6X-BkIXdOB96!v9amROKDoZOInIr(1dvee_L)9D@Q z=Q6d->Fkc|k?b378`_>|JA=0s-k*Cdza;-qVW2Qvc(K@5+*^FCeW3k`ju{=BJ09=c z)p>X4sVR%6d~xc))Tci-JZ;sq2d2F{ebe;EW^A2ta%RuW+RS4!e==*qtZlO%oZUJ5 zzS%#WvwzP0bG|hf`u16c)=+=7{@ty;pq$a zUwH3@#}_SLba>I@i{8Fy{zbbkdUA1L@w&y2U);XLTJl}omYlY9&C(-F-@UZ|(z`Bw zvwNWX$z_L@o$4`r-sqj$yS?|N<#U!_zWn&|pR8E5;`4o4-_E`#SI%E~3|FDwSbg*A z7uU>KQ(p6>Pn@{C{c`j2qnE#N#r7*+?Kk@$>VIYJv30Z74X-xZv@ zZdd27y}O>+^`qVWyASMsVE2jL-`mr@=g^+xHzaT9yWz+U@9f>V*WdfhzP^3K`%dxS zjoWTKQJPmew15Bp*Y(5tv*pF*d&{p?u$ijzeD!Gc9oa3b^5t4ztyX)t-d{gff2*;z zaoi{vYm8CjE5_*qmmM$<9BCGs1I@>qZ<$NXhs~%;)OyWcVq5kz zj&L?RuN+)*@F_R#Hr%JZJ>Iu`;qUTa3AP3=4{jZNX=u~XH->kNR7dxYK012(rp-4U zx#{(r*W7H~{Kzc>x4eC5;i17pj~sgO(2s6C_twE%A0At9_=mS0xqaI0qqjeI$DBKE zyyM|Jr`=h-^NCMS{q(DMeetgEerEJDU%ESe_ujjoxckj}`tN!A-dXpKe)tcghwy(? z%*NR~|AfK-r}ZO*zoPaihB_s25e@f0dDt^d7-KyVEO38xLj)(Z`M5(G(%@848;;-< zo;rOvg3~DbYy@Y({nZH0YO`oGg4?udbR>fDjRtx=f?v?^{k91Hy4Fo^;=3ao@s`Uj z?OLoLC7uiK($;G>Vjs|ET;r=KtcPP4t|Kf(i1XLtYb8?iK;1&T9ifi5hMSs>uR*K_ zzpdI1a9E2g(rb{~0o+yi?$kEG+f^#8Wipqp5AfLut}f~@luTXt#?Vr&Tir?Sg8sT8 zP4E9A&o)RRAxkK^3%I6ub)jW8+Tv>sq`Pn~VWZ_EsKtQ%4b^TgQvnp$S_6$cp$w-( z4f(+9cpgYX2i)!^sC1NMyn#F2!2~WAN-yyeYRq|eslI3xVu+O@&LySvwp-*h^?!q6xN^co7xCY1NIQAkw zt5ddQ{N5kc_Jq*nBOOH=uh7?UeOS9syGOfQ`>e({SCV+pK8;;iS>B$5{h{yyfvuHNWp}Ba?Hoq$WJnEwJX+GXsy@0RL(uK5$E~3SB zG2VrD2`>F!O5NDm)r0ff<@^)_zDTi(R?`~1$n7%v1a87zLH)EAbI_GEKv&Uv>;cJLv$;R(WmGz-A1?59dsvs zn(iWeewOZ`d+D=uAAOGQr(eMH1HVWQ&@a(Z?7V-FewiMkU!l*_7wBR7ReFSejUJ_6 zr^o0w@RG>i#8-oUi@r#|O;6JA&{Oog^d7VIM`WN~heV^W9s0liEAPCumoz$YSp zOh2Ljq@U7%(R+mV4A6hm8G0Y{KXz*2T6R*TL|SA7UI!_1c(F-A6a}vMicaiznkqgf zritldhM1|%7qi4{F-Oc5^TauLrsF)(CC(S~#RX!4__$aoE)d1fAg&VY#nobi*eEuMYs6-; zMQjz<~XMc8cr8F0ote5jTjvVxPECl*E3ai?a4jQ4v)kMNQO2L*T7+ z*c@Prmav2^9C1*%!V|s-#Gn`w!(v2?ikrmE;udj8+$zSzr^I1#o48%vp*@fZETg-7 zZ8yg~-Q97#EK2u8ac>kakKz?k+!w_wqj*&mua4riVcfGmj8~}mD%6vzo4V(vT7hR& z(w@}aN+T<+L225KOf``9lb)};IX;wR%kf8&fhXN$%`jV8zfm%Ew=RX>$S`bpzOb8V zSGMdynHjb1R>`okDz*bZVb^MD&!}6vnW)(Hl<(?ZBiXQ9G7E09q?>-yH(E03+IqE6 zwTCPd0Hd>UA{{u4OBq(#9?mVuWpr0S@R1aSdo@5-F%pE znYrwJJPBcX0D|>C6-mX zX}!t}p<&1=tA?NQ8oDb}m4<|dxWkH`FP&0ZuQZ2rw_2>}P+^?P#z2ylo^o^;0Sv=- zGBw*}@`56d6N*!mNXY}T;ulcQplgRMFUASggf_Emu4Pyem=BFep)+<<#l?ex zgi64KiQ5dTW{1VRiYuk%HEh2a6$`DR4Fy9eSJtf<)LqveQku+%ppqgR!hw?u0c8)H_@==0C=!gU#l&)`}#wk&{VY|jC%vU$tVDY62?7}bjLxvB#3>D8t z#%8Zlh0x+lsNA&^O*xXpX!f#^$X?NJ1g)}H3LI8kN0ef5Io+llNkcbldF5R~pOWDY zg^MVfhSh{|hCQ5d0e3%3CeV>OivF|0HycN!!4x`7(Xp&f+YfvZWG@Ih8e zjrY7V@vx%yc<_eFoFY(#Gf{)Haa+?N=X3x!RB7g6Vi+{6;A+D4yhNi~&6Z&eP@a`6 zOVi9(SgkcE)|a^ky0H{mw*q;*XA~4TZ7ODkObLy%bk-uLPQoY#9g|RjGr176fe*LK zGCkyC%r{cL?lrwMJSue7R(1_ptLUE0vE_#2Bvp6qz=2z_nkg7$P)(Pm4iAy21U|ab z8Ob@iqwL3UlAb;&bKEsCdk zTe8|T{Ctf?LM;a*M3< zf~sIPgxRAi{!E&wO0S7&BW>yqN6JwALd!05yVPhbME0)iEq5@m{ZO=g2!{QP)>;-C z6Vj$I`#$>j8{~9O4m&(V0it)&fsUsZAStf}K~go$5LTik8<{$0 zcSo;g;pUWGWO*&Y#o861Tnp^FnuU%rd+8=dP*t`mfk0+&}oBi3yY$@+znO zEXWI;wAV1CS#6Ienoyc4JVlk@USUIl;WeO97tT)d#4}u}!a+r|w(gT%B;25!Xu3m*vR~n4vTPe4vz^Khl}8|= z)6mNpk)__A)l4}z6F?W*k<4x#5}-16yR1L8T@442@X)z@CNu^v#TACdA`t||;-DUMaCk_l9+ qx{Kk=rVu5YQ9XR<GPS>b$X_& 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 z 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
V$fDV|Iw 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

!oRptb@n+ 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 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(''}),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 += ''; + + 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 += ''; + } + } + 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+='"}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 @@ + From a777ebcee6326bed2f7e99eedf6edbb922175e2d Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Tue, 15 Apr 2014 06:01:25 +0000 Subject: [PATCH 061/436] move the documentation to markdown Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- 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 @@ + + + +-
+- +- +-
+- +- +-
+- +- +- + +
+ +@@ -114,111 +72,7 @@ + {% block body %}{% endblock %} + + +- +
+-
+-
+- +- +-
+- +- +- +- +- +- +- +- +- +- +- +- +- + + + 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 @@ -
- - -
- - -
- - -
@@ -114,111 +72,7 @@ {% block body %}{% endblock %} -
-
-
- - -
- - - - - - - - - - - - - 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 @@ + \ 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 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 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(''}),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 += ''; + + 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 += ''; + } + } + 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+='"}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 @@ + From ac999a9cb2b0976e021aeb8825bb051df6bd0976 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Wed, 16 Apr 2014 10:53:12 +1000 Subject: [PATCH 062/436] now, with shiney markdown Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/articles.md | 8 + docs/sources/articles/baseimages.md | 60 + docs/sources/articles/runmetrics.md | 438 ++++++ docs/sources/articles/security.md | 258 ++++ docs/sources/contributing.md | 7 + docs/sources/contributing/contributing.md | 24 + docs/sources/contributing/devenvironment.md | 149 ++ docs/sources/examples.md | 25 + docs/sources/examples/apt-cacher-ng.md | 113 ++ .../examples/cfengine_process_management.md | 152 ++ docs/sources/examples/couchdb_data_volumes.md | 50 + docs/sources/examples/hello_world.md | 166 +++ docs/sources/examples/https.md | 109 ++ docs/sources/examples/mongodb.md | 89 ++ docs/sources/examples/nodejs_web_app.md | 204 +++ docs/sources/examples/postgresql_service.md | 157 +++ docs/sources/examples/python_web_app.md | 130 ++ .../sources/examples/running_redis_service.md | 95 ++ docs/sources/examples/running_riak_service.md | 138 ++ docs/sources/examples/running_ssh_service.md | 60 + docs/sources/examples/using_supervisord.md | 121 ++ docs/sources/faq.md | 218 +++ docs/sources/genindex.md | 1 + docs/sources/http-routingtable.md | 104 ++ docs/sources/installation.md | 25 + docs/sources/installation/amazon.md | 106 ++ docs/sources/installation/archlinux.md | 69 + docs/sources/installation/binaries.md | 104 ++ docs/sources/installation/cruxlinux.md | 95 ++ docs/sources/installation/fedora.md | 67 + docs/sources/installation/frugalware.md | 58 + docs/sources/installation/gentoolinux.md | 80 ++ docs/sources/installation/google.md | 64 + docs/sources/installation/mac.md | 180 +++ docs/sources/installation/openSUSE.md | 65 + docs/sources/installation/rackspace.md | 88 ++ docs/sources/installation/rhel.md | 80 ++ docs/sources/installation/softlayer.md | 37 + docs/sources/installation/ubuntulinux.md | 330 +++++ docs/sources/installation/windows.md | 72 + docs/sources/reference.md | 9 + docs/sources/reference/api.md | 100 ++ .../reference/api/docker_io_accounts_api.md | 355 +++++ .../reference/api/docker_io_oauth_api.md | 256 ++++ .../reference/api/docker_remote_api.md | 348 +++++ .../reference/api/docker_remote_api_v1.10.md | 1238 ++++++++++++++++ .../reference/api/docker_remote_api_v1.11.md | 1242 ++++++++++++++++ .../reference/api/docker_remote_api_v1.9.md | 1255 +++++++++++++++++ docs/sources/reference/api/index_api.md | 525 +++++++ docs/sources/reference/api/registry_api.md | 501 +++++++ .../reference/api/registry_index_spec.md | 691 +++++++++ .../api/remote_api_client_libraries.md | 89 ++ docs/sources/reference/builder.md | 510 +++++++ docs/sources/reference/commandline.md | 7 + docs/sources/reference/commandline/cli.md | 1170 +++++++++++++++ docs/sources/reference/run.md | 422 ++++++ docs/sources/search.md | 10 + docs/sources/terms.md | 13 + docs/sources/terms/container.md | 46 + docs/sources/terms/filesystem.md | 36 + docs/sources/terms/image.md | 40 + docs/sources/terms/layer.md | 35 + docs/sources/terms/registry.md | 20 + docs/sources/terms/repository.md | 39 + docs/sources/toctree.md | 17 + docs/sources/use.md | 13 + .../sources/use/ambassador_pattern_linking.md | 157 +++ docs/sources/use/basics.md | 180 +++ docs/sources/use/chef.md | 75 + docs/sources/use/host_integration.md | 63 + docs/sources/use/networking.md | 142 ++ docs/sources/use/port_redirection.md | 140 ++ docs/sources/use/puppet.md | 92 ++ docs/sources/use/working_with_links_names.md | 121 ++ docs/sources/use/working_with_volumes.md | 178 +++ docs/sources/use/workingwithrepository.md | 235 +++ 76 files changed, 14766 insertions(+) create mode 100644 docs/sources/articles.md create mode 100644 docs/sources/articles/baseimages.md create mode 100644 docs/sources/articles/runmetrics.md create mode 100644 docs/sources/articles/security.md create mode 100644 docs/sources/contributing.md create mode 100644 docs/sources/contributing/contributing.md create mode 100644 docs/sources/contributing/devenvironment.md create mode 100644 docs/sources/examples.md create mode 100644 docs/sources/examples/apt-cacher-ng.md create mode 100644 docs/sources/examples/cfengine_process_management.md create mode 100644 docs/sources/examples/couchdb_data_volumes.md create mode 100644 docs/sources/examples/hello_world.md create mode 100644 docs/sources/examples/https.md create mode 100644 docs/sources/examples/mongodb.md create mode 100644 docs/sources/examples/nodejs_web_app.md create mode 100644 docs/sources/examples/postgresql_service.md create mode 100644 docs/sources/examples/python_web_app.md create mode 100644 docs/sources/examples/running_redis_service.md create mode 100644 docs/sources/examples/running_riak_service.md create mode 100644 docs/sources/examples/running_ssh_service.md create mode 100644 docs/sources/examples/using_supervisord.md create mode 100644 docs/sources/faq.md create mode 100644 docs/sources/genindex.md create mode 100644 docs/sources/http-routingtable.md create mode 100644 docs/sources/installation.md create mode 100644 docs/sources/installation/amazon.md create mode 100644 docs/sources/installation/archlinux.md create mode 100644 docs/sources/installation/binaries.md create mode 100644 docs/sources/installation/cruxlinux.md create mode 100644 docs/sources/installation/fedora.md create mode 100644 docs/sources/installation/frugalware.md create mode 100644 docs/sources/installation/gentoolinux.md create mode 100644 docs/sources/installation/google.md create mode 100644 docs/sources/installation/mac.md create mode 100644 docs/sources/installation/openSUSE.md create mode 100644 docs/sources/installation/rackspace.md create mode 100644 docs/sources/installation/rhel.md create mode 100644 docs/sources/installation/softlayer.md create mode 100644 docs/sources/installation/ubuntulinux.md create mode 100644 docs/sources/installation/windows.md create mode 100644 docs/sources/reference.md create mode 100644 docs/sources/reference/api.md create mode 100644 docs/sources/reference/api/docker_io_accounts_api.md create mode 100644 docs/sources/reference/api/docker_io_oauth_api.md create mode 100644 docs/sources/reference/api/docker_remote_api.md create mode 100644 docs/sources/reference/api/docker_remote_api_v1.10.md create mode 100644 docs/sources/reference/api/docker_remote_api_v1.11.md create mode 100644 docs/sources/reference/api/docker_remote_api_v1.9.md create mode 100644 docs/sources/reference/api/index_api.md create mode 100644 docs/sources/reference/api/registry_api.md create mode 100644 docs/sources/reference/api/registry_index_spec.md create mode 100644 docs/sources/reference/api/remote_api_client_libraries.md create mode 100644 docs/sources/reference/builder.md create mode 100644 docs/sources/reference/commandline.md create mode 100644 docs/sources/reference/commandline/cli.md create mode 100644 docs/sources/reference/run.md create mode 100644 docs/sources/search.md create mode 100644 docs/sources/terms.md create mode 100644 docs/sources/terms/container.md create mode 100644 docs/sources/terms/filesystem.md create mode 100644 docs/sources/terms/image.md create mode 100644 docs/sources/terms/layer.md create mode 100644 docs/sources/terms/registry.md create mode 100644 docs/sources/terms/repository.md create mode 100644 docs/sources/toctree.md create mode 100644 docs/sources/use.md create mode 100644 docs/sources/use/ambassador_pattern_linking.md create mode 100644 docs/sources/use/basics.md create mode 100644 docs/sources/use/chef.md create mode 100644 docs/sources/use/host_integration.md create mode 100644 docs/sources/use/networking.md create mode 100644 docs/sources/use/port_redirection.md create mode 100644 docs/sources/use/puppet.md create mode 100644 docs/sources/use/working_with_links_names.md create mode 100644 docs/sources/use/working_with_volumes.md create mode 100644 docs/sources/use/workingwithrepository.md diff --git a/docs/sources/articles.md b/docs/sources/articles.md new file mode 100644 index 0000000000..da5a2d255f --- /dev/null +++ b/docs/sources/articles.md @@ -0,0 +1,8 @@ +# Articles + +## Contents: + +- [Docker Security](security/) +- [Create a Base Image](baseimages/) +- [Runtime Metrics](runmetrics/) + diff --git a/docs/sources/articles/baseimages.md b/docs/sources/articles/baseimages.md new file mode 100644 index 0000000000..d2d6336a6c --- /dev/null +++ b/docs/sources/articles/baseimages.md @@ -0,0 +1,60 @@ +page_title: Create a Base Image +page_description: How to create base images +page_keywords: Examples, Usage, base image, docker, documentation, examples + +# Create a Base Image + +So you want to create your own [*Base +Image*](../../terms/image/#base-image-def)? Great! + +The specific process will depend heavily on the Linux distribution you +want to package. We have some examples below, and you are encouraged to +submit pull requests to contribute new ones. + +## Create a full image using tar + +In general, you’ll want to start with a working machine that is running +the distribution you’d like to package as a base image, though that is +not required for some tools like Debian’s +[Debootstrap](https://wiki.debian.org/Debootstrap), which you can also +use to build Ubuntu images. + +It can be as simple as this to create an Ubuntu base image: + + $ sudo debootstrap raring raring > /dev/null + $ sudo tar -C raring -c . | sudo docker import - raring + a29c15f1bf7a + $ sudo docker run raring cat /etc/lsb-release + DISTRIB_ID=Ubuntu + DISTRIB_RELEASE=13.04 + DISTRIB_CODENAME=raring + DISTRIB_DESCRIPTION="Ubuntu 13.04" + +There are more example scripts for creating base images in the Docker +GitHub Repo: + +- [BusyBox](https://github.com/dotcloud/docker/blob/master/contrib/mkimage-busybox.sh) +- CentOS / Scientific Linux CERN (SLC) [on + Debian/Ubuntu](https://github.com/dotcloud/docker/blob/master/contrib/mkimage-rinse.sh) + or [on + CentOS/RHEL/SLC/etc.](https://github.com/dotcloud/docker/blob/master/contrib/mkimage-yum.sh) +- [Debian / + Ubuntu](https://github.com/dotcloud/docker/blob/master/contrib/mkimage-debootstrap.sh) + +## Creating a simple base image using `scratch` + +There is a special repository in the Docker registry called +`scratch`, which was created using an empty tar +file: + + $ tar cv --files-from /dev/null | docker import - scratch + +which you can `docker pull`. You can then use that +image to base your new minimal containers `FROM`: + + FROM scratch + ADD true-asm /true + CMD ["/true"] + +The Dockerfile above is from extremely minimal image - +[tianon/true](https://github.com/tianon/dockerfiles/tree/master/true). diff --git a/docs/sources/articles/runmetrics.md b/docs/sources/articles/runmetrics.md new file mode 100644 index 0000000000..9b09bb74df --- /dev/null +++ b/docs/sources/articles/runmetrics.md @@ -0,0 +1,438 @@ +page_title: Runtime Metrics +page_description: Measure the behavior of running containers +page_keywords: docker, metrics, CPU, memory, disk, IO, run, runtime + +# Runtime Metrics + +Linux Containers rely on [control +groups](https://www.kernel.org/doc/Documentation/cgroups/cgroups.txt) +which not only track groups of processes, but also expose metrics about +CPU, memory, and block I/O usage. You can access those metrics and +obtain network usage metrics as well. This is relevant for "pure" LXC +containers, as well as for Docker containers. + +## Control Groups + +Control groups are exposed through a pseudo-filesystem. In recent +distros, you should find this filesystem under +`/sys/fs/cgroup`. Under that directory, you will see +multiple sub-directories, called devices, freezer, blkio, etc.; each +sub-directory actually corresponds to a different cgroup hierarchy. + +On older systems, the control groups might be mounted on +`/cgroup`, without distinct hierarchies. In that +case, instead of seeing the sub-directories, you will see a bunch of +files in that directory, and possibly some directories corresponding to +existing containers. + +To figure out where your control groups are mounted, you can run: + + grep cgroup /proc/mounts + +## Enumerating Cgroups + +You can look into `/proc/cgroups` to see the +different control group subsystems known to the system, the hierarchy +they belong to, and how many groups they contain. + +You can also look at `/proc//cgroup` to see +which control groups a process belongs to. The control group will be +shown as a path relative to the root of the hierarchy mountpoint; e.g. +`/` means “this process has not been assigned into a +particular group”, while `/lxc/pumpkin` means that +the process is likely to be a member of a container named +`pumpkin`. + +## Finding the Cgroup for a Given Container + +For each container, one cgroup will be created in each hierarchy. On +older systems with older versions of the LXC userland tools, the name of +the cgroup will be the name of the container. With more recent versions +of the LXC tools, the cgroup will be `lxc/.` +.literal} + +For Docker containers using cgroups, the container name will be the full +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` +.literal}. You can look it up with `docker inspect` +or `docker ps -notrunc`. + +Putting everything together to look at the memory metrics for a Docker +container, take a look at +`/sys/fs/cgroup/memory/lxc//`. + +## Metrics from Cgroups: Memory, CPU, Block IO + +For each subsystem (memory, CPU, and block I/O), you will find one or +more pseudo-files containing statistics. + +### Memory Metrics: `memory.stat` + +Memory metrics are found in the "memory" cgroup. Note that the memory +control group adds a little overhead, because it does very fine-grained +accounting of the memory usage on your host. Therefore, many distros +chose to not enable it by default. Generally, to enable it, all you have +to do is to add some kernel command-line parameters: +`cgroup_enable=memory swapaccount=1`. + +The metrics are in the pseudo-file `memory.stat`. +Here is what it will look like: + + cache 11492564992 + rss 1930993664 + mapped_file 306728960 + pgpgin 406632648 + pgpgout 403355412 + swap 0 + pgfault 728281223 + pgmajfault 1724 + inactive_anon 46608384 + active_anon 1884520448 + inactive_file 7003344896 + active_file 4489052160 + unevictable 32768 + hierarchical_memory_limit 9223372036854775807 + hierarchical_memsw_limit 9223372036854775807 + total_cache 11492564992 + total_rss 1930993664 + total_mapped_file 306728960 + total_pgpgin 406632648 + total_pgpgout 403355412 + total_swap 0 + total_pgfault 728281223 + total_pgmajfault 1724 + total_inactive_anon 46608384 + total_active_anon 1884520448 + total_inactive_file 7003344896 + total_active_file 4489052160 + total_unevictable 32768 + +The first half (without the `total_` prefix) +contains statistics relevant to the processes within the cgroup, +excluding sub-cgroups. The second half (with the `total_` +prefix) includes sub-cgroups as well. + +Some metrics are "gauges", i.e. values that can increase or decrease +(e.g. swap, the amount of swap space used by the members of the cgroup). +Some others are "counters", i.e. values that can only go up, because +they represent occurrences of a specific event (e.g. pgfault, which +indicates the number of page faults which happened since the creation of +the cgroup; this number can never decrease). + +cache +: the amount of memory used by the processes of this control group + that can be associated precisely with a block on a block device. + When you read from and write to files on disk, this amount will + increase. This will be the case if you use "conventional" I/O + (`open`, `read`, + `write` syscalls) as well as mapped files (with + `mmap`). It also accounts for the memory used by + `tmpfs` mounts, though the reasons are unclear. +rss +: the amount of memory that *doesn’t* correspond to anything on disk: + stacks, heaps, and anonymous memory maps. +mapped\_file +: indicates the amount of memory mapped by the processes in the + control group. It doesn’t give you information about *how much* + memory is used; it rather tells you *how* it is used. +pgfault and pgmajfault +: indicate the number of times that a process of the cgroup triggered + a "page fault" and a "major fault", respectively. A page fault + happens when a process accesses a part of its virtual memory space + which is nonexistent or protected. The former can happen if the + process is buggy and tries to access an invalid address (it will + then be sent a `SIGSEGV` signal, typically + killing it with the famous `Segmentation fault` + message). The latter can happen when the process reads from a memory + zone which has been swapped out, or which corresponds to a mapped + file: in that case, the kernel will load the page from disk, and let + the CPU complete the memory access. It can also happen when the + process writes to a copy-on-write memory zone: likewise, the kernel + will preempt the process, duplicate the memory page, and resume the + write operation on the process’ own copy of the page. "Major" faults + happen when the kernel actually has to read the data from disk. When + it just has to duplicate an existing page, or allocate an empty + page, it’s a regular (or "minor") fault. +swap +: the amount of swap currently used by the processes in this cgroup. +active\_anon and inactive\_anon +: the amount of *anonymous* memory that has been identified has + respectively *active* and *inactive* by the kernel. "Anonymous" + memory is the memory that is *not* linked to disk pages. In other + words, that’s the equivalent of the rss counter described above. In + fact, the very definition of the rss counter is **active\_anon** + + **inactive\_anon** - **tmpfs** (where tmpfs is the amount of memory + used up by `tmpfs` filesystems mounted by this + control group). Now, what’s the difference between "active" and + "inactive"? Pages are initially "active"; and at regular intervals, + the kernel sweeps over the memory, and tags some pages as + "inactive". Whenever they are accessed again, they are immediately + retagged "active". When the kernel is almost out of memory, and time + comes to swap out to disk, the kernel will swap "inactive" pages. +active\_file and inactive\_file +: cache memory, with *active* and *inactive* similar to the *anon* + memory above. The exact formula is cache = **active\_file** + + **inactive\_file** + **tmpfs**. The exact rules used by the kernel + to move memory pages between active and inactive sets are different + from the ones used for anonymous memory, but the general principle + is the same. Note that when the kernel needs to reclaim memory, it + is cheaper to reclaim a clean (=non modified) page from this pool, + since it can be reclaimed immediately (while anonymous pages and + dirty/modified pages have to be written to disk first). +unevictable +: the amount of memory that cannot be reclaimed; generally, it will + account for memory that has been "locked" with `mlock` +. It is often used by crypto frameworks to make sure that + secret keys and other sensitive material never gets swapped out to + disk. +memory and memsw limits +: These are not really metrics, but a reminder of the limits applied + to this cgroup. The first one indicates the maximum amount of + physical memory that can be used by the processes of this control + group; the second one indicates the maximum amount of RAM+swap. + +Accounting for memory in the page cache is very complex. If two +processes in different control groups both read the same file +(ultimately relying on the same blocks on disk), the corresponding +memory charge will be split between the control groups. It’s nice, but +it also means that when a cgroup is terminated, it could increase the +memory usage of another cgroup, because they are not splitting the cost +anymore for those memory pages. + +### CPU metrics: `cpuacct.stat` + +Now that we’ve covered memory metrics, everything else will look very +simple in comparison. CPU metrics will be found in the +`cpuacct` controller. + +For each container, you will find a pseudo-file `cpuacct.stat` +.literal}, containing the CPU usage accumulated by the processes of the +container, broken down between `user` and +`system` time. If you’re not familiar with the +distinction, `user` is the time during which the +processes were in direct control of the CPU (i.e. executing process +code), and `system` is the time during which the CPU +was executing system calls on behalf of those processes. + +Those times are expressed in ticks of 1/100th of a second. Actually, +they are expressed in "user jiffies". There are `USER_HZ` +*"jiffies"* per second, and on x86 systems, +`USER_HZ` is 100. This used to map exactly to the +number of scheduler "ticks" per second; but with the advent of higher +frequency scheduling, as well as [tickless +kernels](http://lwn.net/Articles/549580/), the number of kernel ticks +wasn’t relevant anymore. It stuck around anyway, mainly for legacy and +compatibility reasons. + +### Block I/O metrics + +Block I/O is accounted in the `blkio` controller. +Different metrics are scattered across different files. While you can +find in-depth details in the +[blkio-controller](https://www.kernel.org/doc/Documentation/cgroups/blkio-controller.txt) +file in the kernel documentation, here is a short list of the most +relevant ones: + +blkio.sectors +: contain the number of 512-bytes sectors read and written by the + processes member of the cgroup, device by device. Reads and writes + are merged in a single counter. +blkio.io\_service\_bytes +: indicates the number of bytes read and written by the cgroup. It has + 4 counters per device, because for each device, it differentiates + between synchronous vs. asynchronous I/O, and reads vs. writes. +blkio.io\_serviced +: the number of I/O operations performed, regardless of their size. It + also has 4 counters per device. +blkio.io\_queued +: indicates the number of I/O operations currently queued for this + cgroup. In other words, if the cgroup isn’t doing any I/O, this will + be zero. Note that the opposite is not true. In other words, if + there is no I/O queued, it does not mean that the cgroup is idle + (I/O-wise). It could be doing purely synchronous reads on an + otherwise quiescent device, which is therefore able to handle them + immediately, without queuing. Also, while it is helpful to figure + out which cgroup is putting stress on the I/O subsystem, keep in + mind that is is a relative quantity. Even if a process group does + not perform more I/O, its queue size can increase just because the + device load increases because of other devices. + +## Network Metrics + +Network metrics are not exposed directly by control groups. There is a +good explanation for that: network interfaces exist within the context +of *network namespaces*. The kernel could probably accumulate metrics +about packets and bytes sent and received by a group of processes, but +those metrics wouldn’t be very useful. You want per-interface metrics +(because traffic happening on the local `lo` +interface doesn’t really count). But since processes in a single cgroup +can belong to multiple network namespaces, those metrics would be harder +to interpret: multiple network namespaces means multiple `lo` +interfaces, potentially multiple `eth0` +interfaces, etc.; so this is why there is no easy way to gather network +metrics with control groups. + +Instead we can gather network metrics from other sources: + +### IPtables + +IPtables (or rather, the netfilter framework for which iptables is just +an interface) can do some serious accounting. + +For instance, you can setup a rule to account for the outbound HTTP +traffic on a web server: + + iptables -I OUTPUT -p tcp --sport 80 + +There is no `-j` or `-g` flag, +so the rule will just count matched packets and go to the following +rule. + +Later, you can check the values of the counters, with: + + iptables -nxvL OUTPUT + +Technically, `-n` is not required, but it will +prevent iptables from doing DNS reverse lookups, which are probably +useless in this scenario. + +Counters include packets and bytes. If you want to setup metrics for +container traffic like this, you could execute a `for` +loop to add two `iptables` rules per +container IP address (one in each direction), in the `FORWARD` +chain. This will only meter traffic going through the NAT +layer; you will also have to add traffic going through the userland +proxy. + +Then, you will need to check those counters on a regular basis. If you +happen to use `collectd`, there is a nice plugin to +automate iptables counters collection. + +### Interface-level counters + +Since each container has a virtual Ethernet interface, you might want to +check directly the TX and RX counters of this interface. You will notice +that each container is associated to a virtual Ethernet interface in +your host, with a name like `vethKk8Zqi`. Figuring +out which interface corresponds to which container is, unfortunately, +difficult. + +But for now, the best way is to check the metrics *from within the +containers*. To accomplish this, you can run an executable from the host +environment within the network namespace of a container using **ip-netns +magic**. + +The `ip-netns exec` command will let you execute any +program (present in the host system) within any network namespace +visible to the current process. This means that your host will be able +to enter the network namespace of your containers, but your containers +won’t be able to access the host, nor their sibling containers. +Containers will be able to “see” and affect their sub-containers, +though. + +The exact format of the command is: + + ip netns exec + +For example: + + ip netns exec mycontainer netstat -i + +`ip netns` finds the "mycontainer" container by +using namespaces pseudo-files. Each process belongs to one network +namespace, one PID namespace, one `mnt` namespace, +etc., and those namespaces are materialized under +`/proc//ns/`. For example, the network +namespace of PID 42 is materialized by the pseudo-file +`/proc/42/ns/net`. + +When you run `ip netns exec mycontainer ...`, it +expects `/var/run/netns/mycontainer` to be one of +those pseudo-files. (Symlinks are accepted.) + +In other words, to execute a command within the network namespace of a +container, we need to: + +- Find out the PID of any process within the container that we want to + investigate; +- Create a symlink from `/var/run/netns/` + to `/proc//ns/net` +- Execute `ip netns exec ....` + +Please review [*Enumerating Cgroups*](#run-findpid) to learn how to find +the cgroup of a pprocess running in the container of which you want to +measure network usage. From there, you can examine the pseudo-file named +`tasks`, which containes the PIDs that are in the +control group (i.e. in the container). Pick any one of them. + +Putting everything together, if the "short ID" of a container is held in +the environment variable `$CID`, then you can do +this: + + TASKS=/sys/fs/cgroup/devices/$CID*/tasks + PID=$(head -n 1 $TASKS) + mkdir -p /var/run/netns + ln -sf /proc/$PID/ns/net /var/run/netns/$CID + ip netns exec $CID netstat -i + +## Tips for high-performance metric collection + +Note that running a new process each time you want to update metrics is +(relatively) expensive. If you want to collect metrics at high +resolutions, and/or over a large number of containers (think 1000 +containers on a single host), you do not want to fork a new process each +time. + +Here is how to collect metrics from a single process. You will have to +write your metric collector in C (or any language that lets you do +low-level system calls). You need to use a special system call, +`setns()`, which lets the current process enter any +arbitrary namespace. It requires, however, an open file descriptor to +the namespace pseudo-file (remember: that’s the pseudo-file in +`/proc//ns/net`). + +However, there is a catch: you must not keep this file descriptor open. +If you do, when the last process of the control group exits, the +namespace will not be destroyed, and its network resources (like the +virtual interface of the container) will stay around for ever (or until +you close that file descriptor). + +The right approach would be to keep track of the first PID of each +container, and re-open the namespace pseudo-file each time. + +## Collecting metrics when a container exits + +Sometimes, you do not care about real time metric collection, but when a +container exits, you want to know how much CPU, memory, etc. it has +used. + +Docker makes this difficult because it relies on `lxc-start` +.literal}, which carefully cleans up after itself, but it is still +possible. It is usually easier to collect metrics at regular intervals +(e.g. every minute, with the collectd LXC plugin) and rely on that +instead. + +But, if you’d still like to gather the stats when a container stops, +here is how: + +For each container, start a collection process, and move it to the +control groups that you want to monitor by writing its PID to the tasks +file of the cgroup. The collection process should periodically re-read +the tasks file to check if it’s the last process of the control group. +(If you also want to collect network statistics as explained in the +previous section, you should also move the process to the appropriate +network namespace.) + +When the container exits, `lxc-start` will try to +delete the control groups. It will fail, since the control group is +still in use; but that’s fine. You process should now detect that it is +the only one remaining in the group. Now is the right time to collect +all the metrics you need! + +Finally, your process should move itself back to the root control group, +and remove the container control group. To remove a control group, just +`rmdir` its directory. It’s counter-intuitive to +`rmdir` a directory as it still contains files; but +remember that this is a pseudo-filesystem, so usual rules don’t apply. +After the cleanup is done, the collection process can exit safely. diff --git a/docs/sources/articles/security.md b/docs/sources/articles/security.md new file mode 100644 index 0000000000..91fbb41c58 --- /dev/null +++ b/docs/sources/articles/security.md @@ -0,0 +1,258 @@ +page_title: Docker Security +page_description: Review of the Docker Daemon attack surface +page_keywords: Docker, Docker documentation, security + +# Docker Security + +> *Adapted from* [Containers & Docker: How Secure are +> They?](blogsecurity) + +There are three major areas to consider when reviewing Docker security: + +- the intrinsic security of containers, as implemented by kernel + namespaces and cgroups; +- the attack surface of the Docker daemon itself; +- the "hardening" security features of the kernel and how they + interact with containers. + +## Kernel Namespaces + +Docker containers are essentially LXC containers, and they come with the +same security features. When you start a container with +`docker run`, behind the scenes Docker uses +`lxc-start` to execute the Docker container. This +creates a set of namespaces and control groups for the container. Those +namespaces and control groups are not created by Docker itself, but by +`lxc-start`. This means that as the LXC userland +tools evolve (and provide additional namespaces and isolation features), +Docker will automatically make use of them. + +**Namespaces provide the first and most straightforward form of +isolation**: processes running within a container cannot see, and even +less affect, processes running in another container, or in the host +system. + +**Each container also gets its own network stack**, meaning that a +container doesn’t get a privileged access to the sockets or interfaces +of another container. Of course, if the host system is setup +accordingly, containers can interact with each other through their +respective network interfaces — just like they can interact with +external hosts. When you specify public ports for your containers or use +[*links*](../../use/working_with_links_names/#working-with-links-names) +then IP traffic is allowed between containers. They can ping each other, +send/receive UDP packets, and establish TCP connections, but that can be +restricted if necessary. From a network architecture point of view, all +containers on a given Docker host are sitting on bridge interfaces. This +means that they are just like physical machines connected through a +common Ethernet switch; no more, no less. + +How mature is the code providing kernel namespaces and private +networking? Kernel namespaces were introduced [between kernel version +2.6.15 and +2.6.26](http://lxc.sourceforge.net/index.php/about/kernel-namespaces/). +This means that since July 2008 (date of the 2.6.26 release, now 5 years +ago), namespace code has been exercised and scrutinized on a large +number of production systems. And there is more: the design and +inspiration for the namespaces code are even older. Namespaces are +actually an effort to reimplement the features of +[OpenVZ](http://en.wikipedia.org/wiki/OpenVZ) in such a way that they +could be merged within the mainstream kernel. And OpenVZ was initially +released in 2005, so both the design and the implementation are pretty +mature. + +## Control Groups + +Control Groups are the other key component of Linux Containers. They +implement resource accounting and limiting. They provide a lot of very +useful metrics, but they also help to ensure that each container gets +its fair share of memory, CPU, disk I/O; and, more importantly, that a +single container cannot bring the system down by exhausting one of those +resources. + +So while they do not play a role in preventing one container from +accessing or affecting the data and processes of another container, they +are essential to fend off some denial-of-service attacks. They are +particularly important on multi-tenant platforms, like public and +private PaaS, to guarantee a consistent uptime (and performance) even +when some applications start to misbehave. + +Control Groups have been around for a while as well: the code was +started in 2006, and initially merged in kernel 2.6.24. + +## Docker Daemon Attack Surface + +Running containers (and applications) with Docker implies running the +Docker daemon. This daemon currently requires root privileges, and you +should therefore be aware of some important details. + +First of all, **only trusted users should be allowed to control your +Docker daemon**. This is a direct consequence of some powerful Docker +features. Specifically, Docker allows you to share a directory between +the Docker host and a guest container; and it allows you to do so +without limiting the access rights of the container. This means that you +can start a container where the `/host` directory +will be the `/` directory on your host; and the +container will be able to alter your host filesystem without any +restriction. This sounds crazy? Well, you have to know that **all +virtualization systems allowing filesystem resource sharing behave the +same way**. Nothing prevents you from sharing your root filesystem (or +even your root block device) with a virtual machine. + +This has a strong security implication: if you instrument Docker from +e.g. a web server to provision containers through an API, you should be +even more careful than usual with parameter checking, to make sure that +a malicious user cannot pass crafted parameters causing Docker to create +arbitrary containers. + +For this reason, the REST API endpoint (used by the Docker CLI to +communicate with the Docker daemon) changed in Docker 0.5.2, and now +uses a UNIX socket instead of a TCP socket bound on 127.0.0.1 (the +latter being prone to cross-site-scripting attacks if you happen to run +Docker directly on your local machine, outside of a VM). You can then +use traditional UNIX permission checks to limit access to the control +socket. + +You can also expose the REST API over HTTP if you explicitly decide so. +However, if you do that, being aware of the abovementioned security +implication, you should ensure that it will be reachable only from a +trusted network or VPN; or protected with e.g. `stunnel` +and client SSL certificates. + +Recent improvements in Linux namespaces will soon allow to run +full-featured containers without root privileges, thanks to the new user +namespace. This is covered in detail +[here](http://s3hh.wordpress.com/2013/07/19/creating-and-using-containers-without-privilege/). +Moreover, this will solve the problem caused by sharing filesystems +between host and guest, since the user namespace allows users within +containers (including the root user) to be mapped to other users in the +host system. + +The end goal for Docker is therefore to implement two additional +security improvements: + +- map the root user of a container to a non-root user of the Docker + host, to mitigate the effects of a container-to-host privilege + escalation; +- allow the Docker daemon to run without root privileges, and delegate + operations requiring those privileges to well-audited sub-processes, + each with its own (very limited) scope: virtual network setup, + filesystem management, etc. + +Finally, if you run Docker on a server, it is recommended to run +exclusively Docker in the server, and move all other services within +containers controlled by Docker. Of course, it is fine to keep your +favorite admin tools (probably at least an SSH server), as well as +existing monitoring/supervision processes (e.g. NRPE, collectd, etc). + +## Linux Kernel Capabilities + +By default, Docker starts containers with a very restricted set of +capabilities. What does that mean? + +Capabilities turn the binary "root/non-root" dichotomy into a +fine-grained access control system. Processes (like web servers) that +just need to bind on a port below 1024 do not have to run as root: they +can just be granted the `net_bind_service` +capability instead. And there are many other capabilities, for almost +all the specific areas where root privileges are usually needed. + +This means a lot for container security; let’s see why! + +Your average server (bare metal or virtual machine) needs to run a bunch +of processes as root. Those typically include SSH, cron, syslogd; +hardware management tools (to e.g. load modules), network configuration +tools (to handle e.g. DHCP, WPA, or VPNs), and much more. A container is +very different, because almost all of those tasks are handled by the +infrastructure around the container: + +- SSH access will typically be managed by a single server running in + the Docker host; +- `cron`, when necessary, should run as a user + process, dedicated and tailored for the app that needs its + scheduling service, rather than as a platform-wide facility; +- log management will also typically be handed to Docker, or by + third-party services like Loggly or Splunk; +- hardware management is irrelevant, meaning that you never need to + run `udevd` or equivalent daemons within + containers; +- network management happens outside of the containers, enforcing + separation of concerns as much as possible, meaning that a container + should never need to perform `ifconfig`, + `route`, or ip commands (except when a container + is specifically engineered to behave like a router or firewall, of + course). + +This means that in most cases, containers will not need "real" root +privileges *at all*. And therefore, containers can run with a reduced +capability set; meaning that "root" within a container has much less +privileges than the real "root". For instance, it is possible to: + +- deny all "mount" operations; +- deny access to raw sockets (to prevent packet spoofing); +- deny access to some filesystem operations, like creating new device + nodes, changing the owner of files, or altering attributes + (including the immutable flag); +- deny module loading; +- and many others. + +This means that even if an intruder manages to escalate to root within a +container, it will be much harder to do serious damage, or to escalate +to the host. + +This won’t affect regular web apps; but malicious users will find that +the arsenal at their disposal has shrunk considerably! You can see [the +list of dropped capabilities in the Docker +code](https://github.com/dotcloud/docker/blob/v0.5.0/lxc_template.go#L97), +and a full list of available capabilities in [Linux +manpages](http://man7.org/linux/man-pages/man7/capabilities.7.html). + +Of course, you can always enable extra capabilities if you really need +them (for instance, if you want to use a FUSE-based filesystem), but by +default, Docker containers will be locked down to ensure maximum safety. + +## Other Kernel Security Features + +Capabilities are just one of the many security features provided by +modern Linux kernels. It is also possible to leverage existing, +well-known systems like TOMOYO, AppArmor, SELinux, GRSEC, etc. with +Docker. + +While Docker currently only enables capabilities, it doesn’t interfere +with the other systems. This means that there are many different ways to +harden a Docker host. Here are a few examples. + +- You can run a kernel with GRSEC and PAX. This will add many safety + checks, both at compile-time and run-time; it will also defeat many + exploits, thanks to techniques like address randomization. It + doesn’t require Docker-specific configuration, since those security + features apply system-wide, independently of containers. +- If your distribution comes with security model templates for LXC + containers, you can use them out of the box. For instance, Ubuntu + comes with AppArmor templates for LXC, and those templates provide + an extra safety net (even though it overlaps greatly with + capabilities). +- You can define your own policies using your favorite access control + mechanism. Since Docker containers are standard LXC containers, + there is nothing “magic” or specific to Docker. + +Just like there are many third-party tools to augment Docker containers +with e.g. special network topologies or shared filesystems, you can +expect to see tools to harden existing Docker containers without +affecting Docker’s core. + +## Conclusions + +Docker containers are, by default, quite secure; especially if you take +care of running your processes inside the containers as non-privileged +users (i.e. non root). + +You can add an extra layer of safety by enabling Apparmor, SELinux, +GRSEC, or your favorite hardening solution. + +Last but not least, if you see interesting security features in other +containerization systems, you will be able to implement them as well +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). diff --git a/docs/sources/contributing.md b/docs/sources/contributing.md new file mode 100644 index 0000000000..b311d13f8c --- /dev/null +++ b/docs/sources/contributing.md @@ -0,0 +1,7 @@ +# Contributing + +## Contents: + +- [Contributing to Docker](contributing/) +- [Setting Up a Dev Environment](devenvironment/) + diff --git a/docs/sources/contributing/contributing.md b/docs/sources/contributing/contributing.md new file mode 100644 index 0000000000..9e2ad19073 --- /dev/null +++ b/docs/sources/contributing/contributing.md @@ -0,0 +1,24 @@ +page_title: Contribution Guidelines +page_description: Contribution guidelines: create issues, conventions, pull requests +page_keywords: contributing, docker, documentation, help, guideline + +# Contributing to Docker + +Want to hack on Docker? Awesome! + +The repository includes [all the instructions you need to get +started](https://github.com/dotcloud/docker/blob/master/CONTRIBUTING.md). + +The [developer environment +Dockerfile](https://github.com/dotcloud/docker/blob/master/Dockerfile) +specifies the tools and versions used to test and build Docker. + +If you’re making changes to the documentation, see the +[README.md](https://github.com/dotcloud/docker/blob/master/docs/README.md). + +The [documentation environment +Dockerfile](https://github.com/dotcloud/docker/blob/master/docs/Dockerfile) +specifies the tools and versions used to build the Documentation. + +Further interesting details can be found in the [Packaging +hints](https://github.com/dotcloud/docker/blob/master/hack/PACKAGERS.md). diff --git a/docs/sources/contributing/devenvironment.md b/docs/sources/contributing/devenvironment.md new file mode 100644 index 0000000000..41c527cde5 --- /dev/null +++ b/docs/sources/contributing/devenvironment.md @@ -0,0 +1,149 @@ +page_title: Setting Up a Dev Environment +page_description: Guides on how to contribute to docker +page_keywords: Docker, documentation, developers, contributing, dev environment + +# Setting Up a Dev Environment + +To make it easier to contribute to Docker, we provide a standard +development environment. It is important that the same environment be +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 + +Docker’s build environment itself is a Docker container, so the first +step is to install Docker on your system. + +You can follow the [install instructions most relevant to your +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 + +Install `git`; honest, it’s very good. You can use +other ways to get the Docker source, but they’re not anywhere near as +easy. + +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 + + git clone http://git@github.com/dotcloud/docker + cd docker + +To checkout a different revision just use `git checkout` +with the name of branch or revision number. + +## Build the Environment + +This following command will build a development environment using the +Dockerfile in the current directory. Essentially, it will install all +the build and runtime dependencies necessary to build and test Docker. +This command will take some time to complete when you first execute it. + + sudo make build + +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 + +To create the Docker binary, run this command: + + sudo make binary + +This will create the Docker binary in +`./bundles/-dev/binary/` + +### Using your built Docker binary + +The binary is available outside the container in the directory +`./bundles/-dev/binary/`. You can swap your +host docker executable with this binary for live testing - for example, +on ubuntu: + + sudo service docker stop ; sudo cp $(which docker) $(which docker)_ ; sudo cp ./bundles/-dev/binary/docker--dev $(which docker);sudo service docker start + +Note + +Its safer to run the tests below before swapping your hosts docker +binary. + +## Run the Tests + +To execute the test cases, run this command: + + sudo make test + +If the test are successful then the tail of the output should look +something like this + + --- PASS: TestWriteBroadcaster (0.00 seconds) + === RUN TestRaceWriteBroadcaster + --- PASS: TestRaceWriteBroadcaster (0.00 seconds) + === RUN TestTruncIndex + --- PASS: TestTruncIndex (0.00 seconds) + === RUN TestCompareKernelVersion + --- PASS: TestCompareKernelVersion (0.00 seconds) + === RUN TestHumanSize + --- PASS: TestHumanSize (0.00 seconds) + === RUN TestParseHost + --- PASS: TestParseHost (0.00 seconds) + === RUN TestParseRepositoryTag + --- PASS: TestParseRepositoryTag (0.00 seconds) + === RUN TestGetResolvConf + --- PASS: TestGetResolvConf (0.00 seconds) + === RUN TestCheckLocalDns + --- PASS: TestCheckLocalDns (0.00 seconds) + === RUN TestParseRelease + --- PASS: TestParseRelease (0.00 seconds) + === RUN TestDependencyGraphCircular + --- PASS: TestDependencyGraphCircular (0.00 seconds) + === RUN TestDependencyGraph + --- PASS: TestDependencyGraph (0.00 seconds) + PASS + ok github.com/dotcloud/docker/utils 0.017s + +If $TESTFLAGS is set in the environment, it is passed as extra +arguments to ‘go test’. You can use this to select certain tests to run, +eg. + +> TESTFLAGS=’-run \^TestBuild\$’ make test + +If the output indicates "FAIL" and you see errors like this: + + server.go:1302 Error: Insertion failed because database is full: database or disk is full + + utils_test.go:179: Error copy: exit status 1 (cp: writing '/tmp/docker-testd5c9-[...]': No space left on device + +Then you likely don’t have enough memory available the test suite. 2GB +is recommended. + +## Use Docker + +You can run an interactive session in the newly built container: + + sudo make shell + + # type 'exit' or Ctrl-D to exit + +## 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 +by: + + sudo make docs + # when its done, you can point your browser to http://yourdockerhost:8000 + # type Ctrl-C to exit + +**Need More Help?** + +If you need more help then hop on to the [\#docker-dev IRC +channel](irc://chat.freenode.net#docker-dev) or post a message on the +[Docker developer mailing +list](https://groups.google.com/d/forum/docker-dev). diff --git a/docs/sources/examples.md b/docs/sources/examples.md new file mode 100644 index 0000000000..98b3d25893 --- /dev/null +++ b/docs/sources/examples.md @@ -0,0 +1,25 @@ + +# 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/) + diff --git a/docs/sources/examples/apt-cacher-ng.md b/docs/sources/examples/apt-cacher-ng.md new file mode 100644 index 0000000000..d81f9a4ec9 --- /dev/null +++ b/docs/sources/examples/apt-cacher-ng.md @@ -0,0 +1,113 @@ +page_title: Running an apt-cacher-ng service +page_description: Installing and running an apt-cacher-ng service +page_keywords: docker, example, package installation, networking, debian, ubuntu + +# Apt-Cacher-ng 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) +- **If you’re using OS X or docker via TCP** then you shouldn’t use + sudo + +When you have multiple Docker servers, or build unrelated Docker +containers which can’t make use of the Docker build cache, it can be +useful to have a caching proxy for your packages. This container makes +the second download of any package almost instant. + +Use the following Dockerfile: + + # + # Build: docker build -t apt-cacher . + # Run: docker run -d -p 3142:3142 --name apt-cacher-run apt-cacher + # + # and then you can run containers with: + # docker run -t -i --rm -e http_proxy http://dockerhost:3142/ debian bash + # + FROM ubuntu + MAINTAINER SvenDowideit@docker.com + + VOLUME ["/var/cache/apt-cacher-ng"] + RUN apt-get update ; apt-get install -yq apt-cacher-ng + + EXPOSE 3142 + CMD chmod 777 /var/cache/apt-cacher-ng ; /etc/init.d/apt-cacher-ng start ; tail -f /var/log/apt-cacher-ng/* + +To build the image using: + + $ sudo docker build -t eg_apt_cacher_ng . + +Then run it, mapping the exposed port to one on the host + + $ sudo docker run -d -p 3142:3142 --name test_apt_cacher_ng eg_apt_cacher_ng + +To see the logfiles that are ‘tailed’ in the default command, you can +use: + + $ sudo docker logs -f test_apt_cacher_ng + +To get your Debian-based containers to use the proxy, you can do one of +three things + +1. Add an apt Proxy setting + `echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/conf.d/01proxy` + +2. Set an environment variable: + `http_proxy=http://dockerhost:3142/` +3. Change your `sources.list` entries to start with + `http://dockerhost:3142/` + +**Option 1** injects the settings safely into your apt configuration in +a local version of a common base: + + FROM ubuntu + RUN echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/apt.conf.d/01proxy + RUN apt-get update ; apt-get install vim git + + # docker build -t my_ubuntu . + +**Option 2** is good for testing, but will break other HTTP clients +which obey `http_proxy`, such as `curl` +.literal}, `wget` and others: + + $ sudo docker run --rm -t -i -e http_proxy=http://dockerhost:3142/ debian bash + +**Option 3** is the least portable, but there will be times when you +might need to do it and you can do it from your `Dockerfile` +too. + +Apt-cacher-ng has some tools that allow you to manage the repository, +and they can be used by leveraging the `VOLUME` +instruction, and the image we built to run the service: + + $ sudo docker run --rm -t -i --volumes-from test_apt_cacher_ng eg_apt_cacher_ng bash + + $$ /usr/lib/apt-cacher-ng/distkill.pl + Scanning /var/cache/apt-cacher-ng, please wait... + Found distributions: + bla, taggedcount: 0 + 1. precise-security (36 index files) + 2. wheezy (25 index files) + 3. precise-updates (36 index files) + 4. precise (36 index files) + 5. wheezy-updates (18 index files) + + Found architectures: + 6. amd64 (36 index files) + 7. i386 (24 index files) + + WARNING: The removal action may wipe out whole directories containing + index files. Select d to see detailed list. + + (Number nn: tag distribution or architecture nn; 0: exit; d: show details; r: remove tagged; q: quit): q + +Finally, clean up after your test by stopping and removing the +container, and then removing the image. + + $ sudo docker stop test_apt_cacher_ng + $ sudo docker rm test_apt_cacher_ng + $ sudo docker rmi eg_apt_cacher_ng diff --git a/docs/sources/examples/cfengine_process_management.md b/docs/sources/examples/cfengine_process_management.md new file mode 100644 index 0000000000..45d6edcec4 --- /dev/null +++ b/docs/sources/examples/cfengine_process_management.md @@ -0,0 +1,152 @@ +page_title: Process Management with CFEngine +page_description: Managing containerized processes with CFEngine +page_keywords: cfengine, process, management, usage, docker, documentation + +# Process Management with CFEngine + +Create Docker containers with managed processes. + +Docker monitors one process in each running container and the container +lives or dies with that process. By introducing CFEngine inside Docker +containers, we can alleviate a few of the issues that may arise: + +- It is possible to easily start multiple processes within a + container, all of which will be managed automatically, with the + normal `docker run` command. +- If a managed process dies or crashes, CFEngine will start it again + within 1 minute. +- The container itself will live as long as the CFEngine scheduling + daemon (cf-execd) lives. With CFEngine, we are able to decouple the + life of the container from the uptime of the service it provides. + +## How it works + +CFEngine, together with the cfe-docker integration policies, are +installed as part of the Dockerfile. This builds CFEngine into our +Docker image. + +The Dockerfile’s `ENTRYPOINT` takes an arbitrary +amount of commands (with any desired arguments) as parameters. When we +run the Docker container these parameters get written to CFEngine +policies and CFEngine takes over to ensure that the desired processes +are running in the container. + +CFEngine scans the process table for the `basename` +of the commands given to the `ENTRYPOINT` and runs +the command to start the process if the `basename` +is not found. For example, if we start the container with +`docker run "/path/to/my/application parameters"`, +CFEngine will look for a process named `application` +and run the command. If an entry for `application` +is not found in the process table at any point in time, CFEngine will +execute `/path/to/my/application parameters` to +start the application once again. The check on the process table happens +every minute. + +Note that it is therefore important that the command to start your +application leaves a process with the basename of the command. This can +be made more flexible by making some minor adjustments to the CFEngine +policies, if desired. + +## Usage + +This example assumes you have Docker installed and working. We will +install and manage `apache2` and `sshd` +in a single container. + +There are three steps: + +1. Install CFEngine into the container. +2. Copy the CFEngine Docker process management policy into the + containerized CFEngine installation. +3. Start your application processes as part of the + `docker run` command. + +### Building the container image + +The first two steps can be done as part of a Dockerfile, as follows. + + FROM ubuntu + MAINTAINER Eystein Måløy Stenberg + + RUN apt-get -y install wget lsb-release unzip ca-certificates + + # install latest CFEngine + RUN wget -qO- http://cfengine.com/pub/gpg.key | apt-key add - + RUN echo "deb http://cfengine.com/pub/apt $(lsb_release -cs) main" > /etc/apt/sources.list.d/cfengine-community.list + RUN apt-get update + RUN apt-get install cfengine-community + + # install cfe-docker process management policy + RUN wget https://github.com/estenberg/cfe-docker/archive/master.zip -P /tmp/ && unzip /tmp/master.zip -d /tmp/ + RUN cp /tmp/cfe-docker-master/cfengine/bin/* /var/cfengine/bin/ + RUN cp /tmp/cfe-docker-master/cfengine/inputs/* /var/cfengine/inputs/ + RUN rm -rf /tmp/cfe-docker-master /tmp/master.zip + + # apache2 and openssh are just for testing purposes, install your own apps here + RUN apt-get -y install openssh-server apache2 + RUN mkdir -p /var/run/sshd + RUN echo "root:password" | chpasswd # need a password for ssh + + ENTRYPOINT ["/var/cfengine/bin/docker_processes_run.sh"] + +By saving this file as `Dockerfile` to a working +directory, you can then build your container with the docker build +command, e.g. `docker build -t managed_image`. + +### Testing the container + +Start the container with `apache2` and +`sshd` running and managed, forwarding a port to our +SSH instance: + + docker run -p 127.0.0.1:222:22 -d managed_image "/usr/sbin/sshd" "/etc/init.d/apache2 start" + +We now clearly see one of the benefits of the cfe-docker integration: it +allows to start several processes as part of a normal +`docker run` command. + +We can now log in to our new container and see that both +`apache2` and `sshd` are +running. We have set the root password to "password" in the Dockerfile +above and can use that to log in with ssh: + + ssh -p222 root@127.0.0.1 + + ps -ef + UID PID PPID C STIME TTY TIME CMD + root 1 0 0 07:48 ? 00:00:00 /bin/bash /var/cfengine/bin/docker_processes_run.sh /usr/sbin/sshd /etc/init.d/apache2 start + root 18 1 0 07:48 ? 00:00:00 /var/cfengine/bin/cf-execd -F + root 20 1 0 07:48 ? 00:00:00 /usr/sbin/sshd + root 32 1 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 34 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 35 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + www-data 36 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start + root 93 20 0 07:48 ? 00:00:00 sshd: root@pts/0 + root 105 93 0 07:48 pts/0 00:00:00 -bash + root 112 105 0 07:49 pts/0 00:00:00 ps -ef + +If we stop apache2, it will be started again within a minute by +CFEngine. + + service apache2 status + Apache2 is running (pid 32). + service apache2 stop + * Stopping web server apache2 ... waiting [ OK ] + service apache2 status + Apache2 is NOT running. + # ... wait up to 1 minute... + service apache2 status + Apache2 is running (pid 173). + +## Adapting to your applications + +To make sure your applications get managed in the same manner, there are +just two things you need to adjust from the above example: + +- In the Dockerfile used above, install your applications instead of + `apache2` and `sshd`. +- When you start the container with `docker run`, + specify the command line arguments to your applications rather than + `apache2` and `sshd`. + diff --git a/docs/sources/examples/couchdb_data_volumes.md b/docs/sources/examples/couchdb_data_volumes.md new file mode 100644 index 0000000000..de75276104 --- /dev/null +++ b/docs/sources/examples/couchdb_data_volumes.md @@ -0,0 +1,50 @@ +page_title: Sharing data between 2 couchdb databases +page_description: Sharing data between 2 couchdb databases +page_keywords: docker, example, package installation, networking, couchdb, data volumes + +# CouchDB 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) + +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 +different versions of CouchDB on the same data, etc. + +## Create first database + +Note that we’re marking `/var/lib/couchdb` as a data +volume. + + COUCH1=$(sudo docker run -d -p 5984 -v /var/lib/couchdb shykes/couchdb:2013-05-03) + +## Add data to the first database + +We’re assuming your Docker host is reachable at `localhost` +.literal}. If not, replace `localhost` with the +public IP of your Docker host. + + HOST=localhost + URL="http://$HOST:$(sudo docker port $COUCH1 5984 | grep -Po '\d+$')/_utils/" + echo "Navigate to $URL in your browser, and use the couch interface to add data" + +## Create second database + +This time, we’re requesting shared access to `$COUCH1` +.literal}‘s volumes. + + COUCH2=$(sudo docker run -d -p 5984 --volumes-from $COUCH1 shykes/couchdb:2013-05-03) + +## Browse data on the second database + + HOST=localhost + URL="http://$HOST:$(sudo docker port $COUCH2 5984 | grep -Po '\d+$')/_utils/" + echo "Navigate to $URL in your browser. You should see the same data as in the first database"'!' + +Congratulations, you are now running two Couchdb containers, completely +isolated from each other *except* for their data. diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md new file mode 100644 index 0000000000..c3058444a8 --- /dev/null +++ b/docs/sources/examples/hello_world.md @@ -0,0 +1,166 @@ +page_title: Hello world example +page_description: A simple hello world example with Docker +page_keywords: docker, example, hello world + +# Check your Docker installation + +This guide assumes you have a working installation of Docker. To check +your Docker install, run the following command: + + # Check that you have a working install + $ sudo docker info + +If you get `docker: command not found` or something +like `/var/lib/docker/repositories: permission denied` +you may have an incomplete Docker installation or insufficient +privileges to access docker on your machine. + +Please refer to [*Installation*](../../installation/#installation-list) +for installation instructions. + +## Hello World + +Note + +- This example assumes you have Docker running in daemon mode. For + more information please see [*Check your Docker + install*](#running-examples). +- **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) + +This is the most basic example available for using Docker. + +Download the small base image named `busybox`: + + # Download a busybox image + $ sudo docker pull busybox + +The `busybox` image is a minimal Linux system. You +can do the same with any number of other images, such as +`debian`, `ubuntu` or +`centos`. The images can be found and retrieved +using the [Docker index](http://index.docker.io). + + $ sudo docker run busybox /bin/echo hello world + +This command will run a simple `echo` command, that +will echo `hello world` back to the console over +standard out. + +**Explanation:** + +- **"sudo"** execute the following commands as user *root* +- **"docker run"** run a command in a new container +- **"busybox"** is the image we are running the command in. +- **"/bin/echo"** is the command we want to run in the container +- **"hello world"** is the input for the echo command + +**Video:** + +See the example in action + + + + + + +## Hello World Daemon + +Note + +- This example assumes you have Docker running in daemon mode. For + more information please see [*Check your Docker + install*](#running-examples). +- **If you don’t like sudo** then see [*Giving non-root + access*](../../installation/binaries/#dockergroup) + +And now for the most boring daemon ever written! + +We will use the Ubuntu image to run a simple hello world daemon that +will just print hello world to standard out every second. It will +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") + +We are going to run a simple hello world daemon in a new container made +from the `ubuntu` image. + +- **"sudo docker run -d "** run a command in a new container. We pass + "-d" so it runs as a daemon. +- **"ubuntu"** is the image we want to run the command inside of. +- **"/bin/sh -c"** is the command we want to run in the container +- **"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, we can use in future commands to see what is going on + with this process. + + + + 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. + + + + 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; + allows us to exit the attachment using Control-C without stopping + the container. +- **$container_id** The Id of the container we want to attach to. + +Exit from the container attachment by pressing Control-C. + + sudo docker ps + +Check the process list to make sure it is running. + +- **"docker ps"** this shows all running process managed by docker + + + + 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. + + + + sudo docker ps + +Make sure it is really stopped. + +**Video:** + +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: + +- [*Node.js Web App*](../nodejs_web_app/#nodejs-web-app) +- [*Redis Service*](../running_redis_service/#running-redis-service) +- [*SSH Daemon Service*](../running_ssh_service/#running-ssh-service) +- [*CouchDB + Service*](../couchdb_data_volumes/#running-couchdb-service) +- [*PostgreSQL Service*](../postgresql_service/#postgresql-service) +- [*Building an Image with MongoDB*](../mongodb/#mongodb-image) +- [*Python Web App*](../python_web_app/#python-web-app) + diff --git a/docs/sources/examples/https.md b/docs/sources/examples/https.md new file mode 100644 index 0000000000..30fd8f2ea9 --- /dev/null +++ b/docs/sources/examples/https.md @@ -0,0 +1,109 @@ +page_title: Docker HTTPS Setup +page_description: How to setup docker with https +page_keywords: docker, example, https, daemon + +# Running Docker with https + +By default, Docker runs via a non-networked Unix socket. It can also +optionally communicate using a HTTP socket. + +If you need Docker reachable via the network in a safe manner, you can +enable TLS by specifying the tlsverify flag and pointing Docker’s +tlscacert flag to a trusted CA certificate. + +In daemon mode, it will only allow connections from clients +authenticated by a certificate signed by that CA. In client mode, it +will only connect to servers with a certificate signed by that CA. + +Warning + +Using TLS and managing a CA is an advanced topic. Please make you self +familiar with openssl, x509 and tls before using it in production. + +## Create a CA, server and client keys with OpenSSL + +First, initialize the CA serial file and generate CA private and public +keys: + + $ echo 01 > ca.srl + $ openssl genrsa -des3 -out ca-key.pem + $ openssl req -new -x509 -days 365 -key ca-key.pem -out ca.pem + +Now that we have a CA, you can create a server key and certificate +signing request. Make sure that "Common Name (e.g. server FQDN or YOUR +name)" matches the hostname you will use to connect to Docker or just +use ‘\*’ for a certificate valid for any hostname: + + $ openssl genrsa -des3 -out server-key.pem + $ openssl req -new -key server-key.pem -out server.csr + +Next we’re going to sign the key with our CA: + + $ openssl x509 -req -days 365 -in server.csr -CA ca.pem -CAkey ca-key.pem \ + -out server-cert.pem + +For client authentication, create a client key and certificate signing +request: + + $ openssl genrsa -des3 -out client-key.pem + $ openssl req -new -key client-key.pem -out client.csr + +To make the key suitable for client authentication, create a extensions +config file: + + $ echo extendedKeyUsage = clientAuth > extfile.cnf + +Now sign the key: + + $ openssl x509 -req -days 365 -in client.csr -CA ca.pem -CAkey ca-key.pem \ + -out client-cert.pem -extfile extfile.cnf + +Finally you need to remove the passphrase from the client and server +key: + + $ openssl rsa -in server-key.pem -out server-key.pem + $ openssl rsa -in client-key.pem -out client-key.pem + +Now you can make the Docker daemon only accept connections from clients +providing a certificate trusted by our CA: + + $ sudo docker -d --tlsverify --tlscacert=ca.pem --tlscert=server-cert.pem --tlskey=server-key.pem \ + -H=0.0.0.0:4243 + +To be able to connect to Docker and validate its certificate, you now +need to provide your client keys, certificates and trusted CA: + + $ docker --tlsverify --tlscacert=ca.pem --tlscert=client-cert.pem --tlskey=client-key.pem \ + -H=dns-name-of-docker-host:4243 + +Warning + +As shown in the example above, you don’t have to run the +`docker` client with `sudo` or +the `docker` group when you use certificate +authentication. That means anyone with the keys can give any +instructions to your Docker daemon, giving them root access to the +machine hosting the daemon. Guard these keys as you would a root +password! + +## Other modes + +If you don’t want to have complete two-way authentication, you can run +Docker in various other modes by mixing the flags. + +### Daemon modes + +- tlsverify, tlscacert, tlscert, tlskey set: Authenticate clients +- tls, tlscert, tlskey: Do not authenticate clients + +### Client modes + +- tls: Authenticate server based on public/default CA pool +- tlsverify, tlscacert: Authenticate server based on given CA +- tls, tlscert, tlskey: Authenticate with client certificate, do not + authenticate server based on given CA +- tlsverify, tlscacert, tlscert, tlskey: Authenticate with client + certificate, authenticate server based on given CA + +The client will send its client certificate if found, so you just need +to drop your keys into \~/.docker/\.pem diff --git a/docs/sources/examples/mongodb.md b/docs/sources/examples/mongodb.md new file mode 100644 index 0000000000..6612bf3ce5 --- /dev/null +++ b/docs/sources/examples/mongodb.md @@ -0,0 +1,89 @@ +page_title: Building a Docker Image with MongoDB +page_description: How to build a Docker image with MongoDB pre-installed +page_keywords: docker, example, package installation, networking, mongodb + +# Building an Image with MongoDB + +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) + +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 +`Dockerfile` that downloads a base image, adds an +apt source and installs the database software on Ubuntu. + +## Creating a `Dockerfile` + +Create an empty file called `Dockerfile`: + + touch Dockerfile + +Next, define the parent image you want to use to build your own image on +top of. Here, we’ll use [Ubuntu](https://index.docker.io/_/ubuntu/) +(tag: `latest`) available on the [docker +index](http://index.docker.io): + + FROM ubuntu:latest + +Since we want to be running the latest version of MongoDB we’ll need to +add the 10gen repo to our apt sources list. + + # Add 10gen official apt source to the sources list + RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10 + RUN echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | tee /etc/apt/sources.list.d/10gen.list + +Then, we don’t want Ubuntu to complain about init not being available so +we’ll divert `/sbin/initctl` to +`/bin/true` so it thinks everything is working. + + # Hack for initctl not being available in Ubuntu + RUN dpkg-divert --local --rename --add /sbin/initctl + RUN ln -s /bin/true /sbin/initctl + +Afterwards we’ll be able to update our apt repositories and install +MongoDB + + # Install MongoDB + RUN apt-get update + RUN apt-get install mongodb-10gen + +To run MongoDB we’ll have to create the default data directory (because +we want it to run without needing to provide a special configuration +file) + + # Create the MongoDB data directory + RUN mkdir -p /data/db + +Finally, we’ll expose the standard port that MongoDB runs on, 27107, as +well as define an `ENTRYPOINT` instruction for the +container. + + EXPOSE 27017 + ENTRYPOINT ["usr/bin/mongod"] + +Now, lets build the image which will go through the +`Dockerfile` we made and run all of the commands. + + sudo docker build -t /mongodb . + +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) + + # Lean and mean + MONGO_ID=$(sudo docker run -d /mongodb --noprealloc --smallfiles) + + # Check the logs out + sudo docker logs $MONGO_ID + + # Connect and play around + mongo --port + +Sweet! diff --git a/docs/sources/examples/nodejs_web_app.md b/docs/sources/examples/nodejs_web_app.md new file mode 100644 index 0000000000..df43ad0b5e --- /dev/null +++ b/docs/sources/examples/nodejs_web_app.md @@ -0,0 +1,204 @@ +page_title: Running a Node.js app on CentOS +page_description: Installing and running a Node.js app on CentOS +page_keywords: docker, example, package installation, node, centos + +# Node.js Web App + +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) + +The goal of this example is to show you how you can build your own +Docker images from a parent image using a `Dockerfile` +. We will do that by making a simple Node.js hello world web +application running on CentOS. You can get the full source code at +[https://github.com/gasi/docker-node-hello](https://github.com/gasi/docker-node-hello). + +## Create Node.js app + +First, create a directory `src` where all the files +would live. Then create a `package.json` file that +describes your app and its dependencies: + + { + "name": "docker-centos-hello", + "private": true, + "version": "0.0.1", + "description": "Node.js Hello World app on CentOS using docker", + "author": "Daniel Gasienica ", + "dependencies": { + "express": "3.2.4" + } + } + +Then, create an `index.js` file that defines a web +app using the [Express.js](http://expressjs.com/) framework: + + var express = require('express'); + + // Constants + var PORT = 8080; + + // App + var app = express(); + app.get('/', function (req, res) { + res.send('Hello World\n'); + }); + + app.listen(PORT); + console.log('Running on http://localhost:' + PORT); + +In the next steps, we’ll look at how you can run this app inside a +CentOS container using Docker. First, you’ll need to build a Docker +image of your app. + +## Creating a `Dockerfile` + +Create an empty file called `Dockerfile`: + + touch Dockerfile + +Open the `Dockerfile` in your favorite text editor +and add the following line that defines the version of Docker the image +requires to build (this example uses Docker 0.3.4): + + # DOCKER-VERSION 0.3.4 + +Next, define the parent image you want to use to build your own image on +top of. Here, we’ll use [CentOS](https://index.docker.io/_/centos/) +(tag: `6.4`) available on the [Docker +index](https://index.docker.io/): + + FROM centos:6.4 + +Since we’re building a Node.js app, you’ll have to install Node.js as +well as npm on your CentOS image. Node.js is required to run your app +and npm to install your app’s dependencies defined in +`package.json`. To install the right package for +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 + # Install Node.js and npm + RUN yum install -y npm + +To bundle your app’s source code inside the Docker image, use the +`ADD` instruction: + + # Bundle app source + ADD . /src + +Install your app dependencies using the `npm` +binary: + + # Install app dependencies + RUN cd /src; npm install + +Your app binds to port `8080` so you’ll use the +`EXPOSE` instruction to have it mapped by the +`docker` daemon: + + EXPOSE 8080 + +Last but not least, define the command to run your app using +`CMD` which defines your runtime, i.e. +`node`, and the path to our app, i.e. +`src/index.js` (see the step where we added the +source to the container): + + CMD ["node", "/src/index.js"] + +Your `Dockerfile` should now look like this: + + # DOCKER-VERSION 0.3.4 + FROM centos:6.4 + + # Enable EPEL for Node.js + RUN rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm + # Install Node.js and npm + RUN yum install -y npm + + # Bundle app source + ADD . /src + # Install app dependencies + RUN cd /src; npm install + + EXPOSE 8080 + CMD ["node", "/src/index.js"] + +## Building your image + +Go to the directory that has your `Dockerfile` and +run the following command to build a Docker image. The `-t` +flag let’s you tag your image so it’s easier to find later +using the `docker images` command: + + sudo docker build -t /centos-node-hello . + +Your image will now be listed by Docker: + + sudo docker images + + > # Example + > REPOSITORY TAG ID CREATED + > centos 6.4 539c0211cd76 8 weeks ago + > gasi/centos-node-hello latest d64d3505b0d2 2 hours ago + +## Run the image + +Running your image with `-d` runs the container in +detached mode, leaving the container running in the background. The +`-p` flag redirects a public port to a private port +in the container. Run the image you previously built: + + sudo docker run -p 49160:8080 -d /centos-node-hello + +Print the output of your app: + + # Get container ID + sudo docker ps + + # Print app output + sudo docker logs + + > # Example + > Running on http://localhost:8080 + +## Test + +To test your app, get the the port of your app that Docker mapped: + + sudo docker ps + + > # Example + > ID IMAGE COMMAND ... PORTS + > ecce33b30ebf gasi/centos-node-hello:latest node /src/index.js 49160->8080 + +In the example above, Docker mapped the `8080` port +of the container to `49160`. + +Now you can call your app using `curl` (install if +needed via: `sudo apt-get install curl`): + + curl -i localhost:49160 + + > HTTP/1.1 200 OK + > X-Powered-By: Express + > Content-Type: text/html; charset=utf-8 + > Content-Length: 12 + > Date: Sun, 02 Jun 2013 03:53:22 GMT + > Connection: keep-alive + > + > Hello World + +We hope this tutorial helped you get up and running with Node.js and +CentOS on Docker. You can get the full source code at +[https://github.com/gasi/docker-node-hello](https://github.com/gasi/docker-node-hello). + +Continue to [*Redis +Service*](../running_redis_service/#running-redis-service). diff --git a/docs/sources/examples/postgresql_service.md b/docs/sources/examples/postgresql_service.md new file mode 100644 index 0000000000..a15d3c2ff0 --- /dev/null +++ b/docs/sources/examples/postgresql_service.md @@ -0,0 +1,157 @@ +page_title: PostgreSQL service How-To +page_description: Running and installing a PostgreSQL service +page_keywords: docker, example, package installation, postgresql + +# PostgreSQL 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) + +## Installing PostgreSQL on Docker + +Assuming there is no Docker image that suits your needs in [the +index](http://index.docker.io), you can create one yourself. + +Start by creating a new Dockerfile: + +Note + +This PostgreSQL setup is for development only purposes. Refer to the +PostgreSQL documentation to fine-tune these settings so that it is +suitably secure. + + # + # example Dockerfile for http://docs.docker.io/en/latest/examples/postgresql_service/ + # + + FROM ubuntu + MAINTAINER SvenDowideit@docker.com + + # 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 + + # Add PostgreSQL's repository. It contains the most recent stable release + # of PostgreSQL, ``9.3``. + RUN echo "deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main" > /etc/apt/sources.list.d/pgdg.list + + # Update the Ubuntu and PostgreSQL repository indexes + RUN apt-get update + + # Install ``python-software-properties``, ``software-properties-common`` and PostgreSQL 9.3 + # There are some warnings (in red) that show up during the build. You can hide + # them by prefixing each apt-get statement with DEBIAN_FRONTEND=noninteractive + RUN apt-get -y -q install python-software-properties software-properties-common + RUN apt-get -y -q install postgresql-9.3 postgresql-client-9.3 postgresql-contrib-9.3 + + # Note: The official Debian and Ubuntu images automatically ``apt-get clean`` + # after each ``apt-get`` + + # Run the rest of the commands as the ``postgres`` user created by the ``postgres-9.3`` package when it was ``apt-get installed`` + USER postgres + + # Create a PostgreSQL role named ``docker`` with ``docker`` as the password and + # then create a database `docker` owned by the ``docker`` role. + # Note: here we use ``&&\`` to run commands one after the other - the ``\`` + # allows the RUN command to span multiple lines. + RUN /etc/init.d/postgresql start &&\ + psql --command "CREATE USER docker WITH SUPERUSER PASSWORD 'docker';" &&\ + createdb -O docker docker + + # Adjust PostgreSQL configuration so that remote connections to the + # database are possible. + RUN echo "host all all 0.0.0.0/0 md5" >> /etc/postgresql/9.3/main/pg_hba.conf + + # And add ``listen_addresses`` to ``/etc/postgresql/9.3/main/postgresql.conf`` + RUN echo "listen_addresses='*'" >> /etc/postgresql/9.3/main/postgresql.conf + + # Expose the PostgreSQL port + EXPOSE 5432 + + # Add VOLUMEs to allow backup of config, logs and databases + VOLUME ["/etc/postgresql", "/var/log/postgresql", "/var/lib/postgresql"] + + # Set the default command to run when starting the container + CMD ["/usr/lib/postgresql/9.3/bin/postgres", "-D", "/var/lib/postgresql/9.3/main", "-c", "config_file=/etc/postgresql/9.3/main/postgresql.conf"] + +Build an image from the Dockerfile assign it a name. + + $ sudo docker build -t eg_postgresql . + +And run the PostgreSQL server container (in the foreground): + + $ 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), +or we can access it from our host (or the network). + +Note + +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 +`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 + + postgres@7ef98b1b7243:/$ psql -h $PG_PORT_5432_TCP_ADDR -p $PG_PORT_5432_TCP_PORT -d docker -U docker --password + +### Connecting from your host system + +Assuming you have the postgresql-client installed, you can use the +host-mapped port to test as well. You need to use `docker ps` +to find out what local host port the container is mapped to +first: + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 5e24362f27f6 eg_postgresql:latest /usr/lib/postgresql/ About an hour ago Up About an hour 0.0.0.0:49153->5432/tcp pg_test + $ psql -h localhost -p 49153 -d docker -U docker --password + +### Testing the database + +Once you have authenticated and have a `docker =#` +prompt, you can create a table and populate it. + + psql (9.3.1) + Type "help" for help. + + docker=# CREATE TABLE cities ( + docker(# name varchar(80), + docker(# location point + docker(# ); + CREATE TABLE + docker=# INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); + INSERT 0 1 + docker=# select * from cities; + name | location + ---------------+----------- + San Francisco | (-194,53) + (1 row) + +### Using the container volumes + +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 + + / # ls + bin etc lib linuxrc mnt proc run sys usr + dev home lib64 media opt root sbin tmp var + / # ls /etc/postgresql/9.3/main/ + environment pg_hba.conf postgresql.conf + pg_ctl.conf pg_ident.conf start.conf + /tmp # ls /var/log + ldconfig postgresql diff --git a/docs/sources/examples/python_web_app.md b/docs/sources/examples/python_web_app.md new file mode 100644 index 0000000000..4d727a0f78 --- /dev/null +++ b/docs/sources/examples/python_web_app.md @@ -0,0 +1,130 @@ +page_title: Python Web app example +page_description: Building your own python web app using docker +page_keywords: docker, example, python, web app + +# Python Web App + +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) + +While using Dockerfiles is the preferred way to create maintainable and +repeatable images, its useful to know how you can try things out and +then commit your live changes to an image. + +The goal of this example is to show you how you can modify your own +Docker images by making changes to a running container, and then saving +the results as a new image. We will do that by making a simple ‘hello +world’ Flask web application image. + +## Download the initial image + +Download the `shykes/pybuilder` Docker image from +the `http://index.docker.io` registry. + +This image contains a `buildapp` script to download +the web app and then `pip install` any required +modules, and a `runapp` script that finds the +`app.py` and runs it. + + $ sudo docker pull shykes/pybuilder + +Note + +This container was built with a very old version of docker (May 2013 - +see [shykes/pybuilder](https://github.com/shykes/pybuilder) ), when the +`Dockerfile` format was different, but the image can +still be used now. + +## Interactively make some modifications + +We then start a new container running interactively using the image. +First, we set a `URL` variable that points to a +tarball of a simple helloflask web app, and then we run a command +contained in the image called `buildapp`, passing it +the `$URL` variable. The container is given a name +`pybuilder_run` which we will use in the next steps. + +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 + + $$ URL=http://github.com/shykes/helloflask/archive/master.tar.gz + $$ /usr/local/bin/buildapp $URL + [...] + $$ exit + +## Commit the container to create a new image + +Save the changes we just made in the container to a new image called +`/builds/github.com/shykes/helloflask/master`. You +now have 3 different ways to refer to the container: name +`pybuilder_run`, short-id `c8b2e8228f11` +.literal}, or long-id +`c8b2e8228f11b8b3e492cbf9a49923ae66496230056d61e07880dc74c5f495f9` +.literal}. + + $ sudo docker commit pybuilder_run /builds/github.com/shykes/helloflask/master + c8b2e8228f11b8b3e492cbf9a49923ae66496230056d61e07880dc74c5f495f9 + +## Run the new image to start the web worker + +Use the new image to create a new container with network port 5000 +mapped to a local port + + $ sudo docker run -d -p 5000 --name web_worker /builds/github.com/shykes/helloflask/master /usr/local/bin/runapp + +- **"docker run -d "** run a command in a new container. We pass "-d" + so it runs as a daemon. +- **"-p 5000"** the web app is going to listen on this port, so it + must be mapped from the container to the host system. +- **/usr/local/bin/runapp** is the command which starts the web app. + +## View the container logs + +View the logs for the new `web_worker` container and +if everything worked as planned you should see the line +`Running on http://0.0.0.0:5000/` in the log output. + +To exit the view without stopping the container, hit Ctrl-C, or open +another terminal and continue with the example while watching the result +in the logs. + + $ sudo docker logs -f web_worker + * Running on http://0.0.0.0:5000/ + +## See the webapp output + +Look up the public-facing port which is NAT-ed. Find the private port +used by the container and store it inside of the `WEB_PORT` +variable. + +Access the web app using the `curl` binary. If +everything worked as planned you should see the line +`Hello world!` inside of your console. + + $ WEB_PORT=$(sudo docker port web_worker 5000 | awk -F: '{ print $2 }') + + # install curl if necessary, then ... + $ curl http://127.0.0.1:$WEB_PORT + Hello world! + +## Clean up example containers and images + + $ sudo docker ps --all + +List `--all` the Docker containers. If this +container had already finished running, it will still be listed here +with a status of ‘Exit 0’. + + $ sudo docker stop web_worker + $ sudo docker rm web_worker pybuilder_run + $ sudo docker rmi /builds/github.com/shykes/helloflask/master shykes/pybuilder:latest + +And now stop the running web worker, and delete the containers, so that +we can then delete the images that we used. diff --git a/docs/sources/examples/running_redis_service.md b/docs/sources/examples/running_redis_service.md new file mode 100644 index 0000000000..38892eeb55 --- /dev/null +++ b/docs/sources/examples/running_redis_service.md @@ -0,0 +1,95 @@ +page_title: Running a Redis service +page_description: Installing and running an redis service +page_keywords: docker, example, package installation, networking, redis + +# Redis 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) + +Very simple, no frills, Redis service attached to a web application +using a link. + +## Create a docker container for Redis + +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 + EXPOSE 6379 + ENTRYPOINT ["/usr/bin/redis-server"] + +Next we build an image from our `Dockerfile`. +Replace `` with your own user name. + + sudo docker build -t /redis . + +## Run the service + +Use the image we’ve just created and name your container +`redis`. + +Running the service with `-d` runs the container in +detached mode, leaving the container running in the background. + +Importantly, we’re not exposing any ports on our container. Instead +we’re going to use a container link to provide access to our Redis +database. + + sudo docker run --name redis -d /redis + +## 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 +`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 +running inside that container to only this container. + + sudo docker run --link redis:db -i -t ubuntu:12.10 /bin/bash + +Once inside our freshly created container we need to install Redis to +get the `redis-cli` binary to test our connection. + + apt-get update + apt-get -y install redis-server + service redis-server stop + +As we’ve used the `--link redis:db` option, Docker +has created some environment variables in our web application container. + + env | grep DB_ + + # Should return something similar to this with your values + DB_NAME=/violet_wolf/db + DB_PORT_6379_TCP_PORT=6379 + DB_PORT=tcp://172.17.0.33:6379 + DB_PORT_6379_TCP=tcp://172.17.0.33:6379 + DB_PORT_6379_TCP_ADDR=172.17.0.33 + DB_PORT_6379_TCP_PROTO=tcp + +We can see that we’ve got a small list of environment variables prefixed +with `DB`. The `DB` comes from +the link alias specified when we launched the container. Let’s use the +`DB_PORT_6379_TCP_ADDR` variable to connect to our +Redis container. + + redis-cli -h $DB_PORT_6379_TCP_ADDR + redis 172.17.0.33:6379> + redis 172.17.0.33:6379> set docker awesome + OK + redis 172.17.0.33:6379> get docker + "awesome" + redis 172.17.0.33:6379> exit + +We could easily use this or other environment variables in our web +application to make a connection to our `redis` +container. diff --git a/docs/sources/examples/running_riak_service.md b/docs/sources/examples/running_riak_service.md new file mode 100644 index 0000000000..dd8aa54c1d --- /dev/null +++ b/docs/sources/examples/running_riak_service.md @@ -0,0 +1,138 @@ +page_title: Running a Riak service +page_description: Build a Docker image with Riak pre-installed +page_keywords: docker, example, package installation, networking, riak + +# Riak 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) + +The goal of this example is to show you how to build a Docker image with +Riak pre-installed. + +## Creating a `Dockerfile` + +Create an empty file called `Dockerfile`: + + touch Dockerfile + +Next, define the parent image you want to use to build your image on top +of. We’ll use [Ubuntu](https://index.docker.io/_/ubuntu/) (tag: +`latest`), which is available on the [docker +index](http://index.docker.io): + + # Riak + # + # VERSION 0.1.0 + + # Use the Ubuntu base image provided by dotCloud + FROM ubuntu:latest + MAINTAINER Hector Castro hector@basho.com + +Next, we update the APT cache and apply any updates: + + # Update the APT cache + RUN sed -i.bak 's/main$/main universe/' /etc/apt/sources.list + RUN apt-get update + RUN apt-get upgrade -y + +After that, we install and setup a few dependencies: + +- `curl` is used to download Basho’s APT + repository key +- `lsb-release` helps us derive the Ubuntu release + codename +- `openssh-server` allows us to login to + containers remotely and join Riak nodes to form a cluster +- `supervisor` is used manage the OpenSSH and Riak + processes + + + + # Install and setup project dependencies + RUN apt-get install -y curl lsb-release supervisor openssh-server + + RUN mkdir -p /var/run/sshd + RUN mkdir -p /var/log/supervisor + + RUN locale-gen en_US en_US.UTF-8 + + ADD supervisord.conf /etc/supervisor/conf.d/supervisord.conf + + RUN echo 'root:basho' | chpasswd + +Next, we add Basho’s APT repository: + + RUN curl -s http://apt.basho.com/gpg/basho.apt.key | apt-key add -- + RUN echo "deb http://apt.basho.com $(lsb_release -cs) main" > /etc/apt/sources.list.d/basho.list + RUN apt-get update + +After that, we install Riak and alter a few defaults: + + # Install Riak and prepare it to run + RUN apt-get install -y riak + RUN sed -i.bak 's/127.0.0.1/0.0.0.0/' /etc/riak/app.config + RUN echo "ulimit -n 4096" >> /etc/default/riak + +Almost there. Next, we add a hack to get us by the lack of +`initctl`: + + # 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 + +Then, we expose the Riak Protocol Buffers and HTTP interfaces, along +with SSH: + + # Expose Riak Protocol Buffers and HTTP interfaces, along with SSH + EXPOSE 8087 8098 22 + +Finally, run `supervisord` so that Riak and OpenSSH +are started: + + CMD ["/usr/bin/supervisord"] + +## Create a `supervisord` configuration file + +Create an empty file called `supervisord.conf`. Make +sure it’s at the same directory level as your `Dockerfile` +.literal}: + + touch supervisord.conf + +Populate it with the following program definitions: + + [supervisord] + nodaemon=true + + [program:sshd] + command=/usr/sbin/sshd -D + stdout_logfile=/var/log/supervisor/%(program_name)s.log + stderr_logfile=/var/log/supervisor/%(program_name)s.log + autorestart=true + + [program:riak] + command=bash -c ". /etc/default/riak && /usr/sbin/riak console" + pidfile=/var/log/riak/riak.pid + stdout_logfile=/var/log/supervisor/%(program_name)s.log + stderr_logfile=/var/log/supervisor/%(program_name)s.log + +## Build the Docker image for Riak + +Now you should be able to build a Docker image for Riak: + + docker build -t "/riak" . + +## Next steps + +Riak is a distributed database. Many production deployments consist of +[at least five +nodes](http://basho.com/why-your-riak-cluster-should-have-at-least-five-nodes/). +See the [docker-riak](https://github.com/hectcastro/docker-riak) project +details on how to deploy a Riak cluster using Docker and Pipework. diff --git a/docs/sources/examples/running_ssh_service.md b/docs/sources/examples/running_ssh_service.md new file mode 100644 index 0000000000..112b9fa441 --- /dev/null +++ b/docs/sources/examples/running_ssh_service.md @@ -0,0 +1,60 @@ +page_title: Running an SSH service +page_description: Installing and running an sshd service +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) + +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 +quick access to a test container. + + # sshd + # + # VERSION 0.0.1 + + FROM ubuntu + MAINTAINER Thatcher R. Peskens "thatcher@dotcloud.com" + + # make sure the package repository is up to date + RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list + RUN apt-get update + + RUN apt-get install -y openssh-server + RUN mkdir /var/run/sshd + RUN echo 'root:screencast' |chpasswd + + EXPOSE 22 + CMD /usr/sbin/sshd -D + +Build the image using: + + $ sudo docker build -rm -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 port test_sshd 22 + 0.0.0.0:49154 + +And now you can ssh to port `49154` on the Docker +daemon’s host IP address (`ip address` or +`ifconfig` can tell you that): + + $ ssh root@192.168.1.2 -p 49154 + # The password is ``screencast``. + $$ + +Finally, clean up after your test by stopping and removing the +container, and then removing the image. + + $ sudo docker stop test_sshd + $ sudo docker rm test_sshd + $ sudo docker rmi eg_sshd diff --git a/docs/sources/examples/using_supervisord.md b/docs/sources/examples/using_supervisord.md new file mode 100644 index 0000000000..8545b0471f --- /dev/null +++ b/docs/sources/examples/using_supervisord.md @@ -0,0 +1,121 @@ +page_title: Using Supervisor with Docker +page_description: How to use Supervisor process management with Docker +page_keywords: docker, supervisor, process management + +# Using Supervisor with Docker + +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) + +Traditionally a Docker container runs a single process when it is +launched, for example an Apache daemon or a SSH server daemon. Often +though you want to run more than one process in a container. There are a +number of ways you can achieve this ranging from using a simple Bash +script as the value of your container’s `CMD` +instruction to installing a process management tool. + +In this example we’re going to make use of the process management tool, +[Supervisor](http://supervisord.org/), to manage multiple processes in +our container. Using Supervisor allows us to better control, manage, and +restart the processes we want to run. To demonstrate this we’re going to +install and manage both an SSH daemon and an Apache daemon. + +## Creating a Dockerfile + +Let’s start by creating a basic `Dockerfile` for our +new image. + + FROM ubuntu:latest + MAINTAINER examples@docker.io + RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list + RUN apt-get update + RUN apt-get upgrade -y + +## Installing Supervisor + +We can now install our SSH and Apache daemons as well as Supervisor in +our container. + + RUN apt-get install -y openssh-server apache2 supervisor + RUN mkdir -p /var/run/sshd + RUN mkdir -p /var/log/supervisor + +Here we’re installing the `openssh-server`, +`apache2` and `supervisor` +(which provides the Supervisor daemon) packages. We’re also creating two +new directories that are needed to run our SSH daemon and Supervisor. + +## Adding Supervisor’s configuration file + +Now let’s add a configuration file for Supervisor. The default file is +called `supervisord.conf` and is located in +`/etc/supervisor/conf.d/`. + + ADD supervisord.conf /etc/supervisor/conf.d/supervisord.conf + +Let’s see what is inside our `supervisord.conf` +file. + + [supervisord] + nodaemon=true + + [program:sshd] + command=/usr/sbin/sshd -D + + [program:apache2] + command=/bin/bash -c "source /etc/apache2/envvars && exec /usr/sbin/apache2 -DFOREGROUND" + +The `supervisord.conf` configuration file contains +directives that configure Supervisor and the processes it manages. The +first block `[supervisord]` provides configuration +for Supervisor itself. We’re using one directive, `nodaemon` +which tells Supervisor to run interactively rather than +daemonize. + +The next two blocks manage the services we wish to control. Each block +controls a separate process. The blocks contain a single directive, +`command`, which specifies what command to run to +start each process. + +## Exposing ports and running Supervisor + +Now let’s finish our `Dockerfile` by exposing some +required ports and specifying the `CMD` instruction +to start Supervisor when our container launches. + + EXPOSE 22 80 + CMD ["/usr/bin/supervisord"] + +Here we’ve exposed ports 22 and 80 on the container and we’re running +the `/usr/bin/supervisord` binary when the container +launches. + +## Building our container + +We can now build our new container. + + sudo docker build -t /supervisord . + +## Running our Supervisor container + +Once we’ve got a built image we can launch a container from it. + + sudo docker run -p 22 -p 80 -t -i /supervisord + 2013-11-25 18:53:22,312 CRIT Supervisor running as root (no user in config file) + 2013-11-25 18:53:22,312 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing + 2013-11-25 18:53:22,342 INFO supervisord started with pid 1 + 2013-11-25 18:53:23,346 INFO spawned: 'sshd' with pid 6 + 2013-11-25 18:53:23,349 INFO spawned: 'apache2' with pid 7 + . . . + +We’ve launched a new container interactively using the +`docker run` command. That container has run +Supervisor and launched the SSH and Apache daemons with it. We’ve +specified the `-p` flag to expose ports 22 and 80. +From here we can now identify the exposed ports and connect to one or +both of the SSH and Apache daemons. diff --git a/docs/sources/faq.md b/docs/sources/faq.md new file mode 100644 index 0000000000..17bb1ea8e7 --- /dev/null +++ b/docs/sources/faq.md @@ -0,0 +1,218 @@ +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. + +### What open source license are you using? + +> 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 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. + +### 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` +> .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 +differences](http://stackoverflow.com/questions/16047306/how-is-docker-io-different-from-a-normal-virtual-machine). + +### Do I lose my data when the container exits? + +Not at all! Any data that your application writes to disk gets preserved +in its container until you explicitly delete the container. The file +system for the container persists even after the container halts. + +### How far do Docker containers scale? + +Some of the largest server farms in the world today are based on +containers. Large web deployments like Google and Twitter, and platform +providers such as Heroku and dotCloud all run on container technology, +at a scale of hundreds of thousands or even millions of containers +running in parallel. + +### How do I connect Docker containers? + +Currently the recommended way to link containers is via the link +primitive. You can see details of how to [work with links +here](http://docs.docker.io/en/latest/use/working_with_links_names/). + +Also of useful when enabling more flexible service portability is the +[Ambassador linking +pattern](http://docs.docker.io/en/latest/use/ambassador_pattern_linking/). + +### How do I run more than one process in a Docker container? + +Any capable process supervisor such as +[http://supervisord.org/](http://supervisord.org/), runit, s6, or +daemontools can do the trick. Docker will start up the process +management daemon which will then fork to run additional processes. As +long as the processor manager daemon continues to run, the container +will continue to as well. You can see a more substantial example [that +uses supervisord +here](http://docs.docker.io/en/latest/examples/using_supervisord/). + +### What platforms does Docker run on? + +Linux: + +- Ubuntu 12.04, 13.04 et al +- Fedora 19/20+ +- RHEL 6.5+ +- Centos 6+ +- Gentoo +- ArchLinux +- openSUSE 12.3+ +- CRUX 3.0+ + +Cloud: + +- Amazon EC2 +- Google Compute Engine +- Rackspace + +### How do I report a security issue with Docker? + +You can learn about the project’s security policy +[here](http://www.docker.io/security/) and report security issues to +this [mailbox](mailto:security%40docker.com). + +### Why do I need to sign my commits to Docker with the DCO? + +Please read [our blog +post](http://blog.docker.io/2014/01/docker-code-contributions-require-developer-certificate-of-origin/) +on the introduction of the DCO. + +### Can I help by adding some questions and answers? + +Definitely! You can fork [the +repo](http://www.github.com/dotcloud/docker) and edit the documentation +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) + +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 new file mode 100644 index 0000000000..8b013d6a6b --- /dev/null +++ b/docs/sources/genindex.md @@ -0,0 +1 @@ +# Index diff --git a/docs/sources/http-routingtable.md b/docs/sources/http-routingtable.md new file mode 100644 index 0000000000..9fd78d03b5 --- /dev/null +++ b/docs/sources/http-routingtable.md @@ -0,0 +1,104 @@ +# HTTP Routing Table + +[**/api**](#cap-/api) | [**/auth**](#cap-/auth) | +[**/build**](#cap-/build) | [**/commit**](#cap-/commit) | +[**/containers**](#cap-/containers) | [**/events**](#cap-/events) | +[**/events:**](#cap-/events:) | [**/images**](#cap-/images) | +[**/info**](#cap-/info) | [**/v1**](#cap-/v1) | +[**/version**](#cap-/version) + + -- -------------------------------------------------------------------------------------------------------------------------------------------------------------------- ---- +   + **/api** + [`GET /api/v1.1/o/authorize/`](../reference/api/docker_io_oauth_api/#get--api-v1.1-o-authorize-) ** + [`POST /api/v1.1/o/token/`](../reference/api/docker_io_oauth_api/#post--api-v1.1-o-token-) ** + [`GET /api/v1.1/users/:username/`](../reference/api/docker_io_accounts_api/#get--api-v1.1-users--username-) ** + [`PATCH /api/v1.1/users/:username/`](../reference/api/docker_io_accounts_api/#patch--api-v1.1-users--username-) ** + [`GET /api/v1.1/users/:username/emails/`](../reference/api/docker_io_accounts_api/#get--api-v1.1-users--username-emails-) ** + [`PATCH /api/v1.1/users/:username/emails/`](../reference/api/docker_io_accounts_api/#patch--api-v1.1-users--username-emails-) ** + [`POST /api/v1.1/users/:username/emails/`](../reference/api/docker_io_accounts_api/#post--api-v1.1-users--username-emails-) ** + [`DELETE /api/v1.1/users/:username/emails/`](../reference/api/docker_io_accounts_api/#delete--api-v1.1-users--username-emails-) ** +   + **/auth** + [`GET /auth`](../reference/api/docker_remote_api/#get--auth) ** + [`POST /auth`](../reference/api/docker_remote_api_v1.9/#post--auth) ** +   + **/build** + [`POST /build`](../reference/api/docker_remote_api_v1.9/#post--build) ** +   + **/commit** + [`POST /commit`](../reference/api/docker_remote_api_v1.9/#post--commit) ** +   + **/containers** + [`DELETE /containers/(id)`](../reference/api/docker_remote_api_v1.9/#delete--containers-(id)) ** + [`POST /containers/(id)/attach`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-attach) ** + [`GET /containers/(id)/changes`](../reference/api/docker_remote_api_v1.9/#get--containers-(id)-changes) ** + [`POST /containers/(id)/copy`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-copy) ** + [`GET /containers/(id)/export`](../reference/api/docker_remote_api_v1.9/#get--containers-(id)-export) ** + [`GET /containers/(id)/json`](../reference/api/docker_remote_api_v1.9/#get--containers-(id)-json) ** + [`POST /containers/(id)/kill`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-kill) ** + [`POST /containers/(id)/restart`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-restart) ** + [`POST /containers/(id)/start`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-start) ** + [`POST /containers/(id)/stop`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-stop) ** + [`GET /containers/(id)/top`](../reference/api/docker_remote_api_v1.9/#get--containers-(id)-top) ** + [`POST /containers/(id)/wait`](../reference/api/docker_remote_api_v1.9/#post--containers-(id)-wait) ** + [`POST /containers/create`](../reference/api/docker_remote_api_v1.9/#post--containers-create) ** + [`GET /containers/json`](../reference/api/docker_remote_api_v1.9/#get--containers-json) ** +   + **/events** + [`GET /events`](../reference/api/docker_remote_api_v1.9/#get--events) ** +   + **/events:** + [`GET /events:`](../reference/api/docker_remote_api/#get--events-) ** +   + **/images** + [`GET /images/(format)`](../reference/api/archive/docker_remote_api_v1.6/#get--images-(format)) ** + [`DELETE /images/(name)`](../reference/api/docker_remote_api_v1.9/#delete--images-(name)) ** + [`GET /images/(name)/get`](../reference/api/docker_remote_api_v1.9/#get--images-(name)-get) ** + [`GET /images/(name)/history`](../reference/api/docker_remote_api_v1.9/#get--images-(name)-history) ** + [`POST /images/(name)/insert`](../reference/api/docker_remote_api_v1.9/#post--images-(name)-insert) ** + [`GET /images/(name)/json`](../reference/api/docker_remote_api_v1.9/#get--images-(name)-json) ** + [`POST /images/(name)/push`](../reference/api/docker_remote_api_v1.9/#post--images-(name)-push) ** + [`POST /images/(name)/tag`](../reference/api/docker_remote_api_v1.9/#post--images-(name)-tag) ** + [`POST /images//delete`](../reference/api/docker_remote_api/#post--images--name--delete) ** + [`POST /images/create`](../reference/api/docker_remote_api_v1.9/#post--images-create) ** + [`GET /images/json`](../reference/api/docker_remote_api_v1.9/#get--images-json) ** + [`POST /images/load`](../reference/api/docker_remote_api_v1.9/#post--images-load) ** + [`GET /images/search`](../reference/api/docker_remote_api_v1.9/#get--images-search) ** + [`GET /images/viz`](../reference/api/docker_remote_api/#get--images-viz) ** +   + **/info** + [`GET /info`](../reference/api/docker_remote_api_v1.9/#get--info) ** +   + **/v1** + [`GET /v1/_ping`](../reference/api/registry_api/#get--v1-_ping) ** + [`GET /v1/images/(image_id)/ancestry`](../reference/api/registry_api/#get--v1-images-(image_id)-ancestry) ** + [`GET /v1/images/(image_id)/json`](../reference/api/registry_api/#get--v1-images-(image_id)-json) ** + [`PUT /v1/images/(image_id)/json`](../reference/api/registry_api/#put--v1-images-(image_id)-json) ** + [`GET /v1/images/(image_id)/layer`](../reference/api/registry_api/#get--v1-images-(image_id)-layer) ** + [`PUT /v1/images/(image_id)/layer`](../reference/api/registry_api/#put--v1-images-(image_id)-layer) ** + [`PUT /v1/repositories/(namespace)/(repo_name)/`](../reference/api/index_api/#put--v1-repositories-(namespace)-(repo_name)-) ** + [`DELETE /v1/repositories/(namespace)/(repo_name)/`](../reference/api/index_api/#delete--v1-repositories-(namespace)-(repo_name)-) ** + [`PUT /v1/repositories/(namespace)/(repo_name)/auth`](../reference/api/index_api/#put--v1-repositories-(namespace)-(repo_name)-auth) ** + [`GET /v1/repositories/(namespace)/(repo_name)/images`](../reference/api/index_api/#get--v1-repositories-(namespace)-(repo_name)-images) ** + [`PUT /v1/repositories/(namespace)/(repo_name)/images`](../reference/api/index_api/#put--v1-repositories-(namespace)-(repo_name)-images) ** + [`DELETE /v1/repositories/(namespace)/(repository)/`](../reference/api/registry_api/#delete--v1-repositories-(namespace)-(repository)-) ** + [`GET /v1/repositories/(namespace)/(repository)/tags`](../reference/api/registry_api/#get--v1-repositories-(namespace)-(repository)-tags) ** + [`GET /v1/repositories/(namespace)/(repository)/tags/(tag)`](../reference/api/registry_api/#get--v1-repositories-(namespace)-(repository)-tags-(tag)) ** + [`PUT /v1/repositories/(namespace)/(repository)/tags/(tag)`](../reference/api/registry_api/#put--v1-repositories-(namespace)-(repository)-tags-(tag)) ** + [`DELETE /v1/repositories/(namespace)/(repository)/tags/(tag)`](../reference/api/registry_api/#delete--v1-repositories-(namespace)-(repository)-tags-(tag)) ** + [`PUT /v1/repositories/(repo_name)/`](../reference/api/index_api/#put--v1-repositories-(repo_name)-) ** + [`DELETE /v1/repositories/(repo_name)/`](../reference/api/index_api/#delete--v1-repositories-(repo_name)-) ** + [`PUT /v1/repositories/(repo_name)/auth`](../reference/api/index_api/#put--v1-repositories-(repo_name)-auth) ** + [`GET /v1/repositories/(repo_name)/images`](../reference/api/index_api/#get--v1-repositories-(repo_name)-images) ** + [`PUT /v1/repositories/(repo_name)/images`](../reference/api/index_api/#put--v1-repositories-(repo_name)-images) ** + [`GET /v1/search`](../reference/api/index_api/#get--v1-search) ** + [`GET /v1/users`](../reference/api/index_api/#get--v1-users) ** + [`POST /v1/users`](../reference/api/index_api/#post--v1-users) ** + [`PUT /v1/users/(username)/`](../reference/api/index_api/#put--v1-users-(username)-) ** +   + **/version** + [`GET /version`](../reference/api/docker_remote_api_v1.9/#get--version) ** + -- -------------------------------------------------------------------------------------------------------------------------------------------------------------------- ---- + + diff --git a/docs/sources/installation.md b/docs/sources/installation.md new file mode 100644 index 0000000000..0ee7b2f903 --- /dev/null +++ b/docs/sources/installation.md @@ -0,0 +1,25 @@ +# Installation + +## Introduction + +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: + +- [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/amazon.md b/docs/sources/installation/amazon.md new file mode 100644 index 0000000000..2dd6b91c40 --- /dev/null +++ b/docs/sources/installation/amazon.md @@ -0,0 +1,106 @@ +page_title: Installation on Amazon EC2 +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: amazon ec2, virtualization, cloud, docker, documentation, installation + +# Amazon EC2 + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +There are several ways to install Docker on AWS EC2: + +- [*Amazon QuickStart (Release Candidate - March + 2014)*](#amazonquickstart-new) or +- [*Amazon QuickStart*](#amazonquickstart) or +- [*Standard Ubuntu Installation*](#amazonstandard) + +**You’ll need an** [AWS account](http://aws.amazon.com/) **first, of +course.** + +## Amazon QuickStart + +1. **Choose an image:** + - Launch the [Create Instance + Wizard](https://console.aws.amazon.com/ec2/v2/home?#LaunchInstanceWizard:) + menu on your AWS Console. + - Click the `Select` button for a 64Bit Ubuntu + image. For example: Ubuntu Server 12.04.3 LTS + - For testing you can use the default (possibly free) + `t1.micro` instance (more info on + [pricing](http://aws.amazon.com/en/ec2/pricing/)). + - Click the `Next: Configure Instance Details` + button at the bottom right. + +2. **Tell CloudInit to install Docker:** + - When you’re on the "Configure Instance Details" step, expand the + "Advanced Details" section. + - Under "User data", select "As text". + - Enter `#include https://get.docker.io` into + the instance *User Data*. + [CloudInit](https://help.ubuntu.com/community/CloudInit) is part + of the Ubuntu image you chose; it will bootstrap Docker by + running the shell script located at this URL. + +3. After a few more standard choices where defaults are probably ok, + your AWS Ubuntu instance with Docker should be running! + +**If this is your first AWS instance, you may need to set up your +Security Group to allow SSH.** By default all incoming ports to your new +instance will be blocked by the AWS Security Group, so you might just +get timeouts when you try to connect. + +Installing with `get.docker.io` (as above) will +create a service named `lxc-docker`. It will also +set up a [*docker group*](../binaries/#dockergroup) and you may want to +add the *ubuntu* user to it so that you don’t have to use +`sudo` for every Docker command. + +Once you’ve got Docker installed, you’re ready to try it out – head on +over to the [*First steps with Docker*](../../use/basics/) or +[*Examples*](../../examples/) section. + +## Amazon QuickStart (Release Candidate - March 2014) + +Amazon just published new Docker-ready AMIs (2014.03 Release Candidate). +Docker packages can now be installed from Amazon’s provided Software +Repository. + +1. **Choose an image:** + - Launch the [Create Instance + Wizard](https://console.aws.amazon.com/ec2/v2/home?#LaunchInstanceWizard:) + menu on your AWS Console. + - Click the `Community AMI` menu option on the + left side + - Search for ‘2014.03’ and select one of the Amazon provided AMI, + for example `amzn-ami-pv-2014.03.rc-0.x86_64-ebs` + .literal} + - For testing you can use the default (possibly free) + `t1.micro` instance (more info on + [pricing](http://aws.amazon.com/en/ec2/pricing/)). + - Click the `Next: Configure Instance Details` + button at the bottom right. + +2. After a few more standard choices where defaults are probably ok, + your Amazon Linux instance should be running! +3. SSH to your instance to install Docker : + `ssh -i ec2-user@` + +4. Once connected to the instance, type + `sudo yum install -y docker ; sudo service docker start` + to install and start Docker + +## Standard Ubuntu Installation + +If you want a more hands-on installation, then you can follow the +[*Ubuntu*](../ubuntulinux/#ubuntu-linux) instructions installing Docker +on any EC2 instance running Ubuntu. Just follow Step 1 from [*Amazon +QuickStart*](#amazonquickstart) to pick an image (or use one of your +own) and skip the step with the *User Data*. Then continue with the +[*Ubuntu*](../ubuntulinux/#ubuntu-linux) instructions. + +Continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/archlinux.md b/docs/sources/installation/archlinux.md new file mode 100644 index 0000000000..ac0aea8a24 --- /dev/null +++ b/docs/sources/installation/archlinux.md @@ -0,0 +1,69 @@ +page_title: Installation on Arch Linux +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: arch linux, virtualization, docker, documentation, installation + +# Arch Linux + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Installing on Arch Linux can be handled via the package in community: + +- [docker](https://www.archlinux.org/packages/community/x86_64/docker/) + +or the following AUR package: + +- [docker-git](https://aur.archlinux.org/packages/docker-git/) + +The docker package will install the latest tagged version of docker. The +docker-git package will build from the current master branch. + +## Dependencies + +Docker depends on several packages which are specified as dependencies +in the packages. The core dependencies are: + +- bridge-utils +- device-mapper +- iproute2 +- lxc +- sqlite + +## Installation + +For the normal package a simple + + pacman -S docker + +is all that is needed. + +For the AUR package execute: + + yaourt -S docker-git + +The instructions here assume **yaourt** is installed. See [Arch User +Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages) +for information on building and installing packages from the AUR if you +have not done so before. + +## Starting Docker + +There is a systemd service unit created for docker. To start the docker +service: + + sudo systemctl start docker + +To start on system boot: + + sudo systemctl enable docker diff --git a/docs/sources/installation/binaries.md b/docs/sources/installation/binaries.md new file mode 100644 index 0000000000..dbe79c983c --- /dev/null +++ b/docs/sources/installation/binaries.md @@ -0,0 +1,104 @@ +page_title: Installation from Binaries +page_description: This instruction set is meant for hackers who want to try out Docker on a variety of environments. +page_keywords: binaries, installation, docker, documentation, linux + +# Binaries + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +**This instruction set is meant for hackers who want to try out Docker +on a variety of environments.** + +Before following these directions, you should really check if a packaged +version of Docker is already available for your distribution. We have +packages for many distributions, and more keep showing up all the time! + +## Check runtime dependencies + +To run properly, docker needs the following software to be installed at +runtime: + +- iptables version 1.4 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 + +Docker in daemon mode has specific kernel requirements. For details, +check your distribution in [*Installation*](../#installation-list). + +In general, a 3.8 Linux kernel (or higher) is preferred, as some of the +prior versions have known issues that are triggered by Docker. + +Note that Docker also has a client mode, which can run on virtually any +Linux kernel (it even builds on OSX!). + +## Get the docker binary: + + wget https://get.docker.io/builds/Linux/x86_64/docker-latest -O docker + chmod +x docker + +Note + +If you have trouble downloading the binary, you can also get the smaller +compressed release file: +[https://get.docker.io/builds/Linux/x86\_64/docker-latest.tgz](https://get.docker.io/builds/Linux/x86_64/docker-latest.tgz) + +## Run the docker daemon + + # start the docker in daemon mode from the directory you unpacked + sudo ./docker -d & + +## Giving non-root access + +The `docker` daemon always runs as the root user, +and since Docker version 0.5.2, the `docker` daemon +binds to a Unix socket instead of a TCP port. By default that Unix +socket is owned by the user *root*, and so, by default, you can access +it with `sudo`. + +Starting in version 0.5.3, if you (or your Docker installer) create a +Unix group called *docker* and add users to it, then the +`docker` daemon will make the ownership of the Unix +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. + +Warning + +The *docker* group (or the group specified with `-G` +.literal}) is root-equivalent; see [*Docker Daemon Attack +Surface*](../../articles/security/#dockersecurity-daemon) details. + +## Upgrades + +To upgrade your manual installation of Docker, first kill the docker +daemon: + + killall docker + +Then follow the regular installation steps. + +## Run your first container! + + # check your docker version + sudo ./docker version + + # run a container and open an interactive shell in the container + sudo ./docker run -i -t ubuntu /bin/bash + +Continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/cruxlinux.md b/docs/sources/installation/cruxlinux.md new file mode 100644 index 0000000000..92b85cfcbc --- /dev/null +++ b/docs/sources/installation/cruxlinux.md @@ -0,0 +1,95 @@ +page_title: Installation on CRUX Linux +page_description: Docker installation on CRUX Linux. +page_keywords: crux linux, virtualization, Docker, documentation, installation + +# CRUX Linux + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Installing on CRUX Linux can be handled via the ports from [James +Mills](http://prologic.shortcircuit.net.au/): + +- [docker](https://bitbucket.org/prologic/ports/src/tip/docker/) +- [docker-bin](https://bitbucket.org/prologic/ports/src/tip/docker-bin/) +- [docker-git](https://bitbucket.org/prologic/ports/src/tip/docker-git/) + +The `docker` port will install the latest tagged +version of Docker. The `docker-bin` port will +install the latest tagged versin of Docker from upstream built binaries. +The `docker-git` package will build from the current +master branch. + +## Installation + +For the time being (*until the CRUX Docker port(s) get into the official +contrib repository*) you will need to install [James +Mills’](https://bitbucket.org/prologic/ports) ports repository. You can +do so via: + +Download the `httpup` file to +`/etc/ports/`: + + curl -q -o - http://crux.nu/portdb/?a=getup&q=prologic > /etc/ports/prologic.httpup + +Add `prtdir /usr/ports/prologic` to +`/etc/prt-get.conf`: + + vim /etc/prt-get.conf + + # or: + echo "prtdir /usr/ports/prologic" >> /etc/prt-get.conf + +Update ports and prt-get cache: + + ports -u + prt-get cache + +To install (*and its dependencies*): + + prt-get depinst docker + +Use `docker-bin` for the upstream binary or +`docker-git` to build and install from the master +branch from git. + +## Kernel Requirements + +To have a working **CRUX+Docker** Host you must ensure your Kernel has +the necessary modules enabled for LXC containers to function correctly +and Docker Daemon to work properly. + +Please read the `README.rst`: + + prt-get readme docker + +There is a `test_kernel_config.sh` script in the +above ports which you can use to test your Kernel configuration: + + cd /usr/ports/prologic/docker + ./test_kernel_config.sh /usr/src/linux/.config + +## Starting Docker + +There is a rc script created for Docker. To start the Docker service: + + sudo su - + /etc/rc.d/docker start + +To start on system boot: + +- Edit `/etc/rc.conf` +- Put `docker` into the `SERVICES=(...)` + array after `net`. + diff --git a/docs/sources/installation/fedora.md b/docs/sources/installation/fedora.md new file mode 100644 index 0000000000..0a3f9de438 --- /dev/null +++ b/docs/sources/installation/fedora.md @@ -0,0 +1,67 @@ +page_title: Installation on Fedora +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux + +# Fedora + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Docker is available in **Fedora 19 and later**. Please note that due to +the current Docker limitations Docker is able to run only on the **64 +bit** architecture. + +## Installation + +The `docker-io` package provides Docker on Fedora. + +If you have the (unrelated) `docker` package +installed already, it will conflict with `docker-io` +.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. + + 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`. + + sudo yum -y install wmdocker + sudo yum -y remove docker + +Install the `docker-io` package which will install +Docker on our host. + + sudo yum -y install docker-io + +To update the `docker-io` package: + + sudo yum -y update docker-io + +Now that it’s installed, let’s start the Docker daemon. + + sudo systemctl start docker + +If we want Docker to start at boot, we should also: + + sudo systemctl enable docker + +Now let’s verify that Docker is working. + + sudo docker run -i -t fedora /bin/bash + +**Done!**, now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/frugalware.md b/docs/sources/installation/frugalware.md new file mode 100644 index 0000000000..45bba0619f --- /dev/null +++ b/docs/sources/installation/frugalware.md @@ -0,0 +1,58 @@ +page_title: Installation on FrugalWare +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: frugalware linux, virtualization, docker, documentation, installation + +# FrugalWare + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Installing on FrugalWare is handled via the official packages: + +- [lxc-docker i686](http://www.frugalware.org/packages/200141) +- [lxc-docker x86\_64](http://www.frugalware.org/packages/200130) + +The lxc-docker package will install the latest tagged version of Docker. + +## Dependencies + +Docker depends on several packages which are specified as dependencies +in the packages. The core dependencies are: + +- systemd +- lvm2 +- sqlite3 +- libguestfs +- lxc +- iproute2 +- bridge-utils + +## Installation + +A simple + + pacman -S lxc-docker + +is all that is needed. + +## Starting Docker + +There is a systemd service unit created for Docker. To start Docker as +service: + + sudo systemctl start lxc-docker + +To start on system boot: + + sudo systemctl enable lxc-docker diff --git a/docs/sources/installation/gentoolinux.md b/docs/sources/installation/gentoolinux.md new file mode 100644 index 0000000000..1104ecdebb --- /dev/null +++ b/docs/sources/installation/gentoolinux.md @@ -0,0 +1,80 @@ +page_title: Installation on Gentoo +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: gentoo linux, virtualization, docker, documentation, installation + +# Gentoo + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Installing Docker on Gentoo Linux can be accomplished using one of two +methods. The first and best way if you’re looking for a stable +experience is to use the official app-emulation/docker package directly +in the portage tree. + +If you’re looking for a `-bin` ebuild, a live +ebuild, or bleeding edge ebuild changes/fixes, the second installation +method is to use the overlay provided at +[https://github.com/tianon/docker-overlay](https://github.com/tianon/docker-overlay) +which can be added using `app-portage/layman`. The +most accurate and up-to-date documentation for properly installing and +using the overlay can be found in [the overlay +README](https://github.com/tianon/docker-overlay/blob/master/README.md#using-this-overlay). + +Note that sometimes there is a disparity between the latest version and +what’s in the overlay, and between the latest version in the overlay and +what’s in the portage tree. Please be patient, and the latest version +should propagate shortly. + +## Installation + +The package should properly pull in all the necessary dependencies and +prompt for all necessary kernel options. The ebuilds for 0.7+ include +use flags to pull in the proper dependencies of the major storage +drivers, with the "device-mapper" use flag being enabled by default, +since that is the simplest installation path. + + sudo emerge -av app-emulation/docker + +If any issues arise from this ebuild or the resulting binary, including +and especially missing kernel configuration flags and/or dependencies, +[open an issue on the docker-overlay +repository](https://github.com/tianon/docker-overlay/issues) or ping +tianon directly in the \#docker IRC channel on the freenode network. + +## Starting Docker + +Ensure that you are running a kernel that includes all the necessary +modules and/or configuration for LXC (and optionally for device-mapper +and/or AUFS, depending on the storage driver you’ve decided to use). + +### OpenRC + +To start the docker daemon: + + sudo /etc/init.d/docker start + +To start on system boot: + + sudo rc-update add docker default + +### systemd + +To start the docker daemon: + + sudo systemctl start docker.service + +To start on system boot: + + sudo systemctl enable docker.service diff --git a/docs/sources/installation/google.md b/docs/sources/installation/google.md new file mode 100644 index 0000000000..2fa2acac2c --- /dev/null +++ b/docs/sources/installation/google.md @@ -0,0 +1,64 @@ +page_title: Installation on Google Cloud Platform +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Docker, Docker documentation, installation, google, Google Compute Engine, Google Cloud Platform + +# [Google Cloud Platform](https://cloud.google.com/) + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +## [Compute Engine](https://developers.google.com/compute) QuickStart for [Debian](https://www.debian.org) + +1. Go to [Google Cloud Console](https://cloud.google.com/console) and + create a new Cloud Project with [Compute Engine + enabled](https://developers.google.com/compute/docs/signup). +2. Download and configure the [Google Cloud + SDK](https://developers.google.com/cloud/sdk/) to use your project + with the following commands: + + + + $ curl https://dl.google.com/dl/cloudsdk/release/install_google_cloud_sdk.bash | bash + $ gcloud auth login + Enter a cloud project id (or leave blank to not set): + +3. Start a new instance, select a zone close to you and the desired + instance size: + + + + $ gcutil addinstance docker-playground --image=backports-debian-7 + 1: europe-west1-a + ... + 4: us-central1-b + >>> + 1: machineTypes/n1-standard-1 + ... + 12: machineTypes/g1-small + >>> + +4. Connect to the instance using SSH: + + + + $ gcutil ssh docker-playground + docker-playground:~$ + +5. Install the latest Docker release and configure it to start when the + instance boots: + + + + docker-playground:~$ curl get.docker.io | bash + docker-playground:~$ sudo update-rc.d docker defaults + +6. Start a new container: + + + + docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' + docker on GCE \o/ diff --git a/docs/sources/installation/mac.md b/docs/sources/installation/mac.md new file mode 100644 index 0000000000..9d6c6892bc --- /dev/null +++ b/docs/sources/installation/mac.md @@ -0,0 +1,180 @@ +page_title: Installation on Mac OS X 10.6 Snow Leopard +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Docker, Docker documentation, requirements, virtualbox, ssh, linux, os x, osx, mac + +# Mac OS X + +Note + +These instructions are available with the new release of Docker (version +0.8). However, they are subject to change. + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer. + +## How To Install Docker On Mac OS X + +### VirtualBox + +Docker on OS X needs VirtualBox to run. To begin with, head over to +[VirtualBox Download Page](https://www.virtualbox.org/wiki/Downloads) +and get the tool for `OS X hosts x86/amd64`. + +Once the download is complete, open the disk image, run the set up file +(i.e. `VirtualBox.pkg`) and install VirtualBox. Do +not simply copy the package without running the installer. + +### boot2docker + +[boot2docker](https://github.com/boot2docker/boot2docker) provides a +handy script to easily manage the VM running the `docker` +daemon. It also takes care of the installation for the OS +image that is used for the job. + +#### With Homebrew + +If you are using Homebrew on your machine, simply run the following +command to install `boot2docker`: + + brew install boot2docker + +#### Manual installation + +Open up a new terminal window, if you have not already. + +Run the following commands to get boot2docker: + + # Enter the installation directory + cd ~/bin + + # Get the file + curl https://raw.github.com/boot2docker/boot2docker/master/boot2docker > boot2docker + + # Mark it executable + chmod +x boot2docker + +### Docker OS X Client + +The `docker` daemon is accessed using the +`docker` client. + +#### With Homebrew + +Run the following command to install the `docker` +client: + + brew install docker + +#### Manual installation + +Run the following commands to get it downloaded and set up: + + # Get the docker client file + DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ + curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ + gunzip $DIR/ld.tgz && \ + tar xvf $DIR/ld.tar -C $DIR/ && \ + cp $DIR/usr/local/bin/docker ./docker + + # Set the environment variable for the docker daemon + export DOCKER_HOST=tcp://127.0.0.1:4243 + + # Copy the executable file + sudo cp docker /usr/local/bin/ + +And that’s it! Let’s check out how to use it. + +## How To Use Docker On Mac OS X + +### The `docker` daemon (via boot2docker) + +Inside the `~/bin` directory, run the following +commands: + + # Initiate the VM + ./boot2docker init + + # Run the VM (the docker daemon) + ./boot2docker up + + # To see all available commands: + ./boot2docker + + # Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} + +### The `docker` client + +Once the VM with the `docker` daemon is up, you can +use the `docker` client just like any other +application. + + docker version + # Client version: 0.7.6 + # Go version (client): go1.2 + # Git commit (client): bc3b2ec + # Server version: 0.7.5 + # Git commit (server): c348c04 + # Go version (server): go1.2 + +### Forwarding VM Port Range to Host + +If we take the port range that docker uses by default with the -P option +(49000-49900), and forward same range from host to vm, we’ll be able to +interact with our containers as if they were running locally: + + # vm must be powered off + for i in {49000..49900}; do + VBoxManage modifyvm "boot2docker-vm" --natpf1 "tcp-port$i,tcp,,$i,,$i"; + VBoxManage modifyvm "boot2docker-vm" --natpf1 "udp-port$i,udp,,$i,,$i"; + done + +### SSH-ing The VM + +If you feel the need to connect to the VM, you can simply run: + + ./boot2docker ssh + + # User: docker + # Pwd: tcuser + +You can now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. + +## Learn More + +### boot2docker: + +See the GitHub page for +[boot2docker](https://github.com/boot2docker/boot2docker). + +### If SSH complains about keys: + + ssh-keygen -R '[localhost]:2022' + +### Upgrading to a newer release of boot2docker + +To upgrade an initialised VM, you can use the following 3 commands. Your +persistence disk will not be changed, so you won’t lose your images and +containers: + + ./boot2docker stop + ./boot2docker download + ./boot2docker start + +### About the way Docker works on Mac OS X: + +Docker has two key components: the `docker` daemon +and the `docker` client. The tool works by client +commanding the daemon. In order to work and do its magic, the daemon +makes use of some Linux Kernel features (e.g. LXC, name spaces etc.), +which are not supported by OS X. Therefore, the solution of getting +Docker to run on OS X consists of running it inside a lightweight +virtual machine. In order to simplify things, Docker comes with a bash +script to make this whole process as easy as possible (i.e. +boot2docker). diff --git a/docs/sources/installation/openSUSE.md b/docs/sources/installation/openSUSE.md new file mode 100644 index 0000000000..d0aad1cd54 --- /dev/null +++ b/docs/sources/installation/openSUSE.md @@ -0,0 +1,65 @@ +page_title: Installation on openSUSE +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: openSUSE, virtualbox, docker, documentation, installation + +# openSUSE + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Docker is available in **openSUSE 12.3 and later**. Please note that due +to the current Docker limitations Docker is able to run only on the **64 +bit** architecture. + +## Installation + +The `docker` package from the [Virtualization +project](https://build.opensuse.org/project/show/Virtualization) on +[OBS](https://build.opensuse.org/) provides Docker on openSUSE. + +To proceed with Docker installation please add the right Virtualization +repository. + + # openSUSE 12.3 + sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization + + # openSUSE 13.1 + sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization + +Install the Docker package. + + sudo zypper in docker + +It’s also possible to install Docker using openSUSE’s 1-click install. +Just visit [this](http://software.opensuse.org/package/docker) page, +select your openSUSE version and click on the installation link. This +will add the right repository to your system and it will also install +the docker package. + +Now that it’s installed, let’s start the Docker daemon. + + sudo systemctl start docker + +If we want Docker to start at boot, we should also: + + sudo systemctl enable docker + +The docker package creates a new group named docker. Users, other than +root user, need to be part of this group in order to interact with the +Docker daemon. + + sudo usermod -G docker + +**Done!**, now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/rackspace.md b/docs/sources/installation/rackspace.md new file mode 100644 index 0000000000..9585a667e7 --- /dev/null +++ b/docs/sources/installation/rackspace.md @@ -0,0 +1,88 @@ +page_title: Installation on Rackspace Cloud +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Rackspace Cloud, installation, docker, linux, ubuntu + +# Rackspace Cloud + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Installing Docker on Ubuntu provided by Rackspace is pretty +straightforward, and you should mostly be able to follow the +[*Ubuntu*](../ubuntulinux/#ubuntu-linux) installation guide. + +**However, there is one caveat:** + +If you are using any Linux not already shipping with the 3.8 kernel you +will need to install it. And this is a little more difficult on +Rackspace. + +Rackspace boots their servers using grub’s `menu.lst` +and does not like non ‘virtual’ packages (e.g. Xen compatible) +kernels there, although they do work. This results in +`update-grub` not having the expected result, and +you will need to set the kernel manually. + +**Do not attempt this on a production machine!** + + # update apt + apt-get update + + # install the new kernel + apt-get install linux-generic-lts-raring + +Great, now you have the kernel installed in `/boot/` +.literal}, next you need to make it boot next time. + + # find the exact names + find /boot/ -name '*3.8*' + + # this should return some results + +Now you need to manually edit `/boot/grub/menu.lst`, +you will find a section at the bottom with the existing options. Copy +the top one and substitute the new kernel into that. Make sure the new +kernel is on top, and double check the kernel and initrd lines point to +the right files. + +Take special care to double check the kernel and initrd entries. + + # now edit /boot/grub/menu.lst + vi /boot/grub/menu.lst + +It will probably look something like this: + + ## ## End Default Options ## + + title Ubuntu 12.04.2 LTS, kernel 3.8.x generic + root (hd0) + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.8.0-19-generic + + title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual + root (hd0) + kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.2.0-38-virtual + + title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual (recovery mode) + root (hd0) + kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash single + initrd /boot/initrd.img-3.2.0-38-virtual + +Reboot the server (either via command line or console) + + # reboot + +Verify the kernel was updated + + uname -a + # Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + + # nice! 3.8. + +Now you can finish with the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +instructions. diff --git a/docs/sources/installation/rhel.md b/docs/sources/installation/rhel.md new file mode 100644 index 0000000000..d17293f3a5 --- /dev/null +++ b/docs/sources/installation/rhel.md @@ -0,0 +1,80 @@ +page_title: Installation on Red Hat Enterprise Linux +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos + +# Red Hat Enterprise Linux + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Note + +This is a community contributed installation path. The only ‘official’ +installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) +installation path. This version may be out of date because it depends on +some binaries to be updated and published + +Docker is available for **RHEL** on EPEL. These instructions should work +for both RHEL and CentOS. They will likely work for other binary +compatible EL6 distributions as well, but they haven’t been tested. + +Please note that this package is part of [Extra Packages for Enterprise +Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort +to create and maintain additional packages for the RHEL distribution. + +Also note that due to the current Docker limitations, Docker is able to +run only on the **64 bit** architecture. + +You will need [RHEL +6.5](https://access.redhat.com/site/articles/3078#RHEL6) or higher, with +a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel +fixes to allow Docker to work. + +## Installation + +Firstly, you need to install the EPEL repository. Please follow the +[EPEL installation +instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). + +The `docker-io` package provides Docker on EPEL. + +If you already have the (unrelated) `docker` package +installed, it will conflict with `docker-io`. +There’s a [bug +report](https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for +it. To proceed with `docker-io` installation, please +remove `docker` first. + +Next, let’s install the `docker-io` package which +will install Docker on our host. + + sudo yum -y install docker-io + +To update the `docker-io` package + + sudo yum -y update docker-io + +Now that it’s installed, let’s start the Docker daemon. + + sudo service docker start + +If we want Docker to start at boot, we should also: + + sudo chkconfig docker on + +Now let’s verify that Docker is working. + + sudo docker run -i -t fedora /bin/bash + +**Done!**, now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. + +## Issues? + +If you have any issues - please report them directly in the [Red Hat +Bugzilla for docker-io +component](https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora%20EPEL&component=docker-io). diff --git a/docs/sources/installation/softlayer.md b/docs/sources/installation/softlayer.md new file mode 100644 index 0000000000..0f55ef1e11 --- /dev/null +++ b/docs/sources/installation/softlayer.md @@ -0,0 +1,37 @@ +page_title: Installation on IBM SoftLayer +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: IBM SoftLayer, virtualization, cloud, docker, documentation, installation + +# IBM SoftLayer + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +## IBM SoftLayer QuickStart + +1. Create an [IBM SoftLayer + account](https://www.softlayer.com/cloudlayer/). +2. Log in to the [SoftLayer + Console](https://control.softlayer.com/devices/). +3. Go to [Order Hourly Computing Instance + Wizard](https://manage.softlayer.com/Sales/orderHourlyComputingInstance) + on your SoftLayer Console. +4. Create a new *CloudLayer Computing Instance* (CCI) using the default + values for all the fields and choose: + +- *First Available* as `Datacenter` and +- *Ubuntu Linux 12.04 LTS Precise Pangolin - Minimal Install (64 bit)* + as `Operating System`. + +5. Click the *Continue Your Order* button at the bottom right and + select *Go to checkout*. +6. Insert the required *User Metadata* and place the order. +7. Then continue with the [*Ubuntu*](../ubuntulinux/#ubuntu-linux) + instructions. + +Continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/ubuntulinux.md b/docs/sources/installation/ubuntulinux.md new file mode 100644 index 0000000000..a3d0ae35a2 --- /dev/null +++ b/docs/sources/installation/ubuntulinux.md @@ -0,0 +1,330 @@ +page_title: Installation on Ubuntu +page_description: Please note this project is currently under heavy development. It should not be used in production. +page_keywords: Docker, Docker documentation, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux + +# Ubuntu + +Warning + +These instructions have changed for 0.6. If you are upgrading from an +earlier version, you will need to follow them again. + +Note + +Docker is still under heavy development! We don’t recommend using it in +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/) + +Docker is supported on the following versions of Ubuntu: + +- [*Ubuntu Precise 12.04 (LTS) (64-bit)*](#ubuntu-precise) +- [*Ubuntu Raring 13.04 and Saucy 13.10 (64 + bit)*](#ubuntu-raring-saucy) + +Please read [*Docker and UFW*](#ufw), if you plan to use [UFW +(Uncomplicated Firewall)](https://help.ubuntu.com/community/UFW) + +## Ubuntu Precise 12.04 (LTS) (64-bit) + +This installation path should work at all times. + +### Dependencies + +**Linux kernel 3.8** + +Due to a bug in LXC, Docker works best on the 3.8 kernel. Precise comes +with a 3.2 kernel, so we need to upgrade it. The kernel you’ll install +when following these steps comes with AUFS built in. We also include the +generic headers to enable packages that depend on them, like ZFS and the +VirtualBox guest additions. If you didn’t install the headers for your +"precise" kernel, then you can skip these headers for the "raring" +kernel. But it is safer to include them if you’re not sure. + + # install the backported kernel + sudo apt-get update + sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring + + # reboot + sudo reboot + +### Installation + +Warning + +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** [*Mirrors*](#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, check that your APT system can deal with `https` +URLs: the file `/usr/lib/apt/methods/https` +should exist. If it doesn’t, you need to install the package +`apt-transport-https`. + + [ -e /usr/lib/apt/methods/https ] || { + apt-get update + apt-get install apt-transport-https + } + +Then, add the Docker repository key to your local keychain. + + 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. + +*You may receive a warning that the package isn’t trusted. Answer yes to +continue installation.* + + sudo sh -c "echo deb https://get.docker.io/ubuntu docker main\ + > /etc/apt/sources.list.d/docker.list" + sudo apt-get update + sudo apt-get install lxc-docker + +Note + +There is also a simple `curl` script available to +help with this process. + + curl -s https://get.docker.io/ubuntu/ | sudo sh + +Now verify that the installation has worked by downloading the +`ubuntu` image and launching a container. + + sudo docker run -i -t ubuntu /bin/bash + +Type `exit` to exit + +**Done!**, now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. + +## Ubuntu Raring 13.04 and Saucy 13.10 (64 bit) + +These instructions cover both Ubuntu Raring 13.04 and Saucy 13.10. + +### Dependencies + +**Optional AUFS filesystem support** + +Ubuntu Raring already comes with the 3.8 kernel, so we don’t need to +install it. However, not all systems have AUFS filesystem support +enabled. AUFS support is optional as of version 0.7, but it’s still +available as a driver and we recommend using it if you can. + +To make sure AUFS is installed, run the following commands: + + sudo apt-get update + sudo apt-get install linux-image-extra-`uname -r` + +### Installation + +Docker is available as a Debian package, which makes installation easy. + +Warning + +Please note that these instructions have changed for 0.6. If you are +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 hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 + +Add the Docker repository to your apt sources list, update and install +the `lxc-docker` package. + + sudo sh -c "echo deb http://get.docker.io/ubuntu docker main\ + > /etc/apt/sources.list.d/docker.list" + sudo apt-get update + sudo apt-get install lxc-docker + +Now verify that the installation has worked by downloading the +`ubuntu` image and launching a container. + + sudo docker run -i -t ubuntu /bin/bash + +Type `exit` to exit + +**Done!**, now continue with the [*Hello +World*](../../examples/hello_world/#hello-world) example. + +### Giving non-root access + +The `docker` daemon always runs as the root user, +and since Docker version 0.5.2, the `docker` daemon +binds to a Unix socket instead of a TCP port. By default that Unix +socket is owned by the user *root*, and so, by default, you can access +it with `sudo`. + +Starting in version 0.5.3, if you (or your Docker installer) create a +Unix group called *docker* and add users to it, then the +`docker` daemon will make the ownership of the Unix +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. 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 (or the group specified with `-G` +.literal}) is root-equivalent; see [*Docker Daemon Attack +Surface*](../../articles/security/#dockersecurity-daemon) details. + +**Example:** + + # Add the docker group if it doesn't already exist. + sudo groupadd docker + + # Add the connected user "${USER}" to the docker group. + # Change the user name to match your preferred user. + # You may have to logout and log back in again for + # this to take effect. + sudo gpasswd -a ${USER} docker + + # Restart the Docker daemon. + sudo service docker restart + +### Upgrade + +To install the latest version of docker, use the standard +`apt-get` method: + + # update your sources list + sudo apt-get update + + # install the latest + sudo apt-get install lxc-docker + +## Memory and Swap Accounting + +If you want to enable memory and swap accounting, you must add the +following command-line parameters to your kernel: + + cgroup_enable=memory swapaccount=1 + +On systems using GRUB (which is the default for Ubuntu), you can add +those parameters by editing `/etc/default/grub` and +extending `GRUB_CMDLINE_LINUX`. Look for the +following line: + + GRUB_CMDLINE_LINUX="" + +And replace it by the following one: + + GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" + +Then run `sudo update-grub`, and reboot. + +These parameters will help you get rid of the following warnings: + + WARNING: Your kernel does not support cgroup swap limit. + WARNING: Your kernel does not support swap limit capabilities. Limitation discarded. + +## Troubleshooting + +On Linux Mint, the `cgroup-lite` package is not +installed by default. Before Docker will work correctly, you will need +to install this via: + + sudo apt-get update && sudo apt-get install cgroup-lite + +## Docker and UFW + +Docker uses a bridge to manage container networking. By default, UFW +drops all forwarding traffic. As a result you will need to enable UFW +forwarding: + + sudo nano /etc/default/ufw + ---- + # Change: + # DEFAULT_FORWARD_POLICY="DROP" + # to + DEFAULT_FORWARD_POLICY="ACCEPT" + +Then reload UFW: + + sudo ufw reload + +UFW’s default set of rules denies all incoming traffic. If you want to +be able to reach your containers from another host then you should allow +incoming connections on the Docker port (default 4243): + + sudo ufw allow 4243/tcp + +## Docker and local DNS server warnings + +Systems which are running Ubuntu or an Ubuntu derivative on the desktop +will use 127.0.0.1 as the default nameserver in /etc/resolv.conf. +NetworkManager sets up dnsmasq to use the real DNS servers of the +connection and sets up nameserver 127.0.0.1 in /etc/resolv.conf. + +When starting containers on these desktop machines, users will see a +warning: + + WARNING: Local (127.0.0.1) DNS resolver found in resolv.conf and containers can't use it. Using default external servers : [8.8.8.8 8.8.4.4] + +This warning is shown because the containers can’t use the local DNS +nameserver and Docker will default to using an external nameserver. + +This can be worked around by specifying a DNS server to be used by the +Docker daemon for the containers: + + sudo nano /etc/default/docker + --- + # Add: + 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 + +The Docker daemon has to be restarted: + + sudo restart docker + +Warning + +If you’re doing this on a laptop which connects to various networks, +make sure to choose a public DNS server. + +An alternative solution involves disabling dnsmasq in NetworkManager by +following these steps: + + sudo nano /etc/NetworkManager/NetworkManager.conf + ---- + # Change: + dns=dnsmasq + # to + #dns=dnsmasq + +NetworkManager and Docker need to be restarted afterwards: + + sudo restart network-manager + sudo restart docker + +Warning + +This might make DNS resolution slower on some networks. + +## Mirrors + +You should `ping get.docker.io` and compare the +latency to the following mirrors, and pick whichever one is best for +you. + +### Yandex + +[Yandex](http://yandex.ru/) in Russia is mirroring the Docker Debian +packages, updating every 6 hours. Substitute +`http://mirror.yandex.ru/mirrors/docker/` for +`http://get.docker.io/ubuntu` in the instructions +above. For example: + + sudo sh -c "echo deb http://mirror.yandex.ru/mirrors/docker/ docker main\ + > /etc/apt/sources.list.d/docker.list" + sudo apt-get update + sudo apt-get install lxc-docker diff --git a/docs/sources/installation/windows.md b/docs/sources/installation/windows.md new file mode 100644 index 0000000000..6c37e7628c --- /dev/null +++ b/docs/sources/installation/windows.md @@ -0,0 +1,72 @@ +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 + +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. + +## Installation + +Note + +Docker is still under heavy development! We don’t recommend using it in +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 + [https://www.virtualbox.org](https://www.virtualbox.org) - or follow + this + [tutorial](http://www.slideshare.net/julienbarbier42/install-virtualbox-on-windows-7). +2. Download the latest boot2docker.iso from + [https://github.com/boot2docker/boot2docker/releases](https://github.com/boot2docker/boot2docker/releases). +3. Start VirtualBox. +4. Create a new Virtual machine with the following settings: + +> - Name: boot2docker +> - Type: Linux +> - Version: Linux 2.6 (64 bit) +> - Memory size: 1024 MB +> - Hard drive: Do not add a virtual hard drive + +5. Open the settings of the virtual machine: + + 5.1. go to Storage + + 5.2. click the empty slot below Controller: IDE + + 5.3. click the disc icon on the right of IDE Secondary Master + + 5.4. click Choose a virtual CD/DVD disk file + +6. Browse to the path where you’ve saved the boot2docker.iso, select + the boot2docker.iso and click open. + +7. Click OK on the Settings dialog to save the changes and close the + window. + +8. Start the virtual machine by clicking the green start button. + +9. The boot2docker virtual machine should boot now. + +## Running Docker + +boot2docker will log you in automatically so you can start using Docker +right away. + +Let’s try the “hello world” example. Run + + docker run busybox echo hello world + +This will download the small busybox image and print hello world. + +## Observations + +### Persistent storage + +The virtual machine created above lacks any persistent data storage. All +images and containers will be lost when shutting down or rebooting the +VM. diff --git a/docs/sources/reference.md b/docs/sources/reference.md new file mode 100644 index 0000000000..3cd720c551 --- /dev/null +++ b/docs/sources/reference.md @@ -0,0 +1,9 @@ +# Reference Manual + +## Contents: + +- [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 new file mode 100644 index 0000000000..7afa5250b3 --- /dev/null +++ b/docs/sources/reference/api.md @@ -0,0 +1,100 @@ +# APIs + +Your programs and scripts can access Docker’s functionality via these +interfaces: + +- [Registry & Index Spec](registry_index_spec/) + - [1. The 3 roles](registry_index_spec/#the-3-roles) + - [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) + - [2.1 Images](registry_api/#images) + - [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) + - [v1.11](docker_remote_api/#v1-11) + - [v1.10](docker_remote_api/#v1-10) + - [v1.9](docker_remote_api/#v1-9) + - [v1.8](docker_remote_api/#v1-8) + - [v1.7](docker_remote_api/#v1-7) + - [v1.6](docker_remote_api/#v1-6) + - [v1.5](docker_remote_api/#v1-5) + - [v1.4](docker_remote_api/#v1-4) + - [v1.3](docker_remote_api/#v1-3) + - [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) + - [2. Register Your + Application](docker_io_oauth_api/#register-your-application) + - [3. Endpoints](docker_io_oauth_api/#endpoints) + - [3.1 Get an Authorization + Code](docker_io_oauth_api/#get-an-authorization-code) + - [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 + user](docker_io_accounts_api/#get-a-single-user) + - [1.2 Update a single + user](docker_io_accounts_api/#update-a-single-user) + - [1.3 List email addresses for a + user](docker_io_accounts_api/#list-email-addresses-for-a-user) + - [1.4 Add email address for a + user](docker_io_accounts_api/#add-email-address-for-a-user) + - [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 diff --git a/docs/sources/reference/api/docker_io_accounts_api.md b/docs/sources/reference/api/docker_io_accounts_api.md new file mode 100644 index 0000000000..e5e77dc421 --- /dev/null +++ b/docs/sources/reference/api/docker_io_accounts_api.md @@ -0,0 +1,355 @@ +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 + +## 1. Endpoints + +### 1.1 Get a single user + + `GET /api/v1.1/users/:username/` +: Get profile info for the specified user. + + Parameters: + + - **username** – username of the user whose profile info is being + requested. + + Request Headers: + +   + + - **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 + whose data is being requested, OAuth access tokens must have + `profile_read` scope. + - **404** – the specified username does not exist. + + **Example request**: + + GET /api/v1.1/users/janedoe/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id": 2, + "username": "janedoe", + "url": "https://www.docker.io/api/v1.1/users/janedoe/", + "date_joined": "2014-02-12T17:58:01.431312Z", + "type": "User", + "full_name": "Jane Doe", + "location": "San Francisco, CA", + "company": "Success, Inc.", + "profile_url": "https://docker.io/", + "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" + "email": "jane.doe@example.com", + "is_active": true + } + +### 1.2 Update a single user + + `PATCH /api/v1.1/users/:username/` +: Update profile info for the specified user. + + Parameters: + + - **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 + email address. + + Request Headers: + +   + + - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + - **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 + whose data is being updated, OAuth access tokens must have + `profile_write` scope. + - **404** – the specified username does not exist. + + **Example request**: + + PATCH /api/v1.1/users/janedoe/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= + + { + "location": "Private Island", + "profile_url": "http://janedoe.com/", + "company": "Retired", + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "id": 2, + "username": "janedoe", + "url": "https://www.docker.io/api/v1.1/users/janedoe/", + "date_joined": "2014-02-12T17:58:01.431312Z", + "type": "User", + "full_name": "Jane Doe", + "location": "Private Island", + "company": "Retired", + "profile_url": "http://janedoe.com/", + "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" + "email": "jane.doe@example.com", + "is_active": true + } + +### 1.3 List email addresses for a user + + `GET /api/v1.1/users/:username/emails/` +: List email info for the specified user. + + Parameters: + + - **username** – username of the user whose profile info is being + updated. + + Request Headers: + +   + + - **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 + whose data is being requested, OAuth access tokens must have + `email_read` scope. + - **404** – the specified username does not exist. + + **Example request**: + + GET /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "email": "jane.doe@example.com", + "verified": true, + "primary": true + } + ] + +### 1.4 Add email address for a user + + `POST /api/v1.1/users/:username/emails/` +: Add a new email address to the specified user’s account. The email + address must be verified separately, a confirmation email is not + automatically sent. + + Json Parameters: + +   + + - **email** (*string*) – email address to be added. + + Request Headers: + +   + + - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + - **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 + whose data is being requested, OAuth access tokens must have + `email_write` scope. + - **404** – the specified username does not exist. + + **Example request**: + + POST /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + + { + "email": "jane.doe+other@example.com" + } + + **Example response**: + + HTTP/1.1 201 Created + Content-Type: application/json + + { + "email": "jane.doe+other@example.com", + "verified": false, + "primary": false + } + +### 1.5 Update an email address for a user + + `PATCH /api/v1.1/users/:username/emails/` +: Update an email address for the specified user to either verify an + email address or set it as the primary email for the user. You + cannot use this endpoint to un-verify an email address. You cannot + use this endpoint to unset the primary email, only set another as + the primary. + + Parameters: + + - **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 + is verified, must be `true` or absent. + - **primary** (*boolean*) – (optional) whether to set the email + address as the primary email, must be `true` + or absent. + + Request Headers: + +   + + - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + - **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 + whose data is being updated, OAuth access tokens must have + `email_write` scope. + - **404** – the specified username or email address does not + exist. + + **Example request**: + + Once you have independently verified an email address. + + PATCH /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= + + { + "email": "jane.doe+other@example.com", + "verified": true, + } + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/json + + { + "email": "jane.doe+other@example.com", + "verified": true, + "primary": false + } + +### 1.6 Delete email address for a user + + `DELETE /api/v1.1/users/:username/emails/` +: Delete an email address from the specified user’s account. You + cannot delete a user’s primary email address. + + Json Parameters: + +   + + - **email** (*string*) – email address to be deleted. + + Request Headers: + +   + + - **Authorization** – required authentication credentials of + either type HTTP Basic or OAuth Bearer Token. + - **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 + whose data is being requested, OAuth access tokens must have + `email_write` scope. + - **404** – the specified username or email address does not + exist. + + **Example request**: + + DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1 + Host: www.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM + + { + "email": "jane.doe+other@example.com" + } + + **Example response**: + + HTTP/1.1 204 NO CONTENT + 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 new file mode 100644 index 0000000000..3c5755e047 --- /dev/null +++ b/docs/sources/reference/api/docker_io_oauth_api.md @@ -0,0 +1,256 @@ +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 + +## 1. Brief introduction + +Some docker.io API requests will require an access token to +authenticate. To get an access token for a user, that user must first +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/html/rfc6749). + +*Also note that all OAuth interactions must take place over https +connections* + +## 2. Register Your Application + +You will need to register your application with docker.io before users +will be able to grant your application access to their account +information. We are currently only allowing applications selectively. To +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 + docker.io users. +- 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 + application. + +When your application is approved you will receive a response from the +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. + +## 3. Endpoints + +### 3.1 Get an Authorization Code + +Once You have registered you are ready to start integrating docker.io +accounts into your application! The process is usually started by a user +following a link in your application to an OAuth Authorization endpoint. + + `GET /api/v1.1/o/authorize/` +: Request that a docker.io user authorize your application. If the + user is not already logged in, they will be prompted to login. The + user is then presented with a form to authorize your application for + the requested access scope. On submission, the user will be + redirected to the specified `redirect_uri` with + an Authorization Code. + + Query Parameters: + +   + + - **client\_id** – The `client_id` given to + your application at registration. + - **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 + 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. + Currently, the scope options are `profile_read` + .literal}, `profile_write`, + `email_read`, and `email_write` + .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 between the authorization request and callback to protect + against CSRF attacks. + + **Example Request** + + Asking the user for authorization. + + GET /api/v1.1/o/authorize/?client_id=TestClientID&response_type=code&redirect_uri=https%3A//my.app/auth_complete/&scope=profile_read%20email_read&state=abc123 HTTP/1.1 + Host: www.docker.io + + **Authorization Page** + + When the user follows a link, making the above GET request, they + will be asked to login to their docker.io account if they are not + already and then be presented with the following authorization + prompt which asks the user to authorize your application with a + description of the requested scopes. + + ![](../../../_images/io_oauth_authorization_page.png) + + Once the user allows or denies your Authorization Request the user + will be redirected back to your application. Included in that + request will be the following query parameters: + + `code` + : The Authorization code generated by the docker.io authorization + server. Present it again to request an Access Token. This code + expires in 60 seconds. + `state` + : If the `state` parameter was present in the + authorization request this will be the exact value received from + that request. + `error` + : An error message in the event of the user denying the + authorization or some other kind of error with the request. + +### 3.2 Get an Access Token + +Once the user has authorized your application, a request will be made to +your application’s specified `redirect_uri` which +includes a `code` parameter that you must then use +to get an Access Token. + + `POST /api/v1.1/o/token/` +: Submit your newly granted Authorization Code and your application’s + credentials to receive an Access Token and Refresh Token. The code + is valid for 60 seconds and cannot be used more than once. + + Request Headers: + +   + + - **Authorization** – HTTP basic authentication using your + application’s `client_id` and + `client_secret` + + Form Parameters: + +   + + - **grant\_type** – MUST be set to `authorization_code` + .literal} + - **code** – The authorization code received from the user’s + redirect request. + - **redirect\_uri** – The same `redirect_uri` + used in the authentication request. + + **Example Request** + + Using an authorization code to get an access token. + + POST /api/v1.1/o/token/ HTTP/1.1 + Host: www.docker.io + Authorization: Basic VGVzdENsaWVudElEOlRlc3RDbGllbnRTZWNyZXQ= + Accept: application/json + Content-Type: application/json + + { + "grant_type": "code", + "code": "YXV0aG9yaXphdGlvbl9jb2Rl", + "redirect_uri": "https://my.app/auth_complete/" + } + + **Example Response** + + HTTP/1.1 200 OK + Content-Type: application/json;charset=UTF-8 + + { + "username": "janedoe", + "user_id": 42, + "access_token": "t6k2BqgRw59hphQBsbBoPPWLqu6FmS", + "expires_in": 15552000, + "token_type": "Bearer", + "scope": "profile_read email_read", + "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc" + } + + In the case of an error, there will be a non-200 HTTP Status and and + data detailing the error. + +### 3.3 Refresh a Token + +Once the Access Token expires you can use your `refresh_token` +to have docker.io issue your application a new Access Token, +if the user has not revoked access from your application. + + `POST /api/v1.1/o/token/` +: Submit your `refresh_token` and application’s + credentials to receive a new Access Token and Refresh Token. The + `refresh_token` can be used only once. + + Request Headers: + +   + + - **Authorization** – HTTP basic authentication using your + application’s `client_id` and + `client_secret` + + Form Parameters: + +   + + - **grant\_type** – MUST be set to `refresh_token` + .literal} + - **refresh\_token** – The `refresh_token` + which was issued to your application. + - **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. + + **Example Request** + + Refreshing an access token. + + POST /api/v1.1/o/token/ HTTP/1.1 + Host: www.docker.io + Authorization: Basic VGVzdENsaWVudElEOlRlc3RDbGllbnRTZWNyZXQ= + Accept: application/json + Content-Type: application/json + + { + "grant_type": "refresh_token", + "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc", + } + + **Example Response** + + HTTP/1.1 200 OK + Content-Type: application/json;charset=UTF-8 + + { + "username": "janedoe", + "user_id": 42, + "access_token": "t6k2BqgRw59hphQBsbBoPPWLqu6FmS", + "expires_in": 15552000, + "token_type": "Bearer", + "scope": "profile_read email_read", + "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc" + } + + In the case of an error, there will be a non-200 HTTP Status and and + data detailing the error. + +## 4. Use an Access Token with the API + +Many of the docker.io API requests will require a Authorization request +header field. Simply ensure you add this header with "Bearer +\<`access_token`\>": + + GET /api/v1.1/resource HTTP/1.1 + Host: docker.io + Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md new file mode 100644 index 0000000000..7608e1f3e8 --- /dev/null +++ b/docs/sources/reference/api/docker_remote_api.md @@ -0,0 +1,348 @@ +page_title: Remote API +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# Docker Remote API + +## 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 +- authConfig, set as the `X-Registry-Auth` header, + is currently a Base64 encoded (json) string with credentials: + `{'username': string, 'password': string, 'email': string, 'serveraddress' : string}` + + +## 2. Versions + +The current version of the API is 1.11 + +Calling /images/\/insert is the same as calling +/v1.11/images/\/insert + +You can still call an old version of the api using +/v1.11/images/\/insert + +### v1.11 + +#### Full Documentation + +[*Docker Remote API v1.11*](../docker_remote_api_v1.11/) + +#### What’s new + + `GET /events` +: **New!** You can now use the `-until` parameter + to close connection after timestamp. + +### v1.10 + +#### Full Documentation + +[*Docker Remote API v1.10*](../docker_remote_api_v1.10/) + +#### What’s new + + `DELETE /images/`(*name*) +: **New!** You can now use the force parameter to force delete of an + image, even if it’s tagged in multiple repositories. **New!** You + can now use the noprune parameter to prevent the deletion of parent + images + + `DELETE /containers/`(*id*) +: **New!** You can now use the force paramter to force delete a + container, even if it is currently running + +### v1.9 + +#### Full Documentation + +[*Docker Remote API v1.9*](../docker_remote_api_v1.9/) + +#### What’s new + + `POST /build` +: **New!** This endpoint now takes a serialized ConfigFile which it + uses to resolve the proper registry auth credentials for pulling the + base image. Clients which previously implemented the version + accepting an AuthConfig object must be updated. + +### v1.8 + +#### Full Documentation + +#### What’s new + + `POST /build` +: **New!** This endpoint now returns build status as json stream. In + case of a build error, it returns the exit status of the failed + command. + + `GET /containers/`(*id*)`/json` +: **New!** This endpoint now returns the host config for the + container. + + `POST /images/create` +: + + `POST /images/`(*name*)`/insert` +: + + `POST /images/`(*name*)`/push` +: **New!** progressDetail object was added in the JSON. It’s now + possible to get the current value and the total of the progress + without having to parse the string. + +### v1.7 + +#### Full Documentation + +#### What’s new + + `GET /images/json` +: The format of the json returned from this uri changed. Instead of an + entry for each repo/tag on an image, each image is only represented + once, with a nested attribute indicating the repo/tags that apply to + that image. + + Instead of: + + HTTP/1.1 200 OK + Content-Type: application/json + + [ + { + "VirtualSize": 131506275, + "Size": 131506275, + "Created": 1365714795, + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Tag": "12.04", + "Repository": "ubuntu" + }, + { + "VirtualSize": 131506275, + "Size": 131506275, + "Created": 1365714795, + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Tag": "latest", + "Repository": "ubuntu" + }, + { + "VirtualSize": 131506275, + "Size": 131506275, + "Created": 1365714795, + "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", + "Tag": "precise", + "Repository": "ubuntu" + }, + { + "VirtualSize": 180116135, + "Size": 24653, + "Created": 1364102658, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Tag": "12.10", + "Repository": "ubuntu" + }, + { + "VirtualSize": 180116135, + "Size": 24653, + "Created": 1364102658, + "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", + "Tag": "quantal", + "Repository": "ubuntu" + } + ] + + The returned json looks like this: + + 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 + } + ] + + `GET /images/viz` +: This URI no longer exists. The `images --viz` + output is now generated in the client, using the + `/images/json` data. + +### v1.6 + +#### Full Documentation + +#### What’s new + + `POST /containers/`(*id*)`/attach` +: **New!** You can now split stderr from stdout. This is done by + prefixing a header to each transmition. See + [`POST /containers/(id)/attach` +](../docker_remote_api_v1.9/#post--containers-(id)-attach "POST /containers/(id)/attach"). + The WebSocket attach is unchanged. Note that attach calls on the + previous API version didn’t change. Stdout and stderr are merged. + +### v1.5 + +#### Full Documentation + +#### What’s new + + `POST /images/create` +: **New!** You can now pass registry credentials (via an AuthConfig + object) through the X-Registry-Auth header + + `POST /images/`(*name*)`/push` +: **New!** The AuthConfig object now needs to be passed through the + X-Registry-Auth header + + `GET /containers/json` +: **New!** The format of the Ports entry has been changed to a list of + dicts each containing PublicPort, PrivatePort and Type describing a + port mapping. + +### v1.4 + +#### Full Documentation + +#### What’s new + + `POST /images/create` +: **New!** When pulling a repo, all images are now downloaded in + parallel. + + `GET /containers/`(*id*)`/top` +: **New!** You can now use ps args with docker top, like docker top + \ aux + + `GET /events:` +: **New!** Image’s name added in the events + +### v1.3 + +docker v0.5.0 +[51f6c4a](https://github.com/dotcloud/docker/commit/51f6c4a7372450d164c61e0054daf0223ddbd909) + +#### Full Documentation + +#### What’s new + + `GET /containers/`(*id*)`/top` +: List the processes running inside a container. + + `GET /events:` +: **New!** Monitor docker’s events via streaming or via polling + +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 + +Warning + +The /build improvements are not reverse-compatible. Pre 1.3 clients will +break on /build. + +List containers (/containers/json): + +- 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 + +### v1.2 + +docker v0.4.2 +[2e7649b](https://github.com/dotcloud/docker/commit/2e7649beda7c820793bd46766cbc2cfeace7b168) + +#### Full Documentation + +#### What’s new + +The auth configuration is now handled by the client. + +The client should send it’s authConfig as POST on each call of +/images/(name)/push + + `GET /auth` +: **Deprecated.** + + `POST /auth` +: Only checks the configuration but doesn’t store it on the server + + Deleting an image is now improved, will only untag the image if it + has children and remove all the untagged parents if has any. + + `POST /images//delete` +: Now returns a JSON structure with the list of images + deleted/untagged. + +### v1.1 + +docker v0.4.0 +[a8ae398](https://github.com/dotcloud/docker/commit/a8ae398bf52e97148ee7bd0d5868de2e15bd297f) + +#### Full Documentation + +#### What’s new + + `POST /images/create` +: + + `POST /images/`(*name*)`/insert` +: + + `POST /images/`(*name*)`/push` +: Uses json stream instead of HTML hijack, it looks like this: + + > HTTP/1.1 200 OK + > Content-Type: application/json + > + > {"status":"Pushing..."} + > {"status":"Pushing", "progress":"1/? (n/a)"} + > {"error":"Invalid..."} + > ... + +### v1.0 + +docker v0.3.4 +[8d73740](https://github.com/dotcloud/docker/commit/8d73740343778651c09160cde9661f5f387b36f4) + +#### Full Documentation + +#### What’s new + +Initial version diff --git a/docs/sources/reference/api/docker_remote_api_v1.10.md b/docs/sources/reference/api/docker_remote_api_v1.10.md new file mode 100644 index 0000000000..6350047c7e --- /dev/null +++ b/docs/sources/reference/api/docker_remote_api_v1.10.md @@ -0,0 +1,1238 @@ +page_title: Remote API v1.10 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# Docker Remote API v1.10 + +## 1. Brief introduction + +- 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 + +### 2.1 Containers + +#### List containers + + `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 + + `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" + ], + "Image":"base", + "Volumes":{ + "/tmp": {} + }, + "WorkingDir":"", + "DisableNetwork": false, + "ExposedPorts":{ + "DisableNetwork": false, + "22/tcp": {} + } + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + 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 + + `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" + ], + "Image": "base", + "Volumes": {}, + "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 + + `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 + + `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 + + `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 + + `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 + "Dns": ["8.8.8.8"], + "VolumesFrom: ["parent", "other:ro"] + } + + **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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + - **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 + +#### Copy files or folders from a container + + `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 + +#### List Images + + `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 + + `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 + + `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 + + `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"] + "Image":"base", + "Volumes":null, + "WorkingDir":"" + }, + "Size": 6824592 + } + + Status Codes: + + - **200** – no error + - **404** – no such image + - **500** – server error + +#### Get the history of an image + + `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 + + `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 + + `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 + + `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"} + ] + + Query Parameters: + +   + + - **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 + +#### Search images + + `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 + +#### Build an image from Dockerfile via stdin + + `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-Config** – base64-encoded ConfigFile object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### Check auth configuration + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + +### 3.1 Inside ‘docker run’ + +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 + +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 + +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.11.md b/docs/sources/reference/api/docker_remote_api_v1.11.md new file mode 100644 index 0000000000..626bec2b59 --- /dev/null +++ b/docs/sources/reference/api/docker_remote_api_v1.11.md @@ -0,0 +1,1242 @@ +page_title: Remote API v1.11 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# Docker Remote API v1.11 + +## 1. Brief introduction + +- 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 + +### 2.1 Containers + +#### List containers + + `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 + + `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":"", + "DisableNetwork": false, + "ExposedPorts":{ + "22/tcp": {} + } + } + + **Example response**: + + HTTP/1.1 201 OK + Content-Type: application/json + + { + "Id":"e90e34656806" + "Warnings":[] + } + + Json Parameters: + +   + + - **config** – the container’s configuration + + 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 + + `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 + + `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 + + `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 + + `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 + + `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: + +   + + - **hostConfig** – the container’s host configuration (optional) + + Status Codes: + + - **204** – no error + - **404** – no such container + - **500** – server error + +#### Stop a container + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + - **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 + +#### Copy files or folders from a container + + `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 + +#### List Images + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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"} + ] + + Query Parameters: + +   + + - **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 + +#### Search images + + `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 + +#### Build an image from Dockerfile via stdin + + `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-Config** – base64-encoded ConfigFile object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### Check auth configuration + + `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 + + `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 + + `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 + + `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 + + `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 + - **until** – timestamp used for polling + + Status Codes: + + - **200** – no error + - **500** – server error + +#### Get a tarball containing all images and tags in a repository + + `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 + + `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 + +### 3.1 Inside ‘docker run’ + +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 + +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 + +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.9.md b/docs/sources/reference/api/docker_remote_api_v1.9.md new file mode 100644 index 0000000000..aaa777292b --- /dev/null +++ b/docs/sources/reference/api/docker_remote_api_v1.9.md @@ -0,0 +1,1255 @@ +page_title: Remote API v1.9 +page_description: API Documentation for Docker +page_keywords: API, Docker, rcli, REST, documentation + +# Docker Remote API v1.9 + +## 1. Brief introduction + +- 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 + +### 2.1 Containers + +#### List containers + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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` +](#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 + + `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 + + `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 + + `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 + +#### List Images + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + +#### Build an image from Dockerfile + + `POST /build` +: Build an image from Dockerfile using a POST body. + + **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 + - **rm** – Remove intermediate containers after a successful build + + Request Headers: + +   + + - **Content-type** – should be set to + `"application/tar"`. + - **X-Registry-Config** – base64-encoded ConfigFile object + + Status Codes: + + - **200** – no error + - **500** – server error + +#### Check auth configuration + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + + `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 + +### 3.1 Inside ‘docker run’ + +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 + +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 + +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/index_api.md b/docs/sources/reference/api/index_api.md new file mode 100644 index 0000000000..9e60f39f3d --- /dev/null +++ b/docs/sources/reference/api/index_api.md @@ -0,0 +1,525 @@ +page_title: Index API +page_description: API Documentation for Docker Index +page_keywords: API, Docker, index, REST, documentation + +# Docker Index API + +## 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. + +## Repository + +### Repositories + +### User Repo + + `PUT /v1/repositories/`(*namespace*)`/`(*repo\_name*)`/` +: Create a user repository with the given `namespace` + and `repo_name`. + + **Example Request**: + + PUT /v1/repositories/foo/bar/ HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + X-Docker-Token: true + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f"}] + + Parameters: + + - **namespace** – the namespace for the repo + - **repo\_name** – the name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + WWW-Authenticate: Token signature=123abc,repository="foo/bar",access=write + X-Docker-Token: signature=123abc,repository="foo/bar",access=write + X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] + + "" + + Status Codes: + + - **200** – Created + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active + + `DELETE /v1/repositories/`(*namespace*)`/`(*repo\_name*)`/` +: Delete a user repository with the given `namespace` + and `repo_name`. + + **Example Request**: + + DELETE /v1/repositories/foo/bar/ HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + X-Docker-Token: true + + "" + + Parameters: + + - **namespace** – the namespace for the repo + - **repo\_name** – the name for the repo + + **Example Response**: + + HTTP/1.1 202 + Vary: Accept + Content-Type: application/json + WWW-Authenticate: Token signature=123abc,repository="foo/bar",access=delete + X-Docker-Token: signature=123abc,repository="foo/bar",access=delete + X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] + + "" + + Status Codes: + + - **200** – Deleted + - **202** – Accepted + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active + +### Library Repo + + `PUT /v1/repositories/`(*repo\_name*)`/` +: Create a library repository with the given `repo_name` +. This is a restricted feature only available to docker + admins. + + When namespace is missing, it is assumed to be `library` + + + **Example Request**: + + PUT /v1/repositories/foobar/ HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + X-Docker-Token: true + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f"}] + + Parameters: + + - **repo\_name** – the library name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + WWW-Authenticate: Token signature=123abc,repository="library/foobar",access=write + X-Docker-Token: signature=123abc,repository="foo/bar",access=write + X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] + + "" + + Status Codes: + + - **200** – Created + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active + + `DELETE /v1/repositories/`(*repo\_name*)`/` +: Delete a library repository with the given `repo_name` +. This is a restricted feature only available to docker + admins. + + When namespace is missing, it is assumed to be `library` + + + **Example Request**: + + DELETE /v1/repositories/foobar/ HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + X-Docker-Token: true + + "" + + Parameters: + + - **repo\_name** – the library name for the repo + + **Example Response**: + + HTTP/1.1 202 + Vary: Accept + Content-Type: application/json + WWW-Authenticate: Token signature=123abc,repository="library/foobar",access=delete + X-Docker-Token: signature=123abc,repository="foo/bar",access=delete + X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] + + "" + + Status Codes: + + - **200** – Deleted + - **202** – Accepted + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active + +### Repository Images + +### User Repo Images + + `PUT /v1/repositories/`(*namespace*)`/`(*repo\_name*)`/images` +: Update the images for a user repo. + + **Example Request**: + + PUT /v1/repositories/foo/bar/images HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}] + + Parameters: + + - **namespace** – the namespace for the repo + - **repo\_name** – the name for the repo + + **Example Response**: + + HTTP/1.1 204 + Vary: Accept + Content-Type: application/json + + "" + + Status Codes: + + - **204** – Created + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active or permission denied + + `GET /v1/repositories/`(*namespace*)`/`(*repo\_name*)`/images` +: get the images for a user repo. + + **Example Request**: + + GET /v1/repositories/foo/bar/images HTTP/1.1 + Host: index.docker.io + Accept: application/json + + Parameters: + + - **namespace** – the namespace for the repo + - **repo\_name** – the name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}, + {"id": "ertwetewtwe38722009fe6857087b486531f9a779a0c1dfddgfgsdgdsgds", + "checksum": "34t23f23fc17e3ed29dae8f12c4f9e89cc6f0bsdfgfsdgdsgdsgerwgew"}] + + Status Codes: + + - **200** – OK + - **404** – Not found + +### Library Repo Images + + `PUT /v1/repositories/`(*repo\_name*)`/images` +: Update the images for a library repo. + + **Example Request**: + + PUT /v1/repositories/foobar/images HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}] + + Parameters: + + - **repo\_name** – the library name for the repo + + **Example Response**: + + HTTP/1.1 204 + Vary: Accept + Content-Type: application/json + + "" + + Status Codes: + + - **204** – Created + - **400** – Errors (invalid json, missing or invalid fields, etc) + - **401** – Unauthorized + - **403** – Account is not Active or permission denied + + `GET /v1/repositories/`(*repo\_name*)`/images` +: get the images for a library repo. + + **Example Request**: + + GET /v1/repositories/foobar/images HTTP/1.1 + Host: index.docker.io + Accept: application/json + + Parameters: + + - **repo\_name** – the library name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + + [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}, + {"id": "ertwetewtwe38722009fe6857087b486531f9a779a0c1dfddgfgsdgdsgds", + "checksum": "34t23f23fc17e3ed29dae8f12c4f9e89cc6f0bsdfgfsdgdsgdsgerwgew"}] + + Status Codes: + + - **200** – OK + - **404** – Not found + +### Repository Authorization + +### Library Repo + + `PUT /v1/repositories/`(*repo\_name*)`/auth` +: authorize a token for a library repo + + **Example Request**: + + PUT /v1/repositories/foobar/auth HTTP/1.1 + Host: index.docker.io + Accept: application/json + Authorization: Token signature=123abc,repository="library/foobar",access=write + + Parameters: + + - **repo\_name** – the library name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + + "OK" + + Status Codes: + + - **200** – OK + - **403** – Permission denied + - **404** – Not found + +### User Repo + + `PUT /v1/repositories/`(*namespace*)`/`(*repo\_name*)`/auth` +: authorize a token for a user repo + + **Example Request**: + + PUT /v1/repositories/foo/bar/auth HTTP/1.1 + Host: index.docker.io + Accept: application/json + Authorization: Token signature=123abc,repository="foo/bar",access=write + + Parameters: + + - **namespace** – the namespace for the repo + - **repo\_name** – the name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + + "OK" + + Status Codes: + + - **200** – OK + - **403** – Permission denied + - **404** – Not found + +### Users + +### User Login + + `GET /v1/users` +: If you want to check your login, you can try this endpoint + + **Example Request**: + + GET /v1/users HTTP/1.1 + Host: index.docker.io + Accept: application/json + Authorization: Basic akmklmasadalkm== + + **Example Response**: + + HTTP/1.1 200 OK + Vary: Accept + Content-Type: application/json + + OK + + Status Codes: + + - **200** – no error + - **401** – Unauthorized + - **403** – Account is not Active + +### User Register + + `POST /v1/users` +: Registering a new account. + + **Example request**: + + POST /v1/users HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + + {"email": "sam@dotcloud.com", + "password": "toto42", + "username": "foobar"'} + + Json Parameters: + +   + + - **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 + + **Example Response**: + + HTTP/1.1 201 OK + Vary: Accept + Content-Type: application/json + + "User Created" + + Status Codes: + + - **201** – User Created + - **400** – Errors (invalid json, missing or invalid fields, etc) + +### Update User + + `PUT /v1/users/`(*username*)`/` +: Change a password or email address for given user. If you pass in an + email, it will add it to your account, it will not remove the old + one. Passwords will be updated. + + It is up to the client to verify that that password that is sent is + the one that they want. Common approach is to have them type it + twice. + + **Example Request**: + + PUT /v1/users/fakeuser/ HTTP/1.1 + Host: index.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Basic akmklmasadalkm== + + {"email": "sam@dotcloud.com", + "password": "toto42"} + + Parameters: + + - **username** – username for the person you want to update + + **Example Response**: + + HTTP/1.1 204 + Vary: Accept + Content-Type: application/json + + "" + + 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 + +## Search + +If you need to search the index, this is the endpoint you would use. + +### Search + + `GET /v1/search` +: Search the Index given a search term. It accepts + [GET](http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.3) + only. + + **Example request**: + + GET /v1/search?q=search_term HTTP/1.1 + Host: example.com + Accept: application/json + + **Example response**: + + HTTP/1.1 200 OK + Vary: Accept + Content-Type: application/json + + {"query":"search_term", + "num_results": 3, + "results" : [ + {"name": "ubuntu", "description": "An ubuntu image..."}, + {"name": "centos", "description": "A centos image..."}, + {"name": "fedora", "description": "A fedora image..."} + ] + } + + Query Parameters: + + - **q** – what you want to search for + + Status Codes: + + - **200** – no error + - **500** – server error + + diff --git a/docs/sources/reference/api/registry_api.md b/docs/sources/reference/api/registry_api.md new file mode 100644 index 0000000000..8ea6da28f1 --- /dev/null +++ b/docs/sources/reference/api/registry_api.md @@ -0,0 +1,501 @@ +page_title: Registry API +page_description: API Documentation for Docker Registry +page_keywords: API, Docker, index, registry, REST, documentation + +# Docker Registry API + +## 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 + 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 + +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 + 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 + 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, 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 + for anyone), others private (accessible only for authorized users). + Authentication and authorization would be delegated to the Index. + The goal of vendor registries is to let someone do “docker pull + 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, + 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 + +Mirror registries and private registries which do not use the Index +don’t even need to run the registry code. They can be implemented by any +kind of transport implementing HTTP GET and PUT. Read-only registries +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. + +The latter would only require two new commands in docker, e.g. +`registryget` and `registryput`, +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 + +### Images + +### Layer + + `GET /v1/images/`(*image\_id*)`/layer` +: get image layer for a given `image_id` + + **Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Authorization: Token signature=123abc,repository="foo/bar",access=read + + Parameters: + + - **image\_id** – the id for the layer you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + + {layer binary data stream} + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Image not found + + `PUT /v1/images/`(*image\_id*)`/layer` +: put image layer for a given `image_id` + + **Example Request**: + + PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 + Host: registry-1.docker.io + Transfer-Encoding: chunked + Authorization: Token signature=123abc,repository="foo/bar",access=write + + {layer binary data stream} + + Parameters: + + - **image\_id** – the id for the layer you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Image not found + +### Image + + `PUT /v1/images/`(*image\_id*)`/json` +: put image for a given `image_id` + + **Example Request**: + + PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + { + id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", + parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", + created: "2013-04-30T17:46:10.843673+03:00", + container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", + container_config: { + Hostname: "host-test", + User: "", + Memory: 0, + MemorySwap: 0, + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + PortSpecs: null, + Tty: false, + OpenStdin: false, + StdinOnce: false, + Env: null, + Cmd: [ + "/bin/bash", + "-c", + "apt-get -q -yy -f install libevent-dev" + ], + Dns: null, + Image: "imagename/blah", + Volumes: { }, + VolumesFrom: "" + }, + docker_version: "0.1.7" + } + + Parameters: + + - **image\_id** – the id for the layer you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + + `GET /v1/images/`(*image\_id*)`/json` +: get image for a given `image_id` + + **Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + Parameters: + + - **image\_id** – the id for the layer you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + X-Docker-Size: 456789 + X-Docker-Checksum: b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087 + + { + id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", + parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", + created: "2013-04-30T17:46:10.843673+03:00", + container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", + container_config: { + Hostname: "host-test", + User: "", + Memory: 0, + MemorySwap: 0, + AttachStdin: false, + AttachStdout: false, + AttachStderr: false, + PortSpecs: null, + Tty: false, + OpenStdin: false, + StdinOnce: false, + Env: null, + Cmd: [ + "/bin/bash", + "-c", + "apt-get -q -yy -f install libevent-dev" + ], + Dns: null, + Image: "imagename/blah", + Volumes: { }, + VolumesFrom: "" + }, + docker_version: "0.1.7" + } + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Image not found + +### Ancestry + + `GET /v1/images/`(*image\_id*)`/ancestry` +: get ancestry for an image given an `image_id` + + **Example Request**: + + GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/ancestry HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + Parameters: + + - **image\_id** – the id for the layer you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + ["088b4502f51920fbd9b7c503e87c7a2c05aa3adc3d35e79c031fa126b403200f", + "aeee63968d87c7da4a5cf5d2be6bee4e21bc226fd62273d180a49c96c62e4543", + "bfa4c5326bc764280b0863b46a4b20d940bc1897ef9c1dfec060604bdc383280", + "6ab5893c6927c15a15665191f2c6cf751f5056d8b95ceee32e43c5e8a3648544"] + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Image not found + +### Tags + + `GET /v1/repositories/`(*namespace*)`/`(*repository*)`/tags` +: get all of the tags for the given repo. + + **Example Request**: + + GET /v1/repositories/foo/bar/tags HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + + Parameters: + + - **namespace** – namespace for the repo + - **repository** – name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + { + "latest": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + "0.1.1": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087" + } + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Repository not found + + `GET /v1/repositories/`(*namespace*)`/`(*repository*)`/tags/`(*tag*) +: get a tag for the given repo. + + **Example Request**: + + GET /v1/repositories/foo/bar/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + Cookie: (Cookie provided by the Registry) + + Parameters: + + - **namespace** – namespace for the repo + - **repository** – name for the repo + - **tag** – name of tag you want to get + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Tag not found + + `DELETE /v1/repositories/`(*namespace*)`/`(*repository*)`/tags/`(*tag*) +: delete the tag for the repo + + **Example Request**: + + DELETE /v1/repositories/foo/bar/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + Parameters: + + - **namespace** – namespace for the repo + - **repository** – name for the repo + - **tag** – name of tag you want to delete + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Tag not found + + `PUT /v1/repositories/`(*namespace*)`/`(*repository*)`/tags/`(*tag*) +: put a tag for the given repo. + + **Example Request**: + + PUT /v1/repositories/foo/bar/tags/latest HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" + + Parameters: + + - **namespace** – namespace for the repo + - **repository** – name for the repo + - **tag** – name of tag you want to add + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + - **400** – Invalid data + - **401** – Requires authorization + - **404** – Image not found + +### Repositories + + `DELETE /v1/repositories/`(*namespace*)`/`(*repository*)`/` +: delete a repository + + **Example Request**: + + DELETE /v1/repositories/foo/bar/ HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + Cookie: (Cookie provided by the Registry) + + "" + + Parameters: + + - **namespace** – namespace for the repo + - **repository** – name for the repo + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + - **401** – Requires authorization + - **404** – Repository not found + +### Status + + `GET /v1/_ping` +: Check status of the registry. This endpoint is also used to + determine if the registry supports SSL. + + **Example Request**: + + GET /v1/_ping HTTP/1.1 + Host: registry-1.docker.io + Accept: application/json + Content-Type: application/json + + "" + + **Example Response**: + + HTTP/1.1 200 + Vary: Accept + Content-Type: application/json + X-Docker-Registry-Version: 0.6.0 + + "" + + Status Codes: + + - **200** – OK + +## Authorization + +This is where we describe the authorization process, including the +tokens and cookies. + +TODO: add more info. diff --git a/docs/sources/reference/api/registry_index_spec.md b/docs/sources/reference/api/registry_index_spec.md new file mode 100644 index 0000000000..84a40a7993 --- /dev/null +++ b/docs/sources/reference/api/registry_index_spec.md @@ -0,0 +1,691 @@ +page_title: Registry Documentation +page_description: Documentation for docker Registry and Registry API +page_keywords: docker, registry, api, index + +# Registry & Index Spec + +## The 3 roles + +### Index + +The Index is responsible for centralizing information about: + +- 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 + +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 + +- 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) + +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 + 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 + 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, 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 + for anyone), others private (accessible only for authorized users). + Authentication and authorization would be delegated to the Index. + The goal of vendor registries is to let someone do “docker pull + 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, + 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. + +The latter would only require two new commands in docker, e.g. +`registryget` and `registryput`, +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 + +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 + +## Workflow + +### Pull + +![](../../../_images/docker_pull_chart.png) + +1. Contact the Index to know where I should download “samalba/busybox” +2. Index replies: a. `samalba/busybox` is on + Registry A b. here are the checksums for `samalba/busybox` + (for all layers) c. token +3. Contact Registry A to receive the layers for + `samalba/busybox` (all of them to the base + image). Registry A is authoritative for “samalba/busybox” but keeps + a copy of all inherited layers and serve them all from the same + location. +4. registry contacts index to verify if token/user is allowed to + download images +5. Index returns true/false lettings registry know if it should proceed + or error out +6. Get the payload for all layers + +It’s possible to run: + + docker pull https:///repositories/samalba/busybox + +In this case, Docker bypasses the Index. However the security is not +guaranteed (in case Registry A is corrupted) because there won’t be any +checksum checks. + +Currently registry redirects to s3 urls for downloads, going forward all +downloads need to be streamed through the registry. The Registry will +then abstract the calls to S3 by a top-level class which implements +sub-classes for S3 and local storage. + +Token is only returned when the `X-Docker-Token` +header is sent with request. + +Basic Auth is required to pull private repos. Basic auth isn’t required +for pulling public repos, but if one is provided, it needs to be valid +and for an active account. + +#### API (pulling repository foo/bar): + +1. (Docker -\> Index) GET /v1/repositories/foo/bar/images + : **Headers**: + : Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== + X-Docker-Token: true + + **Action**: + : (looking up the foo/bar in db and gets images and checksums + for that repo (all if no tag is specified, if tag, only + checksums for those tags) see part 4.4.1) + +2. (Index -\> Docker) HTTP 200 OK + + > **Headers**: + > : - Authorization: Token + > signature=123abc,repository=”foo/bar”,access=write + > - X-Docker-Endpoints: registry.docker.io [, + > registry2.docker.io] + > + > **Body**: + > : Jsonified checksums (see part 4.4.1) + > +3. (Docker -\> Registry) GET /v1/repositories/foo/bar/tags/latest + : **Headers**: + : Authorization: Token + signature=123abc,repository=”foo/bar”,access=write + +4. (Registry -\> Index) GET /v1/repositories/foo/bar/images + + > **Headers**: + > : Authorization: Token + > signature=123abc,repository=”foo/bar”,access=read + > + > **Body**: + > : \ + > + > **Action**: + > : ( Lookup token see if they have access to pull.) + > + > If good: + > : HTTP 200 OK Index will invalidate the token + > + > If bad: + > : HTTP 401 Unauthorized + > +5. (Docker -\> Registry) GET /v1/images/928374982374/ancestry + : **Action**: + : (for each image id returned in the registry, fetch /json + + /layer) + +Note + +If someone makes a second request, then we will always give a new token, +never reuse tokens. + +### Push + +![](../../../_images/docker_push_chart.png) + +1. Contact the index to allocate the repository name “samalba/busybox” + (authentication required with user credentials) +2. If authentication works and namespace available, “samalba/busybox” + is allocated and a temporary token is returned (namespace is marked + as initialized in index) +3. Push the image on the registry (along with the token) +4. Registry A contacts the Index to verify the token (token must + corresponds to the repository name) +5. Index validates the token. Registry A starts reading the stream + 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:** +> **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, +it means that the push is in progress (since checksums are submitted at +the end). + +#### API (pushing repos foo/bar): + +1. (Docker -\> Index) PUT /v1/repositories/foo/bar/ + : **Headers**: + : Authorization: Basic sdkjfskdjfhsdkjfh== X-Docker-Token: + true + + **Action**:: + : - in index, we allocated a new repository, and set to + initialized + + **Body**:: + : (The body contains the list of images that are going to be + pushed, with empty checksums. The checksums will be set at + the end of the push): + + [{“id”: “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”}] + +2. (Index -\> Docker) 200 Created + : **Headers**: + : - WWW-Authenticate: Token + signature=123abc,repository=”foo/bar”,access=write + - X-Docker-Endpoints: registry.docker.io [, + registry2.docker.io] + +3. (Docker -\> Registry) PUT /v1/images/98765432\_parent/json + : **Headers**: + : Authorization: Token + signature=123abc,repository=”foo/bar”,access=write + +4. (Registry-\>Index) GET /v1/repositories/foo/bar/images + : **Headers**: + : Authorization: Token + signature=123abc,repository=”foo/bar”,access=write + + **Action**:: + : - Index: + : will invalidate the token. + + - 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 + signature=123abc,repository=”foo/bar”,access=write + - Cookie: (Cookie provided by the Registry) + +6. (Docker -\> Registry) PUT /v1/images/98765432/json + : **Headers**: + : Cookie: (Cookie provided by the Registry) + +7. (Docker -\> Registry) PUT /v1/images/98765432\_parent/layer + : **Headers**: + : Cookie: (Cookie provided by the Registry) + +8. (Docker -\> Registry) PUT /v1/images/98765432/layer + : **Headers**: + : X-Docker-Checksum: sha256:436745873465fdjkhdfjkgh + +9. (Docker -\> Registry) PUT /v1/repositories/foo/bar/tags/latest + : **Headers**: + : Cookie: (Cookie provided by the Registry) + + **Body**: + : “98765432” + +10. (Docker -\> Index) PUT /v1/repositories/foo/bar/images + + **Headers**: + : Authorization: Basic 123oislifjsldfj== X-Docker-Endpoints: + registry1.docker.io (no validation on this right now) + + **Body**: + : (The image, id’s, tags and checksums) + + [{“id”: + “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, + “checksum”: + “b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087”}] + + **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. + +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 + +If you need to delete something from the index or registry, we need a +nice clean way to do that. Here is the workflow. + +1. Docker contacts the index to request a delete of a repository + `samalba/busybox` (authentication required with + user credentials) +2. If authentication works and repository is valid, + `samalba/busybox` is marked as deleted and a + temporary token is returned +3. Send a delete request to the registry for the repository (along with + the token) +4. Registry A contacts the Index to verify the token (token must + corresponds to the repository name) +5. Index validates the token. Registry A deletes the repository and + everything associated to it. +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. + +#### API (deleting repository foo/bar): + +1. (Docker -\> Index) DELETE /v1/repositories/foo/bar/ + : **Headers**: + : Authorization: Basic sdkjfskdjfhsdkjfh== X-Docker-Token: + true + + **Action**:: + : - in index, we make sure it is a valid repository, and set + to deleted (logically) + + **Body**:: + : Empty + +2. (Index -\> Docker) 202 Accepted + : **Headers**: + : - WWW-Authenticate: Token + signature=123abc,repository=”foo/bar”,access=delete + - X-Docker-Endpoints: registry.docker.io [, + registry2.docker.io] \# list of endpoints where this + repo lives. + +3. (Docker -\> Registry) DELETE /v1/repositories/foo/bar/ + : **Headers**: + : Authorization: Token + signature=123abc,repository=”foo/bar”,access=delete + +4. (Registry-\>Index) PUT /v1/repositories/foo/bar/auth + : **Headers**: + : Authorization: Token + signature=123abc,repository=”foo/bar”,access=delete + + **Action**:: + : - Index: + : will invalidate the token. + + - Registry: + : deletes the repository (if token is approved) + +5. (Registry -\> Docker) 200 OK + : 200 If success 403 if forbidden 400 if bad request 404 if + repository isn’t found + +6. (Docker -\> Index) DELETE /v1/repositories/foo/bar/ + + > **Headers**: + > : Authorization: Basic 123oislifjsldfj== X-Docker-Endpoints: + > registry-1.docker.io (no validation on this right now) + > + > **Body**: + > : Empty + > + > **Return** HTTP 200 + +## 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 -\> + https://registry.docker.io/users/\/repositories/\/ + - team/projectname -\> + https://registry.docker.io/team/\/repositories/\/ + +- Authenticate a user as a repos owner (for a central referenced + repository) + +### 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 +controlled by Docker Inc. + +In this case, the registry will be launched in a special mode +(–standalone? –no-index?). In this mode, the only thing which changes is +that Registry will never contact the Index to verify a token. It will be +the Registry owner responsibility to authenticate the user who pushes +(or even pulls) an image using any mechanism (HTTP auth, IP based, +etc...). + +In this scenario, the Registry is responsible for the security in case +of data corruption since the checksums are not delivered by a trusted +entity. + +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 + +The Index data needed by the Registry are simple: + +- 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. + +The only challenge will be to tell Docker to contact (and trust) this +custom Index. Docker will be configurable at some point to use a +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 + +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 + +The format returned in the images is not defined here (for layer and +JSON), basically because Registry stores exactly the same kind of +information as Docker uses to manage them. + +The format of ancestry is a line-separated list of image ids, in age +order, i.e. the image’s parent is on the last line, the parent of the +parent on the next-to-last line, etc.; if the image has no parent, the +file is empty. + + GET /v1/images//layer + PUT /v1/images//layer + GET /v1/images//json + PUT /v1/images//json + GET /v1/images//ancestry + PUT /v1/images//ancestry + +### Users + +### Create a user (Index) + +POST /v1/users + +**Body**: +: {"email": "[sam@dotcloud.com](mailto:sam%40dotcloud.com)", + "password": "toto42", "username": "foobar"’} +**Validation**: +: - **username**: min 4 character, max 30 characters, must match the + regular expression [a-z0-9\_]. + - **password**: min 5 characters + +**Valid**: return HTTP 200 + +Errors: HTTP 400 (we should create error codes for possible errors) - +invalid json - missing field - wrong format (username, password, email, +etc) - forbidden name - name already exists + +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) + +PUT /v1/users/\ + +**Body**: +: {"password": "toto"} + +Note + +We can also update email address, if they do, they will need to reverify +their new email address. + +### 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. + +GET /v1/users + +**Return**: +: - Valid: HTTP 200 + - Invalid login: HTTP 401 + - Account inactive: HTTP 403 Account is not Active + +### Tags (Registry) + +The Registry does not know anything about users. Even though +repositories are under usernames, it’s just a namespace for the +registry. Allowing us to implement organizations or different namespaces +per user later, without modifying the Registry’s API. + +The following naming restrictions apply: + +- Namespaces must match the same regular expression as usernames (See + 4.2.1.) +- Repository names must match the regular expression [a-zA-Z0-9-\_.] + +### Get all tags: + +GET /v1/repositories/\/\/tags + +**Return**: HTTP 200 +: { "latest": + "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", + “0.1.1”: + “b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087” } + +#### 4.3.2 Read the content of a tag (resolve the image id) + +GET /v1/repositories/\/\/tags/\ + +**Return**: +: "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" + +#### 4.3.3 Delete a tag (registry) + +DELETE /v1/repositories/\/\/tags/\ + +### 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. + +#### 4.4.1 Get the images + +GET /v1/repositories/\/\/images + +**Return**: HTTP 200 +: [{“id”: + “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, + “checksum”: + “[md5:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087](md5:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087)”}] + +### Add/update the images: + +You always add images, you never remove them. + +PUT /v1/repositories/\/\/images + +**Body**: +: [ {“id”: + “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, + “checksum”: + “sha256:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087”} + ] + +**Return** 204 + +### Repositories + +### Remove a Repository (Registry) + +DELETE /v1/repositories/\/\ + +Return 200 OK + +### Remove a Repository (Index) + +This starts the delete process. see 2.3 for more details. + +DELETE /v1/repositories/\/\ + +Return 202 OK + +## Chaining Registries + +It’s possible to chain Registries server for several reasons: + +- 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 +download. + +The Index and Registry use this mechanism to redirect on one or the +other. + +Example with an image download: + +On every request, a special header can be returned: + + X-Docker-Endpoints: server1,server2 + +On the next request, the client will always pick a server from this +list. + +## Authentication & Authorization + +### On the Index + +The Index supports both “Basic” and “Token” challenges. Usually when +there is a `401 Unauthorized`, the Index replies +this: + + 401 Unauthorized + WWW-Authenticate: Basic realm="auth required",Token + +You have 3 options: + +1. Provide user credentials and ask for a token + + > **Header**: + > : - 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 + > signature=123abc,repository=”foo/bar”,access=read + > +2. Provide user credentials only + + > **Header**: + > : Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== + > +3. Provide Token + + > **Header**: + > : Authorization: Token + > signature=123abc,repository=”foo/bar”,access=read + > +### 6.2 On the Registry + +The Registry only supports the Token challenge: + + 401 Unauthorized + WWW-Authenticate: Token + +The only way is to provide a token on `401 Unauthorized` +responses: + + Authorization: Token signature=123abc,repository="foo/bar",access=read + +Usually, the Registry provides a Cookie when a Token verification +succeeded. Every time the Registry passes a Cookie, you have to pass it +back the same cookie.: + + 200 OK + Set-Cookie: session="wD/J7LqL5ctqw8haL10vgfhrb2Q=?foo=UydiYXInCnAxCi4=×tamp=RjEzNjYzMTQ5NDcuNDc0NjQzCi4="; Path=/; HttpOnly + +Next request: + + GET /(...) + Cookie: session="wD/J7LqL5ctqw8haL10vgfhrb2Q=?foo=UydiYXInCnAxCi4=×tamp=RjEzNjYzMTQ5NDcuNDc0NjQzCi4=" + +## Document Version + +- 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 new file mode 100644 index 0000000000..eb1e3a4ee1 --- /dev/null +++ b/docs/sources/reference/api/remote_api_client_libraries.md @@ -0,0 +1,89 @@ +page_title: Remote API Client Libraries +page_description: Various client libraries available to use with the Docker remote API +page_keywords: API, Docker, index, registry, REST, documentation, clients, Python, Ruby, JavaScript, Erlang, Go + +# Docker Remote API Client Libraries + +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/Framewor Name Repository Status + k + ----------------- ------------ ---------------------------------- ------- + Python docker-py [https://github.com/dotcloud/docke Active + r-py](https://github.com/dotcloud/ + docker-py) + + Ruby docker-clien [https://github.com/geku/docker-cl Outdate + t ient](https://github.com/geku/dock d + er-client) + + Ruby docker-api [https://github.com/swipely/docker Active + -api](https://github.com/swipely/d + ocker-api) + + JavaScript dockerode [https://github.com/apocas/dockero Active + (NodeJS) de](https://github.com/apocas/dock + erode) + Install via NPM: npm install + dockerode + + 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 + + JavaScript docker-js [https://github.com/dgoujard/docke Outdate + r-js](https://github.com/dgoujard/ d + docker-js) + + JavaScript docker-cp [https://github.com/13W/docker-cp] Active + (Angular) (https://github.com/13W/docker-cp) + **WebUI** + + JavaScript dockerui [https://github.com/crosbymichael/ Active + (Angular) dockerui](https://github.com/crosb + **WebUI** ymichael/dockerui) + + Java docker-java [https://github.com/kpelykh/docker Active + -java](https://github.com/kpelykh/ + docker-java) + + Erlang erldocker [https://github.com/proger/erldock Active + er](https://github.com/proger/erld + ocker) + + Go go-dockercli [https://github.com/fsouza/go-dock Active + ent erclient](https://github.com/fsouz + a/go-dockerclient) + + Go dockerclient [https://github.com/samalba/docker Active + client](https://github.com/samalba + /dockerclient) + + PHP Alvine [http://pear.alvine.io/](http://pe Active + ar.alvine.io/) + (alpha) + + PHP Docker-PHP [http://stage1.github.io/docker-ph Active + p/](http://stage1.github.io/docker + -php/) + + Perl Net::Docker [https://metacpan.org/pod/Net::Doc Active + ker](https://metacpan.org/pod/Net: + :Docker) + + Perl Eixo::Docker [https://github.com/alambike/eixo- Active + docker](https://github.com/alambik + e/eixo-docker) + + Scala reactive-doc [https://github.com/almoehi/reacti Active + ker ve-docker](https://github.com/almo + ehi/reactive-docker) + ------------------------------------------------------------------------- + + diff --git a/docs/sources/reference/builder.md b/docs/sources/reference/builder.md new file mode 100644 index 0000000000..2c55448a41 --- /dev/null +++ b/docs/sources/reference/builder.md @@ -0,0 +1,510 @@ +page_title: Dockerfile Reference +page_description: Dockerfiles use a simple DSL which allows you to automate the steps you would normally manually take to create an image. +page_keywords: builder, docker, Dockerfile, automation, image creation + +# Dockerfile Reference + +**Docker can act as a builder** and read instructions from a text +`Dockerfile` to automate the steps you would +otherwise take manually to create an image. Executing +`docker build` will run your steps and commit them +along the way, giving you a final image. + +## Usage + +To [*build*](../commandline/cli/#cli-build) an image from a source +repository, create a description file called `Dockerfile` +at the root of your repository. This file will describe the +steps to assemble the image. + +Then call `docker build` with the path of your +source repository as argument (for example, `.`): + +> `sudo docker build .` + +The path to the source repository defines where to find the *context* of +the build. The build is run by the Docker daemon, not by the CLI, so the +whole context must be transferred to the daemon. The Docker CLI reports +"Uploading context" when the context is sent to the daemon. + +You can specify a repository and tag at which to save the new image if +the build succeeds: + +> `sudo docker build -t shykes/myapp .` + +The Docker daemon will run your steps one-by-one, committing the result +to a new image if necessary, before finally outputting the ID of your +new image. The Docker daemon will automatically clean up the context you +sent. + +Note that each instruction is run independently, and causes a new image +to be created - so `RUN cd /tmp` will not have any +effect on the next instructions. + +Whenever possible, Docker will re-use the intermediate images, +accelerating `docker build` significantly (indicated +by `Using cache`): + + $ docker build -t SvenDowideit/ambassador . + Uploading context 10.24 kB + Uploading context + Step 1 : FROM docker-ut + ---> cbba202fe96b + Step 2 : MAINTAINER SvenDowideit@home.org.au + ---> Using cache + ---> 51182097be13 + Step 3 : CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \&/' | sh && top + ---> Using cache + ---> 1a5ffc17324d + Successfully built 1a5ffc17324d + +When you’re done with your build, you’re ready to look into [*Pushing a +repository to its +registry*](../../use/workingwithrepository/#image-push). + +## Format + +Here is the format of the Dockerfile: + + # Comment + INSTRUCTION arguments + +The Instruction is not case-sensitive, however convention is for them to +be UPPERCASE in order to distinguish them from arguments more easily. + +Docker evaluates the instructions in a Dockerfile in order. **The first +instruction must be \`FROM\`** in order to specify the [*Base +Image*](../../terms/image/#base-image-def) from which you are building. + +Docker will treat lines that *begin* with `#` as a +comment. A `#` marker anywhere else in the line will +be treated as an argument. This allows statements like: + + # Comment + RUN echo 'we are running some # of cool things' + +Here is the set of instructions you can use in a `Dockerfile` +for building images. + +## `FROM` + +> `FROM ` + +Or + +> `FROM :` + +The `FROM` instruction sets the [*Base +Image*](../../terms/image/#base-image-def) for subsequent instructions. +As such, a valid Dockerfile must have `FROM` as its +first instruction. The image can be any valid image – it is especially +easy to start by **pulling an image** from the [*Public +Repositories*](../../use/workingwithrepository/#using-public-repositories). + +`FROM` must be the first non-comment instruction in +the `Dockerfile`. + +`FROM` can appear multiple times within a single +Dockerfile in order to create multiple images. Simply make a note of the +last image id output by the commit before each new `FROM` +command. + +If no `tag` is given to the `FROM` +instruction, `latest` is assumed. If the +used tag does not exist, an error will be returned. + +## `MAINTAINER` + +> `MAINTAINER ` + +The `MAINTAINER` instruction allows you to set the +*Author* field of the generated images. + +## `RUN` + +RUN has 2 forms: + +- `RUN ` (the command is run in a shell - + `/bin/sh -c`) +- `RUN ["executable", "param1", "param2"]` (*exec* + form) + +The `RUN` instruction will execute any commands in a +new layer on top of the current image and commit the results. The +resulting committed image will be used for the next step in the +Dockerfile. + +Layering `RUN` instructions and generating commits +conforms to the core concepts of Docker where commits are cheap and +containers can be created from any point in an image’s history, much +like source control. + +The *exec* form makes it possible to avoid shell string munging, and to +`RUN` commands using a base image that does not +contain `/bin/sh`. + +### Known Issues (RUN) + +- [Issue 783](https://github.com/dotcloud/docker/issues/783) is about + file permissions problems that can occur when using the AUFS file + system. You might notice it during an attempt to `rm` + a file, for example. The issue describes a workaround. +- [Issue 2424](https://github.com/dotcloud/docker/issues/2424) Locale + will not be set automatically. + +## `CMD` + +CMD has three forms: + +- `CMD ["executable","param1","param2"]` (like an + *exec*, preferred form) +- `CMD ["param1","param2"]` (as *default + parameters to ENTRYPOINT*) +- `CMD command param1 param2` (as a *shell*) + +There can only be one CMD in a Dockerfile. If you list more than one CMD +then only the last CMD will take effect. + +**The main purpose of a CMD is to provide defaults for an executing +container.** These defaults can include an executable, or they can omit +the executable, in which case you must specify an ENTRYPOINT as well. + +When used in the shell or exec formats, the `CMD` +instruction sets the command to be executed when running the image. + +If you use the *shell* form of the CMD, then the `` +will execute in `/bin/sh -c`: + + FROM ubuntu + CMD echo "This is a test." | wc - + +If you want to **run your** `` **without a +shell** then you must express the command as a JSON array and give the +full path to the executable. **This array form is the preferred format +of CMD.** Any additional parameters must be individually expressed as +strings in the array: + + FROM ubuntu + CMD ["/usr/bin/wc","--help"] + +If you would like your container to run the same executable every time, +then you should consider using `ENTRYPOINT` in +combination with `CMD`. See +[*ENTRYPOINT*](#dockerfile-entrypoint). + +If the user specifies arguments to `docker run` then +they will override the default specified in CMD. + +Note + +Don’t confuse `RUN` with `CMD`. +`RUN` actually runs a command and commits the +result; `CMD` does not execute anything at build +time, but specifies the intended command for the image. + +## `EXPOSE` + +> `EXPOSE [...]` + +The `EXPOSE` instructions informs Docker that the +container will listen on the specified network ports at runtime. Docker +uses this information to interconnect containers using links (see +[*links*](../../use/working_with_links_names/#working-with-links-names)), +and to setup port redirection on the host system (see [*Redirect +Ports*](../../use/port_redirection/#port-redirection)). + +## `ENV` + +> `ENV ` + +The `ENV` instruction sets the environment variable +`` to the value ``. +This value will be passed to all future `RUN` +instructions. This is functionally equivalent to prefixing the command +with `=` + +The environment variables set using `ENV` will +persist when a container is run from the resulting image. You can view +the values using `docker inspect`, and change them +using `docker run --env =`. + +Note + +One example where this can cause unexpected consequenses, is setting +`ENV DEBIAN_FRONTEND noninteractive`. Which will +persist when the container is run interactively; for example: +`docker run -t -i image bash` + +## `ADD` + +> `ADD ` + +The `ADD` instruction will copy new files from +\ and add them to the container’s filesystem at path +``. + +`` must be the path to a file or directory +relative to the source directory being built (also called the *context* +of the build) or a remote file URL. + +`` is the absolute path to which the source +will be copied inside the destination container. + +All new files and directories are created with mode 0755, uid and gid 0. + +Note + +if you build using STDIN (`docker build - < somefile` +.literal}), there is no build context, so the Dockerfile can only +contain an URL based ADD statement. + +Note + +if your URL files are protected using authentication, you will need to +use an `RUN wget` , `RUN curl` +or other tool from within the container as ADD does not support +authentication. + +The copy obeys the following rules: + +- The `` path must be inside the *context* of + the build; you cannot `ADD ../something /something` +, because the first step of a `docker build` + is to send the context directory (and subdirectories) to + the docker daemon. + +- If `` is a URL and `` + does not end with a trailing slash, then a file is + downloaded from the URL and copied to ``. + +- If `` is a URL and `` + does end with a trailing slash, then the filename is + inferred from the URL and the file is downloaded to + `/`. For instance, + `ADD http://example.com/foobar /` would create + the file `/foobar`. The URL must have a + nontrivial path so that an appropriate filename can be discovered in + this case (`http://example.com` will not work). + +- If `` is a directory, the entire directory + is copied, including filesystem metadata. + +- If `` is a *local* tar archive in a + recognized compression format (identity, gzip, bzip2 or xz) then it + is unpacked as a directory. Resources from *remote* URLs are **not** + decompressed. + + When a directory is copied or unpacked, it has the same behavior as + `tar -x`: the result is the union of + + 1. whatever existed at the destination path and + 2. the contents of the source tree, + + with conflicts resolved in favor of "2." on a file-by-file basis. + +- If `` is any other kind of file, it is + copied individually along with its metadata. In this case, if + `` ends with a trailing slash + `/`, it will be considered a directory and the + contents of `` will be written at + `/base()`. + +- If `` does not end with a trailing slash, + it will be considered a regular file and the contents of + `` will be written at `` +. + +- If `` doesn’t exist, it is created along + with all missing directories in its path. + +## `ENTRYPOINT` + +ENTRYPOINT has two forms: + +- `ENTRYPOINT ["executable", "param1", "param2"]` + (like an *exec*, preferred form) +- `ENTRYPOINT command param1 param2` (as a + *shell*) + +There can only be one `ENTRYPOINT` in a Dockerfile. +If you have more than one `ENTRYPOINT`, then only +the last one in the Dockerfile will have an effect. + +An `ENTRYPOINT` helps you to configure a container +that you can run as an executable. That is, when you specify an +`ENTRYPOINT`, then the whole container runs as if it +was just that executable. + +The `ENTRYPOINT` instruction adds an entry command +that will **not** be overwritten when arguments are passed to +`docker run`, unlike the behavior of `CMD` +.literal}. This allows arguments to be passed to the entrypoint. i.e. +`docker run -d` will pass the "-d" argument +to the ENTRYPOINT. + +You can specify parameters either in the ENTRYPOINT JSON array (as in +"like an exec" above), or by using a CMD statement. Parameters in the +ENTRYPOINT will not be overridden by the `docker run` +arguments, but parameters specified via CMD will be overridden +by `docker run` arguments. + +Like a `CMD`, you can specify a plain string for the +ENTRYPOINT and it will execute in `/bin/sh -c`: + + FROM ubuntu + ENTRYPOINT wc -l - + +For example, that Dockerfile’s image will *always* take stdin as input +("-") and print the number of lines ("-l"). If you wanted to make this +optional but default, you could use a CMD: + + FROM ubuntu + CMD ["-l", "-"] + ENTRYPOINT ["/usr/bin/wc"] + +## `VOLUME` + +> `VOLUME ["/data"]` + +The `VOLUME` instruction will create a mount point +with the specified name and mark it as holding externally mounted +volumes from native host or other containers. For more +information/examples and mounting instructions via docker client, refer +to [*Share Directories via +Volumes*](../../use/working_with_volumes/#volume-def) documentation. + +## `USER` + +> `USER daemon` + +The `USER` instruction sets the username or UID to +use when running the image. + +## `WORKDIR` + +> `WORKDIR /path/to/workdir` + +The `WORKDIR` instruction sets the working directory +for the `RUN`, `CMD` and +`ENTRYPOINT` Dockerfile commands that follow it. + +It can be used multiple times in the one Dockerfile. If a relative path +is provided, it will be relative to the path of the previous +`WORKDIR` instruction. For example: + +> WORKDIR /a WORKDIR b WORKDIR c RUN pwd + +The output of the final `pwd` command in this +Dockerfile would be `/a/b/c`. + +## `ONBUILD` + +> `ONBUILD [INSTRUCTION]` + +The `ONBUILD` instruction adds to the image a +"trigger" instruction to be executed at a later time, when the image is +used as the base for another build. The trigger will be executed in the +context of the downstream build, as if it had been inserted immediately +after the *FROM* instruction in the downstream Dockerfile. + +Any build instruction can be registered as a trigger. + +This is useful if you are building an image which will be used as a base +to build other images, for example an application build environment or a +daemon which may be customized with user-specific configuration. + +For example, if your image is a reusable python application builder, it +will require application source code to be added in a particular +directory, and it might require a build script to be called *after* +that. You can’t just call *ADD* and *RUN* now, because you don’t yet +have access to the application source code, and it will be different for +each application build. You could simply provide application developers +with a boilerplate Dockerfile to copy-paste into their application, but +that is inefficient, error-prone and difficult to update because it +mixes with application-specific code. + +The solution is to use *ONBUILD* to register in advance instructions to +run later, during the next build stage. + +Here’s how it works: + +1. When it encounters an *ONBUILD* instruction, the builder adds a + trigger to the metadata of the image being built. The instruction + does not otherwise affect the current build. +2. At the end of the build, a list of all triggers is stored in the + image manifest, under the key *OnBuild*. They can be inspected with + *docker inspect*. +3. Later the image may be used as a base for a new build, using the + *FROM* instruction. As part of processing the *FROM* instruction, + the downstream builder looks for *ONBUILD* triggers, and executes + them in the same order they were registered. If any of the triggers + fail, the *FROM* instruction is aborted which in turn causes the + build to fail. If all triggers succeed, the FROM instruction + completes and the build continues as usual. +4. Triggers are cleared from the final image after being executed. In + other words they are not inherited by "grand-children" builds. + +For example you might add something like this: + + [...] + ONBUILD ADD . /app/src + ONBUILD RUN /usr/local/bin/python-build --dir /app/src + [...] + +Warning + +Chaining ONBUILD instructions using ONBUILD ONBUILD isn’t allowed. + +Warning + +ONBUILD may not trigger FROM or MAINTAINER instructions. + +## Dockerfile Examples + + # Nginx + # + # VERSION 0.0.1 + + FROM ubuntu + MAINTAINER Guillaume J. Charmes + + # make sure the package repository is up to date + RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list + RUN apt-get update + + RUN apt-get install -y inotify-tools nginx apache2 openssh-server + + # Firefox over VNC + # + # VERSION 0.3 + + FROM ubuntu + # make sure the package repository is up to date + RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list + RUN apt-get update + + # Install vnc, xvfb in order to create a 'fake' display and firefox + RUN apt-get install -y x11vnc xvfb firefox + RUN mkdir /.vnc + # Setup a password + RUN x11vnc -storepasswd 1234 ~/.vnc/passwd + # Autostart firefox (might not be the best way, but it does the trick) + RUN bash -c 'echo "firefox" >> /.bashrc' + + EXPOSE 5900 + CMD ["x11vnc", "-forever", "-usepw", "-create"] + + # Multiple images example + # + # VERSION 0.1 + + FROM ubuntu + RUN echo foo > bar + # Will output something like ===> 907ad6c2736f + + FROM ubuntu + RUN echo moo > oink + # Will output something like ===> 695d7793cbe4 + + # You'll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with + # /oink. diff --git a/docs/sources/reference/commandline.md b/docs/sources/reference/commandline.md new file mode 100644 index 0000000000..8620a095b9 --- /dev/null +++ b/docs/sources/reference/commandline.md @@ -0,0 +1,7 @@ + +# Commands + +## Contents: + +- [Command Line](cli/) + diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md new file mode 100644 index 0000000000..6bb0dc9e22 --- /dev/null +++ b/docs/sources/reference/commandline/cli.md @@ -0,0 +1,1170 @@ +page_title: Command Line Interface +page_description: Docker's CLI command description and usage +page_keywords: Docker, Docker documentation, CLI, command line + +# Command Line + +To list available commands, either run `docker` with +no parameters or execute `docker help`: + + $ sudo docker + Usage: docker [OPTIONS] COMMAND [arg...] + -H=[unix:///var/run/docker.sock]: tcp://[host]:port to bind/connect to or unix://[/path/to/socket] to use. When host=[127.0.0.1] is omitted for tcp or path=[/var/run/docker.sock] is omitted for unix sockets, default values are used. + + A self-sufficient runtime for linux containers. + + ... + +## Option types + +Single character commandline options can be combined, so rather than +typing `docker run -t -i --name test busybox sh`, +you can write `docker run -ti --name test busybox sh` +.literal}. + +### Boolean + +Boolean options look like `-d=false`. The value you +see is the default value which gets set if you do **not** use the +boolean flag. If you do call `run -d`, that sets the +opposite boolean value, so in this case, `true`, and +so `docker run -d` **will** run in "detached" mode, +in the background. Other boolean options are similar – specifying them +will set the value to the opposite of the default value. + +### Multi + +Options like `-a=[]` indicate they can be specified +multiple times: + + docker run -a stdin -a stdout -a stderr -i -t ubuntu /bin/bash + +Sometimes this can use a more complex value string, as for +`-v`: + + docker run -v /host:/container example/mysql + +### Strings and Integers + +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. + +## `daemon` + + Usage of docker: + -D, --debug=false: Enable debug mode + -H, --host=[]: Multiple tcp://host:port or unix://path/to/socket to bind in daemon mode, single connection otherwise. systemd socket activation can be used with fd://[socketfd]. + -G, --group="docker": Group to assign the unix socket specified by -H when running in daemon mode; use '' (the empty string) to disable setting of a group + --api-enable-cors=false: Enable CORS headers in the remote API + -b, --bridge="": Attach containers to a pre-existing network bridge; use 'none' to disable container networking + -bip="": Use this CIDR notation address for the network bridge's IP, not compatible with -b + -d, --daemon=false: Enable daemon mode + --dns=[]: Force docker to use specific DNS servers + --dns-search=[]: Force Docker to use specific DNS search domains + -g, --graph="/var/lib/docker": Path to use as the root of the docker runtime + --icc=true: Enable inter-container communication + --ip="0.0.0.0": Default IP address to use when binding container ports + --ip-forward=true: Enable net.ipv4.ip_forward + --iptables=true: Enable Docker's addition of iptables rules + -p, --pidfile="/var/run/docker.pid": Path to use for daemon PID file + -r, --restart=true: Restart previously running containers + -s, --storage-driver="": Force the docker runtime to use a specific storage driver + -e, --exec-driver="native": Force the docker runtime to use a specific exec driver + -v, --version=false: Print version information and quit + --tls=false: Use TLS; implied by tls-verify flags + --tlscacert="~/.docker/ca.pem": Trust only remotes providing a certificate signed by the CA given here + --tlscert="~/.docker/cert.pem": Path to TLS certificate file + --tlskey="~/.docker/key.pem": Path to TLS key file + --tlsverify=false: Use TLS and verify the remote (daemon: verify client, client: verify daemon) + --mtu=0: Set the containers network MTU; if no value is provided: default to the default route MTU or 1500 if no default route is available + +The Docker daemon is the persistent process that manages containers. +Docker uses the same binary for both the daemon and client. To run the +daemon you provide the `-d` flag. + +To force Docker to use devicemapper as the storage driver, use +`docker -d -s devicemapper`. + +To set the DNS server for all Docker containers, use +`docker -d --dns 8.8.8.8`. + +To set the DNS search domain for all Docker containers, use +`docker -d --dns-search example.com`. + +To run the daemon with debug output, use `docker -d -D` +.literal}. + +To use lxc as the execution driver, use `docker -d -e lxc` +.literal}. + +The docker client will also honor the `DOCKER_HOST` +environment variable to set the `-H` flag for the +client. + + docker -H tcp://0.0.0.0:4243 ps + # or + export DOCKER_HOST="tcp://0.0.0.0:4243" + docker ps + # both are equal + +To run the daemon with [systemd socket +activation](http://0pointer.de/blog/projects/socket-activation.html), +use `docker -d -H fd://`. Using `fd://` +will work perfectly for most setups but you can also specify +individual sockets too `docker -d -H fd://3`. If the +specified socket activated files aren’t found then docker will exit. You +can find examples of using systemd socket activation with docker and +systemd in the [docker source +tree](https://github.com/dotcloud/docker/blob/master/contrib/init/systemd/socket-activation/). + +Docker supports softlinks for the Docker data directory +(`/var/lib/docker`) and for `/tmp` +.literal}. TMPDIR and the data directory can be set like this: + + TMPDIR=/mnt/disk2/tmp /usr/local/bin/docker -d -D -g /var/lib/docker -H unix:// > /var/lib/boot2docker/docker.log 2>&1 + # or + export TMPDIR=/mnt/disk2/tmp + /usr/local/bin/docker -d -D -g /var/lib/docker -H unix:// > /var/lib/boot2docker/docker.log 2>&1 + +## `attach` + + Usage: docker attach 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) + +The `attach` command will allow you to view or +interact with any running container, detached (`-d`) +or interactive (`-i`). You can attach to the same +container at the same time - screen sharing style, or quickly view the +progress of your daemonized process. + +You can detach from the container again (and leave it running) with +`CTRL-C` (for a quiet exit) or `CTRL-\` +to get a stacktrace of the Docker client when it quits. When +you detach from the container’s process the exit code will be returned +to the client. + +To stop a container, use `docker stop`. + +To kill the container, use `docker kill`. + +### Examples: + + $ ID=$(sudo docker run -d ubuntu /usr/bin/top -b) + $ sudo docker attach $ID + top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355560k used, 18012k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221740k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17200 1116 912 R 0 0.3 0:00.03 top + + top - 02:05:55 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.0%us, 0.2%sy, 0.0%ni, 99.8%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355244k used, 18328k free, 27872k buffers + Swap: 786428k total, 0k used, 786428k free, 221776k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top + + + top - 02:05:58 up 3:06, 0 users, load average: 0.01, 0.02, 0.05 + Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie + Cpu(s): 0.2%us, 0.3%sy, 0.0%ni, 99.5%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st + Mem: 373572k total, 355780k used, 17792k free, 27880k buffers + Swap: 786428k total, 0k used, 786428k free, 221776k cached + + PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND + 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top + ^C$ + $ sudo docker stop $ID + +## `build` + + Usage: docker build [OPTIONS] PATH | URL | - + Build a new container image from the source code at PATH + -t, --tag="": Repository name (and optionally a tag) to be applied + to the resulting image in case of success. + -q, --quiet=false: Suppress the verbose output generated by the containers. + --no-cache: Do not use the cache when building the image. + --rm=true: Remove intermediate containers after a successful build + +Use this command to build Docker images from a `Dockerfile` +and a "context". + +The files at `PATH` or `URL` are +called the "context" of the build. The build process may refer to any of +the files in the context, for example when using an +[*ADD*](../../builder/#dockerfile-add) instruction. When a single +`Dockerfile` is given as `URL`, +then no context is set. + +When a Git repository is set as `URL`, then the +repository is used as the context. The Git repository is cloned with its +submodules (git clone –recursive). A fresh git clone occurs in a +temporary directory on your local host, and then this is sent to the +Docker daemon as the context. This way, your local user credentials and +vpn’s etc can be used to access private repositories + +See also + +[*Dockerfile Reference*](../../builder/#dockerbuilder). + +### Examples: + + $ sudo docker build . + Uploading context 10240 bytes + Step 1 : FROM busybox + Pulling repository busybox + ---> e9aa60c60128MB/2.284 MB (100%) endpoint: https://cdn-registry-1.docker.io/v1/ + Step 2 : RUN ls -lh / + ---> Running in 9c9e81692ae9 + total 24 + drwxr-xr-x 2 root root 4.0K Mar 12 2013 bin + drwxr-xr-x 5 root root 4.0K Oct 19 00:19 dev + drwxr-xr-x 2 root root 4.0K Oct 19 00:19 etc + drwxr-xr-x 2 root root 4.0K Nov 15 23:34 lib + lrwxrwxrwx 1 root root 3 Mar 12 2013 lib64 -> lib + dr-xr-xr-x 116 root root 0 Nov 15 23:34 proc + lrwxrwxrwx 1 root root 3 Mar 12 2013 sbin -> bin + dr-xr-xr-x 13 root root 0 Nov 15 23:34 sys + drwxr-xr-x 2 root root 4.0K Mar 12 2013 tmp + drwxr-xr-x 2 root root 4.0K Nov 15 23:34 usr + ---> b35f4035db3f + Step 3 : CMD echo Hello World + ---> Running in 02071fceb21b + ---> f52f38b7823e + Successfully built f52f38b7823e + Removing intermediate container 9c9e81692ae9 + Removing intermediate container 02071fceb21b + +This example specifies that the `PATH` is +`.`, and so all the files in the local directory get +tar’d and sent to the Docker daemon. The `PATH` +specifies where to find the files for the "context" of the build on the +Docker daemon. Remember that the daemon could be running on a remote +machine and that no parsing of the `Dockerfile` +happens at the client side (where you’re running +`docker build`). That means that *all* the files at +`PATH` get sent, not just the ones listed to +[*ADD*](../../builder/#dockerfile-add) in the `Dockerfile` +.literal}. + +The transfer of context from the local machine to the Docker daemon is +what the `docker` client means when you see the +"Uploading context" message. + +If you wish to keep the intermediate containers after the build is +complete, you must use `--rm=false`. This does not +affect the build cache. + + $ sudo docker build -t vieux/apache:2.0 . + +This will build like the previous example, but it will then tag the +resulting image. The repository name will be `vieux/apache` +and the tag will be `2.0` + + $ sudo docker build - < Dockerfile + +This will read a `Dockerfile` from *stdin* without +context. Due to the lack of a context, no contents of any local +directory will be sent to the `docker` daemon. Since +there is no context, a `Dockerfile` `ADD` +only works if it refers to a remote URL. + + $ sudo docker build github.com/creack/docker-firefox + +This will clone the GitHub repository and use the cloned repository as +context. The `Dockerfile` at the root of the +repository is used as `Dockerfile`. Note that you +can specify an arbitrary Git repository by using the `git://` +schema. + +## `commit` + + Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] + + Create a new image from a container's changes + + -m, --message="": Commit message + -a, --author="": Author (eg. "John Hannibal Smith " + +It can be useful to commit a container’s file changes or settings into a +new image. This allows you debug a container by running an interactive +shell, or to export a working dataset to another server. Generally, it +is better to use Dockerfiles to manage your images in a documented and +maintainable way. + +### Commit an existing container + + $ sudo docker ps + ID IMAGE COMMAND CREATED STATUS PORTS + c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours + $ docker commit c3f279d17e0a SvenDowideit/testimage:version3 + f5283438590d + $ docker images | head + REPOSITORY TAG ID CREATED VIRTUAL SIZE + SvenDowideit/testimage version3 f5283438590d 16 seconds ago 335.7 MB + +## `cp` + + Usage: docker cp CONTAINER:PATH HOSTPATH + + Copy files/folders from the containers filesystem to the host + path. Paths are relative to the root of the filesystem. + + $ sudo docker cp 7bb0e258aefe:/etc/debian_version . + $ sudo docker cp blue_frog:/etc/hosts . + +## `diff` + + Usage: docker diff CONTAINER + + List the changed files and directories in a container's filesystem + +There are 3 events that are listed in the ‘diff’: + +1. `` `A` `` - Add +2. `` `D` `` - Delete +3. `` `C` `` - Change + +For example: + + $ sudo docker diff 7bb0e258aefe + + C /dev + A /dev/kmsg + C /etc + A /etc/mtab + A /go + A /go/src + A /go/src/github.com + A /go/src/github.com/dotcloud + A /go/src/github.com/dotcloud/docker + A /go/src/github.com/dotcloud/docker/.git + .... + +## `events` + + Usage: docker events + + Get real time events from the server + + --since="": Show all events created since timestamp + (either seconds since epoch, or date string as below) + --until="": Show events created before timestamp + (either seconds since epoch, or date string as below) + +### Examples + +You’ll need two shells for this example. + +#### Shell 1: Listening for events + + $ sudo docker events + +#### Shell 2: Start and Stop a Container + + $ sudo docker start 4386fb97867d + $ sudo docker stop 4386fb97867d + +#### Shell 1: (Again .. now showing events) + + [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop + +#### Show events in the past from a specified time + + $ sudo docker events --since 1378216169 + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop + + $ sudo docker events --since '2013-09-03' + [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop + + $ sudo docker events --since '2013-09-03 15:49:29 +0200 CEST' + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die + [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop + +## `export` + + Usage: docker export CONTAINER + + Export the contents of a filesystem as a tar archive to STDOUT + +For example: + + $ sudo docker export red_panda > latest.tar + +## `history` + + Usage: docker history [OPTIONS] IMAGE + + Show the history of an image + + --no-trunc=false: Don't truncate output + -q, --quiet=false: Only show numeric IDs + +To see how the `docker:latest` image was built: + + $ docker history docker + IMAGE CREATED CREATED BY SIZE + 3e23a5875458790b7a806f95f7ec0d0b2a5c1659bfc899c89f939f6d5b8f7094 8 days ago /bin/sh -c #(nop) ENV LC_ALL=C.UTF-8 0 B + 8578938dd17054dce7993d21de79e96a037400e8d28e15e7290fea4f65128a36 8 days ago /bin/sh -c dpkg-reconfigure locales && locale-gen C.UTF-8 && /usr/sbin/update-locale LANG=C.UTF-8 1.245 MB + be51b77efb42f67a5e96437b3e102f81e0a1399038f77bf28cea0ed23a65cf60 8 days ago /bin/sh -c apt-get update && apt-get install -y git libxml2-dev python build-essential make gcc python-dev locales python-pip 338.3 MB + 4b137612be55ca69776c7f30c2d2dd0aa2e7d72059820abf3e25b629f887a084 6 weeks ago /bin/sh -c #(nop) ADD jessie.tar.xz in / 121 MB + 750d58736b4b6cc0f9a9abe8f258cef269e3e9dceced1146503522be9f985ada 6 weeks ago /bin/sh -c #(nop) MAINTAINER Tianon Gravi - mkimage-debootstrap.sh -t jessie.tar.xz jessie http://http.debian.net/debian 0 B + 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158 9 months ago 0 B + +## `images` + + Usage: docker images [OPTIONS] [NAME] + + List images + + -a, --all=false: Show all images (by default filter out the intermediate image layers) + --no-trunc=false: Don't truncate output + -q, --quiet=false: Only show numeric IDs + +The default `docker images` will show all top level +images, their repository and tags, and their virtual size. + +Docker images have intermediate layers that increase reuseability, +decrease disk usage, and speed up `docker build` by +allowing each step to be cached. These intermediate layers are not shown +by default. + +### Listing the most recently created images + + $ sudo docker images | head + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + 77af4d6b9913 19 hours ago 1.089 GB + committest latest b6fa739cedf5 19 hours ago 1.089 GB + 78a85c484f71 19 hours ago 1.089 GB + docker latest 30557a29d5ab 20 hours ago 1.089 GB + 0124422dd9f9 20 hours ago 1.089 GB + 18ad6fad3402 22 hours ago 1.082 GB + f9f1e26352f0 23 hours ago 1.089 GB + tryout latest 2629d1fa0b81 23 hours ago 131.5 MB + 5ed6274db6ce 24 hours ago 1.089 GB + +### Listing the full length image IDs + + $ sudo docker images --no-trunc | head + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + 77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB + committest latest b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB + 78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB + docker latest 30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB + 0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB + 18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB + f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB + tryout latest 2629d1fa0b81b222fca63371ca16cbf6a0772d07759ff80e8d1369b926940074 23 hours ago 131.5 MB + 5ed6274db6ceb2397844896966ea239290555e74ef307030ebb01ff91b1914df 24 hours ago 1.089 GB + +## `import` + + Usage: docker import URL|- [REPOSITORY[:TAG]] + + Create an empty filesystem image and import the contents of the tarball + (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it. + +URLs must start with `http` and point to a single +file archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, or .txz) containing a +root filesystem. If you would like to import from a local directory or +archive, you can use the `-` parameter to take the +data from *stdin*. + +### Examples + +#### Import from a remote location + +This will create a new untagged image. + + $ sudo docker import http://example.com/exampleimage.tgz + +#### Import from a local file + +Import to docker via pipe and *stdin*. + + $ cat exampleimage.tgz | sudo docker import - exampleimagelocal:new + +#### Import from a local directory + + $ sudo tar -c . | docker import - exampleimagedir + +Note the `sudo` in this example – you must preserve +the ownership of the files (especially root ownership) during the +archiving with tar. If you are not root (or the sudo command) when you +tar, then the ownerships might not get preserved. + +## `info` + + Usage: docker info + + Display system-wide information. + + $ sudo docker info + Containers: 292 + Images: 194 + Debug mode (server): false + Debug mode (client): false + Fds: 22 + Goroutines: 67 + LXC Version: 0.9.0 + EventsListeners: 115 + Kernel Version: 3.8.0-33-generic + WARNING: No swap limit support + +When sending issue reports, please use `docker version` +and `docker info` to ensure we know how +your setup is configured. + +## `inspect` + + Usage: docker inspect CONTAINER|IMAGE [CONTAINER|IMAGE...] + + Return low-level information on a container/image + + -f, --format="": Format the output using the given go template. + +By default, this will render all results in a JSON array. If a format is +specified, the given template will be executed for each result. + +Go’s [text/template](http://golang.org/pkg/text/template/) package +describes all the details of the format. + +### Examples + +#### Get an instance’s IP Address + +For the most part, you can pick out any field from the JSON in a fairly +straightforward manner. + + $ sudo docker inspect --format='{{.NetworkSettings.IPAddress}}' $INSTANCE_ID + +#### List All Port Bindings + +One can loop over arrays and maps in the results to produce simple text +output: + + $ sudo docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID + +#### Find a Specific Port Mapping + +The `.Field` syntax doesn’t work when the field name +begins with a number, but the template language’s `index` +function does. The `.NetworkSettings.Ports` +section contains a map of the internal port mappings to a list +of external address/port objects, so to grab just the numeric public +port, you use `index` to find the specific port map, +and then `index` 0 contains first object inside of +that. Then we ask for the `HostPort` field to get +the public address. + + $ sudo docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID + +#### Get config + +The `.Field` syntax doesn’t work when the field +contains JSON data, but the template language’s custom `json` +function does. The `.config` section +contains complex json object, so to grab it as JSON, you use +`json` to convert config object into JSON + + $ sudo docker inspect --format='{{json .config}}' $INSTANCE_ID + +## `kill` + + Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...] + + Kill a running container (send SIGKILL, or specified signal) + + -s, --signal="KILL": Signal to send to the container + +The main process inside the container will be sent SIGKILL, or any +signal specified with option `--signal`. + +### Known Issues (kill) + +- [Issue 197](https://github.com/dotcloud/docker/issues/197) indicates + that `docker kill` may leave directories behind + and make it difficult to remove the container. +- [Issue 3844](https://github.com/dotcloud/docker/issues/3844) lxc + 1.0.0 beta3 removed `lcx-kill` which is used by + Docker versions before 0.8.0; see the issue for a workaround. + +## `load` + + Usage: docker load + + Load an image from a tar archive on STDIN + + -i, --input="": Read from a tar archive file, instead of STDIN + +Loads a tarred repository from a file or the standard input stream. +Restores both images and tags. + + $ sudo docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + $ sudo docker load < busybox.tar + $ sudo docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + $ sudo docker load --input fedora.tar + $ sudo docker images + REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE + busybox latest 769b9341d937 7 weeks ago 2.489 MB + fedora rawhide 0d20aec6529d 7 weeks ago 387 MB + fedora 20 58394af37342 7 weeks ago 385.5 MB + fedora heisenbug 58394af37342 7 weeks ago 385.5 MB + fedora latest 58394af37342 7 weeks ago 385.5 MB + +## `login` + + Usage: docker login [OPTIONS] [SERVER] + + Register or Login to the docker registry server + + -e, --email="": Email + -p, --password="": Password + -u, --username="": Username + + If you want to login to a private registry you can + specify this by adding the server name. + + example: + docker login localhost:8080 + +## `logs` + + Usage: docker logs [OPTIONS] CONTAINER + + Fetch the logs of a container + + -f, --follow=false: Follow log output + +The `docker logs` command batch-retrieves all logs +present at the time of execution. + +The `docker logs --follow` command combines +`docker logs` and `docker attach` +.literal}: it will first return all logs from the beginning and then +continue streaming new output from the container’s stdout and stderr. + +## `port` + + Usage: docker port [OPTIONS] CONTAINER PRIVATE_PORT + + Lookup the public-facing port which is NAT-ed to PRIVATE_PORT + +## `ps` + + Usage: docker ps [OPTIONS] + + List containers + + -a, --all=false: Show all containers. Only running containers are shown by default. + --before="": Show only container created before Id or Name, include non-running ones. + -l, --latest=false: Show only the latest created container, include non-running ones. + -n=-1: Show n last created containers, include non-running ones. + --no-trunc=false: Don't truncate output + -q, --quiet=false: Only display numeric IDs + -s, --size=false: Display sizes, not to be used with -q + --since="": Show only containers created since Id or Name, include non-running ones. + +Running `docker ps` showing 2 linked containers. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp + d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db + +`docker ps` will show only running containers by +default. To see all containers: `docker ps -a` + +## `pull` + + Usage: docker pull NAME[:TAG] + + Pull an image or a repository from the registry + +Most of your images will be created on top of a base image from the +\([https://index.docker.io](https://index.docker.io)). + +The Docker Index contains many pre-built images that you can +`pull` and try without needing to define and +configure your own. + +To download a particular image, or set of images (i.e., a repository), +use `docker pull`: + + $ docker pull debian + # will pull all the images in the debian repository + $ docker pull debian:testing + # will pull only the image named debian:testing and any intermediate layers + # it is based on. (typically the empty `scratch` image, a MAINTAINERs layer, + # and the un-tared base. + +## `push` + + Usage: docker push NAME[:TAG] + + Push an image or a repository to the registry + +Use `docker push` to share your images on public or +private registries. + +## `restart` + + Usage: docker restart [OPTIONS] NAME + + Restart a running container + + -t, --time=10: Number of seconds to try to stop for before killing the container. Once killed it will then be restarted. Default=10 + +## `rm` + + Usage: docker rm [OPTIONS] CONTAINER + + Remove one or more containers + -l, --link="": Remove the link instead of the actual container + -f, --force=false: Force removal of running container + -v, --volumes=false: Remove the volumes associated to the container + +### Known Issues (rm) + +- [Issue 197](https://github.com/dotcloud/docker/issues/197) indicates + that `docker kill` may leave directories behind + and make it difficult to remove the container. + +### Examples: + + $ sudo docker rm /redis + /redis + +This will remove the container referenced under the link +`/redis`. + + $ sudo docker rm --link /webapp/redis + /webapp/redis + +This will remove the underlying link between `/webapp` +and the `/redis` containers removing all +network communication. + + $ sudo docker rm $(docker ps -a -q) + +This command will delete all stopped containers. The command +`docker ps -a -q` will return all existing container +IDs and pass them to the `rm` command which will +delete them. Any running containers will not be deleted. + +## `rmi` + + Usage: docker rmi IMAGE [IMAGE...] + + Remove one or more images + + -f, --force=false: Force + --no-prune=false: Do not delete untagged parents + +### Removing tagged images + +Images can be removed either by their short or long ID’s, or their image +names. If an image has more than one name, each of them needs to be +removed before the image is removed. + + $ sudo docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + + $ sudo docker rmi fd484f19954f + Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories + 2013/12/11 05:47:16 Error: failed to remove one or more images + + $ sudo docker rmi test1 + Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + $ sudo docker rmi test2 + Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + + $ sudo docker images + REPOSITORY TAG IMAGE ID CREATED SIZE + test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + $ sudo docker rmi test + Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 + +## `run` + + Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] + + Run a command in a new container + + -a, --attach=map[]: Attach to stdin, stdout or stderr + -c, --cpu-shares=0: CPU shares (relative weight) + --cidfile="": Write the container ID to the file + -d, --detach=false: Detached mode: Run container in the background, print new container id + -e, --env=[]: Set environment variables + --env-file="": Read in a line delimited file of ENV variables + -h, --hostname="": Container host name + -i, --interactive=false: Keep stdin open even if not attached + --privileged=false: Give extended privileges to this container + -m, --memory="": Memory limit (format: , where unit = b, k, m or g) + -n, --networking=true: Enable networking for this container + -p, --publish=[]: Map a network port to the container + --rm=false: Automatically remove the container when it exits (incompatible with -d) + -t, --tty=false: Allocate a pseudo-tty + -u, --user="": Username or UID + --dns=[]: Set custom dns servers for the container + --dns-search=[]: Set custom DNS search domains for the container + -v, --volume=[]: 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. + --volumes-from="": Mount all volumes from the given container(s) + --entrypoint="": Overwrite the default entrypoint set by the image + -w, --workdir="": Working directory inside the container + --lxc-conf=[]: (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" + --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) + --expose=[]: Expose a port from the container without publishing it to your host + --link="": Add link to another container (name:alias) + --name="": Assign the specified name to the container. If no name is specific docker will generate a random name + -P, --publish-all=false: Publish all exposed ports to the host interfaces + +The `docker run` command first `creates` +a writeable container layer over the specified image, and then +`starts` it using the specified command. That is, +`docker run` is equivalent to the API +`/containers/create` then +`/containers/(id)/start`. A stopped container can be +restarted with all its previous changes intact using +`docker start`. See `docker ps -a` +to view a list of all containers. + +The `docker run` command can be used in combination +with `docker commit` to [*change the command that a +container runs*](#cli-commit-examples). + +See [*Redirect Ports*](../../../use/port_redirection/#port-redirection) +for more detailed information about the `--expose`, +`-p`, `-P` and +`--link` parameters, and [*Link +Containers*](../../../use/working_with_links_names/#working-with-links-names) +for specific examples using `--link`. + +### Known Issues (run –volumes-from) + +- [Issue 2702](https://github.com/dotcloud/docker/issues/2702): + "lxc-start: Permission denied - failed to mount" could indicate a + permissions problem with AppArmor. Please see the issue for a + workaround. + +### Examples: + + $ sudo docker run --cidfile /tmp/docker_test.cid ubuntu echo "test" + +This will create a container and print `test` to the +console. The `cidfile` flag makes Docker attempt to +create a new file and write the container ID to it. If the file exists +already, Docker will return an error. Docker will close this file when +`docker run` exits. + + $ sudo docker run -t -i --rm ubuntu bash + root@bc338942ef20:/# mount -t tmpfs none /mnt + mount: permission denied + +This will *not* work, because by default, most potentially dangerous +kernel capabilities are dropped; including `cap_sys_admin` +(which is required to mount filesystems). However, the +`--privileged` flag will allow it to run: + + $ sudo docker run --privileged ubuntu bash + root@50e3f57e16e6:/# mount -t tmpfs none /mnt + root@50e3f57e16e6:/# df -h + Filesystem Size Used Avail Use% Mounted on + none 1.9G 0 1.9G 0% /mnt + +The `--privileged` flag gives *all* capabilities to +the container, and it also lifts all the limitations enforced by the +`device` cgroup controller. In other words, the +container can then do almost everything that the host can do. This flag +exists to allow special use-cases, like running Docker within Docker. + + $ sudo docker run -w /path/to/dir/ -i -t ubuntu pwd + +The `-w` lets the command being executed inside +directory given, here `/path/to/dir/`. If the path +does not exists it is created inside the container. + + $ sudo docker run -v `pwd`:`pwd` -w `pwd` -i -t ubuntu pwd + +The `-v` flag mounts the current working directory +into the container. The `-w` lets the command being +executed inside the current working directory, by changing into the +directory to the value returned by `pwd`. So this +combination executes the command using the container, but inside the +current working directory. + + $ sudo docker run -v /doesnt/exist:/foo -w /foo -i -t ubuntu bash + +When the host directory of a bind-mounted volume doesn’t exist, Docker +will automatically create this directory on the host for you. In the +example above, Docker will create the `/doesnt/exist` +folder before starting your container. + + $ sudo docker run -t -i -v /var/run/docker.sock:/var/run/docker.sock -v ./static-docker:/usr/bin/docker busybox sh + +By bind-mounting the docker unix socket and statically linked docker +binary (such as that provided by +[https://get.docker.io](https://get.docker.io)), you give the container +the full access to create and manipulate the host’s docker daemon. + + $ sudo docker run -p 127.0.0.1:80:8080 ubuntu bash + +This binds port `8080` of the container to port +`80` on `127.0.0.1` of the host +machine. [*Redirect +Ports*](../../../use/port_redirection/#port-redirection) explains in +detail how to manipulate ports in Docker. + + $ sudo docker run --expose 80 ubuntu bash + +This exposes port `80` of the container for use +within a link without publishing the port to the host system’s +interfaces. [*Redirect +Ports*](../../../use/port_redirection/#port-redirection) explains in +detail how to manipulate ports in Docker. + + $ sudo docker run -e MYVAR1 --env MYVAR2=foo --env-file ./env.list ubuntu bash + +This sets environmental variables in the container. For illustration all +three flags are shown here. Where `-e`, +`--env` take an environment variable and value, or +if no "=" is provided, then that variable’s current value is passed +through (i.e. $MYVAR1 from the host is set to $MYVAR1 in the +container). All three flags, `-e`, `--env` +and `--env-file` can be repeated. + +Regardless of the order of these three flags, the `--env-file` +are processed first, and then `-e` +.literal}/`--env` flags. This way, the +`-e` or `--env` will override +variables as needed. + + $ cat ./env.list + TEST_FOO=BAR + $ sudo docker run --env TEST_FOO="This is a test" --env-file ./env.list busybox env | grep TEST_FOO + TEST_FOO=This is a test + +The `--env-file` flag takes a filename as an +argument and expects each line to be in the VAR=VAL format, mimicking +the argument passed to `--env`. Comment lines need +only be prefixed with `#` + +An example of a file passed with `--env-file` + + $ cat ./env.list + TEST_FOO=BAR + + # this is a comment + TEST_APP_DEST_HOST=10.10.0.127 + TEST_APP_DEST_PORT=8888 + + # pass through this variable from the caller + TEST_PASSTHROUGH + $ sudo TEST_PASSTHROUGH=howdy docker run --env-file ./env.list busybox env + HOME=/ + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + HOSTNAME=5198e0745561 + TEST_FOO=BAR + TEST_APP_DEST_HOST=10.10.0.127 + TEST_APP_DEST_PORT=8888 + TEST_PASSTHROUGH=howdy + + $ sudo docker run --name console -t -i ubuntu bash + +This will create and run a new container with the container name being +`console`. + + $ sudo docker run --link /redis:redis --name console ubuntu bash + +The `--link` flag will link the container named +`/redis` into the newly created container with the +alias `redis`. The new container can access the +network and environment of the redis container via environment +variables. The `--name` flag will assign the name +`console` to the newly created container. + + $ sudo docker run --volumes-from 777f7dc92da7,ba8c0c54f0f2:ro -i -t ubuntu pwd + +The `--volumes-from` flag mounts all the defined +volumes from the referenced containers. Containers can be specified by a +comma separated list or by repetitions of the `--volumes-from` +argument. The container ID may be optionally suffixed with +`:ro` or `:rw` to mount the +volumes in read-only or read-write mode, respectively. By default, the +volumes are mounted in the same mode (read write or read only) as the +reference container. + +The `-a` flag tells `docker run` +to bind to the container’s stdin, stdout or stderr. This makes it +possible to manipulate the output and input as needed. + + $ sudo echo "test" | docker run -i -a stdin ubuntu cat - + +This pipes data into a container and prints the container’s ID by +attaching only to the container’s stdin. + + $ sudo docker run -a stderr ubuntu echo test + +This isn’t going to print anything unless there’s an error because we’ve +only attached to the stderr of the container. The container’s logs still +store what’s been written to stderr and stdout. + + $ sudo cat somefile | docker run -i -a stdin mybuilder dobuild + +This is how piping a file into a container could be done for a build. +The container’s ID will be printed after the build is done and the build +logs could be retrieved using `docker logs`. This is +useful if you need to pipe a file or something else into a container and +retrieve the container’s ID once the container has finished running. + +#### A complete example + + $ sudo docker run -d --name static static-web-files sh + $ sudo docker run -d --expose=8098 --name riak riakserver + $ sudo docker run -d -m 100m -e DEVELOPMENT=1 -e BRANCH=example-code -v $(pwd):/app/bin:ro --name app appserver + $ sudo docker run -d -p 1443:443 --dns=dns.dev.org --dns-search=dev.org -v /var/log/httpd --volumes-from static --link riak --link app -h www.sven.dev.org --name web webserver + $ sudo docker run -t -i --rm --volumes-from web -w /var/log/httpd busybox tail -f access.log + +This example shows 5 containers that might be set up to test a web +application change: + +1. Start a pre-prepared volume image `static-web-files` + (in the background) that has CSS, image and static HTML in + it, (with a `VOLUME` instruction in the + `Dockerfile` to allow the web server to use + those files); +2. Start a pre-prepared `riakserver` image, give + the container name `riak` and expose port + `8098` to any containers that link to it; +3. Start the `appserver` image, restricting its + memory usage to 100MB, setting two environment variables + `DEVELOPMENT` and `BRANCH` + and bind-mounting the current directory (`$(pwd)` +) in the container in read-only mode as + `/app/bin`; +4. Start the `webserver`, mapping port + `443` in the container to port `1443` + on the Docker server, setting the DNS server to + `dns.dev.org` and DNS search domain to + `dev.org`, creating a volume to put the log + files into (so we can access it from another container), then + importing the files from the volume exposed by the + `static` container, and linking to all exposed + ports from `riak` and `app`. + Lastly, we set the hostname to `web.sven.dev.org` + so its consistent with the pre-generated SSL certificate; +5. Finally, we create a container that runs + `tail -f access.log` using the logs volume from + the `web` container, setting the workdir to + `/var/log/httpd`. The `--rm` + option means that when the container exits, the container’s layer is + removed. + +## `save` + + Usage: docker save IMAGE + + Save an image to a tar archive (streamed to stdout by default) + + -o, --output="": Write to an file, instead of STDOUT + +Produces a tarred repository to the standard output stream. Contains all +parent layers, and all tags + versions, or specified repo:tag. + +It is used to create a backup that can then be used with +`docker load` + + $ sudo docker save busybox > busybox.tar + $ ls -sh b.tar + 2.7M b.tar + $ sudo docker save --output busybox.tar busybox + $ ls -sh b.tar + 2.7M b.tar + $ sudo docker save -o fedora-all.tar fedora + $ sudo docker save -o fedora-latest.tar fedora:latest + +## `search` + + Usage: docker search TERM + + Search the docker index for images + + --no-trunc=false: Don't truncate output + -s, --stars=0: Only displays with at least xxx stars + -t, --trusted=false: Only show trusted builds + +See [*Find Public Images on the Central +Index*](../../../use/workingwithrepository/#searching-central-index) for +more details on finding shared images from the commandline. + +## `start` + + Usage: docker start [OPTIONS] CONTAINER + + Start a stopped container + + -a, --attach=false: Attach container's stdout/stderr and forward all signals to the process + -i, --interactive=false: Attach container's stdin + +## `stop` + + Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...] + + Stop a running container (Send SIGTERM, and then SIGKILL after grace period) + + -t, --time=10: Number of seconds to wait for the container to stop before killing it. + +The main process inside the container will receive SIGTERM, and after a +grace period, SIGKILL + +## `tag` + + Usage: docker tag [OPTIONS] IMAGE [REGISTRYHOST/][USERNAME/]NAME[:TAG] + + Tag an image into a repository + + -f, --force=false: Force + +You can group your images together using names and tags, and then upload +them to [*Share Images via +Repositories*](../../../use/workingwithrepository/#working-with-the-repository). + +## `top` + + Usage: docker top CONTAINER [ps OPTIONS] + + Lookup the running processes of a container + +## `version` + +Show the version of the Docker client, daemon, and latest released +version. + +## `wait` + + Usage: docker wait [OPTIONS] NAME + + Block until a container stops, then print its exit code. diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md new file mode 100644 index 0000000000..6afc130085 --- /dev/null +++ b/docs/sources/reference/run.md @@ -0,0 +1,422 @@ +page_title: Docker Run Reference +page_description: Configure containers at runtime +page_keywords: docker, run, configure, runtime + +# [Docker Run Reference](#id2) + +**Docker runs processes in isolated containers**. When an operator +executes `docker run`, she starts a process with its +own file system, its own networking, and its own isolated process tree. +The [*Image*](../../terms/image/#image-def) which starts the process may +define defaults related to the binary to run, the networking to expose, +and more, but `docker run` gives final control to +the operator who starts the container from the image. That’s the main +reason [*run*](../commandline/cli/#cli-run) has more options than any +other `docker` command. + +Every one of the [*Examples*](../../examples/#example-list) shows +running containers, and so here we try to give more in-depth guidance. + +## [General Form](#id3) + +As you’ve seen in the [*Examples*](../../examples/#example-list), the +basic run command takes this form: + + docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] + +To learn how to interpret the types of `[OPTIONS]`, +see [*Option types*](../commandline/cli/#cli-options). + +The list of `[OPTIONS]` breaks down into two groups: + +1. Settings exclusive to operators, including: + - Detached or Foreground running, + - Container Identification, + - Network settings, and + - Runtime Constraints on CPU and Memory + - Privileges and LXC Configuration + +2. Setting shared between operators and developers, where operators can + override defaults developers set in images at build time. + +Together, the `docker run [OPTIONS]` give complete +control over runtime behavior to the operator, allowing them to override +all defaults set by the developer during `docker build` +and nearly all the defaults set by the Docker runtime itself. + +## [Operator Exclusive Options](#id4) + +Only the operator (the person executing `docker run` +.literal}) can set the following options. + +- [Detached vs Foreground](#detached-vs-foreground) + - [Detached (-d)](#detached-d) + - [Foreground](#foreground) +- [Container Identification](#container-identification) + - [Name (–name)](#name-name) + - [PID Equivalent](#pid-equivalent) +- [Network Settings](#network-settings) +- [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](#id2) + +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 +default foreground mode: + + -d=false: Detached mode: Run container in the background, print new container id + +#### [Detached (-d)](#id3) + +In detached mode (`-d=true` or just `-d` +.literal}), all I/O should be done through network connections or shared +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` +option. + +#### [Foreground](#id4) + +In foreground mode (the default when `-d` is not +specified), `docker run` can start the process in +the container and attach the console to the process’s standard input, +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 + +If you do not specify `-a` then Docker will [attach +everything +(stdin,stdout,stderr)](https://github.com/dotcloud/docker/blob/75a7f4d90cde0295bcfb7213004abce8d4779b75/commands.go#L1797). +You can specify to which of the three standard streams +(`stdin`, `stdout`, +`stderr`) you’d like to connect instead, as in: + + docker run -a stdin -a stdout -i -t ubuntu /bin/bash + +For interactive processes (like a shell) you will typically want a tty +as well as persistent standard input (`stdin`), so +you’ll use `-i -t` together in most interactive +cases. + +### [Container Identification](#id5) + +#### [Name (–name)](#id6) + +The operator can identify a container in three ways: + +- UUID long identifier + ("f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778") +- UUID short identifier ("f78375b1c487") +- 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 +[*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](#id7) + +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 + +### [Network Settings](#id8) + + -n=true : Enable networking for this 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 +with `docker run -n` which disables all incoming and +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`. + +### [Clean Up (–rm)](#id9) + +By default a container’s file system persists even after the container +exits. This makes debugging a lot easier (since you can inspect the +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: + + --rm=false: Automatically remove the container when it exits (incompatible with -d) + +### [Runtime Constraints on CPU and Memory](#id10) + +The operator can also adjust the performance parameters of the +container: + + -m="": Memory limit (format: , where unit = b, k, m or g) + -c=0 : CPU shares (relative weight) + +The operator can constrain the memory available to a container easily +with `docker run -m`. If the host supports swap +memory, then the `-m` memory setting can be larger +than physical RAM. + +Similarly the operator can increase the priority of this container with +the `-c` option. By default, all containers run at +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](#id11) + + --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 +by default a container is not allowed to access any devices, but a +"privileged" container is given access to all devices (see +[lxc-template.go](https://github.com/dotcloud/docker/blob/master/execdriver/lxc/lxc_template.go) +and documentation on [cgroups +devices](https://www.kernel.org/doc/Documentation/cgroups/devices.txt)). + +When the operator executes `docker run --privileged` +.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/). + +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 + +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 +the image starts up as a container. + +Four of the `Dockerfile` commands cannot be +overridden at runtime: `FROM, MAINTAINER, RUN`, and +`ADD`. Everything else has a corresponding override +in `docker run`. We’ll go through what the developer +might have set in each `Dockerfile` instruction and +how the operator can override that setting. + +- [CMD (Default Command or Options)](#cmd-default-command-or-options) +- [ENTRYPOINT (Default Command to Execute at + Runtime](#entrypoint-default-command-to-execute-at-runtime) +- [EXPOSE (Incoming Ports)](#expose-incoming-ports) +- [ENV (Environment Variables)](#env-environment-variables) +- [VOLUME (Shared Filesystems)](#volume-shared-filesystems) +- [USER](#user) +- [WORKDIR](#workdir) + +### [CMD (Default Command or Options)](#id12) + +Recall the optional `COMMAND` in the Docker +commandline: + + docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] + +This command is optional because the person who created the +`IMAGE` may have already provided a default +`COMMAND` using the `Dockerfile` +`CMD`. As the operator (the person running a +container from the image), you can override that `CMD` +just by specifying a new `COMMAND`. + +If the image also specifies an `ENTRYPOINT` then the +`CMD` or `COMMAND` get appended +as arguments to the `ENTRYPOINT`. + +### [ENTRYPOINT (Default Command to Execute at Runtime](#id13) + + --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, +but it is (purposely) more difficult to override. The +`ENTRYPOINT` gives a container its default nature or +behavior, so that when you set an `ENTRYPOINT` you +can run the container *as if it were that binary*, complete with default +options, and you can pass in more options via the `COMMAND` +.literal}. But, sometimes an operator may want to run something else +inside the container, so you can override the default +`ENTRYPOINT` at runtime by using a string to specify +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 + +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 + +### [EXPOSE (Incoming Ports)](#id14) + +The `Dockerfile` doesn’t give much control over +networking, only providing the `EXPOSE` instruction +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 + 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) + +As mentioned previously, `EXPOSE` (and +`--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 +inside the container you might have an HTTP service listening on port 80 +(and so you `EXPOSE 80` in the +`Dockerfile`), but outside the container the port +might be 42800. + +To help a new client container reach the server container’s internal +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`. + +If the operator uses `-P` or `-p` +then Docker will make the exposed port accessible on the host +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 +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)](#id15) + +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` +.literal}: + + $ docker run -e "deep=purple" --rm ubuntu /bin/bash -c export + declare -x HOME="/" + declare -x HOSTNAME="85bc26a0e200" + declare -x OLDPWD + declare -x PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + declare -x PWD="/" + declare -x SHLVL="1" + declare -x container="lxc" + declare -x deep="purple" + +Similarly the operator can set the **hostname** with `-h` +.literal}. + +`--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 + 4241164edf6f5aca5b0e9e4c9eccd899b0b8080c64c0cd26efe02166c73208f3 + + # The redis-name container exposed port 6379 + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 4241164edf6f dockerfiles/redis:latest /redis-stable/src/re 5 seconds ago Up 4 seconds 6379/tcp redis-name + + # Note that there are no public ports exposed since we didn't use -p or -P + $ docker port 4241164edf6f 6379 + 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! + + $ 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 + declare -x PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" + declare -x PWD="/" + declare -x REDIS_ALIAS_NAME="/distracted_wright/redis" + declare -x REDIS_ALIAS_PORT="tcp://172.17.0.32:6379" + declare -x REDIS_ALIAS_PORT_6379_TCP="tcp://172.17.0.32:6379" + declare -x REDIS_ALIAS_PORT_6379_TCP_ADDR="172.17.0.32" + declare -x REDIS_ALIAS_PORT_6379_TCP_PORT="6379" + declare -x REDIS_ALIAS_PORT_6379_TCP_PROTO="tcp" + declare -x SHLVL="1" + declare -x container="lxc" + +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' + 172.17.0.32:6379> + +### [VOLUME (Shared Filesystems)](#id16) + + -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) + +The volumes commands are complex enough to have their own documentation +in section [*Share Directories via +Volumes*](../../use/working_with_volumes/#volume-def). A developer can +define one or more `VOLUME`s associated with an +image, but only the operator can give access from one container to +another (or from a container to a volume mounted on the host). + +### [USER](#id17) + +The default user within a container is `root` (id = +0), but if the developer created additional users, those are accessible +too. The developer can set a default user to run the first process with +the `Dockerfile USER` command, but the operator can +override it + + -u="": Username or UID + +### [WORKDIR](#id18) + +The default working directory for running binaries within a container is +the root directory (`/`), but the developer can set +a different default with the `Dockerfile WORKDIR` +command. The operator can override this with: + + -w="": Working directory inside the container diff --git a/docs/sources/search.md b/docs/sources/search.md new file mode 100644 index 0000000000..0e2e13fb08 --- /dev/null +++ b/docs/sources/search.md @@ -0,0 +1,10 @@ +# Search + +*Please activate JavaScript to enable the search functionality.* + +## How To Search + +From here you can search these documents. Enter your search words into +the box below and click "search". Note that the search function will +automatically search for all of the words. Pages containing fewer words +won't appear in the result list. diff --git a/docs/sources/terms.md b/docs/sources/terms.md new file mode 100644 index 0000000000..59579d99a1 --- /dev/null +++ b/docs/sources/terms.md @@ -0,0 +1,13 @@ +# Glossary + +*Definitions of terms used in Docker documentation.* + +## Contents: + +- [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 new file mode 100644 index 0000000000..92a0265d99 --- /dev/null +++ b/docs/sources/terms/container.md @@ -0,0 +1,46 @@ +page_title: Container +page_description: Definitions of a container +page_keywords: containers, lxc, concepts, explanation, image, container + +# Container + +## Introduction + +![](../../_images/docker-filesystems-busyboxrw.png) + +Once you start a process in Docker from an +[*Image*](../image/#image-def), Docker fetches the image and its +[*Parent Image*](../image/#parent-image-def), and repeats the process +until it reaches the [*Base Image*](../image/#base-image-def). Then the +[*Union File System*](../layer/#ufs-def) adds a read-write layer on top. +That read-write layer, plus the information about its [*Parent +Image*](../image/#parent-image-def) and some additional information like +its unique id, networking configuration, and resource limits is called a +**container**. + +## Container State + +Containers can change, and so they have state. A container may be +**running** or **exited**. + +When a container is running, the idea of a "container" also includes a +tree of processes running on the CPU, isolated from the other processes +running on the host. + +When the container is exited, the state of the file system and its exit +value is preserved. You can start, stop, and restart a container. The +processes restart from scratch (their memory state is **not** preserved +in a container), but the file system is just as it was when the +container was stopped. + +You can promote a container to an [*Image*](../image/#image-def) with +`docker commit`. Once a container is an image, you +can use it as a parent for new containers. + +## Container IDs + +All containers are identified by a 64 hexadecimal digit string +(internally a 256bit value). To simplify their use, a short ID of the +first 12 characters can be used on the commandline. There is a small +possibility of short id collisions, so the docker server will always +return the long ID. diff --git a/docs/sources/terms/filesystem.md b/docs/sources/terms/filesystem.md new file mode 100644 index 0000000000..2038d009e3 --- /dev/null +++ b/docs/sources/terms/filesystem.md @@ -0,0 +1,36 @@ +page_title: File Systems +page_description: How Linux organizes its persistent storage +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 +systems](http://en.wikipedia.org/wiki/Filesystem): + +1. boot file system (bootfs) +2. root file system (rootfs) + +The **boot file system** contains the bootloader and the kernel. The +user never makes any changes to the boot file system. In fact, soon +after the boot process is complete, the entire kernel is in memory, and +the boot file system is unmounted to free up the RAM associated with the +initrd disk image. + +The **root file system** includes the typical directory structure we +associate with Unix-like operating systems: +`/dev, /proc, /bin, /etc, /lib, /usr,` and +`/tmp` plus all the configuration files, binaries +and libraries required to run user applications (like bash, ls, and so +forth). + +While there can be important kernel differences between different Linux +distributions, the contents and organization of the root file system are +usually what make your software packages dependent on one distribution +versus another. Docker can help solve this problem by running multiple +distributions at the same time. + +![](../../_images/docker-filesystems-multiroot.png) diff --git a/docs/sources/terms/image.md b/docs/sources/terms/image.md new file mode 100644 index 0000000000..721d4c954c --- /dev/null +++ b/docs/sources/terms/image.md @@ -0,0 +1,40 @@ +page_title: Images +page_description: Definition of an image +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 +called an **image**. An image never changes. + +Since Docker uses a [*Union File System*](../layer/#ufs-def), the +processes think the whole file system is mounted read-write. But all the +changes go to the top-most writeable layer, and underneath, the original +file in the read-only image is unchanged. Since images don’t change, +images do not have state. + +![](../../_images/docker-filesystems-debianrw.png) + +## Parent Image + +![](../../_images/docker-filesystems-multilayer.png) + +Each image may depend on one more image which forms the layer beneath +it. We sometimes say that the lower image is the **parent** of the upper +image. + +## Base Image + +An image that has no parent is a **base image**. + +## Image IDs + +All images are identified by a 64 hexadecimal digit string (internally a +256bit value). To simplify their use, a short ID of the first 12 +characters can be used on the command line. There is a small possibility +of short id collisions, so the docker server will always return the long +ID. diff --git a/docs/sources/terms/layer.md b/docs/sources/terms/layer.md new file mode 100644 index 0000000000..7665467aae --- /dev/null +++ b/docs/sources/terms/layer.md @@ -0,0 +1,35 @@ +page_title: Layers +page_description: Organizing the Docker Root File System +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. + +## Layer + +When Docker mounts the rootfs, it starts read-only, as in a traditional +Linux boot, but then, instead of changing the file system to read-write +mode, it takes advantage of a [union +mount](http://en.wikipedia.org/wiki/Union_mount) to add a read-write +file system *over* the read-only file system. In fact there may be +multiple read-only file systems stacked on top of each other. We think +of each one of these file systems as a **layer**. + +![](../../_images/docker-filesystems-multilayer.png) + +At first, the top read-write layer has nothing in it, but any time a +process creates a file, this happens in the top layer. And if something +needs to update an existing file in a lower layer, then the file gets +copied to the upper layer and changes go into the copy. The version of +the file on the lower layer cannot be seen by the applications anymore, +but it is there, unchanged. + +## Union File System + +We call the union of the read-write layer and all the read-only layers a +**union file system**. diff --git a/docs/sources/terms/registry.md b/docs/sources/terms/registry.md new file mode 100644 index 0000000000..0d5af2c65d --- /dev/null +++ b/docs/sources/terms/registry.md @@ -0,0 +1,20 @@ +page_title: Registry +page_description: Definition of an Registry +page_keywords: containers, lxc, concepts, explanation, image, repository, container + +# Registry + +## Introduction + +A Registry is a hosted service containing +[*repositories*](../repository/#repository-def) of +[*images*](../image/#image-def) which responds to the Registry API. + +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 new file mode 100644 index 0000000000..2efab3224d --- /dev/null +++ b/docs/sources/terms/repository.md @@ -0,0 +1,39 @@ +page_title: Repository +page_description: Definition of an Repository +page_keywords: containers, lxc, concepts, explanation, image, repository, container + +# 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. + +Images can be associated with a repository (or multiple) by giving them +an image name using one of three different commands: + +1. At build time (e.g. `sudo docker build -t IMAGENAME` +), +2. When committing a container (e.g. + `sudo docker commit CONTAINERID IMAGENAME`) or +3. When tagging an image id with an image name (e.g. + `sudo docker tag IMAGEID IMAGENAME`). + +A Fully Qualified Image Name (FQIN) can be made up of 3 parts: + +`[registry_hostname[:port]/][user_name/](repository_name:version_tag)` +.literal} + +`username` and `registry_hostname` +default to an empty string. When `registry_hostname` +is an empty string, then `docker push` +will push to `index.docker.io:80`. + +If you create a new repository which you want to share, you will need to +set at least the `user_name`, as the ‘default’ blank +`user_name` prefix is reserved for official Docker +images. + +For more information see [*Working with +Repositories*](../../use/workingwithrepository/#working-with-the-repository) diff --git a/docs/sources/toctree.md b/docs/sources/toctree.md new file mode 100644 index 0000000000..e837c7e3af --- /dev/null +++ b/docs/sources/toctree.md @@ -0,0 +1,17 @@ +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: + +- [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 new file mode 100644 index 0000000000..ce4a51025c --- /dev/null +++ b/docs/sources/use.md @@ -0,0 +1,13 @@ +# 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 diff --git a/docs/sources/use/ambassador_pattern_linking.md b/docs/sources/use/ambassador_pattern_linking.md new file mode 100644 index 0000000000..073e6bf14f --- /dev/null +++ b/docs/sources/use/ambassador_pattern_linking.md @@ -0,0 +1,157 @@ +page_title: Link via an Ambassador Container +page_description: Using the Ambassador pattern to abstract (network) services +page_keywords: Examples, Usage, links, docker, documentation, examples, names, name, container naming + +# Link via an Ambassador Container + +## Introduction + +Rather than hardcoding network links between a service consumer and +provider, Docker encourages service portability. + +eg, instead of + + (consumer) --> (redis) + +requiring you to restart the `consumer` to attach it +to a different `redis` service, you can add +ambassadors + + (consumer) --> (redis-ambassador) --> (redis) + + or + + (consumer) --> (redis-ambassador) ---network---> (redis-ambassador) --> (redis) + +When you need to rewire your consumer to talk to a different redis +server, you can just restart the `redis-ambassador` +container that the consumer is connected to. + +This pattern also allows you to transparently move the redis server to a +different docker host from the consumer. + +Using the `svendowideit/ambassador` container, the +link wiring is controlled entirely from the `docker run` +parameters. + +## Two host Example + +Start actual redis server on one Docker host + + 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 + +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 + +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 + redis 172.17.0.160:6379> ping + PONG + +## How it works + +The following example shows what the `svendowideit/ambassador` +container does automatically (with a tiny amount of +`sed`) + +On the docker host (192.168.1.52) that redis will run on: + + # start actual redis server + $ 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 + 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 + +in the redis\_ambassador container, you can see the linked redis +containers’s env + + $ env + REDIS_PORT=tcp://172.17.0.136:6379 + REDIS_PORT_6379_TCP_ADDR=172.17.0.136 + REDIS_NAME=/redis_ambassador/redis + HOSTNAME=19d7adf4705e + REDIS_PORT_6379_TCP_PORT=6379 + HOME=/ + REDIS_PORT_6379_TCP_PROTO=tcp + container=lxc + REDIS_PORT_6379_TCP=tcp://172.17.0.136:6379 + TERM=xterm + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + PWD=/ + +This environment is used by the ambassador socat script to expose redis +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 + + $ socat TCP4-LISTEN:6379,fork,reuseaddr TCP4:172.17.0.136:6379 + +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 + + $ 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 + redis 172.17.0.160:6379> ping + PONG + +## The svendowideit/ambassador Dockerfile + +The `svendowideit/ambassador` image is a small +busybox image with `socat` built in. When you start +the container, it uses a small `sed` script to parse +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` +will forward the local `1234` port to the +remote IP and port - in this case `192.168.1.52:6379` +.literal}. + + # + # + # first you need to build the docker-ut image + # using ./contrib/mkimage-unittest.sh + # then + # 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 + # on the remote host, you can set up another ambassador + # 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 diff --git a/docs/sources/use/basics.md b/docs/sources/use/basics.md new file mode 100644 index 0000000000..844240e4f9 --- /dev/null +++ b/docs/sources/use/basics.md @@ -0,0 +1,180 @@ +page_title: First steps with Docker +page_description: Common usage and commands +page_keywords: Examples, Usage, basic commands, docker, documentation, examples + +# First steps with Docker + +## Check your Docker install + +This guide assumes you have a working installation of Docker. To check +your Docker install, run the following command: + + # Check that you have a working install + docker info + +If you get `docker: command not found` or something +like `/var/lib/docker/repositories: permission denied` +you may have an incomplete docker installation or insufficient +privileges to access Docker on your machine. + +Please refer to [*Installation*](../../installation/#installation-list) +for installation instructions. + +## Download a pre-built image + + # Download an ubuntu image + sudo docker pull ubuntu + +This will find the `ubuntu` image by name in the +[*Central Index*](../workingwithrepository/#searching-central-index) and +download it from the top-level Central Repository to a local image +cache. + +Note + +When the image has successfully downloaded, you will see a 12 character +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 --no-trunc=true` + +**If you’re using OS X** then you shouldn’t use `sudo` +.literal} + +## Running an interactive shell + + # Run an interactive shell in the ubuntu image, + # allocate a tty, attach stdin and stdout + # To detach the tty without exiting the shell, + # use the escape sequence Ctrl-p + Ctrl-q + # note: This will continue to exist in a stopped state once exited (see "docker ps -a") + sudo docker run -i -t ubuntu /bin/bash + +## Bind Docker to another host/port or a Unix socket + +Warning + +Changing the default `docker` daemon binding to a +TCP port or Unix *docker* user group will increase your security risks +by allowing non-root users to gain *root* access on the host. Make sure +you control access to `docker`. If you are binding +to a TCP port, anyone with access to that port has full Docker access; +so it is not advisable on an open network. + +With `-H` it is possible to make the Docker daemon +to listen on a specific IP and port. By default, it will listen on +`unix:///var/run/docker.sock` to allow only local +connections by the *root* user. You *could* set it to +`0.0.0.0:4243` or a specific host IP to give access +to everybody, but that is **not recommended** because then it is trivial +for someone to gain root access to the host where the daemon is running. + +Similarly, the Docker client can use `-H` to connect +to a custom port. + +`-H` accepts host and port assignment in the +following format: `tcp://[host][:port]` or +`unix://path` + +For example: + +- `tcp://host:4243` -\> tcp connection on + host:4243 +- `unix://path/to/socket` -\> unix socket located + at `path/to/socket` + +`-H`, when empty, will default to the same value as +when no `-H` was passed in. + +`-H` also accepts short form for TCP bindings: +`host[:port]` or `:port` + + # Run docker in daemon mode + sudo /docker -H 0.0.0.0:5555 -d & + # Download an ubuntu image + sudo docker -H :5555 pull ubuntu + +You can use multiple `-H`, for example, if you want +to listen on both TCP and a Unix socket + + # Run docker in daemon mode + sudo /docker -H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock -d & + # Download an ubuntu image, use default Unix socket + sudo docker pull ubuntu + # OR use the TCP port + sudo docker -H tcp://127.0.0.1:4243 pull ubuntu + +## Starting a long-running worker process + + # Start a very useful long-running process + JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + + # Collect the output of the job so far + sudo docker logs $JOB + + # Kill the job + sudo docker kill $JOB + +## Listing containers + + sudo docker ps # Lists only running containers + sudo docker ps -a # Lists all containers + +## Controlling containers + + # Start a new container + JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + + # Stop the container + docker stop $JOB + + # Start the container + docker start $JOB + + # Restart the container + docker restart $JOB + + # SIGKILL a container + docker kill $JOB + + # Remove a container + docker stop $JOB # Container must be stopped to remove it + docker rm $JOB + +## Bind a service on a TCP port + + # Bind port 4444 of this container, and tell netcat to listen on it + JOB=$(sudo docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444) + + # Which public port is NATed to my container? + PORT=$(sudo docker port $JOB 4444 | awk -F: '{ print $2 }') + + # Connect to the public port + echo hello world | nc 127.0.0.1 $PORT + + # Verify that the network connection worked + echo "Daemon received: $(sudo docker logs $JOB)" + +## Committing (saving) a container state + +Save your containers state to a container image, so the state can be +re-used. + +When you commit your container only the differences between the image +the container was created from and the current state of the container +will be stored (as a diff). See which images you already have using the +`docker images` command. + + # Commit your container to a new named image + sudo docker commit + + # List your containers + sudo docker images + +You now have a image state from which you can create new instances. + +Read more about [*Share Images via +Repositories*](../workingwithrepository/#working-with-the-repository) or +continue to the complete [*Command +Line*](../../reference/commandline/cli/#cli) diff --git a/docs/sources/use/chef.md b/docs/sources/use/chef.md new file mode 100644 index 0000000000..dfbf8d382e --- /dev/null +++ b/docs/sources/use/chef.md @@ -0,0 +1,75 @@ +page_title: Chef Usage +page_description: Installation and using Docker via Chef +page_keywords: chef, installation, usage, docker, documentation + +# Using Chef + +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 + +To use this guide you’ll need a working installation of +[Chef](http://www.getchef.com/). This cookbook supports a variety of +operating systems. + +## Installation + +The cookbook is available on the [Chef Community +Site](community.opscode.com/cookbooks/docker) and can be installed using +your favorite cookbook dependency manager. + +The source can be found on +[GitHub](https://github.com/bflad/chef-docker). + +## Usage + +The cookbook provides recipes for installing Docker, configuring init +for Docker, and resources for managing images and containers. It +supports almost all Docker functionality. + +### Installation + + include_recipe 'docker' + +### Images + +The next step is to pull a Docker image. For this, we have a resource: + + docker_image 'samalba/docker-registry' + +This is equivalent to running: + + docker pull samalba/docker-registry + +There are attributes available to control how long the cookbook will +allow for downloading (5 minute default). + +To remove images you no longer need: + + docker_image 'samalba/docker-registry' do + action :remove + end + +### Containers + +Now you have an image where you can run commands within a container +managed by Docker. + + docker_container 'samalba/docker-registry' do + detach true + port '5000:5000' + env 'SETTINGS_FLAVOR=local' + volume '/mnt/docker:/docker-storage' + end + +This is equivalent to running the following command, but under upstart: + + docker run --detach=true --publish='5000:5000' --env='SETTINGS_FLAVOR=local' --volume='/mnt/docker:/docker-storage' samalba/docker-registry + +The resources will accept a single string or an array of values for any +docker flags that allow multiple values. diff --git a/docs/sources/use/host_integration.md b/docs/sources/use/host_integration.md new file mode 100644 index 0000000000..0aa0dc8314 --- /dev/null +++ b/docs/sources/use/host_integration.md @@ -0,0 +1,63 @@ +page_title: Automatically Start Containers +page_description: How to generate scripts for upstart, systemd, etc. +page_keywords: systemd, upstart, supervisor, docker, documentation, host integration + +# Automatically Start Containers + +You can use your Docker containers with process managers like +`upstart`, `systemd` and +`supervisor`. + +## Introduction + +If you want a process manager to manage your containers you will need to +run the docker daemon with the `-r=false` so that +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 can then attach a process manager to manage it. +When your run `docker start -a` docker will +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 +`--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" + start on filesystem and started docker + stop on runlevel [!2345] + respawn + script + /usr/bin/docker start -a redis_server + end script + +Next, we have to configure docker so that it’s run with the option +`-r=false`. Run the following command: + + $ sudo sh -c "echo 'DOCKER_OPTS=\"-r=false\"' > /etc/default/docker" + +## Sample systemd Script + + [Unit] + Description=Redis container + Author=Me + After=docker.service + + [Service] + Restart=always + 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 new file mode 100644 index 0000000000..654d9f0049 --- /dev/null +++ b/docs/sources/use/networking.md @@ -0,0 +1,142 @@ +page_title: Configure Networking +page_description: Docker networking +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 + + + + # List host bridges + $ sudo brctl show + bridge name bridge id STP enabled interfaces + docker0 8000.000000000000 no + + # Show docker0 IP address + $ sudo ifconfig docker0 + docker0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx + inet addr:172.17.42.1 Bcast:0.0.0.0 Mask:255.255.0.0 + +At runtime, a [*specific kind of virtual interface*](#vethxxxx-device) +is given to each container which is then bonded to the +`docker0` bridge. Each container also receives a +dedicated IP address from the same range as `docker0` +.literal}. The `docker0` IP address is used as the +default gateway for the container. + + # Run a container + $ sudo docker run -t -i -d base /bin/bash + 52f811c5d3d69edddefc75aff5a4525fc8ba8bcfa1818132f9dc7d4f7c7e78b4 + + $ sudo brctl show + bridge name bridge id STP enabled interfaces + docker0 8000.fef213db5a66 no vethQCDY1N + +Above, `docker0` acts as a bridge for the +`vethQCDY1N` interface which is dedicated to the +52f811c5d3d6 container. + +## How to use a specific IP address range + +Docker will try hard to find an IP range that is not used by the host. +Even though it works for most cases, it’s not bullet-proof and sometimes +you need to have more control over the IP addressing scheme. + +For this purpose, Docker allows you to manage the `docker0` +bridge or your own one using the `-b=` +parameter. + +In this scenario: + +- ensure Docker is stopped +- create your own bridge (`bridge0` for example) +- assign a specific IP to this bridge +- start Docker with the `-b=bridge0` parameter + + + + # Stop Docker + $ sudo service docker stop + + # Clean docker0 bridge and + # add your very own bridge0 + $ sudo ifconfig docker0 down + $ sudo brctl addbr bridge0 + $ sudo ifconfig bridge0 192.168.227.1 netmask 255.255.255.0 + + # Edit your Docker startup file + $ echo "DOCKER_OPTS=\"-b=bridge0\"" >> /etc/default/docker + + # Start Docker + $ sudo service docker start + + # Ensure bridge0 IP is not changed by Docker + $ sudo ifconfig bridge0 + bridge0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx + inet addr:192.168.227.1 Bcast:192.168.227.255 Mask:255.255.255.0 + + # Run a container + $ docker run -i -t base /bin/bash + + # Container IP in the 192.168.227/24 range + root@261c272cd7d5:/# ifconfig eth0 + eth0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx + inet addr:192.168.227.5 Bcast:192.168.227.255 Mask:255.255.255.0 + + # bridge0 IP as the default gateway + root@261c272cd7d5:/# route -n + Kernel IP routing table + Destination Gateway Genmask Flags Metric Ref Use Iface + 0.0.0.0 192.168.227.1 0.0.0.0 UG 0 0 0 eth0 + 192.168.227.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0 + + # hits CTRL+P then CTRL+Q to detach + + # Display bridge info + $ sudo brctl show + bridge name bridge id STP enabled interfaces + bridge0 8000.fe7c2e0faebd no vethAQI2QT + +## Container intercommunication + +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 + communicate with each other. +- `-icc=false` means containers are isolated from + each other. + +Docker uses `iptables` under the hood to either +accept or drop communication between containers. + +## What is the vethXXXX device? + +Well. Things get complicated here. + +The `vethXXXX` interface is the host side of a +point-to-point link between the host and the corresponding container; +the other side of the link is the container’s `eth0` +interface. This pair (host `vethXXX` and container +`eth0`) are connected like a tube. Everything that +comes in one side will come out the other side. + +All the plumbing is delegated to Linux network capabilities (check the +ip link command) and the namespaces infrastructure. + +## I want more + +Jérôme Petazzoni has create `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 new file mode 100644 index 0000000000..33ac9d9158 --- /dev/null +++ b/docs/sources/use/port_redirection.md @@ -0,0 +1,140 @@ +page_title: Redirect Ports +page_description: usage about port redirection +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: + + # Find IP address of container with ID + docker inspect | grep IPAddress | cut -d '"' -f 4 + +However, this IP address is local to the host system and the container +port is not reachable by the outside world. Furthermore, even if the +port is used locally, e.g. by another container, this method is tedious +as the IP address of the container changes every time it starts. + +Docker addresses these two problems and give a simple and robust way to +access services running inside containers. + +To allow non-local clients to reach the service running inside the +container, Docker provide ways to bind the container port to an +interface of the host system. To simplify communication between +containers, Docker provides the linking mechanism. + +## Auto map all exposed ports on the host + +To bind all the exposed container ports to the host automatically, use +`docker run -P `. The mapped host ports +will be auto-selected from a pool of unused ports (49000..49900), and +you will need to use `docker ps`, +`docker inspect ` or +`docker port ` to determine +what they are. + +## Binding a port to a host interface + +To bind a port of the container to a specific interface of the host +system, use the `-p` parameter of the +`docker run` command: + + # General syntax + docker run -p [([:[host_port]])|():][/udp] + +When no host interface is provided, the port is bound to all available +interfaces of the host machine (aka INADDR\_ANY, or 0.0.0.0).When no +host port is provided, one is dynamically allocated. The possible +combinations of options for TCP port are the following: + + # Bind TCP port 8080 of the container to TCP port 80 on 127.0.0.1 of the host machine. + docker run -p 127.0.0.1:80:8080 + + # Bind TCP port 8080 of the container to a dynamically allocated TCP port on 127.0.0.1 of the host machine. + docker run -p 127.0.0.1::8080 + + # Bind TCP port 8080 of the container to TCP port 80 on all available interfaces of the host machine. + docker run -p 80:8080 + + # Bind TCP port 8080 of the container to a dynamically allocated TCP port on all available interfaces of the host machine. + docker run -p 8080 + +UDP ports can also be bound by adding a trailing `/udp` +.literal}. All the combinations described for TCP work. Here is only one +example: + + # Bind UDP port 5353 of the container to UDP port 53 on 127.0.0.1 of the host machine. + docker run -p 127.0.0.1:53:5353/udp + +The command `docker port` lists the interface and +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 + + # Lookup the actual port + docker port dyn-bound 8080 + 127.0.0.1:49160 + +## Linking a container + +Communication between two containers can also be established in a +docker-specific way called linking. + +To briefly present the concept of linking, let us consider two +containers: `server`, containing the service, and +`client`, accessing the service. Once +`server` is running, `client` is +started and links to server. Linking sets environment variables in +`client` giving it some information about +`server`. In this sense, linking is a method of +service discovery. + +Let us now get back to our topic of interest; communication between the +two containers. We mentioned that the tricky part about this +communication was that the IP address of `server` +was not fixed. Therefore, some of the environment variables are going to +be used to inform `client` about this IP address. +This process called exposure, is possible because `client` +is started after `server` has been +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` +command, or the `EXPOSE` build command in +a Dockerfile: + + # Expose port 80 + docker run --expose 80 --name server + +The `client` then links to the `server` +.literal}: + + # Link + docker run --name client --link server:linked-server + +`client` locally refers to `server` +as `linked-server`. The following +environment variables, among others, are available on `client` +.literal}: + + # The default protocol, ip, and port of the service running in the container + LINKED-SERVER_PORT=tcp://172.17.0.8:80 + + # A specific protocol, ip, and port of various services + LINKED-SERVER_PORT_80_TCP=tcp://172.17.0.8:80 + LINKED-SERVER_PORT_80_TCP_PROTO=tcp + LINKED-SERVER_PORT_80_TCP_ADDR=172.17.0.8 + LINKED-SERVER_PORT_80_TCP_PORT=80 + +This tells `client` that a service is running on +port 80 of `server` and that `server` +is accessible at the IP address 172.17.0.8 + +Note: Using the `-p` parameter also exposes the +port.. diff --git a/docs/sources/use/puppet.md b/docs/sources/use/puppet.md new file mode 100644 index 0000000000..55f16dd5bc --- /dev/null +++ b/docs/sources/use/puppet.md @@ -0,0 +1,92 @@ +page_title: Puppet Usage +page_description: Installating and using Puppet +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. + +## Requirements + +To use this guide you’ll need a working installation of Puppet from +[Puppetlabs](https://www.puppetlabs.com) . + +The module also currently uses the official PPA so only works with +Ubuntu. + +## Installation + +The module is available on the [Puppet +Forge](https://forge.puppetlabs.com/garethr/docker/) and can be +installed using the built-in module tool. + + puppet module install garethr/docker + +It can also be found on +[GitHub](https://www.github.com/garethr/garethr-docker) if you would +rather download the source. + +## Usage + +The module provides a puppet class for installing Docker and two defined +types for managing images and containers. + +### Installation + + include 'docker' + +### Images + +The next step is probably to install a Docker image. For this, we have a +defined type which can be used like so: + + docker::image { 'ubuntu': } + +This is equivalent to running: + + docker pull ubuntu + +Note that it will only be downloaded if an image of that name does not +already exist. This is downloading a large binary so on first run can +take a while. For that reason this define turns off the default 5 minute +timeout for the exec type. Note that you can also remove images you no +longer need with: + + docker::image { 'ubuntu': + ensure => 'absent', + } + +### Containers + +Now you have an image where you can run commands within a container +managed by Docker. + + docker::run { 'helloworld': + image => 'ubuntu', + command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', + } + +This is equivalent to running the following command, but under upstart: + + docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done" + +Run also contains a number of optional parameters: + + docker::run { 'helloworld': + image => 'ubuntu', + command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', + ports => ['4444', '4555'], + volumes => ['/var/lib/couchdb', '/var/log'], + volumes_from => '6446ea52fbc9', + memory_limit => 10485760, # bytes + username => 'example', + hostname => 'example.com', + env => ['FOO=BAR', 'FOO2=BAR2'], + dns => ['8.8.8.8', '8.8.4.4'], + } + +Note that ports, env, dns and volumes can be set with either a single +string or as above with an array of values. diff --git a/docs/sources/use/working_with_links_names.md b/docs/sources/use/working_with_links_names.md new file mode 100644 index 0000000000..b979f8a967 --- /dev/null +++ b/docs/sources/use/working_with_links_names.md @@ -0,0 +1,121 @@ +page_title: Link Containers +page_description: How to create and use both links and names +page_keywords: Examples, Usage, links, linking, docker, documentation, examples, names, name, container naming + +# 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 +where the parent container can see selected information about its child. + +## Container Naming + +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. + + # 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 + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 2522602a0d99 ubuntu:12.04 /bin/bash 14 seconds ago Exit 0 test + +## Links: service discovery for docker + +New in version v0.6.5. + +Links allow containers to discover and securely communicate with each +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 +`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 +a parent child relationship between the containers. The parent container +will be able to access information via environment variables of the +child such as name, exposed ports, IP and other selected environment +variables. + +When linking two containers Docker will use the exposed ports of the +container to create a secure tunnel for the parent to access. If a +database container only exposes port 8080 then the linked container will +only be allowed to access port 8080 and nothing else if inter-container +communication is set to false. + +For example, there is an image called `crosbymichael/redis` +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. + + $ 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 +container. The name also allows us to link other containers into this +one. + +Next, we can start a new web application that has a dependency on Redis +and apply a link to connect both containers. If you noticed when running +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 + +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 +access network and environment information from the containers that are +linked into it. + +If we inspect the environment variables of the second container, we +would see all the information about the child container. + + $ root@4c01db0b339c:/# env + + HOSTNAME=4c01db0b339c + DB_NAME=/webapp/db + TERM=xterm + DB_PORT=tcp://172.17.0.8:6379 + DB_PORT_6379_TCP=tcp://172.17.0.8:6379 + DB_PORT_6379_TCP_PROTO=tcp + DB_PORT_6379_TCP_ADDR=172.17.0.8 + DB_PORT_6379_TCP_PORT=6379 + PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin + PWD=/ + SHLVL=1 + HOME=/ + container=lxc + _=/usr/bin/env + root@4c01db0b339c:/# + +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` +in a file, or looking at `/proc/1/environ` +.literal}. + +Running `docker ps` shows the 2 containers, and the +`webapp/db` alias name for the Redis container. + + $ docker ps + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp + d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db diff --git a/docs/sources/use/working_with_volumes.md b/docs/sources/use/working_with_volumes.md new file mode 100644 index 0000000000..1f03101b86 --- /dev/null +++ b/docs/sources/use/working_with_volumes.md @@ -0,0 +1,178 @@ +page_title: Share Directories via Volumes +page_description: How to create and share volumes +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`. + +Each container can have zero or more data volumes. + +New in version v0.3.0. + +## Getting Started + +Using data volumes is as simple as adding a `-v` +parameter to the `docker run` command. The +`-v` parameter can be used more than once in order +to create more volumes within the new container. To create a new +container with two new volumes: + + $ docker run -v /var/volume1 -v /var/volume2 busybox true + +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` +option; irrespective of whether the container is running or +not. + +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 + FROM busybox + VOLUME ["/var/volume1", "/var/volume2"] + CMD ["/bin/true"] + +### Creating and mounting a Data Volume Container + +If you have some persistent data that you want to share between +containers, or want to use from non-persistent containers, its best to +create a named Data Volume Container, and then to mount the data from +it. + +Create a named container with volumes to share (`/var/volume1` +and `/var/volume2`): + + $ 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 + +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 + +This allows you to abstract the actual data source from users of that +data, similar to +[*ambassador\_pattern\_linking*](../ambassador_pattern_linking/#ambassador-pattern-linking). + +If you remove containers that mount volumes, including the initial DATA +container, or the middleman, the volumes will not be deleted until there +are no containers still referencing those volumes. This allows you to +upgrade, or effectively migrate data volumes between containers. + +### Mount a Host Directory as a Container Volume: + + -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. + +You must specify an absolute path for `host-dir`. If +`host-dir` is missing from the command, then docker +creates a new volume. If `host-dir` is present but +points to a non-existent directory on the host, Docker will +automatically create this directory and use it as the source of the +bind-mount. + +Note that this is not available from a Dockerfile due the portability +and sharing purpose of it. The `host-dir` volumes +are entirely host-dependent and might not work on any other machine. + +For example: + + sudo docker run -t -i -v /var/logs:/var/host_logs:ro ubuntu bash + +The command above mounts the host directory `/var/logs` +into the container with read only permissions as +`/var/host_logs`. + +New in version v0.5.0. + +### Note for OS/X users and remote daemon users: + +OS/X users run `boot2docker` to create a minimalist +virtual machine running the docker daemon. That virtual machine then +launches docker commands on behalf of the OS/X command line. The means +that `host directories` refer to directories in the +`boot2docker` virtual machine, not the OS/X +filesystem. + +Similarly, anytime when the docker daemon is on a remote machine, the +`host directories` always refer to directories on +the daemon’s machine. + +### Backup, restore, or migrate data volumes + +You cannot back up volumes using `docker export`, +`docker save` and `docker cp` +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 + +- `-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 + directory into the container; to write the tar file to +- `busybox` - a small simpler image - good for + quick maintenance +- `tar cvf /backup/backup.tar /data` - creates an + uncompressed tar file of all the files in the `/data` + directory + +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 + # 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 + data/ + data/sven.txt + # compare to the original container + $ 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 +restore testing using your preferred tools. + +## Known Issues + +- [Issue 2702](https://github.com/dotcloud/docker/issues/2702): + "lxc-start: Permission denied - failed to mount" could indicate a + permissions problem with AppArmor. Please see the issue for a + workaround. +- [Issue 2528](https://github.com/dotcloud/docker/issues/2528): the + busybox container is used to make the resulting container as small + and simple as possible - whenever you need to interact with the data + in the volume you mount it into another container. + diff --git a/docs/sources/use/workingwithrepository.md b/docs/sources/use/workingwithrepository.md new file mode 100644 index 0000000000..49edbc8ffc --- /dev/null +++ b/docs/sources/use/workingwithrepository.md @@ -0,0 +1,235 @@ +page_title: Share Images via Repositories +page_description: Repositories allow users to share images. +page_keywords: repo, repositories, usage, pull image, push image, image, documentation + +# 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 +the provenance of the repository, i.e. who created it and where the +original copy is located. + +You can find one or more repositories hosted on a *registry*. There can +be an implicit or explicit host name as part of the repository tag. The +implicit registry is located at `index.docker.io`, +the home of "top-level" repositories and the Central Index. This +registry may also include public "user" repositories. + +Docker is not only a tool for creating and managing your own +[*containers*](../../terms/container/#container-def) – **Docker is also +a tool for sharing**. The Docker project provides a Central Registry to +host public repositories, namespaced by user, and a Central Index which +provides user authentication and search over all the public +repositories. You can host your own Registry too! Docker acts as a +client for these services via `docker search, pull, login` +and `push`. + +## 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 + +There are two types of public repositories: *top-level* repositories +which are controlled by the Docker team, and *user* repositories created +by individual contributors. Anyone can read from these repositories – +they really help people get started quickly! You could also use +[*Trusted Builds*](#using-private-repositories) if you need to keep +control of who accesses your images, but we will only refer to public +repositories in these examples. + +- Top-level repositories can easily be recognized by **not** having a + `/` (slash) in their name. These repositories + can generally be trusted. +- User repositories always come in the form of + `/`. This is what your + published images will look like if you push to the public Central + Registry. +- Only the authenticated user can push to their *username* namespace + on the Central Registry. +- User images are not checked, it is therefore up to you whether or + not you trust the creator of this image. + +## Find Public Images on the Central Index + +You can search the Central Index [online](https://index.docker.io) or +using the command line interface. Searching can find images by name, +user name or description: + + $ sudo docker help search + Usage: docker search NAME + + Search the docker index for images + + -notrunc=false: Don't truncate output + $ sudo docker search centos + Found 25 results matching your query ("centos") + NAME DESCRIPTION + centos + slantview/centos-chef-solo CentOS 6.4 with chef-solo. + ... + +There you can see two example results: `centos` and +`slantview/centos-chef-solo`. The second result +shows that it comes from the public repository of a user, +`slantview/`, while the first result +(`centos`) doesn’t explicitly list a repository so +it comes from the trusted Central Repository. The `/` +character separates a user’s repository and the image name. + +Once you have found the image name, you can download it: + + # sudo docker pull + $ sudo docker pull centos + Pulling repository centos + 539c0211cd76: Download complete + +What can you do with that image? Check out the +[*Examples*](../../examples/#example-list) and, when you’re ready with +your own image, come back here to learn how to share it. + +## Contributing to the Central Registry + +Anyone can pull public images from the Central Registry, but if you +would like to share one of your own images, then you must register a +unique user name first. You can create your username and login on the +[central Docker Index online](https://index.docker.io/account/signup/), +or by running + + sudo docker login + +This will prompt you for a username, which will become a public +namespace for your public repositories. + +If your username is available then `docker` will +also prompt you to enter a password and your e-mail address. It will +then automatically log you in. Now you’re ready to commit and push your +own images! + +## Committing a Container to a Named Image + +When you make changes to an existing image, those changes get saved to a +container’s file system. You can then promote that container to become +an image by making a `commit`. In addition to +converting the container to an image, this is also your opportunity to +name the image, specifically a name that includes your user name from +the Central Docker Index (as you did a `login` +above) and a meaningful name for the image. + + # format is "sudo docker commit /" + $ sudo docker commit $CONTAINER_ID myname/kickassapp + +## Pushing a repository to its registry + +In order to push an repository to its registry you need to have named an +image, or committed your container to a named image (see above) + +Now you can push this repository to the registry designated by its name +or tag. + + # format is "docker push /" + $ sudo docker push myname/kickassapp + +## Trusted Builds + +Trusted Builds automate the building and updating of images from GitHub, +directly on `docker.io` servers. It works by adding +a commit hook to your selected repository, triggering a build and update +when you push a commit. + +### To setup a trusted build + +1. Create a [Docker Index account](https://index.docker.io/) and login. +2. Link your GitHub account through the `Link Accounts` + menu. +3. [Configure a Trusted build](https://index.docker.io/builds/). +4. Pick a GitHub project that has a `Dockerfile` + that you want to build. +5. Pick the branch you want to build (the default is the + `master` branch). +6. Give the Trusted Build a name. +7. Assign an optional Docker tag to the Build. +8. Specify where the `Dockerfile` is located. The + default is `/`. + +Once the Trusted Build is configured it will automatically trigger a +build, and in a few minutes, if there are no errors, you will see your +new trusted build on the Docker Index. It will will stay in sync with +your GitHub repo until you deactivate the Trusted Build. + +If you want to see the status of your Trusted Builds you can go to your +[Trusted Builds page](https://index.docker.io/builds/) on the Docker +index, and it will show you the status of your builds, and the build +history. + +Once you’ve created a Trusted Build you can deactivate or delete it. You +cannot however push to a Trusted Build with the `docker push` +command. You can only manage it by committing code to your +GitHub repository. + +You can create multiple Trusted Builds per repository and configure them +to point to specific `Dockerfile`‘s or Git branches. + +## Private Registry + +Private registries and private shared repositories are only possible by +hosting [your own +registry](https://github.com/dotcloud/docker-registry). To push or pull +to a repository on your own registry, you must prefix the tag with the +address of the registry’s host (a `.` or +`:` is used to identify a host), like this: + + # Tag to create a repository with the full registry location. + # The location (e.g. localhost.localdomain:5000) becomes + # a permanent part of the repository name + sudo docker tag 0u812deadbeef localhost.localdomain:5000/repo_name + + # Push the new repository to its home location on localhost + sudo docker push localhost.localdomain:5000/repo_name + +Once a repository has your registry’s host name as part of the tag, you +can push and pull it like any other repository, but it will **not** be +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 +registry](http://blog.docker.io/2013/07/how-to-use-your-own-registry/) + +## Authentication File + +The authentication is stored in a json file, `.dockercfg` +located in your home directory. It supports multiple registry +urls. + +`docker login` will create the +"[https://index.docker.io/v1/](https://index.docker.io/v1/)" key. + +`docker login https://my-registry.com` will create +the "[https://my-registry.com](https://my-registry.com)" key. + +For example: + + { + "https://index.docker.io/v1/": { + "auth": "xXxXxXxXxXx=", + "email": "email@example.com" + }, + "https://my-registry.com": { + "auth": "XxXxXxXxXxX=", + "email": "email@my-registry.com" + } + } + +The `auth` field represents +`base64(:)` From 4d3e448a33f87ed18def8f4ee7a01ef66bc6549e Mon Sep 17 00:00:00 2001 From: Thatcher Peskens Date: Tue, 15 Apr 2014 19:15:13 -0700 Subject: [PATCH 063/436] Changed heading colors and some alignments (no longer center and justification in left column) Docker-DCO-1.1-Signed-off-by: Thatcher Peskens (github: dhrp) --- docs/theme/mkdocs/css/base.css | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/docs/theme/mkdocs/css/base.css b/docs/theme/mkdocs/css/base.css index 822bb3ec0b..1651927cba 100644 --- a/docs/theme/mkdocs/css/base.css +++ b/docs/theme/mkdocs/css/base.css @@ -23,7 +23,7 @@ h6, font-family: "Cabin", "Helvetica Neue", Helvetica, Arial, sans-serif; font-weight: 500; line-height: 1.1; - color: inherit; + color: #0e6b8d; } @@ -33,15 +33,12 @@ h6, 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 { @@ -352,13 +349,11 @@ h6, margin: 0px; font-size: 1.7em; font-weight: bold; - color: #4291d1; - text-align: center; + color: #0e6b8d; } #toc_table > h3 { font-size: 1em; - color: #71afc0; - text-align: center; + color: #0e6b8d; } #toc_table > #toc_navigation { margin-top: 1.5em !important; @@ -374,7 +369,7 @@ h6, padding-bottom: 0px; padding: 0.2em 0.5em; border-bottom: 1px solid #ddd; - text-align: justify; + text-align: left; } #toc_table > #toc_navigation > li > a { padding: 0.4em 0.5em 0.4em 0em; @@ -405,7 +400,6 @@ h6, } #toc_table > #toc_navigation > li.active > a { - font-weight: bold; color: #FF8100; } #toc_table .bs-sidenav { From 2e78ab91ec0c99c52e4b61fe186f0ad8048de9e8 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Tue, 15 Apr 2014 14:57:43 -0600 Subject: [PATCH 064/436] Add missing "ps" requirement to PACKAGERS.md Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- docs/sources/installation/binaries.md | 1 + docs/sources/installation/binaries.rst | 1 + hack/PACKAGERS.md | 1 + 3 files changed, 3 insertions(+) diff --git a/docs/sources/installation/binaries.md b/docs/sources/installation/binaries.md index dbe79c983c..ecb9e9a0bd 100644 --- a/docs/sources/installation/binaries.md +++ b/docs/sources/installation/binaries.md @@ -25,6 +25,7 @@ runtime: - iptables version 1.4 or later - Git version 1.7 or later +- procps (or similar provider of a "ps" executable) - XZ Utils 4.9 or later - a [properly mounted](https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount) diff --git a/docs/sources/installation/binaries.rst b/docs/sources/installation/binaries.rst index c31e19acc4..9fa880b364 100644 --- a/docs/sources/installation/binaries.rst +++ b/docs/sources/installation/binaries.rst @@ -28,6 +28,7 @@ To run properly, docker needs the following software to be installed at runtime: - iptables version 1.4 or later - Git version 1.7 or later +- procps (or similar provider of a "ps" executable) - XZ Utils 4.9 or later - a `properly mounted `_ diff --git a/hack/PACKAGERS.md b/hack/PACKAGERS.md index 7170c5ad25..9edb4a3e14 100644 --- a/hack/PACKAGERS.md +++ b/hack/PACKAGERS.md @@ -265,6 +265,7 @@ To function properly, the Docker daemon needs the following software to be installed and available at runtime: * iptables version 1.4 or later +* procps (or similar provider of a "ps" executable) * XZ Utils version 4.9 or later * a [properly mounted](https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount) From ce7d251d520443228d5058f4fa9185b2f7e7b075 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Wed, 16 Apr 2014 14:43:52 +1000 Subject: [PATCH 065/436] rst->md conversion fix Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/articles/security.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/articles/security.md b/docs/sources/articles/security.md index 91fbb41c58..1a438295e7 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/). From b74fa7587228361f2e13606c260f559b56aaf323 Mon Sep 17 00:00:00 2001 From: "O.S.Tezer" Date: Wed, 16 Apr 2014 18:20:29 +0300 Subject: [PATCH 066/436] Amend breadcrumbs to link to the section indexes, i.e., home/section/ Docker-DCO-1.1-Signed-off-by: O.S. Tezer (github: ostezer) --- docs/theme/mkdocs/breadcrumbs.html | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/theme/mkdocs/breadcrumbs.html b/docs/theme/mkdocs/breadcrumbs.html index 5fa684432f..aa4e90af8b 100644 --- a/docs/theme/mkdocs/breadcrumbs.html +++ b/docs/theme/mkdocs/breadcrumbs.html @@ -2,13 +2,9 @@
  • {% for section in nav %} {% if section.active %} +
  • {{ section.title }}
  • {% if section.children %} - {% for page in section.children[:1] %} -
  • {{ section.title }}
  • - {% endfor %} - {% endif %} - {% if section.children %} -
  • {{ current_page.title }}
  • +
  • {{ current_page.title }}
  • {% endif %} {% endif %} {% endfor %} From 75d97a4d2f446b5357341ea16f95be8f3215eecd Mon Sep 17 00:00:00 2001 From: Aaron Huslage Date: Wed, 16 Apr 2014 11:11:28 -0400 Subject: [PATCH 067/436] Replacing ASCII art image with real diagram Docker-DCO-1.1-Signed-off-by: Aaron Huslage (github: huslage) --- docs/sources/article-img/architecture.svg | 3 +++ docs/sources/introduction/technology.md | 28 ++++++----------------- 2 files changed, 10 insertions(+), 21 deletions(-) create mode 100644 docs/sources/article-img/architecture.svg diff --git a/docs/sources/article-img/architecture.svg b/docs/sources/article-img/architecture.svg new file mode 100644 index 0000000000..607cc3c18f --- /dev/null +++ b/docs/sources/article-img/architecture.svg @@ -0,0 +1,3 @@ + + +2014-04-15 00:37ZCanvas 1Layer 1HostContainer 1Container 2Container 3Container ...Docker Clientdocker pulldocker rundocker ...Docker IndexDocker Daemon diff --git a/docs/sources/introduction/technology.md b/docs/sources/introduction/technology.md index ba1e09f0d7..6ae7445595 100644 --- a/docs/sources/introduction/technology.md +++ b/docs/sources/introduction/technology.md @@ -28,28 +28,14 @@ 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. +-- 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. ;-) +![Docker Architecture Diagram](/article-img/architecture.svg) ## The components of Docker From e1e512e2da5f642ded2eba6baa851f52bae0b05c Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Thu, 17 Apr 2014 00:16:07 +0900 Subject: [PATCH 068/436] This permission should be interpreted as octal, not decimal Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- archive/diff.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/archive/diff.go b/archive/diff.go index e20e4b1f02..87e8ac7dc4 100644 --- a/archive/diff.go +++ b/archive/diff.go @@ -68,7 +68,7 @@ func ApplyLayer(dest string, layer ArchiveReader) error { parent := filepath.Dir(hdr.Name) parentPath := filepath.Join(dest, parent) if _, err := os.Lstat(parentPath); err != nil && os.IsNotExist(err) { - err = os.MkdirAll(parentPath, 600) + err = os.MkdirAll(parentPath, 0600) if err != nil { return err } From 882862b095fb0bf6b554c2b11123c608ff68025e Mon Sep 17 00:00:00 2001 From: "O.S.Tezer" Date: Wed, 16 Apr 2014 19:38:08 +0300 Subject: [PATCH 069/436] Fix headers staying under the menu when clicked-to-scroll. Docker-DCO-1.1-Signed-off-by: O.S. Tezer (github: ostezer) --- docs/theme/mkdocs/css/base.css | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/theme/mkdocs/css/base.css b/docs/theme/mkdocs/css/base.css index 1651927cba..932b298eb1 100644 --- a/docs/theme/mkdocs/css/base.css +++ b/docs/theme/mkdocs/css/base.css @@ -37,6 +37,9 @@ h6, } #content h2 { padding: 0.5em 0em 0.3em 0em; + /* Desktop click-to-scroll margin/padding fixes */ + padding-top: 2em !important; + margin-top: -2em !important; } #content h3 { padding: 0.7em 0em 0.3em 0em; @@ -587,6 +590,13 @@ ol.breadcrumb > li:last-child > a { display: none; } + /* Mobile click-to-scroll margin/padding fixes */ + #content h2 { + padding: 0.5em 0em 0.3em 0em; + padding-top: 13.5em !important; + margin-top: -13.5em !important; + } + } /* Container responsiveness fixes to maximise realestate expenditure */ From 1775ed8c75fabb3544402ca13afe7a4c35b27038 Mon Sep 17 00:00:00 2001 From: "Guillaume J. Charmes" Date: Wed, 16 Apr 2014 14:44:14 -0700 Subject: [PATCH 070/436] Add integration test for hairpin nat Docker-DCO-1.1-Signed-off-by: Guillaume J. Charmes (github: creack) --- integration-cli/docker_cli_nat_test.go | 84 ++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 integration-cli/docker_cli_nat_test.go diff --git a/integration-cli/docker_cli_nat_test.go b/integration-cli/docker_cli_nat_test.go new file mode 100644 index 0000000000..d9dfaff556 --- /dev/null +++ b/integration-cli/docker_cli_nat_test.go @@ -0,0 +1,84 @@ +package main + +import ( + "encoding/json" + "fmt" + "github.com/dotcloud/docker/runtime" + "net" + "os/exec" + "path/filepath" + "testing" +) + +func TestNetworkNat(t *testing.T) { + ncPath, err := exec.LookPath("nc") + if err != nil { + t.Skip("Test not running with `make test`. Netcat not found: %s", err) + } + ncPath, err = filepath.EvalSymlinks(ncPath) + if err != nil { + t.Fatalf("Error resolving netcat symlink: %s", err) + } + iface, err := net.InterfaceByName("eth0") + if err != nil { + t.Skip("Test not running with `make test`. Interface eth0 not found: %s", err) + } + + ifaceAddrs, err := iface.Addrs() + if err != nil || len(ifaceAddrs) == 0 { + t.Fatalf("Error retrieving addresses for eth0: %v (%d addresses)", err, len(ifaceAddrs)) + } + + ifaceIp, _, err := net.ParseCIDR(ifaceAddrs[0].String()) + if err != nil { + t.Fatalf("Error retrieving the up for eth0: %s", err) + } + + runCmd := exec.Command(dockerBinary, "run", "-d", + "-v", ncPath+":/bin/nc", + "-v", "/lib/x86_64-linux-gnu/libc.so.6:/lib/libc.so.6", "-v", "/lib/x86_64-linux-gnu/libresolv.so.2:/lib/libresolv.so.2", "-v", "/lib/x86_64-linux-gnu/libbsd.so.0:/lib/libbsd.so.0", "-v", "/lib/x86_64-linux-gnu/ld-linux-x86-64.so.2:/lib/ld-linux-x86-64.so.2", + "-p", "8080", "busybox", "/bin/nc", "-lp", "8080") + out, _, err := runCommandWithOutput(runCmd) + errorOut(err, t, fmt.Sprintf("run1 failed with errors: %v (%s)", err, out)) + + cleanedContainerID := stripTrailingCharacters(out) + + inspectCmd := exec.Command(dockerBinary, "inspect", cleanedContainerID) + inspectOut, _, err := runCommandWithOutput(inspectCmd) + errorOut(err, t, fmt.Sprintf("out should've been a container id: %v %v", inspectOut, err)) + + containers := []*runtime.Container{} + if err := json.Unmarshal([]byte(inspectOut), &containers); err != nil { + t.Fatalf("Error inspecting the container: %s", err) + } + if len(containers) != 1 { + t.Fatalf("Unepexted container count. Expected 0, recieved: %d", len(containers)) + } + + port8080, exists := containers[0].NetworkSettings.Ports["8080/tcp"] + if !exists || len(port8080) == 0 { + t.Fatal("Port 8080/tcp not found in NetworkSettings") + } + + runCmd = exec.Command(dockerBinary, "run", + "-v", ncPath+":/bin/nc", + "-v", "/lib/x86_64-linux-gnu/libc.so.6:/lib/libc.so.6", "-v", "/lib/x86_64-linux-gnu/libresolv.so.2:/lib/libresolv.so.2", "-v", "/lib/x86_64-linux-gnu/libbsd.so.0:/lib/libbsd.so.0", "-v", "/lib/x86_64-linux-gnu/ld-linux-x86-64.so.2:/lib/ld-linux-x86-64.so.2", + "-p", "8080", "busybox", "sh", "-c", fmt.Sprintf("echo hello world | /bin/nc -w 30 %s %s", ifaceIp, port8080[0].HostPort)) + out, _, err = runCommandWithOutput(runCmd) + errorOut(err, t, fmt.Sprintf("run2 failed with errors: %v (%s)", err, out)) + + runCmd = exec.Command(dockerBinary, "logs", cleanedContainerID) + out, _, err = runCommandWithOutput(runCmd) + errorOut(err, t, fmt.Sprintf("failed to retrieve logs for container: %v %v", cleanedContainerID, err)) + + if expected := "hello world\n"; out != expected { + t.Fatalf("Unexpected output. Expected: %s, recieved: -->%s<--", expected, out) + } + + killCmd := exec.Command(dockerBinary, "kill", cleanedContainerID) + out, _, err = runCommandWithOutput(killCmd) + errorOut(err, t, fmt.Sprintf("failed to kill container: %v %v", out, err)) + deleteAllContainers() + + logDone("network - make sure nat works through the host") +} From 92ea101bc4a498e952ede00bff53d0123f22f41c Mon Sep 17 00:00:00 2001 From: Kato Kazuyoshi Date: Thu, 17 Apr 2014 00:41:19 +0900 Subject: [PATCH 071/436] SQLite is also available in FreeBSD Docker-DCO-1.1-Signed-off-by: Kato Kazuyoshi (github: kzys) --- hack/make.sh | 8 ++++++++ pkg/graphdb/{conn_linux.go => conn_sqlite3.go} | 2 +- pkg/graphdb/conn_unsupported.go | 2 +- 3 files changed, 10 insertions(+), 2 deletions(-) rename pkg/graphdb/{conn_linux.go => conn_sqlite3.go} (92%) diff --git a/hack/make.sh b/hack/make.sh index f3264c9ce3..46df398c57 100755 --- a/hack/make.sh +++ b/hack/make.sh @@ -117,6 +117,14 @@ if [ "$(uname -s)" = 'FreeBSD' ]; then LDFLAGS="$LDFLAGS -extld clang" fi +# If sqlite3.h doesn't exist under /usr/include, +# check /usr/local/include also just in case +# (e.g. FreeBSD Ports installs it under the directory) +if [ ! -e /usr/include/sqlite3.h ] && [ -e /usr/local/include/sqlite3.h ]; then + export CGO_CFLAGS='-I/usr/local/include' + export CGO_LDFLAGS='-L/usr/local/lib' +fi + HAVE_GO_TEST_COVER= if \ go help testflag | grep -- -cover > /dev/null \ diff --git a/pkg/graphdb/conn_linux.go b/pkg/graphdb/conn_sqlite3.go similarity index 92% rename from pkg/graphdb/conn_linux.go rename to pkg/graphdb/conn_sqlite3.go index 7a1ab8c92f..5b5f8e6bfc 100644 --- a/pkg/graphdb/conn_linux.go +++ b/pkg/graphdb/conn_sqlite3.go @@ -1,4 +1,4 @@ -// +build amd64 +// +build linux,amd64 freebsd,cgo package graphdb diff --git a/pkg/graphdb/conn_unsupported.go b/pkg/graphdb/conn_unsupported.go index c2d602569f..0a48634336 100644 --- a/pkg/graphdb/conn_unsupported.go +++ b/pkg/graphdb/conn_unsupported.go @@ -1,4 +1,4 @@ -// +build !linux !amd64 +// +build !linux,!freebsd linux,!amd64 freebsd,!cgo package graphdb From 4ba7b28006620962ae8a0f6cb5865a5e1a65b332 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Thu, 17 Apr 2014 08:43:07 +1000 Subject: [PATCH 072/436] this topic nolonger crashes the build Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index b91fe10125..502fb3dbfe 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -71,7 +71,7 @@ pages: - ['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/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'] From 3ac90aeed5a6bdfe22af48eca1519fb186dc66cb Mon Sep 17 00:00:00 2001 From: unclejack Date: Thu, 17 Apr 2014 03:38:08 +0300 Subject: [PATCH 073/436] provide more information when TestTop tests fail Docker-DCO-1.1-Signed-off-by: Cristian Staretu (github: unclejack) --- integration-cli/docker_cli_top_test.go | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/integration-cli/docker_cli_top_test.go b/integration-cli/docker_cli_top_test.go index d75ec54217..6535473430 100644 --- a/integration-cli/docker_cli_top_test.go +++ b/integration-cli/docker_cli_top_test.go @@ -18,14 +18,22 @@ func TestTopNonPrivileged(t *testing.T) { out, _, err = runCommandWithOutput(topCmd) errorOut(err, t, fmt.Sprintf("failed to run top: %v %v", out, err)) + topCmd = exec.Command(dockerBinary, "top", cleanedContainerID) + out2, _, err2 := runCommandWithOutput(topCmd) + errorOut(err, t, fmt.Sprintf("failed to run top: %v %v", out2, err2)) + killCmd := exec.Command(dockerBinary, "kill", cleanedContainerID) _, err = runCommand(killCmd) errorOut(err, t, fmt.Sprintf("failed to kill container: %v", err)) deleteContainer(cleanedContainerID) - if !strings.Contains(out, "sleep 20") { - t.Fatal("top should've listed sleep 20 in the process list") + if !strings.Contains(out, "sleep 20") && !strings.Contains(out2, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed twice") + } else if !strings.Contains(out, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed the first time") + } else if !strings.Contains(out2, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed the second itime") } logDone("top - sleep process should be listed in non privileged mode") @@ -42,14 +50,22 @@ func TestTopPrivileged(t *testing.T) { out, _, err = runCommandWithOutput(topCmd) errorOut(err, t, fmt.Sprintf("failed to run top: %v %v", out, err)) + topCmd = exec.Command(dockerBinary, "top", cleanedContainerID) + out2, _, err2 := runCommandWithOutput(topCmd) + errorOut(err, t, fmt.Sprintf("failed to run top: %v %v", out2, err2)) + killCmd := exec.Command(dockerBinary, "kill", cleanedContainerID) _, err = runCommand(killCmd) errorOut(err, t, fmt.Sprintf("failed to kill container: %v", err)) deleteContainer(cleanedContainerID) - if !strings.Contains(out, "sleep 20") { - t.Fatal("top should've listed sleep 20 in the process list") + if !strings.Contains(out, "sleep 20") && !strings.Contains(out2, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed twice") + } else if !strings.Contains(out, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed the first time") + } else if !strings.Contains(out2, "sleep 20") { + t.Fatal("top should've listed `sleep 20` in the process list, but failed the second itime") } logDone("top - sleep process should be listed in privileged mode") From 7de1557b2e5bc1ed86e19ffe080889ac74beea42 Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Wed, 16 Apr 2014 18:56:02 -0600 Subject: [PATCH 074/436] Add "validate" Makefile target This was supposed to be part of my previous PR, but somehow got missed. Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- Makefile | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 4186869ce2..b29d21746e 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -.PHONY: all binary build cross default docs docs-build docs-shell shell test test-integration test-integration-cli +.PHONY: all binary build cross default docs docs-build docs-shell shell test test-integration test-integration-cli validate # to allow `make BINDDIR=. shell` or `make BINDDIR= test` BINDDIR := bundles @@ -43,6 +43,9 @@ test-integration: build test-integration-cli: build $(DOCKER_RUN_DOCKER) hack/make.sh binary test-integration-cli +validate: build + $(DOCKER_RUN_DOCKER) hack/make.sh validate-gofmt validate-dco + shell: build $(DOCKER_RUN_DOCKER) bash From 65fb2e77eb8c5fdb419a94058f7b4630c00871af Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Thu, 17 Apr 2014 11:11:32 +1000 Subject: [PATCH 075/436] simplify the docs branch process for now Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/README.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/README.md b/docs/README.md index de1b1250f0..a113cb9edd 100755 --- a/docs/README.md +++ b/docs/README.md @@ -17,20 +17,21 @@ 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 a local branch of the ``master`` branch. That way your fixes +``docs`` branch. You should always edit +docs on a local branch of the ``master`` branch, and send a PR against ``master``. +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. +can easily cherry-pick your changes into the ``docs`` release branch. +In the rare case where your change is not forward-compatible, +you may need to base your changes on the ``docs`` branch. -Now that we have a ``doc*`` branch, we can keep the ``latest`` docs +Now that we have a ``docs`` branch, we can keep the [http://docs.docker.io](http://docs.docker.io) docs up to date with any bugs found between ``docker`` code releases. -**Warning**: When *reading* the docs, the ``master`` documentation may +**Warning**: When *reading* the docs, the [http://beta-docs.docker.io](http://beta-docs.docker.io) documentation may include features not yet part of any official docker -release. ``Master`` docs should be used only for understanding -bleeding-edge development and ``latest`` (which points to the ``doc*`` +release. The ``beta-docs`` site should be used only for understanding +bleeding-edge development and ``docs.docker.io`` (which points to the ``docs`` branch``) should be used for the latest official release. Getting Started @@ -38,7 +39,7 @@ Getting Started 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 +docs. It then starts a HTTP server on port 8000 so that you can connect and see your changes. In the ``docker`` source directory, run: From 205e85da3211ed1600982ee1d189f1d070aa8b40 Mon Sep 17 00:00:00 2001 From: "O.S.Tezer" Date: Thu, 17 Apr 2014 15:04:41 +0300 Subject: [PATCH 076/436] Fix for TOC "click/expand" & "scroll position" problem on mobile. Fixes: - Click/expand - Scroll pos. - TOC table scroll-down arrow. - TOC title scrolls to top. Docker-DCO-1.1-Signed-off-by: O.S. Tezer (github: ostezer) --- docs/theme/mkdocs/css/base.css | 16 +++++++++------- docs/theme/mkdocs/js/base.js | 7 +++++-- docs/theme/mkdocs/toc.html | 2 +- 3 files changed, 15 insertions(+), 10 deletions(-) diff --git a/docs/theme/mkdocs/css/base.css b/docs/theme/mkdocs/css/base.css index 932b298eb1..e701bd4c1f 100644 --- a/docs/theme/mkdocs/css/base.css +++ b/docs/theme/mkdocs/css/base.css @@ -40,6 +40,7 @@ h6, /* Desktop click-to-scroll margin/padding fixes */ padding-top: 2em !important; margin-top: -2em !important; + pointer-events:none; } #content h3 { padding: 0.7em 0em 0.3em 0em; @@ -354,11 +355,16 @@ h6, font-weight: bold; color: #0e6b8d; } +#toc_table > h2 > a > b { + display: none; + border-top-color: #0e6b8d !important; +} #toc_table > h3 { font-size: 1em; color: #0e6b8d; } #toc_table > #toc_navigation { + display: block; margin-top: 1.5em !important; background: #fff; border-bottom: 3px solid #ddd; @@ -572,6 +578,9 @@ ol.breadcrumb > li:last-child > a { margin-bottom: 0.3em; font-size: 2em; } + #toc_table > h2 > a > b { + display: inline-block; + } #toc_table > h3 { display: block; margin: 0; @@ -590,13 +599,6 @@ ol.breadcrumb > li:last-child > a { display: none; } - /* Mobile click-to-scroll margin/padding fixes */ - #content h2 { - padding: 0.5em 0em 0.3em 0em; - padding-top: 13.5em !important; - margin-top: -13.5em !important; - } - } /* Container responsiveness fixes to maximise realestate expenditure */ diff --git a/docs/theme/mkdocs/js/base.js b/docs/theme/mkdocs/js/base.js index f0ee5edb12..13d5e92253 100644 --- a/docs/theme/mkdocs/js/base.js +++ b/docs/theme/mkdocs/js/base.js @@ -30,13 +30,13 @@ $(document).ready(function () }); /* Toggle TOC view for Mobile */ - $('#toc_table').on('click', function () + $('#toc_table > h2').on('click', function () { if ( $(window).width() <= 991 ) { $('#toc_table > #toc_navigation').slideToggle(); } - }) + }); /* Follow TOC links (ScrollSpy) */ $('body').scrollspy({ @@ -61,6 +61,9 @@ function checkToScrollTOC () { if ( $(window).width() >= 768 ) { + // If TOC is hidden, expand. + $('#toc_table > #toc_navigation').css("display", "block"); + // Then attach or detach fixed-scroll if ( ($('#toc_table').height() + 100) >= $(window).height() ) { $('#toc_table').trigger('detach.ScrollToFixed'); diff --git a/docs/theme/mkdocs/toc.html b/docs/theme/mkdocs/toc.html index 5b7de24ffc..e53310d829 100644 --- a/docs/theme/mkdocs/toc.html +++ b/docs/theme/mkdocs/toc.html @@ -1,6 +1,6 @@ -- -- -- -- -- -- -- -- -- -- -- -- -- - - - diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 7971c56d9e..29b926816c 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -119,10 +119,10 @@ pages: # - ['static_files/README.md', 'static_files', 'README'] - ['terms/index.md', '**HIDDEN**'] -- ['terms/layer.md', '**HIDDEN**', 'layer'] -- ['terms/index.md', '**HIDDEN**', 'Home'] -- ['terms/registry.md', '**HIDDEN**', 'registry'] -- ['terms/container.md', '**HIDDEN**', 'container'] -- ['terms/repository.md', '**HIDDEN**', 'repository'] -- ['terms/filesystem.md', '**HIDDEN**', 'filesystem'] -- ['terms/image.md', '**HIDDEN**', 'image'] +- ['terms/layer.md', '**HIDDEN**'] +- ['terms/index.md', '**HIDDEN**'] +- ['terms/registry.md', '**HIDDEN**'] +- ['terms/container.md', '**HIDDEN**'] +- ['terms/repository.md', '**HIDDEN**'] +- ['terms/filesystem.md', '**HIDDEN**'] +- ['terms/image.md', '**HIDDEN**'] diff --git a/docs/pr4923.patch b/docs/pr4923.patch deleted file mode 100644 index ef420520f7..0000000000 --- a/docs/pr4923.patch +++ /dev/null @@ -1,12836 +0,0 @@ -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/requirements.txt b/docs/requirements.txt deleted file mode 100644 index 6f41142a84..0000000000 --- a/docs/requirements.txt +++ /dev/null @@ -1,2 +0,0 @@ -Sphinx==1.2.1 -sphinxcontrib-httpdomain==1.2.0 diff --git a/docs/sources/articles/baseimages.rst b/docs/sources/articles/baseimages.rst deleted file mode 100644 index 61c8f7d9c5..0000000000 --- a/docs/sources/articles/baseimages.rst +++ /dev/null @@ -1,65 +0,0 @@ -:title: Create a Base Image -:description: How to create base images -:keywords: Examples, Usage, base image, docker, documentation, examples - -.. _base_image_creation: - -Create a Base Image -=================== - -So you want to create your own :ref:`base_image_def`? Great! - -The specific process will depend heavily on the Linux distribution you -want to package. We have some examples below, and you are encouraged -to submit pull requests to contribute new ones. - -Create a full image using tar -............................. - -In general, you'll want to start with a working machine that is -running the distribution you'd like to package as a base image, though -that is not required for some tools like Debian's `Debootstrap -`_, which you can also use to -build Ubuntu images. - -It can be as simple as this to create an Ubuntu base image:: - - $ sudo debootstrap raring raring > /dev/null - $ sudo tar -C raring -c . | sudo docker import - raring - a29c15f1bf7a - $ sudo docker run raring cat /etc/lsb-release - DISTRIB_ID=Ubuntu - DISTRIB_RELEASE=13.04 - DISTRIB_CODENAME=raring - DISTRIB_DESCRIPTION="Ubuntu 13.04" - -There are more example scripts for creating base images in the -Docker GitHub Repo: - -* `BusyBox `_ -* CentOS / Scientific Linux CERN (SLC) `on Debian/Ubuntu - `_ - or - `on CentOS/RHEL/SLC/etc. - `_ -* `Debian / Ubuntu - `_ - - -Creating a simple base image using ``scratch`` -.............................................. - -There is a special repository in the Docker registry called ``scratch``, which -was created using an empty tar file:: - - $ tar cv --files-from /dev/null | docker import - scratch - -which you can ``docker pull``. You can then use that image to base your new -minimal containers ``FROM``:: - - FROM scratch - ADD true-asm /true - CMD ["/true"] - -The Dockerfile above is from extremely minimal image - -`tianon/true `_. diff --git a/docs/sources/articles/index.rst b/docs/sources/articles/index.rst deleted file mode 100644 index 75c0cd3fa9..0000000000 --- a/docs/sources/articles/index.rst +++ /dev/null @@ -1,15 +0,0 @@ -:title: Docker articles -:description: various articles related to Docker -:keywords: docker, articles - -.. _articles_list: - -Articles -======== - -.. toctree:: - :maxdepth: 1 - - security - baseimages - runmetrics diff --git a/docs/sources/articles/runmetrics.rst b/docs/sources/articles/runmetrics.rst deleted file mode 100644 index 6b705fb737..0000000000 --- a/docs/sources/articles/runmetrics.rst +++ /dev/null @@ -1,463 +0,0 @@ -:title: Runtime Metrics -:description: Measure the behavior of running containers -:keywords: docker, metrics, CPU, memory, disk, IO, run, runtime - -.. _run_metrics: - - -Runtime Metrics -=============== - -Linux Containers rely on `control groups -`_ which -not only track groups of processes, but also expose metrics about CPU, -memory, and block I/O usage. You can access those metrics and obtain -network usage metrics as well. This is relevant for "pure" LXC -containers, as well as for Docker containers. - -Control Groups --------------- - -Control groups are exposed through a pseudo-filesystem. In recent -distros, you should find this filesystem under -``/sys/fs/cgroup``. Under that directory, you will see multiple -sub-directories, called devices, freezer, blkio, etc.; each -sub-directory actually corresponds to a different cgroup hierarchy. - -On older systems, the control groups might be mounted on ``/cgroup``, -without distinct hierarchies. In that case, instead of seeing the -sub-directories, you will see a bunch of files in that directory, and -possibly some directories corresponding to existing containers. - -To figure out where your control groups are mounted, you can run: - -:: - - grep cgroup /proc/mounts - -.. _run_findpid: - -Enumerating Cgroups -------------------- - -You can look into ``/proc/cgroups`` to see the different control group -subsystems known to the system, the hierarchy they belong to, and how -many groups they contain. - -You can also look at ``/proc//cgroup`` to see which control -groups a process belongs to. The control group will be shown as a path -relative to the root of the hierarchy mountpoint; e.g. ``/`` means -“this process has not been assigned into a particular group”, while -``/lxc/pumpkin`` means that the process is likely to be a member of a -container named ``pumpkin``. - -Finding the Cgroup for a Given Container ----------------------------------------- - -For each container, one cgroup will be created in each hierarchy. On -older systems with older versions of the LXC userland tools, the name -of the cgroup will be the name of the container. With more recent -versions of the LXC tools, the cgroup will be ``lxc/.`` - -For Docker containers using cgroups, the container name will be the -full 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``. You -can look it up with ``docker inspect`` or ``docker ps --no-trunc``. - -Putting everything together to look at the memory metrics for a Docker -container, take a look at ``/sys/fs/cgroup/memory/lxc//``. - -Metrics from Cgroups: Memory, CPU, Block IO -------------------------------------------- - -For each subsystem (memory, CPU, and block I/O), you will find one or -more pseudo-files containing statistics. - -Memory Metrics: ``memory.stat`` -............................... - -Memory metrics are found in the "memory" cgroup. Note that the memory -control group adds a little overhead, because it does very -fine-grained accounting of the memory usage on your host. Therefore, -many distros chose to not enable it by default. Generally, to enable -it, all you have to do is to add some kernel command-line parameters: -``cgroup_enable=memory swapaccount=1``. - -The metrics are in the pseudo-file ``memory.stat``. Here is what it -will look like: - -:: - - cache 11492564992 - rss 1930993664 - mapped_file 306728960 - pgpgin 406632648 - pgpgout 403355412 - swap 0 - pgfault 728281223 - pgmajfault 1724 - inactive_anon 46608384 - active_anon 1884520448 - inactive_file 7003344896 - active_file 4489052160 - unevictable 32768 - hierarchical_memory_limit 9223372036854775807 - hierarchical_memsw_limit 9223372036854775807 - total_cache 11492564992 - total_rss 1930993664 - total_mapped_file 306728960 - total_pgpgin 406632648 - total_pgpgout 403355412 - total_swap 0 - total_pgfault 728281223 - total_pgmajfault 1724 - total_inactive_anon 46608384 - total_active_anon 1884520448 - total_inactive_file 7003344896 - total_active_file 4489052160 - total_unevictable 32768 - -The first half (without the ``total_`` prefix) contains statistics -relevant to the processes within the cgroup, excluding -sub-cgroups. The second half (with the ``total_`` prefix) includes -sub-cgroups as well. - -Some metrics are "gauges", i.e. values that can increase or decrease -(e.g. swap, the amount of swap space used by the members of the -cgroup). Some others are "counters", i.e. values that can only go up, -because they represent occurrences of a specific event (e.g. pgfault, -which indicates the number of page faults which happened since the -creation of the cgroup; this number can never decrease). - -cache - the amount of memory used by the processes of this control group - that can be associated precisely with a block on a block - device. When you read from and write to files on disk, this amount - will increase. This will be the case if you use "conventional" I/O - (``open``, ``read``, ``write`` syscalls) as well as mapped files - (with ``mmap``). It also accounts for the memory used by ``tmpfs`` - mounts, though the reasons are unclear. - -rss - the amount of memory that *doesn't* correspond to anything on - disk: stacks, heaps, and anonymous memory maps. - -mapped_file - indicates the amount of memory mapped by the processes in the - control group. It doesn't give you information about *how much* - memory is used; it rather tells you *how* it is used. - -pgfault and pgmajfault - indicate the number of times that a process of the cgroup triggered - a "page fault" and a "major fault", respectively. A page fault - happens when a process accesses a part of its virtual memory space - which is nonexistent or protected. The former can happen if the - process is buggy and tries to access an invalid address (it will - then be sent a ``SIGSEGV`` signal, typically killing it with the - famous ``Segmentation fault`` message). The latter can happen when - the process reads from a memory zone which has been swapped out, or - which corresponds to a mapped file: in that case, the kernel will - load the page from disk, and let the CPU complete the memory - access. It can also happen when the process writes to a - copy-on-write memory zone: likewise, the kernel will preempt the - process, duplicate the memory page, and resume the write operation - on the process' own copy of the page. "Major" faults happen when the - kernel actually has to read the data from disk. When it just has to - duplicate an existing page, or allocate an empty page, it's a - regular (or "minor") fault. - -swap - the amount of swap currently used by the processes in this cgroup. - -active_anon and inactive_anon - the amount of *anonymous* memory that has been identified has - respectively *active* and *inactive* by the kernel. "Anonymous" - memory is the memory that is *not* linked to disk pages. In other - words, that's the equivalent of the rss counter described above. In - fact, the very definition of the rss counter is **active_anon** + - **inactive_anon** - **tmpfs** (where tmpfs is the amount of memory - used up by ``tmpfs`` filesystems mounted by this control - group). Now, what's the difference between "active" and "inactive"? - Pages are initially "active"; and at regular intervals, the kernel - sweeps over the memory, and tags some pages as "inactive". Whenever - they are accessed again, they are immediately retagged - "active". When the kernel is almost out of memory, and time comes to - swap out to disk, the kernel will swap "inactive" pages. - -active_file and inactive_file - cache memory, with *active* and *inactive* similar to the *anon* - memory above. The exact formula is cache = **active_file** + - **inactive_file** + **tmpfs**. The exact rules used by the kernel to - move memory pages between active and inactive sets are different - from the ones used for anonymous memory, but the general principle - is the same. Note that when the kernel needs to reclaim memory, it - is cheaper to reclaim a clean (=non modified) page from this pool, - since it can be reclaimed immediately (while anonymous pages and - dirty/modified pages have to be written to disk first). - -unevictable - the amount of memory that cannot be reclaimed; generally, it will - account for memory that has been "locked" with ``mlock``. It is - often used by crypto frameworks to make sure that secret keys and - other sensitive material never gets swapped out to disk. - -memory and memsw limits - These are not really metrics, but a reminder of the limits applied - to this cgroup. The first one indicates the maximum amount of - physical memory that can be used by the processes of this control - group; the second one indicates the maximum amount of RAM+swap. - -Accounting for memory in the page cache is very complex. If two -processes in different control groups both read the same file -(ultimately relying on the same blocks on disk), the corresponding -memory charge will be split between the control groups. It's nice, but -it also means that when a cgroup is terminated, it could increase the -memory usage of another cgroup, because they are not splitting the -cost anymore for those memory pages. - -CPU metrics: ``cpuacct.stat`` -............................. - -Now that we've covered memory metrics, everything else will look very -simple in comparison. CPU metrics will be found in the ``cpuacct`` -controller. - -For each container, you will find a pseudo-file ``cpuacct.stat``, -containing the CPU usage accumulated by the processes of the -container, broken down between ``user`` and ``system`` time. If you're -not familiar with the distinction, ``user`` is the time during which -the processes were in direct control of the CPU (i.e. executing -process code), and ``system`` is the time during which the CPU was -executing system calls on behalf of those processes. - -Those times are expressed in ticks of 1/100th of a second. Actually, -they are expressed in "user jiffies". There are ``USER_HZ`` -*"jiffies"* per second, and on x86 systems, ``USER_HZ`` is 100. This -used to map exactly to the number of scheduler "ticks" per second; but -with the advent of higher frequency scheduling, as well as `tickless -kernels `_, the number of kernel -ticks wasn't relevant anymore. It stuck around anyway, mainly for -legacy and compatibility reasons. - -Block I/O metrics -................. - -Block I/O is accounted in the ``blkio`` controller. Different metrics -are scattered across different files. While you can find in-depth -details in the `blkio-controller -`_ -file in the kernel documentation, here is a short list of the most -relevant ones: - -blkio.sectors - contain the number of 512-bytes sectors read and written by the - processes member of the cgroup, device by device. Reads and writes - are merged in a single counter. - -blkio.io_service_bytes - indicates the number of bytes read and written by the cgroup. It has - 4 counters per device, because for each device, it differentiates - between synchronous vs. asynchronous I/O, and reads vs. writes. - -blkio.io_serviced - the number of I/O operations performed, regardless of their size. It - also has 4 counters per device. - -blkio.io_queued - indicates the number of I/O operations currently queued for this - cgroup. In other words, if the cgroup isn't doing any I/O, this will - be zero. Note that the opposite is not true. In other words, if - there is no I/O queued, it does not mean that the cgroup is idle - (I/O-wise). It could be doing purely synchronous reads on an - otherwise quiescent device, which is therefore able to handle them - immediately, without queuing. Also, while it is helpful to figure - out which cgroup is putting stress on the I/O subsystem, keep in - mind that is is a relative quantity. Even if a process group does - not perform more I/O, its queue size can increase just because the - device load increases because of other devices. - -Network Metrics ---------------- - -Network metrics are not exposed directly by control groups. There is a -good explanation for that: network interfaces exist within the context -of *network namespaces*. The kernel could probably accumulate metrics -about packets and bytes sent and received by a group of processes, but -those metrics wouldn't be very useful. You want per-interface metrics -(because traffic happening on the local ``lo`` interface doesn't -really count). But since processes in a single cgroup can belong to -multiple network namespaces, those metrics would be harder to -interpret: multiple network namespaces means multiple ``lo`` -interfaces, potentially multiple ``eth0`` interfaces, etc.; so this is -why there is no easy way to gather network metrics with control -groups. - -Instead we can gather network metrics from other sources: - -IPtables -........ - -IPtables (or rather, the netfilter framework for which iptables is -just an interface) can do some serious accounting. - -For instance, you can setup a rule to account for the outbound HTTP -traffic on a web server: - -:: - - iptables -I OUTPUT -p tcp --sport 80 - - -There is no ``-j`` or ``-g`` flag, so the rule will just count matched -packets and go to the following rule. - -Later, you can check the values of the counters, with: - -:: - - iptables -nxvL OUTPUT - -Technically, ``-n`` is not required, but it will prevent iptables from -doing DNS reverse lookups, which are probably useless in this -scenario. - -Counters include packets and bytes. If you want to setup metrics for -container traffic like this, you could execute a ``for`` loop to add -two ``iptables`` rules per container IP address (one in each -direction), in the ``FORWARD`` chain. This will only meter traffic -going through the NAT layer; you will also have to add traffic going -through the userland proxy. - -Then, you will need to check those counters on a regular basis. If you -happen to use ``collectd``, there is a nice plugin to automate -iptables counters collection. - -Interface-level counters -........................ - -Since each container has a virtual Ethernet interface, you might want -to check directly the TX and RX counters of this interface. You will -notice that each container is associated to a virtual Ethernet -interface in your host, with a name like ``vethKk8Zqi``. Figuring out -which interface corresponds to which container is, unfortunately, -difficult. - -But for now, the best way is to check the metrics *from within the -containers*. To accomplish this, you can run an executable from the -host environment within the network namespace of a container using -**ip-netns magic**. - -The ``ip-netns exec`` command will let you execute any program -(present in the host system) within any network namespace visible to -the current process. This means that your host will be able to enter -the network namespace of your containers, but your containers won't be -able to access the host, nor their sibling containers. Containers will -be able to “see” and affect their sub-containers, though. - -The exact format of the command is:: - - ip netns exec - -For example:: - - ip netns exec mycontainer netstat -i - -``ip netns`` finds the "mycontainer" container by using namespaces -pseudo-files. Each process belongs to one network namespace, one PID -namespace, one ``mnt`` namespace, etc., and those namespaces are -materialized under ``/proc//ns/``. For example, the network -namespace of PID 42 is materialized by the pseudo-file -``/proc/42/ns/net``. - -When you run ``ip netns exec mycontainer ...``, it expects -``/var/run/netns/mycontainer`` to be one of those -pseudo-files. (Symlinks are accepted.) - -In other words, to execute a command within the network namespace of a -container, we need to: - -* Find out the PID of any process within the container that we want to - investigate; -* Create a symlink from ``/var/run/netns/`` to - ``/proc//ns/net`` -* Execute ``ip netns exec ....`` - -Please review :ref:`run_findpid` to learn how to find the cgroup of a -pprocess running in the container of which you want to measure network -usage. From there, you can examine the pseudo-file named ``tasks``, -which containes the PIDs that are in the control group (i.e. in the -container). Pick any one of them. - -Putting everything together, if the "short ID" of a container is held -in the environment variable ``$CID``, then you can do this:: - - TASKS=/sys/fs/cgroup/devices/$CID*/tasks - PID=$(head -n 1 $TASKS) - mkdir -p /var/run/netns - ln -sf /proc/$PID/ns/net /var/run/netns/$CID - ip netns exec $CID netstat -i - - -Tips for high-performance metric collection -------------------------------------------- - -Note that running a new process each time you want to update metrics -is (relatively) expensive. If you want to collect metrics at high -resolutions, and/or over a large number of containers (think 1000 -containers on a single host), you do not want to fork a new process -each time. - -Here is how to collect metrics from a single process. You will have to -write your metric collector in C (or any language that lets you do -low-level system calls). You need to use a special system call, -``setns()``, which lets the current process enter any arbitrary -namespace. It requires, however, an open file descriptor to the -namespace pseudo-file (remember: that’s the pseudo-file in -``/proc//ns/net``). - -However, there is a catch: you must not keep this file descriptor -open. If you do, when the last process of the control group exits, the -namespace will not be destroyed, and its network resources (like the -virtual interface of the container) will stay around for ever (or -until you close that file descriptor). - -The right approach would be to keep track of the first PID of each -container, and re-open the namespace pseudo-file each time. - -Collecting metrics when a container exits ------------------------------------------ - -Sometimes, you do not care about real time metric collection, but when -a container exits, you want to know how much CPU, memory, etc. it has -used. - -Docker makes this difficult because it relies on ``lxc-start``, which -carefully cleans up after itself, but it is still possible. It is -usually easier to collect metrics at regular intervals (e.g. every -minute, with the collectd LXC plugin) and rely on that instead. - -But, if you'd still like to gather the stats when a container stops, -here is how: - -For each container, start a collection process, and move it to the -control groups that you want to monitor by writing its PID to the -tasks file of the cgroup. The collection process should periodically -re-read the tasks file to check if it's the last process of the -control group. (If you also want to collect network statistics as -explained in the previous section, you should also move the process to -the appropriate network namespace.) - -When the container exits, ``lxc-start`` will try to delete the control -groups. It will fail, since the control group is still in use; but -that’s fine. You process should now detect that it is the only one -remaining in the group. Now is the right time to collect all the -metrics you need! - -Finally, your process should move itself back to the root control -group, and remove the container control group. To remove a control -group, just ``rmdir`` its directory. It's counter-intuitive to -``rmdir`` a directory as it still contains files; but remember that -this is a pseudo-filesystem, so usual rules don't apply. After the -cleanup is done, the collection process can exit safely. - diff --git a/docs/sources/articles/security.rst b/docs/sources/articles/security.rst deleted file mode 100644 index ec2ab9bffd..0000000000 --- a/docs/sources/articles/security.rst +++ /dev/null @@ -1,269 +0,0 @@ -:title: Docker Security -:description: Review of the Docker Daemon attack surface -:keywords: Docker, Docker documentation, security - -.. _dockersecurity: - -Docker Security -=============== - - *Adapted from* `Containers & Docker: How Secure are They? `_ - -There are three major areas to consider when reviewing Docker security: - -* the intrinsic security of containers, as implemented by kernel - namespaces and cgroups; -* the attack surface of the Docker daemon itself; -* the "hardening" security features of the kernel and how they - interact with containers. - -Kernel Namespaces ------------------ - -Docker containers are essentially LXC containers, and they come with -the same security features. When you start a container with ``docker -run``, behind the scenes Docker uses ``lxc-start`` to execute the -Docker container. This creates a set of namespaces and control groups -for the container. Those namespaces and control groups are not created -by Docker itself, but by ``lxc-start``. This means that as the LXC -userland tools evolve (and provide additional namespaces and isolation -features), Docker will automatically make use of them. - -**Namespaces provide the first and most straightforward form of -isolation**: processes running within a container cannot see, and even -less affect, processes running in another container, or in the host -system. - -**Each container also gets its own network stack**, meaning that a -container doesn’t get a privileged access to the sockets or interfaces -of another container. Of course, if the host system is setup -accordingly, containers can interact with each other through their -respective network interfaces — just like they can interact with -external hosts. When you specify public ports for your containers or -use :ref:`links ` then IP traffic is allowed -between containers. They can ping each other, send/receive UDP -packets, and establish TCP connections, but that can be restricted if -necessary. From a network architecture point of view, all containers -on a given Docker host are sitting on bridge interfaces. This means -that they are just like physical machines connected through a common -Ethernet switch; no more, no less. - -How mature is the code providing kernel namespaces and private -networking? Kernel namespaces were introduced `between kernel version -2.6.15 and 2.6.26 -`_. This -means that since July 2008 (date of the 2.6.26 release, now 5 years -ago), namespace code has been exercised and scrutinized on a large -number of production systems. And there is more: the design and -inspiration for the namespaces code are even older. Namespaces are -actually an effort to reimplement the features of `OpenVZ -`_ in such a way that they could -be merged within the mainstream kernel. And OpenVZ was initially -released in 2005, so both the design and the implementation are -pretty mature. - -Control Groups --------------- - -Control Groups are the other key component of Linux Containers. They -implement resource accounting and limiting. They provide a lot of very -useful metrics, but they also help to ensure that each container gets -its fair share of memory, CPU, disk I/O; and, more importantly, that a -single container cannot bring the system down by exhausting one of -those resources. - -So while they do not play a role in preventing one container from -accessing or affecting the data and processes of another container, -they are essential to fend off some denial-of-service attacks. They -are particularly important on multi-tenant platforms, like public and -private PaaS, to guarantee a consistent uptime (and performance) even -when some applications start to misbehave. - -Control Groups have been around for a while as well: the code was -started in 2006, and initially merged in kernel 2.6.24. - -.. _dockersecurity_daemon: - -Docker Daemon Attack Surface ----------------------------- - -Running containers (and applications) with Docker implies running the -Docker daemon. This daemon currently requires root privileges, and you -should therefore be aware of some important details. - -First of all, **only trusted users should be allowed to control your -Docker daemon**. This is a direct consequence of some powerful Docker -features. Specifically, Docker allows you to share a directory between -the Docker host and a guest container; and it allows you to do so -without limiting the access rights of the container. This means that -you can start a container where the ``/host`` directory will be the -``/`` directory on your host; and the container will be able to alter -your host filesystem without any restriction. This sounds crazy? Well, -you have to know that **all virtualization systems allowing filesystem -resource sharing behave the same way**. Nothing prevents you from -sharing your root filesystem (or even your root block device) with a -virtual machine. - -This has a strong security implication: if you instrument Docker from -e.g. a web server to provision containers through an API, you should -be even more careful than usual with parameter checking, to make sure -that a malicious user cannot pass crafted parameters causing Docker to -create arbitrary containers. - -For this reason, the REST API endpoint (used by the Docker CLI to -communicate with the Docker daemon) changed in Docker 0.5.2, and now -uses a UNIX socket instead of a TCP socket bound on 127.0.0.1 (the -latter being prone to cross-site-scripting attacks if you happen to -run Docker directly on your local machine, outside of a VM). You can -then use traditional UNIX permission checks to limit access to the -control socket. - -You can also expose the REST API over HTTP if you explicitly decide -so. However, if you do that, being aware of the abovementioned -security implication, you should ensure that it will be reachable -only from a trusted network or VPN; or protected with e.g. ``stunnel`` -and client SSL certificates. - -Recent improvements in Linux namespaces will soon allow to run -full-featured containers without root privileges, thanks to the new -user namespace. This is covered in detail `here -`_. Moreover, -this will solve the problem caused by sharing filesystems between host -and guest, since the user namespace allows users within containers -(including the root user) to be mapped to other users in the host -system. - -The end goal for Docker is therefore to implement two additional -security improvements: - -* map the root user of a container to a non-root user of the Docker - host, to mitigate the effects of a container-to-host privilege - escalation; -* allow the Docker daemon to run without root privileges, and delegate - operations requiring those privileges to well-audited sub-processes, - each with its own (very limited) scope: virtual network setup, - filesystem management, etc. - -Finally, if you run Docker on a server, it is recommended to run -exclusively Docker in the server, and move all other services within -containers controlled by Docker. Of course, it is fine to keep your -favorite admin tools (probably at least an SSH server), as well as -existing monitoring/supervision processes (e.g. NRPE, collectd, etc). - -Linux Kernel Capabilities -------------------------- - -By default, Docker starts containers with a very restricted set of -capabilities. What does that mean? - -Capabilities turn the binary "root/non-root" dichotomy into a -fine-grained access control system. Processes (like web servers) that -just need to bind on a port below 1024 do not have to run as root: -they can just be granted the ``net_bind_service`` capability -instead. And there are many other capabilities, for almost all the -specific areas where root privileges are usually needed. - -This means a lot for container security; let’s see why! - -Your average server (bare metal or virtual machine) needs to run a -bunch of processes as root. Those typically include SSH, cron, -syslogd; hardware management tools (to e.g. load modules), network -configuration tools (to handle e.g. DHCP, WPA, or VPNs), and much -more. A container is very different, because almost all of those tasks -are handled by the infrastructure around the container: - -* SSH access will typically be managed by a single server running in - the Docker host; -* ``cron``, when necessary, should run as a user process, dedicated - and tailored for the app that needs its scheduling service, rather - than as a platform-wide facility; -* log management will also typically be handed to Docker, or by - third-party services like Loggly or Splunk; -* hardware management is irrelevant, meaning that you never need to - run ``udevd`` or equivalent daemons within containers; -* network management happens outside of the containers, enforcing - separation of concerns as much as possible, meaning that a container - should never need to perform ``ifconfig``, ``route``, or ip commands - (except when a container is specifically engineered to behave like a - router or firewall, of course). - -This means that in most cases, containers will not need "real" root -privileges *at all*. And therefore, containers can run with a reduced -capability set; meaning that "root" within a container has much less -privileges than the real "root". For instance, it is possible to: - -* deny all "mount" operations; -* deny access to raw sockets (to prevent packet spoofing); -* deny access to some filesystem operations, like creating new device - nodes, changing the owner of files, or altering attributes - (including the immutable flag); -* deny module loading; -* and many others. - -This means that even if an intruder manages to escalate to root within -a container, it will be much harder to do serious damage, or to -escalate to the host. - -This won't affect regular web apps; but malicious users will find that -the arsenal at their disposal has shrunk considerably! You can see -`the list of dropped capabilities in the Docker code -`_, -and a full list of available capabilities in `Linux manpages -`_. - -Of course, you can always enable extra capabilities if you really need -them (for instance, if you want to use a FUSE-based filesystem), but -by default, Docker containers will be locked down to ensure maximum -safety. - -Other Kernel Security Features ------------------------------- - -Capabilities are just one of the many security features provided by -modern Linux kernels. It is also possible to leverage existing, -well-known systems like TOMOYO, AppArmor, SELinux, GRSEC, etc. with -Docker. - -While Docker currently only enables capabilities, it doesn't interfere -with the other systems. This means that there are many different ways -to harden a Docker host. Here are a few examples. - -* You can run a kernel with GRSEC and PAX. This will add many safety - checks, both at compile-time and run-time; it will also defeat many - exploits, thanks to techniques like address randomization. It - doesn’t require Docker-specific configuration, since those security - features apply system-wide, independently of containers. -* If your distribution comes with security model templates for LXC - containers, you can use them out of the box. For instance, Ubuntu - comes with AppArmor templates for LXC, and those templates provide - an extra safety net (even though it overlaps greatly with - capabilities). -* You can define your own policies using your favorite access control - mechanism. Since Docker containers are standard LXC containers, - there is nothing “magic” or specific to Docker. - -Just like there are many third-party tools to augment Docker -containers with e.g. special network topologies or shared filesystems, -you can expect to see tools to harden existing Docker containers -without affecting Docker’s core. - -Conclusions ------------ - -Docker containers are, by default, quite secure; especially if you -take care of running your processes inside the containers as -non-privileged users (i.e. non root). - -You can add an extra layer of safety by enabling Apparmor, SELinux, -GRSEC, or your favorite hardening solution. - -Last but not least, if you see interesting security features in other -containerization systems, you will be able to implement them as well -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: http://blog.docker.io/2013/08/containers-docker-how-secure-are-they/ - diff --git a/docs/sources/conf.py b/docs/sources/conf.py deleted file mode 100644 index 12f5b57841..0000000000 --- a/docs/sources/conf.py +++ /dev/null @@ -1,266 +0,0 @@ -# -*- coding: utf-8 -*- -# -# Docker documentation build configuration file, created by -# sphinx-quickstart on Tue Mar 19 12:34:07 2013. -# -# This file is execfile()d with the current directory set to its containing dir. -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. - -import sys, os - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -#sys.path.insert(0, os.path.abspath('.')) - -# -- General configuration ----------------------------------------------------- - - - -# Additional templates that should be rendered to pages, maps page names to -# template names. -# the 'redirect_home.html' page redirects using a http meta refresh which, according -# to official sources is more or less equivalent of a 301. - -html_additional_pages = { - 'concepts/containers': 'redirect_home.html', - 'concepts/introduction': 'redirect_home.html', - 'builder/basics': 'redirect_build.html', - } - - - -# If your documentation needs a minimal Sphinx version, state it here. -#needs_sphinx = '1.0' - -# Add any Sphinx extension module names here, as strings. They can be extensions -# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = ['sphinxcontrib.httpdomain', 'sphinx.ext.extlinks'] - -# Configure extlinks -extlinks = { 'issue': ('https://github.com/dotcloud/docker/issues/%s', - 'Issue ') } - -# Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] - -# The suffix of source filenames. -source_suffix = '.rst' - -# The encoding of source files. -#source_encoding = 'utf-8-sig' - -html_add_permalinks = u'¶' - -# The master toctree document. -master_doc = 'toctree' - -# General information about the project. -project = u'Docker' -copyright = u'2014 Docker, Inc.' - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# -# The short X.Y version. -version = '0.1' -# The full version, including alpha/beta/rc tags. -release = '0' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -#language = None - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%B %d, %Y' - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -exclude_patterns = ['_build'] - -# The reST default role (used for this markup: `text`) to use for all documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - -# A list of ignored prefixes for module index sorting. -#modindex_common_prefix = [] - - -# -- Options for HTML output --------------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -html_theme = 'docker' - -# Theme options are theme-specific and customize the look and feel of a theme -# further. For a list of options available for each theme, see the -# documentation. -#html_theme_options = {} - -# Add any paths that contain custom themes here, relative to this directory. -#html_theme_path = [] -html_theme_path = ['../theme'] - -# The name for this set of Sphinx documents. If None, it defaults to -# " v documentation". -#html_title = None - -# A shorter title for the navigation bar. Default is the same as html_title. -#html_short_title = None - -# The name of an image file (relative to this directory) to place at the top -# of the sidebar. -#html_logo = None - -# The name of an image file (within the static path) to use as favicon of the -# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. - -# We use a png favicon. This is not compatible with internet explorer, but looks -# much better on all other browsers. However, sphynx doesn't like it (it likes -# .ico better) so we have just put it in the template rather than used this setting -# html_favicon = 'favicon.png' - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['static_files'] - -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -#html_last_updated_fmt = '%b %d, %Y' - -# If true, SmartyPants will be used to convert quotes and dashes to -# typographically correct entities. -#html_use_smartypants = True - -# Custom sidebar templates, maps document names to template names. -#html_sidebars = {} - -# If false, no module index is generated. -#html_domain_indices = True - -# If false, no index is generated. -#html_use_index = True - -# If true, the index is split into individual pages for each letter. -#html_split_index = False - -# If true, links to the reST sources are added to the pages. -html_show_sourcelink = False - -# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. -#html_show_sphinx = True - -# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. -html_show_copyright = True - -# If true, an OpenSearch description file will be output, and all pages will -# contain a tag referring to it. The value of this option must be the -# base URL from which the finished HTML is served. -#html_use_opensearch = '' - -# This is the file name suffix for HTML files (e.g. ".xhtml"). -#html_file_suffix = None - -# Output file base name for HTML help builder. -htmlhelp_basename = 'Dockerdoc' - - -# -- Options for LaTeX output -------------------------------------------------- - -latex_elements = { -# The paper size ('letterpaper' or 'a4paper'). -#'papersize': 'letterpaper', - -# The font size ('10pt', '11pt' or '12pt'). -#'pointsize': '10pt', - -# Additional stuff for the LaTeX preamble. -#'preamble': '', -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, author, documentclass [howto/manual]). -latex_documents = [ - ('toctree', 'Docker.tex', u'Docker Documentation', - u'Team Docker', 'manual'), -] - -# The name of an image file (relative to this directory) to place at the top of -# the title page. -#latex_logo = None - -# For "manual" documents, if this is true, then toplevel headings are parts, -# not chapters. -#latex_use_parts = False - -# If true, show page references after internal links. -#latex_show_pagerefs = False - -# If true, show URL addresses after external links. -#latex_show_urls = False - -# Documents to append as an appendix to all manuals. -#latex_appendices = [] - -# If false, no module index is generated. -#latex_domain_indices = True - - -# -- Options for manual page output -------------------------------------------- - -# One entry per manual page. List of tuples -# (source start file, name, description, authors, manual section). -man_pages = [ - ('reference/commandline/cli', 'docker', u'Docker CLI Documentation', - [u'Team Docker'], 1), - ('reference/builder', 'Dockerfile', u'Dockerfile Documentation', - [u'Team Docker'], 5), -] - -# If true, show URL addresses after external links. -#man_show_urls = False - - -# -- Options for Texinfo output ------------------------------------------------ - -# Grouping the document tree into Texinfo files. List of tuples -# (source start file, target name, title, author, -# dir menu entry, description, category) -texinfo_documents = [ - ('toctree', 'Docker', u'Docker Documentation', - u'Team Docker', 'Docker', 'One line description of project.', - 'Miscellaneous'), -] - -# Documents to append as an appendix to all manuals. -#texinfo_appendices = [] - -# If false, no module index is generated. -#texinfo_domain_indices = True - -# How to display URL addresses: 'footnote', 'no', or 'inline'. -#texinfo_show_urls = 'footnote' diff --git a/docs/sources/contributing/contributing.rst b/docs/sources/contributing/contributing.rst deleted file mode 100644 index 3b3b3f8f88..0000000000 --- a/docs/sources/contributing/contributing.rst +++ /dev/null @@ -1,25 +0,0 @@ -:title: Contribution Guidelines -:description: Contribution guidelines: create issues, conventions, pull requests -:keywords: contributing, docker, documentation, help, guideline - -Contributing to Docker -====================== - -Want to hack on Docker? Awesome! - -The repository includes `all the instructions you need to get -started `_. - -The `developer environment Dockerfile -`_ -specifies the tools and versions used to test and build Docker. - -If you're making changes to the documentation, see the -`README.md `_. - -The `documentation environment Dockerfile -`_ -specifies the tools and versions used to build the Documentation. - -Further interesting details can be found in the `Packaging hints -`_. diff --git a/docs/sources/contributing/devenvironment.rst b/docs/sources/contributing/devenvironment.rst deleted file mode 100644 index fbd47cbed7..0000000000 --- a/docs/sources/contributing/devenvironment.rst +++ /dev/null @@ -1,167 +0,0 @@ -:title: Setting Up a Dev Environment -:description: Guides on how to contribute to docker -:keywords: Docker, documentation, developers, contributing, dev environment - -Setting Up a Dev Environment -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To make it easier to contribute to Docker, we provide a standard -development environment. It is important that the same environment be -used for all tests, builds and releases. The standard development -environment defines all build dependencies: system libraries and -binaries, go environment, go dependencies, etc. - - -Step 1: Install Docker ----------------------- - -Docker's build environment itself is a Docker container, so the first -step is to install Docker on your system. - -You can follow the `install instructions most relevant to your system -`_. Make sure you have -a working, up-to-date docker installation, then continue to the next -step. - - -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 easy. - -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. - -Step 3: Check out the Source ----------------------------- - -.. code-block:: bash - - git clone http://git@github.com/dotcloud/docker - cd docker - -To checkout a different revision just use ``git checkout`` with the name of branch or revision number. - - -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 the build and runtime dependencies necessary to build and test Docker. This command will take some time to complete when you first execute it. - -.. code-block:: bash - - sudo make build - -If the build is successful, congratulations! You have produced a clean build of -docker, neatly encapsulated in a standard build environment. - - -Step 5: Build the Docker Binary -------------------------------- - -To create the Docker binary, run this command: - -.. code-block:: bash - - sudo make binary - -This will create the Docker binary in ``./bundles/-dev/binary/`` - -Using your built Docker binary -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The binary is available outside the container in the directory -``./bundles/-dev/binary/``. You can swap your host docker executable -with this binary for live testing - for example, on ubuntu: - -.. code-block:: bash - - sudo service docker stop ; sudo cp $(which docker) $(which docker)_ ; sudo cp ./bundles/-dev/binary/docker--dev $(which docker);sudo service docker start - -.. note:: Its safer to run the tests below before swapping your hosts docker binary. - - -Step 5: Run the Tests ---------------------- - -To execute the test cases, run this command: - -.. code-block:: bash - - sudo make test - -If the test are successful then the tail of the output should look something like this - -.. code-block:: bash - - --- PASS: TestWriteBroadcaster (0.00 seconds) - === RUN TestRaceWriteBroadcaster - --- PASS: TestRaceWriteBroadcaster (0.00 seconds) - === RUN TestTruncIndex - --- PASS: TestTruncIndex (0.00 seconds) - === RUN TestCompareKernelVersion - --- PASS: TestCompareKernelVersion (0.00 seconds) - === RUN TestHumanSize - --- PASS: TestHumanSize (0.00 seconds) - === RUN TestParseHost - --- PASS: TestParseHost (0.00 seconds) - === RUN TestParseRepositoryTag - --- PASS: TestParseRepositoryTag (0.00 seconds) - === RUN TestGetResolvConf - --- PASS: TestGetResolvConf (0.00 seconds) - === RUN TestCheckLocalDns - --- PASS: TestCheckLocalDns (0.00 seconds) - === RUN TestParseRelease - --- PASS: TestParseRelease (0.00 seconds) - === RUN TestDependencyGraphCircular - --- PASS: TestDependencyGraphCircular (0.00 seconds) - === RUN TestDependencyGraph - --- PASS: TestDependencyGraph (0.00 seconds) - PASS - ok github.com/dotcloud/docker/utils 0.017s - -If $TESTFLAGS is set in the environment, it is passed as extra arguments to 'go test'. -You can use this to select certain tests to run, eg. - - TESTFLAGS='-run ^TestBuild$' make test - -If the output indicates "FAIL" and you see errors like this: - -.. code-block:: text - - server.go:1302 Error: Insertion failed because database is full: database or disk is full - - utils_test.go:179: Error copy: exit status 1 (cp: writing '/tmp/docker-testd5c9-[...]': No space left on device - -Then you likely don't have enough memory available the test suite. 2GB is recommended. - -Step 6: Use Docker -------------------- - -You can run an interactive session in the newly built container: - -.. code-block:: bash - - sudo make shell - - # type 'exit' or Ctrl-D to exit - - -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 by: - -.. code-block:: bash - - sudo make docs - # when its done, you can point your browser to http://yourdockerhost:8000 - # type Ctrl-C to exit - - -**Need More Help?** - -If you need more help then hop on to the `#docker-dev IRC channel `_ or post a message on the `Docker developer mailing list `_. diff --git a/docs/sources/contributing/index.rst b/docs/sources/contributing/index.rst deleted file mode 100644 index 3669807a14..0000000000 --- a/docs/sources/contributing/index.rst +++ /dev/null @@ -1,14 +0,0 @@ -:title: Contributing to Docker -:description: Guides on how to contribute to docker -:keywords: Docker, documentation, developers, contributing, dev environment - - - -Contributing -============ - -.. toctree:: - :maxdepth: 1 - - contributing - devenvironment diff --git a/docs/sources/examples/apt-cacher-ng.rst b/docs/sources/examples/apt-cacher-ng.rst deleted file mode 100644 index dd844d4ef1..0000000000 --- a/docs/sources/examples/apt-cacher-ng.rst +++ /dev/null @@ -1,102 +0,0 @@ -:title: Running an apt-cacher-ng service -:description: Installing and running an apt-cacher-ng service -:keywords: docker, example, package installation, networking, debian, ubuntu - -.. _running_apt-cacher-ng_service: - -Apt-Cacher-ng Service -===================== - -.. include:: example_header.inc - - -When you have multiple Docker servers, or build unrelated Docker containers -which can't make use of the Docker build cache, it can be useful to have a -caching proxy for your packages. This container makes the second download of -any package almost instant. - -Use the following Dockerfile: - -.. literalinclude:: apt-cacher-ng.Dockerfile - -To build the image using: - -.. code-block:: bash - - $ sudo docker build -t eg_apt_cacher_ng . - -Then run it, mapping the exposed port to one on the host - -.. code-block:: bash - - $ sudo docker run -d -p 3142:3142 --name test_apt_cacher_ng eg_apt_cacher_ng - -To see the logfiles that are 'tailed' in the default command, you can use: - -.. code-block:: bash - - $ sudo docker logs -f test_apt_cacher_ng - -To get your Debian-based containers to use the proxy, you can do one of three things - -1. Add an apt Proxy setting ``echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/conf.d/01proxy`` -2. Set an environment variable: ``http_proxy=http://dockerhost:3142/`` -3. Change your ``sources.list`` entries to start with ``http://dockerhost:3142/`` - -**Option 1** injects the settings safely into your apt configuration in a local -version of a common base: - -.. code-block:: bash - - FROM ubuntu - RUN echo 'Acquire::http { Proxy "http://dockerhost:3142"; };' >> /etc/apt/apt.conf.d/01proxy - RUN apt-get update ; apt-get install vim git - - # docker build -t my_ubuntu . - -**Option 2** is good for testing, but will -break other HTTP clients which obey ``http_proxy``, such as ``curl``, ``wget`` and others: - -.. code-block:: bash - - $ sudo docker run --rm -t -i -e http_proxy=http://dockerhost:3142/ debian bash - -**Option 3** is the least portable, but there will be times when you might need to -do it and you can do it from your ``Dockerfile`` too. - -Apt-cacher-ng has some tools that allow you to manage the repository, and they -can be used by leveraging the ``VOLUME`` instruction, and the image we built to run the -service: - -.. code-block:: bash - - $ sudo docker run --rm -t -i --volumes-from test_apt_cacher_ng eg_apt_cacher_ng bash - - $$ /usr/lib/apt-cacher-ng/distkill.pl - Scanning /var/cache/apt-cacher-ng, please wait... - Found distributions: - bla, taggedcount: 0 - 1. precise-security (36 index files) - 2. wheezy (25 index files) - 3. precise-updates (36 index files) - 4. precise (36 index files) - 5. wheezy-updates (18 index files) - - Found architectures: - 6. amd64 (36 index files) - 7. i386 (24 index files) - - WARNING: The removal action may wipe out whole directories containing - index files. Select d to see detailed list. - - (Number nn: tag distribution or architecture nn; 0: exit; d: show details; r: remove tagged; q: quit): q - - -Finally, clean up after your test by stopping and removing the container, and -then removing the image. - -.. code-block:: bash - - $ sudo docker stop test_apt_cacher_ng - $ sudo docker rm test_apt_cacher_ng - $ sudo docker rmi eg_apt_cacher_ng diff --git a/docs/sources/examples/cfengine_process_management.rst b/docs/sources/examples/cfengine_process_management.rst deleted file mode 100644 index 7ca2c35498..0000000000 --- a/docs/sources/examples/cfengine_process_management.rst +++ /dev/null @@ -1,137 +0,0 @@ -:title: Process Management with CFEngine -:description: Managing containerized processes with CFEngine -:keywords: cfengine, process, management, usage, docker, documentation - -Process Management with CFEngine -================================ - -Create Docker containers with managed processes. - -Docker monitors one process in each running container and the container lives or dies with that process. -By introducing CFEngine inside Docker containers, we can alleviate a few of the issues that may arise: - -* It is possible to easily start multiple processes within a container, all of which will be managed automatically, with the normal ``docker run`` command. -* If a managed process dies or crashes, CFEngine will start it again within 1 minute. -* The container itself will live as long as the CFEngine scheduling daemon (cf-execd) lives. With CFEngine, we are able to decouple the life of the container from the uptime of the service it provides. - - -How it works ------------- - -CFEngine, together with the cfe-docker integration policies, are installed as part of the Dockerfile. This builds CFEngine into our Docker image. - -The Dockerfile's ``ENTRYPOINT`` takes an arbitrary amount of commands (with any desired arguments) as parameters. -When we run the Docker container these parameters get written to CFEngine policies and CFEngine takes over to ensure that the desired processes are running in the container. - -CFEngine scans the process table for the ``basename`` of the commands given to the ``ENTRYPOINT`` and runs the command to start the process if the ``basename`` is not found. -For example, if we start the container with ``docker run "/path/to/my/application parameters"``, CFEngine will look for a process named ``application`` and run the command. -If an entry for ``application`` is not found in the process table at any point in time, CFEngine will execute ``/path/to/my/application parameters`` to start the application once again. -The check on the process table happens every minute. - -Note that it is therefore important that the command to start your application leaves a process with the basename of the command. -This can be made more flexible by making some minor adjustments to the CFEngine policies, if desired. - - -Usage ------ - -This example assumes you have Docker installed and working. -We will install and manage ``apache2`` and ``sshd`` in a single container. - -There are three steps: - -1. Install CFEngine into the container. -2. Copy the CFEngine Docker process management policy into the containerized CFEngine installation. -3. Start your application processes as part of the ``docker run`` command. - - -Building the container image -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The first two steps can be done as part of a Dockerfile, as follows. - -.. code-block:: bash - - FROM ubuntu - MAINTAINER Eystein Måløy Stenberg - - RUN apt-get -y install wget lsb-release unzip ca-certificates - - # install latest CFEngine - RUN wget -qO- http://cfengine.com/pub/gpg.key | apt-key add - - RUN echo "deb http://cfengine.com/pub/apt $(lsb_release -cs) main" > /etc/apt/sources.list.d/cfengine-community.list - RUN apt-get update - RUN apt-get install cfengine-community - - # install cfe-docker process management policy - RUN wget https://github.com/estenberg/cfe-docker/archive/master.zip -P /tmp/ && unzip /tmp/master.zip -d /tmp/ - RUN cp /tmp/cfe-docker-master/cfengine/bin/* /var/cfengine/bin/ - RUN cp /tmp/cfe-docker-master/cfengine/inputs/* /var/cfengine/inputs/ - RUN rm -rf /tmp/cfe-docker-master /tmp/master.zip - - # apache2 and openssh are just for testing purposes, install your own apps here - RUN apt-get -y install openssh-server apache2 - RUN mkdir -p /var/run/sshd - RUN echo "root:password" | chpasswd # need a password for ssh - - ENTRYPOINT ["/var/cfengine/bin/docker_processes_run.sh"] - - -By saving this file as ``Dockerfile`` to a working directory, you can then build your container with the docker build command, -e.g. ``docker build -t managed_image``. - -Testing the container -~~~~~~~~~~~~~~~~~~~~~ - -Start the container with ``apache2`` and ``sshd`` running and managed, forwarding a port to our SSH instance: - -.. code-block:: bash - - docker run -p 127.0.0.1:222:22 -d managed_image "/usr/sbin/sshd" "/etc/init.d/apache2 start" - -We now clearly see one of the benefits of the cfe-docker integration: it allows to start several processes -as part of a normal ``docker run`` command. - -We can now log in to our new container and see that both ``apache2`` and ``sshd`` are running. We have set the root password to -"password" in the Dockerfile above and can use that to log in with ssh: - -.. code-block:: bash - - ssh -p222 root@127.0.0.1 - - ps -ef - UID PID PPID C STIME TTY TIME CMD - root 1 0 0 07:48 ? 00:00:00 /bin/bash /var/cfengine/bin/docker_processes_run.sh /usr/sbin/sshd /etc/init.d/apache2 start - root 18 1 0 07:48 ? 00:00:00 /var/cfengine/bin/cf-execd -F - root 20 1 0 07:48 ? 00:00:00 /usr/sbin/sshd - root 32 1 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start - www-data 34 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start - www-data 35 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start - www-data 36 32 0 07:48 ? 00:00:00 /usr/sbin/apache2 -k start - root 93 20 0 07:48 ? 00:00:00 sshd: root@pts/0 - root 105 93 0 07:48 pts/0 00:00:00 -bash - root 112 105 0 07:49 pts/0 00:00:00 ps -ef - - -If we stop apache2, it will be started again within a minute by CFEngine. - -.. code-block:: bash - - service apache2 status - Apache2 is running (pid 32). - service apache2 stop - * Stopping web server apache2 ... waiting [ OK ] - service apache2 status - Apache2 is NOT running. - # ... wait up to 1 minute... - service apache2 status - Apache2 is running (pid 173). - - -Adapting to your applications ------------------------------ - -To make sure your applications get managed in the same manner, there are just two things you need to adjust from the above example: - -* In the Dockerfile used above, install your applications instead of ``apache2`` and ``sshd``. -* When you start the container with ``docker run``, specify the command line arguments to your applications rather than ``apache2`` and ``sshd``. diff --git a/docs/sources/examples/couchdb_data_volumes.rst b/docs/sources/examples/couchdb_data_volumes.rst deleted file mode 100644 index 6cf3fab68c..0000000000 --- a/docs/sources/examples/couchdb_data_volumes.rst +++ /dev/null @@ -1,56 +0,0 @@ -:title: Sharing data between 2 couchdb databases -:description: Sharing data between 2 couchdb databases -:keywords: docker, example, package installation, networking, couchdb, data volumes - -.. _running_couchdb_service: - -CouchDB Service -=============== - -.. include:: example_header.inc - -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 -different versions of CouchDB on the same data, etc. - -Create first database ---------------------- - -Note that we're marking ``/var/lib/couchdb`` as a data volume. - -.. code-block:: bash - - COUCH1=$(sudo docker run -d -p 5984 -v /var/lib/couchdb shykes/couchdb:2013-05-03) - -Add data to the first database ------------------------------- - -We're assuming your Docker host is reachable at ``localhost``. If not, -replace ``localhost`` with the public IP of your Docker host. - -.. code-block:: bash - - HOST=localhost - URL="http://$HOST:$(sudo docker port $COUCH1 5984 | grep -Po '\d+$')/_utils/" - echo "Navigate to $URL in your browser, and use the couch interface to add data" - -Create second database ----------------------- - -This time, we're requesting shared access to ``$COUCH1``'s volumes. - -.. code-block:: bash - - COUCH2=$(sudo docker run -d -p 5984 --volumes-from $COUCH1 shykes/couchdb:2013-05-03) - -Browse data on the second database ----------------------------------- - -.. code-block:: bash - - HOST=localhost - URL="http://$HOST:$(sudo docker port $COUCH2 5984 | grep -Po '\d+$')/_utils/" - echo "Navigate to $URL in your browser. You should see the same data as in the first database"'!' - -Congratulations, you are now running two Couchdb containers, completely -isolated from each other *except* for their data. diff --git a/docs/sources/examples/hello_world.rst b/docs/sources/examples/hello_world.rst deleted file mode 100644 index 39d7abea2c..0000000000 --- a/docs/sources/examples/hello_world.rst +++ /dev/null @@ -1,181 +0,0 @@ -:title: Hello world example -:description: A simple hello world example with Docker -:keywords: docker, example, hello world - -.. _running_examples: - -Check your Docker install -------------------------- - -This guide assumes you have a working installation of Docker. To check -your Docker install, run the following command: - -.. code-block:: bash - - # Check that you have a working install - $ sudo docker info - -If you get ``docker: command not found`` or something like -``/var/lib/docker/repositories: permission denied`` you may have an incomplete -Docker installation or insufficient privileges to access docker on your machine. - -Please refer to :ref:`installation_list` for installation instructions. - - -.. _hello_world: - -Hello World ------------ - -.. include:: example_header.inc - -This is the most basic example available for using Docker. - -Download the small base image named ``busybox``: - -.. code-block:: bash - - # Download a busybox image - $ sudo docker pull busybox - -The ``busybox`` image is a minimal Linux system. You can do the same -with any number of other images, such as ``debian``, ``ubuntu`` or ``centos``. -The images can be found and retrieved using the `Docker index`_. - -.. _Docker index: http://index.docker.io - -.. code-block:: bash - - $ sudo docker run busybox /bin/echo hello world - -This command will run a simple ``echo`` command, that will echo ``hello world`` back to the console over standard out. - -**Explanation:** - -- **"sudo"** execute the following commands as user *root* -- **"docker run"** run a command in a new container -- **"busybox"** is the image we are running the command in. -- **"/bin/echo"** is the command we want to run in the container -- **"hello world"** is the input for the echo command - - - -**Video:** - -See the example in action - -.. raw:: html - - - ----- - -.. _hello_world_daemon: - -Hello World Daemon ------------------- - -.. include:: example_header.inc - -And now for the most boring daemon ever written! - -We will use the Ubuntu image to run a simple hello world daemon that will just print hello -world to standard out every second. It will continue to do this until -we stop it. - -**Steps:** - -.. code-block:: bash - - 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. - -- **"sudo docker run -d "** run a command in a new container. We pass "-d" - so it runs as a daemon. -- **"ubuntu"** is the image we want to run the command inside of. -- **"/bin/sh -c"** is the command we want to run in the container -- **"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, we can use in future commands to see what is going on - with this process. - -.. code-block:: bash - - 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. - -.. code-block:: bash - - 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; allows - us to exit the attachment using Control-C without stopping the container. -- **$container_id** The Id of the container we want to attach to. - -Exit from the container attachment by pressing Control-C. - -.. code-block:: bash - - sudo docker ps - -Check the process list to make sure it is running. - -- **"docker ps"** this shows all running process managed by docker - -.. code-block:: bash - - 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. - -.. code-block:: bash - - sudo docker ps - -Make sure it is really stopped. - - -**Video:** - -See the example in action - -.. raw:: html - - - -The next example in the series is a :ref:`nodejs_web_app` example, or -you could skip to any of the other examples: - - -* :ref:`nodejs_web_app` -* :ref:`running_redis_service` -* :ref:`running_ssh_service` -* :ref:`running_couchdb_service` -* :ref:`postgresql_service` -* :ref:`mongodb_image` -* :ref:`python_web_app` diff --git a/docs/sources/examples/https.rst b/docs/sources/examples/https.rst deleted file mode 100644 index 7a221ed951..0000000000 --- a/docs/sources/examples/https.rst +++ /dev/null @@ -1,126 +0,0 @@ -:title: Docker HTTPS Setup -:description: How to setup docker with https -:keywords: docker, example, https, daemon - -.. _running_docker_https: - -Running Docker with https -========================= - -By default, Docker runs via a non-networked Unix socket. It can also optionally -communicate using a HTTP socket. - -If you need Docker reachable via the network in a safe manner, you can enable -TLS by specifying the `tlsverify` flag and pointing Docker's `tlscacert` flag to a -trusted CA certificate. - -In daemon mode, it will only allow connections from clients authenticated by a -certificate signed by that CA. In client mode, it will only connect to servers -with a certificate signed by that CA. - -.. warning:: - - Using TLS and managing a CA is an advanced topic. Please make you self familiar - with openssl, x509 and tls before using it in production. - -Create a CA, server and client keys with OpenSSL ------------------------------------------------- - -First, initialize the CA serial file and generate CA private and public keys: - -.. code-block:: bash - - $ echo 01 > ca.srl - $ openssl genrsa -des3 -out ca-key.pem - $ openssl req -new -x509 -days 365 -key ca-key.pem -out ca.pem - -Now that we have a CA, you can create a server key and certificate signing request. -Make sure that `"Common Name (e.g. server FQDN or YOUR name)"` matches the hostname you will use -to connect to Docker or just use '*' for a certificate valid for any hostname: - -.. code-block:: bash - - $ openssl genrsa -des3 -out server-key.pem - $ openssl req -new -key server-key.pem -out server.csr - -Next we're going to sign the key with our CA: - -.. code-block:: bash - - $ openssl x509 -req -days 365 -in server.csr -CA ca.pem -CAkey ca-key.pem \ - -out server-cert.pem - -For client authentication, create a client key and certificate signing request: - -.. code-block:: bash - - $ openssl genrsa -des3 -out client-key.pem - $ openssl req -new -key client-key.pem -out client.csr - - -To make the key suitable for client authentication, create a extensions config file: - -.. code-block:: bash - - $ echo extendedKeyUsage = clientAuth > extfile.cnf - -Now sign the key: - -.. code-block:: bash - - $ openssl x509 -req -days 365 -in client.csr -CA ca.pem -CAkey ca-key.pem \ - -out client-cert.pem -extfile extfile.cnf - -Finally you need to remove the passphrase from the client and server key: - -.. code-block:: bash - - $ openssl rsa -in server-key.pem -out server-key.pem - $ openssl rsa -in client-key.pem -out client-key.pem - -Now you can make the Docker daemon only accept connections from clients providing -a certificate trusted by our CA: - -.. code-block:: bash - - $ sudo docker -d --tlsverify --tlscacert=ca.pem --tlscert=server-cert.pem --tlskey=server-key.pem \ - -H=0.0.0.0:4243 - -To be able to connect to Docker and validate its certificate, you now need to provide your client keys, -certificates and trusted CA: - -.. code-block:: bash - - $ docker --tlsverify --tlscacert=ca.pem --tlscert=client-cert.pem --tlskey=client-key.pem \ - -H=dns-name-of-docker-host:4243 - -.. warning:: - - As shown in the example above, you don't have to run the ``docker`` - client with ``sudo`` or the ``docker`` group when you use - certificate authentication. That means anyone with the keys can - give any instructions to your Docker daemon, giving them root - access to the machine hosting the daemon. Guard these keys as you - would a root password! - -Other modes ------------ -If you don't want to have complete two-way authentication, you can run Docker in -various other modes by mixing the flags. - -Daemon modes -~~~~~~~~~~~~ -- tlsverify, tlscacert, tlscert, tlskey set: Authenticate clients -- tls, tlscert, tlskey: Do not authenticate clients - -Client modes -~~~~~~~~~~~~ -- tls: Authenticate server based on public/default CA pool -- tlsverify, tlscacert: Authenticate server based on given CA -- tls, tlscert, tlskey: Authenticate with client certificate, do not authenticate - server based on given CA -- tlsverify, tlscacert, tlscert, tlskey: Authenticate with client certificate, - authenticate server based on given CA - -The client will send its client certificate if found, so you just need to drop -your keys into `~/.docker/.pem` diff --git a/docs/sources/examples/index.rst b/docs/sources/examples/index.rst deleted file mode 100644 index 94e2d917bb..0000000000 --- a/docs/sources/examples/index.rst +++ /dev/null @@ -1,30 +0,0 @@ -:title: Docker Examples -:description: Examples on how to use Docker -:keywords: docker, hello world, node, nodejs, python, couch, couchdb, redis, ssh, sshd, examples, postgresql, link - - -.. _example_list: - -Examples -======== - -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. - -.. toctree:: - :maxdepth: 1 - - hello_world - nodejs_web_app - running_redis_service - running_ssh_service - couchdb_data_volumes - postgresql_service - mongodb - running_riak_service - using_supervisord - cfengine_process_management - python_web_app - apt-cacher-ng - https diff --git a/docs/sources/examples/mongodb.rst b/docs/sources/examples/mongodb.rst deleted file mode 100644 index 913dc2699a..0000000000 --- a/docs/sources/examples/mongodb.rst +++ /dev/null @@ -1,100 +0,0 @@ -:title: Building a Docker Image with MongoDB -:description: How to build a Docker image with MongoDB pre-installed -:keywords: docker, example, package installation, networking, mongodb - -.. _mongodb_image: - -Building an Image with MongoDB -============================== - -.. include:: example_header.inc - -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 ``Dockerfile`` that downloads a base image, adds an -apt source and installs the database software on Ubuntu. - -Creating a ``Dockerfile`` -+++++++++++++++++++++++++ - -Create an empty file called ``Dockerfile``: - -.. code-block:: bash - - touch Dockerfile - -Next, define the parent image you want to use to build your own image on top of. -Here, we’ll use `Ubuntu `_ (tag: ``latest``) -available on the `docker index `_: - -.. code-block:: bash - - FROM ubuntu:latest - -Since we want to be running the latest version of MongoDB we'll need to add the -10gen repo to our apt sources list. - -.. code-block:: bash - - # Add 10gen official apt source to the sources list - RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10 - RUN echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | tee /etc/apt/sources.list.d/10gen.list - -Then, we don't want Ubuntu to complain about init not being available so we'll -divert ``/sbin/initctl`` to ``/bin/true`` so it thinks everything is working. - -.. code-block:: bash - - # Hack for initctl not being available in Ubuntu - RUN dpkg-divert --local --rename --add /sbin/initctl - RUN ln -sf /bin/true /sbin/initctl - -Afterwards we'll be able to update our apt repositories and install MongoDB - -.. code-block:: bash - - # Install MongoDB - RUN apt-get update - RUN apt-get install mongodb-10gen - -To run MongoDB we'll have to create the default data directory (because we want it to -run without needing to provide a special configuration file) - -.. code-block:: bash - - # Create the MongoDB data directory - RUN mkdir -p /data/db - -Finally, we'll expose the standard port that MongoDB runs on, 27107, as well as -define an ``ENTRYPOINT`` instruction for the container. - -.. code-block:: bash - - EXPOSE 27017 - ENTRYPOINT ["usr/bin/mongod"] - -Now, lets build the image which will go through the ``Dockerfile`` we made and -run all of the commands. - -.. code-block:: bash - - sudo docker build -t /mongodb . - -Now you should be able to run ``mongod`` as a daemon and be able to connect on -the local port! - -.. code-block:: bash - - # Regular style - MONGO_ID=$(sudo docker run -P -d /mongodb) - - # Lean and mean - MONGO_ID=$(sudo docker run -P -d /mongodb --noprealloc --smallfiles) - - # Check the logs out - sudo docker logs $MONGO_ID - - # Connect and play around - mongo --port - -Sweet! diff --git a/docs/sources/examples/nodejs_web_app.rst b/docs/sources/examples/nodejs_web_app.rst deleted file mode 100644 index 55bd76db89..0000000000 --- a/docs/sources/examples/nodejs_web_app.rst +++ /dev/null @@ -1,239 +0,0 @@ -:title: Running a Node.js app on CentOS -:description: Installing and running a Node.js app on CentOS -:keywords: docker, example, package installation, node, centos - -.. _nodejs_web_app: - -Node.js Web App -=============== - -.. include:: example_header.inc - -The goal of this example is to show you how you can build your own -Docker images from a parent image using a ``Dockerfile`` . We will do -that by making a simple Node.js hello world web application running on -CentOS. You can get the full source code at -https://github.com/gasi/docker-node-hello. - -Create Node.js app -++++++++++++++++++ - -First, create a directory ``src`` where all the files would live. Then create a ``package.json`` file that describes your app and its -dependencies: - -.. code-block:: json - - { - "name": "docker-centos-hello", - "private": true, - "version": "0.0.1", - "description": "Node.js Hello World app on CentOS using docker", - "author": "Daniel Gasienica ", - "dependencies": { - "express": "3.2.4" - } - } - -Then, create an ``index.js`` file that defines a web app using the -`Express.js `_ framework: - -.. code-block:: javascript - - var express = require('express'); - - // Constants - var PORT = 8080; - - // App - var app = express(); - app.get('/', function (req, res) { - res.send('Hello World\n'); - }); - - app.listen(PORT); - console.log('Running on http://localhost:' + PORT); - - -In the next steps, we’ll look at how you can run this app inside a CentOS -container using Docker. First, you’ll need to build a Docker image of your app. - -Creating a ``Dockerfile`` -+++++++++++++++++++++++++ - -Create an empty file called ``Dockerfile``: - -.. code-block:: bash - - touch Dockerfile - -Open the ``Dockerfile`` in your favorite text editor and add the following line -that defines the version of Docker the image requires to build -(this example uses Docker 0.3.4): - -.. code-block:: bash - - # DOCKER-VERSION 0.3.4 - -Next, define the parent image you want to use to build your own image on top of. -Here, we’ll use `CentOS `_ (tag: ``6.4``) -available on the `Docker index`_: - -.. code-block:: bash - - FROM centos:6.4 - -Since we’re building a Node.js app, you’ll have to install Node.js as well as -npm on your CentOS image. Node.js is required to run your app and npm to install -your app’s dependencies defined in ``package.json``. -To install the right package for CentOS, we’ll use the instructions from the -`Node.js wiki`_: - -.. code-block:: bash - - # Enable EPEL for Node.js - 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 - -To bundle your app’s source code inside the Docker image, use the ``ADD`` -instruction: - -.. code-block:: bash - - # Bundle app source - ADD . /src - -Install your app dependencies using the ``npm`` binary: - -.. code-block:: bash - - # Install app dependencies - RUN cd /src; npm install - -Your app binds to port ``8080`` so you’ll use the ``EXPOSE`` instruction -to have it mapped by the ``docker`` daemon: - -.. code-block:: bash - - EXPOSE 8080 - -Last but not least, define the command to run your app using ``CMD`` -which defines your runtime, i.e. ``node``, and the path to our app, -i.e. ``src/index.js`` (see the step where we added the source to the -container): - -.. code-block:: bash - - CMD ["node", "/src/index.js"] - -Your ``Dockerfile`` should now look like this: - -.. code-block:: bash - - - # DOCKER-VERSION 0.3.4 - FROM centos:6.4 - - # Enable EPEL for Node.js - RUN rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm - # Install Node.js and npm - RUN yum install -y npm - - # Bundle app source - ADD . /src - # Install app dependencies - RUN cd /src; npm install - - EXPOSE 8080 - CMD ["node", "/src/index.js"] - - -Building your image -+++++++++++++++++++ - -Go to the directory that has your ``Dockerfile`` and run the following -command to build a Docker image. The ``-t`` flag let’s you tag your -image so it’s easier to find later using the ``docker images`` -command: - -.. code-block:: bash - - sudo docker build -t /centos-node-hello . - -Your image will now be listed by Docker: - -.. code-block:: bash - - sudo docker images - - > # Example - > REPOSITORY TAG ID CREATED - > centos 6.4 539c0211cd76 8 weeks ago - > gasi/centos-node-hello latest d64d3505b0d2 2 hours ago - - -Run the image -+++++++++++++ - -Running your image with ``-d`` runs the container in detached mode, leaving the -container running in the background. The ``-p`` flag redirects a public port to a private port in the container. Run the image you previously built: - -.. code-block:: bash - - sudo docker run -p 49160:8080 -d /centos-node-hello - -Print the output of your app: - -.. code-block:: bash - - # Get container ID - sudo docker ps - - # Print app output - sudo docker logs - - > # Example - > Running on http://localhost:8080 - - -Test -++++ - -To test your app, get the the port of your app that Docker mapped: - -.. code-block:: bash - - sudo docker ps - - > # Example - > ID IMAGE COMMAND ... PORTS - > ecce33b30ebf gasi/centos-node-hello:latest node /src/index.js 49160->8080 - -In the example above, Docker mapped the ``8080`` port of the container to -``49160``. - -Now you can call your app using ``curl`` (install if needed via: -``sudo apt-get install curl``): - -.. code-block:: bash - - curl -i localhost:49160 - - > HTTP/1.1 200 OK - > X-Powered-By: Express - > Content-Type: text/html; charset=utf-8 - > Content-Length: 12 - > Date: Sun, 02 Jun 2013 03:53:22 GMT - > Connection: keep-alive - > - > Hello World - -We hope this tutorial helped you get up and running with Node.js and -CentOS on Docker. You can get the full source code at -https://github.com/gasi/docker-node-hello. - -Continue to :ref:`running_redis_service`. - - -.. _Node.js wiki: https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager#rhelcentosscientific-linux-6 -.. _docker index: https://index.docker.io/ diff --git a/docs/sources/examples/postgresql_service.rst b/docs/sources/examples/postgresql_service.rst deleted file mode 100644 index 488e1530b2..0000000000 --- a/docs/sources/examples/postgresql_service.rst +++ /dev/null @@ -1,117 +0,0 @@ -:title: PostgreSQL service How-To -:description: Running and installing a PostgreSQL service -:keywords: docker, example, package installation, postgresql - -.. _postgresql_service: - -PostgreSQL Service -================== - -.. include:: example_header.inc - -Installing PostgreSQL on Docker -------------------------------- - -Assuming there is no Docker image that suits your needs in `the index`_, you -can create one yourself. - -.. _the index: http://index.docker.io - -Start by creating a new Dockerfile: - -.. note:: - - This PostgreSQL setup is for development only purposes. Refer - to the PostgreSQL documentation to fine-tune these settings so that it - is suitably secure. - -.. literalinclude:: postgresql_service.Dockerfile - -Build an image from the Dockerfile assign it a name. - -.. code-block:: bash - - $ sudo docker build -t eg_postgresql . - -And run the PostgreSQL server container (in the foreground): - -.. code-block:: bash - - $ sudo docker run --rm -P --name pg_test eg_postgresql - -There are 2 ways to connect to the PostgreSQL server. We can use -:ref:`working_with_links_names`, or we can access it from our host (or the network). - -.. note:: 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 ``docker run``. This will -set a number of environment variables that can then be used to connect: - -.. code-block:: 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 - -Connecting from your host system -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Assuming you have the postgresql-client installed, you can use the host-mapped port -to test as well. You need to use ``docker ps`` to find out what local host port the -container is mapped to first: - -.. code-block:: bash - - $ docker ps - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 5e24362f27f6 eg_postgresql:latest /usr/lib/postgresql/ About an hour ago Up About an hour 0.0.0.0:49153->5432/tcp pg_test - $ psql -h localhost -p 49153 -d docker -U docker --password - -Testing the database -^^^^^^^^^^^^^^^^^^^^ - -Once you have authenticated and have a ``docker =#`` prompt, you can -create a table and populate it. - -.. code-block:: bash - - psql (9.3.1) - Type "help" for help. - - docker=# CREATE TABLE cities ( - docker(# name varchar(80), - docker(# location point - docker(# ); - CREATE TABLE - docker=# INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); - INSERT 0 1 - docker=# select * from cities; - name | location - ---------------+----------- - San Francisco | (-194,53) - (1 row) - -Using the container volumes -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -You can use the defined volumes to inspect the PostgreSQL log files and to backup your -configuration and data: - -.. code-block:: bash - - docker run --rm --volumes-from pg_test -t -i busybox sh - - / # ls - bin etc lib linuxrc mnt proc run sys usr - dev home lib64 media opt root sbin tmp var - / # ls /etc/postgresql/9.3/main/ - environment pg_hba.conf postgresql.conf - pg_ctl.conf pg_ident.conf start.conf - /tmp # ls /var/log - ldconfig postgresql - diff --git a/docs/sources/examples/python_web_app.rst b/docs/sources/examples/python_web_app.rst deleted file mode 100644 index 33c038f9ab..0000000000 --- a/docs/sources/examples/python_web_app.rst +++ /dev/null @@ -1,145 +0,0 @@ -:title: Python Web app example -:description: Building your own python web app using docker -:keywords: docker, example, python, web app - -.. _python_web_app: - -Python Web App -============== - -.. include:: example_header.inc - -While using Dockerfiles is the preferred way to create maintainable -and repeatable images, its useful to know how you can try things out -and then commit your live changes to an image. - -The goal of this example is to show you how you can modify your own -Docker images by making changes to a running -container, and then saving the results as a new image. We will do -that by making a simple 'hello world' Flask web application image. - -Download the initial image --------------------------- - -Download the ``shykes/pybuilder`` Docker image from the ``http://index.docker.io`` -registry. - -This image contains a ``buildapp`` script to download the web app and then ``pip install`` -any required modules, and a ``runapp`` script that finds the ``app.py`` and runs it. - -.. _`shykes/pybuilder`: https://github.com/shykes/pybuilder - -.. code-block:: bash - - $ sudo docker pull shykes/pybuilder - -.. note:: This container was built with a very old version of docker - (May 2013 - see `shykes/pybuilder`_ ), when the ``Dockerfile`` format was different, - but the image can still be used now. - -Interactively make some modifications -------------------------------------- - -We then start a new container running interactively using the image. -First, we set a ``URL`` variable that points to a tarball of a simple -helloflask web app, and then we run a command contained in the image called -``buildapp``, passing it the ``$URL`` variable. The container is -given a name ``pybuilder_run`` which we will use in the next steps. - -While this example is simple, you could run any number of interactive commands, -try things out, and then exit when you're done. - -.. code-block:: 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 - [...] - $$ exit - -Commit the container to create a new image ------------------------------------------- - -Save the changes we just made in the container to a new image called -``/builds/github.com/shykes/helloflask/master``. You now have 3 different -ways to refer to the container: name ``pybuilder_run``, short-id ``c8b2e8228f11``, or -long-id ``c8b2e8228f11b8b3e492cbf9a49923ae66496230056d61e07880dc74c5f495f9``. - -.. code-block:: bash - - $ sudo docker commit pybuilder_run /builds/github.com/shykes/helloflask/master - c8b2e8228f11b8b3e492cbf9a49923ae66496230056d61e07880dc74c5f495f9 - - -Run the new image to start the web worker ------------------------------------------ - -Use the new image to create a new container with -network port 5000 mapped to a local port - -.. code-block:: bash - - $ sudo docker run -d -p 5000 --name web_worker /builds/github.com/shykes/helloflask/master /usr/local/bin/runapp - - -- **"docker run -d "** run a command in a new container. We pass "-d" - so it runs as a daemon. -- **"-p 5000"** the web app is going to listen on this port, so it - must be mapped from the container to the host system. -- **/usr/local/bin/runapp** is the command which starts the web app. - - -View the container logs ------------------------ - -View the logs for the new ``web_worker`` container and -if everything worked as planned you should see the line ``Running on -http://0.0.0.0:5000/`` in the log output. - -To exit the view without stopping the container, hit Ctrl-C, or open another -terminal and continue with the example while watching the result in the logs. - -.. code-block:: bash - - $ sudo docker logs -f web_worker - * Running on http://0.0.0.0:5000/ - - -See the webapp output ---------------------- - -Look up the public-facing port which is NAT-ed. Find the private port -used by the container and store it inside of the ``WEB_PORT`` variable. - -Access the web app using the ``curl`` binary. If everything worked as planned you -should see the line ``Hello world!`` inside of your console. - -.. code-block:: bash - - $ WEB_PORT=$(sudo docker port web_worker 5000 | awk -F: '{ print $2 }') - - # install curl if necessary, then ... - $ curl http://127.0.0.1:$WEB_PORT - Hello world! - - -Clean up example containers and images --------------------------------------- - -.. code-block:: bash - - $ sudo docker ps --all - -List ``--all`` the Docker containers. If this container had already finished -running, it will still be listed here with a status of 'Exit 0'. - -.. code-block:: bash - - $ sudo docker stop web_worker - $ sudo docker rm web_worker pybuilder_run - $ sudo docker rmi /builds/github.com/shykes/helloflask/master shykes/pybuilder:latest - -And now stop the running web worker, and delete the containers, so that we can -then delete the images that we used. - diff --git a/docs/sources/examples/running_redis_service.rst b/docs/sources/examples/running_redis_service.rst deleted file mode 100644 index 5a5a1b003f..0000000000 --- a/docs/sources/examples/running_redis_service.rst +++ /dev/null @@ -1,101 +0,0 @@ -:title: Running a Redis service -:description: Installing and running an redis service -:keywords: docker, example, package installation, networking, redis - -.. _running_redis_service: - -Redis Service -============= - -.. include:: example_header.inc - -Very simple, no frills, Redis service attached to a web application using a link. - -Create a docker container for Redis ------------------------------------ - -Firstly, we create a ``Dockerfile`` for our new Redis image. - -.. code-block:: bash - - 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. - -.. code-block:: bash - - sudo docker build -t /redis . - -Run the service ---------------- - -Use the image we've just created and name your container ``redis``. - -Running the service with ``-d`` runs the container in detached mode, leaving the -container running in the background. - -Importantly, we're not exposing any ports on our container. Instead we're going to -use a container link to provide access to our Redis database. - -.. code-block:: bash - - sudo docker run --name redis -d /redis - -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 ``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 running inside that container to only this container. - -.. code-block:: bash - - sudo docker run --link redis:db -i -t ubuntu:12.10 /bin/bash - -Once inside our freshly created container we need to install Redis to get the -``redis-cli`` binary to test our connection. - -.. code-block:: bash - - apt-get update - apt-get -y install redis-server - service redis-server stop - -As we've used the ``--link redis:db`` option, Docker has created some environment -variables in our web application container. - -.. code-block:: bash - - env | grep DB_ - - # Should return something similar to this with your values - DB_NAME=/violet_wolf/db - DB_PORT_6379_TCP_PORT=6379 - DB_PORT=tcp://172.17.0.33:6379 - DB_PORT_6379_TCP=tcp://172.17.0.33:6379 - DB_PORT_6379_TCP_ADDR=172.17.0.33 - DB_PORT_6379_TCP_PROTO=tcp - -We can see that we've got a small list of environment variables prefixed with ``DB``. -The ``DB`` comes from the link alias specified when we launched the container. Let's use -the ``DB_PORT_6379_TCP_ADDR`` variable to connect to our Redis container. - -.. code-block:: bash - - redis-cli -h $DB_PORT_6379_TCP_ADDR - redis 172.17.0.33:6379> - redis 172.17.0.33:6379> set docker awesome - OK - redis 172.17.0.33:6379> get docker - "awesome" - redis 172.17.0.33:6379> exit - -We could easily use this or other environment variables in our web application to make a -connection to our ``redis`` container. - diff --git a/docs/sources/examples/running_riak_service.rst b/docs/sources/examples/running_riak_service.rst deleted file mode 100644 index 55e5e405c9..0000000000 --- a/docs/sources/examples/running_riak_service.rst +++ /dev/null @@ -1,151 +0,0 @@ -:title: Running a Riak service -:description: Build a Docker image with Riak pre-installed -:keywords: docker, example, package installation, networking, riak - -Riak Service -============================== - -.. include:: example_header.inc - -The goal of this example is to show you how to build a Docker image with Riak -pre-installed. - -Creating a ``Dockerfile`` -+++++++++++++++++++++++++ - -Create an empty file called ``Dockerfile``: - -.. code-block:: bash - - touch Dockerfile - -Next, define the parent image you want to use to build your image on top of. -We’ll use `Ubuntu `_ (tag: ``latest``), -which is available on the `docker index `_: - -.. code-block:: bash - - # Riak - # - # VERSION 0.1.0 - - # Use the Ubuntu base image provided by dotCloud - FROM ubuntu:latest - MAINTAINER Hector Castro hector@basho.com - -Next, we update the APT cache and apply any updates: - -.. code-block:: bash - - # Update the APT cache - RUN sed -i.bak 's/main$/main universe/' /etc/apt/sources.list - RUN apt-get update - RUN apt-get upgrade -y - -After that, we install and setup a few dependencies: - -- ``curl`` is used to download Basho's APT repository key -- ``lsb-release`` helps us derive the Ubuntu release codename -- ``openssh-server`` allows us to login to containers remotely and join Riak - nodes to form a cluster -- ``supervisor`` is used manage the OpenSSH and Riak processes - -.. code-block:: bash - - # Install and setup project dependencies - RUN apt-get install -y curl lsb-release supervisor openssh-server - - RUN mkdir -p /var/run/sshd - RUN mkdir -p /var/log/supervisor - - RUN locale-gen en_US en_US.UTF-8 - - ADD supervisord.conf /etc/supervisor/conf.d/supervisord.conf - - RUN echo 'root:basho' | chpasswd - -Next, we add Basho's APT repository: - -.. code-block:: bash - - RUN curl -s http://apt.basho.com/gpg/basho.apt.key | apt-key add -- - RUN echo "deb http://apt.basho.com $(lsb_release -cs) main" > /etc/apt/sources.list.d/basho.list - RUN apt-get update - -After that, we install Riak and alter a few defaults: - -.. code-block:: bash - - # Install Riak and prepare it to run - RUN apt-get install -y riak - RUN sed -i.bak 's/127.0.0.1/0.0.0.0/' /etc/riak/app.config - RUN echo "ulimit -n 4096" >> /etc/default/riak - -Almost there. Next, we add a hack to get us by the lack of ``initctl``: - -.. code-block:: bash - - # Hack for initctl - # See: https://github.com/dotcloud/docker/issues/1024 - RUN dpkg-divert --local --rename --add /sbin/initctl - RUN ln -sf /bin/true /sbin/initctl - -Then, we expose the Riak Protocol Buffers and HTTP interfaces, along with SSH: - -.. code-block:: bash - - # Expose Riak Protocol Buffers and HTTP interfaces, along with SSH - EXPOSE 8087 8098 22 - -Finally, run ``supervisord`` so that Riak and OpenSSH are started: - -.. code-block:: bash - - CMD ["/usr/bin/supervisord"] - -Create a ``supervisord`` configuration file -+++++++++++++++++++++++++++++++++++++++++++ - -Create an empty file called ``supervisord.conf``. Make sure it's at the same -directory level as your ``Dockerfile``: - -.. code-block:: bash - - touch supervisord.conf - -Populate it with the following program definitions: - -.. code-block:: bash - - [supervisord] - nodaemon=true - - [program:sshd] - command=/usr/sbin/sshd -D - stdout_logfile=/var/log/supervisor/%(program_name)s.log - stderr_logfile=/var/log/supervisor/%(program_name)s.log - autorestart=true - - [program:riak] - command=bash -c ". /etc/default/riak && /usr/sbin/riak console" - pidfile=/var/log/riak/riak.pid - stdout_logfile=/var/log/supervisor/%(program_name)s.log - stderr_logfile=/var/log/supervisor/%(program_name)s.log - -Build the Docker image for Riak -+++++++++++++++++++++++++++++++ - -Now you should be able to build a Docker image for Riak: - -.. code-block:: bash - - docker build -t "/riak" . - -Next steps -++++++++++ - -Riak is a distributed database. Many production deployments consist of `at -least five nodes `_. See the `docker-riak `_ project details on how to deploy a Riak cluster using Docker and -Pipework. diff --git a/docs/sources/examples/running_ssh_service.rst b/docs/sources/examples/running_ssh_service.rst deleted file mode 100644 index 4161275019..0000000000 --- a/docs/sources/examples/running_ssh_service.rst +++ /dev/null @@ -1,49 +0,0 @@ -:title: Running an SSH service -:description: Installing and running an sshd service -:keywords: docker, example, package installation, networking - -.. _running_ssh_service: - -SSH Daemon Service -================== - -.. include:: example_header.inc - -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 quick access to a -test container. - -.. literalinclude:: running_ssh_service.Dockerfile - -Build the image using: - -.. code-block:: bash - - $ 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: - -.. code-block:: bash - - $ sudo docker run -d -P --name test_sshd eg_sshd - $ sudo docker port test_sshd 22 - 0.0.0.0:49154 - -And now you can ssh to port ``49154`` on the Docker daemon's host IP address -(``ip address`` or ``ifconfig`` can tell you that): - -.. code-block:: bash - - $ ssh root@192.168.1.2 -p 49154 - # The password is ``screencast``. - $$ - -Finally, clean up after your test by stopping and removing the container, and -then removing the image. - -.. code-block:: bash - - $ sudo docker stop test_sshd - $ sudo docker rm test_sshd - $ sudo docker rmi eg_sshd diff --git a/docs/sources/examples/using_supervisord.rst b/docs/sources/examples/using_supervisord.rst deleted file mode 100644 index 750b6c2334..0000000000 --- a/docs/sources/examples/using_supervisord.rst +++ /dev/null @@ -1,128 +0,0 @@ -:title: Using Supervisor with Docker -:description: How to use Supervisor process management with Docker -:keywords: docker, supervisor, process management - -.. _using_supervisord: - -Using Supervisor with Docker -============================ - -.. include:: example_header.inc - -Traditionally a Docker container runs a single process when it is launched, for -example an Apache daemon or a SSH server daemon. Often though you want to run -more than one process in a container. There are a number of ways you can -achieve this ranging from using a simple Bash script as the value of your -container's ``CMD`` instruction to installing a process management tool. - -In this example we're going to make use of the process management tool, -`Supervisor `_, to manage multiple processes in our -container. Using Supervisor allows us to better control, manage, and restart the -processes we want to run. To demonstrate this we're going to install and manage both an -SSH daemon and an Apache daemon. - -Creating a Dockerfile ---------------------- - -Let's start by creating a basic ``Dockerfile`` for our new image. - -.. code-block:: bash - - FROM ubuntu:latest - MAINTAINER examples@docker.io - RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list - RUN apt-get update - RUN apt-get upgrade -y - -Installing Supervisor ---------------------- - -We can now install our SSH and Apache daemons as well as Supervisor in our container. - -.. code-block:: bash - - RUN apt-get install -y openssh-server apache2 supervisor - RUN mkdir -p /var/run/sshd - RUN mkdir -p /var/log/supervisor - -Here we're installing the ``openssh-server``, ``apache2`` and ``supervisor`` -(which provides the Supervisor daemon) packages. We're also creating two new -directories that are needed to run our SSH daemon and Supervisor. - -Adding Supervisor's configuration file --------------------------------------- - -Now let's add a configuration file for Supervisor. The default file is called -``supervisord.conf`` and is located in ``/etc/supervisor/conf.d/``. - -.. code-block:: bash - - ADD supervisord.conf /etc/supervisor/conf.d/supervisord.conf - -Let's see what is inside our ``supervisord.conf`` file. - -.. code-block:: bash - - [supervisord] - nodaemon=true - - [program:sshd] - command=/usr/sbin/sshd -D - - [program:apache2] - command=/bin/bash -c "source /etc/apache2/envvars && exec /usr/sbin/apache2 -DFOREGROUND" - -The ``supervisord.conf`` configuration file contains directives that configure -Supervisor and the processes it manages. The first block ``[supervisord]`` -provides configuration for Supervisor itself. We're using one directive, -``nodaemon`` which tells Supervisor to run interactively rather than daemonize. - -The next two blocks manage the services we wish to control. Each block controls -a separate process. The blocks contain a single directive, ``command``, which -specifies what command to run to start each process. - -Exposing ports and running Supervisor -------------------------------------- - -Now let's finish our ``Dockerfile`` by exposing some required ports and -specifying the ``CMD`` instruction to start Supervisor when our container -launches. - -.. code-block:: bash - - EXPOSE 22 80 - CMD ["/usr/bin/supervisord"] - -Here we've exposed ports 22 and 80 on the container and we're running the -``/usr/bin/supervisord`` binary when the container launches. - -Building our container ----------------------- - -We can now build our new container. - -.. code-block:: bash - - sudo docker build -t /supervisord . - -Running our Supervisor container --------------------------------- - -Once we've got a built image we can launch a container from it. - -.. code-block:: bash - - sudo docker run -p 22 -p 80 -t -i /supervisord - 2013-11-25 18:53:22,312 CRIT Supervisor running as root (no user in config file) - 2013-11-25 18:53:22,312 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing - 2013-11-25 18:53:22,342 INFO supervisord started with pid 1 - 2013-11-25 18:53:23,346 INFO spawned: 'sshd' with pid 6 - 2013-11-25 18:53:23,349 INFO spawned: 'apache2' with pid 7 - . . . - -We've launched a new container interactively using the ``docker run`` command. -That container has run Supervisor and launched the SSH and Apache daemons with -it. We've specified the ``-p`` flag to expose ports 22 and 80. From here we can -now identify the exposed ports and connect to one or both of the SSH and Apache -daemons. - diff --git a/docs/sources/faq.rst b/docs/sources/faq.rst deleted file mode 100644 index 07055941bd..0000000000 --- a/docs/sources/faq.rst +++ /dev/null @@ -1,224 +0,0 @@ -:title: FAQ -:description: Most frequently asked questions. -: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. - -What open source license are you using? -....................................... - - We are using the Apache License Version 2.0, see it here: - 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 :ref:`macosx` and - :ref:`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. - -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 :ref:`a tool for developers to automatically - assemble a container from their source code `, - 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``, so new versions - of a container can be transferred by only sending diffs. - - * *Component re-use.* - Any container can be used as a :ref:`"base image" - ` 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 - `_ 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 :ref:`registry - ` 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 differences `_. - -Do I lose my data when the container exits? -........................................... - -Not at all! Any data that your application writes to disk gets preserved -in its container until you explicitly delete the container. The file -system for the container persists even after the container halts. - -How far do Docker containers scale? -................................... - -Some of the largest server farms in the world today are based on containers. -Large web deployments like Google and Twitter, and platform providers such as -Heroku and dotCloud all run on container technology, at a scale of hundreds of -thousands or even millions of containers running in parallel. - -How do I connect Docker containers? -................................... - -Currently the recommended way to link containers is via the `link` primitive. -You can see details of how to `work with links here -`_. - -Also of useful when enabling more flexible service portability is the -`Ambassador linking pattern -`_. - -How do I run more than one process in a Docker container? -......................................................... - -Any capable process supervisor such as http://supervisord.org/, runit, s6, or -daemontools can do the trick. Docker will start up the process management -daemon which will then fork to run additional processes. As long as the -processor manager daemon continues to run, the container will continue to as -well. You can see a more substantial example `that uses supervisord here -`_. - -What platforms does Docker run on? -.................................. - -Linux: - -- Ubuntu 12.04, 13.04 et al -- Fedora 19/20+ -- RHEL 6.5+ -- Centos 6+ -- Gentoo -- ArchLinux -- openSUSE 12.3+ -- CRUX 3.0+ - -Cloud: - -- Amazon EC2 -- Google Compute Engine -- Rackspace - -How do I report a security issue with Docker? -............................................. - -You can learn about the project's security policy `here `_ -and report security issues to this `mailbox `_. - -Why do I need to sign my commits to Docker with the DCO? -........................................................ - -Please read `our blog post `_ on the introduction of the DCO. - -Can I help by adding some questions and answers? -................................................ - -Definitely! You can fork `the repo`_ and edit the documentation sources. - - -Where can I find more answers? -.............................. - - You can find more answers on: - - * `Docker user mailinglist`_ - * `Docker developer mailinglist`_ - * `IRC, docker on freenode`_ - * `GitHub`_ - * `Ask questions on Stackoverflow`_ - * `Join the conversation on Twitter`_ - - - .. _Docker user mailinglist: https://groups.google.com/d/forum/docker-user - .. _Docker developer mailinglist: https://groups.google.com/d/forum/docker-dev - .. _the repo: http://www.github.com/dotcloud/docker - .. _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 :ref:`hello_world` example. diff --git a/docs/sources/installation/amazon.rst b/docs/sources/installation/amazon.rst deleted file mode 100644 index b062a15e1e..0000000000 --- a/docs/sources/installation/amazon.rst +++ /dev/null @@ -1,107 +0,0 @@ -:title: Installation on Amazon EC2 -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: amazon ec2, virtualization, cloud, docker, documentation, installation - -Amazon EC2 -========== - -.. include:: install_header.inc - -There are several ways to install Docker on AWS EC2: - -* :ref:`amazonquickstart_new` or -* :ref:`amazonquickstart` or -* :ref:`amazonstandard` - -**You'll need an** `AWS account `_ **first, of course.** - -.. _amazonquickstart: - -Amazon QuickStart ------------------ - -1. **Choose an image:** - - * Launch the `Create Instance Wizard - `_ menu - on your AWS Console. - - * Click the ``Select`` button for a 64Bit Ubuntu image. For example: Ubuntu Server 12.04.3 LTS - - * For testing you can use the default (possibly free) - ``t1.micro`` instance (more info on `pricing - `_). - - * Click the ``Next: Configure Instance Details`` button at the bottom right. - -2. **Tell CloudInit to install Docker:** - - * When you're on the "Configure Instance Details" step, expand the "Advanced - Details" section. - - * Under "User data", select "As text". - - * Enter ``#include https://get.docker.io`` into the instance *User Data*. - `CloudInit `_ is part of the - Ubuntu image you chose; it will bootstrap Docker by running the shell - script located at this URL. - -3. After a few more standard choices where defaults are probably ok, your AWS - Ubuntu instance with Docker should be running! - -**If this is your first AWS instance, you may need to set up your -Security Group to allow SSH.** By default all incoming ports to your -new instance will be blocked by the AWS Security Group, so you might -just get timeouts when you try to connect. - -Installing with ``get.docker.io`` (as above) will create a service named -``lxc-docker``. It will also set up a :ref:`docker group ` and you -may want to add the *ubuntu* user to it so that you don't have to use ``sudo`` -for every Docker command. - -Once you've got Docker installed, you're ready to try it out -- head -on over to the :doc:`../use/basics` or :doc:`../examples/index` section. - -.. _amazonquickstart_new: - -Amazon QuickStart (Release Candidate - March 2014) --------------------------------------------------- - -Amazon just published new Docker-ready AMIs (2014.03 Release Candidate). Docker packages -can now be installed from Amazon's provided Software Repository. - -1. **Choose an image:** - - * Launch the `Create Instance Wizard - `_ menu - on your AWS Console. - - * Click the ``Community AMI`` menu option on the left side - - * Search for '2014.03' and select one of the Amazon provided AMI, for example ``amzn-ami-pv-2014.03.rc-0.x86_64-ebs`` - - * For testing you can use the default (possibly free) - ``t1.micro`` instance (more info on `pricing - `_). - - * Click the ``Next: Configure Instance Details`` button at the bottom right. - -2. After a few more standard choices where defaults are probably ok, your Amazon - Linux instance should be running! - -3. SSH to your instance to install Docker : ``ssh -i ec2-user@`` - -4. Once connected to the instance, type ``sudo yum install -y docker ; sudo service docker start`` to install and start Docker - -.. _amazonstandard: - -Standard Ubuntu Installation ----------------------------- - -If you want a more hands-on installation, then you can follow the -:ref:`ubuntu_linux` instructions installing Docker on any EC2 instance -running Ubuntu. Just follow Step 1 from :ref:`amazonquickstart` to -pick an image (or use one of your own) and skip the step with the -*User Data*. Then continue with the :ref:`ubuntu_linux` instructions. - -Continue with the :ref:`hello_world` example. diff --git a/docs/sources/installation/archlinux.rst b/docs/sources/installation/archlinux.rst deleted file mode 100644 index c9b4c1d2c5..0000000000 --- a/docs/sources/installation/archlinux.rst +++ /dev/null @@ -1,73 +0,0 @@ -:title: Installation on Arch Linux -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: arch linux, virtualization, docker, documentation, installation - -.. _arch_linux: - -Arch Linux -========== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Installing on Arch Linux can be handled via the package in community: - -* `docker `_ - -or the following AUR package: - -* `docker-git `_ - -The docker package will install the latest tagged version of docker. -The docker-git package will build from the current master branch. - -Dependencies ------------- - -Docker depends on several packages which are specified as dependencies in -the packages. The core dependencies are: - -* bridge-utils -* device-mapper -* iproute2 -* lxc -* sqlite - - -Installation ------------- - -For the normal package a simple -:: - - pacman -S docker - -is all that is needed. - -For the AUR package execute: -:: - - yaourt -S docker-git - -The instructions here assume **yaourt** is installed. See -`Arch User Repository `_ -for information on building and installing packages from the AUR if you have not -done so before. - - -Starting Docker ---------------- - -There is a systemd service unit created for docker. To start the docker service: - -:: - - sudo systemctl start docker - - -To start on system boot: - -:: - - sudo systemctl enable docker diff --git a/docs/sources/installation/binaries.rst b/docs/sources/installation/binaries.rst deleted file mode 100644 index 9fa880b364..0000000000 --- a/docs/sources/installation/binaries.rst +++ /dev/null @@ -1,123 +0,0 @@ -:title: Installation from Binaries -:description: This instruction set is meant for hackers who want to try out Docker on a variety of environments. -:keywords: binaries, installation, docker, documentation, linux - -.. _binaries: - -Binaries -======== - -.. include:: install_header.inc - -**This instruction set is meant for hackers who want to try out Docker -on a variety of environments.** - -Before following these directions, you should really check if a -packaged version of Docker is already available for your distribution. -We have packages for many distributions, and more keep showing up all -the time! - - -Check runtime dependencies --------------------------- - -.. DOC COMMENT: this should be kept in sync with - https://github.com/dotcloud/docker/blob/master/hack/PACKAGERS.md#runtime-dependencies - -To run properly, docker needs the following software to be installed at runtime: - -- iptables version 1.4 or later -- Git version 1.7 or later -- procps (or similar provider of a "ps" executable) -- XZ Utils 4.9 or later -- a `properly mounted - `_ - cgroupfs hierarchy (having a single, all-encompassing "cgroup" mount point `is - `_ `not - `_ `sufficient - `_) - - -Check kernel dependencies -------------------------- - -Docker in daemon mode has specific kernel requirements. For details, -check your distribution in :ref:`installation_list`. - -In general, a 3.8 Linux kernel (or higher) is preferred, as some of the -prior versions have known issues that are triggered by Docker. - -Note that Docker also has a client mode, which can run on virtually -any Linux kernel (it even builds on OSX!). - - -Get the docker binary: ----------------------- - -.. code-block:: bash - - wget https://get.docker.io/builds/Linux/x86_64/docker-latest -O docker - chmod +x docker - -.. note:: - If you have trouble downloading the binary, you can also get the smaller - compressed release file: https://get.docker.io/builds/Linux/x86_64/docker-latest.tgz - -Run the docker daemon ---------------------- - -.. code-block:: bash - - # start the docker in daemon mode from the directory you unpacked - sudo ./docker -d & - - -.. _dockergroup: - -Giving non-root access ----------------------- - -The ``docker`` daemon always runs as the root user, and since Docker -version 0.5.2, the ``docker`` daemon binds to a Unix socket instead of -a TCP port. By default that Unix socket is owned by the user *root*, -and so, by default, you can access it with ``sudo``. - -Starting in version 0.5.3, if you (or your Docker installer) create a -Unix group called *docker* and add users to it, then the ``docker`` -daemon will make the ownership of the Unix 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. - -.. warning:: The *docker* group (or the group specified with ``-G``) is - root-equivalent; see :ref:`dockersecurity_daemon` details. - - -Upgrades --------- - -To upgrade your manual installation of Docker, first kill the docker -daemon: - -.. code-block:: bash - - killall docker - -Then follow the regular installation steps. - - -Run your first container! -------------------------- - -.. code-block:: bash - - # check your docker version - sudo ./docker version - - # run a container and open an interactive shell in the container - sudo ./docker run -i -t ubuntu /bin/bash - - - -Continue with the :ref:`hello_world` example. diff --git a/docs/sources/installation/cruxlinux.rst b/docs/sources/installation/cruxlinux.rst deleted file mode 100644 index d1970cd1bf..0000000000 --- a/docs/sources/installation/cruxlinux.rst +++ /dev/null @@ -1,98 +0,0 @@ -:title: Installation on CRUX Linux -:description: Docker installation on CRUX Linux. -:keywords: crux linux, virtualization, Docker, documentation, installation - -.. _crux_linux: - - -CRUX Linux -========== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Installing on CRUX Linux can be handled via the ports from `James Mills `_: - -* `docker `_ - -* `docker-bin `_ - -* `docker-git `_ - -The ``docker`` port will install the latest tagged version of Docker. -The ``docker-bin`` port will install the latest tagged versin of Docker from upstream built binaries. -The ``docker-git`` package will build from the current master branch. - - -Installation ------------- - -For the time being (*until the CRUX Docker port(s) get into the official contrib repository*) you will need to install -`James Mills' `_ ports repository. You can do so via: - -Download the ``httpup`` file to ``/etc/ports/``: -:: - - curl -q -o - http://crux.nu/portdb/?a=getup&q=prologic > /etc/ports/prologic.httpup - - -Add ``prtdir /usr/ports/prologic`` to ``/etc/prt-get.conf``: -:: - - vim /etc/prt-get.conf - - # or: - echo "prtdir /usr/ports/prologic" >> /etc/prt-get.conf - - -Update ports and prt-get cache: -:: - - ports -u - prt-get cache - - -To install (*and its dependencies*): -:: - - prt-get depinst docker - - -Use ``docker-bin`` for the upstream binary or ``docker-git`` to build and install from the master branch from git. - - -Kernel Requirements -------------------- - -To have a working **CRUX+Docker** Host you must ensure your Kernel -has the necessary modules enabled for LXC containers to function -correctly and Docker Daemon to work properly. - -Please read the ``README.rst``: -:: - - prt-get readme docker - -There is a ``test_kernel_config.sh`` script in the above ports which you can use to test your Kernel configuration: - -:: - - cd /usr/ports/prologic/docker - ./test_kernel_config.sh /usr/src/linux/.config - - -Starting Docker ---------------- - -There is a rc script created for Docker. To start the Docker service: - -:: - - sudo su - - /etc/rc.d/docker start - -To start on system boot: - -- Edit ``/etc/rc.conf`` -- Put ``docker`` into the ``SERVICES=(...)`` array after ``net``. diff --git a/docs/sources/installation/fedora.rst b/docs/sources/installation/fedora.rst deleted file mode 100644 index 3b95f04f7f..0000000000 --- a/docs/sources/installation/fedora.rst +++ /dev/null @@ -1,75 +0,0 @@ -:title: Installation on Fedora -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux - -.. _fedora: - -Fedora -====== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Docker is available in **Fedora 19 and later**. Please note that due to the -current Docker limitations Docker is able to run only on the **64 bit** -architecture. - -Installation ------------- - -The ``docker-io`` package provides Docker on Fedora. - - -If you have the (unrelated) ``docker`` package installed already, it will -conflict with ``docker-io``. There's a `bug report`_ filed for it. -To proceed with ``docker-io`` installation on Fedora 19 or Fedora 20, please -remove ``docker`` first. - -.. code-block:: bash - - sudo yum -y remove docker - -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``. - -.. code-block:: bash - - sudo yum -y install wmdocker - sudo yum -y remove docker - -Install the ``docker-io`` package which will install Docker on our host. - -.. code-block:: bash - - sudo yum -y install docker-io - - -To update the ``docker-io`` package: - -.. code-block:: bash - - sudo yum -y update docker-io - -Now that it's installed, let's start the Docker daemon. - -.. code-block:: bash - - sudo systemctl start docker - -If we want Docker to start at boot, we should also: - -.. code-block:: bash - - sudo systemctl enable docker - -Now let's verify that Docker is working. - -.. code-block:: bash - - sudo docker run -i -t fedora /bin/bash - -**Done!**, now continue with the :ref:`hello_world` example. - -.. _bug report: https://bugzilla.redhat.com/show_bug.cgi?id=1043676 - diff --git a/docs/sources/installation/frugalware.rst b/docs/sources/installation/frugalware.rst deleted file mode 100644 index ed9bb2bfaa..0000000000 --- a/docs/sources/installation/frugalware.rst +++ /dev/null @@ -1,62 +0,0 @@ -:title: Installation on FrugalWare -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: frugalware linux, virtualization, docker, documentation, installation - -.. _frugalware: - -FrugalWare -========== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Installing on FrugalWare is handled via the official packages: - -* `lxc-docker i686 `_ - -* `lxc-docker x86_64 `_ - -The `lxc-docker` package will install the latest tagged version of Docker. - -Dependencies ------------- - -Docker depends on several packages which are specified as dependencies in -the packages. The core dependencies are: - -* systemd -* lvm2 -* sqlite3 -* libguestfs -* lxc -* iproute2 -* bridge-utils - - -Installation ------------- - -A simple -:: - - pacman -S lxc-docker - -is all that is needed. - - -Starting Docker ---------------- - -There is a systemd service unit created for Docker. To start Docker as service: - -:: - - sudo systemctl start lxc-docker - - -To start on system boot: - -:: - - sudo systemctl enable lxc-docker diff --git a/docs/sources/installation/gentoolinux.rst b/docs/sources/installation/gentoolinux.rst deleted file mode 100644 index 5abfddeb91..0000000000 --- a/docs/sources/installation/gentoolinux.rst +++ /dev/null @@ -1,84 +0,0 @@ -:title: Installation on Gentoo -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: gentoo linux, virtualization, docker, documentation, installation - -.. _gentoo_linux: - -Gentoo -====== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Installing Docker on Gentoo Linux can be accomplished using one of two methods. -The first and best way if you're looking for a stable experience is to use the -official `app-emulation/docker` package directly in the portage tree. - -If you're looking for a ``-bin`` ebuild, a live ebuild, or bleeding edge -ebuild changes/fixes, the second installation method is to use the overlay -provided at https://github.com/tianon/docker-overlay which can be added using -``app-portage/layman``. The most accurate and up-to-date documentation for -properly installing and using the overlay can be found in `the overlay README -`_. - -Note that sometimes there is a disparity between the latest version and what's -in the overlay, and between the latest version in the overlay and what's in the -portage tree. Please be patient, and the latest version should propagate -shortly. - -Installation -^^^^^^^^^^^^ - -The package should properly pull in all the necessary dependencies and prompt -for all necessary kernel options. The ebuilds for 0.7+ include use flags to -pull in the proper dependencies of the major storage drivers, with the -"device-mapper" use flag being enabled by default, since that is the simplest -installation path. - -.. code-block:: bash - - sudo emerge -av app-emulation/docker - -If any issues arise from this ebuild or the resulting binary, including and -especially missing kernel configuration flags and/or dependencies, `open an -issue on the docker-overlay repository -`_ or ping tianon directly in -the #docker IRC channel on the freenode network. - -Starting Docker -^^^^^^^^^^^^^^^ - -Ensure that you are running a kernel that includes all the necessary modules -and/or configuration for LXC (and optionally for device-mapper and/or AUFS, -depending on the storage driver you've decided to use). - -OpenRC ------- - -To start the docker daemon: - -.. code-block:: bash - - sudo /etc/init.d/docker start - -To start on system boot: - -.. code-block:: bash - - sudo rc-update add docker default - -systemd -------- - -To start the docker daemon: - -.. code-block:: bash - - sudo systemctl start docker.service - -To start on system boot: - -.. code-block:: bash - - sudo systemctl enable docker.service diff --git a/docs/sources/installation/google.rst b/docs/sources/installation/google.rst deleted file mode 100644 index cc1df5da24..0000000000 --- a/docs/sources/installation/google.rst +++ /dev/null @@ -1,58 +0,0 @@ -:title: Installation on Google Cloud Platform -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Docker, Docker documentation, installation, google, Google Compute Engine, Google Cloud Platform - -`Google Cloud Platform `_ -==================================================== - -.. include:: install_header.inc - -.. _googlequickstart: - -`Compute Engine `_ QuickStart for `Debian `_ ------------------------------------------------------------------------------------------------------------ - -1. Go to `Google Cloud Console `_ and create a new Cloud Project with `Compute Engine enabled `_. - -2. Download and configure the `Google Cloud SDK `_ to use your project with the following commands: - -.. code-block:: bash - - $ curl https://dl.google.com/dl/cloudsdk/release/install_google_cloud_sdk.bash | bash - $ gcloud auth login - Enter a cloud project id (or leave blank to not set): - -3. Start a new instance, select a zone close to you and the desired instance size: - -.. code-block:: bash - - $ gcutil addinstance docker-playground --image=backports-debian-7 - 1: europe-west1-a - ... - 4: us-central1-b - >>> - 1: machineTypes/n1-standard-1 - ... - 12: machineTypes/g1-small - >>> - -4. Connect to the instance using SSH: - -.. code-block:: bash - - $ gcutil ssh docker-playground - docker-playground:~$ - -5. Install the latest Docker release and configure it to start when the instance boots: - -.. code-block:: bash - - docker-playground:~$ curl get.docker.io | bash - docker-playground:~$ sudo update-rc.d docker defaults - -6. Start a new container: - -.. code-block:: bash - - docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' - docker on GCE \o/ diff --git a/docs/sources/installation/index.rst b/docs/sources/installation/index.rst deleted file mode 100644 index ae0e9196fa..0000000000 --- a/docs/sources/installation/index.rst +++ /dev/null @@ -1,34 +0,0 @@ -:title: Docker Installation -:description: many ways to install Docker -:keywords: docker, installation - -.. _installation_list: - -Installation -============ - -There are a number of ways to install Docker, depending on where you -want to run the daemon. The :ref:`ubuntu_linux` installation is the -officially-tested version. The community adds more techniques for -installing Docker all the time. - -Contents: - -.. toctree:: - :maxdepth: 1 - - ubuntulinux - rhel - fedora - archlinux - cruxlinux - gentoolinux - openSUSE - frugalware - mac - windows - amazon - rackspace - google - softlayer - binaries diff --git a/docs/sources/installation/mac.rst b/docs/sources/installation/mac.rst deleted file mode 100644 index d5243625a7..0000000000 --- a/docs/sources/installation/mac.rst +++ /dev/null @@ -1,212 +0,0 @@ -:title: Installation on Mac OS X 10.6 Snow Leopard -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Docker, Docker documentation, requirements, virtualbox, ssh, linux, os x, osx, mac - -.. _macosx: - -======== -Mac OS X -======== - -.. note:: - - These instructions are available with the new release of Docker - (version 0.8). However, they are subject to change. - -.. include:: install_header.inc - -Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer. - -How To Install Docker On Mac OS X -================================= - -VirtualBox ----------- - -Docker on OS X needs VirtualBox to run. To begin with, head over to -`VirtualBox Download Page`_ and get the tool for ``OS X hosts x86/amd64``. - -.. _VirtualBox Download Page: https://www.virtualbox.org/wiki/Downloads - -Once the download is complete, open the disk image, run the set up file -(i.e. ``VirtualBox.pkg``) and install VirtualBox. Do not simply copy the -package without running the installer. - -boot2docker ------------ - -`boot2docker`_ provides a handy script to easily manage the VM running the -``docker`` daemon. It also takes care of the installation for the OS image -that is used for the job. - -.. _GitHub page: https://github.com/boot2docker/boot2docker - -With Homebrew -~~~~~~~~~~~~~ - -If you are using Homebrew on your machine, simply run the following command to install ``boot2docker``: - -.. code-block:: bash - - brew install boot2docker - -Manual installation -~~~~~~~~~~~~~~~~~~~ - -Open up a new terminal window, if you have not already. - -Run the following commands to get boot2docker: - -.. code-block:: bash - - # Enter the installation directory - cd ~/bin - - # Get the file - curl https://raw.github.com/boot2docker/boot2docker/master/boot2docker > boot2docker - - # Mark it executable - chmod +x boot2docker - -Docker OS X Client ------------------- - -The ``docker`` daemon is accessed using the ``docker`` client. - -With Homebrew -~~~~~~~~~~~~~ - -Run the following command to install the ``docker`` client: - -.. code-block:: bash - - brew install docker - -Manual installation -~~~~~~~~~~~~~~~~~~~ - -Run the following commands to get it downloaded and set up: - -.. code-block:: bash - - # Get the docker client file - DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ - curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ - gunzip $DIR/ld.tgz && \ - tar xvf $DIR/ld.tar -C $DIR/ && \ - cp $DIR/usr/local/bin/docker ./docker - - # Set the environment variable for the docker daemon - export DOCKER_HOST=tcp://127.0.0.1:4243 - - # Copy the executable file - sudo cp docker /usr/local/bin/ - -And that’s it! Let’s check out how to use it. - -How To Use Docker On Mac OS X -============================= - -The ``docker`` daemon (via boot2docker) ---------------------------------------- - -Inside the ``~/bin`` directory, run the following commands: - -.. code-block:: bash - - # Initiate the VM - ./boot2docker init - - # Run the VM (the docker daemon) - ./boot2docker up - - # To see all available commands: - ./boot2docker - - # Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} - -The ``docker`` client ---------------------- - -Once the VM with the ``docker`` daemon is up, you can use the ``docker`` -client just like any other application. - -.. code-block:: bash - - docker version - # Client version: 0.7.6 - # Go version (client): go1.2 - # Git commit (client): bc3b2ec - # Server version: 0.7.5 - # Git commit (server): c348c04 - # Go version (server): go1.2 - -Forwarding VM Port Range to Host --------------------------------- - -If we take the port range that docker uses by default with the -P option -(49000-49900), and forward same range from host to vm, we'll be able to interact -with our containers as if they were running locally: - -.. code-block:: bash - - # vm must be powered off - for i in {49000..49900}; do - VBoxManage modifyvm "boot2docker-vm" --natpf1 "tcp-port$i,tcp,,$i,,$i"; - VBoxManage modifyvm "boot2docker-vm" --natpf1 "udp-port$i,udp,,$i,,$i"; - done - -SSH-ing The VM --------------- - -If you feel the need to connect to the VM, you can simply run: - -.. code-block:: bash - - ./boot2docker ssh - - # User: docker - # Pwd: tcuser - -You can now continue with the :ref:`hello_world` example. - -Learn More -========== - -boot2docker: ------------- - -See the GitHub page for `boot2docker`_. - -.. _boot2docker: https://github.com/boot2docker/boot2docker - -If SSH complains about keys: ----------------------------- - -.. code-block:: bash - - ssh-keygen -R '[localhost]:2022' - -Upgrading to a newer release of boot2docker -------------------------------------------- - -To upgrade an initialised VM, you can use the following 3 commands. Your persistence -disk will not be changed, so you won't lose your images and containers: - -.. code-block:: bash - - ./boot2docker stop - ./boot2docker download - ./boot2docker start - -About the way Docker works on Mac OS X: ---------------------------------------- - -Docker has two key components: the ``docker`` daemon and the ``docker`` -client. The tool works by client commanding the daemon. In order to -work and do its magic, the daemon makes use of some Linux Kernel -features (e.g. LXC, name spaces etc.), which are not supported by OS X. -Therefore, the solution of getting Docker to run on OS X consists of -running it inside a lightweight virtual machine. In order to simplify -things, Docker comes with a bash script to make this whole process as -easy as possible (i.e. boot2docker). diff --git a/docs/sources/installation/openSUSE.rst b/docs/sources/installation/openSUSE.rst deleted file mode 100644 index c791beacbf..0000000000 --- a/docs/sources/installation/openSUSE.rst +++ /dev/null @@ -1,73 +0,0 @@ -:title: Installation on openSUSE -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: openSUSE, virtualbox, docker, documentation, installation - -.. _openSUSE: - -openSUSE -======== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Docker is available in **openSUSE 12.3 and later**. Please note that due to the -current Docker limitations Docker is able to run only on the **64 bit** -architecture. - -Installation ------------- - -The ``docker`` package from the `Virtualization project`_ on `OBS`_ provides -Docker on openSUSE. - - -To proceed with Docker installation please add the right Virtualization -repository. - -.. code-block:: bash - - # openSUSE 12.3 - sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization - - # openSUSE 13.1 - sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization - - -Install the Docker package. - -.. code-block:: bash - - sudo zypper in docker - -It's also possible to install Docker using openSUSE's 1-click install. Just -visit `this`_ page, select your openSUSE version and click on the installation -link. This will add the right repository to your system and it will -also install the `docker` package. - -Now that it's installed, let's start the Docker daemon. - -.. code-block:: bash - - sudo systemctl start docker - -If we want Docker to start at boot, we should also: - -.. code-block:: bash - - sudo systemctl enable docker - -The `docker` package creates a new group named `docker`. Users, other than -`root` user, need to be part of this group in order to interact with the -Docker daemon. - -.. code-block:: bash - - sudo usermod -G docker - - -**Done!**, now continue with the :ref:`hello_world` example. - -.. _Virtualization project: https://build.opensuse.org/project/show/Virtualization -.. _OBS: https://build.opensuse.org/ -.. _this: http://software.opensuse.org/package/docker diff --git a/docs/sources/installation/rackspace.rst b/docs/sources/installation/rackspace.rst deleted file mode 100644 index 687131a413..0000000000 --- a/docs/sources/installation/rackspace.rst +++ /dev/null @@ -1,97 +0,0 @@ -:title: Installation on Rackspace Cloud -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Rackspace Cloud, installation, docker, linux, ubuntu - -Rackspace Cloud -=============== - -.. include:: install_unofficial.inc - -Installing Docker on Ubuntu provided by Rackspace is pretty -straightforward, and you should mostly be able to follow the -:ref:`ubuntu_linux` installation guide. - -**However, there is one caveat:** - -If you are using any Linux not already shipping with the 3.8 kernel -you will need to install it. And this is a little more difficult on -Rackspace. - -Rackspace boots their servers using grub's ``menu.lst`` and does not -like non 'virtual' packages (e.g. Xen compatible) kernels there, -although they do work. This results in ``update-grub`` not having the -expected result, and you will need to set the kernel manually. - -**Do not attempt this on a production machine!** - -.. code-block:: bash - - # update apt - apt-get update - - # install the new kernel - apt-get install linux-generic-lts-raring - - -Great, now you have the kernel installed in ``/boot/``, next you need to make it -boot next time. - -.. code-block:: bash - - # find the exact names - find /boot/ -name '*3.8*' - - # this should return some results - - -Now you need to manually edit ``/boot/grub/menu.lst``, you will find a -section at the bottom with the existing options. Copy the top one and -substitute the new kernel into that. Make sure the new kernel is on -top, and double check the kernel and initrd lines point to the right files. - -Take special care to double check the kernel and initrd entries. - -.. code-block:: bash - - # now edit /boot/grub/menu.lst - vi /boot/grub/menu.lst - -It will probably look something like this: - -:: - - ## ## End Default Options ## - - title Ubuntu 12.04.2 LTS, kernel 3.8.x generic - root (hd0) - kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0 - initrd /boot/initrd.img-3.8.0-19-generic - - title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual - root (hd0) - kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash console=hvc0 - initrd /boot/initrd.img-3.2.0-38-virtual - - title Ubuntu 12.04.2 LTS, kernel 3.2.0-38-virtual (recovery mode) - root (hd0) - kernel /boot/vmlinuz-3.2.0-38-virtual root=/dev/xvda1 ro quiet splash single - initrd /boot/initrd.img-3.2.0-38-virtual - - -Reboot the server (either via command line or console) - -.. code-block:: bash - - # reboot - -Verify the kernel was updated - -.. code-block:: bash - - uname -a - # Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux - - # nice! 3.8. - - -Now you can finish with the :ref:`ubuntu_linux` instructions. diff --git a/docs/sources/installation/rhel.rst b/docs/sources/installation/rhel.rst deleted file mode 100644 index 151fba6f1f..0000000000 --- a/docs/sources/installation/rhel.rst +++ /dev/null @@ -1,85 +0,0 @@ -:title: Installation on Red Hat Enterprise Linux -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Docker, Docker documentation, requirements, linux, rhel, centos - -.. _rhel: - -Red Hat Enterprise Linux -======================== - -.. include:: install_header.inc - -.. include:: install_unofficial.inc - -Docker is available for **RHEL** on EPEL. These instructions should work for -both RHEL and CentOS. They will likely work for other binary compatible EL6 -distributions as well, but they haven't been tested. - -Please note that this package is part of `Extra Packages for Enterprise -Linux (EPEL)`_, a community effort to create and maintain additional packages -for the RHEL distribution. - -Also note that due to the current Docker limitations, Docker is able to run -only on the **64 bit** architecture. - -You will need `RHEL 6.5`_ or higher, with a RHEL 6 kernel version 2.6.32-431 or higher -as this has specific kernel fixes to allow Docker to work. - -Installation ------------- - -Firstly, you need to install the EPEL repository. Please follow the `EPEL installation instructions`_. - - -The ``docker-io`` package provides Docker on EPEL. - - -If you already have the (unrelated) ``docker`` package installed, it will -conflict with ``docker-io``. There's a `bug report`_ filed for it. -To proceed with ``docker-io`` installation, please remove -``docker`` first. - - -Next, let's install the ``docker-io`` package which will install Docker on our host. - -.. code-block:: bash - - sudo yum -y install docker-io - -To update the ``docker-io`` package - -.. code-block:: bash - - sudo yum -y update docker-io - -Now that it's installed, let's start the Docker daemon. - -.. code-block:: bash - - sudo service docker start - -If we want Docker to start at boot, we should also: - -.. code-block:: bash - - sudo chkconfig docker on - -Now let's verify that Docker is working. - -.. code-block:: bash - - sudo docker run -i -t fedora /bin/bash - -**Done!**, now continue with the :ref:`hello_world` example. - -Issues? -------- - -If you have any issues - please report them directly in the `Red Hat Bugzilla for docker-io component`_. - -.. _Extra Packages for Enterprise Linux (EPEL): https://fedoraproject.org/wiki/EPEL -.. _EPEL installation instructions: https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F -.. _Red Hat Bugzilla for docker-io component : https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora%20EPEL&component=docker-io -.. _bug report: https://bugzilla.redhat.com/show_bug.cgi?id=1043676 -.. _RHEL 6.5: https://access.redhat.com/site/articles/3078#RHEL6 - diff --git a/docs/sources/installation/softlayer.rst b/docs/sources/installation/softlayer.rst deleted file mode 100644 index 0fe3d6df5a..0000000000 --- a/docs/sources/installation/softlayer.rst +++ /dev/null @@ -1,25 +0,0 @@ -:title: Installation on IBM SoftLayer -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: IBM SoftLayer, virtualization, cloud, docker, documentation, installation - -IBM SoftLayer -============= - -.. include:: install_header.inc - -IBM SoftLayer QuickStart -------------------------- - -1. Create an `IBM SoftLayer account `_. -2. Log in to the `SoftLayer Console `_. -3. Go to `Order Hourly Computing Instance Wizard `_ on your SoftLayer Console. -4. Create a new *CloudLayer Computing Instance* (CCI) using the default values for all the fields and choose: - -- *First Available* as ``Datacenter`` and -- *Ubuntu Linux 12.04 LTS Precise Pangolin - Minimal Install (64 bit)* as ``Operating System``. - -5. Click the *Continue Your Order* button at the bottom right and select *Go to checkout*. -6. Insert the required *User Metadata* and place the order. -7. Then continue with the :ref:`ubuntu_linux` instructions. - -Continue with the :ref:`hello_world` example. \ No newline at end of file diff --git a/docs/sources/installation/ubuntulinux.rst b/docs/sources/installation/ubuntulinux.rst deleted file mode 100644 index 3e4b2a9855..0000000000 --- a/docs/sources/installation/ubuntulinux.rst +++ /dev/null @@ -1,380 +0,0 @@ -:title: Installation on Ubuntu -:description: Please note this project is currently under heavy development. It should not be used in production. -:keywords: Docker, Docker documentation, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux - -.. _ubuntu_linux: - -Ubuntu -====== - -.. warning:: - - These instructions have changed for 0.6. If you are upgrading from - an earlier version, you will need to follow them again. - -.. include:: install_header.inc - -Docker is supported on the following versions of Ubuntu: - -- :ref:`ubuntu_precise` -- :ref:`ubuntu_raring_saucy` - -Please read :ref:`ufw`, if you plan to use `UFW (Uncomplicated -Firewall) `_ - -.. _ubuntu_precise: - -Ubuntu Precise 12.04 (LTS) (64-bit) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -This installation path should work at all times. - - -Dependencies ------------- - -**Linux kernel 3.8** - -Due to a bug in LXC, Docker works best on the 3.8 kernel. Precise -comes with a 3.2 kernel, so we need to upgrade it. The kernel you'll -install when following these steps comes with AUFS built in. We also -include the generic headers to enable packages that depend on them, -like ZFS and the VirtualBox guest additions. If you didn't install the -headers for your "precise" kernel, then you can skip these headers for -the "raring" kernel. But it is safer to include them if you're not -sure. - - -.. code-block:: bash - - # install the backported kernel - sudo apt-get update - sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring - - # reboot - sudo reboot - - -Installation ------------- - -.. warning:: - - 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. - -First, check that your APT system can deal with ``https`` URLs: -the file ``/usr/lib/apt/methods/https`` should exist. If it doesn't, -you need to install the package ``apt-transport-https``. - -.. code-block:: bash - - [ -e /usr/lib/apt/methods/https ] || { - apt-get update - apt-get install apt-transport-https - } - -Then, add the Docker repository key to your local keychain. - -.. code-block:: bash - - 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. - -*You may receive a warning that the package isn't trusted. Answer yes to -continue installation.* - -.. code-block:: bash - - sudo sh -c "echo deb https://get.docker.io/ubuntu docker main\ - > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker - -.. note:: - - There is also a simple ``curl`` script available to help with this process. - - .. code-block:: bash - - curl -s https://get.docker.io/ubuntu/ | sudo sh - -Now verify that the installation has worked by downloading the ``ubuntu`` image -and launching a container. - -.. code-block:: bash - - sudo docker run -i -t ubuntu /bin/bash - -Type ``exit`` to exit - -**Done!**, now continue with the :ref:`hello_world` example. - -.. _ubuntu_raring_saucy: - -Ubuntu Raring 13.04 and Saucy 13.10 (64 bit) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -These instructions cover both Ubuntu Raring 13.04 and Saucy 13.10. - -Dependencies ------------- - -**Optional AUFS filesystem support** - -Ubuntu Raring already comes with the 3.8 kernel, so we don't need to install it. However, not all systems -have AUFS filesystem support enabled. AUFS support is optional as of version 0.7, but it's still available as -a driver and we recommend using it if you can. - -To make sure AUFS is installed, run the following commands: - -.. code-block:: bash - - sudo apt-get update - sudo apt-get install linux-image-extra-`uname -r` - - -Installation ------------- - -Docker is available as a Debian package, which makes installation easy. - -.. warning:: - - Please note that these instructions have changed for 0.6. If you are upgrading from an earlier version, you will need - to follow them again. - -First add the Docker repository key to your local keychain. - -.. code-block:: bash - - 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. - -.. code-block:: bash - - sudo sh -c "echo deb http://get.docker.io/ubuntu docker main\ - > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker - -Now verify that the installation has worked by downloading the ``ubuntu`` image -and launching a container. - -.. code-block:: bash - - sudo docker run -i -t ubuntu /bin/bash - -Type ``exit`` to exit - -**Done!**, now continue with the :ref:`hello_world` example. - - -Giving non-root access ----------------------- - -The ``docker`` daemon always runs as the root user, and since Docker version -0.5.2, the ``docker`` daemon binds to a Unix socket instead of a TCP port. By -default that Unix socket is owned by the user *root*, and so, by default, you -can access it with ``sudo``. - -Starting in version 0.5.3, if you (or your Docker installer) create a -Unix group called *docker* and add users to it, then the ``docker`` -daemon will make the ownership of the Unix 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. 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 (or the group specified with ``-G``) is - root-equivalent; see :ref:`dockersecurity_daemon` details. - - -**Example:** - -.. code-block:: bash - - # Add the docker group if it doesn't already exist. - sudo groupadd docker - - # Add the connected user "${USER}" to the docker group. - # Change the user name to match your preferred user. - # You may have to logout and log back in again for - # this to take effect. - sudo gpasswd -a ${USER} docker - - # Restart the Docker daemon. - sudo service docker restart - - -Upgrade --------- - -To install the latest version of docker, use the standard ``apt-get`` method: - - -.. code-block:: bash - - # update your sources list - sudo apt-get update - - # install the latest - sudo apt-get install lxc-docker - -Memory and Swap Accounting -^^^^^^^^^^^^^^^^^^^^^^^^^^ - -If you want to enable memory and swap accounting, you must add the following -command-line parameters to your kernel:: - - cgroup_enable=memory swapaccount=1 - -On systems using GRUB (which is the default for Ubuntu), you can add those -parameters by editing ``/etc/default/grub`` and extending -``GRUB_CMDLINE_LINUX``. Look for the following line:: - - GRUB_CMDLINE_LINUX="" - -And replace it by the following one:: - - GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" - -Then run ``sudo update-grub``, and reboot. - -These parameters will help you get rid of the following warnings:: - - WARNING: Your kernel does not support cgroup swap limit. - WARNING: Your kernel does not support swap limit capabilities. Limitation discarded. - -Troubleshooting -^^^^^^^^^^^^^^^ - -On Linux Mint, the ``cgroup-lite`` package is not installed by default. -Before Docker will work correctly, you will need to install this via: - -.. code-block:: bash - - sudo apt-get update && sudo apt-get install cgroup-lite - -.. _ufw: - -Docker and UFW -^^^^^^^^^^^^^^ - -Docker uses a bridge to manage container networking. By default, UFW drops all -`forwarding` traffic. As a result you will need to enable UFW forwarding: - -.. code-block:: bash - - sudo nano /etc/default/ufw - ---- - # Change: - # DEFAULT_FORWARD_POLICY="DROP" - # to - DEFAULT_FORWARD_POLICY="ACCEPT" - -Then reload UFW: - -.. code-block:: bash - - sudo ufw reload - - -UFW's default set of rules denies all `incoming` traffic. If you want to be -able to reach your containers from another host then you should allow -incoming connections on the Docker port (default 4243): - -.. code-block:: bash - - sudo ufw allow 4243/tcp - -Docker and local DNS server warnings -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Systems which are running Ubuntu or an Ubuntu derivative on the desktop will -use `127.0.0.1` as the default nameserver in `/etc/resolv.conf`. NetworkManager -sets up dnsmasq to use the real DNS servers of the connection and sets up -`nameserver 127.0.0.1` in `/etc/resolv.conf`. - -When starting containers on these desktop machines, users will see a warning: - -.. code-block:: bash - - WARNING: Local (127.0.0.1) DNS resolver found in resolv.conf and containers can't use it. Using default external servers : [8.8.8.8 8.8.4.4] - -This warning is shown because the containers can't use the local DNS nameserver -and Docker will default to using an external nameserver. - -This can be worked around by specifying a DNS server to be used by the Docker -daemon for the containers: - -.. code-block:: bash - - sudo nano /etc/default/docker - --- - # Add: - 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 - -The Docker daemon has to be restarted: - -.. code-block:: bash - - sudo restart docker - -.. warning:: If you're doing this on a laptop which connects to various networks, make sure to choose a public DNS server. - -An alternative solution involves disabling dnsmasq in NetworkManager by -following these steps: - -.. code-block:: bash - - sudo nano /etc/NetworkManager/NetworkManager.conf - ---- - # Change: - dns=dnsmasq - # to - #dns=dnsmasq - -NetworkManager and Docker need to be restarted afterwards: - -.. code-block:: bash - - sudo restart network-manager - sudo restart docker - -.. warning:: This might make DNS resolution slower on some networks. - -.. _installmirrors: - -Mirrors -^^^^^^^ - -You should ``ping get.docker.io`` and compare the latency to the -following mirrors, and pick whichever one is best for you. - -Yandex ------- - -`Yandex `_ in Russia is mirroring the Docker Debian -packages, updating every 6 hours. Substitute -``http://mirror.yandex.ru/mirrors/docker/`` for -``http://get.docker.io/ubuntu`` in the instructions above. For example: - -.. code-block:: bash - - sudo sh -c "echo deb http://mirror.yandex.ru/mirrors/docker/ docker main\ - > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker diff --git a/docs/sources/installation/windows.rst b/docs/sources/installation/windows.rst deleted file mode 100755 index ceb29c8853..0000000000 --- a/docs/sources/installation/windows.rst +++ /dev/null @@ -1,72 +0,0 @@ -:title: Installation on Windows -:description: Please note this project is currently under heavy development. It should not be used in production. -: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 that's where Docker will run. - -Installation ------------- - -.. include:: install_header.inc - -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. - -3. Start VirtualBox. - -4. Create a new Virtual machine with the following settings: - - - `Name: boot2docker` - - `Type: Linux` - - `Version: Linux 2.6 (64 bit)` - - `Memory size: 1024 MB` - - `Hard drive: Do not add a virtual hard drive` - -5. Open the settings of the virtual machine: - - 5.1. go to Storage - - 5.2. click the empty slot below `Controller: IDE` - - 5.3. click the disc icon on the right of `IDE Secondary Master` - - 5.4. click `Choose a virtual CD/DVD disk file` - -6. Browse to the path where you've saved the `boot2docker.iso`, select the `boot2docker.iso` and click open. - -7. Click OK on the Settings dialog to save the changes and close the window. - -8. Start the virtual machine by clicking the green start button. - -9. The boot2docker virtual machine should boot now. - -Running Docker --------------- - -boot2docker will log you in automatically so you can start using Docker right -away. - -Let's try the “hello world” example. Run - -.. code-block:: bash - - docker run busybox echo hello world - -This will download the small busybox image and print hello world. - - -Observations ------------- - -Persistent storage -`````````````````` - -The virtual machine created above lacks any persistent data storage. All images -and containers will be lost when shutting down or rebooting the VM. diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.0.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.0.rst deleted file mode 100644 index fa4b969758..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.0.rst +++ /dev/null @@ -1,1025 +0,0 @@ -.. use orphan to suppress "WARNING: document isn't included in any toctree" -.. per http://sphinx-doc.org/markup/misc.html#file-wide-metadata - -:orphan: - -:title: Remote API v1.0 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -====================== -Docker Remote API v1.0 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/start HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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":"" - } - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - {{ STREAM }} - - :query t: repository name to be applied to the resulting image in case of success - :statuscode 200: no error - :statuscode 500: server error - - -Get default username and email -****************************** - -.. http:get:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - GET /auth HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "username":"hannibal", - "email":"hannibal@a-team.com" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Check auth configuration and store it -************************************* - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - POST /auth HTTP/1.1 - Content-Type: application/json - - { - "username":"hannibal", - "password:"xxxx", - "email":"hannibal@a-team.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Containers":11, - "Images":16, - "Debug":false, - "NFd": 11, - "NGoroutines":21, - "MemoryLimit":true, - "SwapLimit":false - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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/archive/docker_remote_api_v1.1.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.1.rst deleted file mode 100644 index 92b5039aa6..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.1.rst +++ /dev/null @@ -1,1035 +0,0 @@ -.. use orphan to suppress "WARNING: document isn't included in any toctree" -.. per http://sphinx-doc.org/markup/misc.html#file-wide-metadata - -:orphan: - -:title: Remote API v1.1 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -====================== -Docker Remote API v1.1 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/start HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pulling..."} - {"status":"Pulling", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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":"" - } - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - {{ STREAM }} - - :query t: tag to be applied to the resulting image in case of success - :statuscode 200: no error - :statuscode 500: server error - - -Get default username and email -****************************** - -.. http:get:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - GET /auth HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "username":"hannibal", - "email":"hannibal@a-team.com" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Check auth configuration and store it -************************************* - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - POST /auth HTTP/1.1 - Content-Type: application/json - - { - "username":"hannibal", - "password:"xxxx", - "email":"hannibal@a-team.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Containers":11, - "Images":16, - "Debug":false, - "NFd": 11, - "NGoroutines":21, - "MemoryLimit":true, - "SwapLimit":false - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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/archive/docker_remote_api_v1.2.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.2.rst deleted file mode 100644 index 80f76a3de9..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.2.rst +++ /dev/null @@ -1,1051 +0,0 @@ -.. use orphan to suppress "WARNING: document isn't included in any toctree" -.. per http://sphinx-doc.org/markup/misc.html#file-wide-metadata - -:orphan: - -:title: Remote API v1.2 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -====================== -Docker Remote API v1.2 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/start HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pulling..."} - {"status":"Pulling", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Tag":["ubuntu:latest"], - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - {{ authConfig }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 204: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - {{ STREAM }} - - :query t: repository name to be applied to the resulting image in case of success - :query remote: resource to fetch, as URI - :statuscode 200: no error - :statuscode 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 -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - POST /auth HTTP/1.1 - Content-Type: application/json - - { - "username":"hannibal", - "password:"xxxx", - "email":"hannibal@a-team.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Status": "Login Succeeded" - } - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 401: unauthorized - :statuscode 403: forbidden - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Containers":11, - "Images":16, - "Debug":false, - "NFd": 11, - "NGoroutines":21, - "MemoryLimit":true, - "SwapLimit":false - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -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" --api-enable-cors - diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.3.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.3.rst deleted file mode 100644 index 2b17a37a4d..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.3.rst +++ /dev/null @@ -1,1130 +0,0 @@ -.. use orphan to suppress "WARNING: document isn't included in any toctree" -.. per http://sphinx-doc.org/markup/misc.html#file-wide-metadata - -:orphan: - -:title: Remote API v1.3 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -====================== -Docker Remote API v1.3 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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" - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/(id)/start HTTP/1.1 - Content-Type: application/json - - { - "Binds":["/tmp:/tmp"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pulling..."} - {"status":"Pulling", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - {{ authConfig }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :statuscode 200: no error - :statuscode 500: server error - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - POST /auth HTTP/1.1 - Content-Type: application/json - - { - "username":"hannibal", - "password:"xxxx", - "email":"hannibal@a-team.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -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/archive/docker_remote_api_v1.4.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.4.rst deleted file mode 100644 index ff5aaa7a74..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.4.rst +++ /dev/null @@ -1,1176 +0,0 @@ -:title: Remote API v1.4 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.4 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 409: conflict between containers and images - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/(id)/start HTTP/1.1 - Content-Type: application/json - - { - "Binds":["/tmp:/tmp"], - "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pulling..."} - {"status":"Pulling", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict between containers and images - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - {{ authConfig }} - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :statuscode 200: no error - :statuscode 500: server error - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors - diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.5.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.5.rst deleted file mode 100644 index d4440e4423..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.5.rst +++ /dev/null @@ -1,1144 +0,0 @@ -:title: Remote API v1.5 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.5 -====================== - -.. contents:: Table of Contents - -1. Brief 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 or pull, the HTTP connection is hijacked to transport stdout stdin and stderr - -2. Endpoints -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/(id)/start HTTP/1.1 - Content-Type: application/json - - { - "Binds":["/tmp:/tmp"], - "LxcConf":[{"Key":"lxc.utsname","Value":"docker"}] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - -Wait a container -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=ubuntu HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/centos/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/fedora/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :query rm: remove intermediate containers after a successful build - :statuscode 200: no error - :statuscode 500: server error - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "PortSpecs":["22"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.6.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.6.rst deleted file mode 100644 index cfc37084b8..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.6.rst +++ /dev/null @@ -1,1282 +0,0 @@ -:title: Remote API v1.6 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.6 -====================== - -.. contents:: Table of Contents - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :query name: container name to use - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 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**: - - .. sourcecode:: http - - POST /containers/create HTTP/1.1 - Content-Type: application/json - - { - "Cmd":[ - "/usr/sbin/sshd","-D" - ], - "Image":"image-with-sshd", - "ExposedPorts":{"22/tcp":{}} - } - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - POST /containers/e90e34656806/start HTTP/1.1 - Content-Type: application/json - - { - "PortBindings": { "22/tcp": [{ "HostPort": "11022" }]} - } - - **Example response**: - - .. sourcecode:: http - - 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 -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container (integer). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/(format) - - List images ``format`` could be json or viz (json default) - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - GET /images/viz HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create an image -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :statuscode 200: no error - :statuscode 500: server error - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 registry: the registry you wan to push, optional - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http:get:: /images/search - - Search for an image in the docker index - - **Example request**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :statuscode 200: no error - :statuscode 500: server error - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - Content-Type: application/json - - { - "Cmd": ["cat", "/world"], - "ExposedPorts":{"22/tcp":{}} - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - - -3. Going further -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors - diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.7.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.7.rst deleted file mode 100644 index 7a4f688d8f..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.7.rst +++ /dev/null @@ -1,1263 +0,0 @@ -:title: Remote API v1.7 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.7 -====================== - -.. contents:: Table of Contents - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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": {} - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container (integer). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/json - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http: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**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 term: term to search - :statuscode 200: no error - :statuscode 500: server error - - -2.3 Misc --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 :ref:`ADD build command - `). - - :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :reqheader Content-type: should be set to ``"application/tar"``. - :statuscode 200: no error - :statuscode 500: server error - - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -Get a tarball containing all images and tags in a repository -************************************************************ - -.. http:get:: /images/(name)/get - - Get a tarball containing all images and metadata for the repository specified by ``name``. - - **Example request** - - .. sourcecode:: http - - 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 -******************************************************** - -.. http:post:: /images/load - - Load a set of images and tags into the docker repository. - - **Example request** - - .. sourcecode:: http - - 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 -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors - diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.8.rst b/docs/sources/reference/api/archive/docker_remote_api_v1.8.rst deleted file mode 100644 index 4f1b266bb6..0000000000 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.8.rst +++ /dev/null @@ -1,1295 +0,0 @@ -:title: Remote API v1.8 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.8 -====================== - -.. contents:: Table of Contents - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam Hostname: Container host name - :jsonparam User: Username or UID - :jsonparam Memory: Memory Limit in bytes - :jsonparam CpuShares: CPU shares (relative weight) - :jsonparam AttachStdin: 1/True/true or 0/False/false, attach to standard input. Default false - :jsonparam AttachStdout: 1/True/true or 0/False/false, attach to standard output. Default false - :jsonparam AttachStderr: 1/True/true or 0/False/false, attach to standard error. Default false - :jsonparam Tty: 1/True/true or 0/False/false, allocate a pseudo-tty. Default false - :jsonparam OpenStdin: 1/True/true or 0/False/false, keep stdin open even if not attached. Default false - :query name: Assign the specified name to the container. Must match ``/?[a-zA-Z0-9_-]+``. - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam 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. - :jsonparam LxcConf: Map of custom lxc options - :jsonparam PortBindings: Expose ports from the container, optionally publishing them via the HostPort flag - :jsonparam PublishAllPorts: 1/True/true or 0/False/false, publish all exposed ports to the host interfaces. Default false - :jsonparam Privileged: 1/True/true or 0/False/false, give extended privileges to this container. Default false - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container (integer). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/json - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http: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**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 term: term to search - :statuscode 200: no error - :statuscode 500: server error - - -2.3 Misc --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 :ref:`ADD build command - `). - - :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :reqheader Content-type: should be set to ``"application/tar"``. - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -Get a tarball containing all images and tags in a repository -************************************************************ - -.. http:get:: /images/(name)/get - - Get a tarball containing all images and metadata for the repository specified by ``name``. - - **Example request** - - .. sourcecode:: http - - 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 -******************************************************** - -.. http:post:: /images/load - - Load a set of images and tags into the docker repository. - - **Example request** - - .. sourcecode:: http - - 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 -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_io_accounts_api.rst b/docs/sources/reference/api/docker_io_accounts_api.rst deleted file mode 100644 index 1ce75ca738..0000000000 --- a/docs/sources/reference/api/docker_io_accounts_api.rst +++ /dev/null @@ -1,306 +0,0 @@ -:title: docker.io Accounts API -:description: API Documentation for docker.io accounts. -:keywords: API, Docker, accounts, REST, documentation - - -====================== -docker.io Accounts API -====================== - - -1. Endpoints -============ - - -1.1 Get a single user -^^^^^^^^^^^^^^^^^^^^^ - -.. http:get:: /api/v1.1/users/:username/ - - Get profile info for the specified user. - - :param username: username of the user whose profile info is being requested. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token. - - :statuscode 200: success, user data returned. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have ``profile_read`` scope. - :statuscode 404: the specified username does not exist. - - **Example request**: - - .. sourcecode:: http - - GET /api/v1.1/users/janedoe/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "id": 2, - "username": "janedoe", - "url": "https://www.docker.io/api/v1.1/users/janedoe/", - "date_joined": "2014-02-12T17:58:01.431312Z", - "type": "User", - "full_name": "Jane Doe", - "location": "San Francisco, CA", - "company": "Success, Inc.", - "profile_url": "https://docker.io/", - "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" - "email": "jane.doe@example.com", - "is_active": true - } - - -1.2 Update a single user -^^^^^^^^^^^^^^^^^^^^^^^^ - -.. http:patch:: /api/v1.1/users/:username/ - - Update profile info for the specified user. - - :param username: username of the user whose profile info is being updated. - - :jsonparam string full_name: (optional) the new name of the user. - :jsonparam string location: (optional) the new location. - :jsonparam string company: (optional) the new company of the user. - :jsonparam string profile_url: (optional) the new profile url. - :jsonparam string gravatar_email: (optional) the new Gravatar email address. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token. - :reqheader Content-Type: MIME Type of post data. JSON, url-encoded form data, etc. - - :statuscode 200: success, user data updated. - :statuscode 400: post data validation error. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being updated, OAuth access tokens must have ``profile_write`` scope. - :statuscode 404: the specified username does not exist. - - **Example request**: - - .. sourcecode:: http - - PATCH /api/v1.1/users/janedoe/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= - - { - "location": "Private Island", - "profile_url": "http://janedoe.com/", - "company": "Retired", - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "id": 2, - "username": "janedoe", - "url": "https://www.docker.io/api/v1.1/users/janedoe/", - "date_joined": "2014-02-12T17:58:01.431312Z", - "type": "User", - "full_name": "Jane Doe", - "location": "Private Island", - "company": "Retired", - "profile_url": "http://janedoe.com/", - "gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm" - "email": "jane.doe@example.com", - "is_active": true - } - - -1.3 List email addresses for a user -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. http:get:: /api/v1.1/users/:username/emails/ - - List email info for the specified user. - - :param username: username of the user whose profile info is being updated. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token - - :statuscode 200: success, user data updated. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have ``email_read`` scope. - :statuscode 404: the specified username does not exist. - - **Example request**: - - .. sourcecode:: http - - GET /api/v1.1/users/janedoe/emails/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "email": "jane.doe@example.com", - "verified": true, - "primary": true - } - ] - - -1.4 Add email address for a user -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. http:post:: /api/v1.1/users/:username/emails/ - - Add a new email address to the specified user's account. The email address - must be verified separately, a confirmation email is not automatically sent. - - :jsonparam string email: email address to be added. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token. - :reqheader Content-Type: MIME Type of post data. JSON, url-encoded form data, etc. - - :statuscode 201: success, new email added. - :statuscode 400: data validation error. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have ``email_write`` scope. - :statuscode 404: the specified username does not exist. - - **Example request**: - - .. sourcecode:: http - - POST /api/v1.1/users/janedoe/emails/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM - - { - "email": "jane.doe+other@example.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 Created - Content-Type: application/json - - { - "email": "jane.doe+other@example.com", - "verified": false, - "primary": false - } - - -1.5 Update an email address for a user -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. http:patch:: /api/v1.1/users/:username/emails/ - - Update an email address for the specified user to either verify an email - address or set it as the primary email for the user. You cannot use this - endpoint to un-verify an email address. You cannot use this endpoint to - unset the primary email, only set another as the primary. - - :param username: username of the user whose email info is being updated. - - :jsonparam string email: the email address to be updated. - :jsonparam boolean verified: (optional) whether the email address is verified, must be ``true`` or absent. - :jsonparam boolean primary: (optional) whether to set the email address as the primary email, must be ``true`` or absent. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token. - :reqheader Content-Type: MIME Type of post data. JSON, url-encoded form data, etc. - - :statuscode 200: success, user's email updated. - :statuscode 400: data validation error. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being updated, OAuth access tokens must have ``email_write`` scope. - :statuscode 404: the specified username or email address does not exist. - - **Example request**: - - Once you have independently verified an email address. - - .. sourcecode:: http - - PATCH /api/v1.1/users/janedoe/emails/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= - - { - "email": "jane.doe+other@example.com", - "verified": true, - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "email": "jane.doe+other@example.com", - "verified": true, - "primary": false - } - - -1.6 Delete email address for a user -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. http:delete:: /api/v1.1/users/:username/emails/ - - Delete an email address from the specified user's account. You cannot - delete a user's primary email address. - - :jsonparam string email: email address to be deleted. - - :reqheader Authorization: required authentication credentials of either type HTTP Basic or OAuth Bearer Token. - :reqheader Content-Type: MIME Type of post data. JSON, url-encoded form data, etc. - - :statuscode 204: success, email address removed. - :statuscode 400: validation error. - :statuscode 401: authentication error. - :statuscode 403: permission error, authenticated user must be the user whose data is being requested, OAuth access tokens must have ``email_write`` scope. - :statuscode 404: the specified username or email address does not exist. - - **Example request**: - - .. sourcecode:: http - - DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1 - Host: www.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM - - { - "email": "jane.doe+other@example.com" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 NO CONTENT - Content-Length: 0 diff --git a/docs/sources/reference/api/docker_io_oauth_api.rst b/docs/sources/reference/api/docker_io_oauth_api.rst deleted file mode 100644 index 24d2af3adb..0000000000 --- a/docs/sources/reference/api/docker_io_oauth_api.rst +++ /dev/null @@ -1,251 +0,0 @@ -:title: docker.io OAuth API -:description: API Documentation for docker.io's OAuth flow. -:keywords: API, Docker, oauth, REST, documentation - - -=================== -docker.io OAuth API -=================== - - -1. Brief introduction -===================== - -Some docker.io API requests will require an access token to authenticate. To -get an access token for a user, that user must first 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 `_. - -*Also note that all OAuth interactions must take place over https connections* - - -2. Register Your Application -============================ - -You will need to register your application with docker.io before users will -be able to grant your application access to their account information. We -are currently only allowing applications selectively. To request registration -of your application send an email to support-accounts@docker.com with the -following information: - -- 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 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 application. - -When your application is approved you will receive a response from the -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. - - -3. Endpoints -============ - -3.1 Get an Authorization Code -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Once You have registered you are ready to start integrating docker.io accounts -into your application! The process is usually started by a user following a -link in your application to an OAuth Authorization endpoint. - -.. http:get:: /api/v1.1/o/authorize/ - - Request that a docker.io user authorize your application. If the user is - not already logged in, they will be prompted to login. The user is then - presented with a form to authorize your application for the requested - access scope. On submission, the user will be redirected to the specified - ``redirect_uri`` with an Authorization Code. - - :query client_id: The ``client_id`` given to your application at - registration. - :query response_type: MUST be set to ``code``. This specifies that you - would like an Authorization Code returned. - :query 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. - :query scope: The extent of access permissions you are requesting. - Currently, the scope options are ``profile_read``, ``profile_write``, - ``email_read``, and ``email_write``. Scopes must be separated by a - space. If omitted, the default scopes ``profile_read email_read`` are - used. - :query state: (Recommended) Used by your application to maintain state - between the authorization request and callback to protect against CSRF - attacks. - - **Example Request** - - Asking the user for authorization. - - .. sourcecode:: http - - GET /api/v1.1/o/authorize/?client_id=TestClientID&response_type=code&redirect_uri=https%3A//my.app/auth_complete/&scope=profile_read%20email_read&state=abc123 HTTP/1.1 - Host: www.docker.io - - **Authorization Page** - - When the user follows a link, making the above GET request, they will be - asked to login to their docker.io account if they are not already and then - be presented with the following authorization prompt which asks the user - to authorize your application with a description of the requested scopes. - - .. image:: _static/io_oauth_authorization_page.png - - Once the user allows or denies your Authorization Request the user will be - redirected back to your application. Included in that request will be the - following query parameters: - - ``code`` - The Authorization code generated by the docker.io authorization server. - Present it again to request an Access Token. This code expires in 60 - seconds. - - ``state`` - If the ``state`` parameter was present in the authorization request this - will be the exact value received from that request. - - ``error`` - An error message in the event of the user denying the authorization or - some other kind of error with the request. - - -3.2 Get an Access Token -^^^^^^^^^^^^^^^^^^^^^^^ - -Once the user has authorized your application, a request will be made to your -application's specified ``redirect_uri`` which includes a ``code`` parameter -that you must then use to get an Access Token. - -.. http:post:: /api/v1.1/o/token/ - - Submit your newly granted Authorization Code and your application's - credentials to receive an Access Token and Refresh Token. The code is valid - for 60 seconds and cannot be used more than once. - - :reqheader Authorization: HTTP basic authentication using your - application's ``client_id`` and ``client_secret`` - - :form grant_type: MUST be set to ``authorization_code`` - :form code: The authorization code received from the user's redirect - request. - :form redirect_uri: The same ``redirect_uri`` used in the authentication - request. - - **Example Request** - - Using an authorization code to get an access token. - - .. sourcecode:: http - - POST /api/v1.1/o/token/ HTTP/1.1 - Host: www.docker.io - Authorization: Basic VGVzdENsaWVudElEOlRlc3RDbGllbnRTZWNyZXQ= - Accept: application/json - Content-Type: application/json - - { - "grant_type": "code", - "code": "YXV0aG9yaXphdGlvbl9jb2Rl", - "redirect_uri": "https://my.app/auth_complete/" - } - - **Example Response** - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json;charset=UTF-8 - - { - "username": "janedoe", - "user_id": 42, - "access_token": "t6k2BqgRw59hphQBsbBoPPWLqu6FmS", - "expires_in": 15552000, - "token_type": "Bearer", - "scope": "profile_read email_read", - "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc" - } - - In the case of an error, there will be a non-200 HTTP Status and and data - detailing the error. - - -3.3 Refresh a Token -^^^^^^^^^^^^^^^^^^^ - -Once the Access Token expires you can use your ``refresh_token`` to have -docker.io issue your application a new Access Token, if the user has not -revoked access from your application. - -.. http:post:: /api/v1.1/o/token/ - - Submit your ``refresh_token`` and application's credentials to receive a - new Access Token and Refresh Token. The ``refresh_token`` can be used - only once. - - :reqheader Authorization: HTTP basic authentication using your - application's ``client_id`` and ``client_secret`` - - :form grant_type: MUST be set to ``refresh_token`` - :form refresh_token: The ``refresh_token`` which was issued to your - application. - :form 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. - - **Example Request** - - Refreshing an access token. - - .. sourcecode:: http - - POST /api/v1.1/o/token/ HTTP/1.1 - Host: www.docker.io - Authorization: Basic VGVzdENsaWVudElEOlRlc3RDbGllbnRTZWNyZXQ= - Accept: application/json - Content-Type: application/json - - { - "grant_type": "refresh_token", - "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc", - } - - **Example Response** - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json;charset=UTF-8 - - { - "username": "janedoe", - "user_id": 42, - "access_token": "t6k2BqgRw59hphQBsbBoPPWLqu6FmS", - "expires_in": 15552000, - "token_type": "Bearer", - "scope": "profile_read email_read", - "refresh_token": "hJDhLH3cfsUrQlT4MxA6s8xAFEqdgc" - } - - In the case of an error, there will be a non-200 HTTP Status and and data - detailing the error. - - -4. Use an Access Token with the API -=================================== - -Many of the docker.io API requests will require a Authorization request header -field. Simply ensure you add this header with "Bearer <``access_token``>": - -.. sourcecode:: http - - GET /api/v1.1/resource HTTP/1.1 - Host: docker.io - Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA diff --git a/docs/sources/reference/api/docker_remote_api.rst b/docs/sources/reference/api/docker_remote_api.rst deleted file mode 100644 index 1e90b1bbe3..0000000000 --- a/docs/sources/reference/api/docker_remote_api.rst +++ /dev/null @@ -1,404 +0,0 @@ -:title: Remote API -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -.. COMMENT use https://pythonhosted.org/sphinxcontrib-httpdomain/ to -.. document the REST API. - -================= -Docker Remote API -================= - - -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 -- authConfig, set as the ``X-Registry-Auth`` header, is currently a Base64 encoded (json) string with credentials: - ``{'username': string, 'password': string, 'email': string, 'serveraddress' : string}`` - -2. Versions -=========== - -The current version of the API is 1.11 - -Calling /images//insert is the same as calling -/v1.11/images//insert - -You can still call an old version of the api using -/v1.11/images//insert - - -v1.11 -***** - -Full Documentation ------------------- - -:doc:`docker_remote_api_v1.11` - -What's new ----------- - -.. http:get:: /events - - **New!** You can now use the ``-until`` parameter to close connection after timestamp. - -v1.10 -***** - -Full Documentation ------------------- - -:doc:`docker_remote_api_v1.10` - -What's new ----------- - -.. http:delete:: /images/(name) - - **New!** You can now use the force parameter to force delete of an image, even if it's - tagged in multiple repositories. - **New!** You can now use the noprune parameter to prevent the deletion of parent images - -.. http:delete:: /containers/(id) - - **New!** You can now use the force paramter to force delete a container, even if - it is currently running - -v1.9 -**** - -Full Documentation ------------------- - -:doc:`docker_remote_api_v1.9` - -What's new ----------- - -.. http:post:: /build - - **New!** This endpoint now takes a serialized ConfigFile which it uses to - resolve the proper registry auth credentials for pulling the base image. - Clients which previously implemented the version accepting an AuthConfig - object must be updated. - -v1.8 -**** - -Full Documentation ------------------- - -What's new ----------- - -.. http:post:: /build - - **New!** This endpoint now returns build status as json stream. In case - of a build error, it returns the exit status of the failed command. - -.. http:get:: /containers/(id)/json - - **New!** This endpoint now returns the host config for the container. - -.. http:post:: /images/create -.. http:post:: /images/(name)/insert -.. http:post:: /images/(name)/push - - **New!** progressDetail object was added in the JSON. It's now possible - to get the current value and the total of the progress without having to - parse the string. - -v1.7 -**** - -Full Documentation ------------------- - -What's new ----------- - -.. http:get:: /images/json - - The format of the json returned from this uri changed. Instead of an entry - for each repo/tag on an image, each image is only represented once, with a - nested attribute indicating the repo/tags that apply to that image. - - Instead of: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "VirtualSize": 131506275, - "Size": 131506275, - "Created": 1365714795, - "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", - "Tag": "12.04", - "Repository": "ubuntu" - }, - { - "VirtualSize": 131506275, - "Size": 131506275, - "Created": 1365714795, - "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", - "Tag": "latest", - "Repository": "ubuntu" - }, - { - "VirtualSize": 131506275, - "Size": 131506275, - "Created": 1365714795, - "Id": "8dbd9e392a964056420e5d58ca5cc376ef18e2de93b5cc90e868a1bbc8318c1c", - "Tag": "precise", - "Repository": "ubuntu" - }, - { - "VirtualSize": 180116135, - "Size": 24653, - "Created": 1364102658, - "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", - "Tag": "12.10", - "Repository": "ubuntu" - }, - { - "VirtualSize": 180116135, - "Size": 24653, - "Created": 1364102658, - "Id": "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc", - "Tag": "quantal", - "Repository": "ubuntu" - } - ] - - The returned json looks like this: - - .. sourcecode:: http - - 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 - } - ] - -.. http:get:: /images/viz - - This URI no longer exists. The ``images --viz`` output is now generated in - the client, using the ``/images/json`` data. - -v1.6 -**** - -Full Documentation ------------------- - -What's new ----------- - -.. http:post:: /containers/(id)/attach - - **New!** You can now split stderr from stdout. This is done by prefixing - a header to each transmition. See :http:post:`/containers/(id)/attach`. - The WebSocket attach is unchanged. - Note that attach calls on the previous API version didn't change. Stdout and - stderr are merged. - - -v1.5 -**** - -Full Documentation ------------------- - -What's new ----------- - -.. http:post:: /images/create - - **New!** You can now pass registry credentials (via an AuthConfig object) - through the `X-Registry-Auth` header - -.. http:post:: /images/(name)/push - - **New!** The AuthConfig object now needs to be passed through - the `X-Registry-Auth` header - -.. http:get:: /containers/json - - **New!** The format of the `Ports` entry has been changed to a list of - dicts each containing `PublicPort`, `PrivatePort` and `Type` describing a - port mapping. - -v1.4 -**** - -Full Documentation ------------------- - -What's new ----------- - -.. http:post:: /images/create - - **New!** When pulling a repo, all images are now downloaded in parallel. - -.. http:get:: /containers/(id)/top - - **New!** You can now use ps args with docker top, like `docker top aux` - -.. http:get:: /events: - - **New!** Image's name added in the events - -v1.3 -**** - -docker v0.5.0 51f6c4a_ - -Full Documentation ------------------- - -What's new ----------- - -.. http:get:: /containers/(id)/top - - List the processes running inside a container. - -.. http:get:: /events: - - **New!** Monitor docker's events via streaming or via polling - -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 - -.. Warning:: - - The /build improvements are not reverse-compatible. Pre 1.3 clients - will break on /build. - -List containers (/containers/json): - -- 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 - -v1.2 -**** - -docker v0.4.2 2e7649b_ - -Full Documentation ------------------- - -What's new ----------- - -The auth configuration is now handled by the client. - -The client should send it's authConfig as POST on each call of -/images/(name)/push - -.. http:get:: /auth - - **Deprecated.** - -.. http:post:: /auth - - Only checks the configuration but doesn't store it on the server - - Deleting an image is now improved, will only untag the image if it - has children and remove all the untagged parents if has any. - -.. http:post:: /images//delete - - Now returns a JSON structure with the list of images - deleted/untagged. - - -v1.1 -**** - -docker v0.4.0 a8ae398_ - -Full Documentation ------------------- - -What's new ----------- - -.. http:post:: /images/create -.. http:post:: /images/(name)/insert -.. http:post:: /images/(name)/push - - Uses json stream instead of HTML hijack, it looks like this: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)"} - {"error":"Invalid..."} - ... - -v1.0 -**** - -docker v0.3.4 8d73740_ - -Full Documentation ------------------- - -What's new ----------- - -Initial version - - -.. _a8ae398: https://github.com/dotcloud/docker/commit/a8ae398bf52e97148ee7bd0d5868de2e15bd297f -.. _8d73740: https://github.com/dotcloud/docker/commit/8d73740343778651c09160cde9661f5f387b36f4 -.. _2e7649b: https://github.com/dotcloud/docker/commit/2e7649beda7c820793bd46766cbc2cfeace7b168 -.. _51f6c4a: https://github.com/dotcloud/docker/commit/51f6c4a7372450d164c61e0054daf0223ddbd909 diff --git a/docs/sources/reference/api/docker_remote_api_v1.10.rst b/docs/sources/reference/api/docker_remote_api_v1.10.rst deleted file mode 100644 index 8635ec4826..0000000000 --- a/docs/sources/reference/api/docker_remote_api_v1.10.rst +++ /dev/null @@ -1,1280 +0,0 @@ -:title: Remote API v1.10 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -======================= -Docker Remote API v1.10 -======================= - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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" - ], - "Image":"base", - "Volumes":{ - "/tmp": {} - }, - "WorkingDir":"", - "DisableNetwork": false, - "ExposedPorts":{ - "22/tcp": {} - } - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :query name: Assign the specified name to the container. Must match ``/?[a-zA-Z0-9_-]+``. - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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" - ], - "Image": "base", - "Volumes": {}, - "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 - } - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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 - "Dns": ["8.8.8.8"], - "VolumesFrom: ["parent", "other:ro"] - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container, must be integer or string (i.e. SIGINT). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :query force: 1/True/true or 0/False/false, Removes the container even if it was running. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/json - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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"] - "Image":"base", - "Volumes":null, - "WorkingDir":"" - }, - "Size": 6824592 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :query force: 1/True/true or 0/False/false, default false - :query noprune: 1/True/true or 0/False/false, default false - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http: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**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 term: term to search - :statuscode 200: no error - :statuscode 500: server error - - -2.3 Misc --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 :ref:`ADD build command - `). - - :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :reqheader Content-type: should be set to ``"application/tar"``. - :reqheader X-Registry-Config: base64-encoded ConfigFile object - :statuscode 200: no error - :statuscode 500: server error - - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -Get a tarball containing all images and tags in a repository -************************************************************ - -.. http:get:: /images/(name)/get - - Get a tarball containing all images and metadata for the repository specified by ``name``. - - **Example request** - - .. sourcecode:: http - - 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 -******************************************************** - -.. http:post:: /images/load - - Load a set of images and tags into the docker repository. - - **Example request** - - .. sourcecode:: http - - 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 -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.rst b/docs/sources/reference/api/docker_remote_api_v1.11.rst deleted file mode 100644 index d66b4b1410..0000000000 --- a/docs/sources/reference/api/docker_remote_api_v1.11.rst +++ /dev/null @@ -1,1285 +0,0 @@ -:title: Remote API v1.11 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -======================= -Docker Remote API v1.11 -======================= - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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":"", - "DisableNetwork": false, - "ExposedPorts":{ - "22/tcp": {} - } - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam config: the container's configuration - :query name: Assign the specified name to the container. Must match ``/?[a-zA-Z0-9_-]+``. - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam hostConfig: the container's host configuration (optional) - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container, must be integer or string (i.e. SIGINT). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :query force: 1/True/true or 0/False/false, Removes the container even if it was running. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/json - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :query force: 1/True/true or 0/False/false, default false - :query noprune: 1/True/true or 0/False/false, default false - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http: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**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 term: term to search - :statuscode 200: no error - :statuscode 500: server error - - -2.3 Misc --------- - -Build an image from Dockerfile via stdin -**************************************** - -.. http:post:: /build - - Build an image from Dockerfile via stdin - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 :ref:`ADD build command - `). - - :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :reqheader Content-type: should be set to ``"application/tar"``. - :reqheader X-Registry-Config: base64-encoded ConfigFile object - :statuscode 200: no error - :statuscode 500: server error - - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :query until: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -Get a tarball containing all images and tags in a repository -************************************************************ - -.. http:get:: /images/(name)/get - - Get a tarball containing all images and metadata for the repository specified by ``name``. - - **Example request** - - .. sourcecode:: http - - 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 -******************************************************** - -.. http:post:: /images/load - - Load a set of images and tags into the docker repository. - - **Example request** - - .. sourcecode:: http - - 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 -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.9.rst b/docs/sources/reference/api/docker_remote_api_v1.9.rst deleted file mode 100644 index db0e3bfdae..0000000000 --- a/docs/sources/reference/api/docker_remote_api_v1.9.rst +++ /dev/null @@ -1,1294 +0,0 @@ -:title: Remote API v1.9 -:description: API Documentation for Docker -:keywords: API, Docker, rcli, REST, documentation - -:orphan: - -====================== -Docker Remote API v1.9 -====================== - -1. Brief introduction -===================== - -- The Remote API has replaced rcli -- The daemon listens on ``unix:///var/run/docker.sock``, but you can - :ref:`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 -============ - -2.1 Containers --------------- - -List containers -*************** - -.. http:get:: /containers/json - - List containers - - **Example request**: - - .. sourcecode:: http - - GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 all: 1/True/true or 0/False/false, Show all containers. Only running containers are shown by default - :query limit: Show ``limit`` last created containers, include non-running ones. - :query since: Show only containers created since Id, include non-running ones. - :query before: Show only containers created before Id, include non-running ones. - :query size: 1/True/true or 0/False/false, Show the containers sizes - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 500: server error - - -Create a container -****************** - -.. http:post:: /containers/create - - Create a container - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/json - - { - "Id":"e90e34656806" - "Warnings":[] - } - - :jsonparam Hostname: Container host name - :jsonparam User: Username or UID - :jsonparam Memory: Memory Limit in bytes - :jsonparam CpuShares: CPU shares (relative weight) - :jsonparam AttachStdin: 1/True/true or 0/False/false, attach to standard input. Default false - :jsonparam AttachStdout: 1/True/true or 0/False/false, attach to standard output. Default false - :jsonparam AttachStderr: 1/True/true or 0/False/false, attach to standard error. Default false - :jsonparam Tty: 1/True/true or 0/False/false, allocate a pseudo-tty. Default false - :jsonparam OpenStdin: 1/True/true or 0/False/false, keep stdin open even if not attached. Default false - :query name: Assign the specified name to the container. Must match ``/?[a-zA-Z0-9_-]+``. - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 406: impossible to attach (container not running) - :statuscode 500: server error - - -Inspect a container -******************* - -.. http:get:: /containers/(id)/json - - Return low-level information on the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - } - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -List processes running inside a container -***************************************** - -.. http:get:: /containers/(id)/top - - List processes running inside the container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/top HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 ps_args: ps arguments to use (eg. aux) - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Inspect changes on a container's filesystem -******************************************* - -.. http:get:: /containers/(id)/changes - - Inspect changes on container ``id`` 's filesystem - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/changes HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Path":"/dev", - "Kind":0 - }, - { - "Path":"/dev/kmsg", - "Kind":1 - }, - { - "Path":"/test", - "Kind":1 - } - ] - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Export a container -****************** - -.. http:get:: /containers/(id)/export - - Export the contents of container ``id`` - - **Example request**: - - .. sourcecode:: http - - GET /containers/4fa6e0f0c678/export HTTP/1.1 - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Start a container -***************** - -.. http:post:: /containers/(id)/start - - Start the container ``id`` - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 204 No Content - Content-Type: text/plain - - :jsonparam 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. - :jsonparam LxcConf: Map of custom lxc options - :jsonparam PortBindings: Expose ports from the container, optionally publishing them via the HostPort flag - :jsonparam PublishAllPorts: 1/True/true or 0/False/false, publish all exposed ports to the host interfaces. Default false - :jsonparam Privileged: 1/True/true or 0/False/false, give extended privileges to this container. Default false - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Stop a container -**************** - -.. http:post:: /containers/(id)/stop - - Stop the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/stop?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Restart a container -******************* - -.. http:post:: /containers/(id)/restart - - Restart the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/restart?t=5 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query t: number of seconds to wait before killing the container - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Kill a container -**************** - -.. http:post:: /containers/(id)/kill - - Kill the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/e90e34656806/kill HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query signal: Signal to send to the container, must be integer or string (i.e. SIGINT). When not set, SIGKILL is assumed and the call will waits for the container to exit. - :statuscode 204: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Attach to a container -********************* - -.. http:post:: /containers/(id)/attach - - Attach to the container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/vnd.docker.raw-stream - - {{ STREAM }} - - :query logs: 1/True/true or 0/False/false, return logs. Default false - :query stream: 1/True/true or 0/False/false, return stream. Default false - :query stdin: 1/True/true or 0/False/false, if stream=true, attach to stdin. Default false - :query stdout: 1/True/true or 0/False/false, if logs=true, return stdout log, if stream=true, attach to stdout. Default false - :query stderr: 1/True/true or 0/False/false, if logs=true, return stderr log, if stream=true, attach to stderr. Default false - :statuscode 200: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - **Stream details**: - - When using the TTY setting is enabled in - :http: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 -**************** - -.. http:post:: /containers/(id)/wait - - Block until container ``id`` stops, then returns the exit code - - **Example request**: - - .. sourcecode:: http - - POST /containers/16253994b7c4/wait HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"StatusCode":0} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Remove a container -******************* - -.. http:delete:: /containers/(id) - - Remove the container ``id`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /containers/16253994b7c4?v=1 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 204 OK - - :query v: 1/True/true or 0/False/false, Remove the volumes associated to the container. Default false - :statuscode 204: no error - :statuscode 400: bad parameter - :statuscode 404: no such container - :statuscode 500: server error - - -Copy files or folders from a container -************************************** - -.. http:post:: /containers/(id)/copy - - Copy files or folders of container ``id`` - - **Example request**: - - .. sourcecode:: http - - POST /containers/4fa6e0f0c678/copy HTTP/1.1 - Content-Type: application/json - - { - "Resource":"test.txt" - } - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/octet-stream - - {{ STREAM }} - - :statuscode 200: no error - :statuscode 404: no such container - :statuscode 500: server error - - -2.2 Images ----------- - -List Images -*********** - -.. http:get:: /images/json - - **Example request**: - - .. sourcecode:: http - - GET /images/json?all=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 -*************** - -.. http:post:: /images/create - - Create an image, either by pull it from the registry or by importing it - - **Example request**: - - .. sourcecode:: http - - POST /images/create?fromImage=base HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 fromImage: name of the image to pull - :query fromSrc: source to import, - means stdin - :query repo: repository - :query tag: tag - :query registry: the registry to pull from - :reqheader X-Registry-Auth: base64-encoded AuthConfig object - :statuscode 200: no error - :statuscode 500: server error - - - -Insert a file in an image -************************* - -.. http:post:: /images/(name)/insert - - Insert a file from ``url`` in the image ``name`` at ``path`` - - **Example request**: - - .. sourcecode:: http - - POST /images/test/insert?path=/usr&url=myurl HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Inserting..."} - {"status":"Inserting", "progress":"1/? (n/a)", "progressDetail":{"current":1}} - {"error":"Invalid..."} - ... - - :statuscode 200: no error - :statuscode 500: server error - - -Inspect an image -**************** - -.. http:get:: /images/(name)/json - - Return low-level information on the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/json HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Get the history of an image -*************************** - -.. http:get:: /images/(name)/history - - Return the history of the image ``name`` - - **Example request**: - - .. sourcecode:: http - - GET /images/base/history HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - [ - { - "Id":"b750fe79269d", - "Created":1364102658, - "CreatedBy":"/bin/bash" - }, - { - "Id":"27cf78414709", - "Created":1364068391, - "CreatedBy":"" - } - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Push an image on the registry -***************************** - -.. http:post:: /images/(name)/push - - Push the image ``name`` on the registry - - **Example request**: - - .. sourcecode:: http - - POST /images/test/push HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - {"status":"Pushing..."} - {"status":"Pushing", "progress":"1/? (n/a)", "progressDetail":{"current":1}}} - {"error":"Invalid..."} - ... - - :query registry: the registry you wan to push, optional - :reqheader X-Registry-Auth: include a base64-encoded AuthConfig object. - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 500: server error - - -Tag an image into a repository -****************************** - -.. http:post:: /images/(name)/tag - - Tag the image ``name`` into a repository - - **Example request**: - - .. sourcecode:: http - - POST /images/test/tag?repo=myrepo&force=0 HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - - :query repo: The repository to tag in - :query force: 1/True/true or 0/False/false, default false - :statuscode 201: no error - :statuscode 400: bad parameter - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Remove an image -*************** - -.. http:delete:: /images/(name) - - Remove the image ``name`` from the filesystem - - **Example request**: - - .. sourcecode:: http - - DELETE /images/test HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-type: application/json - - [ - {"Untagged":"3e2f21a89f"}, - {"Deleted":"3e2f21a89f"}, - {"Deleted":"53b4f83ac9"} - ] - - :statuscode 200: no error - :statuscode 404: no such image - :statuscode 409: conflict - :statuscode 500: server error - - -Search images -************* - -.. http: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**: - - .. sourcecode:: http - - GET /images/search?term=sshd HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 term: term to search - :statuscode 200: no error - :statuscode 500: server error - - -2.3 Misc --------- - -Build an image from Dockerfile -****************************** - -.. http:post:: /build - - Build an image from Dockerfile using a POST body. - - **Example request**: - - .. sourcecode:: http - - POST /build HTTP/1.1 - - {{ STREAM }} - - **Example response**: - - .. sourcecode:: http - - 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 :ref:`ADD build command - `). - - :query t: repository name (and optionally a tag) to be applied to the resulting image in case of success - :query q: suppress verbose build output - :query nocache: do not use the cache when building the image - :query rm: Remove intermediate containers after a successful build - :reqheader Content-type: should be set to ``"application/tar"``. - :reqheader X-Registry-Config: base64-encoded ConfigFile object - :statuscode 200: no error - :statuscode 500: server error - - - -Check auth configuration -************************ - -.. http:post:: /auth - - Get the default username and email - - **Example request**: - - .. sourcecode:: http - - 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**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - - :statuscode 200: no error - :statuscode 204: no error - :statuscode 500: server error - - -Display system-wide information -******************************* - -.. http:get:: /info - - Display system-wide information - - **Example request**: - - .. sourcecode:: http - - GET /info HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - 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 - } - - :statuscode 200: no error - :statuscode 500: server error - - -Show the docker version information -*********************************** - -.. http:get:: /version - - Show the docker version information - - **Example request**: - - .. sourcecode:: http - - GET /version HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Content-Type: application/json - - { - "Version":"0.2.2", - "GitCommit":"5a2a5cc+CHANGES", - "GoVersion":"go1.0.3" - } - - :statuscode 200: no error - :statuscode 500: server error - - -Create a new image from a container's changes -********************************************* - -.. http:post:: /commit - - Create a new image from a container's changes - - **Example request**: - - .. sourcecode:: http - - POST /commit?container=44c004db4b17&m=message&repo=myrepo HTTP/1.1 - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Content-Type: application/vnd.docker.raw-stream - - {"Id":"596069db4bf5"} - - :query container: source container - :query repo: repository - :query tag: tag - :query m: commit message - :query author: author (eg. "John Hannibal Smith ") - :query run: config automatically applied when the image is run. (ex: {"Cmd": ["cat", "/world"], "PortSpecs":["22"]}) - :statuscode 201: no error - :statuscode 404: no such container - :statuscode 500: server error - - -Monitor Docker's events -*********************** - -.. http:get:: /events - - Get events from docker, either in real time via streaming, or via polling (using `since`) - - **Example request**: - - .. sourcecode:: http - - GET /events?since=1374067924 - - **Example response**: - - .. sourcecode:: http - - 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 since: timestamp used for polling - :statuscode 200: no error - :statuscode 500: server error - -Get a tarball containing all images and tags in a repository -************************************************************ - -.. http:get:: /images/(name)/get - - Get a tarball containing all images and metadata for the repository specified by ``name``. - - **Example request** - - .. sourcecode:: http - - 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 -******************************************************** - -.. http:post:: /images/load - - Load a set of images and tags into the docker repository. - - **Example request** - - .. sourcecode:: http - - 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 -================ - -3.1 Inside 'docker run' ------------------------ - -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 -------------- - -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 ------------------ - -To enable cross origin requests to the remote api add the flag "--api-enable-cors" when running docker in daemon mode. - -.. code-block:: bash - - docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/index.rst b/docs/sources/reference/api/index.rst deleted file mode 100644 index 3c84a505c6..0000000000 --- a/docs/sources/reference/api/index.rst +++ /dev/null @@ -1,20 +0,0 @@ -:title: API Documentation -:description: docker documentation -:keywords: docker, ipa, documentation - -APIs -==== - -Your programs and scripts can access Docker's functionality via these interfaces: - -.. toctree:: - :maxdepth: 3 - - registry_index_spec - registry_api - index_api - docker_remote_api - remote_api_client_libraries - docker_io_oauth_api - docker_io_accounts_api - diff --git a/docs/sources/reference/api/index_api.rst b/docs/sources/reference/api/index_api.rst deleted file mode 100644 index 5191fc8992..0000000000 --- a/docs/sources/reference/api/index_api.rst +++ /dev/null @@ -1,556 +0,0 @@ -:title: Index API -:description: API Documentation for Docker Index -:keywords: API, Docker, index, REST, documentation - -================= -Docker Index API -================= - -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. - -2. Endpoints -============ - -2.1 Repository -^^^^^^^^^^^^^^ - -Repositories -************* - -User Repo -~~~~~~~~~ - -.. http:put:: /v1/repositories/(namespace)/(repo_name)/ - - Create a user repository with the given ``namespace`` and ``repo_name``. - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foo/bar/ HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - X-Docker-Token: true - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f"}] - - :parameter namespace: the namespace for the repo - :parameter repo_name: the name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - WWW-Authenticate: Token signature=123abc,repository="foo/bar",access=write - X-Docker-Token: signature=123abc,repository="foo/bar",access=write - X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] - - "" - - :statuscode 200: Created - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - - -.. http:delete:: /v1/repositories/(namespace)/(repo_name)/ - - Delete a user repository with the given ``namespace`` and ``repo_name``. - - **Example Request**: - - .. sourcecode:: http - - DELETE /v1/repositories/foo/bar/ HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - X-Docker-Token: true - - "" - - :parameter namespace: the namespace for the repo - :parameter repo_name: the name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 202 - Vary: Accept - Content-Type: application/json - WWW-Authenticate: Token signature=123abc,repository="foo/bar",access=delete - X-Docker-Token: signature=123abc,repository="foo/bar",access=delete - X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] - - "" - - :statuscode 200: Deleted - :statuscode 202: Accepted - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - -Library Repo -~~~~~~~~~~~~ - -.. http:put:: /v1/repositories/(repo_name)/ - - Create a library repository with the given ``repo_name``. - This is a restricted feature only available to docker admins. - - When namespace is missing, it is assumed to be ``library`` - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foobar/ HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - X-Docker-Token: true - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f"}] - - :parameter repo_name: the library name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - WWW-Authenticate: Token signature=123abc,repository="library/foobar",access=write - X-Docker-Token: signature=123abc,repository="foo/bar",access=write - X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] - - "" - - :statuscode 200: Created - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - -.. http:delete:: /v1/repositories/(repo_name)/ - - Delete a library repository with the given ``repo_name``. - This is a restricted feature only available to docker admins. - - When namespace is missing, it is assumed to be ``library`` - - **Example Request**: - - .. sourcecode:: http - - DELETE /v1/repositories/foobar/ HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - X-Docker-Token: true - - "" - - :parameter repo_name: the library name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 202 - Vary: Accept - Content-Type: application/json - WWW-Authenticate: Token signature=123abc,repository="library/foobar",access=delete - X-Docker-Token: signature=123abc,repository="foo/bar",access=delete - X-Docker-Endpoints: registry-1.docker.io [, registry-2.docker.io] - - "" - - :statuscode 200: Deleted - :statuscode 202: Accepted - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - -Repository Images -***************** - -User Repo Images -~~~~~~~~~~~~~~~~ - -.. http:put:: /v1/repositories/(namespace)/(repo_name)/images - - Update the images for a user repo. - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foo/bar/images HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}] - - :parameter namespace: the namespace for the repo - :parameter repo_name: the name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 204 - Vary: Accept - Content-Type: application/json - - "" - - :statuscode 204: Created - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active or permission denied - - -.. http:get:: /v1/repositories/(namespace)/(repo_name)/images - - get the images for a user repo. - - **Example Request**: - - .. sourcecode:: http - - GET /v1/repositories/foo/bar/images HTTP/1.1 - Host: index.docker.io - Accept: application/json - - :parameter namespace: the namespace for the repo - :parameter repo_name: the name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}, - {"id": "ertwetewtwe38722009fe6857087b486531f9a779a0c1dfddgfgsdgdsgds", - "checksum": "34t23f23fc17e3ed29dae8f12c4f9e89cc6f0bsdfgfsdgdsgdsgerwgew"}] - - :statuscode 200: OK - :statuscode 404: Not found - -Library Repo Images -~~~~~~~~~~~~~~~~~~~ - -.. http:put:: /v1/repositories/(repo_name)/images - - Update the images for a library repo. - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foobar/images HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}] - - :parameter repo_name: the library name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 204 - Vary: Accept - Content-Type: application/json - - "" - - :statuscode 204: Created - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active or permission denied - - -.. http:get:: /v1/repositories/(repo_name)/images - - get the images for a library repo. - - **Example Request**: - - .. sourcecode:: http - - GET /v1/repositories/foobar/images HTTP/1.1 - Host: index.docker.io - Accept: application/json - - :parameter repo_name: the library name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - - [{"id": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - "checksum": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087"}, - {"id": "ertwetewtwe38722009fe6857087b486531f9a779a0c1dfddgfgsdgdsgds", - "checksum": "34t23f23fc17e3ed29dae8f12c4f9e89cc6f0bsdfgfsdgdsgdsgerwgew"}] - - :statuscode 200: OK - :statuscode 404: Not found - - -Repository Authorization -************************ - -Library Repo -~~~~~~~~~~~~ - -.. http:put:: /v1/repositories/(repo_name)/auth - - authorize a token for a library repo - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foobar/auth HTTP/1.1 - Host: index.docker.io - Accept: application/json - Authorization: Token signature=123abc,repository="library/foobar",access=write - - :parameter repo_name: the library name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - - "OK" - - :statuscode 200: OK - :statuscode 403: Permission denied - :statuscode 404: Not found - - -User Repo -~~~~~~~~~ - -.. http:put:: /v1/repositories/(namespace)/(repo_name)/auth - - authorize a token for a user repo - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foo/bar/auth HTTP/1.1 - Host: index.docker.io - Accept: application/json - Authorization: Token signature=123abc,repository="foo/bar",access=write - - :parameter namespace: the namespace for the repo - :parameter repo_name: the name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - - "OK" - - :statuscode 200: OK - :statuscode 403: Permission denied - :statuscode 404: Not found - - -2.2 Users -^^^^^^^^^ - -User Login -********** - -.. http:get:: /v1/users - - If you want to check your login, you can try this endpoint - - **Example Request**: - - .. sourcecode:: http - - GET /v1/users HTTP/1.1 - Host: index.docker.io - Accept: application/json - Authorization: Basic akmklmasadalkm== - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Vary: Accept - Content-Type: application/json - - OK - - :statuscode 200: no error - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - - -User Register -************* - -.. http:post:: /v1/users - - Registering a new account. - - **Example request**: - - .. sourcecode:: http - - POST /v1/users HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - - {"email": "sam@dotcloud.com", - "password": "toto42", - "username": "foobar"'} - - :jsonparameter email: valid email address, that needs to be confirmed - :jsonparameter username: min 4 character, max 30 characters, must match the regular expression [a-z0-9\_]. - :jsonparameter password: min 5 characters - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 201 OK - Vary: Accept - Content-Type: application/json - - "User Created" - - :statuscode 201: User Created - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - -Update User -*********** - -.. http:put:: /v1/users/(username)/ - - Change a password or email address for given user. If you pass in an email, - it will add it to your account, it will not remove the old one. Passwords will - be updated. - - It is up to the client to verify that that password that is sent is the one that - they want. Common approach is to have them type it twice. - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/users/fakeuser/ HTTP/1.1 - Host: index.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Basic akmklmasadalkm== - - {"email": "sam@dotcloud.com", - "password": "toto42"} - - :parameter username: username for the person you want to update - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 204 - Vary: Accept - Content-Type: application/json - - "" - - :statuscode 204: User Updated - :statuscode 400: Errors (invalid json, missing or invalid fields, etc) - :statuscode 401: Unauthorized - :statuscode 403: Account is not Active - :statuscode 404: User not found - - -2.3 Search -^^^^^^^^^^ -If you need to search the index, this is the endpoint you would use. - -Search -****** - -.. http:get:: /v1/search - - Search the Index given a search term. It accepts :http:method:`get` only. - - **Example request**: - - .. sourcecode:: http - - GET /v1/search?q=search_term HTTP/1.1 - Host: example.com - Accept: application/json - - - **Example response**: - - .. sourcecode:: http - - HTTP/1.1 200 OK - Vary: Accept - Content-Type: application/json - - {"query":"search_term", - "num_results": 3, - "results" : [ - {"name": "ubuntu", "description": "An ubuntu image..."}, - {"name": "centos", "description": "A centos image..."}, - {"name": "fedora", "description": "A fedora image..."} - ] - } - - :query q: what you want to search for - :statuscode 200: no error - :statuscode 500: server error diff --git a/docs/sources/reference/api/registry_api.rst b/docs/sources/reference/api/registry_api.rst deleted file mode 100644 index b5c36cc344..0000000000 --- a/docs/sources/reference/api/registry_api.rst +++ /dev/null @@ -1,504 +0,0 @@ -:title: Registry API -:description: API Documentation for Docker Registry -:keywords: API, Docker, index, registry, REST, documentation - -=================== -Docker Registry API -=================== - - -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 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 - -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 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 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, 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 for anyone), others private (accessible only for authorized users). Authentication and authorization would be delegated to the Index. The goal of vendor registries is to let someone do “docker pull 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, 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:: - - Mirror registries and private registries which do not use the Index don’t even need to run the registry code. They can be implemented by any kind of transport implementing HTTP GET and PUT. Read-only registries 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. - -The latter would only require two new commands in docker, e.g. ``registryget`` -and ``registryput``, wrapping access to the local filesystem (and optionally -doing consistency checks). Authentication and authorization are then delegated -to SSH (e.g. with public keys). - -2. Endpoints -============ - -2.1 Images ----------- - -Layer -***** - -.. http:get:: /v1/images/(image_id)/layer - - get image layer for a given ``image_id`` - - **Example Request**: - - .. sourcecode:: http - - GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Authorization: Token signature=123abc,repository="foo/bar",access=read - - :parameter image_id: the id for the layer you want to get - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - X-Docker-Registry-Version: 0.6.0 - Cookie: (Cookie provided by the Registry) - - {layer binary data stream} - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Image not found - - -.. http:put:: /v1/images/(image_id)/layer - - put image layer for a given ``image_id`` - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/layer HTTP/1.1 - Host: registry-1.docker.io - Transfer-Encoding: chunked - Authorization: Token signature=123abc,repository="foo/bar",access=write - - {layer binary data stream} - - :parameter image_id: the id for the layer you want to get - - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Image not found - - -Image -***** - -.. http:put:: /v1/images/(image_id)/json - - put image for a given ``image_id`` - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - { - id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", - parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", - created: "2013-04-30T17:46:10.843673+03:00", - container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", - container_config: { - Hostname: "host-test", - User: "", - Memory: 0, - MemorySwap: 0, - AttachStdin: false, - AttachStdout: false, - AttachStderr: false, - PortSpecs: null, - Tty: false, - OpenStdin: false, - StdinOnce: false, - Env: null, - Cmd: [ - "/bin/bash", - "-c", - "apt-get -q -yy -f install libevent-dev" - ], - Dns: null, - Image: "imagename/blah", - Volumes: { }, - VolumesFrom: "" - }, - docker_version: "0.1.7" - } - - :parameter image_id: the id for the layer you want to get - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - :statuscode 401: Requires authorization - -.. http:get:: /v1/images/(image_id)/json - - get image for a given ``image_id`` - - **Example Request**: - - .. sourcecode:: http - - GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/json HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - :parameter image_id: the id for the layer you want to get - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - X-Docker-Size: 456789 - X-Docker-Checksum: b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087 - - { - id: "088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c", - parent: "aeee6396d62273d180a49c96c62e45438d87c7da4a5cf5d2be6bee4e21bc226f", - created: "2013-04-30T17:46:10.843673+03:00", - container: "8305672a76cc5e3d168f97221106ced35a76ec7ddbb03209b0f0d96bf74f6ef7", - container_config: { - Hostname: "host-test", - User: "", - Memory: 0, - MemorySwap: 0, - AttachStdin: false, - AttachStdout: false, - AttachStderr: false, - PortSpecs: null, - Tty: false, - OpenStdin: false, - StdinOnce: false, - Env: null, - Cmd: [ - "/bin/bash", - "-c", - "apt-get -q -yy -f install libevent-dev" - ], - Dns: null, - Image: "imagename/blah", - Volumes: { }, - VolumesFrom: "" - }, - docker_version: "0.1.7" - } - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Image not found - - -Ancestry -******** - -.. http:get:: /v1/images/(image_id)/ancestry - - get ancestry for an image given an ``image_id`` - - **Example Request**: - - .. sourcecode:: http - - GET /v1/images/088b4505aa3adc3d35e79c031fa126b403200f02f51920fbd9b7c503e87c7a2c/ancestry HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - :parameter image_id: the id for the layer you want to get - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - ["088b4502f51920fbd9b7c503e87c7a2c05aa3adc3d35e79c031fa126b403200f", - "aeee63968d87c7da4a5cf5d2be6bee4e21bc226fd62273d180a49c96c62e4543", - "bfa4c5326bc764280b0863b46a4b20d940bc1897ef9c1dfec060604bdc383280", - "6ab5893c6927c15a15665191f2c6cf751f5056d8b95ceee32e43c5e8a3648544"] - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Image not found - - -2.2 Tags --------- - -.. http:get:: /v1/repositories/(namespace)/(repository)/tags - - get all of the tags for the given repo. - - **Example Request**: - - .. sourcecode:: http - - GET /v1/repositories/foo/bar/tags HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - Cookie: (Cookie provided by the Registry) - - :parameter namespace: namespace for the repo - :parameter repository: name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - { - "latest": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - "0.1.1": "b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087" - } - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Repository not found - - -.. http:get:: /v1/repositories/(namespace)/(repository)/tags/(tag) - - get a tag for the given repo. - - **Example Request**: - - .. sourcecode:: http - - GET /v1/repositories/foo/bar/tags/latest HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - Cookie: (Cookie provided by the Registry) - - :parameter namespace: namespace for the repo - :parameter repository: name for the repo - :parameter tag: name of tag you want to get - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Tag not found - -.. http:delete:: /v1/repositories/(namespace)/(repository)/tags/(tag) - - delete the tag for the repo - - **Example Request**: - - .. sourcecode:: http - - DELETE /v1/repositories/foo/bar/tags/latest HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - :parameter namespace: namespace for the repo - :parameter repository: name for the repo - :parameter tag: name of tag you want to delete - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Tag not found - - -.. http:put:: /v1/repositories/(namespace)/(repository)/tags/(tag) - - put a tag for the given repo. - - **Example Request**: - - .. sourcecode:: http - - PUT /v1/repositories/foo/bar/tags/latest HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" - - :parameter namespace: namespace for the repo - :parameter repository: name for the repo - :parameter tag: name of tag you want to add - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - :statuscode 400: Invalid data - :statuscode 401: Requires authorization - :statuscode 404: Image not found - -2.3 Repositories ----------------- - -.. http:delete:: /v1/repositories/(namespace)/(repository)/ - - delete a repository - - **Example Request**: - - .. sourcecode:: http - - DELETE /v1/repositories/foo/bar/ HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - Cookie: (Cookie provided by the Registry) - - "" - - :parameter namespace: namespace for the repo - :parameter repository: name for the repo - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - :statuscode 401: Requires authorization - :statuscode 404: Repository not found - -2.4 Status ----------- - -.. http:get:: /v1/_ping - - Check status of the registry. This endpoint is also used to determine if - the registry supports SSL. - - **Example Request**: - - .. sourcecode:: http - - GET /v1/_ping HTTP/1.1 - Host: registry-1.docker.io - Accept: application/json - Content-Type: application/json - - "" - - **Example Response**: - - .. sourcecode:: http - - HTTP/1.1 200 - Vary: Accept - Content-Type: application/json - X-Docker-Registry-Version: 0.6.0 - - "" - - :statuscode 200: OK - - -3 Authorization -=============== -This is where we describe the authorization process, including the tokens and cookies. - -TODO: add more info. diff --git a/docs/sources/reference/api/registry_index_spec.rst b/docs/sources/reference/api/registry_index_spec.rst deleted file mode 100644 index 89f6319f5c..0000000000 --- a/docs/sources/reference/api/registry_index_spec.rst +++ /dev/null @@ -1,622 +0,0 @@ -:title: Registry Documentation -:description: Documentation for docker Registry and Registry API -:keywords: docker, registry, api, index - -.. _registryindexspec: - -===================== -Registry & Index Spec -===================== - -1. The 3 roles -=============== - -1.1 Index ---------- - -The Index is responsible for centralizing information about: - -- 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 - -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. - -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 service using tokens -- It supports different storage backends (S3, cloud files, local FS) -- It doesn’t have a local database -- `Source Code `_ - -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 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 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, 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 for anyone), others private (accessible only for authorized users). Authentication and authorization would be delegated to the Index. The goal of vendor registries is to let someone do “docker pull 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, 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. - -The latter would only require two new commands in docker, e.g. ``registryget`` -and ``registryput``, wrapping access to the local filesystem (and optionally -doing consistency checks). Authentication and authorization are then delegated -to SSH (e.g. with public keys). - -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 - -2. Workflow -=========== - -2.1 Pull --------- - -.. image:: /static_files/docker_pull_chart.png - -1. Contact the Index to know where I should download “samalba/busybox” -2. Index replies: - a. ``samalba/busybox`` is on Registry A - b. here are the checksums for ``samalba/busybox`` (for all layers) - c. token -3. Contact Registry A to receive the layers for ``samalba/busybox`` (all of them to the base image). Registry A is authoritative for “samalba/busybox” but keeps a copy of all inherited layers and serve them all from the same location. -4. registry contacts index to verify if token/user is allowed to download images -5. Index returns true/false lettings registry know if it should proceed or error out -6. Get the payload for all layers - -It's possible to run: - -.. code-block:: bash - - docker pull https:///repositories/samalba/busybox - -In this case, Docker bypasses the Index. However the security is not guaranteed -(in case Registry A is corrupted) because there won’t be any checksum checks. - -Currently registry redirects to s3 urls for downloads, going forward all -downloads need to be streamed through the registry. The Registry will then -abstract the calls to S3 by a top-level class which implements sub-classes for -S3 and local storage. - -Token is only returned when the ``X-Docker-Token`` header is sent with request. - -Basic Auth is required to pull private repos. Basic auth isn't required for -pulling public repos, but if one is provided, it needs to be valid and for an -active account. - -API (pulling repository foo/bar): -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -1. (Docker -> Index) GET /v1/repositories/foo/bar/images - **Headers**: - Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== - X-Docker-Token: true - **Action**: - (looking up the foo/bar in db and gets images and checksums for that repo (all if no tag is specified, if tag, only checksums for those tags) see part 4.4.1) - -2. (Index -> Docker) HTTP 200 OK - - **Headers**: - - Authorization: Token signature=123abc,repository=”foo/bar”,access=write - - X-Docker-Endpoints: registry.docker.io [, registry2.docker.io] - **Body**: - Jsonified checksums (see part 4.4.1) - -3. (Docker -> Registry) GET /v1/repositories/foo/bar/tags/latest - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=write - -4. (Registry -> Index) GET /v1/repositories/foo/bar/images - - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=read - - **Body**: - - - **Action**: - ( Lookup token see if they have access to pull.) - - If good: - HTTP 200 OK - Index will invalidate the token - If bad: - HTTP 401 Unauthorized - -5. (Docker -> Registry) GET /v1/images/928374982374/ancestry - **Action**: - (for each image id returned in the registry, fetch /json + /layer) - -.. note:: - - If someone makes a second request, then we will always give a new token, never reuse tokens. - -2.2 Push --------- - -.. image:: /static_files/docker_push_chart.png - -1. Contact the index to allocate the repository name “samalba/busybox” (authentication required with user credentials) -2. If authentication works and namespace available, “samalba/busybox” is allocated and a temporary token is returned (namespace is marked as initialized in index) -3. Push the image on the registry (along with the token) -4. Registry A contacts the Index to verify the token (token must corresponds to the repository name) -5. Index validates the token. Registry A starts reading the stream 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:: - - **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, it means -that the push is in progress (since checksums are submitted at the end). - -API (pushing repos foo/bar): -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -1. (Docker -> Index) PUT /v1/repositories/foo/bar/ - **Headers**: - Authorization: Basic sdkjfskdjfhsdkjfh== - X-Docker-Token: true - - **Action**:: - - in index, we allocated a new repository, and set to initialized - - **Body**:: - (The body contains the list of images that are going to be pushed, with empty checksums. The checksums will be set at the end of the push):: - - [{“id”: “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”}] - -2. (Index -> Docker) 200 Created - **Headers**: - - WWW-Authenticate: Token signature=123abc,repository=”foo/bar”,access=write - - X-Docker-Endpoints: registry.docker.io [, registry2.docker.io] - -3. (Docker -> Registry) PUT /v1/images/98765432_parent/json - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=write - -4. (Registry->Index) GET /v1/repositories/foo/bar/images - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=write - **Action**:: - - Index: - will invalidate the token. - - 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 signature=123abc,repository=”foo/bar”,access=write - - Cookie: (Cookie provided by the Registry) - -6. (Docker -> Registry) PUT /v1/images/98765432/json - **Headers**: - Cookie: (Cookie provided by the Registry) - -7. (Docker -> Registry) PUT /v1/images/98765432_parent/layer - **Headers**: - Cookie: (Cookie provided by the Registry) - -8. (Docker -> Registry) PUT /v1/images/98765432/layer - **Headers**: - X-Docker-Checksum: sha256:436745873465fdjkhdfjkgh - -9. (Docker -> Registry) PUT /v1/repositories/foo/bar/tags/latest - **Headers**: - Cookie: (Cookie provided by the Registry) - **Body**: - “98765432” - -10. (Docker -> Index) PUT /v1/repositories/foo/bar/images - - **Headers**: - Authorization: Basic 123oislifjsldfj== - X-Docker-Endpoints: registry1.docker.io (no validation on this right now) - - **Body**: - (The image, id’s, tags and checksums) - - [{“id”: “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, - “checksum”: “b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087”}] - - **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. - - 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. - -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. - -1. Docker contacts the index to request a delete of a repository ``samalba/busybox`` (authentication required with user credentials) -2. If authentication works and repository is valid, ``samalba/busybox`` is marked as deleted and a temporary token is returned -3. Send a delete request to the registry for the repository (along with the token) -4. Registry A contacts the Index to verify the token (token must corresponds to the repository name) -5. Index validates the token. Registry A deletes the repository and everything associated to it. -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. - -API (deleting repository foo/bar): -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -1. (Docker -> Index) DELETE /v1/repositories/foo/bar/ - **Headers**: - Authorization: Basic sdkjfskdjfhsdkjfh== - X-Docker-Token: true - - **Action**:: - - in index, we make sure it is a valid repository, and set to deleted (logically) - - **Body**:: - Empty - -2. (Index -> Docker) 202 Accepted - **Headers**: - - WWW-Authenticate: Token signature=123abc,repository=”foo/bar”,access=delete - - X-Docker-Endpoints: registry.docker.io [, registry2.docker.io] # list of endpoints where this repo lives. - -3. (Docker -> Registry) DELETE /v1/repositories/foo/bar/ - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=delete - -4. (Registry->Index) PUT /v1/repositories/foo/bar/auth - **Headers**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=delete - **Action**:: - - Index: - will invalidate the token. - - Registry: - deletes the repository (if token is approved) - -5. (Registry -> Docker) 200 OK - 200 If success - 403 if forbidden - 400 if bad request - 404 if repository isn't found - -6. (Docker -> Index) DELETE /v1/repositories/foo/bar/ - - **Headers**: - Authorization: Basic 123oislifjsldfj== - X-Docker-Endpoints: registry-1.docker.io (no validation on this right now) - - **Body**: - Empty - - **Return** HTTP 200 - - -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 -> \https://registry.docker.io/users//repositories// - - team/projectname -> \https://registry.docker.io/team//repositories// -- Authenticate a user as a repos owner (for a central referenced repository) - -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 controlled by -Docker Inc. - -In this case, the registry will be launched in a special mode (--standalone? ---no-index?). In this mode, the only thing which changes is that Registry will -never contact the Index to verify a token. It will be the Registry owner -responsibility to authenticate the user who pushes (or even pulls) an image -using any mechanism (HTTP auth, IP based, etc...). - -In this scenario, the Registry is responsible for the security in case of data -corruption since the checksums are not delivered by a trusted entity. - -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). - -3.2 With an Index ------------------ - -The Index data needed by the Registry are simple: - -- 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. - -The only challenge will be to tell Docker to contact (and trust) this custom -Index. Docker will be configurable at some point to use a 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. - -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 - -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 information as -Docker uses to manage them. - -The format of ancestry is a line-separated list of image ids, in age order, -i.e. the image’s parent is on the last line, the parent of the parent on the -next-to-last line, etc.; if the image has no parent, the file is empty. - -.. code-block:: bash - - GET /v1/images//layer - PUT /v1/images//layer - GET /v1/images//json - PUT /v1/images//json - GET /v1/images//ancestry - PUT /v1/images//ancestry - -4.2 Users ---------- - -4.2.1 Create a user (Index) -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -POST /v1/users - -**Body**: - {"email": "sam@dotcloud.com", "password": "toto42", "username": "foobar"'} - -**Validation**: - - **username**: min 4 character, max 30 characters, must match the regular - expression [a-z0-9\_]. - - **password**: min 5 characters - -**Valid**: return HTTP 200 - -Errors: HTTP 400 (we should create error codes for possible errors) -- invalid json -- missing field -- wrong format (username, password, email, etc) -- forbidden name -- name already exists - -.. note:: - - A user account will be valid only if the email has been validated (a validation link is sent to the email address). - -4.2.2 Update a user (Index) -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -PUT /v1/users/ - -**Body**: - {"password": "toto"} - -.. note:: - - We can also update email address, if they do, they will need to reverify their new email address. - -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. - -GET /v1/users - -**Return**: - - Valid: HTTP 200 - - Invalid login: HTTP 401 - - Account inactive: HTTP 403 Account is not Active - -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 registry. Allowing us to -implement organizations or different namespaces per user later, without -modifying the Registry’s API. - -The following naming restrictions apply: - -- Namespaces must match the same regular expression as usernames (See 4.2.1.) -- Repository names must match the regular expression [a-zA-Z0-9-_.] - -4.3.1 Get all tags -^^^^^^^^^^^^^^^^^^ - -GET /v1/repositories///tags - -**Return**: HTTP 200 - { - "latest": "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f", - “0.1.1”: “b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087” - } - -4.3.2 Read the content of a tag (resolve the image id) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -GET /v1/repositories///tags/ - -**Return**: - "9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f" - -4.3.3 Delete a tag (registry) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -DELETE /v1/repositories///tags/ - -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. - -4.4.1 Get the images -^^^^^^^^^^^^^^^^^^^^^ - -GET /v1/repositories///images - -**Return**: HTTP 200 - [{“id”: “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, “checksum”: “md5:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087”}] - - -4.4.2 Add/update the images -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -You always add images, you never remove them. - -PUT /v1/repositories///images - -**Body**: - [ {“id”: “9e89cc6f0bc3c38722009fe6857087b486531f9a779a0c17e3ed29dae8f12c4f”, “checksum”: “sha256:b486531f9a779a0c17e3ed29dae8f12c4f9e89cc6f0bc3c38722009fe6857087”} ] - -**Return** 204 - -4.5 Repositories ----------------- - -4.5.1 Remove a Repository (Registry) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -DELETE /v1/repositories// - -Return 200 OK - -4.5.2 Remove a Repository (Index) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -This starts the delete process. see 2.3 for more details. - -DELETE /v1/repositories// - -Return 202 OK - -5. Chaining Registries -====================== - -It’s possible to chain Registries server for several reasons: - -- 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 download. - -The Index and Registry use this mechanism to redirect on one or the other. - -Example with an image download: - -On every request, a special header can be returned:: - - X-Docker-Endpoints: server1,server2 - -On the next request, the client will always pick a server from this list. - -6. Authentication & Authorization -================================= - -6.1 On the Index ------------------ - -The Index supports both “Basic” and “Token” challenges. Usually when there is a -``401 Unauthorized``, the Index replies this:: - - 401 Unauthorized - WWW-Authenticate: Basic realm="auth required",Token - -You have 3 options: - -1. Provide user credentials and ask for a token - - **Header**: - - 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 signature=123abc,repository=”foo/bar”,access=read - -2. Provide user credentials only - - **Header**: - Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== - -3. Provide Token - - **Header**: - Authorization: Token signature=123abc,repository=”foo/bar”,access=read - -6.2 On the Registry -------------------- - -The Registry only supports the Token challenge:: - - 401 Unauthorized - WWW-Authenticate: Token - -The only way is to provide a token on ``401 Unauthorized`` responses:: - - Authorization: Token signature=123abc,repository="foo/bar",access=read - -Usually, the Registry provides a Cookie when a Token verification succeeded. -Every time the Registry passes a Cookie, you have to pass it back the same -cookie.:: - - 200 OK - Set-Cookie: session="wD/J7LqL5ctqw8haL10vgfhrb2Q=?foo=UydiYXInCnAxCi4=×tamp=RjEzNjYzMTQ5NDcuNDc0NjQzCi4="; Path=/; HttpOnly - -Next request:: - - GET /(...) - Cookie: session="wD/J7LqL5ctqw8haL10vgfhrb2Q=?foo=UydiYXInCnAxCi4=×tamp=RjEzNjYzMTQ5NDcuNDc0NjQzCi4=" - - -7 Document Version -==================== - -- 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.rst b/docs/sources/reference/api/remote_api_client_libraries.rst deleted file mode 100644 index c94c68cd48..0000000000 --- a/docs/sources/reference/api/remote_api_client_libraries.rst +++ /dev/null @@ -1,55 +0,0 @@ -:title: Remote API Client Libraries -:description: Various client libraries available to use with the Docker remote API -:keywords: API, Docker, index, registry, REST, documentation, clients, Python, Ruby, JavaScript, Erlang, Go - - -================================== -Docker Remote API Client Libraries -================================== - -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 | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Ruby | docker-client | https://github.com/geku/docker-client | Outdated | -+----------------------+----------------+--------------------------------------------+----------+ -| Ruby | docker-api | https://github.com/swipely/docker-api | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| JavaScript (NodeJS) | dockerode | https://github.com/apocas/dockerode | Active | -| | | Install via NPM: `npm install dockerode` | | -+----------------------+----------------+--------------------------------------------+----------+ -| JavaScript (NodeJS) | docker.io | https://github.com/appersonlabs/docker.io | Active | -| | | Install via NPM: `npm install docker.io` | | -+----------------------+----------------+--------------------------------------------+----------+ -| JavaScript | docker-js | https://github.com/dgoujard/docker-js | Outdated | -+----------------------+----------------+--------------------------------------------+----------+ -| JavaScript (Angular) | docker-cp | https://github.com/13W/docker-cp | Active | -| **WebUI** | | | | -+----------------------+----------------+--------------------------------------------+----------+ -| JavaScript (Angular) | dockerui | https://github.com/crosbymichael/dockerui | Active | -| **WebUI** | | | | -+----------------------+----------------+--------------------------------------------+----------+ -| Java | docker-java | https://github.com/kpelykh/docker-java | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Erlang | erldocker | https://github.com/proger/erldocker | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Go | go-dockerclient| https://github.com/fsouza/go-dockerclient | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Go | dockerclient | https://github.com/samalba/dockerclient | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| PHP | Alvine | http://pear.alvine.io/ (alpha) | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| PHP | Docker-PHP | http://stage1.github.io/docker-php/ | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Perl | Net::Docker | https://metacpan.org/pod/Net::Docker | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Perl | Eixo::Docker | https://github.com/alambike/eixo-docker | Active | -+----------------------+----------------+--------------------------------------------+----------+ -| Scala | reactive-docker| https://github.com/almoehi/reactive-docker | Active | -+----------------------+----------------+--------------------------------------------+----------+ diff --git a/docs/sources/reference/builder.rst b/docs/sources/reference/builder.rst deleted file mode 100644 index e8897d1b09..0000000000 --- a/docs/sources/reference/builder.rst +++ /dev/null @@ -1,532 +0,0 @@ -:title: Dockerfile Reference -:description: Dockerfiles use a simple DSL which allows you to automate the steps you would normally manually take to create an image. -:keywords: builder, docker, Dockerfile, automation, image creation - -.. _dockerbuilder: - -==================== -Dockerfile Reference -==================== - -**Docker can act as a builder** and read instructions from a text -``Dockerfile`` to automate the steps you would otherwise take manually -to create an image. Executing ``docker build`` will run your steps and -commit them along the way, giving you a final image. - -.. _dockerfile_usage: - -Usage -===== - -To :ref:`build ` an image from a source repository, create -a description file called ``Dockerfile`` at the root of your -repository. This file will describe the steps to assemble the image. - -Then call ``docker build`` with the path of your source repository as -argument (for example, ``.``): - - ``sudo docker build .`` - -The path to the source repository defines where to find the *context* -of the build. The build is run by the Docker daemon, not by the CLI, -so the whole context must be transferred to the daemon. The Docker CLI -reports "Uploading context" when the context is sent to the daemon. - -You can specify a repository and tag at which to save the new image if the -build succeeds: - - ``sudo docker build -t shykes/myapp .`` - -The Docker daemon will run your steps one-by-one, committing the -result to a new image if necessary, before finally outputting the -ID of your new image. The Docker daemon will automatically clean -up the context you sent. - -Note that each instruction is run independently, and causes a new image -to be created - so ``RUN cd /tmp`` will not have any effect on the next -instructions. - -Whenever possible, Docker will re-use the intermediate images, -accelerating ``docker build`` significantly (indicated by ``Using cache``): - -.. code-block:: bash - - $ docker build -t SvenDowideit/ambassador . - Uploading context 10.24 kB - Uploading context - Step 1 : FROM docker-ut - ---> cbba202fe96b - Step 2 : MAINTAINER SvenDowideit@home.org.au - ---> Using cache - ---> 51182097be13 - Step 3 : CMD env | grep _TCP= | sed 's/.*_PORT_\([0-9]*\)_TCP=tcp:\/\/\(.*\):\(.*\)/socat TCP4-LISTEN:\1,fork,reuseaddr TCP4:\2:\3 \&/' | sh && top - ---> Using cache - ---> 1a5ffc17324d - Successfully built 1a5ffc17324d - -When you're done with your build, you're ready to look into -:ref:`image_push`. - -.. _dockerfile_format: - -Format -====== - -Here is the format of the Dockerfile: - -:: - - # Comment - INSTRUCTION arguments - -The Instruction is not case-sensitive, however convention is for them to be -UPPERCASE in order to distinguish them from arguments more easily. - -Docker evaluates the instructions in a Dockerfile in order. **The -first instruction must be `FROM`** in order to specify the -:ref:`base_image_def` from which you are building. - -Docker will treat lines that *begin* with ``#`` as a comment. A ``#`` -marker anywhere else in the line will be treated as an argument. This -allows statements like: - -:: - - # Comment - RUN echo 'we are running some # of cool things' - -.. _dockerfile_instructions: - - -Here is the set of instructions you can use in a ``Dockerfile`` for -building images. - -.. _dockerfile_from: - -``FROM`` -======== - - ``FROM `` - -Or - - ``FROM :`` - -The ``FROM`` instruction sets the :ref:`base_image_def` for subsequent -instructions. As such, a valid Dockerfile must have ``FROM`` as its -first instruction. The image can be any valid image -- it is -especially easy to start by **pulling an image** from the -:ref:`using_public_repositories`. - -``FROM`` must be the first non-comment instruction in the -``Dockerfile``. - -``FROM`` can appear multiple times within a single Dockerfile in order -to create multiple images. Simply make a note of the last image id -output by the commit before each new ``FROM`` command. - -If no ``tag`` is given to the ``FROM`` instruction, ``latest`` is -assumed. If the used tag does not exist, an error will be returned. - -.. _dockerfile_maintainer: - -``MAINTAINER`` -============== - - ``MAINTAINER `` - -The ``MAINTAINER`` instruction allows you to set the *Author* field of -the generated images. - -.. _dockerfile_run: - -``RUN`` -======= - -RUN has 2 forms: - -* ``RUN `` (the command is run in a shell - ``/bin/sh -c``) -* ``RUN ["executable", "param1", "param2"]`` (*exec* form) - -The ``RUN`` instruction will execute any commands in a new layer on top -of the current image and commit the results. The resulting committed image -will be used for the next step in the Dockerfile. - -Layering ``RUN`` instructions and generating commits conforms to the -core concepts of Docker where commits are cheap and containers can be -created from any point in an image's history, much like source -control. - -The *exec* form makes it possible to avoid shell string munging, and to ``RUN`` -commands using a base image that does not contain ``/bin/sh``. - -Known Issues (RUN) -.................. - -* :issue:`783` is about file permissions problems that can occur when - using the AUFS file system. You might notice it during an attempt to - ``rm`` a file, for example. The issue describes a workaround. -* :issue:`2424` Locale will not be set automatically. - -.. _dockerfile_cmd: - -``CMD`` -======= - -CMD has three forms: - -* ``CMD ["executable","param1","param2"]`` (like an *exec*, preferred form) -* ``CMD ["param1","param2"]`` (as *default parameters to ENTRYPOINT*) -* ``CMD command param1 param2`` (as a *shell*) - -There can only be one CMD in a Dockerfile. If you list more than one -CMD then only the last CMD will take effect. - -**The main purpose of a CMD is to provide defaults for an executing -container.** These defaults can include an executable, or they can -omit the executable, in which case you must specify an ENTRYPOINT as -well. - -When used in the shell or exec formats, the ``CMD`` instruction sets -the command to be executed when running the image. - -If you use the *shell* form of the CMD, then the ```` will -execute in ``/bin/sh -c``: - -.. code-block:: bash - - FROM ubuntu - CMD echo "This is a test." | wc - - -If you want to **run your** ```` **without a shell** then you -must express the command as a JSON array and give the full path to the -executable. **This array form is the preferred format of CMD.** Any -additional parameters must be individually expressed as strings in the -array: - -.. code-block:: bash - - FROM ubuntu - CMD ["/usr/bin/wc","--help"] - -If you would like your container to run the same executable every -time, then you should consider using ``ENTRYPOINT`` in combination -with ``CMD``. See :ref:`dockerfile_entrypoint`. - -If the user specifies arguments to ``docker run`` then they will -override the default specified in CMD. - -.. note:: - Don't confuse ``RUN`` with ``CMD``. ``RUN`` actually runs a - command and commits the result; ``CMD`` does not execute anything at - build time, but specifies the intended command for the image. - -.. _dockerfile_expose: - -``EXPOSE`` -========== - - ``EXPOSE [...]`` - -The ``EXPOSE`` instructions informs Docker that the container will listen -on the specified network ports at runtime. Docker uses this information -to interconnect containers using links (see :ref:`links `), -and to setup port redirection on the host system (see :ref:`port_redirection`). - -.. _dockerfile_env: - -``ENV`` -======= - - ``ENV `` - -The ``ENV`` instruction sets the environment variable ```` to the -value ````. This value will be passed to all future ``RUN`` -instructions. This is functionally equivalent to prefixing the command -with ``=`` - -The environment variables set using ``ENV`` will persist when a container is run -from the resulting image. You can view the values using ``docker inspect``, and change them using ``docker run --env =``. - -.. note:: - One example where this can cause unexpected consequenses, is setting - ``ENV DEBIAN_FRONTEND noninteractive``. - Which will persist when the container is run interactively; for example: - ``docker run -t -i image bash`` - -.. _dockerfile_add: - -``ADD`` -======= - - ``ADD `` - -The ``ADD`` instruction will copy new files from and add them to -the container's filesystem at path ````. - -```` must be the path to a file or directory relative to the -source directory being built (also called the *context* of the build) or -a remote file URL. - -```` is the absolute path to which the source will be copied inside the -destination container. - -All new files and directories are created with mode 0755, uid and gid -0. - -.. note:: - if you build using STDIN (``docker build - < somefile``), there is no build - context, so the Dockerfile can only contain an URL based ADD statement. - -.. note:: - if your URL files are protected using authentication, you will need to use - an ``RUN wget`` , ``RUN curl`` or other tool from within the container as - ADD does not support authentication. - -The copy obeys the following rules: - -* The ```` path must be inside the *context* of the build; you cannot - ``ADD ../something /something``, because the first step of a - ``docker build`` is to send the context directory (and subdirectories) to - the docker daemon. -* If ```` is a URL and ```` does not end with a trailing slash, - then a file is downloaded from the URL and copied to ````. -* If ```` is a URL and ```` does end with a trailing slash, - then the filename is inferred from the URL and the file is downloaded to - ``/``. For instance, ``ADD http://example.com/foobar /`` - would create the file ``/foobar``. The URL must have a nontrivial path - so that an appropriate filename can be discovered in this case - (``http://example.com`` will not work). -* If ```` is a directory, the entire directory is copied, - including filesystem metadata. -* If ```` is a *local* tar archive in a recognized compression - format (identity, gzip, bzip2 or xz) then it is unpacked as a - directory. Resources from *remote* URLs are **not** decompressed. - - When a directory is copied or unpacked, it has the same behavior as - ``tar -x``: the result is the union of - - 1. whatever existed at the destination path and - 2. the contents of the source tree, - - with conflicts resolved in favor of "2." on a file-by-file basis. - -* If ```` is any other kind of file, it is copied individually - along with its metadata. In this case, if ```` ends with a - trailing slash ``/``, it will be considered a directory and the - contents of ```` will be written at ``/base()``. -* If ```` does not end with a trailing slash, it will be - considered a regular file and the contents of ```` will be - written at ````. -* If ```` doesn't exist, it is created along with all missing - directories in its path. - -.. _dockerfile_entrypoint: - -``ENTRYPOINT`` -============== - -ENTRYPOINT has two forms: - -* ``ENTRYPOINT ["executable", "param1", "param2"]`` (like an *exec*, - preferred form) -* ``ENTRYPOINT command param1 param2`` (as a *shell*) - -There can only be one ``ENTRYPOINT`` in a Dockerfile. If you have more -than one ``ENTRYPOINT``, then only the last one in the Dockerfile will -have an effect. - -An ``ENTRYPOINT`` helps you to configure a container that you can run -as an executable. That is, when you specify an ``ENTRYPOINT``, then -the whole container runs as if it was just that executable. - -The ``ENTRYPOINT`` instruction adds an entry command that will **not** -be overwritten when arguments are passed to ``docker run``, unlike the -behavior of ``CMD``. This allows arguments to be passed to the -entrypoint. i.e. ``docker run -d`` will pass the "-d" -argument to the ENTRYPOINT. - -You can specify parameters either in the ENTRYPOINT JSON array (as in -"like an exec" above), or by using a CMD statement. Parameters in the -ENTRYPOINT will not be overridden by the ``docker run`` arguments, but -parameters specified via CMD will be overridden by ``docker run`` -arguments. - -Like a ``CMD``, you can specify a plain string for the ENTRYPOINT and -it will execute in ``/bin/sh -c``: - -.. code-block:: bash - - FROM ubuntu - ENTRYPOINT wc -l - - -For example, that Dockerfile's image will *always* take stdin as input -("-") and print the number of lines ("-l"). If you wanted to make -this optional but default, you could use a CMD: - -.. code-block:: bash - - FROM ubuntu - CMD ["-l", "-"] - ENTRYPOINT ["/usr/bin/wc"] - -.. _dockerfile_volume: - -``VOLUME`` -========== - - ``VOLUME ["/data"]`` - -The ``VOLUME`` instruction will create a mount point with the specified name and mark it -as holding externally mounted volumes from native host or other containers. For more information/examples -and mounting instructions via docker client, refer to :ref:`volume_def` documentation. - -.. _dockerfile_user: - -``USER`` -======== - - ``USER daemon`` - -The ``USER`` instruction sets the username or UID to use when running -the image. - -.. _dockerfile_workdir: - -``WORKDIR`` -=========== - - ``WORKDIR /path/to/workdir`` - -The ``WORKDIR`` instruction sets the working directory for the ``RUN``, ``CMD`` and -``ENTRYPOINT`` Dockerfile commands that follow it. - -It can be used multiple times in the one Dockerfile. If a relative path is -provided, it will be relative to the path of the previous ``WORKDIR`` -instruction. For example: - - WORKDIR /a - WORKDIR b - WORKDIR c - RUN pwd - -The output of the final ``pwd`` command in this Dockerfile would be ``/a/b/c``. - -``ONBUILD`` -=========== - - ``ONBUILD [INSTRUCTION]`` - -The ``ONBUILD`` instruction adds to the image a "trigger" instruction to be -executed at a later time, when the image is used as the base for another build. -The trigger will be executed in the context of the downstream build, as if it -had been inserted immediately after the *FROM* instruction in the downstream -Dockerfile. - -Any build instruction can be registered as a trigger. - -This is useful if you are building an image which will be used as a base to build -other images, for example an application build environment or a daemon which may be -customized with user-specific configuration. - -For example, if your image is a reusable python application builder, it will require -application source code to be added in a particular directory, and it might require -a build script to be called *after* that. You can't just call *ADD* and *RUN* now, -because you don't yet have access to the application source code, and it will be -different for each application build. You could simply provide application developers -with a boilerplate Dockerfile to copy-paste into their application, but that is -inefficient, error-prone and difficult to update because it mixes with -application-specific code. - -The solution is to use *ONBUILD* to register in advance instructions to run later, -during the next build stage. - -Here's how it works: - -1. When it encounters an *ONBUILD* instruction, the builder adds a trigger to - the metadata of the image being built. - The instruction does not otherwise affect the current build. - -2. At the end of the build, a list of all triggers is stored in the image manifest, - under the key *OnBuild*. They can be inspected with *docker inspect*. - -3. Later the image may be used as a base for a new build, using the *FROM* instruction. - As part of processing the *FROM* instruction, the downstream builder looks for *ONBUILD* - triggers, and executes them in the same order they were registered. If any of the - triggers fail, the *FROM* instruction is aborted which in turn causes the build - to fail. If all triggers succeed, the FROM instruction completes and the build - continues as usual. - -4. Triggers are cleared from the final image after being executed. In other words - they are not inherited by "grand-children" builds. - -For example you might add something like this: - -.. code-block:: bash - - [...] - ONBUILD ADD . /app/src - ONBUILD RUN /usr/local/bin/python-build --dir /app/src - [...] - -.. warning:: Chaining ONBUILD instructions using `ONBUILD ONBUILD` isn't allowed. -.. warning:: ONBUILD may not trigger FROM or MAINTAINER instructions. - -.. _dockerfile_examples: - -Dockerfile Examples -====================== - -.. code-block:: bash - - # Nginx - # - # VERSION 0.0.1 - - FROM ubuntu - MAINTAINER Guillaume J. Charmes - - # make sure the package repository is up to date - RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list - RUN apt-get update - - RUN apt-get install -y inotify-tools nginx apache2 openssh-server - -.. code-block:: bash - - # Firefox over VNC - # - # VERSION 0.3 - - FROM ubuntu - # make sure the package repository is up to date - RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list - RUN apt-get update - - # Install vnc, xvfb in order to create a 'fake' display and firefox - RUN apt-get install -y x11vnc xvfb firefox - RUN mkdir /.vnc - # Setup a password - RUN x11vnc -storepasswd 1234 ~/.vnc/passwd - # Autostart firefox (might not be the best way, but it does the trick) - RUN bash -c 'echo "firefox" >> /.bashrc' - - EXPOSE 5900 - CMD ["x11vnc", "-forever", "-usepw", "-create"] - -.. code-block:: bash - - # Multiple images example - # - # VERSION 0.1 - - FROM ubuntu - RUN echo foo > bar - # Will output something like ===> 907ad6c2736f - - FROM ubuntu - RUN echo moo > oink - # Will output something like ===> 695d7793cbe4 - - # You'll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with - # /oink. diff --git a/docs/sources/reference/commandline/cli.rst b/docs/sources/reference/commandline/cli.rst deleted file mode 100644 index 9c1d3ae4be..0000000000 --- a/docs/sources/reference/commandline/cli.rst +++ /dev/null @@ -1,1405 +0,0 @@ -:title: Command Line Interface -:description: Docker's CLI command description and usage -:keywords: Docker, Docker documentation, CLI, command line - -.. _cli: - -Command Line -============ - -To list available commands, either run ``docker`` with no parameters or execute -``docker help``:: - - $ sudo docker - Usage: docker [OPTIONS] COMMAND [arg...] - -H, --host=[]: The socket(s) to bind to in daemon mode, specified using one or more tcp://host:port, unix:///path/to/socket, fd://* or fd://socketfd. - - A self-sufficient runtime for linux containers. - - ... - -.. _cli_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 -``docker run -ti --name test busybox sh``. - -Boolean -~~~~~~~ - -Boolean options look like ``-d=false``. The value you see is the -default value which gets set if you do **not** use the boolean -flag. If you do call ``run -d``, that sets the opposite boolean value, -so in this case, ``true``, and so ``docker run -d`` **will** run in -"detached" mode, in the background. Other boolean options are similar --- specifying them will set the value to the opposite of the default -value. - -Multi -~~~~~ - -Options like ``-a=[]`` indicate they can be specified multiple times:: - - docker run -a stdin -a stdout -a stderr -i -t ubuntu /bin/bash - -Sometimes this can use a more complex value string, as for ``-v``:: - - docker run -v /host:/container example/mysql - -Strings and Integers -~~~~~~~~~~~~~~~~~~~~ - -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. - -.. _cli_daemon: - -``daemon`` ----------- - -:: - - Usage of docker: - -D, --debug=false: Enable debug mode - -G, --group="docker": Group to assign the unix socket specified by -H when running in daemon mode; use '' (the empty string) to disable setting of a group - -H, --host=[]: The socket(s) to bind to in daemon mode, specified using one or more tcp://host:port, unix:///path/to/socket, fd://* or fd://socketfd. - --api-enable-cors=false: Enable CORS headers in the remote API - -b, --bridge="": Attach containers to a pre-existing network bridge; use 'none' to disable container networking - -bip="": Use this CIDR notation address for the network bridge's IP, not compatible with -b - -d, --daemon=false: Enable daemon mode - --dns=[]: Force docker to use specific DNS servers - --dns-search=[]: Force Docker to use specific DNS search domains - -g, --graph="/var/lib/docker": Path to use as the root of the docker runtime - --icc=true: Enable inter-container communication - --ip="0.0.0.0": Default IP address to use when binding container ports - --ip-forward=true: Enable net.ipv4.ip_forward - --iptables=true: Enable Docker's addition of iptables rules - -p, --pidfile="/var/run/docker.pid": Path to use for daemon PID file - -r, --restart=true: Restart previously running containers - -s, --storage-driver="": Force the docker runtime to use a specific storage driver - -e, --exec-driver="native": Force the docker runtime to use a specific exec driver - -v, --version=false: Print version information and quit - --tls=false: Use TLS; implied by tls-verify flags - --tlscacert="~/.docker/ca.pem": Trust only remotes providing a certificate signed by the CA given here - --tlscert="~/.docker/cert.pem": Path to TLS certificate file - --tlskey="~/.docker/key.pem": Path to TLS key file - --tlsverify=false: Use TLS and verify the remote (daemon: verify client, client: verify daemon) - --mtu=0: Set the containers network MTU; if no value is provided: default to the default route MTU or 1500 if no default route is available - - Options with [] may be specified multiple times. - -The Docker daemon is the persistent process that manages containers. Docker uses the same binary for both the -daemon and client. To run the daemon you provide the ``-d`` flag. - -To force Docker to use devicemapper as the storage driver, use ``docker -d -s devicemapper``. - -To set the DNS server for all Docker containers, use ``docker -d --dns 8.8.8.8``. - -To set the DNS search domain for all Docker containers, use ``docker -d --dns-search example.com``. - -To run the daemon with debug output, use ``docker -d -D``. - -To use lxc as the execution driver, use ``docker -d -e lxc``. - -The docker client will also honor the ``DOCKER_HOST`` environment variable to set -the ``-H`` flag for the client. - -:: - - docker -H tcp://0.0.0.0:4243 ps - # or - export DOCKER_HOST="tcp://0.0.0.0:4243" - docker ps - # both are equal - -To run the daemon with `systemd socket activation `_, use ``docker -d -H fd://``. -Using ``fd://`` will work perfectly for most setups but you can also specify individual sockets too ``docker -d -H fd://3``. -If the specified socket activated files aren't found then docker will exit. -You can find examples of using systemd socket activation with docker and systemd in the `docker source tree `_. - -Docker supports softlinks for the Docker data directory (``/var/lib/docker``) and for ``/tmp``. -TMPDIR and the data directory can be set like this: - -:: - - TMPDIR=/mnt/disk2/tmp /usr/local/bin/docker -d -D -g /var/lib/docker -H unix:// > /var/lib/boot2docker/docker.log 2>&1 - # or - export TMPDIR=/mnt/disk2/tmp - /usr/local/bin/docker -d -D -g /var/lib/docker -H unix:// > /var/lib/boot2docker/docker.log 2>&1 - -.. _cli_attach: - -``attach`` ----------- - -:: - - Usage: docker attach 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) - -The ``attach`` command will allow you to view or interact with any -running container, detached (``-d``) or interactive (``-i``). You can -attach to the same container at the same time - screen sharing style, -or quickly view the progress of your daemonized process. - -You can detach from the container again (and leave it running) with -``CTRL-C`` (for a quiet exit) or ``CTRL-\`` to get a stacktrace of -the Docker client when it quits. When you detach from the container's -process the exit code will be returned to the client. - -To stop a container, use ``docker stop``. - -To kill the container, use ``docker kill``. - -.. _cli_attach_examples: - -Examples: -~~~~~~~~~ - -.. code-block:: bash - - $ ID=$(sudo docker run -d ubuntu /usr/bin/top -b) - $ sudo docker attach $ID - top - 02:05:52 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 - Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie - Cpu(s): 0.1%us, 0.2%sy, 0.0%ni, 99.7%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st - Mem: 373572k total, 355560k used, 18012k free, 27872k buffers - Swap: 786428k total, 0k used, 786428k free, 221740k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - 1 root 20 0 17200 1116 912 R 0 0.3 0:00.03 top - - top - 02:05:55 up 3:05, 0 users, load average: 0.01, 0.02, 0.05 - Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie - Cpu(s): 0.0%us, 0.2%sy, 0.0%ni, 99.8%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st - Mem: 373572k total, 355244k used, 18328k free, 27872k buffers - Swap: 786428k total, 0k used, 786428k free, 221776k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top - - - top - 02:05:58 up 3:06, 0 users, load average: 0.01, 0.02, 0.05 - Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie - Cpu(s): 0.2%us, 0.3%sy, 0.0%ni, 99.5%id, 0.0%wa, 0.0%hi, 0.0%si, 0.0%st - Mem: 373572k total, 355780k used, 17792k free, 27880k buffers - Swap: 786428k total, 0k used, 786428k free, 221776k cached - - PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND - 1 root 20 0 17208 1144 932 R 0 0.3 0:00.03 top - ^C$ - $ sudo docker stop $ID - -.. _cli_build: - -``build`` ---------- - -:: - - Usage: docker build [OPTIONS] PATH | URL | - - Build a new container image from the source code at PATH - -t, --tag="": Repository name (and optionally a tag) to be applied - to the resulting image in case of success. - -q, --quiet=false: Suppress the verbose output generated by the containers. - --no-cache: Do not use the cache when building the image. - --rm=true: Remove intermediate containers after a successful build - -Use this command to build Docker images from a ``Dockerfile`` and a "context". - -The files at ``PATH`` or ``URL`` are called the "context" of the build. -The build process may refer to any of the files in the context, for example when -using an :ref:`ADD ` instruction. -When a single ``Dockerfile`` is given as ``URL``, then no context is set. - -When a Git repository is set as ``URL``, then the repository is used as the context. -The Git repository is cloned with its submodules (`git clone --recursive`). -A fresh git clone occurs in a temporary directory on your local host, and then this -is sent to the Docker daemon as the context. -This way, your local user credentials and vpn's etc can be used to access private repositories - -.. _cli_build_examples: - -.. seealso:: :ref:`dockerbuilder`. - -Examples: -~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker build . - Uploading context 10240 bytes - Step 1 : FROM busybox - Pulling repository busybox - ---> e9aa60c60128MB/2.284 MB (100%) endpoint: https://cdn-registry-1.docker.io/v1/ - Step 2 : RUN ls -lh / - ---> Running in 9c9e81692ae9 - total 24 - drwxr-xr-x 2 root root 4.0K Mar 12 2013 bin - drwxr-xr-x 5 root root 4.0K Oct 19 00:19 dev - drwxr-xr-x 2 root root 4.0K Oct 19 00:19 etc - drwxr-xr-x 2 root root 4.0K Nov 15 23:34 lib - lrwxrwxrwx 1 root root 3 Mar 12 2013 lib64 -> lib - dr-xr-xr-x 116 root root 0 Nov 15 23:34 proc - lrwxrwxrwx 1 root root 3 Mar 12 2013 sbin -> bin - dr-xr-xr-x 13 root root 0 Nov 15 23:34 sys - drwxr-xr-x 2 root root 4.0K Mar 12 2013 tmp - drwxr-xr-x 2 root root 4.0K Nov 15 23:34 usr - ---> b35f4035db3f - Step 3 : CMD echo Hello World - ---> Running in 02071fceb21b - ---> f52f38b7823e - Successfully built f52f38b7823e - Removing intermediate container 9c9e81692ae9 - Removing intermediate container 02071fceb21b - - -This example specifies that the ``PATH`` is ``.``, and so all the files in -the local directory get tar'd and sent to the Docker daemon. The ``PATH`` -specifies where to find the files for the "context" of the build on -the Docker daemon. Remember that the daemon could be running on a -remote machine and that no parsing of the ``Dockerfile`` happens at the -client side (where you're running ``docker build``). That means that -*all* the files at ``PATH`` get sent, not just the ones listed to -:ref:`ADD ` in the ``Dockerfile``. - -The transfer of context from the local machine to the Docker daemon is -what the ``docker`` client means when you see the "Uploading context" -message. - -If you wish to keep the intermediate containers after the build is complete, -you must use ``--rm=false``. This does not affect the build cache. - - -.. code-block:: bash - - $ sudo docker build -t vieux/apache:2.0 . - -This will build like the previous example, but it will then tag the -resulting image. The repository name will be ``vieux/apache`` and the -tag will be ``2.0`` - - -.. code-block:: bash - - $ sudo docker build - < Dockerfile - -This will read a ``Dockerfile`` from *stdin* without context. Due to -the lack of a context, no contents of any local directory will be sent -to the ``docker`` daemon. Since there is no context, a ``Dockerfile`` -``ADD`` only works if it refers to a remote URL. - -.. code-block:: bash - - $ sudo docker build github.com/creack/docker-firefox - -This will clone the GitHub repository and use the cloned repository as -context. The ``Dockerfile`` at the root of the repository is used as -``Dockerfile``. Note that you can specify an arbitrary Git repository -by using the ``git://`` schema. - - -.. _cli_commit: - -``commit`` ----------- - -:: - - Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] - - Create a new image from a container's changes - - -m, --message="": Commit message - -a, --author="": Author (eg. "John Hannibal Smith " - -It can be useful to commit a container's file changes or settings into a new image. -This allows you debug a container by running an interactive shell, or to export -a working dataset to another server. -Generally, it is better to use Dockerfiles to manage your images in a documented -and maintainable way. - -.. _cli_commit_examples: - -Commit an existing container -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker ps - ID IMAGE COMMAND CREATED STATUS PORTS - c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours - 197387f1b436 ubuntu:12.04 /bin/bash 7 days ago Up 25 hours - $ docker commit c3f279d17e0a SvenDowideit/testimage:version3 - f5283438590d - $ docker images | head - REPOSITORY TAG ID CREATED VIRTUAL SIZE - SvenDowideit/testimage version3 f5283438590d 16 seconds ago 335.7 MB - - -.. _cli_cp: - -``cp`` ------- - -:: - - Usage: docker cp CONTAINER:PATH HOSTPATH - - Copy files/folders from the containers filesystem to the host - path. Paths are relative to the root of the filesystem. - -.. code-block:: bash - - $ sudo docker cp 7bb0e258aefe:/etc/debian_version . - $ sudo docker cp blue_frog:/etc/hosts . - -.. _cli_diff: - -``diff`` --------- - -:: - - Usage: docker diff CONTAINER - - List the changed files and directories in a container's filesystem - -There are 3 events that are listed in the 'diff': - -1. ```A``` - Add -2. ```D``` - Delete -3. ```C``` - Change - -For example: - -.. code-block:: bash - - $ sudo docker diff 7bb0e258aefe - - C /dev - A /dev/kmsg - C /etc - A /etc/mtab - A /go - A /go/src - A /go/src/github.com - A /go/src/github.com/dotcloud - A /go/src/github.com/dotcloud/docker - A /go/src/github.com/dotcloud/docker/.git - .... - -.. _cli_events: - -``events`` ----------- - -:: - - Usage: docker events - - Get real time events from the server - - --since="": Show all events created since timestamp - (either seconds since epoch, or date string as below) - --until="": Show events created before timestamp - (either seconds since epoch, or date string as below) - -.. _cli_events_example: - -Examples -~~~~~~~~ - -You'll need two shells for this example. - -Shell 1: Listening for events -............................. - -.. code-block:: bash - - $ sudo docker events - -Shell 2: Start and Stop a Container -................................... - -.. code-block:: bash - - $ sudo docker start 4386fb97867d - $ sudo docker stop 4386fb97867d - -Shell 1: (Again .. now showing events) -...................................... - -.. code-block:: bash - - [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop - -Show events in the past from a specified time -............................................. - -.. code-block:: bash - - $ sudo docker events --since 1378216169 - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop - - $ sudo docker events --since '2013-09-03' - [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop - - $ sudo docker events --since '2013-09-03 15:49:29 +0200 CEST' - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die - [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop - -.. _cli_export: - -``export`` ----------- - -:: - - Usage: docker export CONTAINER - - Export the contents of a filesystem as a tar archive to STDOUT - -For example: - -.. code-block:: bash - - $ sudo docker export red_panda > latest.tar - -.. _cli_history: - -``history`` ------------ - -:: - - Usage: docker history [OPTIONS] IMAGE - - Show the history of an image - - --no-trunc=false: Don't truncate output - -q, --quiet=false: Only show numeric IDs - -To see how the ``docker:latest`` image was built: - -.. code-block:: bash - - $ docker history docker - IMAGE CREATED CREATED BY SIZE - 3e23a5875458790b7a806f95f7ec0d0b2a5c1659bfc899c89f939f6d5b8f7094 8 days ago /bin/sh -c #(nop) ENV LC_ALL=C.UTF-8 0 B - 8578938dd17054dce7993d21de79e96a037400e8d28e15e7290fea4f65128a36 8 days ago /bin/sh -c dpkg-reconfigure locales && locale-gen C.UTF-8 && /usr/sbin/update-locale LANG=C.UTF-8 1.245 MB - be51b77efb42f67a5e96437b3e102f81e0a1399038f77bf28cea0ed23a65cf60 8 days ago /bin/sh -c apt-get update && apt-get install -y git libxml2-dev python build-essential make gcc python-dev locales python-pip 338.3 MB - 4b137612be55ca69776c7f30c2d2dd0aa2e7d72059820abf3e25b629f887a084 6 weeks ago /bin/sh -c #(nop) ADD jessie.tar.xz in / 121 MB - 750d58736b4b6cc0f9a9abe8f258cef269e3e9dceced1146503522be9f985ada 6 weeks ago /bin/sh -c #(nop) MAINTAINER Tianon Gravi - mkimage-debootstrap.sh -t jessie.tar.xz jessie http://http.debian.net/debian 0 B - 511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158 9 months ago 0 B - -.. _cli_images: - -``images`` ----------- - -:: - - Usage: docker images [OPTIONS] [NAME] - - List images - - -a, --all=false: Show all images (by default filter out the intermediate image layers) - --no-trunc=false: Don't truncate output - -q, --quiet=false: Only show numeric IDs - -The default ``docker images`` will show all top level images, their repository -and tags, and their virtual size. - -Docker images have intermediate layers that increase reuseability, decrease -disk usage, and speed up ``docker build`` by allowing each step to be cached. -These intermediate layers are not shown by default. - -Listing the most recently created images -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker images | head - REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE - 77af4d6b9913 19 hours ago 1.089 GB - committest latest b6fa739cedf5 19 hours ago 1.089 GB - 78a85c484f71 19 hours ago 1.089 GB - docker latest 30557a29d5ab 20 hours ago 1.089 GB - 0124422dd9f9 20 hours ago 1.089 GB - 18ad6fad3402 22 hours ago 1.082 GB - f9f1e26352f0 23 hours ago 1.089 GB - tryout latest 2629d1fa0b81 23 hours ago 131.5 MB - 5ed6274db6ce 24 hours ago 1.089 GB - -Listing the full length image IDs -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker images --no-trunc | head - REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE - 77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB - committest latest b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB - 78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB - docker latest 30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB - 0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB - 18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB - f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB - tryout latest 2629d1fa0b81b222fca63371ca16cbf6a0772d07759ff80e8d1369b926940074 23 hours ago 131.5 MB - 5ed6274db6ceb2397844896966ea239290555e74ef307030ebb01ff91b1914df 24 hours ago 1.089 GB - -.. _cli_import: - -``import`` ----------- - -:: - - Usage: docker import URL|- [REPOSITORY[:TAG]] - - Create an empty filesystem image and import the contents of the tarball - (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it. - -URLs must start with ``http`` and point to a single -file archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, or .txz) containing a -root filesystem. If you would like to import from a local directory or -archive, you can use the ``-`` parameter to take the data from *stdin*. - -Examples -~~~~~~~~ - -Import from a remote location -............................. - -This will create a new untagged image. - -.. code-block:: bash - - $ sudo docker import http://example.com/exampleimage.tgz - -Import from a local file -........................ - -Import to docker via pipe and *stdin*. - -.. code-block:: bash - - $ cat exampleimage.tgz | sudo docker import - exampleimagelocal:new - -Import from a local directory -............................. - -.. code-block:: bash - - $ sudo tar -c . | docker import - exampleimagedir - -Note the ``sudo`` in this example -- you must preserve the ownership of the -files (especially root ownership) during the archiving with tar. If you are not -root (or the sudo command) when you tar, then the ownerships might not get -preserved. - -.. _cli_info: - -``info`` --------- - -:: - - Usage: docker info - - Display system-wide information. - -.. code-block:: bash - - $ sudo docker info - Containers: 292 - Images: 194 - Debug mode (server): false - Debug mode (client): false - Fds: 22 - Goroutines: 67 - LXC Version: 0.9.0 - EventsListeners: 115 - Kernel Version: 3.8.0-33-generic - WARNING: No swap limit support - -When sending issue reports, please use ``docker version`` and ``docker info`` to -ensure we know how your setup is configured. - -.. _cli_inspect: - -``inspect`` ------------ - -:: - - Usage: docker inspect CONTAINER|IMAGE [CONTAINER|IMAGE...] - - Return low-level information on a container/image - - -f, --format="": Format the output using the given go template. - -By default, this will render all results in a JSON array. If a format -is specified, the given template will be executed for each result. - -Go's `text/template `_ package -describes all the details of the format. - -Examples -~~~~~~~~ - -Get an instance's IP Address -............................ - -For the most part, you can pick out any field from the JSON in a -fairly straightforward manner. - -.. code-block:: bash - - $ sudo docker inspect --format='{{.NetworkSettings.IPAddress}}' $INSTANCE_ID - -List All Port Bindings -...................... - -One can loop over arrays and maps in the results to produce simple -text output: - -.. code-block:: bash - - $ sudo docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID - -Find a Specific Port Mapping -............................ - -The ``.Field`` syntax doesn't work when the field name begins with a -number, but the template language's ``index`` function does. The -``.NetworkSettings.Ports`` section contains a map of the internal port -mappings to a list of external address/port objects, so to grab just -the numeric public port, you use ``index`` to find the specific port -map, and then ``index`` 0 contains first object inside of that. Then -we ask for the ``HostPort`` field to get the public address. - -.. code-block:: bash - - $ sudo docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID - -Get config -.......... - -The ``.Field`` syntax doesn't work when the field contains JSON data, -but the template language's custom ``json`` function does. The ``.config`` -section contains complex json object, so to grab it as JSON, you use ``json`` -to convert config object into JSON - -.. code-block:: bash - - $ sudo docker inspect --format='{{json .config}}' $INSTANCE_ID - - -.. _cli_kill: - -``kill`` --------- - -:: - - Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...] - - Kill a running container (send SIGKILL, or specified signal) - - -s, --signal="KILL": Signal to send to the container - -The main process inside the container will be sent SIGKILL, or any signal specified with option ``--signal``. - -Known Issues (kill) -~~~~~~~~~~~~~~~~~~~ - -* :issue:`197` indicates that ``docker kill`` may leave directories - behind and make it difficult to remove the container. -* :issue:`3844` lxc 1.0.0 beta3 removed ``lcx-kill`` which is used by Docker versions before 0.8.0; - see the issue for a workaround. - -.. _cli_load: - -``load`` --------- - -:: - - Usage: docker load - - Load an image from a tar archive on STDIN - - -i, --input="": Read from a tar archive file, instead of STDIN - -Loads a tarred repository from a file or the standard input stream. -Restores both images and tags. - -.. code-block:: bash - - $ sudo docker images - REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE - $ sudo docker load < busybox.tar - $ sudo docker images - REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE - busybox latest 769b9341d937 7 weeks ago 2.489 MB - $ sudo docker load --input fedora.tar - $ sudo docker images - REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE - busybox latest 769b9341d937 7 weeks ago 2.489 MB - fedora rawhide 0d20aec6529d 7 weeks ago 387 MB - fedora 20 58394af37342 7 weeks ago 385.5 MB - fedora heisenbug 58394af37342 7 weeks ago 385.5 MB - fedora latest 58394af37342 7 weeks ago 385.5 MB - - -.. _cli_login: - -``login`` ---------- - -:: - - Usage: docker login [OPTIONS] [SERVER] - - Register or Login to the docker registry server - - -e, --email="": Email - -p, --password="": Password - -u, --username="": Username - - If you want to login to a private registry you can - specify this by adding the server name. - - example: - docker login localhost:8080 - - -.. _cli_logs: - -``logs`` --------- - -:: - - Usage: docker logs [OPTIONS] CONTAINER - - Fetch the logs of a container - - -f, --follow=false: Follow log output - -The ``docker logs`` command batch-retrieves all logs present at the time of execution. - -The ``docker logs --follow`` command combines ``docker logs`` and ``docker attach``: -it will first return all logs from the beginning and then continue streaming -new output from the container's stdout and stderr. - - -.. _cli_port: - -``port`` --------- - -:: - - Usage: docker port [OPTIONS] CONTAINER PRIVATE_PORT - - Lookup the public-facing port which is NAT-ed to PRIVATE_PORT - - -.. _cli_ps: - -``ps`` ------- - -:: - - Usage: docker ps [OPTIONS] - - List containers - - -a, --all=false: Show all containers. Only running containers are shown by default. - --before="": Show only container created before Id or Name, include non-running ones. - -l, --latest=false: Show only the latest created container, include non-running ones. - -n=-1: Show n last created containers, include non-running ones. - --no-trunc=false: Don't truncate output - -q, --quiet=false: Only display numeric IDs - -s, --size=false: Display sizes, not to be used with -q - --since="": Show only containers created since Id or Name, include non-running ones. - - -Running ``docker ps`` showing 2 linked containers. - -.. code-block:: bash - - $ docker ps - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp - d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db - -``docker ps`` will show only running containers by default. To see all containers: ``docker ps -a`` - -.. _cli_pull: - -``pull`` --------- - -:: - - Usage: docker pull NAME[:TAG] - - Pull an image or a repository from the registry - -Most of your images will be created on top of a base image from the -(https://index.docker.io). - -The Docker Index contains many pre-built images that you can ``pull`` and try -without needing to define and configure your own. - -To download a particular image, or set of images (i.e., a repository), -use ``docker pull``: - -.. code-block:: bash - - $ docker pull debian - # will pull all the images in the debian repository - $ docker pull debian:testing - # will pull only the image named debian:testing and any intermediate layers - # it is based on. (typically the empty `scratch` image, a MAINTAINERs layer, - # and the un-tared base. - -.. _cli_push: - -``push`` --------- - -:: - - Usage: docker push NAME[:TAG] - - Push an image or a repository to the registry - -Use ``docker push`` to share your images on public or private registries. - -.. _cli_restart: - -``restart`` ------------ - -:: - - Usage: docker restart [OPTIONS] NAME - - Restart a running container - - -t, --time=10: Number of seconds to try to stop for before killing the container. Once killed it will then be restarted. Default=10 - -.. _cli_rm: - -``rm`` ------- - -:: - - Usage: docker rm [OPTIONS] CONTAINER - - Remove one or more containers - -l, --link="": Remove the link instead of the actual container - -f, --force=false: Force removal of running container - -v, --volumes=false: Remove the volumes associated to the container - -Known Issues (rm) -~~~~~~~~~~~~~~~~~ - -* :issue:`197` indicates that ``docker kill`` may leave directories - behind and make it difficult to remove the container. - - -Examples: -~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker rm /redis - /redis - - -This will remove the container referenced under the link ``/redis``. - - -.. code-block:: bash - - $ sudo docker rm --link /webapp/redis - /webapp/redis - - -This will remove the underlying link between ``/webapp`` and the ``/redis`` containers removing all -network communication. - -.. code-block:: bash - - $ sudo docker rm $(docker ps -a -q) - - -This command will delete all stopped containers. The command ``docker ps -a -q`` will return all -existing container IDs and pass them to the ``rm`` command which will delete them. Any running -containers will not be deleted. - -.. _cli_rmi: - -``rmi`` -------- - -:: - - Usage: docker rmi IMAGE [IMAGE...] - - Remove one or more images - - -f, --force=false: Force - --no-prune=false: Do not delete untagged parents - -Removing tagged images -~~~~~~~~~~~~~~~~~~~~~~ - -Images can be removed either by their short or long ID's, or their image names. -If an image has more than one name, each of them needs to be removed before the -image is removed. - -.. code-block:: bash - - $ sudo docker images - REPOSITORY TAG IMAGE ID CREATED SIZE - test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) - test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) - test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) - - $ sudo docker rmi fd484f19954f - Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories - 2013/12/11 05:47:16 Error: failed to remove one or more images - - $ sudo docker rmi test1 - Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 - $ sudo docker rmi test2 - Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 - - $ sudo docker images - REPOSITORY TAG IMAGE ID CREATED SIZE - test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) - $ sudo docker rmi test - Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 - Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 - - -.. _cli_run: - -``run`` -------- - -:: - - Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] - - Run a command in a new container - - -a, --attach=map[]: Attach to stdin, stdout or stderr - -c, --cpu-shares=0: CPU shares (relative weight) - --cidfile="": Write the container ID to the file - -d, --detach=false: Detached mode: Run container in the background, print new container id - -e, --env=[]: Set environment variables - --env-file="": Read in a line delimited file of ENV variables - -h, --hostname="": Container host name - -i, --interactive=false: Keep stdin open even if not attached - --privileged=false: Give extended privileges to this container - -m, --memory="": Memory limit (format: , where unit = b, k, m or g) - -n, --networking=true: Enable networking for this container - -p, --publish=[]: Map a network port to the container - --rm=false: Automatically remove the container when it exits (incompatible with -d) - -t, --tty=false: Allocate a pseudo-tty - -u, --user="": Username or UID - --dns=[]: Set custom dns servers for the container - --dns-search=[]: Set custom DNS search domains for the container - -v, --volume=[]: 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. - --volumes-from="": Mount all volumes from the given container(s) - --entrypoint="": Overwrite the default entrypoint set by the image - -w, --workdir="": Working directory inside the container - --lxc-conf=[]: (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" - --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) - --expose=[]: Expose a port from the container without publishing it to your host - --link="": Add link to another container (name:alias) - --name="": Assign the specified name to the container. If no name is specific docker will generate a random name - -P, --publish-all=false: Publish all exposed ports to the host interfaces - -The ``docker run`` command first ``creates`` a writeable container layer over -the specified image, and then ``starts`` it using the specified command. That -is, ``docker run`` is equivalent to the API ``/containers/create`` then -``/containers/(id)/start``. -A stopped container can be restarted with all its previous changes intact using -``docker start``. See ``docker ps -a`` to view a list of all containers. - -The ``docker run`` command can be used in combination with ``docker commit`` to -:ref:`change the command that a container runs `. - -See :ref:`port_redirection` for more detailed information about the ``--expose``, -``-p``, ``-P`` and ``--link`` parameters, and :ref:`working_with_links_names` for -specific examples using ``--link``. - -Known Issues (run --volumes-from) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* :issue:`2702`: "lxc-start: Permission denied - failed to mount" - could indicate a permissions problem with AppArmor. Please see the - issue for a workaround. - -Examples: -~~~~~~~~~ - -.. code-block:: bash - - $ sudo docker run --cidfile /tmp/docker_test.cid ubuntu echo "test" - -This will create a container and print ``test`` to the console. The -``cidfile`` flag makes Docker attempt to create a new file and write the -container ID to it. If the file exists already, Docker will return an -error. Docker will close this file when ``docker run`` exits. - -.. code-block:: bash - - $ sudo docker run -t -i --rm ubuntu bash - root@bc338942ef20:/# mount -t tmpfs none /mnt - mount: permission denied - - -This will *not* work, because by default, most potentially dangerous -kernel capabilities are dropped; including ``cap_sys_admin`` (which is -required to mount filesystems). However, the ``--privileged`` flag will -allow it to run: - -.. code-block:: bash - - $ sudo docker run --privileged ubuntu bash - root@50e3f57e16e6:/# mount -t tmpfs none /mnt - root@50e3f57e16e6:/# df -h - Filesystem Size Used Avail Use% Mounted on - none 1.9G 0 1.9G 0% /mnt - - -The ``--privileged`` flag gives *all* capabilities to the container, -and it also lifts all the limitations enforced by the ``device`` -cgroup controller. In other words, the container can then do almost -everything that the host can do. This flag exists to allow special -use-cases, like running Docker within Docker. - -.. code-block:: bash - - $ sudo docker run -w /path/to/dir/ -i -t ubuntu pwd - -The ``-w`` lets the command being executed inside directory given, -here ``/path/to/dir/``. If the path does not exists it is created inside the -container. - -.. code-block:: bash - - $ sudo docker run -v `pwd`:`pwd` -w `pwd` -i -t ubuntu pwd - -The ``-v`` flag mounts the current working directory into the container. -The ``-w`` lets the command being executed inside the current -working directory, by changing into the directory to the value -returned by ``pwd``. So this combination executes the command -using the container, but inside the current working directory. - -.. code-block:: bash - - $ sudo docker run -v /doesnt/exist:/foo -w /foo -i -t ubuntu bash - -When the host directory of a bind-mounted volume doesn't exist, Docker -will automatically create this directory on the host for you. In the -example above, Docker will create the ``/doesnt/exist`` folder before -starting your container. - -.. code-block:: bash - - $ sudo docker run -t -i -v /var/run/docker.sock:/var/run/docker.sock -v ./static-docker:/usr/bin/docker busybox sh - -By bind-mounting the docker unix socket and statically linked docker binary -(such as that provided by https://get.docker.io), you give the container -the full access to create and manipulate the host's docker daemon. - -.. code-block:: bash - - $ sudo docker run -p 127.0.0.1:80:8080 ubuntu bash - -This binds port ``8080`` of the container to port ``80`` on ``127.0.0.1`` of the -host machine. :ref:`port_redirection` explains in detail how to manipulate ports -in Docker. - -.. code-block:: bash - - $ sudo docker run --expose 80 ubuntu bash - -This exposes port ``80`` of the container for use within a link without -publishing the port to the host system's interfaces. :ref:`port_redirection` -explains in detail how to manipulate ports in Docker. - -.. code-block:: bash - - $ sudo docker run -e MYVAR1 --env MYVAR2=foo --env-file ./env.list ubuntu bash - -This sets environmental variables in the container. For illustration all three -flags are shown here. Where ``-e``, ``--env`` take an environment variable and -value, or if no "=" is provided, then that variable's current value is passed -through (i.e. $MYVAR1 from the host is set to $MYVAR1 in the container). All -three flags, ``-e``, ``--env`` and ``--env-file`` can be repeated. - -Regardless of the order of these three flags, the ``--env-file`` are processed -first, and then ``-e``/``--env`` flags. This way, the ``-e`` or ``--env`` will -override variables as needed. - -.. code-block:: bash - - $ cat ./env.list - TEST_FOO=BAR - $ sudo docker run --env TEST_FOO="This is a test" --env-file ./env.list busybox env | grep TEST_FOO - TEST_FOO=This is a test - -The ``--env-file`` flag takes a filename as an argument and expects each line -to be in the VAR=VAL format, mimicking the argument passed to ``--env``. -Comment lines need only be prefixed with ``#`` - -An example of a file passed with ``--env-file`` - -.. code-block:: bash - - $ cat ./env.list - TEST_FOO=BAR - - # this is a comment - TEST_APP_DEST_HOST=10.10.0.127 - TEST_APP_DEST_PORT=8888 - - # pass through this variable from the caller - TEST_PASSTHROUGH - $ sudo TEST_PASSTHROUGH=howdy docker run --env-file ./env.list busybox env - HOME=/ - PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin - HOSTNAME=5198e0745561 - TEST_FOO=BAR - TEST_APP_DEST_HOST=10.10.0.127 - TEST_APP_DEST_PORT=8888 - TEST_PASSTHROUGH=howdy - - -.. code-block:: bash - - $ sudo docker run --name console -t -i ubuntu bash - -This will create and run a new container with the container name -being ``console``. - -.. code-block:: bash - - $ sudo docker run --link /redis:redis --name console ubuntu bash - -The ``--link`` flag will link the container named ``/redis`` into the -newly created container with the alias ``redis``. The new container -can access the network and environment of the redis container via -environment variables. The ``--name`` flag will assign the name ``console`` -to the newly created container. - -.. code-block:: bash - - $ sudo docker run --volumes-from 777f7dc92da7,ba8c0c54f0f2:ro -i -t ubuntu pwd - -The ``--volumes-from`` flag mounts all the defined volumes from the -referenced containers. Containers can be specified by a comma separated -list or by repetitions of the ``--volumes-from`` argument. The container -ID may be optionally suffixed with ``:ro`` or ``:rw`` to mount the volumes in -read-only or read-write mode, respectively. By default, the volumes are mounted -in the same mode (read write or read only) as the reference container. - -The ``-a`` flag tells ``docker run`` to bind to the container's stdin, stdout -or stderr. This makes it possible to manipulate the output and input as needed. - -.. code-block:: bash - - $ sudo echo "test" | docker run -i -a stdin ubuntu cat - - -This pipes data into a container and prints the container's ID by attaching -only to the container's stdin. - -.. code-block:: bash - - $ sudo docker run -a stderr ubuntu echo test - -This isn't going to print anything unless there's an error because we've only -attached to the stderr of the container. The container's logs still store -what's been written to stderr and stdout. - -.. code-block:: bash - - $ sudo cat somefile | docker run -i -a stdin mybuilder dobuild - -This is how piping a file into a container could be done for a build. -The container's ID will be printed after the build is done and the build logs -could be retrieved using ``docker logs``. This is useful if you need to pipe -a file or something else into a container and retrieve the container's ID once -the container has finished running. - - -A complete example -.................. - -.. code-block:: bash - - $ sudo docker run -d --name static static-web-files sh - $ sudo docker run -d --expose=8098 --name riak riakserver - $ sudo docker run -d -m 100m -e DEVELOPMENT=1 -e BRANCH=example-code -v $(pwd):/app/bin:ro --name app appserver - $ sudo docker run -d -p 1443:443 --dns=dns.dev.org --dns-search=dev.org -v /var/log/httpd --volumes-from static --link riak --link app -h www.sven.dev.org --name web webserver - $ sudo docker run -t -i --rm --volumes-from web -w /var/log/httpd busybox tail -f access.log - -This example shows 5 containers that might be set up to test a web application change: - -1. Start a pre-prepared volume image ``static-web-files`` (in the background) that has CSS, image and static HTML in it, (with a ``VOLUME`` instruction in the ``Dockerfile`` to allow the web server to use those files); -2. Start a pre-prepared ``riakserver`` image, give the container name ``riak`` and expose port ``8098`` to any containers that link to it; -3. Start the ``appserver`` image, restricting its memory usage to 100MB, setting two environment variables ``DEVELOPMENT`` and ``BRANCH`` and bind-mounting the current directory (``$(pwd)``) in the container in read-only mode as ``/app/bin``; -4. Start the ``webserver``, mapping port ``443`` in the container to port ``1443`` on the Docker server, setting the DNS server to ``dns.dev.org`` and DNS search domain to ``dev.org``, creating a volume to put the log files into (so we can access it from another container), then importing the files from the volume exposed by the ``static`` container, and linking to all exposed ports from ``riak`` and ``app``. Lastly, we set the hostname to ``web.sven.dev.org`` so its consistent with the pre-generated SSL certificate; -5. Finally, we create a container that runs ``tail -f access.log`` using the logs volume from the ``web`` container, setting the workdir to ``/var/log/httpd``. The ``--rm`` option means that when the container exits, the container's layer is removed. - - -.. _cli_save: - -``save`` ---------- - -:: - - Usage: docker save IMAGE - - Save an image to a tar archive (streamed to stdout by default) - - -o, --output="": Write to an file, instead of STDOUT - - -Produces a tarred repository to the standard output stream. -Contains all parent layers, and all tags + versions, or specified repo:tag. - -It is used to create a backup that can then be used with ``docker load`` - -.. code-block:: bash - - $ sudo docker save busybox > busybox.tar - $ ls -sh b.tar - 2.7M b.tar - $ sudo docker save --output busybox.tar busybox - $ ls -sh b.tar - 2.7M b.tar - $ sudo docker save -o fedora-all.tar fedora - $ sudo docker save -o fedora-latest.tar fedora:latest - - -.. _cli_search: - -``search`` ----------- - -:: - - Usage: docker search TERM - - Search the docker index for images - - --no-trunc=false: Don't truncate output - -s, --stars=0: Only displays with at least xxx stars - -t, --trusted=false: Only show trusted builds - -See :ref:`searching_central_index` for more details on finding shared images -from the commandline. - -.. _cli_start: - -``start`` ---------- - -:: - - Usage: docker start [OPTIONS] CONTAINER - - Start a stopped container - - -a, --attach=false: Attach container᾿s stdout/stderr and forward all signals to the process - -i, --interactive=false: Attach container᾿s stdin - -.. _cli_stop: - -``stop`` --------- - -:: - - Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...] - - Stop a running container (Send SIGTERM, and then SIGKILL after grace period) - - -t, --time=10: Number of seconds to wait for the container to stop before killing it. - -The main process inside the container will receive SIGTERM, and after a grace period, SIGKILL - -.. _cli_tag: - -``tag`` -------- - -:: - - Usage: docker tag [OPTIONS] IMAGE [REGISTRYHOST/][USERNAME/]NAME[:TAG] - - Tag an image into a repository - - -f, --force=false: Force - -You can group your images together using names and -tags, and then upload them to :ref:`working_with_the_repository`. - -.. _cli_top: - -``top`` -------- - -:: - - Usage: docker top CONTAINER [ps OPTIONS] - - Lookup the running processes of a container - -.. _cli_version: - -``version`` ------------ - -Show the version of the Docker client, daemon, and latest released version. - - -.. _cli_wait: - -``wait`` --------- - -:: - - Usage: docker wait [OPTIONS] NAME - - Block until a container stops, then print its exit code. diff --git a/docs/sources/reference/commandline/index.rst b/docs/sources/reference/commandline/index.rst deleted file mode 100644 index 5536e1012e..0000000000 --- a/docs/sources/reference/commandline/index.rst +++ /dev/null @@ -1,14 +0,0 @@ -:title: Commands -:description: docker command line interface -:keywords: commands, command line, help, docker - - -Commands -======== - -Contents: - -.. toctree:: - :maxdepth: 1 - - cli diff --git a/docs/sources/reference/index.rst b/docs/sources/reference/index.rst deleted file mode 100644 index d35a19b93d..0000000000 --- a/docs/sources/reference/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -:title: Docker Reference Manual -:description: References -:keywords: docker, references, api, command line, commands - -.. _references: - -Reference Manual -================ - -Contents: - -.. toctree:: - :maxdepth: 1 - - commandline/index - builder - run - api/index diff --git a/docs/sources/reference/run.rst b/docs/sources/reference/run.rst deleted file mode 100644 index 0e6247ea28..0000000000 --- a/docs/sources/reference/run.rst +++ /dev/null @@ -1,418 +0,0 @@ -:title: Docker Run Reference -:description: Configure containers at runtime -:keywords: docker, run, configure, runtime - -.. _run_docker: - -==================== -Docker Run Reference -==================== - -**Docker runs processes in isolated containers**. When an operator -executes ``docker run``, she starts a process with its own file -system, its own networking, and its own isolated process tree. The -:ref:`image_def` which starts the process may define defaults related -to the binary to run, the networking to expose, and more, but ``docker -run`` gives final control to the operator who starts the container -from the image. That's the main reason :ref:`cli_run` has more options -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. - -.. _run_running: - -General Form -============ - -As you've seen in the :ref:`example_list`, the basic `run` command -takes this form:: - - docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] - -To learn how to interpret the types of ``[OPTIONS]``, see -:ref:`cli_options`. - -The list of ``[OPTIONS]`` breaks down into two groups: - -1. Settings exclusive to operators, including: - - * Detached or Foreground running, - * Container Identification, - * Network settings, and - * Runtime Constraints on CPU and Memory - * Privileges and LXC Configuration - -2. Setting shared between operators and developers, where operators - can override defaults developers set in images at build time. - -Together, the ``docker run [OPTIONS]`` give complete control over -runtime behavior to the operator, allowing them to override all -defaults set by the developer during ``docker build`` and nearly all -the defaults set by the Docker runtime itself. - -Operator Exclusive Options -========================== - -Only the operator (the person executing ``docker run``) can set the -following options. - -.. contents:: - :local: - -Detached vs Foreground ----------------------- - -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 -default foreground mode:: - - -d=false: Detached mode: Run container in the background, print new container id - -Detached (-d) -............. - -In detached mode (``-d=true`` or just ``-d``), all I/O should be done -through network connections or shared 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`` -:ref:`cli_attach`. If you choose to run a container in the detached -mode, then you cannot use the ``--rm`` option. - -Foreground -.......... - -In foreground mode (the default when ``-d`` is not specified), -``docker run`` can start the process in the container and attach the -console to the process's standard input, 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 - -If you do not specify ``-a`` then Docker will `attach everything -(stdin,stdout,stderr) -`_. You -can specify to which of the three standard streams (``stdin``, ``stdout``, -``stderr``) you'd like to connect instead, as in:: - - docker run -a stdin -a stdout -i -t ubuntu /bin/bash - -For interactive processes (like a shell) you will typically want a tty -as well as persistent standard input (``stdin``), so you'll use ``-i --t`` together in most interactive cases. - -Container Identification ------------------------- - -Name (--name) -............. - -The operator can identify a container in three ways: - -* UUID long identifier ("f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778") -* UUID short identifier ("f78375b1c487") -* 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 :ref:`links ` (or any other place -you need to identify a container). This works for both background and -foreground Docker containers. - -PID Equivalent -.............. - -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 - -Network Settings ----------------- - -:: - - -n=true : Enable networking for this 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 with ``docker run -n`` which disables all incoming and 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``. - -Clean Up (--rm) ---------------- - -By default a container's file system persists even after the container -exits. This makes debugging a lot easier (since you can inspect the -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:: - - --rm=false: Automatically remove the container when it exits (incompatible with -d) - - -Runtime Constraints on CPU and Memory -------------------------------------- - -The operator can also adjust the performance parameters of the container:: - - -m="": Memory limit (format: , where unit = b, k, m or g) - -c=0 : CPU shares (relative weight) - -The operator can constrain the memory available to a container easily -with ``docker run -m``. If the host supports swap memory, then the -``-m`` memory setting can be larger than physical RAM. - -Similarly the operator can increase the priority of this container -with the ``-c`` option. By default, all containers run at 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 ---------------------------------------- - -:: - - --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 by default a container is not allowed to access any devices, -but a "privileged" container is given access to all devices (see -lxc-template.go_ and documentation on `cgroups devices -`_). - -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`` is -available on the `Docker Blog -`_. - -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_. -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. - -.. _lxc-template.go: https://github.com/dotcloud/docker/blob/master/execdriver/lxc/lxc_template.go - - -Overriding ``Dockerfile`` Image Defaults -======================================== - -When a developer builds an image from a :ref:`Dockerfile -` or when she commits it, the developer can set a -number of default parameters that take effect when the image starts up -as a container. - -Four of the ``Dockerfile`` commands cannot be overridden at runtime: -``FROM, MAINTAINER, RUN``, and ``ADD``. Everything else has a -corresponding override in ``docker run``. We'll go through what the -developer might have set in each ``Dockerfile`` instruction and how the -operator can override that setting. - -.. contents:: - :local: - -CMD (Default Command or Options) --------------------------------- - -Recall the optional ``COMMAND`` in the Docker commandline:: - - docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] - -This command is optional because the person who created the ``IMAGE`` -may have already provided a default ``COMMAND`` using the ``Dockerfile`` -``CMD``. As the operator (the person running a container from the -image), you can override that ``CMD`` just by specifying a new -``COMMAND``. - -If the image also specifies an ``ENTRYPOINT`` then the ``CMD`` or -``COMMAND`` get appended as arguments to the ``ENTRYPOINT``. - - -ENTRYPOINT (Default Command to Execute at Runtime -------------------------------------------------- - -:: - - --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, but it is -(purposely) more difficult to override. The ``ENTRYPOINT`` gives a -container its default nature or behavior, so that when you set an -``ENTRYPOINT`` you can run the container *as if it were that binary*, -complete with default options, and you can pass in more options via -the ``COMMAND``. But, sometimes an operator may want to run something else -inside the container, so you can override the default ``ENTRYPOINT`` at -runtime by using a string to specify 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 - -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 - - -EXPOSE (Incoming Ports) ------------------------ - -The ``Dockerfile`` doesn't give much control over networking, only -providing the ``EXPOSE`` instruction 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 - 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) - -As mentioned previously, ``EXPOSE`` (and ``--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 inside the container you might -have an HTTP service listening on port 80 (and so you ``EXPOSE 80`` in -the ``Dockerfile``), but outside the container the port might be 42800. - -To help a new client container reach the server container's internal -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``. - -If the operator uses ``-P`` or ``-p`` then Docker will make the -exposed port accessible on the host 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 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) ---------------------------- - -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``:: - - $ docker run -e "deep=purple" --rm ubuntu /bin/bash -c export - declare -x HOME="/" - declare -x HOSTNAME="85bc26a0e200" - declare -x OLDPWD - declare -x PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" - declare -x PWD="/" - declare -x SHLVL="1" - declare -x container="lxc" - declare -x deep="purple" - -Similarly the operator can set the **hostname** with ``-h``. - -``--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 - 4241164edf6f5aca5b0e9e4c9eccd899b0b8080c64c0cd26efe02166c73208f3 - - # The redis-name container exposed port 6379 - $ docker ps - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 4241164edf6f dockerfiles/redis:latest /redis-stable/src/re 5 seconds ago Up 4 seconds 6379/tcp redis-name - - # Note that there are no public ports exposed since we didn't use -p or -P - $ docker port 4241164edf6f 6379 - 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! - -:: - - $ 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 - declare -x PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" - declare -x PWD="/" - declare -x REDIS_ALIAS_NAME="/distracted_wright/redis" - declare -x REDIS_ALIAS_PORT="tcp://172.17.0.32:6379" - declare -x REDIS_ALIAS_PORT_6379_TCP="tcp://172.17.0.32:6379" - declare -x REDIS_ALIAS_PORT_6379_TCP_ADDR="172.17.0.32" - declare -x REDIS_ALIAS_PORT_6379_TCP_PORT="6379" - declare -x REDIS_ALIAS_PORT_6379_TCP_PROTO="tcp" - declare -x SHLVL="1" - declare -x container="lxc" - -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' - 172.17.0.32:6379> - -VOLUME (Shared Filesystems) ---------------------------- - -:: - - -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) - -The volumes commands are complex enough to have their own -documentation in section :ref:`volume_def`. A developer can define one -or more ``VOLUME``\s associated with an image, but only the operator can -give access from one container to another (or from a container to a -volume mounted on the host). - -USER ----- - -The default user within a container is ``root`` (id = 0), but if the -developer created additional users, those are accessible too. The -developer can set a default user to run the first process with the -``Dockerfile USER`` command, but the operator can override it :: - - -u="": Username or UID - -WORKDIR -------- - -The default working directory for running binaries within a container is the root directory (``/``), but the developer can set a different default with the ``Dockerfile WORKDIR`` command. The operator can override this with:: - - -w="": Working directory inside the container - diff --git a/docs/sources/terms/container.rst b/docs/sources/terms/container.rst deleted file mode 100644 index 206664bd82..0000000000 --- a/docs/sources/terms/container.rst +++ /dev/null @@ -1,47 +0,0 @@ -:title: Container -:description: Definitions of a container -:keywords: containers, lxc, concepts, explanation, image, container - -.. _container_def: - -Container -========= - -.. image:: images/docker-filesystems-busyboxrw.png - -Once you start a process in Docker from an :ref:`image_def`, Docker -fetches the image and its :ref:`parent_image_def`, and repeats the -process until it reaches the :ref:`base_image_def`. Then the -:ref:`ufs_def` adds a read-write layer on top. That read-write layer, -plus the information about its :ref:`parent_image_def` and some -additional information like its unique id, networking configuration, -and resource limits is called a **container**. - -.. _container_state_def: - -Container State -............... - -Containers can change, and so they have state. A container may be -**running** or **exited**. - -When a container is running, the idea of a "container" also includes a -tree of processes running on the CPU, isolated from the other -processes running on the host. - -When the container is exited, the state of the file system and -its exit value is preserved. You can start, stop, and restart a -container. The processes restart from scratch (their memory state is -**not** preserved in a container), but the file system is just as it -was when the container was stopped. - -You can promote a container to an :ref:`image_def` with ``docker -commit``. Once a container is an image, you can use it as a parent for -new containers. - -Container IDs -............. -All containers are identified by a 64 hexadecimal digit string (internally a 256bit -value). To simplify their use, a short ID of the first 12 characters can be used -on the commandline. There is a small possibility of short id collisions, so the -docker server will always return the long ID. diff --git a/docs/sources/terms/filesystem.rst b/docs/sources/terms/filesystem.rst deleted file mode 100644 index 0af893f198..0000000000 --- a/docs/sources/terms/filesystem.rst +++ /dev/null @@ -1,38 +0,0 @@ -:title: File Systems -:description: How Linux organizes its persistent storage -:keywords: containers, files, linux - -.. _filesystem_def: - -File System -=========== - -.. image:: images/docker-filesystems-generic.png - -In order for a Linux system to run, it typically needs two `file -systems `_: - -1. boot file system (bootfs) -2. root file system (rootfs) - -The **boot file system** contains the bootloader and the kernel. The -user never makes any changes to the boot file system. In fact, soon -after the boot process is complete, the entire kernel is in memory, -and the boot file system is unmounted to free up the RAM associated -with the initrd disk image. - - -The **root file system** includes the typical directory structure we -associate with Unix-like operating systems: ``/dev, /proc, /bin, /etc, -/lib, /usr,`` and ``/tmp`` plus all the configuration files, binaries -and libraries required to run user applications (like bash, ls, and so -forth). - -While there can be important kernel differences between different -Linux distributions, the contents and organization of the root file -system are usually what make your software packages dependent on one -distribution versus another. Docker can help solve this problem by -running multiple distributions at the same time. - -.. image:: images/docker-filesystems-multiroot.png - diff --git a/docs/sources/terms/image.rst b/docs/sources/terms/image.rst deleted file mode 100644 index 6d5c8b2e7c..0000000000 --- a/docs/sources/terms/image.rst +++ /dev/null @@ -1,46 +0,0 @@ -:title: Images -:description: Definition of an image -:keywords: containers, lxc, concepts, explanation, image, container - -.. _image_def: - -Image -===== - -.. image:: images/docker-filesystems-debian.png - -In Docker terminology, a read-only :ref:`layer_def` is called an -**image**. An image never changes. - -Since Docker uses a :ref:`ufs_def`, the processes think the whole file -system is mounted read-write. But all the changes go to the top-most -writeable layer, and underneath, the original file in the read-only -image is unchanged. Since images don't change, images do not have state. - -.. image:: images/docker-filesystems-debianrw.png - -.. _parent_image_def: - -Parent Image -............ - -.. image:: images/docker-filesystems-multilayer.png - -Each image may depend on one more image which forms the layer beneath -it. We sometimes say that the lower image is the **parent** of the -upper image. - -.. _base_image_def: - -Base Image -.......... - -An image that has no parent is a **base image**. - -Image IDs -......... -All images are identified by a 64 hexadecimal digit string (internally a 256bit -value). To simplify their use, a short ID of the first 12 characters can be used -on the command line. There is a small possibility of short id collisions, so the -docker server will always return the long ID. - diff --git a/docs/sources/terms/index.rst b/docs/sources/terms/index.rst deleted file mode 100644 index 40851082b5..0000000000 --- a/docs/sources/terms/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -:title: Glossary -:description: Definitions of terms used in Docker documentation -:keywords: concepts, documentation, docker, containers - - - -Glossary -======== - -Definitions of terms used in Docker documentation. - -Contents: - -.. toctree:: - :maxdepth: 1 - - filesystem - layer - image - container - registry - repository - - diff --git a/docs/sources/terms/layer.rst b/docs/sources/terms/layer.rst deleted file mode 100644 index 509dbe5cba..0000000000 --- a/docs/sources/terms/layer.rst +++ /dev/null @@ -1,40 +0,0 @@ -:title: Layers -:description: Organizing the Docker Root File System -:keywords: containers, lxc, concepts, explanation, image, container - -Layers -====== - -In a traditional Linux boot, the kernel first mounts the root -:ref:`filesystem_def` as read-only, checks its integrity, and then -switches the whole rootfs volume to read-write mode. - -.. _layer_def: - -Layer -..... - -When Docker mounts the rootfs, it starts read-only, as in a traditional -Linux boot, but then, instead of changing the file system to -read-write mode, it takes advantage of a `union mount -`_ to add a read-write file -system *over* the read-only file system. In fact there may be multiple -read-only file systems stacked on top of each other. We think of each -one of these file systems as a **layer**. - -.. image:: images/docker-filesystems-multilayer.png - -At first, the top read-write layer has nothing in it, but any time a -process creates a file, this happens in the top layer. And if -something needs to update an existing file in a lower layer, then the -file gets copied to the upper layer and changes go into the copy. The -version of the file on the lower layer cannot be seen by the -applications anymore, but it is there, unchanged. - -.. _ufs_def: - -Union File System -................. - -We call the union of the read-write layer and all the read-only layers -a **union file system**. diff --git a/docs/sources/terms/registry.rst b/docs/sources/terms/registry.rst deleted file mode 100644 index 90c3ee721c..0000000000 --- a/docs/sources/terms/registry.rst +++ /dev/null @@ -1,16 +0,0 @@ -:title: Registry -:description: Definition of an Registry -:keywords: containers, lxc, concepts, explanation, image, repository, container - -.. _registry_def: - -Registry -========== - -A Registry is a hosted service containing :ref:`repositories` -of :ref:`images` which responds to the Registry API. - -The default registry can be accessed using a browser at http://images.docker.io -or using the ``sudo docker search`` command. - -For more information see :ref:`Working with Repositories` diff --git a/docs/sources/terms/repository.rst b/docs/sources/terms/repository.rst deleted file mode 100644 index 04f3950f36..0000000000 --- a/docs/sources/terms/repository.rst +++ /dev/null @@ -1,30 +0,0 @@ -:title: Repository -:description: Definition of an Repository -:keywords: containers, lxc, concepts, explanation, image, repository, container - -.. _repository_def: - -Repository -========== - -A repository is a set of images either on your local Docker server, or -shared, by pushing it to a :ref:`Registry` server. - -Images can be associated with a repository (or multiple) by giving them an image name -using one of three different commands: - -1. At build time (e.g. ``sudo docker build -t IMAGENAME``), -2. When committing a container (e.g. ``sudo docker commit CONTAINERID IMAGENAME``) or -3. When tagging an image id with an image name (e.g. ``sudo docker tag IMAGEID IMAGENAME``). - -A `Fully Qualified Image Name` (FQIN) can be made up of 3 parts: - -``[registry_hostname[:port]/][user_name/](repository_name:version_tag)`` - -``username`` and ``registry_hostname`` default to an empty string. -When ``registry_hostname`` is an empty string, then ``docker push`` will push to ``index.docker.io:80``. - -If you create a new repository which you want to share, you will need to set at least the -``user_name``, as the 'default' blank ``user_name`` prefix is reserved for official Docker images. - -For more information see :ref:`Working with Repositories` diff --git a/docs/sources/toctree.rst b/docs/sources/toctree.rst deleted file mode 100644 index d09bcc313c..0000000000 --- a/docs/sources/toctree.rst +++ /dev/null @@ -1,21 +0,0 @@ -:title: Documentation -:description: -- todo: change me -:keywords: todo, docker, documentation, installation, usage, examples, contributing, faq, command line, concepts - -Documentation -============= - -This documentation has the following resources: - -.. toctree:: - :maxdepth: 1 - - installation/index - use/index - examples/index - reference/index - contributing/index - terms/index - articles/index - faq - diff --git a/docs/sources/use/ambassador_pattern_linking.rst b/docs/sources/use/ambassador_pattern_linking.rst deleted file mode 100644 index bbd5816768..0000000000 --- a/docs/sources/use/ambassador_pattern_linking.rst +++ /dev/null @@ -1,183 +0,0 @@ -:title: Link via an Ambassador Container -:description: Using the Ambassador pattern to abstract (network) services -:keywords: Examples, Usage, links, docker, documentation, examples, names, name, container naming - -.. _ambassador_pattern_linking: - -Link via an Ambassador Container -================================ - -Rather than hardcoding network links between a service consumer and provider, Docker -encourages service portability. - -eg, instead of - -.. code-block:: bash - - (consumer) --> (redis) - -requiring you to restart the ``consumer`` to attach it to a different ``redis`` service, -you can add ambassadors - -.. code-block:: bash - - (consumer) --> (redis-ambassador) --> (redis) - - or - - (consumer) --> (redis-ambassador) ---network---> (redis-ambassador) --> (redis) - -When you need to rewire your consumer to talk to a different redis server, you -can just restart the ``redis-ambassador`` container that the consumer is connected to. - -This pattern also allows you to transparently move the redis server to a different -docker host from the consumer. - -Using the ``svendowideit/ambassador`` container, the link wiring is controlled entirely -from the ``docker run`` parameters. - -Two host Example ----------------- - -Start actual redis server on one Docker host - -.. code-block:: bash - - 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 - -.. code-block:: bash - - 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`` - -.. code-block:: bash - - 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. - -.. code-block:: bash - - client-server $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli - redis 172.17.0.160:6379> ping - PONG - - - -How it works ------------- - -The following example shows what the ``svendowideit/ambassador`` container does -automatically (with a tiny amount of ``sed``) - -On the docker host (192.168.1.52) that redis will run on: - -.. code-block:: bash - - # start actual redis server - $ 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 - 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 - -in the redis_ambassador container, you can see the linked redis containers's env - -.. code-block:: bash - - $ env - REDIS_PORT=tcp://172.17.0.136:6379 - REDIS_PORT_6379_TCP_ADDR=172.17.0.136 - REDIS_NAME=/redis_ambassador/redis - HOSTNAME=19d7adf4705e - REDIS_PORT_6379_TCP_PORT=6379 - HOME=/ - REDIS_PORT_6379_TCP_PROTO=tcp - container=lxc - REDIS_PORT_6379_TCP=tcp://172.17.0.136:6379 - TERM=xterm - PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin - PWD=/ - - -This environment is used by the ambassador socat script to expose redis to the world -(via the -p 6379:6379 port mapping) - -.. code-block:: bash - - $ 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 - - $ socat TCP4-LISTEN:6379,fork,reuseaddr TCP4:172.17.0.136:6379 - -then ping the redis server via the ambassador - -.. code-block::bash - - $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli - redis 172.17.0.160:6379> ping - PONG - -Now goto a different server - -.. code-block:: bash - - $ sudo ./contrib/mkimage-unittest.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 - -.. code-block:: bash - - $ docker pull relateiq/redis-cli - $ docker run -i -t --rm --link redis_ambassador:redis relateiq/redis-cli - redis 172.17.0.160:6379> ping - PONG - -The svendowideit/ambassador Dockerfile --------------------------------------- - -The ``svendowideit/ambassador`` image is a small busybox image with ``socat`` built in. -When you start the container, it uses a small ``sed`` script to parse 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`` will forward the -local ``1234`` port to the remote IP and port - in this case ``192.168.1.52:6379``. - - -:: - - # - # - # first you need to build the docker-ut image - # using ./contrib/mkimage-unittest.sh - # then - # 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 - # on the remote host, you can set up another ambassador - # 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 - diff --git a/docs/sources/use/basics.rst b/docs/sources/use/basics.rst deleted file mode 100644 index 4164e706f7..0000000000 --- a/docs/sources/use/basics.rst +++ /dev/null @@ -1,199 +0,0 @@ -:title: First steps with Docker -:description: Common usage and commands -:keywords: Examples, Usage, basic commands, docker, documentation, examples - - -First steps with Docker -======================= - -Check your Docker install -------------------------- - -This guide assumes you have a working installation of Docker. To check -your Docker install, run the following command: - -.. code-block:: bash - - # Check that you have a working install - docker info - -If you get ``docker: command not found`` or something like -``/var/lib/docker/repositories: permission denied`` you may have an incomplete -docker installation or insufficient privileges to access Docker on your machine. - -Please refer to :ref:`installation_list` for installation instructions. - -Download a pre-built image --------------------------- - -.. code-block:: bash - - # Download an ubuntu image - sudo docker pull ubuntu - -This will find the ``ubuntu`` image by name in the :ref:`Central Index -` and download it from the top-level Central -Repository to a local image cache. - -.. NOTE:: When the image has successfully downloaded, you will see a - 12 character 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 --no-trunc=true`` - - **If you're using OS X** then you shouldn't use ``sudo`` - -Running an interactive shell ----------------------------- - -.. code-block:: bash - - # Run an interactive shell in the ubuntu image, - # allocate a tty, attach stdin and stdout - # To detach the tty without exiting the shell, - # use the escape sequence Ctrl-p + Ctrl-q - # note: This will continue to exist in a stopped state once exited (see "docker ps -a") - sudo docker run -i -t ubuntu /bin/bash - -.. _bind_docker: - -Bind Docker to another host/port or a Unix socket -------------------------------------------------- - -.. warning:: Changing the default ``docker`` daemon binding to a TCP - port or Unix *docker* user group will increase your security risks - by allowing non-root users to gain *root* access on the - host. Make sure you control access to ``docker``. If you are binding - to a TCP port, anyone with access to that port has full Docker access; - so it is not advisable on an open network. - -With ``-H`` it is possible to make the Docker daemon to listen on a -specific IP and port. By default, it will listen on -``unix:///var/run/docker.sock`` to allow only local connections by the -*root* user. You *could* set it to ``0.0.0.0:4243`` or a specific host IP to -give access to everybody, but that is **not recommended** because then -it is trivial for someone to gain root access to the host where the -daemon is running. - -Similarly, the Docker client can use ``-H`` to connect to a custom port. - -``-H`` accepts host and port assignment in the following format: -``tcp://[host][:port]`` or ``unix://path`` - -For example: - -* ``tcp://host:4243`` -> tcp connection on host:4243 -* ``unix://path/to/socket`` -> unix socket located at ``path/to/socket`` - -``-H``, when empty, will default to the same value as when no ``-H`` was passed in. - -``-H`` also accepts short form for TCP bindings: -``host[:port]`` or ``:port`` - -.. code-block:: bash - - # Run docker in daemon mode - sudo /docker -H 0.0.0.0:5555 -d & - # Download an ubuntu image - sudo docker -H :5555 pull ubuntu - -You can use multiple ``-H``, for example, if you want to listen on -both TCP and a Unix socket - -.. code-block:: bash - - # Run docker in daemon mode - sudo /docker -H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock -d & - # Download an ubuntu image, use default Unix socket - sudo docker pull ubuntu - # OR use the TCP port - sudo docker -H tcp://127.0.0.1:4243 pull ubuntu - -Starting a long-running worker process --------------------------------------- - -.. code-block:: bash - - # Start a very useful long-running process - JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") - - # Collect the output of the job so far - sudo docker logs $JOB - - # Kill the job - sudo docker kill $JOB - - -Listing containers ------------------- - -.. code-block:: bash - - sudo docker ps # Lists only running containers - sudo docker ps -a # Lists all containers - - -Controlling containers ----------------------- -.. code-block:: bash - - # Start a new container - JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") - - # Stop the container - docker stop $JOB - - # Start the container - docker start $JOB - - # Restart the container - docker restart $JOB - - # SIGKILL a container - docker kill $JOB - - # Remove a container - docker stop $JOB # Container must be stopped to remove it - docker rm $JOB - - -Bind a service on a TCP port ------------------------------- - -.. code-block:: bash - - # Bind port 4444 of this container, and tell netcat to listen on it - JOB=$(sudo docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444) - - # Which public port is NATed to my container? - PORT=$(sudo docker port $JOB 4444 | awk -F: '{ print $2 }') - - # Connect to the public port - echo hello world | nc 127.0.0.1 $PORT - - # Verify that the network connection worked - echo "Daemon received: $(sudo docker logs $JOB)" - - -Committing (saving) a container state -------------------------------------- - -Save your containers state to a container image, so the state can be re-used. - -When you commit your container only the differences between the image the -container was created from and the current state of the container will be -stored (as a diff). See which images you already have using the ``docker -images`` command. - -.. code-block:: bash - - # Commit your container to a new named image - sudo docker commit - - # List your containers - sudo docker images - -You now have a image state from which you can create new instances. - -Read more about :ref:`working_with_the_repository` or continue to the -complete :ref:`cli` diff --git a/docs/sources/use/chef.rst b/docs/sources/use/chef.rst deleted file mode 100644 index 919eba7a8f..0000000000 --- a/docs/sources/use/chef.rst +++ /dev/null @@ -1,95 +0,0 @@ -:title: Chef Usage -:description: Installation and using Docker via Chef -:keywords: chef, installation, usage, docker, documentation - -.. _install_using_chef: - -Using Chef -============= - -.. note:: - - Please note this is a community contributed installation path. The - only 'official' installation is using the :ref:`ubuntu_linux` - installation path. This version may sometimes be out of date. - -Requirements ------------- - -To use this guide you'll need a working installation of -`Chef `_. This cookbook supports a variety of -operating systems. - -Installation ------------- - -The cookbook is available on the `Chef Community Site -`_ and can be installed -using your favorite cookbook dependency manager. - -The source can be found on `GitHub -`_. - -Usage ------ - -The cookbook provides recipes for installing Docker, configuring init -for Docker, and resources for managing images and containers. -It supports almost all Docker functionality. - -Installation -~~~~~~~~~~~~ - -.. code-block:: ruby - - include_recipe 'docker' - -Images -~~~~~~ - -The next step is to pull a Docker image. For this, we have a resource: - -.. code-block:: ruby - - docker_image 'samalba/docker-registry' - -This is equivalent to running: - -.. code-block:: bash - - docker pull samalba/docker-registry - -There are attributes available to control how long the cookbook -will allow for downloading (5 minute default). - -To remove images you no longer need: - -.. code-block:: ruby - - docker_image 'samalba/docker-registry' do - action :remove - end - -Containers -~~~~~~~~~~ - -Now you have an image where you can run commands within a container -managed by Docker. - -.. code-block:: ruby - - docker_container 'samalba/docker-registry' do - detach true - port '5000:5000' - env 'SETTINGS_FLAVOR=local' - volume '/mnt/docker:/docker-storage' - end - -This is equivalent to running the following command, but under upstart: - -.. code-block:: bash - - docker run --detach=true --publish='5000:5000' --env='SETTINGS_FLAVOR=local' --volume='/mnt/docker:/docker-storage' samalba/docker-registry - -The resources will accept a single string or an array of values -for any docker flags that allow multiple values. diff --git a/docs/sources/use/host_integration.rst b/docs/sources/use/host_integration.rst deleted file mode 100644 index cb920a5908..0000000000 --- a/docs/sources/use/host_integration.rst +++ /dev/null @@ -1,74 +0,0 @@ -:title: Automatically Start Containers -:description: How to generate scripts for upstart, systemd, etc. -:keywords: systemd, upstart, supervisor, docker, documentation, host integration - - - -Automatically Start Containers -============================== - -You can use your Docker containers with process managers like ``upstart``, -``systemd`` and ``supervisor``. - -Introduction ------------- - -If you want a process manager to manage your containers you will need to run -the docker daemon with the ``-r=false`` so that 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 can then attach a process manager to manage -it. When your run ``docker start -a`` docker will 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 -``--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: - -.. code-block:: bash - - description "Redis container" - author "Me" - start on filesystem and started docker - stop on runlevel [!2345] - respawn - script - /usr/bin/docker start -a redis_server - end script - -Next, we have to configure docker so that it's run with the option ``-r=false``. -Run the following command: - -.. code-block:: bash - - $ sudo sh -c "echo 'DOCKER_OPTS=\"-r=false\"' > /etc/default/docker" - - -Sample systemd Script ---------------------- - -.. code-block:: bash - - [Unit] - Description=Redis container - Author=Me - After=docker.service - - [Service] - Restart=always - 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/index.rst b/docs/sources/use/index.rst deleted file mode 100644 index dcf6289b41..0000000000 --- a/docs/sources/use/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -:title: Documentation -:description: -- todo: change me -:keywords: todo, docker, documentation, basic, builder - - - -Use -======== - -Contents: - -.. toctree:: - :maxdepth: 1 - - basics - workingwithrepository - port_redirection - networking - host_integration - working_with_volumes - working_with_links_names - ambassador_pattern_linking - chef - puppet diff --git a/docs/sources/use/networking.rst b/docs/sources/use/networking.rst deleted file mode 100644 index 59c63ed674..0000000000 --- a/docs/sources/use/networking.rst +++ /dev/null @@ -1,153 +0,0 @@ -:title: Configure Networking -:description: Docker networking -:keywords: network, networking, bridge, docker, documentation - - -Configure Networking -==================== - -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 - - -.. code-block:: bash - - # List host bridges - $ sudo brctl show - bridge name bridge id STP enabled interfaces - docker0 8000.000000000000 no - - # Show docker0 IP address - $ sudo ifconfig docker0 - docker0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx - inet addr:172.17.42.1 Bcast:0.0.0.0 Mask:255.255.0.0 - - - -At runtime, a :ref:`specific kind of virtual -interface` is given to each container which is then -bonded to the ``docker0`` bridge. Each container also receives a -dedicated IP address from the same range as ``docker0``. The -``docker0`` IP address is used as the default gateway for the -container. - -.. code-block:: bash - - # Run a container - $ sudo docker run -t -i -d base /bin/bash - 52f811c5d3d69edddefc75aff5a4525fc8ba8bcfa1818132f9dc7d4f7c7e78b4 - - $ sudo brctl show - bridge name bridge id STP enabled interfaces - docker0 8000.fef213db5a66 no vethQCDY1N - - -Above, ``docker0`` acts as a bridge for the ``vethQCDY1N`` interface -which is dedicated to the 52f811c5d3d6 container. - - -How to use a specific IP address range ---------------------------------------- - -Docker will try hard to find an IP range that is not used by the -host. Even though it works for most cases, it's not bullet-proof and -sometimes you need to have more control over the IP addressing scheme. - -For this purpose, Docker allows you to manage the ``docker0`` bridge -or your own one using the ``-b=`` parameter. - -In this scenario: - -- ensure Docker is stopped -- create your own bridge (``bridge0`` for example) -- assign a specific IP to this bridge -- start Docker with the ``-b=bridge0`` parameter - - -.. code-block:: bash - - # Stop Docker - $ sudo service docker stop - - # Clean docker0 bridge and - # add your very own bridge0 - $ sudo ifconfig docker0 down - $ sudo brctl addbr bridge0 - $ sudo ifconfig bridge0 192.168.227.1 netmask 255.255.255.0 - - # Edit your Docker startup file - $ echo "DOCKER_OPTS=\"-b=bridge0\"" >> /etc/default/docker - - # Start Docker - $ sudo service docker start - - # Ensure bridge0 IP is not changed by Docker - $ sudo ifconfig bridge0 - bridge0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx - inet addr:192.168.227.1 Bcast:192.168.227.255 Mask:255.255.255.0 - - # Run a container - $ docker run -i -t base /bin/bash - - # Container IP in the 192.168.227/24 range - root@261c272cd7d5:/# ifconfig eth0 - eth0 Link encap:Ethernet HWaddr xx:xx:xx:xx:xx:xx - inet addr:192.168.227.5 Bcast:192.168.227.255 Mask:255.255.255.0 - - # bridge0 IP as the default gateway - root@261c272cd7d5:/# route -n - Kernel IP routing table - Destination Gateway Genmask Flags Metric Ref Use Iface - 0.0.0.0 192.168.227.1 0.0.0.0 UG 0 0 0 eth0 - 192.168.227.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0 - - # hits CTRL+P then CTRL+Q to detach - - # Display bridge info - $ sudo brctl show - bridge name bridge id STP enabled interfaces - bridge0 8000.fe7c2e0faebd no vethAQI2QT - - -Container intercommunication -------------------------------- - -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 communicate with each other. -- ``--icc=false`` means containers are isolated from each other. - -Docker uses ``iptables`` under the hood to either accept or -drop communication between containers. - - -.. _vethxxxx-device: - -What is the vethXXXX device? ------------------------------------ -Well. Things get complicated here. - -The ``vethXXXX`` interface is the host side of a point-to-point link -between the host and the corresponding container; the other side of -the link is the container's ``eth0`` -interface. This pair (host ``vethXXX`` and container ``eth0``) are -connected like a tube. Everything that comes in one side will come out -the other side. - -All the plumbing is delegated to Linux network capabilities (check the -ip link command) and the namespaces infrastructure. - - -I want more ------------- - -Jérôme Petazzoni has created ``pipework`` to connect together -containers in arbitrarily complex scenarios : -https://github.com/jpetazzo/pipework diff --git a/docs/sources/use/port_redirection.rst b/docs/sources/use/port_redirection.rst deleted file mode 100644 index cf5c2100a9..0000000000 --- a/docs/sources/use/port_redirection.rst +++ /dev/null @@ -1,152 +0,0 @@ -:title: Redirect Ports -:description: usage about port redirection -:keywords: Usage, basic port, docker, documentation, examples - - -.. _port_redirection: - -Redirect Ports -============== - -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: - -.. code-block:: bash - - # Find IP address of container with ID - docker inspect | grep IPAddress | cut -d '"' -f 4 - -However, this IP address is local to the host system and the container -port is not reachable by the outside world. Furthermore, even if the -port is used locally, e.g. by another container, this method is -tedious as the IP address of the container changes every time it -starts. - -Docker addresses these two problems and give a simple and robust way -to access services running inside containers. - -To allow non-local clients to reach the service running inside the -container, Docker provide ways to bind the container port to an -interface of the host system. To simplify communication between -containers, Docker provides the linking mechanism. - -Auto map all exposed ports on the host --------------------------------------- - -To bind all the exposed container ports to the host automatically, use -``docker run -P ``. The mapped host ports will be auto-selected -from a pool of unused ports (49000..49900), and you will need to use -``docker ps``, ``docker inspect `` or -``docker port `` to determine what they are. - -Binding a port to a host interface ------------------------------------ - -To bind a port of the container to a specific interface of the host -system, use the ``-p`` parameter of the ``docker run`` command: - -.. code-block:: bash - - # General syntax - docker run -p [([:[host_port]])|():][/udp] - -When no host interface is provided, the port is bound to all available -interfaces of the host machine (aka INADDR_ANY, or 0.0.0.0).When no host port is -provided, one is dynamically allocated. The possible combinations of options for -TCP port are the following: - -.. code-block:: bash - - # Bind TCP port 8080 of the container to TCP port 80 on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1:80:8080 - - # Bind TCP port 8080 of the container to a dynamically allocated TCP port on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1::8080 - - # Bind TCP port 8080 of the container to TCP port 80 on all available interfaces of the host machine. - docker run -p 80:8080 - - # Bind TCP port 8080 of the container to a dynamically allocated TCP port on all available interfaces of the host machine. - docker run -p 8080 - -UDP ports can also be bound by adding a trailing ``/udp``. All the -combinations described for TCP work. Here is only one example: - -.. code-block:: bash - - # Bind UDP port 5353 of the container to UDP port 53 on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1:53:5353/udp - -The command ``docker port`` lists the interface and port on the host -machine bound to a given container port. It is useful when using -dynamically allocated ports: - -.. code-block:: bash - - # Bind to a dynamically allocated port - docker run -p 127.0.0.1::8080 --name dyn-bound - - # Lookup the actual port - docker port dyn-bound 8080 - 127.0.0.1:49160 - - -Linking a container -------------------- - -Communication between two containers can also be established in a -docker-specific way called linking. - -To briefly present the concept of linking, let us consider two -containers: ``server``, containing the service, and ``client``, -accessing the service. Once ``server`` is running, ``client`` is -started and links to server. Linking sets environment variables in -``client`` giving it some information about ``server``. In this sense, -linking is a method of service discovery. - -Let us now get back to our topic of interest; communication between -the two containers. We mentioned that the tricky part about this -communication was that the IP address of ``server`` was not -fixed. Therefore, some of the environment variables are going to be -used to inform ``client`` about this IP address. This process called -exposure, is possible because ``client`` is started after ``server`` -has been 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`` command, or the ``EXPOSE`` build command in a -Dockerfile: - -.. code-block:: bash - - # Expose port 80 - docker run --expose 80 --name server - -The ``client`` then links to the ``server``: - -.. code-block:: bash - - # Link - docker run --name client --link server:linked-server - -``client`` locally refers to ``server`` as ``linked-server``. The -following environment variables, among others, are available on -``client``: - -.. code-block:: bash - - # The default protocol, ip, and port of the service running in the container - LINKED-SERVER_PORT=tcp://172.17.0.8:80 - - # A specific protocol, ip, and port of various services - LINKED-SERVER_PORT_80_TCP=tcp://172.17.0.8:80 - LINKED-SERVER_PORT_80_TCP_PROTO=tcp - LINKED-SERVER_PORT_80_TCP_ADDR=172.17.0.8 - LINKED-SERVER_PORT_80_TCP_PORT=80 - -This tells ``client`` that a service is running on port 80 of -``server`` and that ``server`` is accessible at the IP address -172.17.0.8 - -Note: Using the ``-p`` parameter also exposes the port. diff --git a/docs/sources/use/puppet.rst b/docs/sources/use/puppet.rst deleted file mode 100644 index 4183c14f18..0000000000 --- a/docs/sources/use/puppet.rst +++ /dev/null @@ -1,117 +0,0 @@ -:title: Puppet Usage -:description: Installating and using Puppet -:keywords: puppet, installation, usage, docker, documentation - -.. _install_using_puppet: - -Using Puppet -============= - -.. note:: - - Please note this is a community contributed installation path. The - only 'official' installation is using the :ref:`ubuntu_linux` - installation path. This version may sometimes be out of date. - -Requirements ------------- - -To use this guide you'll need a working installation of Puppet from -`Puppetlabs `_ . - -The module also currently uses the official PPA so only works with Ubuntu. - -Installation ------------- - -The module is available on the `Puppet Forge -`_ and can be installed -using the built-in module tool. - -.. code-block:: bash - - puppet module install garethr/docker - -It can also be found on `GitHub -`_ if you would rather -download the source. - -Usage ------ - -The module provides a puppet class for installing Docker and two defined types -for managing images and containers. - -Installation -~~~~~~~~~~~~ - -.. code-block:: ruby - - include 'docker' - -Images -~~~~~~ - -The next step is probably to install a Docker image. For this, we have a -defined type which can be used like so: - -.. code-block:: ruby - - docker::image { 'ubuntu': } - -This is equivalent to running: - -.. code-block:: bash - - docker pull ubuntu - -Note that it will only be downloaded if an image of that name does -not already exist. This is downloading a large binary so on first -run can take a while. For that reason this define turns off the -default 5 minute timeout for the exec type. Note that you can also -remove images you no longer need with: - -.. code-block:: ruby - - docker::image { 'ubuntu': - ensure => 'absent', - } - -Containers -~~~~~~~~~~ - -Now you have an image where you can run commands within a container -managed by Docker. - -.. code-block:: ruby - - docker::run { 'helloworld': - image => 'ubuntu', - command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', - } - -This is equivalent to running the following command, but under upstart: - -.. code-block:: bash - - docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done" - -Run also contains a number of optional parameters: - -.. code-block:: ruby - - docker::run { 'helloworld': - image => 'ubuntu', - command => '/bin/sh -c "while true; do echo hello world; sleep 1; done"', - ports => ['4444', '4555'], - volumes => ['/var/lib/couchdb', '/var/log'], - volumes_from => '6446ea52fbc9', - memory_limit => 10485760, # bytes - username => 'example', - hostname => 'example.com', - env => ['FOO=BAR', 'FOO2=BAR2'], - dns => ['8.8.8.8', '8.8.4.4'], - } - -Note that ports, env, dns and volumes can be set with either a single string -or as above with an array of values. diff --git a/docs/sources/use/working_with_links_names.rst b/docs/sources/use/working_with_links_names.rst deleted file mode 100644 index 4acb6079c1..0000000000 --- a/docs/sources/use/working_with_links_names.rst +++ /dev/null @@ -1,132 +0,0 @@ -:title: Link Containers -:description: How to create and use both links and names -:keywords: Examples, Usage, links, linking, docker, documentation, examples, names, name, container naming - -.. _working_with_links_names: - -Link Containers -=============== - -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 where the parent container can -see selected information about its child. - -.. _run_name: - -Container Naming ----------------- - -.. versionadded:: 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. - -.. code-block:: 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 - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 2522602a0d99 ubuntu:12.04 /bin/bash 14 seconds ago Exit 0 test - -.. _run_link: - -Links: service discovery for docker ------------------------------------ - -.. versionadded:: v0.6.5 - -Links allow containers to discover and securely communicate with each -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 ``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 a parent child relationship between the -containers. The parent container will be able to access information -via environment variables of the child such as name, exposed ports, IP -and other selected environment variables. - -When linking two containers Docker will use the exposed ports of the -container to create a secure tunnel for the parent to access. If a -database container only exposes port 8080 then the linked container -will only be allowed to access port 8080 and nothing else if -inter-container communication is set to false. - -For example, there is an image called ``crosbymichael/redis`` 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 a daemon. - -.. code-block:: bash - - $ 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 container. The -name also allows us to link other containers into this one. - -Next, we can start a new web application that has a dependency on -Redis and apply a link to connect both containers. If you noticed when -running 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. - -.. code-block:: bash - - $ sudo docker run -t -i --link redis:db --name webapp ubuntu bash - -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 access network and environment information from -the containers that are linked into it. - -If we inspect the environment variables of the second container, we -would see all the information about the child container. - -.. code-block:: bash - - $ root@4c01db0b339c:/# env - - HOSTNAME=4c01db0b339c - DB_NAME=/webapp/db - TERM=xterm - DB_PORT=tcp://172.17.0.8:6379 - DB_PORT_6379_TCP=tcp://172.17.0.8:6379 - DB_PORT_6379_TCP_PROTO=tcp - DB_PORT_6379_TCP_ADDR=172.17.0.8 - DB_PORT_6379_TCP_PORT=6379 - PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin - PWD=/ - SHLVL=1 - HOME=/ - container=lxc - _=/usr/bin/env - root@4c01db0b339c:/# - -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`` in a file, - or looking at ``/proc/1/environ``. - -Running ``docker ps`` shows the 2 containers, and the ``webapp/db`` -alias name for the Redis container. - -.. code-block:: bash - - $ docker ps - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp - d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db - diff --git a/docs/sources/use/working_with_volumes.rst b/docs/sources/use/working_with_volumes.rst deleted file mode 100644 index d2f035dc84..0000000000 --- a/docs/sources/use/working_with_volumes.rst +++ /dev/null @@ -1,164 +0,0 @@ -:title: Share Directories via Volumes -:description: How to create and share volumes -:keywords: Examples, Usage, volume, docker, documentation, examples - -.. _volume_def: - -Share Directories via Volumes -============================= - -A *data volume* is a specially-designated directory within one or more -containers that bypasses the :ref:`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 :ref:`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. - -.. versionadded:: v0.3.0 - -Getting Started -............... - -Using data volumes is as simple as adding a ``-v`` parameter to the ``docker run`` -command. The ``-v`` parameter can be used more than once in order to -create more volumes within the new container. To create a new container with -two new volumes:: - - $ docker run -v /var/volume1 -v /var/volume2 busybox true - -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`` option; irrespective of whether the -container is running or not. - -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 - FROM busybox - VOLUME ["/var/volume1", "/var/volume2"] - CMD ["/bin/true"] - -Creating and mounting a Data Volume Container ---------------------------------------------- - -If you have some persistent data that you want to share between containers, -or want to use from non-persistent containers, its best to create a named -Data Volume Container, and then to mount the data from it. - -Create a named container with volumes to share (``/var/volume1`` and ``/var/volume2``):: - - $ 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 - -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 - -This allows you to abstract the actual data source from users of that data, -similar to :ref:`ambassador_pattern_linking `. - -If you remove containers that mount volumes, including the initial DATA container, -or the middleman, the volumes will not be deleted until there are no containers still -referencing those volumes. This allows you to upgrade, or effectively migrate data volumes -between containers. - -Mount a Host Directory as a Container Volume: ---------------------------------------------- - -:: - - -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. - -You must specify an absolute path for ``host-dir``. -If ``host-dir`` is missing from the command, then docker creates a new volume. -If ``host-dir`` is present but points to a non-existent directory on the host, -Docker will automatically create this directory and use it as the source of the -bind-mount. - -Note that this is not available from a Dockerfile due the portability and -sharing purpose of it. The ``host-dir`` volumes are entirely host-dependent and -might not work on any other machine. - -For example:: - - sudo docker run -t -i -v /var/logs:/var/host_logs:ro ubuntu bash - -The command above mounts the host directory ``/var/logs`` into the -container with read only permissions as ``/var/host_logs``. - -.. versionadded:: v0.5.0 - - -Note for OS/X users and remote daemon users: --------------------------------------------- - -OS/X users run ``boot2docker`` to create a minimalist virtual machine running the docker daemon. That -virtual machine then launches docker commands on behalf of the OS/X command line. The means that ``host -directories`` refer to directories in the ``boot2docker`` virtual machine, not the OS/X filesystem. - -Similarly, anytime when the docker daemon is on a remote machine, the ``host directories`` always refer to directories on the daemon's machine. - -Backup, restore, or migrate data volumes ----------------------------------------- - -You cannot back up volumes using ``docker export``, ``docker save`` and ``docker cp`` -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 - -* ``--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 directory into the container; to write the tar file to -* ``busybox`` - a small simpler image - good for quick maintenance -* ``tar cvf /backup/backup.tar /data`` - creates an uncompressed tar file of all the files in the ``/data`` directory - -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 - # 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 - data/ - data/sven.txt - # compare to the original container - $ 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 restore -testing using your preferred tools. - -Known Issues -............ - -* :issue:`2702`: "lxc-start: Permission denied - failed to mount" - could indicate a permissions problem with AppArmor. Please see the - issue for a workaround. -* :issue:`2528`: the busybox container is used to make the resulting container as small and - simple as possible - whenever you need to interact with the data in the volume - you mount it into another container. diff --git a/docs/sources/use/workingwithrepository.rst b/docs/sources/use/workingwithrepository.rst deleted file mode 100644 index c126361f8c..0000000000 --- a/docs/sources/use/workingwithrepository.rst +++ /dev/null @@ -1,256 +0,0 @@ -:title: Share Images via Repositories -:description: Repositories allow users to share images. -:keywords: repo, repositories, usage, pull image, push image, image, documentation - -.. _working_with_the_repository: - -Share Images via Repositories -============================= - -A *repository* is a shareable collection of tagged :ref:`images` -that together create the file systems for containers. The -repository's name is a label that indicates the provenance of the -repository, i.e. who created it and where the original copy is -located. - -You can find one or more repositories hosted on a *registry*. There -can be an implicit or explicit host name as part of the repository -tag. The implicit registry is located at ``index.docker.io``, the home -of "top-level" repositories and the Central Index. This registry may -also include public "user" repositories. - -Docker is not only a tool for creating and managing your own -:ref:`containers ` -- **Docker is also a tool for -sharing**. The Docker project provides a Central Registry to host -public repositories, namespaced by user, and a Central Index which -provides user authentication and search over all the public -repositories. You can host your own Registry too! Docker acts as a -client for these services via ``docker search, pull, login`` and -``push``. - -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. - -.. _using_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 by individual contributors. Anyone can read from these -repositories -- they really help people get started quickly! You could -also use :ref:`using_private_repositories` if you need to keep control -of who accesses your images, but we will only refer to public -repositories in these examples. - -* Top-level repositories can easily be recognized by **not** having a - ``/`` (slash) in their name. These repositories can generally be - trusted. -* User repositories always come in the form of - ``/``. This is what your published images will - look like if you push to the public Central Registry. -* Only the authenticated user can push to their *username* namespace - on the Central Registry. -* User images are not checked, it is therefore up to you whether or - not you trust the creator of this image. - -.. _searching_central_index: - -Find Public Images on the Central Index ---------------------------------------- - -You can search the Central Index `online `_ -or using the command line interface. Searching can find images by name, user -name or description: - -.. code-block:: bash - - $ sudo docker help search - Usage: docker search NAME - - Search the docker index for images - - --no-trunc=false: Don't truncate output - $ sudo docker search centos - Found 25 results matching your query ("centos") - NAME DESCRIPTION - centos - slantview/centos-chef-solo CentOS 6.4 with chef-solo. - ... - -There you can see two example results: ``centos`` and -``slantview/centos-chef-solo``. The second result shows that it comes -from the public repository of a user, ``slantview/``, while the first -result (``centos``) doesn't explicitly list a repository so it comes -from the trusted Central Repository. The ``/`` character separates a -user's repository and the image name. - -Once you have found the image name, you can download it: - -.. code-block:: bash - - # sudo docker pull - $ sudo docker pull centos - Pulling repository centos - 539c0211cd76: Download complete - -What can you do with that image? Check out the :ref:`example_list` -and, when you're ready with your own image, come back here to learn -how to share it. - -Contributing to the Central Registry ------------------------------------- - -Anyone can pull public images from the Central Registry, but if you -would like to share one of your own images, then you must register a -unique user name first. You can create your username and login on the -`central Docker Index online -`_, or by running - -.. code-block:: bash - - sudo docker login - -This will prompt you for a username, which will become a public -namespace for your public repositories. - -If your username is available then ``docker`` will also prompt you to -enter a password and your e-mail address. It will then automatically -log you in. Now you're ready to commit and push your own images! - -.. _container_commit: - -Committing a Container to a Named Image ---------------------------------------- - -When you make changes to an existing image, those changes get saved to -a container's file system. You can then promote that container to -become an image by making a ``commit``. In addition to converting the -container to an image, this is also your opportunity to name the -image, specifically a name that includes your user name from the -Central Docker Index (as you did a ``login`` above) and a meaningful -name for the image. - -.. code-block:: bash - - # format is "sudo docker commit /" - $ sudo docker commit $CONTAINER_ID myname/kickassapp - -.. _image_push: - -Pushing a repository to its registry ------------------------------------- - -In order to push an repository to its registry you need to have named an image, -or committed your container to a named image (see above) - -Now you can push this repository to the registry designated by its name -or tag. - -.. code-block:: bash - - # format is "docker push /" - $ sudo docker push myname/kickassapp - -.. _using_private_repositories: - -Trusted Builds --------------- - -Trusted Builds automate the building and updating of images from GitHub, directly -on ``docker.io`` servers. It works by adding a commit hook to your selected repository, -triggering a build and update when you push a commit. - -To setup a trusted build -++++++++++++++++++++++++ - -#. Create a `Docker Index account `_ and login. -#. Link your GitHub account through the ``Link Accounts`` menu. -#. `Configure a Trusted build `_. -#. Pick a GitHub project that has a ``Dockerfile`` that you want to build. -#. Pick the branch you want to build (the default is the ``master`` branch). -#. Give the Trusted Build a name. -#. Assign an optional Docker tag to the Build. -#. Specify where the ``Dockerfile`` is located. The default is ``/``. - -Once the Trusted Build is configured it will automatically trigger a build, and -in a few minutes, if there are no errors, you will see your new trusted build -on the Docker Index. It will will stay in sync with your GitHub repo until you -deactivate the Trusted Build. - -If you want to see the status of your Trusted Builds you can go to your -`Trusted Builds page `_ on the Docker index, -and it will show you the status of your builds, and the build history. - -Once you've created a Trusted Build you can deactivate or delete it. You cannot -however push to a Trusted Build with the ``docker push`` command. You can only -manage it by committing code to your GitHub repository. - -You can create multiple Trusted Builds per repository and configure them to -point to specific ``Dockerfile``'s or Git branches. - -Private Registry ----------------- - -Private registries and private shared repositories are -only possible by hosting `your own registry -`_. To push or pull to a -repository on your own registry, you must prefix the tag with the -address of the registry's host (a ``.`` or ``:`` is used to identify a host), -like this: - -.. code-block:: bash - - # Tag to create a repository with the full registry location. - # The location (e.g. localhost.localdomain:5000) becomes - # a permanent part of the repository name - sudo docker tag 0u812deadbeef localhost.localdomain:5000/repo_name - - # Push the new repository to its home location on localhost - sudo docker push localhost.localdomain:5000/repo_name - -Once a repository has your registry's host name as part of the tag, -you can push and pull it like any other repository, but it will -**not** be 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. - -.. raw:: html - - - -.. seealso:: `Docker Blog: How to use your own registry - `_ - -Authentication file -------------------- - -The authentication is stored in a json file, ``.dockercfg`` located in your -home directory. It supports multiple registry urls. - -``docker login`` will create the "https://index.docker.io/v1/" key. - -``docker login https://my-registry.com`` will create the "https://my-registry.com" key. - -For example: - -.. code-block:: json - - { - "https://index.docker.io/v1/": { - "auth": "xXxXxXxXxXx=", - "email": "email@example.com" - }, - "https://my-registry.com": { - "auth": "XxXxXxXxXxX=", - "email": "email@my-registry.com" - } - } - -The ``auth`` field represents ``base64(:)`` diff --git a/docs/theme/docker/layout.html b/docs/theme/docker/layout.html deleted file mode 100755 index 0dac9e0680..0000000000 --- a/docs/theme/docker/layout.html +++ /dev/null @@ -1,78 +0,0 @@ - - - - - - - {{ meta['title'] if meta and meta['title'] else title }} - Docker Documentation - - - - - - - {%- set url_root = pathto('', 1) %} - {%- if url_root == '#' %}{% set url_root = '' %}{% endif %} - - {%- if current_version == 'latest' %} - {% set github_tag = 'master' %} - {% else %} - {% set github_tag = current_version %} - {% endif %} - - - - {%- set css_files = css_files + ['_static/css/bootstrap.css'] %} - {%- set css_files = css_files + ['_static/pygments.css'] %} - {%- set css_files = css_files + ['_static/css/main.css'] %} - - {%- set script_files = - ['//code.jquery.com/jquery-1.10.1.min.js'] - + ['//fonts.googleapis.com/css?family=Cabin:400,700,400italic'] - %} - - {# - This part is hopefully complex because things like |cut '/index/' are not available in Sphinx jinja - and will make it crash. (and we need index/ out. - #} - - - {%- for cssfile in css_files %} - - {%- endfor %} - - {%- for scriptfile in script_files if scriptfile != '_static/jquery.js' %} - - {%- endfor %} - - {%- block extrahead %}{% endblock %} - - - - - - -
    - - -
    - {% block body %}{% endblock %} -
    - -
    - - - diff --git a/docs/theme/docker/redirect_build.html b/docs/theme/docker/redirect_build.html deleted file mode 100644 index 1f26fc3aaa..0000000000 --- a/docs/theme/docker/redirect_build.html +++ /dev/null @@ -1,12 +0,0 @@ - - - - Page Moved - - - - -This page has moved. Perhaps you should visit the Builder page - - - diff --git a/docs/theme/docker/redirect_home.html b/docs/theme/docker/redirect_home.html deleted file mode 100644 index 109239f819..0000000000 --- a/docs/theme/docker/redirect_home.html +++ /dev/null @@ -1,12 +0,0 @@ - - - - Page Moved - - - - -This page has moved. Perhaps you should visit the Documentation Homepage - - - diff --git a/docs/theme/docker/static/css/bootstrap.css b/docs/theme/docker/static/css/bootstrap.css deleted file mode 100755 index b255056927..0000000000 --- a/docs/theme/docker/static/css/bootstrap.css +++ /dev/null @@ -1,6158 +0,0 @@ -/*! - * Bootstrap v2.3.0 - * - * Copyright 2012 Twitter, Inc - * Licensed under the Apache License v2.0 - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Designed and built with all the love in the world @twitter by @mdo and @fat. - */ - -.clearfix { - *zoom: 1; -} - -.clearfix:before, -.clearfix:after { - display: table; - line-height: 0; - content: ""; -} - -.clearfix:after { - clear: both; -} - -.hide-text { - font: 0/0 a; - color: transparent; - text-shadow: none; - background-color: transparent; - border: 0; -} - -.input-block-level { - display: block; - width: 100%; - min-height: 30px; - -webkit-box-sizing: border-box; - -moz-box-sizing: border-box; - box-sizing: border-box; -} - -article, -aside, -details, -figcaption, -figure, -footer, -header, -hgroup, -nav, -section { - display: block; -} - -audio, -canvas, -video { - display: inline-block; - *display: inline; - *zoom: 1; -} - -audio:not([controls]) { - display: none; -} - -html { - font-size: 100%; - -webkit-text-size-adjust: 100%; - -ms-text-size-adjust: 100%; -} - -a:focus { - outline: thin dotted #333; - outline: 5px auto -webkit-focus-ring-color; - outline-offset: -2px; -} - -a:hover, -a:active { - outline: 0; -} - -sub, -sup { - position: relative; - font-size: 75%; - line-height: 0; - vertical-align: baseline; -} - -sup { - top: -0.5em; -} - -sub { - bottom: -0.25em; -} - -img { - width: auto\9; - height: auto; - max-width: 100%; - vertical-align: middle; - border: 0; - -ms-interpolation-mode: bicubic; -} - -#map_canvas img, -.google-maps img { - max-width: none; -} - -button, -input, -select, -textarea { - margin: 0; - font-size: 100%; - vertical-align: middle; -} - -button, -input { - *overflow: visible; - line-height: normal; -} - -button::-moz-focus-inner, -input::-moz-focus-inner { - padding: 0; - border: 0; -} - -button, -html input[type="button"], -input[type="reset"], -input[type="submit"] { - cursor: pointer; - -webkit-appearance: button; -} - -label, -select, -button, -input[type="button"], -input[type="reset"], -input[type="submit"], -input[type="radio"], -input[type="checkbox"] { - cursor: pointer; -} - -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-decoration, -input[type="search"]::-webkit-search-cancel-button { - -webkit-appearance: none; -} - -textarea { - overflow: auto; - vertical-align: top; -} - -@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) ")"; - } - .ir a:after, - 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: 0.5cm; - } - p, - h2, - h3 { - orphans: 3; - widows: 3; - } - h2, - h3 { - page-break-after: avoid; - } -} - -body { - margin: 0; - font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; - font-size: 14px; - line-height: 20px; - color: #333333; - background-color: #ffffff; -} - -a { - color: #0088cc; - text-decoration: none; -} - -a:hover, -a:focus { - color: #005580; - text-decoration: underline; -} - -.img-rounded { - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; -} - -.img-polaroid { - padding: 4px; - background-color: #fff; - border: 1px solid #ccc; - border: 1px solid rgba(0, 0, 0, 0.2); - -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1); - -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1); - box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1); -} - -.img-circle { - -webkit-border-radius: 500px; - -moz-border-radius: 500px; - border-radius: 500px; -} - -.row { - margin-left: -20px; - *zoom: 1; -} - -.row:before, -.row:after { - display: table; - line-height: 0; - content: ""; -} - -.row:after { - clear: both; -} - -[class*="span"] { - float: left; - min-height: 1px; - margin-left: 20px; -} - -.container, -.navbar-static-top .container, -.navbar-fixed-top .container, -.navbar-fixed-bottom .container { - width: 940px; -} - -.span12 { - width: 940px; -} - -.span11 { - width: 860px; -} - -.span10 { - width: 780px; -} - -.span9 { - width: 700px; -} - -.span8 { - width: 620px; -} - -.span7 { - width: 540px; -} - -.span6 { - width: 460px; -} - -.span5 { - width: 380px; -} - -.span4 { - width: 300px; -} - -.span3 { - width: 220px; -} - -.span2 { - width: 140px; -} - -.span1 { - width: 60px; -} - -.offset12 { - margin-left: 980px; -} - -.offset11 { - margin-left: 900px; -} - -.offset10 { - margin-left: 820px; -} - -.offset9 { - margin-left: 740px; -} - -.offset8 { - margin-left: 660px; -} - -.offset7 { - margin-left: 580px; -} - -.offset6 { - margin-left: 500px; -} - -.offset5 { - margin-left: 420px; -} - -.offset4 { - margin-left: 340px; -} - -.offset3 { - margin-left: 260px; -} - -.offset2 { - margin-left: 180px; -} - -.offset1 { - margin-left: 100px; -} - -.row-fluid { - width: 100%; - *zoom: 1; -} - -.row-fluid:before, -.row-fluid:after { - display: table; - line-height: 0; - content: ""; -} - -.row-fluid:after { - clear: both; -} - -.row-fluid [class*="span"] { - display: block; - float: left; - width: 100%; - min-height: 30px; - margin-left: 2.127659574468085%; - *margin-left: 2.074468085106383%; - -webkit-box-sizing: border-box; - -moz-box-sizing: border-box; - box-sizing: border-box; -} - -.row-fluid [class*="span"]:first-child { - margin-left: 0; -} - -.row-fluid .controls-row [class*="span"] + [class*="span"] { - margin-left: 2.127659574468085%; -} - -.row-fluid .span12 { - width: 100%; - *width: 99.94680851063829%; -} - -.row-fluid .span11 { - width: 91.48936170212765%; - *width: 91.43617021276594%; -} - -.row-fluid .span10 { - width: 82.97872340425532%; - *width: 82.92553191489361%; -} - -.row-fluid .span9 { - width: 74.46808510638297%; - *width: 74.41489361702126%; -} - -.row-fluid .span8 { - width: 65.95744680851064%; - *width: 65.90425531914893%; -} - -.row-fluid .span7 { - width: 57.44680851063829%; - *width: 57.39361702127659%; -} - -.row-fluid .span6 { - width: 48.93617021276595%; - *width: 48.88297872340425%; -} - -.row-fluid .span5 { - width: 40.42553191489362%; - *width: 40.37234042553192%; -} - -.row-fluid .span4 { - width: 31.914893617021278%; - *width: 31.861702127659576%; -} - -.row-fluid .span3 { - width: 23.404255319148934%; - *width: 23.351063829787233%; -} - -.row-fluid .span2 { - width: 14.893617021276595%; - *width: 14.840425531914894%; -} - -.row-fluid .span1 { - width: 6.382978723404255%; - *width: 6.329787234042553%; -} - -.row-fluid .offset12 { - margin-left: 104.25531914893617%; - *margin-left: 104.14893617021275%; -} - -.row-fluid .offset12:first-child { - margin-left: 102.12765957446808%; - *margin-left: 102.02127659574467%; -} - -.row-fluid .offset11 { - margin-left: 95.74468085106382%; - *margin-left: 95.6382978723404%; -} - -.row-fluid .offset11:first-child { - margin-left: 93.61702127659574%; - *margin-left: 93.51063829787232%; -} - -.row-fluid .offset10 { - margin-left: 87.23404255319149%; - *margin-left: 87.12765957446807%; -} - -.row-fluid .offset10:first-child { - margin-left: 85.1063829787234%; - *margin-left: 84.99999999999999%; -} - -.row-fluid .offset9 { - margin-left: 78.72340425531914%; - *margin-left: 78.61702127659572%; -} - -.row-fluid .offset9:first-child { - margin-left: 76.59574468085106%; - *margin-left: 76.48936170212764%; -} - -.row-fluid .offset8 { - margin-left: 70.2127659574468%; - *margin-left: 70.10638297872339%; -} - -.row-fluid .offset8:first-child { - margin-left: 68.08510638297872%; - *margin-left: 67.9787234042553%; -} - -.row-fluid .offset7 { - margin-left: 61.70212765957446%; - *margin-left: 61.59574468085106%; -} - -.row-fluid .offset7:first-child { - margin-left: 59.574468085106375%; - *margin-left: 59.46808510638297%; -} - -.row-fluid .offset6 { - margin-left: 53.191489361702125%; - *margin-left: 53.085106382978715%; -} - -.row-fluid .offset6:first-child { - margin-left: 51.063829787234035%; - *margin-left: 50.95744680851063%; -} - -.row-fluid .offset5 { - margin-left: 44.68085106382979%; - *margin-left: 44.57446808510638%; -} - -.row-fluid .offset5:first-child { - margin-left: 42.5531914893617%; - *margin-left: 42.4468085106383%; -} - -.row-fluid .offset4 { - margin-left: 36.170212765957444%; - *margin-left: 36.06382978723405%; -} - -.row-fluid .offset4:first-child { - margin-left: 34.04255319148936%; - *margin-left: 33.93617021276596%; -} - -.row-fluid .offset3 { - margin-left: 27.659574468085104%; - *margin-left: 27.5531914893617%; -} - -.row-fluid .offset3:first-child { - margin-left: 25.53191489361702%; - *margin-left: 25.425531914893618%; -} - -.row-fluid .offset2 { - margin-left: 19.148936170212764%; - *margin-left: 19.04255319148936%; -} - -.row-fluid .offset2:first-child { - margin-left: 17.02127659574468%; - *margin-left: 16.914893617021278%; -} - -.row-fluid .offset1 { - margin-left: 10.638297872340425%; - *margin-left: 10.53191489361702%; -} - -.row-fluid .offset1:first-child { - margin-left: 8.51063829787234%; - *margin-left: 8.404255319148938%; -} - -[class*="span"].hide, -.row-fluid [class*="span"].hide { - display: none; -} - -[class*="span"].pull-right, -.row-fluid [class*="span"].pull-right { - float: right; -} - -.container { - margin-right: auto; - margin-left: auto; - *zoom: 1; -} - -.container:before, -.container:after { - display: table; - line-height: 0; - content: ""; -} - -.container:after { - clear: both; -} - -.container-fluid { - padding-right: 20px; - padding-left: 20px; - *zoom: 1; -} - -.container-fluid:before, -.container-fluid:after { - display: table; - line-height: 0; - content: ""; -} - -.container-fluid:after { - clear: both; -} - -p { - margin: 0 0 10px; -} - -.lead { - margin-bottom: 20px; - font-size: 21px; - font-weight: 200; - line-height: 30px; -} - -small { - font-size: 85%; -} - -strong { - font-weight: bold; -} - -em { - font-style: italic; -} - -cite { - font-style: normal; -} - -.muted { - color: #999999; -} - -a.muted:hover, -a.muted:focus { - color: #808080; -} - -.text-warning { - color: #c09853; -} - -a.text-warning:hover, -a.text-warning:focus { - color: #a47e3c; -} - -.text-error { - color: #b94a48; -} - -a.text-error:hover, -a.text-error:focus { - color: #953b39; -} - -.text-info { - color: #3a87ad; -} - -a.text-info:hover, -a.text-info:focus { - color: #2d6987; -} - -.text-success { - color: #468847; -} - -a.text-success:hover, -a.text-success:focus { - color: #356635; -} - -.text-left { - text-align: left; -} - -.text-right { - text-align: right; -} - -.text-center { - text-align: center; -} - -h1, -h2, -h3, -h4, -h5, -h6 { - margin: 10px 0; - font-family: inherit; - font-weight: bold; - line-height: 20px; - color: inherit; - text-rendering: optimizelegibility; -} - -h1 small, -h2 small, -h3 small, -h4 small, -h5 small, -h6 small { - font-weight: normal; - line-height: 1; - color: #999999; -} - -h1, -h2, -h3 { - line-height: 40px; -} - -h1 { - font-size: 38.5px; -} - -h2 { - font-size: 31.5px; -} - -h3 { - font-size: 24.5px; -} - -h4 { - font-size: 17.5px; -} - -h5 { - font-size: 14px; -} - -h6 { - font-size: 11.9px; -} - -h1 small { - font-size: 24.5px; -} - -h2 small { - font-size: 17.5px; -} - -h3 small { - font-size: 14px; -} - -h4 small { - font-size: 14px; -} - -.page-header { - padding-bottom: 9px; - margin: 20px 0 30px; - border-bottom: 1px solid #eeeeee; -} - -ul, -ol { - padding: 0; - margin: 0 0 10px 25px; -} - -ul ul, -ul ol, -ol ol, -ol ul { - margin-bottom: 0; -} - -li { - line-height: 20px; -} - -ul.unstyled, -ol.unstyled { - margin-left: 0; - list-style: none; -} - -ul.inline, -ol.inline { - margin-left: 0; - list-style: none; -} - -ul.inline > li, -ol.inline > li { - display: inline-block; - *display: inline; - padding-right: 5px; - padding-left: 5px; - *zoom: 1; -} - -dl { - margin-bottom: 20px; -} - -dt, -dd { - line-height: 20px; -} - -dt { - font-weight: bold; -} - -dd { - margin-left: 10px; -} - -.dl-horizontal { - *zoom: 1; -} - -.dl-horizontal:before, -.dl-horizontal:after { - display: table; - line-height: 0; - content: ""; -} - -.dl-horizontal:after { - clear: both; -} - -.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; -} - -hr { - margin: 20px 0; - border: 0; - border-top: 1px solid #eeeeee; - border-bottom: 1px solid #ffffff; -} - -abbr[title], -abbr[data-original-title] { - cursor: help; - border-bottom: 1px dotted #999999; -} - -abbr.initialism { - font-size: 90%; - text-transform: uppercase; -} - -blockquote { - padding: 0 0 0 15px; - margin: 0 0 20px; - border-left: 5px solid #eeeeee; -} - -blockquote p { - margin-bottom: 0; - font-size: 17.5px; - font-weight: 300; - line-height: 1.25; -} - -blockquote small { - display: block; - line-height: 20px; - color: #999999; -} - -blockquote small:before { - content: '\2014 \00A0'; -} - -blockquote.pull-right { - float: right; - padding-right: 15px; - padding-left: 0; - border-right: 5px solid #eeeeee; - border-left: 0; -} - -blockquote.pull-right p, -blockquote.pull-right small { - text-align: right; -} - -blockquote.pull-right small:before { - content: ''; -} - -blockquote.pull-right small:after { - content: '\00A0 \2014'; -} - -q:before, -q:after, -blockquote:before, -blockquote:after { - content: ""; -} - -address { - display: block; - margin-bottom: 20px; - font-style: normal; - line-height: 20px; -} - -code, -pre { - padding: 0 3px 2px; - font-family: Monaco, Menlo, Consolas, "Courier New", monospace; - font-size: 12px; - color: #333333; - -webkit-border-radius: 3px; - -moz-border-radius: 3px; - border-radius: 3px; -} - -code { - padding: 2px 4px; - color: #d14; - white-space: nowrap; - background-color: #f7f7f9; - border: 1px solid #e1e1e8; -} - -pre { - display: block; - padding: 9.5px; - margin: 0 0 10px; - font-size: 13px; - line-height: 20px; - word-break: break-all; - word-wrap: break-word; - white-space: pre; - white-space: pre-wrap; - background-color: #f5f5f5; - border: 1px solid #ccc; - border: 1px solid rgba(0, 0, 0, 0.15); - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -pre.prettyprint { - margin-bottom: 20px; -} - -pre code { - padding: 0; - color: inherit; - white-space: pre; - white-space: pre-wrap; - background-color: transparent; - border: 0; -} - -.pre-scrollable { - max-height: 340px; - overflow-y: scroll; -} - -form { - margin: 0 0 20px; -} - -fieldset { - padding: 0; - margin: 0; - border: 0; -} - -legend { - display: block; - width: 100%; - padding: 0; - margin-bottom: 20px; - font-size: 21px; - line-height: 40px; - color: #333333; - border: 0; - border-bottom: 1px solid #e5e5e5; -} - -legend small { - font-size: 15px; - color: #999999; -} - -label, -input, -button, -select, -textarea { - font-size: 14px; - font-weight: normal; - line-height: 20px; -} - -input, -button, -select, -textarea { - font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; -} - -label { - display: block; - margin-bottom: 5px; -} - -select, -textarea, -input[type="text"], -input[type="password"], -input[type="datetime"], -input[type="datetime-local"], -input[type="date"], -input[type="month"], -input[type="time"], -input[type="week"], -input[type="number"], -input[type="email"], -input[type="url"], -input[type="search"], -input[type="tel"], -input[type="color"], -.uneditable-input { - display: inline-block; - height: 20px; - padding: 4px 6px; - margin-bottom: 10px; - font-size: 14px; - line-height: 20px; - color: #555555; - vertical-align: middle; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -input, -textarea, -.uneditable-input { - width: 206px; -} - -textarea { - height: auto; -} - -textarea, -input[type="text"], -input[type="password"], -input[type="datetime"], -input[type="datetime-local"], -input[type="date"], -input[type="month"], -input[type="time"], -input[type="week"], -input[type="number"], -input[type="email"], -input[type="url"], -input[type="search"], -input[type="tel"], -input[type="color"], -.uneditable-input { - background-color: #ffffff; - border: 1px solid #cccccc; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - -moz-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 linear 0.2s, box-shadow linear 0.2s; - -moz-transition: border linear 0.2s, box-shadow linear 0.2s; - -o-transition: border linear 0.2s, box-shadow linear 0.2s; - transition: border linear 0.2s, box-shadow linear 0.2s; -} - -textarea:focus, -input[type="text"]:focus, -input[type="password"]:focus, -input[type="datetime"]:focus, -input[type="datetime-local"]:focus, -input[type="date"]:focus, -input[type="month"]:focus, -input[type="time"]:focus, -input[type="week"]:focus, -input[type="number"]:focus, -input[type="email"]:focus, -input[type="url"]:focus, -input[type="search"]:focus, -input[type="tel"]:focus, -input[type="color"]:focus, -.uneditable-input:focus { - border-color: rgba(82, 168, 236, 0.8); - outline: 0; - outline: thin dotted \9; - /* IE6-9 */ - - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.6); - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.6); - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.6); -} - -input[type="radio"], -input[type="checkbox"] { - margin: 4px 0 0; - margin-top: 1px \9; - *margin-top: 0; - line-height: normal; -} - -input[type="file"], -input[type="image"], -input[type="submit"], -input[type="reset"], -input[type="button"], -input[type="radio"], -input[type="checkbox"] { - width: auto; -} - -select, -input[type="file"] { - height: 30px; - /* In IE7, the height of the select element cannot be changed by height, only font-size */ - - *margin-top: 4px; - /* For IE7, add top margin to align select with labels */ - - line-height: 30px; -} - -select { - width: 220px; - background-color: #ffffff; - border: 1px solid #cccccc; -} - -select[multiple], -select[size] { - height: auto; -} - -select:focus, -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; -} - -.uneditable-input, -.uneditable-textarea { - color: #999999; - cursor: not-allowed; - background-color: #fcfcfc; - border-color: #cccccc; - -webkit-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.025); - -moz-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.025); - box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.025); -} - -.uneditable-input { - overflow: hidden; - white-space: nowrap; -} - -.uneditable-textarea { - width: auto; - height: auto; -} - -input:-moz-placeholder, -textarea:-moz-placeholder { - color: #999999; -} - -input:-ms-input-placeholder, -textarea:-ms-input-placeholder { - color: #999999; -} - -input::-webkit-input-placeholder, -textarea::-webkit-input-placeholder { - color: #999999; -} - -.radio, -.checkbox { - min-height: 20px; - padding-left: 20px; -} - -.radio input[type="radio"], -.checkbox input[type="checkbox"] { - float: left; - margin-left: -20px; -} - -.controls > .radio:first-child, -.controls > .checkbox:first-child { - padding-top: 5px; -} - -.radio.inline, -.checkbox.inline { - display: inline-block; - padding-top: 5px; - margin-bottom: 0; - vertical-align: middle; -} - -.radio.inline + .radio.inline, -.checkbox.inline + .checkbox.inline { - margin-left: 10px; -} - -.input-mini { - width: 60px; -} - -.input-small { - width: 90px; -} - -.input-medium { - width: 150px; -} - -.input-large { - width: 210px; -} - -.input-xlarge { - width: 270px; -} - -.input-xxlarge { - width: 530px; -} - -input[class*="span"], -select[class*="span"], -textarea[class*="span"], -.uneditable-input[class*="span"], -.row-fluid input[class*="span"], -.row-fluid select[class*="span"], -.row-fluid textarea[class*="span"], -.row-fluid .uneditable-input[class*="span"] { - float: none; - margin-left: 0; -} - -.input-append input[class*="span"], -.input-append .uneditable-input[class*="span"], -.input-prepend input[class*="span"], -.input-prepend .uneditable-input[class*="span"], -.row-fluid input[class*="span"], -.row-fluid select[class*="span"], -.row-fluid textarea[class*="span"], -.row-fluid .uneditable-input[class*="span"], -.row-fluid .input-prepend [class*="span"], -.row-fluid .input-append [class*="span"] { - display: inline-block; -} - -input, -textarea, -.uneditable-input { - margin-left: 0; -} - -.controls-row [class*="span"] + [class*="span"] { - margin-left: 20px; -} - -input.span12, -textarea.span12, -.uneditable-input.span12 { - width: 926px; -} - -input.span11, -textarea.span11, -.uneditable-input.span11 { - width: 846px; -} - -input.span10, -textarea.span10, -.uneditable-input.span10 { - width: 766px; -} - -input.span9, -textarea.span9, -.uneditable-input.span9 { - width: 686px; -} - -input.span8, -textarea.span8, -.uneditable-input.span8 { - width: 606px; -} - -input.span7, -textarea.span7, -.uneditable-input.span7 { - width: 526px; -} - -input.span6, -textarea.span6, -.uneditable-input.span6 { - width: 446px; -} - -input.span5, -textarea.span5, -.uneditable-input.span5 { - width: 366px; -} - -input.span4, -textarea.span4, -.uneditable-input.span4 { - width: 286px; -} - -input.span3, -textarea.span3, -.uneditable-input.span3 { - width: 206px; -} - -input.span2, -textarea.span2, -.uneditable-input.span2 { - width: 126px; -} - -input.span1, -textarea.span1, -.uneditable-input.span1 { - width: 46px; -} - -.controls-row { - *zoom: 1; -} - -.controls-row:before, -.controls-row:after { - display: table; - line-height: 0; - content: ""; -} - -.controls-row:after { - clear: both; -} - -.controls-row [class*="span"], -.row-fluid .controls-row [class*="span"] { - float: left; -} - -.controls-row .checkbox[class*="span"], -.controls-row .radio[class*="span"] { - padding-top: 5px; -} - -input[disabled], -select[disabled], -textarea[disabled], -input[readonly], -select[readonly], -textarea[readonly] { - cursor: not-allowed; - background-color: #eeeeee; -} - -input[type="radio"][disabled], -input[type="checkbox"][disabled], -input[type="radio"][readonly], -input[type="checkbox"][readonly] { - background-color: transparent; -} - -.control-group.warning .control-label, -.control-group.warning .help-block, -.control-group.warning .help-inline { - color: #c09853; -} - -.control-group.warning .checkbox, -.control-group.warning .radio, -.control-group.warning input, -.control-group.warning select, -.control-group.warning textarea { - color: #c09853; -} - -.control-group.warning input, -.control-group.warning select, -.control-group.warning textarea { - border-color: #c09853; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); -} - -.control-group.warning input:focus, -.control-group.warning select:focus, -.control-group.warning textarea:focus { - border-color: #a47e3c; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #dbc59e; - -moz-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; -} - -.control-group.warning .input-prepend .add-on, -.control-group.warning .input-append .add-on { - color: #c09853; - background-color: #fcf8e3; - border-color: #c09853; -} - -.control-group.error .control-label, -.control-group.error .help-block, -.control-group.error .help-inline { - color: #b94a48; -} - -.control-group.error .checkbox, -.control-group.error .radio, -.control-group.error input, -.control-group.error select, -.control-group.error textarea { - color: #b94a48; -} - -.control-group.error input, -.control-group.error select, -.control-group.error textarea { - border-color: #b94a48; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); -} - -.control-group.error input:focus, -.control-group.error select:focus, -.control-group.error textarea:focus { - border-color: #953b39; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #d59392; - -moz-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; -} - -.control-group.error .input-prepend .add-on, -.control-group.error .input-append .add-on { - color: #b94a48; - background-color: #f2dede; - border-color: #b94a48; -} - -.control-group.success .control-label, -.control-group.success .help-block, -.control-group.success .help-inline { - color: #468847; -} - -.control-group.success .checkbox, -.control-group.success .radio, -.control-group.success input, -.control-group.success select, -.control-group.success textarea { - color: #468847; -} - -.control-group.success input, -.control-group.success select, -.control-group.success textarea { - border-color: #468847; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); -} - -.control-group.success input:focus, -.control-group.success select:focus, -.control-group.success textarea:focus { - border-color: #356635; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7aba7b; - -moz-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; -} - -.control-group.success .input-prepend .add-on, -.control-group.success .input-append .add-on { - color: #468847; - background-color: #dff0d8; - border-color: #468847; -} - -.control-group.info .control-label, -.control-group.info .help-block, -.control-group.info .help-inline { - color: #3a87ad; -} - -.control-group.info .checkbox, -.control-group.info .radio, -.control-group.info input, -.control-group.info select, -.control-group.info textarea { - color: #3a87ad; -} - -.control-group.info input, -.control-group.info select, -.control-group.info textarea { - border-color: #3a87ad; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); -} - -.control-group.info input:focus, -.control-group.info select:focus, -.control-group.info textarea:focus { - border-color: #2d6987; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7ab5d3; - -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7ab5d3; - box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #7ab5d3; -} - -.control-group.info .input-prepend .add-on, -.control-group.info .input-append .add-on { - color: #3a87ad; - background-color: #d9edf7; - border-color: #3a87ad; -} - -input:focus:invalid, -textarea:focus:invalid, -select:focus:invalid { - color: #b94a48; - border-color: #ee5f5b; -} - -input:focus:invalid:focus, -textarea:focus:invalid:focus, -select:focus:invalid:focus { - border-color: #e9322d; - -webkit-box-shadow: 0 0 6px #f8b9b7; - -moz-box-shadow: 0 0 6px #f8b9b7; - box-shadow: 0 0 6px #f8b9b7; -} - -.form-actions { - padding: 19px 20px 20px; - margin-top: 20px; - margin-bottom: 20px; - background-color: #f5f5f5; - border-top: 1px solid #e5e5e5; - *zoom: 1; -} - -.form-actions:before, -.form-actions:after { - display: table; - line-height: 0; - content: ""; -} - -.form-actions:after { - clear: both; -} - -.help-block, -.help-inline { - color: #595959; -} - -.help-block { - display: block; - margin-bottom: 10px; -} - -.help-inline { - display: inline-block; - *display: inline; - padding-left: 5px; - vertical-align: middle; - *zoom: 1; -} - -.input-append, -.input-prepend { - display: inline-block; - margin-bottom: 10px; - font-size: 0; - white-space: nowrap; - vertical-align: middle; -} - -.input-append input, -.input-prepend input, -.input-append select, -.input-prepend select, -.input-append .uneditable-input, -.input-prepend .uneditable-input, -.input-append .dropdown-menu, -.input-prepend .dropdown-menu, -.input-append .popover, -.input-prepend .popover { - font-size: 14px; -} - -.input-append input, -.input-prepend input, -.input-append select, -.input-prepend select, -.input-append .uneditable-input, -.input-prepend .uneditable-input { - position: relative; - margin-bottom: 0; - *margin-left: 0; - vertical-align: top; - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.input-append input:focus, -.input-prepend input:focus, -.input-append select:focus, -.input-prepend select:focus, -.input-append .uneditable-input:focus, -.input-prepend .uneditable-input:focus { - z-index: 2; -} - -.input-append .add-on, -.input-prepend .add-on { - display: inline-block; - width: auto; - height: 20px; - min-width: 16px; - padding: 4px 5px; - font-size: 14px; - font-weight: normal; - line-height: 20px; - text-align: center; - text-shadow: 0 1px 0 #ffffff; - background-color: #eeeeee; - border: 1px solid #ccc; -} - -.input-append .add-on, -.input-prepend .add-on, -.input-append .btn, -.input-prepend .btn, -.input-append .btn-group > .dropdown-toggle, -.input-prepend .btn-group > .dropdown-toggle { - vertical-align: top; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.input-append .active, -.input-prepend .active { - background-color: #a9dba9; - border-color: #46a546; -} - -.input-prepend .add-on, -.input-prepend .btn { - margin-right: -1px; -} - -.input-prepend .add-on:first-child, -.input-prepend .btn:first-child { - -webkit-border-radius: 4px 0 0 4px; - -moz-border-radius: 4px 0 0 4px; - border-radius: 4px 0 0 4px; -} - -.input-append input, -.input-append select, -.input-append .uneditable-input { - -webkit-border-radius: 4px 0 0 4px; - -moz-border-radius: 4px 0 0 4px; - border-radius: 4px 0 0 4px; -} - -.input-append input + .btn-group .btn:last-child, -.input-append select + .btn-group .btn:last-child, -.input-append .uneditable-input + .btn-group .btn:last-child { - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.input-append .add-on, -.input-append .btn, -.input-append .btn-group { - margin-left: -1px; -} - -.input-append .add-on:last-child, -.input-append .btn:last-child, -.input-append .btn-group:last-child > .dropdown-toggle { - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.input-prepend.input-append input, -.input-prepend.input-append select, -.input-prepend.input-append .uneditable-input { - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.input-prepend.input-append input + .btn-group .btn, -.input-prepend.input-append select + .btn-group .btn, -.input-prepend.input-append .uneditable-input + .btn-group .btn { - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.input-prepend.input-append .add-on:first-child, -.input-prepend.input-append .btn:first-child { - margin-right: -1px; - -webkit-border-radius: 4px 0 0 4px; - -moz-border-radius: 4px 0 0 4px; - border-radius: 4px 0 0 4px; -} - -.input-prepend.input-append .add-on:last-child, -.input-prepend.input-append .btn:last-child { - margin-left: -1px; - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.input-prepend.input-append .btn-group:first-child { - margin-left: 0; -} - -input.search-query { - padding-right: 14px; - padding-right: 4px \9; - padding-left: 14px; - padding-left: 4px \9; - /* IE7-8 doesn't have border-radius, so don't indent the padding */ - - margin-bottom: 0; - -webkit-border-radius: 15px; - -moz-border-radius: 15px; - border-radius: 15px; -} - -/* Allow for input prepend/append in search forms */ - -.form-search .input-append .search-query, -.form-search .input-prepend .search-query { - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.form-search .input-append .search-query { - -webkit-border-radius: 14px 0 0 14px; - -moz-border-radius: 14px 0 0 14px; - border-radius: 14px 0 0 14px; -} - -.form-search .input-append .btn { - -webkit-border-radius: 0 14px 14px 0; - -moz-border-radius: 0 14px 14px 0; - border-radius: 0 14px 14px 0; -} - -.form-search .input-prepend .search-query { - -webkit-border-radius: 0 14px 14px 0; - -moz-border-radius: 0 14px 14px 0; - border-radius: 0 14px 14px 0; -} - -.form-search .input-prepend .btn { - -webkit-border-radius: 14px 0 0 14px; - -moz-border-radius: 14px 0 0 14px; - border-radius: 14px 0 0 14px; -} - -.form-search input, -.form-inline input, -.form-horizontal input, -.form-search textarea, -.form-inline textarea, -.form-horizontal textarea, -.form-search select, -.form-inline select, -.form-horizontal select, -.form-search .help-inline, -.form-inline .help-inline, -.form-horizontal .help-inline, -.form-search .uneditable-input, -.form-inline .uneditable-input, -.form-horizontal .uneditable-input, -.form-search .input-prepend, -.form-inline .input-prepend, -.form-horizontal .input-prepend, -.form-search .input-append, -.form-inline .input-append, -.form-horizontal .input-append { - display: inline-block; - *display: inline; - margin-bottom: 0; - vertical-align: middle; - *zoom: 1; -} - -.form-search .hide, -.form-inline .hide, -.form-horizontal .hide { - display: none; -} - -.form-search label, -.form-inline label, -.form-search .btn-group, -.form-inline .btn-group { - display: inline-block; -} - -.form-search .input-append, -.form-inline .input-append, -.form-search .input-prepend, -.form-inline .input-prepend { - margin-bottom: 0; -} - -.form-search .radio, -.form-search .checkbox, -.form-inline .radio, -.form-inline .checkbox { - padding-left: 0; - margin-bottom: 0; - vertical-align: middle; -} - -.form-search .radio input[type="radio"], -.form-search .checkbox input[type="checkbox"], -.form-inline .radio input[type="radio"], -.form-inline .checkbox input[type="checkbox"] { - float: left; - margin-right: 3px; - margin-left: 0; -} - -.control-group { - margin-bottom: 10px; -} - -legend + .control-group { - margin-top: 20px; - -webkit-margin-top-collapse: separate; -} - -.form-horizontal .control-group { - margin-bottom: 20px; - *zoom: 1; -} - -.form-horizontal .control-group:before, -.form-horizontal .control-group:after { - display: table; - line-height: 0; - content: ""; -} - -.form-horizontal .control-group:after { - clear: both; -} - -.form-horizontal .control-label { - float: left; - width: 160px; - padding-top: 5px; - text-align: right; -} - -.form-horizontal .controls { - *display: inline-block; - *padding-left: 20px; - margin-left: 180px; - *margin-left: 0; -} - -.form-horizontal .controls:first-child { - *padding-left: 180px; -} - -.form-horizontal .help-block { - margin-bottom: 0; -} - -.form-horizontal input + .help-block, -.form-horizontal select + .help-block, -.form-horizontal textarea + .help-block, -.form-horizontal .uneditable-input + .help-block, -.form-horizontal .input-prepend + .help-block, -.form-horizontal .input-append + .help-block { - margin-top: 10px; -} - -.form-horizontal .form-actions { - padding-left: 180px; -} - -table { - max-width: 100%; - background-color: transparent; - border-collapse: collapse; - border-spacing: 0; -} - -.table { - width: 100%; - margin-bottom: 20px; -} - -.table th, -.table td { - padding: 8px; - line-height: 20px; - text-align: left; - vertical-align: top; - border-top: 1px solid #dddddd; -} - -.table th { - font-weight: bold; -} - -.table thead th { - vertical-align: bottom; -} - -.table caption + thead tr:first-child th, -.table caption + thead tr:first-child td, -.table colgroup + thead tr:first-child th, -.table colgroup + thead tr:first-child td, -.table thead:first-child tr:first-child th, -.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 th, -.table-condensed td { - padding: 4px 5px; -} - -.table-bordered { - border: 1px solid #dddddd; - border-collapse: separate; - *border-collapse: collapse; - border-left: 0; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -.table-bordered th, -.table-bordered td { - border-left: 1px solid #dddddd; -} - -.table-bordered caption + thead tr:first-child th, -.table-bordered caption + tbody tr:first-child th, -.table-bordered caption + tbody tr:first-child td, -.table-bordered colgroup + thead tr:first-child th, -.table-bordered colgroup + tbody tr:first-child th, -.table-bordered colgroup + tbody tr:first-child td, -.table-bordered thead:first-child tr:first-child th, -.table-bordered tbody:first-child tr:first-child th, -.table-bordered tbody:first-child tr:first-child td { - border-top: 0; -} - -.table-bordered thead:first-child tr:first-child > th:first-child, -.table-bordered tbody:first-child tr:first-child > td:first-child, -.table-bordered tbody:first-child tr:first-child > th:first-child { - -webkit-border-top-left-radius: 4px; - border-top-left-radius: 4px; - -moz-border-radius-topleft: 4px; -} - -.table-bordered thead:first-child tr:first-child > th:last-child, -.table-bordered tbody:first-child tr:first-child > td:last-child, -.table-bordered tbody:first-child tr:first-child > th:last-child { - -webkit-border-top-right-radius: 4px; - border-top-right-radius: 4px; - -moz-border-radius-topright: 4px; -} - -.table-bordered thead:last-child tr:last-child > th:first-child, -.table-bordered tbody:last-child tr:last-child > td:first-child, -.table-bordered tbody:last-child tr:last-child > th:first-child, -.table-bordered tfoot:last-child tr:last-child > td:first-child, -.table-bordered tfoot:last-child tr:last-child > th:first-child { - -webkit-border-bottom-left-radius: 4px; - border-bottom-left-radius: 4px; - -moz-border-radius-bottomleft: 4px; -} - -.table-bordered thead:last-child tr:last-child > th:last-child, -.table-bordered tbody:last-child tr:last-child > td:last-child, -.table-bordered tbody:last-child tr:last-child > th:last-child, -.table-bordered tfoot:last-child tr:last-child > td:last-child, -.table-bordered tfoot:last-child tr:last-child > th:last-child { - -webkit-border-bottom-right-radius: 4px; - border-bottom-right-radius: 4px; - -moz-border-radius-bottomright: 4px; -} - -.table-bordered tfoot + tbody:last-child tr:last-child td:first-child { - -webkit-border-bottom-left-radius: 0; - border-bottom-left-radius: 0; - -moz-border-radius-bottomleft: 0; -} - -.table-bordered tfoot + tbody:last-child tr:last-child td:last-child { - -webkit-border-bottom-right-radius: 0; - border-bottom-right-radius: 0; - -moz-border-radius-bottomright: 0; -} - -.table-bordered caption + thead tr:first-child th:first-child, -.table-bordered caption + tbody tr:first-child td:first-child, -.table-bordered colgroup + thead tr:first-child th:first-child, -.table-bordered colgroup + tbody tr:first-child td:first-child { - -webkit-border-top-left-radius: 4px; - border-top-left-radius: 4px; - -moz-border-radius-topleft: 4px; -} - -.table-bordered caption + thead tr:first-child th:last-child, -.table-bordered caption + tbody tr:first-child td:last-child, -.table-bordered colgroup + thead tr:first-child th:last-child, -.table-bordered colgroup + tbody tr:first-child td:last-child { - -webkit-border-top-right-radius: 4px; - border-top-right-radius: 4px; - -moz-border-radius-topright: 4px; -} - -.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 td[class*="span"], -table th[class*="span"], -.row-fluid table td[class*="span"], -.row-fluid table th[class*="span"] { - display: table-cell; - float: none; - margin-left: 0; -} - -.table td.span1, -.table th.span1 { - float: none; - width: 44px; - margin-left: 0; -} - -.table td.span2, -.table th.span2 { - float: none; - width: 124px; - margin-left: 0; -} - -.table td.span3, -.table th.span3 { - float: none; - width: 204px; - margin-left: 0; -} - -.table td.span4, -.table th.span4 { - float: none; - width: 284px; - margin-left: 0; -} - -.table td.span5, -.table th.span5 { - float: none; - width: 364px; - margin-left: 0; -} - -.table td.span6, -.table th.span6 { - float: none; - width: 444px; - margin-left: 0; -} - -.table td.span7, -.table th.span7 { - float: none; - width: 524px; - margin-left: 0; -} - -.table td.span8, -.table th.span8 { - float: none; - width: 604px; - margin-left: 0; -} - -.table td.span9, -.table th.span9 { - float: none; - width: 684px; - margin-left: 0; -} - -.table td.span10, -.table th.span10 { - float: none; - width: 764px; - margin-left: 0; -} - -.table td.span11, -.table th.span11 { - float: none; - width: 844px; - margin-left: 0; -} - -.table td.span12, -.table th.span12 { - float: none; - width: 924px; - margin-left: 0; -} - -.table tbody tr.success > td { - background-color: #dff0d8; -} - -.table tbody tr.error > td { - background-color: #f2dede; -} - -.table tbody tr.warning > td { - background-color: #fcf8e3; -} - -.table tbody tr.info > td { - background-color: #d9edf7; -} - -.table-hover tbody tr.success:hover > td { - background-color: #d0e9c6; -} - -.table-hover tbody tr.error:hover > td { - background-color: #ebcccc; -} - -.table-hover tbody tr.warning:hover > td { - background-color: #faf2cc; -} - -.table-hover tbody tr.info:hover > td { - background-color: #c4e3f3; -} - -[class^="icon-"], -[class*=" icon-"] { - display: inline-block; - width: 14px; - height: 14px; - margin-top: 1px; - *margin-right: .3em; - line-height: 14px; - vertical-align: text-top; - background-image: url("../img/glyphicons-halflings.png"); - background-position: 14px 14px; - background-repeat: no-repeat; -} - -/* White icons with optional class, or on hover/focus/active states of certain elements */ - -.icon-white, -.nav-pills > .active > a > [class^="icon-"], -.nav-pills > .active > a > [class*=" icon-"], -.nav-list > .active > a > [class^="icon-"], -.nav-list > .active > a > [class*=" icon-"], -.navbar-inverse .nav > .active > a > [class^="icon-"], -.navbar-inverse .nav > .active > a > [class*=" icon-"], -.dropdown-menu > li > a:hover > [class^="icon-"], -.dropdown-menu > li > a:focus > [class^="icon-"], -.dropdown-menu > li > a:hover > [class*=" icon-"], -.dropdown-menu > li > a:focus > [class*=" icon-"], -.dropdown-menu > .active > a > [class^="icon-"], -.dropdown-menu > .active > a > [class*=" icon-"], -.dropdown-submenu:hover > a > [class^="icon-"], -.dropdown-submenu:focus > a > [class^="icon-"], -.dropdown-submenu:hover > a > [class*=" icon-"], -.dropdown-submenu:focus > a > [class*=" icon-"] { - background-image: url("../img/glyphicons-halflings-white.png"); -} - -.icon-glass { - background-position: 0 0; -} - -.icon-music { - background-position: -24px 0; -} - -.icon-search { - background-position: -48px 0; -} - -.icon-envelope { - background-position: -72px 0; -} - -.icon-heart { - background-position: -96px 0; -} - -.icon-star { - background-position: -120px 0; -} - -.icon-star-empty { - background-position: -144px 0; -} - -.icon-user { - background-position: -168px 0; -} - -.icon-film { - background-position: -192px 0; -} - -.icon-th-large { - background-position: -216px 0; -} - -.icon-th { - background-position: -240px 0; -} - -.icon-th-list { - background-position: -264px 0; -} - -.icon-ok { - background-position: -288px 0; -} - -.icon-remove { - background-position: -312px 0; -} - -.icon-zoom-in { - background-position: -336px 0; -} - -.icon-zoom-out { - background-position: -360px 0; -} - -.icon-off { - background-position: -384px 0; -} - -.icon-signal { - background-position: -408px 0; -} - -.icon-cog { - background-position: -432px 0; -} - -.icon-trash { - background-position: -456px 0; -} - -.icon-home { - background-position: 0 -24px; -} - -.icon-file { - background-position: -24px -24px; -} - -.icon-time { - background-position: -48px -24px; -} - -.icon-road { - background-position: -72px -24px; -} - -.icon-download-alt { - background-position: -96px -24px; -} - -.icon-download { - background-position: -120px -24px; -} - -.icon-upload { - background-position: -144px -24px; -} - -.icon-inbox { - background-position: -168px -24px; -} - -.icon-play-circle { - background-position: -192px -24px; -} - -.icon-repeat { - background-position: -216px -24px; -} - -.icon-refresh { - background-position: -240px -24px; -} - -.icon-list-alt { - background-position: -264px -24px; -} - -.icon-lock { - background-position: -287px -24px; -} - -.icon-flag { - background-position: -312px -24px; -} - -.icon-headphones { - background-position: -336px -24px; -} - -.icon-volume-off { - background-position: -360px -24px; -} - -.icon-volume-down { - background-position: -384px -24px; -} - -.icon-volume-up { - background-position: -408px -24px; -} - -.icon-qrcode { - background-position: -432px -24px; -} - -.icon-barcode { - background-position: -456px -24px; -} - -.icon-tag { - background-position: 0 -48px; -} - -.icon-tags { - background-position: -25px -48px; -} - -.icon-book { - background-position: -48px -48px; -} - -.icon-bookmark { - background-position: -72px -48px; -} - -.icon-print { - background-position: -96px -48px; -} - -.icon-camera { - background-position: -120px -48px; -} - -.icon-font { - background-position: -144px -48px; -} - -.icon-bold { - background-position: -167px -48px; -} - -.icon-italic { - background-position: -192px -48px; -} - -.icon-text-height { - background-position: -216px -48px; -} - -.icon-text-width { - background-position: -240px -48px; -} - -.icon-align-left { - background-position: -264px -48px; -} - -.icon-align-center { - background-position: -288px -48px; -} - -.icon-align-right { - background-position: -312px -48px; -} - -.icon-align-justify { - background-position: -336px -48px; -} - -.icon-list { - background-position: -360px -48px; -} - -.icon-indent-left { - background-position: -384px -48px; -} - -.icon-indent-right { - background-position: -408px -48px; -} - -.icon-facetime-video { - background-position: -432px -48px; -} - -.icon-picture { - background-position: -456px -48px; -} - -.icon-pencil { - background-position: 0 -72px; -} - -.icon-map-marker { - background-position: -24px -72px; -} - -.icon-adjust { - background-position: -48px -72px; -} - -.icon-tint { - background-position: -72px -72px; -} - -.icon-edit { - background-position: -96px -72px; -} - -.icon-share { - background-position: -120px -72px; -} - -.icon-check { - background-position: -144px -72px; -} - -.icon-move { - background-position: -168px -72px; -} - -.icon-step-backward { - background-position: -192px -72px; -} - -.icon-fast-backward { - background-position: -216px -72px; -} - -.icon-backward { - background-position: -240px -72px; -} - -.icon-play { - background-position: -264px -72px; -} - -.icon-pause { - background-position: -288px -72px; -} - -.icon-stop { - background-position: -312px -72px; -} - -.icon-forward { - background-position: -336px -72px; -} - -.icon-fast-forward { - background-position: -360px -72px; -} - -.icon-step-forward { - background-position: -384px -72px; -} - -.icon-eject { - background-position: -408px -72px; -} - -.icon-chevron-left { - background-position: -432px -72px; -} - -.icon-chevron-right { - background-position: -456px -72px; -} - -.icon-plus-sign { - background-position: 0 -96px; -} - -.icon-minus-sign { - background-position: -24px -96px; -} - -.icon-remove-sign { - background-position: -48px -96px; -} - -.icon-ok-sign { - background-position: -72px -96px; -} - -.icon-question-sign { - background-position: -96px -96px; -} - -.icon-info-sign { - background-position: -120px -96px; -} - -.icon-screenshot { - background-position: -144px -96px; -} - -.icon-remove-circle { - background-position: -168px -96px; -} - -.icon-ok-circle { - background-position: -192px -96px; -} - -.icon-ban-circle { - background-position: -216px -96px; -} - -.icon-arrow-left { - background-position: -240px -96px; -} - -.icon-arrow-right { - background-position: -264px -96px; -} - -.icon-arrow-up { - background-position: -289px -96px; -} - -.icon-arrow-down { - background-position: -312px -96px; -} - -.icon-share-alt { - background-position: -336px -96px; -} - -.icon-resize-full { - background-position: -360px -96px; -} - -.icon-resize-small { - background-position: -384px -96px; -} - -.icon-plus { - background-position: -408px -96px; -} - -.icon-minus { - background-position: -433px -96px; -} - -.icon-asterisk { - background-position: -456px -96px; -} - -.icon-exclamation-sign { - background-position: 0 -120px; -} - -.icon-gift { - background-position: -24px -120px; -} - -.icon-leaf { - background-position: -48px -120px; -} - -.icon-fire { - background-position: -72px -120px; -} - -.icon-eye-open { - background-position: -96px -120px; -} - -.icon-eye-close { - background-position: -120px -120px; -} - -.icon-warning-sign { - background-position: -144px -120px; -} - -.icon-plane { - background-position: -168px -120px; -} - -.icon-calendar { - background-position: -192px -120px; -} - -.icon-random { - width: 16px; - background-position: -216px -120px; -} - -.icon-comment { - background-position: -240px -120px; -} - -.icon-magnet { - background-position: -264px -120px; -} - -.icon-chevron-up { - background-position: -288px -120px; -} - -.icon-chevron-down { - background-position: -313px -119px; -} - -.icon-retweet { - background-position: -336px -120px; -} - -.icon-shopping-cart { - background-position: -360px -120px; -} - -.icon-folder-close { - width: 16px; - background-position: -384px -120px; -} - -.icon-folder-open { - width: 16px; - background-position: -408px -120px; -} - -.icon-resize-vertical { - background-position: -432px -119px; -} - -.icon-resize-horizontal { - background-position: -456px -118px; -} - -.icon-hdd { - background-position: 0 -144px; -} - -.icon-bullhorn { - background-position: -24px -144px; -} - -.icon-bell { - background-position: -48px -144px; -} - -.icon-certificate { - background-position: -72px -144px; -} - -.icon-thumbs-up { - background-position: -96px -144px; -} - -.icon-thumbs-down { - background-position: -120px -144px; -} - -.icon-hand-right { - background-position: -144px -144px; -} - -.icon-hand-left { - background-position: -168px -144px; -} - -.icon-hand-up { - background-position: -192px -144px; -} - -.icon-hand-down { - background-position: -216px -144px; -} - -.icon-circle-arrow-right { - background-position: -240px -144px; -} - -.icon-circle-arrow-left { - background-position: -264px -144px; -} - -.icon-circle-arrow-up { - background-position: -288px -144px; -} - -.icon-circle-arrow-down { - background-position: -312px -144px; -} - -.icon-globe { - background-position: -336px -144px; -} - -.icon-wrench { - background-position: -360px -144px; -} - -.icon-tasks { - background-position: -384px -144px; -} - -.icon-filter { - background-position: -408px -144px; -} - -.icon-briefcase { - background-position: -432px -144px; -} - -.icon-fullscreen { - background-position: -456px -144px; -} - -.dropup, -.dropdown { - position: relative; -} - -.dropdown-toggle { - *margin-bottom: -3px; -} - -.dropdown-toggle:active, -.open .dropdown-toggle { - outline: 0; -} - -.caret { - display: inline-block; - width: 0; - height: 0; - vertical-align: top; - border-top: 4px solid #000000; - border-right: 4px solid transparent; - border-left: 4px solid transparent; - content: ""; -} - -.dropdown .caret { - margin-top: 8px; - margin-left: 2px; -} - -.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; - list-style: none; - background-color: #ffffff; - border: 1px solid #ccc; - border: 1px solid rgba(0, 0, 0, 0.2); - *border-right-width: 2px; - *border-bottom-width: 2px; - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; - -webkit-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - -moz-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - -webkit-background-clip: padding-box; - -moz-background-clip: padding; - background-clip: padding-box; -} - -.dropdown-menu.pull-right { - right: 0; - left: auto; -} - -.dropdown-menu .divider { - *width: 100%; - height: 1px; - margin: 9px 1px; - *margin: -5px 0 5px; - overflow: hidden; - background-color: #e5e5e5; - border-bottom: 1px solid #ffffff; -} - -.dropdown-menu > li > a { - display: block; - padding: 3px 20px; - clear: both; - font-weight: normal; - line-height: 20px; - color: #333333; - white-space: nowrap; -} - -.dropdown-menu > li > a:hover, -.dropdown-menu > li > a:focus, -.dropdown-submenu:hover > a, -.dropdown-submenu:focus > a { - color: #ffffff; - text-decoration: none; - background-color: #0081c2; - background-image: -moz-linear-gradient(top, #0088cc, #0077b3); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#0088cc), to(#0077b3)); - background-image: -webkit-linear-gradient(top, #0088cc, #0077b3); - background-image: -o-linear-gradient(top, #0088cc, #0077b3); - background-image: linear-gradient(to bottom, #0088cc, #0077b3); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0077b3', GradientType=0); -} - -.dropdown-menu > .active > a, -.dropdown-menu > .active > a:hover, -.dropdown-menu > .active > a:focus { - color: #ffffff; - text-decoration: none; - background-color: #0081c2; - background-image: -moz-linear-gradient(top, #0088cc, #0077b3); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#0088cc), to(#0077b3)); - background-image: -webkit-linear-gradient(top, #0088cc, #0077b3); - background-image: -o-linear-gradient(top, #0088cc, #0077b3); - background-image: linear-gradient(to bottom, #0088cc, #0077b3); - background-repeat: repeat-x; - outline: 0; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0077b3', GradientType=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: default; - background-color: transparent; - background-image: none; - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.open { - *z-index: 1000; -} - -.open > .dropdown-menu { - display: block; -} - -.pull-right > .dropdown-menu { - right: 0; - left: auto; -} - -.dropup .caret, -.navbar-fixed-bottom .dropdown .caret { - border-top: 0; - border-bottom: 4px solid #000000; - content: ""; -} - -.dropup .dropdown-menu, -.navbar-fixed-bottom .dropdown .dropdown-menu { - top: auto; - bottom: 100%; - margin-bottom: 1px; -} - -.dropdown-submenu { - position: relative; -} - -.dropdown-submenu > .dropdown-menu { - top: 0; - left: 100%; - margin-top: -6px; - margin-left: -1px; - -webkit-border-radius: 0 6px 6px 6px; - -moz-border-radius: 0 6px 6px 6px; - border-radius: 0 6px 6px 6px; -} - -.dropdown-submenu:hover > .dropdown-menu { - display: block; -} - -.dropup .dropdown-submenu > .dropdown-menu { - top: auto; - bottom: 0; - margin-top: 0; - margin-bottom: -2px; - -webkit-border-radius: 5px 5px 5px 0; - -moz-border-radius: 5px 5px 5px 0; - border-radius: 5px 5px 5px 0; -} - -.dropdown-submenu > a:after { - display: block; - float: right; - width: 0; - height: 0; - margin-top: 5px; - margin-right: -10px; - border-color: transparent; - border-left-color: #cccccc; - border-style: solid; - border-width: 5px 0 5px 5px; - content: " "; -} - -.dropdown-submenu:hover > a:after { - border-left-color: #ffffff; -} - -.dropdown-submenu.pull-left { - float: none; -} - -.dropdown-submenu.pull-left > .dropdown-menu { - left: -100%; - margin-left: 10px; - -webkit-border-radius: 6px 0 6px 6px; - -moz-border-radius: 6px 0 6px 6px; - border-radius: 6px 0 6px 6px; -} - -.dropdown .dropdown-menu .nav-header { - padding-right: 20px; - padding-left: 20px; -} - -.typeahead { - z-index: 1051; - margin-top: 2px; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -.well { - min-height: 20px; - padding: 19px; - margin-bottom: 20px; - background-color: #f5f5f5; - border: 1px solid #e3e3e3; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); - -moz-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-large { - padding: 24px; - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; -} - -.well-small { - padding: 9px; - -webkit-border-radius: 3px; - -moz-border-radius: 3px; - border-radius: 3px; -} - -.fade { - opacity: 0; - -webkit-transition: opacity 0.15s linear; - -moz-transition: opacity 0.15s linear; - -o-transition: opacity 0.15s linear; - transition: opacity 0.15s linear; -} - -.fade.in { - opacity: 1; -} - -.collapse { - position: relative; - height: 0; - overflow: hidden; - -webkit-transition: height 0.35s ease; - -moz-transition: height 0.35s ease; - -o-transition: height 0.35s ease; - transition: height 0.35s ease; -} - -.collapse.in { - height: auto; -} - -.close { - float: right; - font-size: 20px; - font-weight: bold; - line-height: 20px; - 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.4; - filter: alpha(opacity=40); -} - -button.close { - padding: 0; - cursor: pointer; - background: transparent; - border: 0; - -webkit-appearance: none; -} - -.btn { - display: inline-block; - *display: inline; - padding: 4px 12px; - margin-bottom: 0; - *margin-left: .3em; - font-size: 14px; - line-height: 20px; - color: #333333; - text-align: center; - text-shadow: 0 1px 1px rgba(255, 255, 255, 0.75); - vertical-align: middle; - cursor: pointer; - background-color: #f5f5f5; - *background-color: #e6e6e6; - background-image: -moz-linear-gradient(top, #ffffff, #e6e6e6); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#e6e6e6)); - background-image: -webkit-linear-gradient(top, #ffffff, #e6e6e6); - background-image: -o-linear-gradient(top, #ffffff, #e6e6e6); - background-image: linear-gradient(to bottom, #ffffff, #e6e6e6); - background-repeat: repeat-x; - border: 1px solid #cccccc; - *border: 0; - border-color: #e6e6e6 #e6e6e6 #bfbfbf; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - border-bottom-color: #b3b3b3; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffe6e6e6', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); - *zoom: 1; - -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); - -moz-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); - box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); -} - -.btn:hover, -.btn:focus, -.btn:active, -.btn.active, -.btn.disabled, -.btn[disabled] { - color: #333333; - background-color: #e6e6e6; - *background-color: #d9d9d9; -} - -.btn:active, -.btn.active { - background-color: #cccccc \9; -} - -.btn:first-child { - *margin-left: 0; -} - -.btn:hover, -.btn:focus { - color: #333333; - text-decoration: none; - background-position: 0 -15px; - -webkit-transition: background-position 0.1s linear; - -moz-transition: background-position 0.1s linear; - -o-transition: background-position 0.1s linear; - transition: background-position 0.1s linear; -} - -.btn:focus { - outline: thin dotted #333; - outline: 5px auto -webkit-focus-ring-color; - outline-offset: -2px; -} - -.btn.active, -.btn:active { - background-image: none; - outline: 0; - -webkit-box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); - -moz-box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); - box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); -} - -.btn.disabled, -.btn[disabled] { - cursor: default; - background-image: none; - opacity: 0.65; - filter: alpha(opacity=65); - -webkit-box-shadow: none; - -moz-box-shadow: none; - box-shadow: none; -} - -.btn-large { - padding: 11px 19px; - font-size: 17.5px; - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; -} - -.btn-large [class^="icon-"], -.btn-large [class*=" icon-"] { - margin-top: 4px; -} - -.btn-small { - padding: 2px 10px; - font-size: 11.9px; - -webkit-border-radius: 3px; - -moz-border-radius: 3px; - border-radius: 3px; -} - -.btn-small [class^="icon-"], -.btn-small [class*=" icon-"] { - margin-top: 0; -} - -.btn-mini [class^="icon-"], -.btn-mini [class*=" icon-"] { - margin-top: -1px; -} - -.btn-mini { - padding: 0 6px; - font-size: 10.5px; - -webkit-border-radius: 3px; - -moz-border-radius: 3px; - border-radius: 3px; -} - -.btn-block { - display: block; - width: 100%; - padding-right: 0; - padding-left: 0; - -webkit-box-sizing: border-box; - -moz-box-sizing: border-box; - box-sizing: border-box; -} - -.btn-block + .btn-block { - margin-top: 5px; -} - -input[type="submit"].btn-block, -input[type="reset"].btn-block, -input[type="button"].btn-block { - width: 100%; -} - -.btn-primary.active, -.btn-warning.active, -.btn-danger.active, -.btn-success.active, -.btn-info.active, -.btn-inverse.active { - color: rgba(255, 255, 255, 0.75); -} - -.btn-primary { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #006dcc; - *background-color: #0044cc; - background-image: -moz-linear-gradient(top, #0088cc, #0044cc); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#0088cc), to(#0044cc)); - background-image: -webkit-linear-gradient(top, #0088cc, #0044cc); - background-image: -o-linear-gradient(top, #0088cc, #0044cc); - background-image: linear-gradient(to bottom, #0088cc, #0044cc); - background-repeat: repeat-x; - border-color: #0044cc #0044cc #002a80; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0044cc', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-primary:hover, -.btn-primary:focus, -.btn-primary:active, -.btn-primary.active, -.btn-primary.disabled, -.btn-primary[disabled] { - color: #ffffff; - background-color: #0044cc; - *background-color: #003bb3; -} - -.btn-primary:active, -.btn-primary.active { - background-color: #003399 \9; -} - -.btn-warning { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #faa732; - *background-color: #f89406; - background-image: -moz-linear-gradient(top, #fbb450, #f89406); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#fbb450), to(#f89406)); - background-image: -webkit-linear-gradient(top, #fbb450, #f89406); - background-image: -o-linear-gradient(top, #fbb450, #f89406); - background-image: linear-gradient(to bottom, #fbb450, #f89406); - background-repeat: repeat-x; - border-color: #f89406 #f89406 #ad6704; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffbb450', endColorstr='#fff89406', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-warning:hover, -.btn-warning:focus, -.btn-warning:active, -.btn-warning.active, -.btn-warning.disabled, -.btn-warning[disabled] { - color: #ffffff; - background-color: #f89406; - *background-color: #df8505; -} - -.btn-warning:active, -.btn-warning.active { - background-color: #c67605 \9; -} - -.btn-danger { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #da4f49; - *background-color: #bd362f; - background-image: -moz-linear-gradient(top, #ee5f5b, #bd362f); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#bd362f)); - background-image: -webkit-linear-gradient(top, #ee5f5b, #bd362f); - background-image: -o-linear-gradient(top, #ee5f5b, #bd362f); - background-image: linear-gradient(to bottom, #ee5f5b, #bd362f); - background-repeat: repeat-x; - border-color: #bd362f #bd362f #802420; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffee5f5b', endColorstr='#ffbd362f', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-danger:hover, -.btn-danger:focus, -.btn-danger:active, -.btn-danger.active, -.btn-danger.disabled, -.btn-danger[disabled] { - color: #ffffff; - background-color: #bd362f; - *background-color: #a9302a; -} - -.btn-danger:active, -.btn-danger.active { - background-color: #942a25 \9; -} - -.btn-success { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #5bb75b; - *background-color: #51a351; - background-image: -moz-linear-gradient(top, #62c462, #51a351); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#51a351)); - background-image: -webkit-linear-gradient(top, #62c462, #51a351); - background-image: -o-linear-gradient(top, #62c462, #51a351); - background-image: linear-gradient(to bottom, #62c462, #51a351); - background-repeat: repeat-x; - border-color: #51a351 #51a351 #387038; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff62c462', endColorstr='#ff51a351', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-success:hover, -.btn-success:focus, -.btn-success:active, -.btn-success.active, -.btn-success.disabled, -.btn-success[disabled] { - color: #ffffff; - background-color: #51a351; - *background-color: #499249; -} - -.btn-success:active, -.btn-success.active { - background-color: #408140 \9; -} - -.btn-info { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #49afcd; - *background-color: #2f96b4; - background-image: -moz-linear-gradient(top, #5bc0de, #2f96b4); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#2f96b4)); - background-image: -webkit-linear-gradient(top, #5bc0de, #2f96b4); - background-image: -o-linear-gradient(top, #5bc0de, #2f96b4); - background-image: linear-gradient(to bottom, #5bc0de, #2f96b4); - background-repeat: repeat-x; - border-color: #2f96b4 #2f96b4 #1f6377; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff5bc0de', endColorstr='#ff2f96b4', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-info:hover, -.btn-info:focus, -.btn-info:active, -.btn-info.active, -.btn-info.disabled, -.btn-info[disabled] { - color: #ffffff; - background-color: #2f96b4; - *background-color: #2a85a0; -} - -.btn-info:active, -.btn-info.active { - background-color: #24748c \9; -} - -.btn-inverse { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #363636; - *background-color: #222222; - background-image: -moz-linear-gradient(top, #444444, #222222); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#444444), to(#222222)); - background-image: -webkit-linear-gradient(top, #444444, #222222); - background-image: -o-linear-gradient(top, #444444, #222222); - background-image: linear-gradient(to bottom, #444444, #222222); - background-repeat: repeat-x; - border-color: #222222 #222222 #000000; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff444444', endColorstr='#ff222222', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.btn-inverse:hover, -.btn-inverse:focus, -.btn-inverse:active, -.btn-inverse.active, -.btn-inverse.disabled, -.btn-inverse[disabled] { - color: #ffffff; - background-color: #222222; - *background-color: #151515; -} - -.btn-inverse:active, -.btn-inverse.active { - background-color: #080808 \9; -} - -button.btn, -input[type="submit"].btn { - *padding-top: 3px; - *padding-bottom: 3px; -} - -button.btn::-moz-focus-inner, -input[type="submit"].btn::-moz-focus-inner { - padding: 0; - border: 0; -} - -button.btn.btn-large, -input[type="submit"].btn.btn-large { - *padding-top: 7px; - *padding-bottom: 7px; -} - -button.btn.btn-small, -input[type="submit"].btn.btn-small { - *padding-top: 3px; - *padding-bottom: 3px; -} - -button.btn.btn-mini, -input[type="submit"].btn.btn-mini { - *padding-top: 1px; - *padding-bottom: 1px; -} - -.btn-link, -.btn-link:active, -.btn-link[disabled] { - background-color: transparent; - background-image: none; - -webkit-box-shadow: none; - -moz-box-shadow: none; - box-shadow: none; -} - -.btn-link { - color: #0088cc; - cursor: pointer; - border-color: transparent; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.btn-link:hover, -.btn-link:focus { - color: #005580; - text-decoration: underline; - background-color: transparent; -} - -.btn-link[disabled]:hover, -.btn-link[disabled]:focus { - color: #333333; - text-decoration: none; -} - -.btn-group { - position: relative; - display: inline-block; - *display: inline; - *margin-left: .3em; - font-size: 0; - white-space: nowrap; - vertical-align: middle; - *zoom: 1; -} - -.btn-group:first-child { - *margin-left: 0; -} - -.btn-group + .btn-group { - margin-left: 5px; -} - -.btn-toolbar { - margin-top: 10px; - margin-bottom: 10px; - font-size: 0; -} - -.btn-toolbar > .btn + .btn, -.btn-toolbar > .btn-group + .btn, -.btn-toolbar > .btn + .btn-group { - margin-left: 5px; -} - -.btn-group > .btn { - position: relative; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.btn-group > .btn + .btn { - margin-left: -1px; -} - -.btn-group > .btn, -.btn-group > .dropdown-menu, -.btn-group > .popover { - font-size: 14px; -} - -.btn-group > .btn-mini { - font-size: 10.5px; -} - -.btn-group > .btn-small { - font-size: 11.9px; -} - -.btn-group > .btn-large { - font-size: 17.5px; -} - -.btn-group > .btn:first-child { - margin-left: 0; - -webkit-border-bottom-left-radius: 4px; - border-bottom-left-radius: 4px; - -webkit-border-top-left-radius: 4px; - border-top-left-radius: 4px; - -moz-border-radius-bottomleft: 4px; - -moz-border-radius-topleft: 4px; -} - -.btn-group > .btn:last-child, -.btn-group > .dropdown-toggle { - -webkit-border-top-right-radius: 4px; - border-top-right-radius: 4px; - -webkit-border-bottom-right-radius: 4px; - border-bottom-right-radius: 4px; - -moz-border-radius-topright: 4px; - -moz-border-radius-bottomright: 4px; -} - -.btn-group > .btn.large:first-child { - margin-left: 0; - -webkit-border-bottom-left-radius: 6px; - border-bottom-left-radius: 6px; - -webkit-border-top-left-radius: 6px; - border-top-left-radius: 6px; - -moz-border-radius-bottomleft: 6px; - -moz-border-radius-topleft: 6px; -} - -.btn-group > .btn.large:last-child, -.btn-group > .large.dropdown-toggle { - -webkit-border-top-right-radius: 6px; - border-top-right-radius: 6px; - -webkit-border-bottom-right-radius: 6px; - border-bottom-right-radius: 6px; - -moz-border-radius-topright: 6px; - -moz-border-radius-bottomright: 6px; -} - -.btn-group > .btn:hover, -.btn-group > .btn:focus, -.btn-group > .btn:active, -.btn-group > .btn.active { - z-index: 2; -} - -.btn-group .dropdown-toggle:active, -.btn-group.open .dropdown-toggle { - outline: 0; -} - -.btn-group > .btn + .dropdown-toggle { - *padding-top: 5px; - padding-right: 8px; - *padding-bottom: 5px; - padding-left: 8px; - -webkit-box-shadow: inset 1px 0 0 rgba(255, 255, 255, 0.125), inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); - -moz-box-shadow: inset 1px 0 0 rgba(255, 255, 255, 0.125), inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); - box-shadow: inset 1px 0 0 rgba(255, 255, 255, 0.125), inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); -} - -.btn-group > .btn-mini + .dropdown-toggle { - *padding-top: 2px; - padding-right: 5px; - *padding-bottom: 2px; - padding-left: 5px; -} - -.btn-group > .btn-small + .dropdown-toggle { - *padding-top: 5px; - *padding-bottom: 4px; -} - -.btn-group > .btn-large + .dropdown-toggle { - *padding-top: 7px; - padding-right: 12px; - *padding-bottom: 7px; - padding-left: 12px; -} - -.btn-group.open .dropdown-toggle { - background-image: none; - -webkit-box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); - -moz-box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); - box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); -} - -.btn-group.open .btn.dropdown-toggle { - background-color: #e6e6e6; -} - -.btn-group.open .btn-primary.dropdown-toggle { - background-color: #0044cc; -} - -.btn-group.open .btn-warning.dropdown-toggle { - background-color: #f89406; -} - -.btn-group.open .btn-danger.dropdown-toggle { - background-color: #bd362f; -} - -.btn-group.open .btn-success.dropdown-toggle { - background-color: #51a351; -} - -.btn-group.open .btn-info.dropdown-toggle { - background-color: #2f96b4; -} - -.btn-group.open .btn-inverse.dropdown-toggle { - background-color: #222222; -} - -.btn .caret { - margin-top: 8px; - margin-left: 0; -} - -.btn-large .caret { - margin-top: 6px; -} - -.btn-large .caret { - border-top-width: 5px; - border-right-width: 5px; - border-left-width: 5px; -} - -.btn-mini .caret, -.btn-small .caret { - margin-top: 8px; -} - -.dropup .btn-large .caret { - border-bottom-width: 5px; -} - -.btn-primary .caret, -.btn-warning .caret, -.btn-danger .caret, -.btn-info .caret, -.btn-success .caret, -.btn-inverse .caret { - border-top-color: #ffffff; - border-bottom-color: #ffffff; -} - -.btn-group-vertical { - display: inline-block; - *display: inline; - /* IE7 inline-block hack */ - - *zoom: 1; -} - -.btn-group-vertical > .btn { - display: block; - float: none; - max-width: 100%; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.btn-group-vertical > .btn + .btn { - margin-top: -1px; - margin-left: 0; -} - -.btn-group-vertical > .btn:first-child { - -webkit-border-radius: 4px 4px 0 0; - -moz-border-radius: 4px 4px 0 0; - border-radius: 4px 4px 0 0; -} - -.btn-group-vertical > .btn:last-child { - -webkit-border-radius: 0 0 4px 4px; - -moz-border-radius: 0 0 4px 4px; - border-radius: 0 0 4px 4px; -} - -.btn-group-vertical > .btn-large:first-child { - -webkit-border-radius: 6px 6px 0 0; - -moz-border-radius: 6px 6px 0 0; - border-radius: 6px 6px 0 0; -} - -.btn-group-vertical > .btn-large:last-child { - -webkit-border-radius: 0 0 6px 6px; - -moz-border-radius: 0 0 6px 6px; - border-radius: 0 0 6px 6px; -} - -.alert { - padding: 8px 35px 8px 14px; - margin-bottom: 20px; - text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5); - background-color: #fcf8e3; - border: 1px solid #fbeed5; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -.alert, -.alert h4 { - color: #c09853; -} - -.alert h4 { - margin: 0; -} - -.alert .close { - position: relative; - top: -2px; - right: -21px; - line-height: 20px; -} - -.alert-success { - color: #468847; - background-color: #dff0d8; - border-color: #d6e9c6; -} - -.alert-success h4 { - color: #468847; -} - -.alert-danger, -.alert-error { - color: #b94a48; - background-color: #f2dede; - border-color: #eed3d7; -} - -.alert-danger h4, -.alert-error h4 { - color: #b94a48; -} - -.alert-info { - color: #3a87ad; - background-color: #d9edf7; - border-color: #bce8f1; -} - -.alert-info h4 { - color: #3a87ad; -} - -.alert-block { - padding-top: 14px; - padding-bottom: 14px; -} - -.alert-block > p, -.alert-block > ul { - margin-bottom: 0; -} - -.alert-block p + p { - margin-top: 5px; -} - -.nav { - margin-bottom: 20px; - margin-left: 0; - list-style: none; -} - -.nav > li > a { - display: block; -} - -.nav > li > a:hover, -.nav > li > a:focus { - text-decoration: none; - background-color: #eeeeee; -} - -.nav > li > a > img { - max-width: none; -} - -.nav > .pull-right { - float: right; -} - -.nav-header { - display: block; - padding: 3px 15px; - font-size: 11px; - font-weight: bold; - line-height: 20px; - color: #999999; - text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5); - text-transform: uppercase; -} - -.nav li + .nav-header { - margin-top: 9px; -} - -.nav-list { - padding-right: 15px; - padding-left: 15px; - margin-bottom: 0; -} - -.nav-list > li > a, -.nav-list .nav-header { - margin-right: -15px; - margin-left: -15px; - text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5); -} - -.nav-list > li > a { - padding: 3px 15px; -} - -.nav-list > .active > a, -.nav-list > .active > a:hover, -.nav-list > .active > a:focus { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.2); - background-color: #0088cc; -} - -.nav-list [class^="icon-"], -.nav-list [class*=" icon-"] { - margin-right: 2px; -} - -.nav-list .divider { - *width: 100%; - height: 1px; - margin: 9px 1px; - *margin: -5px 0 5px; - overflow: hidden; - background-color: #e5e5e5; - border-bottom: 1px solid #ffffff; -} - -.nav-tabs, -.nav-pills { - *zoom: 1; -} - -.nav-tabs:before, -.nav-pills:before, -.nav-tabs:after, -.nav-pills:after { - display: table; - line-height: 0; - content: ""; -} - -.nav-tabs:after, -.nav-pills:after { - clear: both; -} - -.nav-tabs > li, -.nav-pills > li { - float: left; -} - -.nav-tabs > li > a, -.nav-pills > li > a { - padding-right: 12px; - padding-left: 12px; - margin-right: 2px; - line-height: 14px; -} - -.nav-tabs { - border-bottom: 1px solid #ddd; -} - -.nav-tabs > li { - margin-bottom: -1px; -} - -.nav-tabs > li > a { - padding-top: 8px; - padding-bottom: 8px; - line-height: 20px; - border: 1px solid transparent; - -webkit-border-radius: 4px 4px 0 0; - -moz-border-radius: 4px 4px 0 0; - border-radius: 4px 4px 0 0; -} - -.nav-tabs > li > a:hover, -.nav-tabs > li > a:focus { - border-color: #eeeeee #eeeeee #dddddd; -} - -.nav-tabs > .active > a, -.nav-tabs > .active > a:hover, -.nav-tabs > .active > a:focus { - color: #555555; - cursor: default; - background-color: #ffffff; - border: 1px solid #ddd; - border-bottom-color: transparent; -} - -.nav-pills > li > a { - padding-top: 8px; - padding-bottom: 8px; - margin-top: 2px; - margin-bottom: 2px; - -webkit-border-radius: 5px; - -moz-border-radius: 5px; - border-radius: 5px; -} - -.nav-pills > .active > a, -.nav-pills > .active > a:hover, -.nav-pills > .active > a:focus { - color: #ffffff; - background-color: #0088cc; -} - -.nav-stacked > li { - float: none; -} - -.nav-stacked > li > a { - margin-right: 0; -} - -.nav-tabs.nav-stacked { - border-bottom: 0; -} - -.nav-tabs.nav-stacked > li > a { - border: 1px solid #ddd; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.nav-tabs.nav-stacked > li:first-child > a { - -webkit-border-top-right-radius: 4px; - border-top-right-radius: 4px; - -webkit-border-top-left-radius: 4px; - border-top-left-radius: 4px; - -moz-border-radius-topright: 4px; - -moz-border-radius-topleft: 4px; -} - -.nav-tabs.nav-stacked > li:last-child > a { - -webkit-border-bottom-right-radius: 4px; - border-bottom-right-radius: 4px; - -webkit-border-bottom-left-radius: 4px; - border-bottom-left-radius: 4px; - -moz-border-radius-bottomright: 4px; - -moz-border-radius-bottomleft: 4px; -} - -.nav-tabs.nav-stacked > li > a:hover, -.nav-tabs.nav-stacked > li > a:focus { - z-index: 2; - border-color: #ddd; -} - -.nav-pills.nav-stacked > li > a { - margin-bottom: 3px; -} - -.nav-pills.nav-stacked > li:last-child > a { - margin-bottom: 1px; -} - -.nav-tabs .dropdown-menu { - -webkit-border-radius: 0 0 6px 6px; - -moz-border-radius: 0 0 6px 6px; - border-radius: 0 0 6px 6px; -} - -.nav-pills .dropdown-menu { - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; -} - -.nav .dropdown-toggle .caret { - margin-top: 6px; - border-top-color: #0088cc; - border-bottom-color: #0088cc; -} - -.nav .dropdown-toggle:hover .caret, -.nav .dropdown-toggle:focus .caret { - border-top-color: #005580; - border-bottom-color: #005580; -} - -/* move down carets for tabs */ - -.nav-tabs .dropdown-toggle .caret { - margin-top: 8px; -} - -.nav .active .dropdown-toggle .caret { - border-top-color: #fff; - border-bottom-color: #fff; -} - -.nav-tabs .active .dropdown-toggle .caret { - border-top-color: #555555; - border-bottom-color: #555555; -} - -.nav > .dropdown.active > a:hover, -.nav > .dropdown.active > a:focus { - cursor: pointer; -} - -.nav-tabs .open .dropdown-toggle, -.nav-pills .open .dropdown-toggle, -.nav > li.dropdown.open.active > a:hover, -.nav > li.dropdown.open.active > a:focus { - color: #ffffff; - background-color: #999999; - border-color: #999999; -} - -.nav li.dropdown.open .caret, -.nav li.dropdown.open.active .caret, -.nav li.dropdown.open a:hover .caret, -.nav li.dropdown.open a:focus .caret { - border-top-color: #ffffff; - border-bottom-color: #ffffff; - opacity: 1; - filter: alpha(opacity=100); -} - -.tabs-stacked .open > a:hover, -.tabs-stacked .open > a:focus { - border-color: #999999; -} - -.tabbable { - *zoom: 1; -} - -.tabbable:before, -.tabbable:after { - display: table; - line-height: 0; - content: ""; -} - -.tabbable:after { - clear: both; -} - -.tab-content { - overflow: auto; -} - -.tabs-below > .nav-tabs, -.tabs-right > .nav-tabs, -.tabs-left > .nav-tabs { - border-bottom: 0; -} - -.tab-content > .tab-pane, -.pill-content > .pill-pane { - display: none; -} - -.tab-content > .active, -.pill-content > .active { - display: block; -} - -.tabs-below > .nav-tabs { - border-top: 1px solid #ddd; -} - -.tabs-below > .nav-tabs > li { - margin-top: -1px; - margin-bottom: 0; -} - -.tabs-below > .nav-tabs > li > a { - -webkit-border-radius: 0 0 4px 4px; - -moz-border-radius: 0 0 4px 4px; - border-radius: 0 0 4px 4px; -} - -.tabs-below > .nav-tabs > li > a:hover, -.tabs-below > .nav-tabs > li > a:focus { - border-top-color: #ddd; - border-bottom-color: transparent; -} - -.tabs-below > .nav-tabs > .active > a, -.tabs-below > .nav-tabs > .active > a:hover, -.tabs-below > .nav-tabs > .active > a:focus { - border-color: transparent #ddd #ddd #ddd; -} - -.tabs-left > .nav-tabs > li, -.tabs-right > .nav-tabs > li { - float: none; -} - -.tabs-left > .nav-tabs > li > a, -.tabs-right > .nav-tabs > li > a { - min-width: 74px; - margin-right: 0; - margin-bottom: 3px; -} - -.tabs-left > .nav-tabs { - float: left; - margin-right: 19px; - border-right: 1px solid #ddd; -} - -.tabs-left > .nav-tabs > li > a { - margin-right: -1px; - -webkit-border-radius: 4px 0 0 4px; - -moz-border-radius: 4px 0 0 4px; - border-radius: 4px 0 0 4px; -} - -.tabs-left > .nav-tabs > li > a:hover, -.tabs-left > .nav-tabs > li > a:focus { - border-color: #eeeeee #dddddd #eeeeee #eeeeee; -} - -.tabs-left > .nav-tabs .active > a, -.tabs-left > .nav-tabs .active > a:hover, -.tabs-left > .nav-tabs .active > a:focus { - border-color: #ddd transparent #ddd #ddd; - *border-right-color: #ffffff; -} - -.tabs-right > .nav-tabs { - float: right; - margin-left: 19px; - border-left: 1px solid #ddd; -} - -.tabs-right > .nav-tabs > li > a { - margin-left: -1px; - -webkit-border-radius: 0 4px 4px 0; - -moz-border-radius: 0 4px 4px 0; - border-radius: 0 4px 4px 0; -} - -.tabs-right > .nav-tabs > li > a:hover, -.tabs-right > .nav-tabs > li > a:focus { - border-color: #eeeeee #eeeeee #eeeeee #dddddd; -} - -.tabs-right > .nav-tabs .active > a, -.tabs-right > .nav-tabs .active > a:hover, -.tabs-right > .nav-tabs .active > a:focus { - border-color: #ddd #ddd #ddd transparent; - *border-left-color: #ffffff; -} - -.nav > .disabled > a { - color: #999999; -} - -.nav > .disabled > a:hover, -.nav > .disabled > a:focus { - text-decoration: none; - cursor: default; - background-color: transparent; -} - -.navbar { - *position: relative; - *z-index: 2; - margin-bottom: 20px; - overflow: visible; -} - -.navbar-inner { - min-height: 40px; - padding-right: 20px; - padding-left: 20px; - background-color: #fafafa; - background-image: -moz-linear-gradient(top, #ffffff, #f2f2f2); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#f2f2f2)); - background-image: -webkit-linear-gradient(top, #ffffff, #f2f2f2); - background-image: -o-linear-gradient(top, #ffffff, #f2f2f2); - background-image: linear-gradient(to bottom, #ffffff, #f2f2f2); - background-repeat: repeat-x; - border: 1px solid #d4d4d4; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#fff2f2f2', GradientType=0); - *zoom: 1; - -webkit-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - -moz-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); -} - -.navbar-inner:before, -.navbar-inner:after { - display: table; - line-height: 0; - content: ""; -} - -.navbar-inner:after { - clear: both; -} - -.navbar .container { - width: auto; -} - -.nav-collapse.collapse { - height: auto; - overflow: visible; -} - -.navbar .brand { - display: block; - float: left; - padding: 10px 20px 10px; - margin-left: -20px; - font-size: 20px; - font-weight: 200; - color: #777777; - text-shadow: 0 1px 0 #ffffff; -} - -.navbar .brand:hover, -.navbar .brand:focus { - text-decoration: none; -} - -.navbar-text { - margin-bottom: 0; - line-height: 40px; - color: #777777; -} - -.navbar-link { - color: #777777; -} - -.navbar-link:hover, -.navbar-link:focus { - color: #333333; -} - -.navbar .divider-vertical { - height: 40px; - margin: 0 9px; - border-right: 1px solid #ffffff; - border-left: 1px solid #f2f2f2; -} - -.navbar .btn, -.navbar .btn-group { - margin-top: 5px; -} - -.navbar .btn-group .btn, -.navbar .input-prepend .btn, -.navbar .input-append .btn, -.navbar .input-prepend .btn-group, -.navbar .input-append .btn-group { - margin-top: 0; -} - -.navbar-form { - margin-bottom: 0; - *zoom: 1; -} - -.navbar-form:before, -.navbar-form:after { - display: table; - line-height: 0; - content: ""; -} - -.navbar-form:after { - clear: both; -} - -.navbar-form input, -.navbar-form select, -.navbar-form .radio, -.navbar-form .checkbox { - margin-top: 5px; -} - -.navbar-form input, -.navbar-form select, -.navbar-form .btn { - display: inline-block; - margin-bottom: 0; -} - -.navbar-form input[type="image"], -.navbar-form input[type="checkbox"], -.navbar-form input[type="radio"] { - margin-top: 3px; -} - -.navbar-form .input-append, -.navbar-form .input-prepend { - margin-top: 5px; - white-space: nowrap; -} - -.navbar-form .input-append input, -.navbar-form .input-prepend input { - margin-top: 0; -} - -.navbar-search { - position: relative; - float: left; - margin-top: 5px; - margin-bottom: 0; -} - -.navbar-search .search-query { - padding: 4px 14px; - margin-bottom: 0; - font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; - font-size: 13px; - font-weight: normal; - line-height: 1; - -webkit-border-radius: 15px; - -moz-border-radius: 15px; - border-radius: 15px; -} - -.navbar-static-top { - position: static; - margin-bottom: 0; -} - -.navbar-static-top .navbar-inner { - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.navbar-fixed-top, -.navbar-fixed-bottom { - position: fixed; - right: 0; - left: 0; - z-index: 1030; - margin-bottom: 0; -} - -.navbar-fixed-top .navbar-inner, -.navbar-static-top .navbar-inner { - border-width: 0 0 1px; -} - -.navbar-fixed-bottom .navbar-inner { - border-width: 1px 0 0; -} - -.navbar-fixed-top .navbar-inner, -.navbar-fixed-bottom .navbar-inner { - padding-right: 0; - padding-left: 0; - -webkit-border-radius: 0; - -moz-border-radius: 0; - border-radius: 0; -} - -.navbar-static-top .container, -.navbar-fixed-top .container, -.navbar-fixed-bottom .container { - width: 940px; -} - -.navbar-fixed-top { - top: 0; -} - -.navbar-fixed-top .navbar-inner, -.navbar-static-top .navbar-inner { - -webkit-box-shadow: 0 1px 10px rgba(0, 0, 0, 0.1); - -moz-box-shadow: 0 1px 10px rgba(0, 0, 0, 0.1); - box-shadow: 0 1px 10px rgba(0, 0, 0, 0.1); -} - -.navbar-fixed-bottom { - bottom: 0; -} - -.navbar-fixed-bottom .navbar-inner { - -webkit-box-shadow: 0 -1px 10px rgba(0, 0, 0, 0.1); - -moz-box-shadow: 0 -1px 10px rgba(0, 0, 0, 0.1); - box-shadow: 0 -1px 10px rgba(0, 0, 0, 0.1); -} - -.navbar .nav { - position: relative; - left: 0; - display: block; - float: left; - margin: 0 10px 0 0; -} - -.navbar .nav.pull-right { - float: right; - margin-right: 0; -} - -.navbar .nav > li { - float: left; -} - -.navbar .nav > li > a { - float: none; - padding: 10px 15px 10px; - color: #777777; - text-decoration: none; - text-shadow: 0 1px 0 #ffffff; -} - -.navbar .nav .dropdown-toggle .caret { - margin-top: 8px; -} - -.navbar .nav > li > a:focus, -.navbar .nav > li > a:hover { - color: #333333; - text-decoration: none; - background-color: transparent; -} - -.navbar .nav > .active > a, -.navbar .nav > .active > a:hover, -.navbar .nav > .active > a:focus { - color: #555555; - text-decoration: none; - background-color: #e5e5e5; - -webkit-box-shadow: inset 0 3px 8px rgba(0, 0, 0, 0.125); - -moz-box-shadow: inset 0 3px 8px rgba(0, 0, 0, 0.125); - box-shadow: inset 0 3px 8px rgba(0, 0, 0, 0.125); -} - -.navbar .btn-navbar { - display: none; - float: right; - padding: 7px 10px; - margin-right: 5px; - margin-left: 5px; - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #ededed; - *background-color: #e5e5e5; - background-image: -moz-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#f2f2f2), to(#e5e5e5)); - background-image: -webkit-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -o-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: linear-gradient(to bottom, #f2f2f2, #e5e5e5); - background-repeat: repeat-x; - border-color: #e5e5e5 #e5e5e5 #bfbfbf; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2', endColorstr='#ffe5e5e5', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); - -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.075); - -moz-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.075); - box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.075); -} - -.navbar .btn-navbar:hover, -.navbar .btn-navbar:focus, -.navbar .btn-navbar:active, -.navbar .btn-navbar.active, -.navbar .btn-navbar.disabled, -.navbar .btn-navbar[disabled] { - color: #ffffff; - background-color: #e5e5e5; - *background-color: #d9d9d9; -} - -.navbar .btn-navbar:active, -.navbar .btn-navbar.active { - background-color: #cccccc \9; -} - -.navbar .btn-navbar .icon-bar { - display: block; - width: 18px; - height: 2px; - background-color: #f5f5f5; - -webkit-border-radius: 1px; - -moz-border-radius: 1px; - border-radius: 1px; - -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.25); - -moz-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.25); - box-shadow: 0 1px 0 rgba(0, 0, 0, 0.25); -} - -.btn-navbar .icon-bar + .icon-bar { - margin-top: 3px; -} - -.navbar .nav > li > .dropdown-menu:before { - position: absolute; - top: -7px; - left: 9px; - display: inline-block; - border-right: 7px solid transparent; - border-bottom: 7px solid #ccc; - border-left: 7px solid transparent; - border-bottom-color: rgba(0, 0, 0, 0.2); - content: ''; -} - -.navbar .nav > li > .dropdown-menu:after { - position: absolute; - top: -6px; - left: 10px; - display: inline-block; - border-right: 6px solid transparent; - border-bottom: 6px solid #ffffff; - border-left: 6px solid transparent; - content: ''; -} - -.navbar-fixed-bottom .nav > li > .dropdown-menu:before { - top: auto; - bottom: -7px; - border-top: 7px solid #ccc; - border-bottom: 0; - border-top-color: rgba(0, 0, 0, 0.2); -} - -.navbar-fixed-bottom .nav > li > .dropdown-menu:after { - top: auto; - bottom: -6px; - border-top: 6px solid #ffffff; - border-bottom: 0; -} - -.navbar .nav li.dropdown > a:hover .caret, -.navbar .nav li.dropdown > a:focus .caret { - border-top-color: #333333; - border-bottom-color: #333333; -} - -.navbar .nav li.dropdown.open > .dropdown-toggle, -.navbar .nav li.dropdown.active > .dropdown-toggle, -.navbar .nav li.dropdown.open.active > .dropdown-toggle { - color: #555555; - background-color: #e5e5e5; -} - -.navbar .nav li.dropdown > .dropdown-toggle .caret { - border-top-color: #777777; - border-bottom-color: #777777; -} - -.navbar .nav li.dropdown.open > .dropdown-toggle .caret, -.navbar .nav li.dropdown.active > .dropdown-toggle .caret, -.navbar .nav li.dropdown.open.active > .dropdown-toggle .caret { - border-top-color: #555555; - border-bottom-color: #555555; -} - -.navbar .pull-right > li > .dropdown-menu, -.navbar .nav > li > .dropdown-menu.pull-right { - right: 0; - left: auto; -} - -.navbar .pull-right > li > .dropdown-menu:before, -.navbar .nav > li > .dropdown-menu.pull-right:before { - right: 12px; - left: auto; -} - -.navbar .pull-right > li > .dropdown-menu:after, -.navbar .nav > li > .dropdown-menu.pull-right:after { - right: 13px; - left: auto; -} - -.navbar .pull-right > li > .dropdown-menu .dropdown-menu, -.navbar .nav > li > .dropdown-menu.pull-right .dropdown-menu { - right: 100%; - left: auto; - margin-right: -1px; - margin-left: 0; - -webkit-border-radius: 6px 0 6px 6px; - -moz-border-radius: 6px 0 6px 6px; - border-radius: 6px 0 6px 6px; -} - -.navbar-inverse .navbar-inner { - background-color: #1b1b1b; - background-image: -moz-linear-gradient(top, #222222, #111111); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#222222), to(#111111)); - background-image: -webkit-linear-gradient(top, #222222, #111111); - background-image: -o-linear-gradient(top, #222222, #111111); - background-image: linear-gradient(to bottom, #222222, #111111); - background-repeat: repeat-x; - border-color: #252525; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff222222', endColorstr='#ff111111', GradientType=0); -} - -.navbar-inverse .brand, -.navbar-inverse .nav > li > a { - color: #999999; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); -} - -.navbar-inverse .brand:hover, -.navbar-inverse .nav > li > a:hover, -.navbar-inverse .brand:focus, -.navbar-inverse .nav > li > a:focus { - color: #ffffff; -} - -.navbar-inverse .brand { - color: #999999; -} - -.navbar-inverse .navbar-text { - color: #999999; -} - -.navbar-inverse .nav > li > a:focus, -.navbar-inverse .nav > li > a:hover { - color: #ffffff; - background-color: transparent; -} - -.navbar-inverse .nav .active > a, -.navbar-inverse .nav .active > a:hover, -.navbar-inverse .nav .active > a:focus { - color: #ffffff; - background-color: #111111; -} - -.navbar-inverse .navbar-link { - color: #999999; -} - -.navbar-inverse .navbar-link:hover, -.navbar-inverse .navbar-link:focus { - color: #ffffff; -} - -.navbar-inverse .divider-vertical { - border-right-color: #222222; - border-left-color: #111111; -} - -.navbar-inverse .nav li.dropdown.open > .dropdown-toggle, -.navbar-inverse .nav li.dropdown.active > .dropdown-toggle, -.navbar-inverse .nav li.dropdown.open.active > .dropdown-toggle { - color: #ffffff; - background-color: #111111; -} - -.navbar-inverse .nav li.dropdown > a:hover .caret, -.navbar-inverse .nav li.dropdown > a:focus .caret { - border-top-color: #ffffff; - border-bottom-color: #ffffff; -} - -.navbar-inverse .nav li.dropdown > .dropdown-toggle .caret { - border-top-color: #999999; - border-bottom-color: #999999; -} - -.navbar-inverse .nav li.dropdown.open > .dropdown-toggle .caret, -.navbar-inverse .nav li.dropdown.active > .dropdown-toggle .caret, -.navbar-inverse .nav li.dropdown.open.active > .dropdown-toggle .caret { - border-top-color: #ffffff; - border-bottom-color: #ffffff; -} - -.navbar-inverse .navbar-search .search-query { - color: #ffffff; - background-color: #515151; - border-color: #111111; - -webkit-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1), 0 1px 0 rgba(255, 255, 255, 0.15); - -moz-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1), 0 1px 0 rgba(255, 255, 255, 0.15); - box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1), 0 1px 0 rgba(255, 255, 255, 0.15); - -webkit-transition: none; - -moz-transition: none; - -o-transition: none; - transition: none; -} - -.navbar-inverse .navbar-search .search-query:-moz-placeholder { - color: #cccccc; -} - -.navbar-inverse .navbar-search .search-query:-ms-input-placeholder { - color: #cccccc; -} - -.navbar-inverse .navbar-search .search-query::-webkit-input-placeholder { - color: #cccccc; -} - -.navbar-inverse .navbar-search .search-query:focus, -.navbar-inverse .navbar-search .search-query.focused { - padding: 5px 15px; - color: #333333; - text-shadow: 0 1px 0 #ffffff; - background-color: #ffffff; - border: 0; - outline: 0; - -webkit-box-shadow: 0 0 3px rgba(0, 0, 0, 0.15); - -moz-box-shadow: 0 0 3px rgba(0, 0, 0, 0.15); - box-shadow: 0 0 3px rgba(0, 0, 0, 0.15); -} - -.navbar-inverse .btn-navbar { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #0e0e0e; - *background-color: #040404; - background-image: -moz-linear-gradient(top, #151515, #040404); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#151515), to(#040404)); - background-image: -webkit-linear-gradient(top, #151515, #040404); - background-image: -o-linear-gradient(top, #151515, #040404); - background-image: linear-gradient(to bottom, #151515, #040404); - background-repeat: repeat-x; - border-color: #040404 #040404 #000000; - border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff151515', endColorstr='#ff040404', GradientType=0); - filter: progid:DXImageTransform.Microsoft.gradient(enabled=false); -} - -.navbar-inverse .btn-navbar:hover, -.navbar-inverse .btn-navbar:focus, -.navbar-inverse .btn-navbar:active, -.navbar-inverse .btn-navbar.active, -.navbar-inverse .btn-navbar.disabled, -.navbar-inverse .btn-navbar[disabled] { - color: #ffffff; - background-color: #040404; - *background-color: #000000; -} - -.navbar-inverse .btn-navbar:active, -.navbar-inverse .btn-navbar.active { - background-color: #000000 \9; -} - -.breadcrumb { - padding: 8px 15px; - margin: 0 0 20px; - list-style: none; - background-color: #f5f5f5; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -.breadcrumb > li { - display: inline-block; - *display: inline; - text-shadow: 0 1px 0 #ffffff; - *zoom: 1; -} - -.breadcrumb > li > .divider { - padding: 0 5px; - color: #ccc; -} - -.breadcrumb > .active { - color: #999999; -} - -.pagination { - margin: 20px 0; -} - -.pagination ul { - display: inline-block; - *display: inline; - margin-bottom: 0; - margin-left: 0; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - *zoom: 1; - -webkit-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05); - -moz-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05); - box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05); -} - -.pagination ul > li { - display: inline; -} - -.pagination ul > li > a, -.pagination ul > li > span { - float: left; - padding: 4px 12px; - line-height: 20px; - text-decoration: none; - background-color: #ffffff; - border: 1px solid #dddddd; - border-left-width: 0; -} - -.pagination ul > li > a:hover, -.pagination ul > li > a:focus, -.pagination ul > .active > a, -.pagination ul > .active > span { - background-color: #f5f5f5; -} - -.pagination ul > .active > a, -.pagination ul > .active > span { - color: #999999; - cursor: default; -} - -.pagination ul > .disabled > span, -.pagination ul > .disabled > a, -.pagination ul > .disabled > a:hover, -.pagination ul > .disabled > a:focus { - color: #999999; - cursor: default; - background-color: transparent; -} - -.pagination ul > li:first-child > a, -.pagination ul > li:first-child > span { - border-left-width: 1px; - -webkit-border-bottom-left-radius: 4px; - border-bottom-left-radius: 4px; - -webkit-border-top-left-radius: 4px; - border-top-left-radius: 4px; - -moz-border-radius-bottomleft: 4px; - -moz-border-radius-topleft: 4px; -} - -.pagination ul > li:last-child > a, -.pagination ul > li:last-child > span { - -webkit-border-top-right-radius: 4px; - border-top-right-radius: 4px; - -webkit-border-bottom-right-radius: 4px; - border-bottom-right-radius: 4px; - -moz-border-radius-topright: 4px; - -moz-border-radius-bottomright: 4px; -} - -.pagination-centered { - text-align: center; -} - -.pagination-right { - text-align: right; -} - -.pagination-large ul > li > a, -.pagination-large ul > li > span { - padding: 11px 19px; - font-size: 17.5px; -} - -.pagination-large ul > li:first-child > a, -.pagination-large ul > li:first-child > span { - -webkit-border-bottom-left-radius: 6px; - border-bottom-left-radius: 6px; - -webkit-border-top-left-radius: 6px; - border-top-left-radius: 6px; - -moz-border-radius-bottomleft: 6px; - -moz-border-radius-topleft: 6px; -} - -.pagination-large ul > li:last-child > a, -.pagination-large ul > li:last-child > span { - -webkit-border-top-right-radius: 6px; - border-top-right-radius: 6px; - -webkit-border-bottom-right-radius: 6px; - border-bottom-right-radius: 6px; - -moz-border-radius-topright: 6px; - -moz-border-radius-bottomright: 6px; -} - -.pagination-mini ul > li:first-child > a, -.pagination-small ul > li:first-child > a, -.pagination-mini ul > li:first-child > span, -.pagination-small ul > li:first-child > span { - -webkit-border-bottom-left-radius: 3px; - border-bottom-left-radius: 3px; - -webkit-border-top-left-radius: 3px; - border-top-left-radius: 3px; - -moz-border-radius-bottomleft: 3px; - -moz-border-radius-topleft: 3px; -} - -.pagination-mini ul > li:last-child > a, -.pagination-small ul > li:last-child > a, -.pagination-mini ul > li:last-child > span, -.pagination-small ul > li:last-child > span { - -webkit-border-top-right-radius: 3px; - border-top-right-radius: 3px; - -webkit-border-bottom-right-radius: 3px; - border-bottom-right-radius: 3px; - -moz-border-radius-topright: 3px; - -moz-border-radius-bottomright: 3px; -} - -.pagination-small ul > li > a, -.pagination-small ul > li > span { - padding: 2px 10px; - font-size: 11.9px; -} - -.pagination-mini ul > li > a, -.pagination-mini ul > li > span { - padding: 0 6px; - font-size: 10.5px; -} - -.pager { - margin: 20px 0; - text-align: center; - list-style: none; - *zoom: 1; -} - -.pager:before, -.pager:after { - display: table; - line-height: 0; - 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; - -webkit-border-radius: 15px; - -moz-border-radius: 15px; - border-radius: 15px; -} - -.pager li > a:hover, -.pager li > a:focus { - text-decoration: none; - background-color: #f5f5f5; -} - -.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: default; - background-color: #fff; -} - -.modal-backdrop { - position: fixed; - top: 0; - right: 0; - bottom: 0; - left: 0; - z-index: 1040; - background-color: #000000; -} - -.modal-backdrop.fade { - opacity: 0; -} - -.modal-backdrop, -.modal-backdrop.fade.in { - opacity: 0.8; - filter: alpha(opacity=80); -} - -.modal { - position: fixed; - top: 10%; - left: 50%; - z-index: 1050; - width: 560px; - margin-left: -280px; - background-color: #ffffff; - border: 1px solid #999; - border: 1px solid rgba(0, 0, 0, 0.3); - *border: 1px solid #999; - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; - outline: none; - -webkit-box-shadow: 0 3px 7px rgba(0, 0, 0, 0.3); - -moz-box-shadow: 0 3px 7px rgba(0, 0, 0, 0.3); - box-shadow: 0 3px 7px rgba(0, 0, 0, 0.3); - -webkit-background-clip: padding-box; - -moz-background-clip: padding-box; - background-clip: padding-box; -} - -.modal.fade { - top: -25%; - -webkit-transition: opacity 0.3s linear, top 0.3s ease-out; - -moz-transition: opacity 0.3s linear, top 0.3s ease-out; - -o-transition: opacity 0.3s linear, top 0.3s ease-out; - transition: opacity 0.3s linear, top 0.3s ease-out; -} - -.modal.fade.in { - top: 10%; -} - -.modal-header { - padding: 9px 15px; - border-bottom: 1px solid #eee; -} - -.modal-header .close { - margin-top: 2px; -} - -.modal-header h3 { - margin: 0; - line-height: 30px; -} - -.modal-body { - position: relative; - max-height: 400px; - padding: 15px; - overflow-y: auto; -} - -.modal-form { - margin-bottom: 0; -} - -.modal-footer { - padding: 14px 15px 15px; - margin-bottom: 0; - text-align: right; - background-color: #f5f5f5; - border-top: 1px solid #ddd; - -webkit-border-radius: 0 0 6px 6px; - -moz-border-radius: 0 0 6px 6px; - border-radius: 0 0 6px 6px; - *zoom: 1; - -webkit-box-shadow: inset 0 1px 0 #ffffff; - -moz-box-shadow: inset 0 1px 0 #ffffff; - box-shadow: inset 0 1px 0 #ffffff; -} - -.modal-footer:before, -.modal-footer:after { - display: table; - line-height: 0; - 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; -} - -.tooltip { - position: absolute; - z-index: 1030; - display: block; - font-size: 11px; - line-height: 1.4; - opacity: 0; - filter: alpha(opacity=0); - visibility: visible; -} - -.tooltip.in { - opacity: 0.8; - filter: alpha(opacity=80); -} - -.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: 8px; - color: #ffffff; - text-align: center; - text-decoration: none; - background-color: #000000; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - 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.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; -} - -.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 #ccc; - border: 1px solid rgba(0, 0, 0, 0.2); - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; - -webkit-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - -moz-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); - -webkit-background-clip: padding-box; - -moz-background-clip: padding; - 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; - -webkit-border-radius: 5px 5px 0 0; - -moz-border-radius: 5px 5px 0 0; - border-radius: 5px 5px 0 0; -} - -.popover-title:empty { - display: none; -} - -.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: #ffffff; - border-bottom-width: 0; -} - -.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: #ffffff; - border-left-width: 0; -} - -.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: #ffffff; - border-top-width: 0; -} - -.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: #ffffff; - border-right-width: 0; -} - -.thumbnails { - margin-left: -20px; - list-style: none; - *zoom: 1; -} - -.thumbnails:before, -.thumbnails:after { - display: table; - line-height: 0; - content: ""; -} - -.thumbnails:after { - clear: both; -} - -.row-fluid .thumbnails { - margin-left: 0; -} - -.thumbnails > li { - float: left; - margin-bottom: 20px; - margin-left: 20px; -} - -.thumbnail { - display: block; - padding: 4px; - line-height: 20px; - border: 1px solid #ddd; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.055); - -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.055); - box-shadow: 0 1px 3px rgba(0, 0, 0, 0.055); - -webkit-transition: all 0.2s ease-in-out; - -moz-transition: all 0.2s ease-in-out; - -o-transition: all 0.2s ease-in-out; - transition: all 0.2s ease-in-out; -} - -a.thumbnail:hover, -a.thumbnail:focus { - border-color: #0088cc; - -webkit-box-shadow: 0 1px 4px rgba(0, 105, 214, 0.25); - -moz-box-shadow: 0 1px 4px rgba(0, 105, 214, 0.25); - box-shadow: 0 1px 4px rgba(0, 105, 214, 0.25); -} - -.thumbnail > img { - display: block; - max-width: 100%; - margin-right: auto; - margin-left: auto; -} - -.thumbnail .caption { - padding: 9px; - color: #555555; -} - -.media, -.media-body { - overflow: hidden; - *overflow: visible; - 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 { - margin-left: 0; - list-style: none; -} - -.label, -.badge { - display: inline-block; - padding: 2px 4px; - font-size: 11.844px; - font-weight: bold; - line-height: 14px; - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - white-space: nowrap; - vertical-align: baseline; - background-color: #999999; -} - -.label { - -webkit-border-radius: 3px; - -moz-border-radius: 3px; - border-radius: 3px; -} - -.badge { - padding-right: 9px; - padding-left: 9px; - -webkit-border-radius: 9px; - -moz-border-radius: 9px; - border-radius: 9px; -} - -.label:empty, -.badge:empty { - display: none; -} - -a.label:hover, -a.label:focus, -a.badge:hover, -a.badge:focus { - color: #ffffff; - text-decoration: none; - cursor: pointer; -} - -.label-important, -.badge-important { - background-color: #b94a48; -} - -.label-important[href], -.badge-important[href] { - background-color: #953b39; -} - -.label-warning, -.badge-warning { - background-color: #f89406; -} - -.label-warning[href], -.badge-warning[href] { - background-color: #c67605; -} - -.label-success, -.badge-success { - background-color: #468847; -} - -.label-success[href], -.badge-success[href] { - background-color: #356635; -} - -.label-info, -.badge-info { - background-color: #3a87ad; -} - -.label-info[href], -.badge-info[href] { - background-color: #2d6987; -} - -.label-inverse, -.badge-inverse { - background-color: #333333; -} - -.label-inverse[href], -.badge-inverse[href] { - background-color: #1a1a1a; -} - -.btn .label, -.btn .badge { - position: relative; - top: -1px; -} - -.btn-mini .label, -.btn-mini .badge { - top: 0; -} - -@-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; - } -} - -@-ms-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: #f7f7f7; - background-image: -moz-linear-gradient(top, #f5f5f5, #f9f9f9); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#f5f5f5), to(#f9f9f9)); - background-image: -webkit-linear-gradient(top, #f5f5f5, #f9f9f9); - background-image: -o-linear-gradient(top, #f5f5f5, #f9f9f9); - background-image: linear-gradient(to bottom, #f5f5f5, #f9f9f9); - background-repeat: repeat-x; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff5f5f5', endColorstr='#fff9f9f9', GradientType=0); - -webkit-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1); - -moz-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; - color: #ffffff; - text-align: center; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); - background-color: #0e90d2; - background-image: -moz-linear-gradient(top, #149bdf, #0480be); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#149bdf), to(#0480be)); - background-image: -webkit-linear-gradient(top, #149bdf, #0480be); - background-image: -o-linear-gradient(top, #149bdf, #0480be); - background-image: linear-gradient(to bottom, #149bdf, #0480be); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff149bdf', endColorstr='#ff0480be', GradientType=0); - -webkit-box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.15); - -moz-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-box-sizing: border-box; - -moz-box-sizing: border-box; - box-sizing: border-box; - -webkit-transition: width 0.6s ease; - -moz-transition: width 0.6s ease; - -o-transition: width 0.6s ease; - transition: width 0.6s ease; -} - -.progress .bar + .bar { - -webkit-box-shadow: inset 1px 0 0 rgba(0, 0, 0, 0.15), inset 0 -1px 0 rgba(0, 0, 0, 0.15); - -moz-box-shadow: inset 1px 0 0 rgba(0, 0, 0, 0.15), inset 0 -1px 0 rgba(0, 0, 0, 0.15); - box-shadow: inset 1px 0 0 rgba(0, 0, 0, 0.15), inset 0 -1px 0 rgba(0, 0, 0, 0.15); -} - -.progress-striped .bar { - background-color: #149bdf; - 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: -o-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); - -webkit-background-size: 40px 40px; - -moz-background-size: 40px 40px; - -o-background-size: 40px 40px; - background-size: 40px 40px; -} - -.progress.active .bar { - -webkit-animation: progress-bar-stripes 2s linear infinite; - -moz-animation: progress-bar-stripes 2s linear infinite; - -ms-animation: progress-bar-stripes 2s linear infinite; - -o-animation: progress-bar-stripes 2s linear infinite; - animation: progress-bar-stripes 2s linear infinite; -} - -.progress-danger .bar, -.progress .bar-danger { - background-color: #dd514c; - background-image: -moz-linear-gradient(top, #ee5f5b, #c43c35); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#c43c35)); - background-image: -webkit-linear-gradient(top, #ee5f5b, #c43c35); - background-image: -o-linear-gradient(top, #ee5f5b, #c43c35); - background-image: linear-gradient(to bottom, #ee5f5b, #c43c35); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffee5f5b', endColorstr='#ffc43c35', GradientType=0); -} - -.progress-danger.progress-striped .bar, -.progress-striped .bar-danger { - background-color: #ee5f5b; - 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: -o-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-success .bar, -.progress .bar-success { - background-color: #5eb95e; - background-image: -moz-linear-gradient(top, #62c462, #57a957); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#57a957)); - background-image: -webkit-linear-gradient(top, #62c462, #57a957); - background-image: -o-linear-gradient(top, #62c462, #57a957); - background-image: linear-gradient(to bottom, #62c462, #57a957); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff62c462', endColorstr='#ff57a957', GradientType=0); -} - -.progress-success.progress-striped .bar, -.progress-striped .bar-success { - background-color: #62c462; - 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: -o-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-info .bar, -.progress .bar-info { - background-color: #4bb1cf; - background-image: -moz-linear-gradient(top, #5bc0de, #339bb9); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#339bb9)); - background-image: -webkit-linear-gradient(top, #5bc0de, #339bb9); - background-image: -o-linear-gradient(top, #5bc0de, #339bb9); - background-image: linear-gradient(to bottom, #5bc0de, #339bb9); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff5bc0de', endColorstr='#ff339bb9', GradientType=0); -} - -.progress-info.progress-striped .bar, -.progress-striped .bar-info { - background-color: #5bc0de; - 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: -o-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-warning .bar, -.progress .bar-warning { - background-color: #faa732; - background-image: -moz-linear-gradient(top, #fbb450, #f89406); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#fbb450), to(#f89406)); - background-image: -webkit-linear-gradient(top, #fbb450, #f89406); - background-image: -o-linear-gradient(top, #fbb450, #f89406); - background-image: linear-gradient(to bottom, #fbb450, #f89406); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffbb450', endColorstr='#fff89406', GradientType=0); -} - -.progress-warning.progress-striped .bar, -.progress-striped .bar-warning { - background-color: #fbb450; - 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: -o-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); -} - -.accordion { - margin-bottom: 20px; -} - -.accordion-group { - margin-bottom: 2px; - border: 1px solid #e5e5e5; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; -} - -.accordion-heading { - border-bottom: 0; -} - -.accordion-heading .accordion-toggle { - display: block; - padding: 8px 15px; -} - -.accordion-toggle { - cursor: pointer; -} - -.accordion-inner { - padding: 9px 15px; - border-top: 1px solid #e5e5e5; -} - -.carousel { - position: relative; - margin-bottom: 20px; - line-height: 1; -} - -.carousel-inner { - position: relative; - width: 100%; - overflow: hidden; -} - -.carousel-inner > .item { - position: relative; - display: none; - -webkit-transition: 0.6s ease-in-out left; - -moz-transition: 0.6s ease-in-out left; - -o-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; - 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: 40%; - left: 15px; - width: 40px; - height: 40px; - margin-top: -20px; - font-size: 60px; - font-weight: 100; - line-height: 30px; - color: #ffffff; - text-align: center; - background: #222222; - border: 3px solid #ffffff; - -webkit-border-radius: 23px; - -moz-border-radius: 23px; - border-radius: 23px; - opacity: 0.5; - filter: alpha(opacity=50); -} - -.carousel-control.right { - right: 15px; - left: auto; -} - -.carousel-control:hover, -.carousel-control:focus { - color: #ffffff; - text-decoration: none; - opacity: 0.9; - filter: alpha(opacity=90); -} - -.carousel-indicators { - position: absolute; - top: 15px; - right: 15px; - z-index: 5; - margin: 0; - list-style: none; -} - -.carousel-indicators li { - display: block; - float: left; - width: 10px; - height: 10px; - margin-left: 5px; - text-indent: -999px; - background-color: #ccc; - background-color: rgba(255, 255, 255, 0.25); - border-radius: 5px; -} - -.carousel-indicators .active { - background-color: #fff; -} - -.carousel-caption { - position: absolute; - right: 0; - bottom: 0; - left: 0; - padding: 15px; - background: #333333; - background: rgba(0, 0, 0, 0.75); -} - -.carousel-caption h4, -.carousel-caption p { - line-height: 20px; - color: #ffffff; -} - -.carousel-caption h4 { - margin: 0 0 5px; -} - -.carousel-caption p { - margin-bottom: 0; -} - -.hero-unit { - padding: 60px; - margin-bottom: 30px; - font-size: 18px; - font-weight: 200; - line-height: 30px; - color: inherit; - background-color: #eeeeee; - -webkit-border-radius: 6px; - -moz-border-radius: 6px; - border-radius: 6px; -} - -.hero-unit h1 { - margin-bottom: 0; - font-size: 60px; - line-height: 1; - letter-spacing: -1px; - color: inherit; -} - -.hero-unit li { - line-height: 30px; -} - -.pull-right { - float: right; -} - -.pull-left { - float: left; -} - -.hide { - display: none; -} - -.show { - display: block; -} - -.invisible { - visibility: hidden; -} - -.affix { - position: fixed; -} diff --git a/docs/theme/docker/static/css/bootstrap.min.css b/docs/theme/docker/static/css/bootstrap.min.css deleted file mode 100755 index fd5ed73407..0000000000 --- a/docs/theme/docker/static/css/bootstrap.min.css +++ /dev/null @@ -1,9 +0,0 @@ -/*! - * Bootstrap v2.3.0 - * - * Copyright 2012 Twitter, Inc - * Licensed under the Apache License v2.0 - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Designed and built with all the love in the world @twitter by @mdo and @fat. - */.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;line-height:0;content:""}.clearfix:after{clear:both}.hide-text{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.input-block-level{display:block;width:100%;min-height:30px;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}a:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}a:hover,a:active{outline:0}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{width:auto\9;height:auto;max-width:100%;vertical-align:middle;border:0;-ms-interpolation-mode:bicubic}#map_canvas img,.google-maps img{max-width:none}button,input,select,textarea{margin:0;font-size:100%;vertical-align:middle}button,input{*overflow:visible;line-height:normal}button::-moz-focus-inner,input::-moz-focus-inner{padding:0;border:0}button,html input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button}label,select,button,input[type="button"],input[type="reset"],input[type="submit"],input[type="radio"],input[type="checkbox"]{cursor:pointer}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-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}textarea{overflow:auto;vertical-align:top}@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) ")"}.ir a:after,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:.5cm}p,h2,h3{orphans:3;widows:3}h2,h3{page-break-after:avoid}}body{margin:0;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:14px;line-height:20px;color:#333;background-color:#fff}a{color:#08c;text-decoration:none}a:hover,a:focus{color:#005580;text-decoration:underline}.img-rounded{-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.img-polaroid{padding:4px;background-color:#fff;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.2);-webkit-box-shadow:0 1px 3px rgba(0,0,0,0.1);-moz-box-shadow:0 1px 3px rgba(0,0,0,0.1);box-shadow:0 1px 3px rgba(0,0,0,0.1)}.img-circle{-webkit-border-radius:500px;-moz-border-radius:500px;border-radius:500px}.row{margin-left:-20px;*zoom:1}.row:before,.row:after{display:table;line-height:0;content:""}.row:after{clear:both}[class*="span"]{float:left;min-height:1px;margin-left:20px}.container,.navbar-static-top .container,.navbar-fixed-top .container,.navbar-fixed-bottom .container{width:940px}.span12{width:940px}.span11{width:860px}.span10{width:780px}.span9{width:700px}.span8{width:620px}.span7{width:540px}.span6{width:460px}.span5{width:380px}.span4{width:300px}.span3{width:220px}.span2{width:140px}.span1{width:60px}.offset12{margin-left:980px}.offset11{margin-left:900px}.offset10{margin-left:820px}.offset9{margin-left:740px}.offset8{margin-left:660px}.offset7{margin-left:580px}.offset6{margin-left:500px}.offset5{margin-left:420px}.offset4{margin-left:340px}.offset3{margin-left:260px}.offset2{margin-left:180px}.offset1{margin-left:100px}.row-fluid{width:100%;*zoom:1}.row-fluid:before,.row-fluid:after{display:table;line-height:0;content:""}.row-fluid:after{clear:both}.row-fluid [class*="span"]{display:block;float:left;width:100%;min-height:30px;margin-left:2.127659574468085%;*margin-left:2.074468085106383%;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.row-fluid [class*="span"]:first-child{margin-left:0}.row-fluid .controls-row [class*="span"]+[class*="span"]{margin-left:2.127659574468085%}.row-fluid .span12{width:100%;*width:99.94680851063829%}.row-fluid .span11{width:91.48936170212765%;*width:91.43617021276594%}.row-fluid .span10{width:82.97872340425532%;*width:82.92553191489361%}.row-fluid .span9{width:74.46808510638297%;*width:74.41489361702126%}.row-fluid .span8{width:65.95744680851064%;*width:65.90425531914893%}.row-fluid .span7{width:57.44680851063829%;*width:57.39361702127659%}.row-fluid .span6{width:48.93617021276595%;*width:48.88297872340425%}.row-fluid .span5{width:40.42553191489362%;*width:40.37234042553192%}.row-fluid .span4{width:31.914893617021278%;*width:31.861702127659576%}.row-fluid .span3{width:23.404255319148934%;*width:23.351063829787233%}.row-fluid .span2{width:14.893617021276595%;*width:14.840425531914894%}.row-fluid .span1{width:6.382978723404255%;*width:6.329787234042553%}.row-fluid .offset12{margin-left:104.25531914893617%;*margin-left:104.14893617021275%}.row-fluid .offset12:first-child{margin-left:102.12765957446808%;*margin-left:102.02127659574467%}.row-fluid .offset11{margin-left:95.74468085106382%;*margin-left:95.6382978723404%}.row-fluid .offset11:first-child{margin-left:93.61702127659574%;*margin-left:93.51063829787232%}.row-fluid .offset10{margin-left:87.23404255319149%;*margin-left:87.12765957446807%}.row-fluid .offset10:first-child{margin-left:85.1063829787234%;*margin-left:84.99999999999999%}.row-fluid .offset9{margin-left:78.72340425531914%;*margin-left:78.61702127659572%}.row-fluid .offset9:first-child{margin-left:76.59574468085106%;*margin-left:76.48936170212764%}.row-fluid .offset8{margin-left:70.2127659574468%;*margin-left:70.10638297872339%}.row-fluid .offset8:first-child{margin-left:68.08510638297872%;*margin-left:67.9787234042553%}.row-fluid .offset7{margin-left:61.70212765957446%;*margin-left:61.59574468085106%}.row-fluid .offset7:first-child{margin-left:59.574468085106375%;*margin-left:59.46808510638297%}.row-fluid .offset6{margin-left:53.191489361702125%;*margin-left:53.085106382978715%}.row-fluid .offset6:first-child{margin-left:51.063829787234035%;*margin-left:50.95744680851063%}.row-fluid .offset5{margin-left:44.68085106382979%;*margin-left:44.57446808510638%}.row-fluid .offset5:first-child{margin-left:42.5531914893617%;*margin-left:42.4468085106383%}.row-fluid .offset4{margin-left:36.170212765957444%;*margin-left:36.06382978723405%}.row-fluid .offset4:first-child{margin-left:34.04255319148936%;*margin-left:33.93617021276596%}.row-fluid .offset3{margin-left:27.659574468085104%;*margin-left:27.5531914893617%}.row-fluid .offset3:first-child{margin-left:25.53191489361702%;*margin-left:25.425531914893618%}.row-fluid .offset2{margin-left:19.148936170212764%;*margin-left:19.04255319148936%}.row-fluid .offset2:first-child{margin-left:17.02127659574468%;*margin-left:16.914893617021278%}.row-fluid .offset1{margin-left:10.638297872340425%;*margin-left:10.53191489361702%}.row-fluid .offset1:first-child{margin-left:8.51063829787234%;*margin-left:8.404255319148938%}[class*="span"].hide,.row-fluid [class*="span"].hide{display:none}[class*="span"].pull-right,.row-fluid [class*="span"].pull-right{float:right}.container{margin-right:auto;margin-left:auto;*zoom:1}.container:before,.container:after{display:table;line-height:0;content:""}.container:after{clear:both}.container-fluid{padding-right:20px;padding-left:20px;*zoom:1}.container-fluid:before,.container-fluid:after{display:table;line-height:0;content:""}.container-fluid:after{clear:both}p{margin:0 0 10px}.lead{margin-bottom:20px;font-size:21px;font-weight:200;line-height:30px}small{font-size:85%}strong{font-weight:bold}em{font-style:italic}cite{font-style:normal}.muted{color:#999}a.muted:hover,a.muted:focus{color:#808080}.text-warning{color:#c09853}a.text-warning:hover,a.text-warning:focus{color:#a47e3c}.text-error{color:#b94a48}a.text-error:hover,a.text-error:focus{color:#953b39}.text-info{color:#3a87ad}a.text-info:hover,a.text-info:focus{color:#2d6987}.text-success{color:#468847}a.text-success:hover,a.text-success:focus{color:#356635}.text-left{text-align:left}.text-right{text-align:right}.text-center{text-align:center}h1,h2,h3,h4,h5,h6{margin:10px 0;font-family:inherit;font-weight:bold;line-height:20px;color:inherit;text-rendering:optimizelegibility}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-weight:normal;line-height:1;color:#999}h1,h2,h3{line-height:40px}h1{font-size:38.5px}h2{font-size:31.5px}h3{font-size:24.5px}h4{font-size:17.5px}h5{font-size:14px}h6{font-size:11.9px}h1 small{font-size:24.5px}h2 small{font-size:17.5px}h3 small{font-size:14px}h4 small{font-size:14px}.page-header{padding-bottom:9px;margin:20px 0 30px;border-bottom:1px solid #eee}ul,ol{padding:0;margin:0 0 10px 25px}ul ul,ul ol,ol ol,ol ul{margin-bottom:0}li{line-height:20px}ul.unstyled,ol.unstyled{margin-left:0;list-style:none}ul.inline,ol.inline{margin-left:0;list-style:none}ul.inline>li,ol.inline>li{display:inline-block;*display:inline;padding-right:5px;padding-left:5px;*zoom:1}dl{margin-bottom:20px}dt,dd{line-height:20px}dt{font-weight:bold}dd{margin-left:10px}.dl-horizontal{*zoom:1}.dl-horizontal:before,.dl-horizontal:after{display:table;line-height:0;content:""}.dl-horizontal:after{clear:both}.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}hr{margin:20px 0;border:0;border-top:1px solid #eee;border-bottom:1px solid #fff}abbr[title],abbr[data-original-title]{cursor:help;border-bottom:1px dotted #999}abbr.initialism{font-size:90%;text-transform:uppercase}blockquote{padding:0 0 0 15px;margin:0 0 20px;border-left:5px solid #eee}blockquote p{margin-bottom:0;font-size:17.5px;font-weight:300;line-height:1.25}blockquote small{display:block;line-height:20px;color:#999}blockquote small:before{content:'\2014 \00A0'}blockquote.pull-right{float:right;padding-right:15px;padding-left:0;border-right:5px solid #eee;border-left:0}blockquote.pull-right p,blockquote.pull-right small{text-align:right}blockquote.pull-right small:before{content:''}blockquote.pull-right small:after{content:'\00A0 \2014'}q:before,q:after,blockquote:before,blockquote:after{content:""}address{display:block;margin-bottom:20px;font-style:normal;line-height:20px}code,pre{padding:0 3px 2px;font-family:Monaco,Menlo,Consolas,"Courier New",monospace;font-size:12px;color:#333;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}code{padding:2px 4px;color:#d14;white-space:nowrap;background-color:#f7f7f9;border:1px solid #e1e1e8}pre{display:block;padding:9.5px;margin:0 0 10px;font-size:13px;line-height:20px;word-break:break-all;word-wrap:break-word;white-space:pre;white-space:pre-wrap;background-color:#f5f5f5;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.15);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}pre.prettyprint{margin-bottom:20px}pre code{padding:0;color:inherit;white-space:pre;white-space:pre-wrap;background-color:transparent;border:0}.pre-scrollable{max-height:340px;overflow-y:scroll}form{margin:0 0 20px}fieldset{padding:0;margin:0;border:0}legend{display:block;width:100%;padding:0;margin-bottom:20px;font-size:21px;line-height:40px;color:#333;border:0;border-bottom:1px solid #e5e5e5}legend small{font-size:15px;color:#999}label,input,button,select,textarea{font-size:14px;font-weight:normal;line-height:20px}input,button,select,textarea{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif}label{display:block;margin-bottom:5px}select,textarea,input[type="text"],input[type="password"],input[type="datetime"],input[type="datetime-local"],input[type="date"],input[type="month"],input[type="time"],input[type="week"],input[type="number"],input[type="email"],input[type="url"],input[type="search"],input[type="tel"],input[type="color"],.uneditable-input{display:inline-block;height:20px;padding:4px 6px;margin-bottom:10px;font-size:14px;line-height:20px;color:#555;vertical-align:middle;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}input,textarea,.uneditable-input{width:206px}textarea{height:auto}textarea,input[type="text"],input[type="password"],input[type="datetime"],input[type="datetime-local"],input[type="date"],input[type="month"],input[type="time"],input[type="week"],input[type="number"],input[type="email"],input[type="url"],input[type="search"],input[type="tel"],input[type="color"],.uneditable-input{background-color:#fff;border:1px solid #ccc;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-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 linear .2s,box-shadow linear .2s;-moz-transition:border linear .2s,box-shadow linear .2s;-o-transition:border linear .2s,box-shadow linear .2s;transition:border linear .2s,box-shadow linear .2s}textarea:focus,input[type="text"]:focus,input[type="password"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus,.uneditable-input:focus{border-color:rgba(82,168,236,0.8);outline:0;outline:thin dotted \9;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6)}input[type="radio"],input[type="checkbox"]{margin:4px 0 0;margin-top:1px \9;*margin-top:0;line-height:normal}input[type="file"],input[type="image"],input[type="submit"],input[type="reset"],input[type="button"],input[type="radio"],input[type="checkbox"]{width:auto}select,input[type="file"]{height:30px;*margin-top:4px;line-height:30px}select{width:220px;background-color:#fff;border:1px solid #ccc}select[multiple],select[size]{height:auto}select:focus,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}.uneditable-input,.uneditable-textarea{color:#999;cursor:not-allowed;background-color:#fcfcfc;border-color:#ccc;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.025);-moz-box-shadow:inset 0 1px 2px rgba(0,0,0,0.025);box-shadow:inset 0 1px 2px rgba(0,0,0,0.025)}.uneditable-input{overflow:hidden;white-space:nowrap}.uneditable-textarea{width:auto;height:auto}input:-moz-placeholder,textarea:-moz-placeholder{color:#999}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:#999}input::-webkit-input-placeholder,textarea::-webkit-input-placeholder{color:#999}.radio,.checkbox{min-height:20px;padding-left:20px}.radio input[type="radio"],.checkbox input[type="checkbox"]{float:left;margin-left:-20px}.controls>.radio:first-child,.controls>.checkbox:first-child{padding-top:5px}.radio.inline,.checkbox.inline{display:inline-block;padding-top:5px;margin-bottom:0;vertical-align:middle}.radio.inline+.radio.inline,.checkbox.inline+.checkbox.inline{margin-left:10px}.input-mini{width:60px}.input-small{width:90px}.input-medium{width:150px}.input-large{width:210px}.input-xlarge{width:270px}.input-xxlarge{width:530px}input[class*="span"],select[class*="span"],textarea[class*="span"],.uneditable-input[class*="span"],.row-fluid input[class*="span"],.row-fluid select[class*="span"],.row-fluid textarea[class*="span"],.row-fluid .uneditable-input[class*="span"]{float:none;margin-left:0}.input-append input[class*="span"],.input-append .uneditable-input[class*="span"],.input-prepend input[class*="span"],.input-prepend .uneditable-input[class*="span"],.row-fluid input[class*="span"],.row-fluid select[class*="span"],.row-fluid textarea[class*="span"],.row-fluid .uneditable-input[class*="span"],.row-fluid .input-prepend [class*="span"],.row-fluid .input-append [class*="span"]{display:inline-block}input,textarea,.uneditable-input{margin-left:0}.controls-row [class*="span"]+[class*="span"]{margin-left:20px}input.span12,textarea.span12,.uneditable-input.span12{width:926px}input.span11,textarea.span11,.uneditable-input.span11{width:846px}input.span10,textarea.span10,.uneditable-input.span10{width:766px}input.span9,textarea.span9,.uneditable-input.span9{width:686px}input.span8,textarea.span8,.uneditable-input.span8{width:606px}input.span7,textarea.span7,.uneditable-input.span7{width:526px}input.span6,textarea.span6,.uneditable-input.span6{width:446px}input.span5,textarea.span5,.uneditable-input.span5{width:366px}input.span4,textarea.span4,.uneditable-input.span4{width:286px}input.span3,textarea.span3,.uneditable-input.span3{width:206px}input.span2,textarea.span2,.uneditable-input.span2{width:126px}input.span1,textarea.span1,.uneditable-input.span1{width:46px}.controls-row{*zoom:1}.controls-row:before,.controls-row:after{display:table;line-height:0;content:""}.controls-row:after{clear:both}.controls-row [class*="span"],.row-fluid .controls-row [class*="span"]{float:left}.controls-row .checkbox[class*="span"],.controls-row .radio[class*="span"]{padding-top:5px}input[disabled],select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#eee}input[type="radio"][disabled],input[type="checkbox"][disabled],input[type="radio"][readonly],input[type="checkbox"][readonly]{background-color:transparent}.control-group.warning .control-label,.control-group.warning .help-block,.control-group.warning .help-inline{color:#c09853}.control-group.warning .checkbox,.control-group.warning .radio,.control-group.warning input,.control-group.warning select,.control-group.warning textarea{color:#c09853}.control-group.warning input,.control-group.warning select,.control-group.warning textarea{border-color:#c09853;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.control-group.warning input:focus,.control-group.warning select:focus,.control-group.warning textarea:focus{border-color:#a47e3c;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #dbc59e;-moz-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}.control-group.warning .input-prepend .add-on,.control-group.warning .input-append .add-on{color:#c09853;background-color:#fcf8e3;border-color:#c09853}.control-group.error .control-label,.control-group.error .help-block,.control-group.error .help-inline{color:#b94a48}.control-group.error .checkbox,.control-group.error .radio,.control-group.error input,.control-group.error select,.control-group.error textarea{color:#b94a48}.control-group.error input,.control-group.error select,.control-group.error textarea{border-color:#b94a48;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.control-group.error input:focus,.control-group.error select:focus,.control-group.error textarea:focus{border-color:#953b39;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #d59392;-moz-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}.control-group.error .input-prepend .add-on,.control-group.error .input-append .add-on{color:#b94a48;background-color:#f2dede;border-color:#b94a48}.control-group.success .control-label,.control-group.success .help-block,.control-group.success .help-inline{color:#468847}.control-group.success .checkbox,.control-group.success .radio,.control-group.success input,.control-group.success select,.control-group.success textarea{color:#468847}.control-group.success input,.control-group.success select,.control-group.success textarea{border-color:#468847;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.control-group.success input:focus,.control-group.success select:focus,.control-group.success textarea:focus{border-color:#356635;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7aba7b;-moz-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}.control-group.success .input-prepend .add-on,.control-group.success .input-append .add-on{color:#468847;background-color:#dff0d8;border-color:#468847}.control-group.info .control-label,.control-group.info .help-block,.control-group.info .help-inline{color:#3a87ad}.control-group.info .checkbox,.control-group.info .radio,.control-group.info input,.control-group.info select,.control-group.info textarea{color:#3a87ad}.control-group.info input,.control-group.info select,.control-group.info textarea{border-color:#3a87ad;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075)}.control-group.info input:focus,.control-group.info select:focus,.control-group.info textarea:focus{border-color:#2d6987;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7ab5d3;-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7ab5d3;box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 6px #7ab5d3}.control-group.info .input-prepend .add-on,.control-group.info .input-append .add-on{color:#3a87ad;background-color:#d9edf7;border-color:#3a87ad}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#b94a48;border-color:#ee5f5b}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#e9322d;-webkit-box-shadow:0 0 6px #f8b9b7;-moz-box-shadow:0 0 6px #f8b9b7;box-shadow:0 0 6px #f8b9b7}.form-actions{padding:19px 20px 20px;margin-top:20px;margin-bottom:20px;background-color:#f5f5f5;border-top:1px solid #e5e5e5;*zoom:1}.form-actions:before,.form-actions:after{display:table;line-height:0;content:""}.form-actions:after{clear:both}.help-block,.help-inline{color:#595959}.help-block{display:block;margin-bottom:10px}.help-inline{display:inline-block;*display:inline;padding-left:5px;vertical-align:middle;*zoom:1}.input-append,.input-prepend{display:inline-block;margin-bottom:10px;font-size:0;white-space:nowrap;vertical-align:middle}.input-append input,.input-prepend input,.input-append select,.input-prepend select,.input-append .uneditable-input,.input-prepend .uneditable-input,.input-append .dropdown-menu,.input-prepend .dropdown-menu,.input-append .popover,.input-prepend .popover{font-size:14px}.input-append input,.input-prepend input,.input-append select,.input-prepend select,.input-append .uneditable-input,.input-prepend .uneditable-input{position:relative;margin-bottom:0;*margin-left:0;vertical-align:top;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.input-append input:focus,.input-prepend input:focus,.input-append select:focus,.input-prepend select:focus,.input-append .uneditable-input:focus,.input-prepend .uneditable-input:focus{z-index:2}.input-append .add-on,.input-prepend .add-on{display:inline-block;width:auto;height:20px;min-width:16px;padding:4px 5px;font-size:14px;font-weight:normal;line-height:20px;text-align:center;text-shadow:0 1px 0 #fff;background-color:#eee;border:1px solid #ccc}.input-append .add-on,.input-prepend .add-on,.input-append .btn,.input-prepend .btn,.input-append .btn-group>.dropdown-toggle,.input-prepend .btn-group>.dropdown-toggle{vertical-align:top;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.input-append .active,.input-prepend .active{background-color:#a9dba9;border-color:#46a546}.input-prepend .add-on,.input-prepend .btn{margin-right:-1px}.input-prepend .add-on:first-child,.input-prepend .btn:first-child{-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.input-append input,.input-append select,.input-append .uneditable-input{-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.input-append input+.btn-group .btn:last-child,.input-append select+.btn-group .btn:last-child,.input-append .uneditable-input+.btn-group .btn:last-child{-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.input-append .add-on,.input-append .btn,.input-append .btn-group{margin-left:-1px}.input-append .add-on:last-child,.input-append .btn:last-child,.input-append .btn-group:last-child>.dropdown-toggle{-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.input-prepend.input-append input,.input-prepend.input-append select,.input-prepend.input-append .uneditable-input{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.input-prepend.input-append input+.btn-group .btn,.input-prepend.input-append select+.btn-group .btn,.input-prepend.input-append .uneditable-input+.btn-group .btn{-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.input-prepend.input-append .add-on:first-child,.input-prepend.input-append .btn:first-child{margin-right:-1px;-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.input-prepend.input-append .add-on:last-child,.input-prepend.input-append .btn:last-child{margin-left:-1px;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.input-prepend.input-append .btn-group:first-child{margin-left:0}input.search-query{padding-right:14px;padding-right:4px \9;padding-left:14px;padding-left:4px \9;margin-bottom:0;-webkit-border-radius:15px;-moz-border-radius:15px;border-radius:15px}.form-search .input-append .search-query,.form-search .input-prepend .search-query{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.form-search .input-append .search-query{-webkit-border-radius:14px 0 0 14px;-moz-border-radius:14px 0 0 14px;border-radius:14px 0 0 14px}.form-search .input-append .btn{-webkit-border-radius:0 14px 14px 0;-moz-border-radius:0 14px 14px 0;border-radius:0 14px 14px 0}.form-search .input-prepend .search-query{-webkit-border-radius:0 14px 14px 0;-moz-border-radius:0 14px 14px 0;border-radius:0 14px 14px 0}.form-search .input-prepend .btn{-webkit-border-radius:14px 0 0 14px;-moz-border-radius:14px 0 0 14px;border-radius:14px 0 0 14px}.form-search input,.form-inline input,.form-horizontal input,.form-search textarea,.form-inline textarea,.form-horizontal textarea,.form-search select,.form-inline select,.form-horizontal select,.form-search .help-inline,.form-inline .help-inline,.form-horizontal .help-inline,.form-search .uneditable-input,.form-inline .uneditable-input,.form-horizontal .uneditable-input,.form-search .input-prepend,.form-inline .input-prepend,.form-horizontal .input-prepend,.form-search .input-append,.form-inline .input-append,.form-horizontal .input-append{display:inline-block;*display:inline;margin-bottom:0;vertical-align:middle;*zoom:1}.form-search .hide,.form-inline .hide,.form-horizontal .hide{display:none}.form-search label,.form-inline label,.form-search .btn-group,.form-inline .btn-group{display:inline-block}.form-search .input-append,.form-inline .input-append,.form-search .input-prepend,.form-inline .input-prepend{margin-bottom:0}.form-search .radio,.form-search .checkbox,.form-inline .radio,.form-inline .checkbox{padding-left:0;margin-bottom:0;vertical-align:middle}.form-search .radio input[type="radio"],.form-search .checkbox input[type="checkbox"],.form-inline .radio input[type="radio"],.form-inline .checkbox input[type="checkbox"]{float:left;margin-right:3px;margin-left:0}.control-group{margin-bottom:10px}legend+.control-group{margin-top:20px;-webkit-margin-top-collapse:separate}.form-horizontal .control-group{margin-bottom:20px;*zoom:1}.form-horizontal .control-group:before,.form-horizontal .control-group:after{display:table;line-height:0;content:""}.form-horizontal .control-group:after{clear:both}.form-horizontal .control-label{float:left;width:160px;padding-top:5px;text-align:right}.form-horizontal .controls{*display:inline-block;*padding-left:20px;margin-left:180px;*margin-left:0}.form-horizontal .controls:first-child{*padding-left:180px}.form-horizontal .help-block{margin-bottom:0}.form-horizontal input+.help-block,.form-horizontal select+.help-block,.form-horizontal textarea+.help-block,.form-horizontal .uneditable-input+.help-block,.form-horizontal .input-prepend+.help-block,.form-horizontal .input-append+.help-block{margin-top:10px}.form-horizontal .form-actions{padding-left:180px}table{max-width:100%;background-color:transparent;border-collapse:collapse;border-spacing:0}.table{width:100%;margin-bottom:20px}.table th,.table td{padding:8px;line-height:20px;text-align:left;vertical-align:top;border-top:1px solid #ddd}.table th{font-weight:bold}.table thead th{vertical-align:bottom}.table caption+thead tr:first-child th,.table caption+thead tr:first-child td,.table colgroup+thead tr:first-child th,.table colgroup+thead tr:first-child td,.table thead:first-child tr:first-child th,.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 th,.table-condensed td{padding:4px 5px}.table-bordered{border:1px solid #ddd;border-collapse:separate;*border-collapse:collapse;border-left:0;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.table-bordered th,.table-bordered td{border-left:1px solid #ddd}.table-bordered caption+thead tr:first-child th,.table-bordered caption+tbody tr:first-child th,.table-bordered caption+tbody tr:first-child td,.table-bordered colgroup+thead tr:first-child th,.table-bordered colgroup+tbody tr:first-child th,.table-bordered colgroup+tbody tr:first-child td,.table-bordered thead:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child td{border-top:0}.table-bordered thead:first-child tr:first-child>th:first-child,.table-bordered tbody:first-child tr:first-child>td:first-child,.table-bordered tbody:first-child tr:first-child>th:first-child{-webkit-border-top-left-radius:4px;border-top-left-radius:4px;-moz-border-radius-topleft:4px}.table-bordered thead:first-child tr:first-child>th:last-child,.table-bordered tbody:first-child tr:first-child>td:last-child,.table-bordered tbody:first-child tr:first-child>th:last-child{-webkit-border-top-right-radius:4px;border-top-right-radius:4px;-moz-border-radius-topright:4px}.table-bordered thead:last-child tr:last-child>th:first-child,.table-bordered tbody:last-child tr:last-child>td:first-child,.table-bordered tbody:last-child tr:last-child>th:first-child,.table-bordered tfoot:last-child tr:last-child>td:first-child,.table-bordered tfoot:last-child tr:last-child>th:first-child{-webkit-border-bottom-left-radius:4px;border-bottom-left-radius:4px;-moz-border-radius-bottomleft:4px}.table-bordered thead:last-child tr:last-child>th:last-child,.table-bordered tbody:last-child tr:last-child>td:last-child,.table-bordered tbody:last-child tr:last-child>th:last-child,.table-bordered tfoot:last-child tr:last-child>td:last-child,.table-bordered tfoot:last-child tr:last-child>th:last-child{-webkit-border-bottom-right-radius:4px;border-bottom-right-radius:4px;-moz-border-radius-bottomright:4px}.table-bordered tfoot+tbody:last-child tr:last-child td:first-child{-webkit-border-bottom-left-radius:0;border-bottom-left-radius:0;-moz-border-radius-bottomleft:0}.table-bordered tfoot+tbody:last-child tr:last-child td:last-child{-webkit-border-bottom-right-radius:0;border-bottom-right-radius:0;-moz-border-radius-bottomright:0}.table-bordered caption+thead tr:first-child th:first-child,.table-bordered caption+tbody tr:first-child td:first-child,.table-bordered colgroup+thead tr:first-child th:first-child,.table-bordered colgroup+tbody tr:first-child td:first-child{-webkit-border-top-left-radius:4px;border-top-left-radius:4px;-moz-border-radius-topleft:4px}.table-bordered caption+thead tr:first-child th:last-child,.table-bordered caption+tbody tr:first-child td:last-child,.table-bordered colgroup+thead tr:first-child th:last-child,.table-bordered colgroup+tbody tr:first-child td:last-child{-webkit-border-top-right-radius:4px;border-top-right-radius:4px;-moz-border-radius-topright:4px}.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 td[class*="span"],table th[class*="span"],.row-fluid table td[class*="span"],.row-fluid table th[class*="span"]{display:table-cell;float:none;margin-left:0}.table td.span1,.table th.span1{float:none;width:44px;margin-left:0}.table td.span2,.table th.span2{float:none;width:124px;margin-left:0}.table td.span3,.table th.span3{float:none;width:204px;margin-left:0}.table td.span4,.table th.span4{float:none;width:284px;margin-left:0}.table td.span5,.table th.span5{float:none;width:364px;margin-left:0}.table td.span6,.table th.span6{float:none;width:444px;margin-left:0}.table td.span7,.table th.span7{float:none;width:524px;margin-left:0}.table td.span8,.table th.span8{float:none;width:604px;margin-left:0}.table td.span9,.table th.span9{float:none;width:684px;margin-left:0}.table td.span10,.table th.span10{float:none;width:764px;margin-left:0}.table td.span11,.table th.span11{float:none;width:844px;margin-left:0}.table td.span12,.table th.span12{float:none;width:924px;margin-left:0}.table tbody tr.success>td{background-color:#dff0d8}.table tbody tr.error>td{background-color:#f2dede}.table tbody tr.warning>td{background-color:#fcf8e3}.table tbody tr.info>td{background-color:#d9edf7}.table-hover tbody tr.success:hover>td{background-color:#d0e9c6}.table-hover tbody tr.error:hover>td{background-color:#ebcccc}.table-hover tbody tr.warning:hover>td{background-color:#faf2cc}.table-hover tbody tr.info:hover>td{background-color:#c4e3f3}[class^="icon-"],[class*=" icon-"]{display:inline-block;width:14px;height:14px;margin-top:1px;*margin-right:.3em;line-height:14px;vertical-align:text-top;background-image:url("../img/glyphicons-halflings.png");background-position:14px 14px;background-repeat:no-repeat}.icon-white,.nav-pills>.active>a>[class^="icon-"],.nav-pills>.active>a>[class*=" icon-"],.nav-list>.active>a>[class^="icon-"],.nav-list>.active>a>[class*=" icon-"],.navbar-inverse .nav>.active>a>[class^="icon-"],.navbar-inverse .nav>.active>a>[class*=" icon-"],.dropdown-menu>li>a:hover>[class^="icon-"],.dropdown-menu>li>a:focus>[class^="icon-"],.dropdown-menu>li>a:hover>[class*=" icon-"],.dropdown-menu>li>a:focus>[class*=" icon-"],.dropdown-menu>.active>a>[class^="icon-"],.dropdown-menu>.active>a>[class*=" icon-"],.dropdown-submenu:hover>a>[class^="icon-"],.dropdown-submenu:focus>a>[class^="icon-"],.dropdown-submenu:hover>a>[class*=" icon-"],.dropdown-submenu:focus>a>[class*=" icon-"]{background-image:url("../img/glyphicons-halflings-white.png")}.icon-glass{background-position:0 0}.icon-music{background-position:-24px 0}.icon-search{background-position:-48px 0}.icon-envelope{background-position:-72px 0}.icon-heart{background-position:-96px 0}.icon-star{background-position:-120px 0}.icon-star-empty{background-position:-144px 0}.icon-user{background-position:-168px 0}.icon-film{background-position:-192px 0}.icon-th-large{background-position:-216px 0}.icon-th{background-position:-240px 0}.icon-th-list{background-position:-264px 0}.icon-ok{background-position:-288px 0}.icon-remove{background-position:-312px 0}.icon-zoom-in{background-position:-336px 0}.icon-zoom-out{background-position:-360px 0}.icon-off{background-position:-384px 0}.icon-signal{background-position:-408px 0}.icon-cog{background-position:-432px 0}.icon-trash{background-position:-456px 0}.icon-home{background-position:0 -24px}.icon-file{background-position:-24px -24px}.icon-time{background-position:-48px -24px}.icon-road{background-position:-72px -24px}.icon-download-alt{background-position:-96px -24px}.icon-download{background-position:-120px -24px}.icon-upload{background-position:-144px -24px}.icon-inbox{background-position:-168px -24px}.icon-play-circle{background-position:-192px -24px}.icon-repeat{background-position:-216px -24px}.icon-refresh{background-position:-240px -24px}.icon-list-alt{background-position:-264px -24px}.icon-lock{background-position:-287px -24px}.icon-flag{background-position:-312px -24px}.icon-headphones{background-position:-336px -24px}.icon-volume-off{background-position:-360px -24px}.icon-volume-down{background-position:-384px -24px}.icon-volume-up{background-position:-408px -24px}.icon-qrcode{background-position:-432px -24px}.icon-barcode{background-position:-456px -24px}.icon-tag{background-position:0 -48px}.icon-tags{background-position:-25px -48px}.icon-book{background-position:-48px -48px}.icon-bookmark{background-position:-72px -48px}.icon-print{background-position:-96px -48px}.icon-camera{background-position:-120px -48px}.icon-font{background-position:-144px -48px}.icon-bold{background-position:-167px -48px}.icon-italic{background-position:-192px -48px}.icon-text-height{background-position:-216px -48px}.icon-text-width{background-position:-240px -48px}.icon-align-left{background-position:-264px -48px}.icon-align-center{background-position:-288px -48px}.icon-align-right{background-position:-312px -48px}.icon-align-justify{background-position:-336px -48px}.icon-list{background-position:-360px -48px}.icon-indent-left{background-position:-384px -48px}.icon-indent-right{background-position:-408px -48px}.icon-facetime-video{background-position:-432px -48px}.icon-picture{background-position:-456px -48px}.icon-pencil{background-position:0 -72px}.icon-map-marker{background-position:-24px -72px}.icon-adjust{background-position:-48px -72px}.icon-tint{background-position:-72px -72px}.icon-edit{background-position:-96px -72px}.icon-share{background-position:-120px -72px}.icon-check{background-position:-144px -72px}.icon-move{background-position:-168px -72px}.icon-step-backward{background-position:-192px -72px}.icon-fast-backward{background-position:-216px -72px}.icon-backward{background-position:-240px -72px}.icon-play{background-position:-264px -72px}.icon-pause{background-position:-288px -72px}.icon-stop{background-position:-312px -72px}.icon-forward{background-position:-336px -72px}.icon-fast-forward{background-position:-360px -72px}.icon-step-forward{background-position:-384px -72px}.icon-eject{background-position:-408px -72px}.icon-chevron-left{background-position:-432px -72px}.icon-chevron-right{background-position:-456px -72px}.icon-plus-sign{background-position:0 -96px}.icon-minus-sign{background-position:-24px -96px}.icon-remove-sign{background-position:-48px -96px}.icon-ok-sign{background-position:-72px -96px}.icon-question-sign{background-position:-96px -96px}.icon-info-sign{background-position:-120px -96px}.icon-screenshot{background-position:-144px -96px}.icon-remove-circle{background-position:-168px -96px}.icon-ok-circle{background-position:-192px -96px}.icon-ban-circle{background-position:-216px -96px}.icon-arrow-left{background-position:-240px -96px}.icon-arrow-right{background-position:-264px -96px}.icon-arrow-up{background-position:-289px -96px}.icon-arrow-down{background-position:-312px -96px}.icon-share-alt{background-position:-336px -96px}.icon-resize-full{background-position:-360px -96px}.icon-resize-small{background-position:-384px -96px}.icon-plus{background-position:-408px -96px}.icon-minus{background-position:-433px -96px}.icon-asterisk{background-position:-456px -96px}.icon-exclamation-sign{background-position:0 -120px}.icon-gift{background-position:-24px -120px}.icon-leaf{background-position:-48px -120px}.icon-fire{background-position:-72px -120px}.icon-eye-open{background-position:-96px -120px}.icon-eye-close{background-position:-120px -120px}.icon-warning-sign{background-position:-144px -120px}.icon-plane{background-position:-168px -120px}.icon-calendar{background-position:-192px -120px}.icon-random{width:16px;background-position:-216px -120px}.icon-comment{background-position:-240px -120px}.icon-magnet{background-position:-264px -120px}.icon-chevron-up{background-position:-288px -120px}.icon-chevron-down{background-position:-313px -119px}.icon-retweet{background-position:-336px -120px}.icon-shopping-cart{background-position:-360px -120px}.icon-folder-close{width:16px;background-position:-384px -120px}.icon-folder-open{width:16px;background-position:-408px -120px}.icon-resize-vertical{background-position:-432px -119px}.icon-resize-horizontal{background-position:-456px -118px}.icon-hdd{background-position:0 -144px}.icon-bullhorn{background-position:-24px -144px}.icon-bell{background-position:-48px -144px}.icon-certificate{background-position:-72px -144px}.icon-thumbs-up{background-position:-96px -144px}.icon-thumbs-down{background-position:-120px -144px}.icon-hand-right{background-position:-144px -144px}.icon-hand-left{background-position:-168px -144px}.icon-hand-up{background-position:-192px -144px}.icon-hand-down{background-position:-216px -144px}.icon-circle-arrow-right{background-position:-240px -144px}.icon-circle-arrow-left{background-position:-264px -144px}.icon-circle-arrow-up{background-position:-288px -144px}.icon-circle-arrow-down{background-position:-312px -144px}.icon-globe{background-position:-336px -144px}.icon-wrench{background-position:-360px -144px}.icon-tasks{background-position:-384px -144px}.icon-filter{background-position:-408px -144px}.icon-briefcase{background-position:-432px -144px}.icon-fullscreen{background-position:-456px -144px}.dropup,.dropdown{position:relative}.dropdown-toggle{*margin-bottom:-3px}.dropdown-toggle:active,.open .dropdown-toggle{outline:0}.caret{display:inline-block;width:0;height:0;vertical-align:top;border-top:4px solid #000;border-right:4px solid transparent;border-left:4px solid transparent;content:""}.dropdown .caret{margin-top:8px;margin-left:2px}.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;list-style:none;background-color:#fff;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.2);*border-right-width:2px;*border-bottom-width:2px;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0,0,0,0.2);-moz-box-shadow:0 5px 10px rgba(0,0,0,0.2);box-shadow:0 5px 10px rgba(0,0,0,0.2);-webkit-background-clip:padding-box;-moz-background-clip:padding;background-clip:padding-box}.dropdown-menu.pull-right{right:0;left:auto}.dropdown-menu .divider{*width:100%;height:1px;margin:9px 1px;*margin:-5px 0 5px;overflow:hidden;background-color:#e5e5e5;border-bottom:1px solid #fff}.dropdown-menu>li>a{display:block;padding:3px 20px;clear:both;font-weight:normal;line-height:20px;color:#333;white-space:nowrap}.dropdown-menu>li>a:hover,.dropdown-menu>li>a:focus,.dropdown-submenu:hover>a,.dropdown-submenu:focus>a{color:#fff;text-decoration:none;background-color:#0081c2;background-image:-moz-linear-gradient(top,#08c,#0077b3);background-image:-webkit-gradient(linear,0 0,0 100%,from(#08c),to(#0077b3));background-image:-webkit-linear-gradient(top,#08c,#0077b3);background-image:-o-linear-gradient(top,#08c,#0077b3);background-image:linear-gradient(to bottom,#08c,#0077b3);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc',endColorstr='#ff0077b3',GradientType=0)}.dropdown-menu>.active>a,.dropdown-menu>.active>a:hover,.dropdown-menu>.active>a:focus{color:#fff;text-decoration:none;background-color:#0081c2;background-image:-moz-linear-gradient(top,#08c,#0077b3);background-image:-webkit-gradient(linear,0 0,0 100%,from(#08c),to(#0077b3));background-image:-webkit-linear-gradient(top,#08c,#0077b3);background-image:-o-linear-gradient(top,#08c,#0077b3);background-image:linear-gradient(to bottom,#08c,#0077b3);background-repeat:repeat-x;outline:0;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc',endColorstr='#ff0077b3',GradientType=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:default;background-color:transparent;background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.open{*z-index:1000}.open>.dropdown-menu{display:block}.pull-right>.dropdown-menu{right:0;left:auto}.dropup .caret,.navbar-fixed-bottom .dropdown .caret{border-top:0;border-bottom:4px solid #000;content:""}.dropup .dropdown-menu,.navbar-fixed-bottom .dropdown .dropdown-menu{top:auto;bottom:100%;margin-bottom:1px}.dropdown-submenu{position:relative}.dropdown-submenu>.dropdown-menu{top:0;left:100%;margin-top:-6px;margin-left:-1px;-webkit-border-radius:0 6px 6px 6px;-moz-border-radius:0 6px 6px 6px;border-radius:0 6px 6px 6px}.dropdown-submenu:hover>.dropdown-menu{display:block}.dropup .dropdown-submenu>.dropdown-menu{top:auto;bottom:0;margin-top:0;margin-bottom:-2px;-webkit-border-radius:5px 5px 5px 0;-moz-border-radius:5px 5px 5px 0;border-radius:5px 5px 5px 0}.dropdown-submenu>a:after{display:block;float:right;width:0;height:0;margin-top:5px;margin-right:-10px;border-color:transparent;border-left-color:#ccc;border-style:solid;border-width:5px 0 5px 5px;content:" "}.dropdown-submenu:hover>a:after{border-left-color:#fff}.dropdown-submenu.pull-left{float:none}.dropdown-submenu.pull-left>.dropdown-menu{left:-100%;margin-left:10px;-webkit-border-radius:6px 0 6px 6px;-moz-border-radius:6px 0 6px 6px;border-radius:6px 0 6px 6px}.dropdown .dropdown-menu .nav-header{padding-right:20px;padding-left:20px}.typeahead{z-index:1051;margin-top:2px;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.well{min-height:20px;padding:19px;margin-bottom:20px;background-color:#f5f5f5;border:1px solid #e3e3e3;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.05);-moz-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-large{padding:24px;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.well-small{padding:9px;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.fade{opacity:0;-webkit-transition:opacity .15s linear;-moz-transition:opacity .15s linear;-o-transition:opacity .15s linear;transition:opacity .15s linear}.fade.in{opacity:1}.collapse{position:relative;height:0;overflow:hidden;-webkit-transition:height .35s ease;-moz-transition:height .35s ease;-o-transition:height .35s ease;transition:height .35s ease}.collapse.in{height:auto}.close{float:right;font-size:20px;font-weight:bold;line-height:20px;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:.4;filter:alpha(opacity=40)}button.close{padding:0;cursor:pointer;background:transparent;border:0;-webkit-appearance:none}.btn{display:inline-block;*display:inline;padding:4px 12px;margin-bottom:0;*margin-left:.3em;font-size:14px;line-height:20px;color:#333;text-align:center;text-shadow:0 1px 1px rgba(255,255,255,0.75);vertical-align:middle;cursor:pointer;background-color:#f5f5f5;*background-color:#e6e6e6;background-image:-moz-linear-gradient(top,#fff,#e6e6e6);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fff),to(#e6e6e6));background-image:-webkit-linear-gradient(top,#fff,#e6e6e6);background-image:-o-linear-gradient(top,#fff,#e6e6e6);background-image:linear-gradient(to bottom,#fff,#e6e6e6);background-repeat:repeat-x;border:1px solid #ccc;*border:0;border-color:#e6e6e6 #e6e6e6 #bfbfbf;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);border-bottom-color:#b3b3b3;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff',endColorstr='#ffe6e6e6',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false);*zoom:1;-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05)}.btn:hover,.btn:focus,.btn:active,.btn.active,.btn.disabled,.btn[disabled]{color:#333;background-color:#e6e6e6;*background-color:#d9d9d9}.btn:active,.btn.active{background-color:#ccc \9}.btn:first-child{*margin-left:0}.btn:hover,.btn:focus{color:#333;text-decoration:none;background-position:0 -15px;-webkit-transition:background-position .1s linear;-moz-transition:background-position .1s linear;-o-transition:background-position .1s linear;transition:background-position .1s linear}.btn:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}.btn.active,.btn:active{background-image:none;outline:0;-webkit-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05)}.btn.disabled,.btn[disabled]{cursor:default;background-image:none;opacity:.65;filter:alpha(opacity=65);-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.btn-large{padding:11px 19px;font-size:17.5px;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.btn-large [class^="icon-"],.btn-large [class*=" icon-"]{margin-top:4px}.btn-small{padding:2px 10px;font-size:11.9px;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.btn-small [class^="icon-"],.btn-small [class*=" icon-"]{margin-top:0}.btn-mini [class^="icon-"],.btn-mini [class*=" icon-"]{margin-top:-1px}.btn-mini{padding:0 6px;font-size:10.5px;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.btn-block{display:block;width:100%;padding-right:0;padding-left:0;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.btn-block+.btn-block{margin-top:5px}input[type="submit"].btn-block,input[type="reset"].btn-block,input[type="button"].btn-block{width:100%}.btn-primary.active,.btn-warning.active,.btn-danger.active,.btn-success.active,.btn-info.active,.btn-inverse.active{color:rgba(255,255,255,0.75)}.btn-primary{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#006dcc;*background-color:#04c;background-image:-moz-linear-gradient(top,#08c,#04c);background-image:-webkit-gradient(linear,0 0,0 100%,from(#08c),to(#04c));background-image:-webkit-linear-gradient(top,#08c,#04c);background-image:-o-linear-gradient(top,#08c,#04c);background-image:linear-gradient(to bottom,#08c,#04c);background-repeat:repeat-x;border-color:#04c #04c #002a80;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc',endColorstr='#ff0044cc',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-primary:hover,.btn-primary:focus,.btn-primary:active,.btn-primary.active,.btn-primary.disabled,.btn-primary[disabled]{color:#fff;background-color:#04c;*background-color:#003bb3}.btn-primary:active,.btn-primary.active{background-color:#039 \9}.btn-warning{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#faa732;*background-color:#f89406;background-image:-moz-linear-gradient(top,#fbb450,#f89406);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fbb450),to(#f89406));background-image:-webkit-linear-gradient(top,#fbb450,#f89406);background-image:-o-linear-gradient(top,#fbb450,#f89406);background-image:linear-gradient(to bottom,#fbb450,#f89406);background-repeat:repeat-x;border-color:#f89406 #f89406 #ad6704;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffbb450',endColorstr='#fff89406',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-warning:hover,.btn-warning:focus,.btn-warning:active,.btn-warning.active,.btn-warning.disabled,.btn-warning[disabled]{color:#fff;background-color:#f89406;*background-color:#df8505}.btn-warning:active,.btn-warning.active{background-color:#c67605 \9}.btn-danger{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#da4f49;*background-color:#bd362f;background-image:-moz-linear-gradient(top,#ee5f5b,#bd362f);background-image:-webkit-gradient(linear,0 0,0 100%,from(#ee5f5b),to(#bd362f));background-image:-webkit-linear-gradient(top,#ee5f5b,#bd362f);background-image:-o-linear-gradient(top,#ee5f5b,#bd362f);background-image:linear-gradient(to bottom,#ee5f5b,#bd362f);background-repeat:repeat-x;border-color:#bd362f #bd362f #802420;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffee5f5b',endColorstr='#ffbd362f',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-danger:hover,.btn-danger:focus,.btn-danger:active,.btn-danger.active,.btn-danger.disabled,.btn-danger[disabled]{color:#fff;background-color:#bd362f;*background-color:#a9302a}.btn-danger:active,.btn-danger.active{background-color:#942a25 \9}.btn-success{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#5bb75b;*background-color:#51a351;background-image:-moz-linear-gradient(top,#62c462,#51a351);background-image:-webkit-gradient(linear,0 0,0 100%,from(#62c462),to(#51a351));background-image:-webkit-linear-gradient(top,#62c462,#51a351);background-image:-o-linear-gradient(top,#62c462,#51a351);background-image:linear-gradient(to bottom,#62c462,#51a351);background-repeat:repeat-x;border-color:#51a351 #51a351 #387038;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff62c462',endColorstr='#ff51a351',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-success:hover,.btn-success:focus,.btn-success:active,.btn-success.active,.btn-success.disabled,.btn-success[disabled]{color:#fff;background-color:#51a351;*background-color:#499249}.btn-success:active,.btn-success.active{background-color:#408140 \9}.btn-info{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#49afcd;*background-color:#2f96b4;background-image:-moz-linear-gradient(top,#5bc0de,#2f96b4);background-image:-webkit-gradient(linear,0 0,0 100%,from(#5bc0de),to(#2f96b4));background-image:-webkit-linear-gradient(top,#5bc0de,#2f96b4);background-image:-o-linear-gradient(top,#5bc0de,#2f96b4);background-image:linear-gradient(to bottom,#5bc0de,#2f96b4);background-repeat:repeat-x;border-color:#2f96b4 #2f96b4 #1f6377;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff5bc0de',endColorstr='#ff2f96b4',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-info:hover,.btn-info:focus,.btn-info:active,.btn-info.active,.btn-info.disabled,.btn-info[disabled]{color:#fff;background-color:#2f96b4;*background-color:#2a85a0}.btn-info:active,.btn-info.active{background-color:#24748c \9}.btn-inverse{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#363636;*background-color:#222;background-image:-moz-linear-gradient(top,#444,#222);background-image:-webkit-gradient(linear,0 0,0 100%,from(#444),to(#222));background-image:-webkit-linear-gradient(top,#444,#222);background-image:-o-linear-gradient(top,#444,#222);background-image:linear-gradient(to bottom,#444,#222);background-repeat:repeat-x;border-color:#222 #222 #000;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff444444',endColorstr='#ff222222',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.btn-inverse:hover,.btn-inverse:focus,.btn-inverse:active,.btn-inverse.active,.btn-inverse.disabled,.btn-inverse[disabled]{color:#fff;background-color:#222;*background-color:#151515}.btn-inverse:active,.btn-inverse.active{background-color:#080808 \9}button.btn,input[type="submit"].btn{*padding-top:3px;*padding-bottom:3px}button.btn::-moz-focus-inner,input[type="submit"].btn::-moz-focus-inner{padding:0;border:0}button.btn.btn-large,input[type="submit"].btn.btn-large{*padding-top:7px;*padding-bottom:7px}button.btn.btn-small,input[type="submit"].btn.btn-small{*padding-top:3px;*padding-bottom:3px}button.btn.btn-mini,input[type="submit"].btn.btn-mini{*padding-top:1px;*padding-bottom:1px}.btn-link,.btn-link:active,.btn-link[disabled]{background-color:transparent;background-image:none;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.btn-link{color:#08c;cursor:pointer;border-color:transparent;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.btn-link:hover,.btn-link:focus{color:#005580;text-decoration:underline;background-color:transparent}.btn-link[disabled]:hover,.btn-link[disabled]:focus{color:#333;text-decoration:none}.btn-group{position:relative;display:inline-block;*display:inline;*margin-left:.3em;font-size:0;white-space:nowrap;vertical-align:middle;*zoom:1}.btn-group:first-child{*margin-left:0}.btn-group+.btn-group{margin-left:5px}.btn-toolbar{margin-top:10px;margin-bottom:10px;font-size:0}.btn-toolbar>.btn+.btn,.btn-toolbar>.btn-group+.btn,.btn-toolbar>.btn+.btn-group{margin-left:5px}.btn-group>.btn{position:relative;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.btn-group>.btn+.btn{margin-left:-1px}.btn-group>.btn,.btn-group>.dropdown-menu,.btn-group>.popover{font-size:14px}.btn-group>.btn-mini{font-size:10.5px}.btn-group>.btn-small{font-size:11.9px}.btn-group>.btn-large{font-size:17.5px}.btn-group>.btn:first-child{margin-left:0;-webkit-border-bottom-left-radius:4px;border-bottom-left-radius:4px;-webkit-border-top-left-radius:4px;border-top-left-radius:4px;-moz-border-radius-bottomleft:4px;-moz-border-radius-topleft:4px}.btn-group>.btn:last-child,.btn-group>.dropdown-toggle{-webkit-border-top-right-radius:4px;border-top-right-radius:4px;-webkit-border-bottom-right-radius:4px;border-bottom-right-radius:4px;-moz-border-radius-topright:4px;-moz-border-radius-bottomright:4px}.btn-group>.btn.large:first-child{margin-left:0;-webkit-border-bottom-left-radius:6px;border-bottom-left-radius:6px;-webkit-border-top-left-radius:6px;border-top-left-radius:6px;-moz-border-radius-bottomleft:6px;-moz-border-radius-topleft:6px}.btn-group>.btn.large:last-child,.btn-group>.large.dropdown-toggle{-webkit-border-top-right-radius:6px;border-top-right-radius:6px;-webkit-border-bottom-right-radius:6px;border-bottom-right-radius:6px;-moz-border-radius-topright:6px;-moz-border-radius-bottomright:6px}.btn-group>.btn:hover,.btn-group>.btn:focus,.btn-group>.btn:active,.btn-group>.btn.active{z-index:2}.btn-group .dropdown-toggle:active,.btn-group.open .dropdown-toggle{outline:0}.btn-group>.btn+.dropdown-toggle{*padding-top:5px;padding-right:8px;*padding-bottom:5px;padding-left:8px;-webkit-box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05)}.btn-group>.btn-mini+.dropdown-toggle{*padding-top:2px;padding-right:5px;*padding-bottom:2px;padding-left:5px}.btn-group>.btn-small+.dropdown-toggle{*padding-top:5px;*padding-bottom:4px}.btn-group>.btn-large+.dropdown-toggle{*padding-top:7px;padding-right:12px;*padding-bottom:7px;padding-left:12px}.btn-group.open .dropdown-toggle{background-image:none;-webkit-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05)}.btn-group.open .btn.dropdown-toggle{background-color:#e6e6e6}.btn-group.open .btn-primary.dropdown-toggle{background-color:#04c}.btn-group.open .btn-warning.dropdown-toggle{background-color:#f89406}.btn-group.open .btn-danger.dropdown-toggle{background-color:#bd362f}.btn-group.open .btn-success.dropdown-toggle{background-color:#51a351}.btn-group.open .btn-info.dropdown-toggle{background-color:#2f96b4}.btn-group.open .btn-inverse.dropdown-toggle{background-color:#222}.btn .caret{margin-top:8px;margin-left:0}.btn-large .caret{margin-top:6px}.btn-large .caret{border-top-width:5px;border-right-width:5px;border-left-width:5px}.btn-mini .caret,.btn-small .caret{margin-top:8px}.dropup .btn-large .caret{border-bottom-width:5px}.btn-primary .caret,.btn-warning .caret,.btn-danger .caret,.btn-info .caret,.btn-success .caret,.btn-inverse .caret{border-top-color:#fff;border-bottom-color:#fff}.btn-group-vertical{display:inline-block;*display:inline;*zoom:1}.btn-group-vertical>.btn{display:block;float:none;max-width:100%;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.btn-group-vertical>.btn+.btn{margin-top:-1px;margin-left:0}.btn-group-vertical>.btn:first-child{-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0}.btn-group-vertical>.btn:last-child{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px}.btn-group-vertical>.btn-large:first-child{-webkit-border-radius:6px 6px 0 0;-moz-border-radius:6px 6px 0 0;border-radius:6px 6px 0 0}.btn-group-vertical>.btn-large:last-child{-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px}.alert{padding:8px 35px 8px 14px;margin-bottom:20px;text-shadow:0 1px 0 rgba(255,255,255,0.5);background-color:#fcf8e3;border:1px solid #fbeed5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.alert,.alert h4{color:#c09853}.alert h4{margin:0}.alert .close{position:relative;top:-2px;right:-21px;line-height:20px}.alert-success{color:#468847;background-color:#dff0d8;border-color:#d6e9c6}.alert-success h4{color:#468847}.alert-danger,.alert-error{color:#b94a48;background-color:#f2dede;border-color:#eed3d7}.alert-danger h4,.alert-error h4{color:#b94a48}.alert-info{color:#3a87ad;background-color:#d9edf7;border-color:#bce8f1}.alert-info h4{color:#3a87ad}.alert-block{padding-top:14px;padding-bottom:14px}.alert-block>p,.alert-block>ul{margin-bottom:0}.alert-block p+p{margin-top:5px}.nav{margin-bottom:20px;margin-left:0;list-style:none}.nav>li>a{display:block}.nav>li>a:hover,.nav>li>a:focus{text-decoration:none;background-color:#eee}.nav>li>a>img{max-width:none}.nav>.pull-right{float:right}.nav-header{display:block;padding:3px 15px;font-size:11px;font-weight:bold;line-height:20px;color:#999;text-shadow:0 1px 0 rgba(255,255,255,0.5);text-transform:uppercase}.nav li+.nav-header{margin-top:9px}.nav-list{padding-right:15px;padding-left:15px;margin-bottom:0}.nav-list>li>a,.nav-list .nav-header{margin-right:-15px;margin-left:-15px;text-shadow:0 1px 0 rgba(255,255,255,0.5)}.nav-list>li>a{padding:3px 15px}.nav-list>.active>a,.nav-list>.active>a:hover,.nav-list>.active>a:focus{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.2);background-color:#08c}.nav-list [class^="icon-"],.nav-list [class*=" icon-"]{margin-right:2px}.nav-list .divider{*width:100%;height:1px;margin:9px 1px;*margin:-5px 0 5px;overflow:hidden;background-color:#e5e5e5;border-bottom:1px solid #fff}.nav-tabs,.nav-pills{*zoom:1}.nav-tabs:before,.nav-pills:before,.nav-tabs:after,.nav-pills:after{display:table;line-height:0;content:""}.nav-tabs:after,.nav-pills:after{clear:both}.nav-tabs>li,.nav-pills>li{float:left}.nav-tabs>li>a,.nav-pills>li>a{padding-right:12px;padding-left:12px;margin-right:2px;line-height:14px}.nav-tabs{border-bottom:1px solid #ddd}.nav-tabs>li{margin-bottom:-1px}.nav-tabs>li>a{padding-top:8px;padding-bottom:8px;line-height:20px;border:1px solid transparent;-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0}.nav-tabs>li>a:hover,.nav-tabs>li>a:focus{border-color:#eee #eee #ddd}.nav-tabs>.active>a,.nav-tabs>.active>a:hover,.nav-tabs>.active>a:focus{color:#555;cursor:default;background-color:#fff;border:1px solid #ddd;border-bottom-color:transparent}.nav-pills>li>a{padding-top:8px;padding-bottom:8px;margin-top:2px;margin-bottom:2px;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.nav-pills>.active>a,.nav-pills>.active>a:hover,.nav-pills>.active>a:focus{color:#fff;background-color:#08c}.nav-stacked>li{float:none}.nav-stacked>li>a{margin-right:0}.nav-tabs.nav-stacked{border-bottom:0}.nav-tabs.nav-stacked>li>a{border:1px solid #ddd;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.nav-tabs.nav-stacked>li:first-child>a{-webkit-border-top-right-radius:4px;border-top-right-radius:4px;-webkit-border-top-left-radius:4px;border-top-left-radius:4px;-moz-border-radius-topright:4px;-moz-border-radius-topleft:4px}.nav-tabs.nav-stacked>li:last-child>a{-webkit-border-bottom-right-radius:4px;border-bottom-right-radius:4px;-webkit-border-bottom-left-radius:4px;border-bottom-left-radius:4px;-moz-border-radius-bottomright:4px;-moz-border-radius-bottomleft:4px}.nav-tabs.nav-stacked>li>a:hover,.nav-tabs.nav-stacked>li>a:focus{z-index:2;border-color:#ddd}.nav-pills.nav-stacked>li>a{margin-bottom:3px}.nav-pills.nav-stacked>li:last-child>a{margin-bottom:1px}.nav-tabs .dropdown-menu{-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px}.nav-pills .dropdown-menu{-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.nav .dropdown-toggle .caret{margin-top:6px;border-top-color:#08c;border-bottom-color:#08c}.nav .dropdown-toggle:hover .caret,.nav .dropdown-toggle:focus .caret{border-top-color:#005580;border-bottom-color:#005580}.nav-tabs .dropdown-toggle .caret{margin-top:8px}.nav .active .dropdown-toggle .caret{border-top-color:#fff;border-bottom-color:#fff}.nav-tabs .active .dropdown-toggle .caret{border-top-color:#555;border-bottom-color:#555}.nav>.dropdown.active>a:hover,.nav>.dropdown.active>a:focus{cursor:pointer}.nav-tabs .open .dropdown-toggle,.nav-pills .open .dropdown-toggle,.nav>li.dropdown.open.active>a:hover,.nav>li.dropdown.open.active>a:focus{color:#fff;background-color:#999;border-color:#999}.nav li.dropdown.open .caret,.nav li.dropdown.open.active .caret,.nav li.dropdown.open a:hover .caret,.nav li.dropdown.open a:focus .caret{border-top-color:#fff;border-bottom-color:#fff;opacity:1;filter:alpha(opacity=100)}.tabs-stacked .open>a:hover,.tabs-stacked .open>a:focus{border-color:#999}.tabbable{*zoom:1}.tabbable:before,.tabbable:after{display:table;line-height:0;content:""}.tabbable:after{clear:both}.tab-content{overflow:auto}.tabs-below>.nav-tabs,.tabs-right>.nav-tabs,.tabs-left>.nav-tabs{border-bottom:0}.tab-content>.tab-pane,.pill-content>.pill-pane{display:none}.tab-content>.active,.pill-content>.active{display:block}.tabs-below>.nav-tabs{border-top:1px solid #ddd}.tabs-below>.nav-tabs>li{margin-top:-1px;margin-bottom:0}.tabs-below>.nav-tabs>li>a{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px}.tabs-below>.nav-tabs>li>a:hover,.tabs-below>.nav-tabs>li>a:focus{border-top-color:#ddd;border-bottom-color:transparent}.tabs-below>.nav-tabs>.active>a,.tabs-below>.nav-tabs>.active>a:hover,.tabs-below>.nav-tabs>.active>a:focus{border-color:transparent #ddd #ddd #ddd}.tabs-left>.nav-tabs>li,.tabs-right>.nav-tabs>li{float:none}.tabs-left>.nav-tabs>li>a,.tabs-right>.nav-tabs>li>a{min-width:74px;margin-right:0;margin-bottom:3px}.tabs-left>.nav-tabs{float:left;margin-right:19px;border-right:1px solid #ddd}.tabs-left>.nav-tabs>li>a{margin-right:-1px;-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.tabs-left>.nav-tabs>li>a:hover,.tabs-left>.nav-tabs>li>a:focus{border-color:#eee #ddd #eee #eee}.tabs-left>.nav-tabs .active>a,.tabs-left>.nav-tabs .active>a:hover,.tabs-left>.nav-tabs .active>a:focus{border-color:#ddd transparent #ddd #ddd;*border-right-color:#fff}.tabs-right>.nav-tabs{float:right;margin-left:19px;border-left:1px solid #ddd}.tabs-right>.nav-tabs>li>a{margin-left:-1px;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.tabs-right>.nav-tabs>li>a:hover,.tabs-right>.nav-tabs>li>a:focus{border-color:#eee #eee #eee #ddd}.tabs-right>.nav-tabs .active>a,.tabs-right>.nav-tabs .active>a:hover,.tabs-right>.nav-tabs .active>a:focus{border-color:#ddd #ddd #ddd transparent;*border-left-color:#fff}.nav>.disabled>a{color:#999}.nav>.disabled>a:hover,.nav>.disabled>a:focus{text-decoration:none;cursor:default;background-color:transparent}.navbar{*position:relative;*z-index:2;margin-bottom:20px;overflow:visible}.navbar-inner{min-height:40px;padding-right:20px;padding-left:20px;background-color:#fafafa;background-image:-moz-linear-gradient(top,#fff,#f2f2f2);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fff),to(#f2f2f2));background-image:-webkit-linear-gradient(top,#fff,#f2f2f2);background-image:-o-linear-gradient(top,#fff,#f2f2f2);background-image:linear-gradient(to bottom,#fff,#f2f2f2);background-repeat:repeat-x;border:1px solid #d4d4d4;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff',endColorstr='#fff2f2f2',GradientType=0);*zoom:1;-webkit-box-shadow:0 1px 4px rgba(0,0,0,0.065);-moz-box-shadow:0 1px 4px rgba(0,0,0,0.065);box-shadow:0 1px 4px rgba(0,0,0,0.065)}.navbar-inner:before,.navbar-inner:after{display:table;line-height:0;content:""}.navbar-inner:after{clear:both}.navbar .container{width:auto}.nav-collapse.collapse{height:auto;overflow:visible}.navbar .brand{display:block;float:left;padding:10px 20px 10px;margin-left:-20px;font-size:20px;font-weight:200;color:#777;text-shadow:0 1px 0 #fff}.navbar .brand:hover,.navbar .brand:focus{text-decoration:none}.navbar-text{margin-bottom:0;line-height:40px;color:#777}.navbar-link{color:#777}.navbar-link:hover,.navbar-link:focus{color:#333}.navbar .divider-vertical{height:40px;margin:0 9px;border-right:1px solid #fff;border-left:1px solid #f2f2f2}.navbar .btn,.navbar .btn-group{margin-top:5px}.navbar .btn-group .btn,.navbar .input-prepend .btn,.navbar .input-append .btn,.navbar .input-prepend .btn-group,.navbar .input-append .btn-group{margin-top:0}.navbar-form{margin-bottom:0;*zoom:1}.navbar-form:before,.navbar-form:after{display:table;line-height:0;content:""}.navbar-form:after{clear:both}.navbar-form input,.navbar-form select,.navbar-form .radio,.navbar-form .checkbox{margin-top:5px}.navbar-form input,.navbar-form select,.navbar-form .btn{display:inline-block;margin-bottom:0}.navbar-form input[type="image"],.navbar-form input[type="checkbox"],.navbar-form input[type="radio"]{margin-top:3px}.navbar-form .input-append,.navbar-form .input-prepend{margin-top:5px;white-space:nowrap}.navbar-form .input-append input,.navbar-form .input-prepend input{margin-top:0}.navbar-search{position:relative;float:left;margin-top:5px;margin-bottom:0}.navbar-search .search-query{padding:4px 14px;margin-bottom:0;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px;font-weight:normal;line-height:1;-webkit-border-radius:15px;-moz-border-radius:15px;border-radius:15px}.navbar-static-top{position:static;margin-bottom:0}.navbar-static-top .navbar-inner{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.navbar-fixed-top,.navbar-fixed-bottom{position:fixed;right:0;left:0;z-index:1030;margin-bottom:0}.navbar-fixed-top .navbar-inner,.navbar-static-top .navbar-inner{border-width:0 0 1px}.navbar-fixed-bottom .navbar-inner{border-width:1px 0 0}.navbar-fixed-top .navbar-inner,.navbar-fixed-bottom .navbar-inner{padding-right:0;padding-left:0;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.navbar-static-top .container,.navbar-fixed-top .container,.navbar-fixed-bottom .container{width:940px}.navbar-fixed-top{top:0}.navbar-fixed-top .navbar-inner,.navbar-static-top .navbar-inner{-webkit-box-shadow:0 1px 10px rgba(0,0,0,0.1);-moz-box-shadow:0 1px 10px rgba(0,0,0,0.1);box-shadow:0 1px 10px rgba(0,0,0,0.1)}.navbar-fixed-bottom{bottom:0}.navbar-fixed-bottom .navbar-inner{-webkit-box-shadow:0 -1px 10px rgba(0,0,0,0.1);-moz-box-shadow:0 -1px 10px rgba(0,0,0,0.1);box-shadow:0 -1px 10px rgba(0,0,0,0.1)}.navbar .nav{position:relative;left:0;display:block;float:left;margin:0 10px 0 0}.navbar .nav.pull-right{float:right;margin-right:0}.navbar .nav>li{float:left}.navbar .nav>li>a{float:none;padding:10px 15px 10px;color:#777;text-decoration:none;text-shadow:0 1px 0 #fff}.navbar .nav .dropdown-toggle .caret{margin-top:8px}.navbar .nav>li>a:focus,.navbar .nav>li>a:hover{color:#333;text-decoration:none;background-color:transparent}.navbar .nav>.active>a,.navbar .nav>.active>a:hover,.navbar .nav>.active>a:focus{color:#555;text-decoration:none;background-color:#e5e5e5;-webkit-box-shadow:inset 0 3px 8px rgba(0,0,0,0.125);-moz-box-shadow:inset 0 3px 8px rgba(0,0,0,0.125);box-shadow:inset 0 3px 8px rgba(0,0,0,0.125)}.navbar .btn-navbar{display:none;float:right;padding:7px 10px;margin-right:5px;margin-left:5px;color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#ededed;*background-color:#e5e5e5;background-image:-moz-linear-gradient(top,#f2f2f2,#e5e5e5);background-image:-webkit-gradient(linear,0 0,0 100%,from(#f2f2f2),to(#e5e5e5));background-image:-webkit-linear-gradient(top,#f2f2f2,#e5e5e5);background-image:-o-linear-gradient(top,#f2f2f2,#e5e5e5);background-image:linear-gradient(to bottom,#f2f2f2,#e5e5e5);background-repeat:repeat-x;border-color:#e5e5e5 #e5e5e5 #bfbfbf;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2',endColorstr='#ffe5e5e5',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false);-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075);-moz-box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075);box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075)}.navbar .btn-navbar:hover,.navbar .btn-navbar:focus,.navbar .btn-navbar:active,.navbar .btn-navbar.active,.navbar .btn-navbar.disabled,.navbar .btn-navbar[disabled]{color:#fff;background-color:#e5e5e5;*background-color:#d9d9d9}.navbar .btn-navbar:active,.navbar .btn-navbar.active{background-color:#ccc \9}.navbar .btn-navbar .icon-bar{display:block;width:18px;height:2px;background-color:#f5f5f5;-webkit-border-radius:1px;-moz-border-radius:1px;border-radius:1px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,0.25);-moz-box-shadow:0 1px 0 rgba(0,0,0,0.25);box-shadow:0 1px 0 rgba(0,0,0,0.25)}.btn-navbar .icon-bar+.icon-bar{margin-top:3px}.navbar .nav>li>.dropdown-menu:before{position:absolute;top:-7px;left:9px;display:inline-block;border-right:7px solid transparent;border-bottom:7px solid #ccc;border-left:7px solid transparent;border-bottom-color:rgba(0,0,0,0.2);content:''}.navbar .nav>li>.dropdown-menu:after{position:absolute;top:-6px;left:10px;display:inline-block;border-right:6px solid transparent;border-bottom:6px solid #fff;border-left:6px solid transparent;content:''}.navbar-fixed-bottom .nav>li>.dropdown-menu:before{top:auto;bottom:-7px;border-top:7px solid #ccc;border-bottom:0;border-top-color:rgba(0,0,0,0.2)}.navbar-fixed-bottom .nav>li>.dropdown-menu:after{top:auto;bottom:-6px;border-top:6px solid #fff;border-bottom:0}.navbar .nav li.dropdown>a:hover .caret,.navbar .nav li.dropdown>a:focus .caret{border-top-color:#333;border-bottom-color:#333}.navbar .nav li.dropdown.open>.dropdown-toggle,.navbar .nav li.dropdown.active>.dropdown-toggle,.navbar .nav li.dropdown.open.active>.dropdown-toggle{color:#555;background-color:#e5e5e5}.navbar .nav li.dropdown>.dropdown-toggle .caret{border-top-color:#777;border-bottom-color:#777}.navbar .nav li.dropdown.open>.dropdown-toggle .caret,.navbar .nav li.dropdown.active>.dropdown-toggle .caret,.navbar .nav li.dropdown.open.active>.dropdown-toggle .caret{border-top-color:#555;border-bottom-color:#555}.navbar .pull-right>li>.dropdown-menu,.navbar .nav>li>.dropdown-menu.pull-right{right:0;left:auto}.navbar .pull-right>li>.dropdown-menu:before,.navbar .nav>li>.dropdown-menu.pull-right:before{right:12px;left:auto}.navbar .pull-right>li>.dropdown-menu:after,.navbar .nav>li>.dropdown-menu.pull-right:after{right:13px;left:auto}.navbar .pull-right>li>.dropdown-menu .dropdown-menu,.navbar .nav>li>.dropdown-menu.pull-right .dropdown-menu{right:100%;left:auto;margin-right:-1px;margin-left:0;-webkit-border-radius:6px 0 6px 6px;-moz-border-radius:6px 0 6px 6px;border-radius:6px 0 6px 6px}.navbar-inverse .navbar-inner{background-color:#1b1b1b;background-image:-moz-linear-gradient(top,#222,#111);background-image:-webkit-gradient(linear,0 0,0 100%,from(#222),to(#111));background-image:-webkit-linear-gradient(top,#222,#111);background-image:-o-linear-gradient(top,#222,#111);background-image:linear-gradient(to bottom,#222,#111);background-repeat:repeat-x;border-color:#252525;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff222222',endColorstr='#ff111111',GradientType=0)}.navbar-inverse .brand,.navbar-inverse .nav>li>a{color:#999;text-shadow:0 -1px 0 rgba(0,0,0,0.25)}.navbar-inverse .brand:hover,.navbar-inverse .nav>li>a:hover,.navbar-inverse .brand:focus,.navbar-inverse .nav>li>a:focus{color:#fff}.navbar-inverse .brand{color:#999}.navbar-inverse .navbar-text{color:#999}.navbar-inverse .nav>li>a:focus,.navbar-inverse .nav>li>a:hover{color:#fff;background-color:transparent}.navbar-inverse .nav .active>a,.navbar-inverse .nav .active>a:hover,.navbar-inverse .nav .active>a:focus{color:#fff;background-color:#111}.navbar-inverse .navbar-link{color:#999}.navbar-inverse .navbar-link:hover,.navbar-inverse .navbar-link:focus{color:#fff}.navbar-inverse .divider-vertical{border-right-color:#222;border-left-color:#111}.navbar-inverse .nav li.dropdown.open>.dropdown-toggle,.navbar-inverse .nav li.dropdown.active>.dropdown-toggle,.navbar-inverse .nav li.dropdown.open.active>.dropdown-toggle{color:#fff;background-color:#111}.navbar-inverse .nav li.dropdown>a:hover .caret,.navbar-inverse .nav li.dropdown>a:focus .caret{border-top-color:#fff;border-bottom-color:#fff}.navbar-inverse .nav li.dropdown>.dropdown-toggle .caret{border-top-color:#999;border-bottom-color:#999}.navbar-inverse .nav li.dropdown.open>.dropdown-toggle .caret,.navbar-inverse .nav li.dropdown.active>.dropdown-toggle .caret,.navbar-inverse .nav li.dropdown.open.active>.dropdown-toggle .caret{border-top-color:#fff;border-bottom-color:#fff}.navbar-inverse .navbar-search .search-query{color:#fff;background-color:#515151;border-color:#111;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);-moz-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);-webkit-transition:none;-moz-transition:none;-o-transition:none;transition:none}.navbar-inverse .navbar-search .search-query:-moz-placeholder{color:#ccc}.navbar-inverse .navbar-search .search-query:-ms-input-placeholder{color:#ccc}.navbar-inverse .navbar-search .search-query::-webkit-input-placeholder{color:#ccc}.navbar-inverse .navbar-search .search-query:focus,.navbar-inverse .navbar-search .search-query.focused{padding:5px 15px;color:#333;text-shadow:0 1px 0 #fff;background-color:#fff;border:0;outline:0;-webkit-box-shadow:0 0 3px rgba(0,0,0,0.15);-moz-box-shadow:0 0 3px rgba(0,0,0,0.15);box-shadow:0 0 3px rgba(0,0,0,0.15)}.navbar-inverse .btn-navbar{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#0e0e0e;*background-color:#040404;background-image:-moz-linear-gradient(top,#151515,#040404);background-image:-webkit-gradient(linear,0 0,0 100%,from(#151515),to(#040404));background-image:-webkit-linear-gradient(top,#151515,#040404);background-image:-o-linear-gradient(top,#151515,#040404);background-image:linear-gradient(to bottom,#151515,#040404);background-repeat:repeat-x;border-color:#040404 #040404 #000;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff151515',endColorstr='#ff040404',GradientType=0);filter:progid:DXImageTransform.Microsoft.gradient(enabled=false)}.navbar-inverse .btn-navbar:hover,.navbar-inverse .btn-navbar:focus,.navbar-inverse .btn-navbar:active,.navbar-inverse .btn-navbar.active,.navbar-inverse .btn-navbar.disabled,.navbar-inverse .btn-navbar[disabled]{color:#fff;background-color:#040404;*background-color:#000}.navbar-inverse .btn-navbar:active,.navbar-inverse .btn-navbar.active{background-color:#000 \9}.breadcrumb{padding:8px 15px;margin:0 0 20px;list-style:none;background-color:#f5f5f5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.breadcrumb>li{display:inline-block;*display:inline;text-shadow:0 1px 0 #fff;*zoom:1}.breadcrumb>li>.divider{padding:0 5px;color:#ccc}.breadcrumb>.active{color:#999}.pagination{margin:20px 0}.pagination ul{display:inline-block;*display:inline;margin-bottom:0;margin-left:0;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;*zoom:1;-webkit-box-shadow:0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:0 1px 2px rgba(0,0,0,0.05);box-shadow:0 1px 2px rgba(0,0,0,0.05)}.pagination ul>li{display:inline}.pagination ul>li>a,.pagination ul>li>span{float:left;padding:4px 12px;line-height:20px;text-decoration:none;background-color:#fff;border:1px solid #ddd;border-left-width:0}.pagination ul>li>a:hover,.pagination ul>li>a:focus,.pagination ul>.active>a,.pagination ul>.active>span{background-color:#f5f5f5}.pagination ul>.active>a,.pagination ul>.active>span{color:#999;cursor:default}.pagination ul>.disabled>span,.pagination ul>.disabled>a,.pagination ul>.disabled>a:hover,.pagination ul>.disabled>a:focus{color:#999;cursor:default;background-color:transparent}.pagination ul>li:first-child>a,.pagination ul>li:first-child>span{border-left-width:1px;-webkit-border-bottom-left-radius:4px;border-bottom-left-radius:4px;-webkit-border-top-left-radius:4px;border-top-left-radius:4px;-moz-border-radius-bottomleft:4px;-moz-border-radius-topleft:4px}.pagination ul>li:last-child>a,.pagination ul>li:last-child>span{-webkit-border-top-right-radius:4px;border-top-right-radius:4px;-webkit-border-bottom-right-radius:4px;border-bottom-right-radius:4px;-moz-border-radius-topright:4px;-moz-border-radius-bottomright:4px}.pagination-centered{text-align:center}.pagination-right{text-align:right}.pagination-large ul>li>a,.pagination-large ul>li>span{padding:11px 19px;font-size:17.5px}.pagination-large ul>li:first-child>a,.pagination-large ul>li:first-child>span{-webkit-border-bottom-left-radius:6px;border-bottom-left-radius:6px;-webkit-border-top-left-radius:6px;border-top-left-radius:6px;-moz-border-radius-bottomleft:6px;-moz-border-radius-topleft:6px}.pagination-large ul>li:last-child>a,.pagination-large ul>li:last-child>span{-webkit-border-top-right-radius:6px;border-top-right-radius:6px;-webkit-border-bottom-right-radius:6px;border-bottom-right-radius:6px;-moz-border-radius-topright:6px;-moz-border-radius-bottomright:6px}.pagination-mini ul>li:first-child>a,.pagination-small ul>li:first-child>a,.pagination-mini ul>li:first-child>span,.pagination-small ul>li:first-child>span{-webkit-border-bottom-left-radius:3px;border-bottom-left-radius:3px;-webkit-border-top-left-radius:3px;border-top-left-radius:3px;-moz-border-radius-bottomleft:3px;-moz-border-radius-topleft:3px}.pagination-mini ul>li:last-child>a,.pagination-small ul>li:last-child>a,.pagination-mini ul>li:last-child>span,.pagination-small ul>li:last-child>span{-webkit-border-top-right-radius:3px;border-top-right-radius:3px;-webkit-border-bottom-right-radius:3px;border-bottom-right-radius:3px;-moz-border-radius-topright:3px;-moz-border-radius-bottomright:3px}.pagination-small ul>li>a,.pagination-small ul>li>span{padding:2px 10px;font-size:11.9px}.pagination-mini ul>li>a,.pagination-mini ul>li>span{padding:0 6px;font-size:10.5px}.pager{margin:20px 0;text-align:center;list-style:none;*zoom:1}.pager:before,.pager:after{display:table;line-height:0;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;-webkit-border-radius:15px;-moz-border-radius:15px;border-radius:15px}.pager li>a:hover,.pager li>a:focus{text-decoration:none;background-color:#f5f5f5}.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:default;background-color:#fff}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop,.modal-backdrop.fade.in{opacity:.8;filter:alpha(opacity=80)}.modal{position:fixed;top:10%;left:50%;z-index:1050;width:560px;margin-left:-280px;background-color:#fff;border:1px solid #999;border:1px solid rgba(0,0,0,0.3);*border:1px solid #999;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;outline:0;-webkit-box-shadow:0 3px 7px rgba(0,0,0,0.3);-moz-box-shadow:0 3px 7px rgba(0,0,0,0.3);box-shadow:0 3px 7px rgba(0,0,0,0.3);-webkit-background-clip:padding-box;-moz-background-clip:padding-box;background-clip:padding-box}.modal.fade{top:-25%;-webkit-transition:opacity .3s linear,top .3s ease-out;-moz-transition:opacity .3s linear,top .3s ease-out;-o-transition:opacity .3s linear,top .3s ease-out;transition:opacity .3s linear,top .3s ease-out}.modal.fade.in{top:10%}.modal-header{padding:9px 15px;border-bottom:1px solid #eee}.modal-header .close{margin-top:2px}.modal-header h3{margin:0;line-height:30px}.modal-body{position:relative;max-height:400px;padding:15px;overflow-y:auto}.modal-form{margin-bottom:0}.modal-footer{padding:14px 15px 15px;margin-bottom:0;text-align:right;background-color:#f5f5f5;border-top:1px solid #ddd;-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px;*zoom:1;-webkit-box-shadow:inset 0 1px 0 #fff;-moz-box-shadow:inset 0 1px 0 #fff;box-shadow:inset 0 1px 0 #fff}.modal-footer:before,.modal-footer:after{display:table;line-height:0;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}.tooltip{position:absolute;z-index:1030;display:block;font-size:11px;line-height:1.4;opacity:0;filter:alpha(opacity=0);visibility:visible}.tooltip.in{opacity:.8;filter:alpha(opacity=80)}.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:8px;color:#fff;text-align:center;text-decoration:none;background-color:#000;-webkit-border-radius:4px;-moz-border-radius:4px;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.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}.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);-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0,0,0,0.2);-moz-box-shadow:0 5px 10px rgba(0,0,0,0.2);box-shadow:0 5px 10px rgba(0,0,0,0.2);-webkit-background-clip:padding-box;-moz-background-clip:padding;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;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0}.popover-title:empty{display:none}.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}.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}.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}.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}.thumbnails{margin-left:-20px;list-style:none;*zoom:1}.thumbnails:before,.thumbnails:after{display:table;line-height:0;content:""}.thumbnails:after{clear:both}.row-fluid .thumbnails{margin-left:0}.thumbnails>li{float:left;margin-bottom:20px;margin-left:20px}.thumbnail{display:block;padding:4px;line-height:20px;border:1px solid #ddd;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:0 1px 3px rgba(0,0,0,0.055);-moz-box-shadow:0 1px 3px rgba(0,0,0,0.055);box-shadow:0 1px 3px rgba(0,0,0,0.055);-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;-o-transition:all .2s ease-in-out;transition:all .2s ease-in-out}a.thumbnail:hover,a.thumbnail:focus{border-color:#08c;-webkit-box-shadow:0 1px 4px rgba(0,105,214,0.25);-moz-box-shadow:0 1px 4px rgba(0,105,214,0.25);box-shadow:0 1px 4px rgba(0,105,214,0.25)}.thumbnail>img{display:block;max-width:100%;margin-right:auto;margin-left:auto}.thumbnail .caption{padding:9px;color:#555}.media,.media-body{overflow:hidden;*overflow:visible;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{margin-left:0;list-style:none}.label,.badge{display:inline-block;padding:2px 4px;font-size:11.844px;font-weight:bold;line-height:14px;color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);white-space:nowrap;vertical-align:baseline;background-color:#999}.label{-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.badge{padding-right:9px;padding-left:9px;-webkit-border-radius:9px;-moz-border-radius:9px;border-radius:9px}.label:empty,.badge:empty{display:none}a.label:hover,a.label:focus,a.badge:hover,a.badge:focus{color:#fff;text-decoration:none;cursor:pointer}.label-important,.badge-important{background-color:#b94a48}.label-important[href],.badge-important[href]{background-color:#953b39}.label-warning,.badge-warning{background-color:#f89406}.label-warning[href],.badge-warning[href]{background-color:#c67605}.label-success,.badge-success{background-color:#468847}.label-success[href],.badge-success[href]{background-color:#356635}.label-info,.badge-info{background-color:#3a87ad}.label-info[href],.badge-info[href]{background-color:#2d6987}.label-inverse,.badge-inverse{background-color:#333}.label-inverse[href],.badge-inverse[href]{background-color:#1a1a1a}.btn .label,.btn .badge{position:relative;top:-1px}.btn-mini .label,.btn-mini .badge{top:0}@-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}}@-ms-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:#f7f7f7;background-image:-moz-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:-webkit-gradient(linear,0 0,0 100%,from(#f5f5f5),to(#f9f9f9));background-image:-webkit-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:-o-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:linear-gradient(to bottom,#f5f5f5,#f9f9f9);background-repeat:repeat-x;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff5f5f5',endColorstr='#fff9f9f9',GradientType=0);-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);-moz-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;color:#fff;text-align:center;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#0e90d2;background-image:-moz-linear-gradient(top,#149bdf,#0480be);background-image:-webkit-gradient(linear,0 0,0 100%,from(#149bdf),to(#0480be));background-image:-webkit-linear-gradient(top,#149bdf,#0480be);background-image:-o-linear-gradient(top,#149bdf,#0480be);background-image:linear-gradient(to bottom,#149bdf,#0480be);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff149bdf',endColorstr='#ff0480be',GradientType=0);-webkit-box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);-moz-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-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;-webkit-transition:width .6s ease;-moz-transition:width .6s ease;-o-transition:width .6s ease;transition:width .6s ease}.progress .bar+.bar{-webkit-box-shadow:inset 1px 0 0 rgba(0,0,0,0.15),inset 0 -1px 0 rgba(0,0,0,0.15);-moz-box-shadow:inset 1px 0 0 rgba(0,0,0,0.15),inset 0 -1px 0 rgba(0,0,0,0.15);box-shadow:inset 1px 0 0 rgba(0,0,0,0.15),inset 0 -1px 0 rgba(0,0,0,0.15)}.progress-striped .bar{background-color:#149bdf;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:-o-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);-webkit-background-size:40px 40px;-moz-background-size:40px 40px;-o-background-size:40px 40px;background-size:40px 40px}.progress.active .bar{-webkit-animation:progress-bar-stripes 2s linear infinite;-moz-animation:progress-bar-stripes 2s linear infinite;-ms-animation:progress-bar-stripes 2s linear infinite;-o-animation:progress-bar-stripes 2s linear infinite;animation:progress-bar-stripes 2s linear infinite}.progress-danger .bar,.progress .bar-danger{background-color:#dd514c;background-image:-moz-linear-gradient(top,#ee5f5b,#c43c35);background-image:-webkit-gradient(linear,0 0,0 100%,from(#ee5f5b),to(#c43c35));background-image:-webkit-linear-gradient(top,#ee5f5b,#c43c35);background-image:-o-linear-gradient(top,#ee5f5b,#c43c35);background-image:linear-gradient(to bottom,#ee5f5b,#c43c35);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffee5f5b',endColorstr='#ffc43c35',GradientType=0)}.progress-danger.progress-striped .bar,.progress-striped .bar-danger{background-color:#ee5f5b;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:-o-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-success .bar,.progress .bar-success{background-color:#5eb95e;background-image:-moz-linear-gradient(top,#62c462,#57a957);background-image:-webkit-gradient(linear,0 0,0 100%,from(#62c462),to(#57a957));background-image:-webkit-linear-gradient(top,#62c462,#57a957);background-image:-o-linear-gradient(top,#62c462,#57a957);background-image:linear-gradient(to bottom,#62c462,#57a957);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff62c462',endColorstr='#ff57a957',GradientType=0)}.progress-success.progress-striped .bar,.progress-striped .bar-success{background-color:#62c462;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:-o-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-info .bar,.progress .bar-info{background-color:#4bb1cf;background-image:-moz-linear-gradient(top,#5bc0de,#339bb9);background-image:-webkit-gradient(linear,0 0,0 100%,from(#5bc0de),to(#339bb9));background-image:-webkit-linear-gradient(top,#5bc0de,#339bb9);background-image:-o-linear-gradient(top,#5bc0de,#339bb9);background-image:linear-gradient(to bottom,#5bc0de,#339bb9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff5bc0de',endColorstr='#ff339bb9',GradientType=0)}.progress-info.progress-striped .bar,.progress-striped .bar-info{background-color:#5bc0de;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:-o-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-warning .bar,.progress .bar-warning{background-color:#faa732;background-image:-moz-linear-gradient(top,#fbb450,#f89406);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fbb450),to(#f89406));background-image:-webkit-linear-gradient(top,#fbb450,#f89406);background-image:-o-linear-gradient(top,#fbb450,#f89406);background-image:linear-gradient(to bottom,#fbb450,#f89406);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffbb450',endColorstr='#fff89406',GradientType=0)}.progress-warning.progress-striped .bar,.progress-striped .bar-warning{background-color:#fbb450;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:-o-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)}.accordion{margin-bottom:20px}.accordion-group{margin-bottom:2px;border:1px solid #e5e5e5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.accordion-heading{border-bottom:0}.accordion-heading .accordion-toggle{display:block;padding:8px 15px}.accordion-toggle{cursor:pointer}.accordion-inner{padding:9px 15px;border-top:1px solid #e5e5e5}.carousel{position:relative;margin-bottom:20px;line-height:1}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner>.item{position:relative;display:none;-webkit-transition:.6s ease-in-out left;-moz-transition:.6s ease-in-out left;-o-transition:.6s ease-in-out left;transition:.6s ease-in-out left}.carousel-inner>.item>img,.carousel-inner>.item>a>img{display:block;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:40%;left:15px;width:40px;height:40px;margin-top:-20px;font-size:60px;font-weight:100;line-height:30px;color:#fff;text-align:center;background:#222;border:3px solid #fff;-webkit-border-radius:23px;-moz-border-radius:23px;border-radius:23px;opacity:.5;filter:alpha(opacity=50)}.carousel-control.right{right:15px;left:auto}.carousel-control:hover,.carousel-control:focus{color:#fff;text-decoration:none;opacity:.9;filter:alpha(opacity=90)}.carousel-indicators{position:absolute;top:15px;right:15px;z-index:5;margin:0;list-style:none}.carousel-indicators li{display:block;float:left;width:10px;height:10px;margin-left:5px;text-indent:-999px;background-color:#ccc;background-color:rgba(255,255,255,0.25);border-radius:5px}.carousel-indicators .active{background-color:#fff}.carousel-caption{position:absolute;right:0;bottom:0;left:0;padding:15px;background:#333;background:rgba(0,0,0,0.75)}.carousel-caption h4,.carousel-caption p{line-height:20px;color:#fff}.carousel-caption h4{margin:0 0 5px}.carousel-caption p{margin-bottom:0}.hero-unit{padding:60px;margin-bottom:30px;font-size:18px;font-weight:200;line-height:30px;color:inherit;background-color:#eee;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.hero-unit h1{margin-bottom:0;font-size:60px;line-height:1;letter-spacing:-1px;color:inherit}.hero-unit li{line-height:30px}.pull-right{float:right}.pull-left{float:left}.hide{display:none}.show{display:block}.invisible{visibility:hidden}.affix{position:fixed} diff --git a/docs/theme/docker/static/css/main.css b/docs/theme/docker/static/css/main.css deleted file mode 100755 index ce4ba7b869..0000000000 --- a/docs/theme/docker/static/css/main.css +++ /dev/null @@ -1,477 +0,0 @@ -.debug { - border: 2px dotted red !important; - box-sizing: border-box; - -moz-box-sizing: border-box; -} -body { - min-width: 940px; - font-family: "Cabin", "Helvetica Neue", Helvetica, Arial, sans-serif; -} -p a { - text-decoration: underline; -} -p a.btn { - text-decoration: none; -} -.brand.logo a { - text-decoration: none; -} -.navbar .navbar-inner { - padding-left: 0px; - padding-right: 0px; -} -.navbar .nav li a { - padding: 24.2857142855px 17px 24.2857142855px; - color: #777777; - text-decoration: none; - text-shadow: 0 1px 0 #f2f2f2; -} -.navbar .nav > li { - float: left; -} -.nav-underline { - height: 6px; - background-color: #71afc0; -} -.nav-login li a { - color: white; - padding: 10px 15px 10px; -} -.navbar .brand { - margin-left: 0px; - float: left; - display: block; -} -.navbar-inner { - min-height: 70px; - padding-left: 20px; - padding-right: 20px; - background-color: #ededed; - background-image: -moz-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#f2f2f2), to(#e5e5e5)); - background-image: -webkit-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -o-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: linear-gradient(to bottom, #f2f2f2, #e5e5e5); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2', endColorstr='#ffe5e5e5', GradientType=0); - border: 1px solid #c7c7c7; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - -webkit-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - -moz-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); -} -.brand-logo a { - color: white; -} -.brand-logo a img { - width: auto; -} -.inline-icon { - margin-bottom: 6px; -} -.row { - margin-top: 15px; - margin-bottom: 15px; -} -div[class*='span'] { - -moz-box-sizing: border-box; - box-sizing: border-box; -} -.box { - padding: 30px; - background-color: white; - margin-top: 8px; -} -.paper { - background-color: white; - padding-top: 30px; - padding-bottom: 30px; -} -.copy-headline { - margin-top: 0px; -} -.box h1, -.box h2, -.box h3, -.box h4 { - margin-top: -5px; -} -.nested { - padding: 30px; -} -.box.div { - padding: 30px; -} -span.read-more { - margin-left: 15px; - white-space: nowrap; -} -.forcetopalign { - margin-top: 15px !important; -} -.forcetopmargin { - margin-top: 23px !important; -} -.forceleftalign { - margin-left: 15px !important; -} -.forceleftmargin { - margin-left: 21px !important; -} -.textcenter { - text-align: center; -} -.textright { - text-align: right; -} -.textsmaller { - font-size: 12px; -} -.modal-backdrop { - opacity: 0.4; -} -/* generic page copy styles */ -.copy-headline h1 { - font-size: 21px; -} -/* ======================= - Sticky footer -======================= */ -html, -body { - height: 100%; - /* The html and body elements cannot have any padding or margin. */ - -} -/* Wrapper for page content to push down footer */ -#wrap { - min-height: 100%; - height: auto !important; - height: 100%; - /* Negative indent footer by it's height */ - - margin: 0 auto -280px; -} -/* Set the fixed height of the footer here */ -#push-the-footer, -#footer { - height: 280px; -} -.main-row { - padding-top: 50px; -} -#footer .footer { - margin-top: 160px; -} -#footer .footer .ligaturesymbols { - font-size: 30px; - color: black; -} -#footer .footer .ligaturesymbols a { - color: black; -} -#footer .footer .footerlist h3, -#footer .footer .footerlist h4 { - /* correct the top alignment */ - - margin-top: 0px; -} -.footer-landscape-image { - position: absolute: - bottom: 0; - margin-bottom: 0; - background-image: url('https://www.docker.io/static/img/website-footer_clean.svg'); - background-repeat: repeat-x; - height: 280px; -} -.main-row { - margin-top: 40px; -} -.sidebar { - width: 215px; - float: left; -} -.main-content { - padding: 16px 18px inherit; - margin-left: 230px; - /* space for sidebar */ - -} -/* ======================= - Social footer -======================= */ -.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; -} -form table th { - vertical-align: top; - text-align: right; - white-space: nowrap; -} -form .labeldd label { - font-weight: bold; -} -form .helptext { - font-size: 12px; - margin-top: -4px; - margin-bottom: 10px; -} -form .fielddd input { - width: 250px; -} -form .error { - color: #a30000; -} -div.alert.alert-block { - margin-bottom: 15px; -} -/* ======================= ======================= - Documentation -========================= ========================= */ -/* ======================= - Styles for the sidebar -========================= */ -.page-title { - background-color: white; - border: 1px solid transparent; - text-align: center; - width: 100%; -} -.page-title h4 { - font-size: 20px; -} -.bs-docs-sidebar { - padding-left: 5px; - max-width: 100%; - box-sizing: border-box; - -moz-box-sizing: border-box; - margin-top: 18px; -} -.bs-docs-sidebar ul { - list-style: none; - margin-left: 0px; -} -.bs-docs-sidebar .toctree-l2 > ul { - width: 100%; -} -.bs-docs-sidebar ul > li.toctree-l1.has-children { - background-image: url('../img/menu_arrow_right.gif'); - background-repeat: no-repeat; - background-position: 13px 13px; - list-style-type: none; - padding: 0px 0px 0px 0px; - vertical-align: middle; -} -.bs-docs-sidebar ul > li.toctree-l1.has-children.open { - background-image: url('../img/menu_arrow_down.gif'); -} -.bs-docs-sidebar ul > li > a { - box-sizing: border-box; - -moz-box-sizing: border-box; - width: 100%; - display: inline-block; - padding-top: 8px; - padding-bottom: 8px; - padding-left: 35px; - padding-right: 20px; - font-size: 14px; - border-bottom: 1.5px solid #595959; - line-height: 20px; -} -.bs-docs-sidebar ul > li:first-child.active > a { - border-top: 1.5px solid #595959; -} -.bs-docs-sidebar ul > li:last-child > a { - border-bottom: none; -} -.bs-docs-sidebar ul > li:last-child.active > a { - border-bottom: 1.5px solid #595959; -} -.bs-docs-sidebar ul > li.active > a { - border-right: 1.5px solid #595959; - border-left: 1.5px solid #595959; - color: #394d54; -} -.bs-docs-sidebar ul > li:hover { - background-color: #e8e8e8; -} -.bs-docs-sidebar.toctree-l3 ul { - display: inherit; - margin-left: 15px; - font-size: smaller; -} -.bs-docs-sidebar .toctree-l3 a { - border: none; - font-size: 12px; - line-height: 15px; -} -.bs-docs-sidebar ul > li > ul { - display: none; -} -.bs-docs-sidebar ul > li.current > ul { - display: inline-block; - padding-left: 0px; - width: 100%; -} -.toctree-l2.current > a { - font-weight: bold; -} -.toctree-l2.current { - border: 1.5px solid #595959; - color: #394d54; -} -/* ===================================== - Styles for the floating version widget -====================================== */ -.version-flyer { - position: fixed; - float: right; - right: 0; - bottom: 40px; - background-color: #E0E0E0; - border: 1px solid #88BABC; - padding: 5px; - font-size: larger; - max-width: 300px; -} -.version-flyer .content { - padding-right: 45px; - margin-top: 7px; - margin-left: 7px; - background-image: url('../img/container3.png'); - background-position: right center; - background-repeat: no-repeat; -} -.version-flyer .active-slug { - visibility: visible; - display: inline-block; - font-weight: bolder; -} -.version-flyer:hover .alternative { - animation-duration: 1s; - display: inline-block; -} -.version-flyer .version-note { - font-size: 16px; - color: black; -} -/* ===================================== - Styles for -====================================== */ -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} -.headerlink { - font-size: smaller; - color: #666; - font-weight: bold; - float: right; - visibility: hidden; -} -h2, h3, h4, h5, h6 { - margin-top: 0.7em; -} -/* ===================================== - Miscellaneous information -====================================== */ -.admonition.warning, -.admonition.note, -.admonition.seealso, -.admonition.todo { - border: 3px solid black; - padding: 10px; - margin: 5px auto 10px; -} -.admonition .admonition-title { - font-size: larger; -} -.admonition.warning, -.admonition.danger { - border-color: #ac0004; -} -.admonition.note { - border-color: #cbc200; -} -.admonition.todo { - border-color: orange; -} -.admonition.seealso { - border-color: #23cb1f; -} -/* Add styles for other types of comments */ -.versionchanged, -.versionadded, -.versionmodified, -.deprecated { - font-size: larger; - font-weight: bold; -} -.versionchanged { - color: lightseagreen; -} -.versionadded { - color: mediumblue; -} -.deprecated { - color: orangered; -} diff --git a/docs/theme/docker/static/css/main.less b/docs/theme/docker/static/css/main.less deleted file mode 100644 index e248e21c08..0000000000 --- a/docs/theme/docker/static/css/main.less +++ /dev/null @@ -1,691 +0,0 @@ -// Main CSS configuration file -// by Thatcher Peskens, thatcher@dotcloud.com -// -// Please note variables.less is customized to include custom font, background-color, and link colors. - - -@import "variables.less"; - -// Variables for main.less -// ----------------------- - -@box-top-margin: 8px; -@box-padding-size: 30px; -@docker-background-color: #71AFC0; -@very-dark-sea-green: #394D54; - -// Custom colors for Docker -// -------------------------- -@gray-super-light: #F2F2F2; -@deep-red: #A30000; -@deep-blue: #1B2033; -@deep-green: #007035; -@link-blue: #213B8F; - - -.debug { - border: 2px dotted red !important; - box-sizing: border-box; - -moz-box-sizing: border-box; -} - - -// Other custom colors for Docker -// -------------------------- - -// ** are defined in sources/less/variables ** -//@import "bootstrap/variables.less"; - - -// Styles generic for each and every page -// ----------------------------------- // ----------------------------------- - - -// moving body down to make place for fixed navigation -body { - min-width: 940px; - font-family: @font-family-base; - -} - - -p a { - text-decoration: underline; - - &.btn { - text-decoration: none; - } - -} - -.brand.logo a { - text-decoration: none; -} - -// Styles for top navigation -// ---------------------------------- -.navbar .navbar-inner { - padding-left: 0px; - padding-right: 0px; -} - -.navbar .nav { - li a { - padding: ((@navbar-height - @line-height-base) / 2) 17px ((@navbar-height - @line-height-base) / 2); - color: #777777; - text-decoration: none; - text-shadow: 0 1px 0 #f2f2f2; - } -} - - -.navbar .nav > li { - float: left; -} - -.nav-underline { - height: 6px; - background-color: @docker-background-color; -} - -.nav-login { - li { - a { - color: white; - padding: 10px 15px 10px; - } - } -} - - -.navbar .brand { - margin-left: 0px; - float: left; - display: block; -} - -.navbar-inner { - min-height: 70px; - padding-left: 20px; - padding-right: 20px; - background-color: #ededed; - background-image: -moz-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#f2f2f2), to(#e5e5e5)); - background-image: -webkit-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: -o-linear-gradient(top, #f2f2f2, #e5e5e5); - background-image: linear-gradient(to bottom, #f2f2f2, #e5e5e5); - background-repeat: repeat-x; - filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2', endColorstr='#ffe5e5e5', GradientType=0); - border: 1px solid #c7c7c7; - -webkit-border-radius: 4px; - -moz-border-radius: 4px; - border-radius: 4px; - -webkit-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - -moz-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); - box-shadow: 0 1px 4px rgba(0, 0, 0, 0.065); -} - -.brand-logo a { - color: white; - img { - width: auto; - } -} - -.logo { -// background-color: #A30000; -// color: white; -} - -.inline-icon { - margin-bottom: 6px; -} - -// Bootstrap elements -// ---------------------------------- - -.row { - margin-top: 15px; - margin-bottom: 15px; -} - -.container { - // background-color: green; -} - -// Styles on blocks of content -// ---------------------------------- - -// everything which is a block should have box-sizing: border-box; - -div[class*='span'] -{ - -moz-box-sizing: border-box; - box-sizing: border-box; -} - - -// Box for making white with a border, and some nice spacings -.box { - padding: @box-padding-size; - background-color: white; - margin-top: @box-top-margin; -} - -.paper { - background-color: white; - padding-top: 30px; - padding-bottom: 30px; -} - -.copy-headline { - margin-top: 0px; -// border-bottom: 1.2px solid @veryDarkSeaGreen; -} - -.box { - h1, h2, h3, h4 { - margin-top: -5px; - } -} - -.nested { - padding: @box-padding-size; -} - -.box.div { - padding: @box-padding-size; -} - -span.read-more { - margin-left: 15px; - white-space: nowrap; -} - - -// set a top margin of @box-top-margin + 8 px to make it show a margin -//instead of the div being flush against the side. Typically only -// required for a stacked div in a column, w.o. using row. -.forcetopalign { - margin-top: 15px !important; -} -.forcetopmargin { - margin-top: 23px !important; -} -.forceleftalign { - margin-left: 15px !important; -} -.forceleftmargin { - margin-left: 21px !important; -} - - -// simple text aligns -.textcenter { - text-align: center; -} - -.textright { - text-align: right; -} - -.textsmaller { - font-size: @font-size-small; -} - -.modal-backdrop { - opacity: 0.4; -} - - -/* generic page copy styles */ - -.copy-headline h1 { - font-size: 21px; -} - - -/* ======================= - Sticky footer -======================= */ - -@sticky-footer-height: 280px; - -html, -body { - height: 100%; - /* The html and body elements cannot have any padding or margin. */ -} - -/* Wrapper for page content to push down footer */ -#wrap { - min-height: 100%; - height: auto !important; - height: 100%; - /* Negative indent footer by it's height */ - margin: 0 auto -@sticky-footer-height; -} - -/* Set the fixed height of the footer here */ -#push-the-footer, -#footer { - height: @sticky-footer-height; -} - -#footer { -// margin-bottom: -60px; -// margin-top: 160px; -} - -.main-row { - padding-top: @navbar-height; -} - - -// Styles on the footer -// ---------------------------------- - -// -#footer .footer { - margin-top: 160px; - .ligaturesymbols { - font-size: 30px; - color: black; - a { - color: black; - } - } - - .footerlist { - h3, h4 { - /* correct the top alignment */ - margin-top: 0px; - } - } - -} - -.footer-landscape-image { - position: absolute: - bottom: 0; - margin-bottom: 0; - background-image: url('https://www.docker.io/static/img/website-footer_clean.svg'); - background-repeat: repeat-x; - height: @sticky-footer-height; -} - -.main-row { - margin-top: 40px; -} - -.sidebar { - width: 215px; - float: left; -} - -.main-content { - padding: 16px 18px inherit; - margin-left: 230px; /* space for sidebar */ -} - - - -/* ======================= - Social footer -======================= */ - -.social { - margin-left: 0px; - margin-top: 15px; -} - -.social { - .twitter, .github, .googleplus, .facebook, .slideshare, .linkedin, .flickr, .youtube, .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; -} - - - -// Styles on the forms -// ---------------------------------- - -form table { - th { - vertical-align: top; - text-align: right; - white-space: nowrap; - } -} - -form { - .labeldd label { - font-weight: bold; - } - - .helptext { - font-size: @font-size-small; - margin-top: -4px; - margin-bottom: 10px; - } - - .fielddd input { - width: 250px; - } - - .error { - color: @deep-red; - } - - [type=submit] { -// margin-top: -8px; - } -} - -div.alert.alert-block { - margin-bottom: 15px; -} - -/* ======================= ======================= - Documentation -========================= ========================= */ - - -/* ======================= - Styles for the sidebar -========================= */ - - -@sidebar-navigation-border: 1.5px solid #595959; -@sidebar-navigation-width: 225px; - - -.page-title { - // border-bottom: 1px solid #bbbbbb; - background-color: white; - border: 1px solid transparent; - text-align: center; - width: 100%; - h4 { - font-size: 20px; - } -} - -.bs-docs-sidebar { - padding-left: 5px; - max-width: 100%; - box-sizing: border-box; - -moz-box-sizing: border-box; - margin-top: 18px; - - ul { - list-style: none; - margin-left: 0px; - } - - .toctree-l2 > ul { - width: 100%; - } - - ul > li { - &.toctree-l1.has-children { - background-image: url('../img/menu_arrow_right.gif'); - background-repeat: no-repeat; - background-position: 13px 13px; - list-style-type: none; - // margin-left: px; - padding: 0px 0px 0px 0px; - vertical-align: middle; - - &.open { - background-image: url('../img/menu_arrow_down.gif'); - } - } - - & > a { - box-sizing: border-box; - -moz-box-sizing: border-box; - width: 100%; - display:inline-block; - padding-top: 8px; - padding-bottom: 8px; - padding-left: 35px; - padding-right: 20px; - font-size: @font-size-base; - border-bottom: @sidebar-navigation-border; - line-height: 20px; - } - - &:first-child.active > a { - border-top: @sidebar-navigation-border; - } - - &:last-child > a { - border-bottom: none; - } - - &:last-child.active > a { - border-bottom: @sidebar-navigation-border; - } - - &.active > a { - border-right: @sidebar-navigation-border; - border-left: @sidebar-navigation-border; - color: @very-dark-sea-green; - } - - &:hover { - background-color: #e8e8e8; - } - } - - &.toctree-l3 ul { - display: inherit; - - margin-left: 15px; - font-size: smaller; - } - - .toctree-l3 a { - border: none; - font-size: 12px; - line-height: 15px; - } - - ul > li > ul { - display: none; - } - - ul > li.current > ul { - display: inline-block; - padding-left: 0px; - width: 100%; - } -} - -.toctree-l2 { - &.current > a { - font-weight: bold; - } - &.current { - border: 1.5px solid #595959; - color: #394d54; - } -} - - -/* ===================================== - Styles for the floating version widget -====================================== */ - -.version-flyer { - position: fixed; - float: right; - right: 0; - bottom: 40px; - background-color: #E0E0E0; - border: 1px solid #88BABC; - padding: 5px; - font-size: larger; - max-width: 300px; - - .content { - padding-right: 45px; - margin-top: 7px; - margin-left: 7px; - background-image: url('../img/container3.png'); - background-position: right center; - background-repeat: no-repeat; - } - - .alternative { - } - - .active-slug { - visibility: visible; - display: inline-block; - font-weight: bolder; - } - - &:hover .alternative { - animation-duration: 1s; - display: inline-block; - } - - .version-note { - font-size: 16px; - color: black; - } - -} - -/* ===================================== - Styles for -====================================== */ - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -.headerlink { - font-size: smaller; - color: #666; - font-weight: bold; - float: right; - visibility: hidden; -} - -h2, h3, h4, h5, h6 { - margin-top: 0.7em; -} - -/* ===================================== - Miscellaneous information -====================================== */ - -.admonition { - &.warning, &.note, &.seealso, &.todo { - border: 3px solid black; - padding: 10px; - margin: 5px auto 10px; - } - - .admonition-title { - font-size: larger; - } - - &.warning, &.danger { - border-color: #ac0004; - } - - &.note { - border-color: #cbc200; - } - - &.todo { - border-color: orange; - } - - &.seealso { - border-color: #23cb1f; - } - -} - -/* Add styles for other types of comments */ - -.versionchanged, -.versionadded, -.versionmodified, -.deprecated { - font-size: larger; - font-weight: bold; -} - -.versionchanged { - color: lightseagreen; -} - -.versionadded { - color: mediumblue; -} - -.deprecated { - color: orangered; -} diff --git a/docs/theme/docker/static/css/variables.css b/docs/theme/docker/static/css/variables.css deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/docs/theme/docker/static/css/variables.less b/docs/theme/docker/static/css/variables.less deleted file mode 100644 index cc1d764364..0000000000 --- a/docs/theme/docker/static/css/variables.less +++ /dev/null @@ -1,622 +0,0 @@ -// -// Variables -// -------------------------------------------------- - - -// Global values -// -------------------------------------------------- - - -// Grays -// ------------------------- - -@gray-darker: lighten(#000, 13.5%); // #222 -@gray-dark: lighten(#000, 20%); // #333 -@gray: lighten(#000, 33.5%); // #555 -@gray-light: lighten(#000, 60%); // #999 -@gray-lighter: lighten(#000, 93.5%); // #eee - -// Brand colors -// ------------------------- - -@brand-primary: #428bca; -@brand-success: #5cb85c; -@brand-warning: #f0ad4e; -@brand-danger: #d9534f; -@brand-info: #5bc0de; - -// Scaffolding -// ------------------------- - -@body-bg: #fff; -@text-color: @gray-dark; - -// Links -// ------------------------- - -@link-color: @brand-primary; -@link-hover-color: darken(@link-color, 15%); - -// Typography -// ------------------------- - -@font-family-sans-serif: "Cabin", "Helvetica Neue", Helvetica, Arial, sans-serif; -@font-family-serif: Georgia, "Times New Roman", Times, serif; -@font-family-monospace: Monaco, Menlo, Consolas, "Courier New", monospace; -@font-family-base: @font-family-sans-serif; - -@font-size-base: 14px; -@font-size-large: ceil(@font-size-base * 1.25); // ~18px -@font-size-small: ceil(@font-size-base * 0.85); // ~12px - -@line-height-base: 1.428571429; // 20/14 -@line-height-computed: floor(@font-size-base * @line-height-base); // ~20px - -@headings-font-family: @font-family-base; -@headings-font-weight: 500; -@headings-line-height: 1.1; - -// Iconography -// ------------------------- - -@icon-font-path: "../fonts/"; -@icon-font-name: "glyphicons-halflings-regular"; - - -// Components -// ------------------------- -// Based on 14px font-size and 1.428 line-height (~20px to start) - -@padding-base-vertical: 6px; -@padding-base-horizontal: 12px; - -@padding-large-vertical: 10px; -@padding-large-horizontal: 16px; - -@padding-small-vertical: 5px; -@padding-small-horizontal: 10px; - -@line-height-large: 1.33; -@line-height-small: 1.5; - -@border-radius-base: 4px; -@border-radius-large: 6px; -@border-radius-small: 3px; - -@component-active-bg: @brand-primary; - -@caret-width-base: 4px; -@caret-width-large: 5px; - -// Tables -// ------------------------- - -@table-cell-padding: 8px; -@table-condensed-cell-padding: 5px; - -@table-bg: transparent; // overall background-color -@table-bg-accent: #f9f9f9; // for striping -@table-bg-hover: #f5f5f5; -@table-bg-active: @table-bg-hover; - -@table-border-color: #ddd; // table and cell border - - -// Buttons -// ------------------------- - -@btn-font-weight: normal; - -@btn-default-color: #333; -@btn-default-bg: #fff; -@btn-default-border: #ccc; - -@btn-primary-color: #fff; -@btn-primary-bg: @brand-primary; -@btn-primary-border: darken(@btn-primary-bg, 5%); - -@btn-success-color: #fff; -@btn-success-bg: @brand-success; -@btn-success-border: darken(@btn-success-bg, 5%); - -@btn-warning-color: #fff; -@btn-warning-bg: @brand-warning; -@btn-warning-border: darken(@btn-warning-bg, 5%); - -@btn-danger-color: #fff; -@btn-danger-bg: @brand-danger; -@btn-danger-border: darken(@btn-danger-bg, 5%); - -@btn-info-color: #fff; -@btn-info-bg: @brand-info; -@btn-info-border: darken(@btn-info-bg, 5%); - -@btn-link-disabled-color: @gray-light; - - -// Forms -// ------------------------- - -@input-bg: #fff; -@input-bg-disabled: @gray-lighter; - -@input-color: @gray; -@input-border: #ccc; -@input-border-radius: @border-radius-base; -@input-border-focus: #66afe9; - -@input-color-placeholder: @gray-light; - -@input-height-base: (@line-height-computed + (@padding-base-vertical * 2) + 2); -@input-height-large: (floor(@font-size-large * @line-height-large) + (@padding-large-vertical * 2) + 2); -@input-height-small: (floor(@font-size-small * @line-height-small) + (@padding-small-vertical * 2) + 2); - -@legend-color: @gray-dark; -@legend-border-color: #e5e5e5; - -@input-group-addon-bg: @gray-lighter; -@input-group-addon-border-color: @input-border; - - -// Dropdowns -// ------------------------- - -@dropdown-bg: #fff; -@dropdown-border: rgba(0,0,0,.15); -@dropdown-fallback-border: #ccc; -@dropdown-divider-bg: #e5e5e5; - -@dropdown-link-active-color: #fff; -@dropdown-link-active-bg: @component-active-bg; - -@dropdown-link-color: @gray-dark; -@dropdown-link-hover-color: #fff; -@dropdown-link-hover-bg: @dropdown-link-active-bg; - -@dropdown-link-disabled-color: @gray-light; - -@dropdown-header-color: @gray-light; - -@dropdown-caret-color: #000; - - -// COMPONENT VARIABLES -// -------------------------------------------------- - - -// Z-index master list -// ------------------------- -// Used for a bird's eye view of components dependent on the z-axis -// Try to avoid customizing these :) - -@zindex-navbar: 1000; -@zindex-dropdown: 1000; -@zindex-popover: 1010; -@zindex-tooltip: 1030; -@zindex-navbar-fixed: 1030; -@zindex-modal-background: 1040; -@zindex-modal: 1050; - -// Media queries breakpoints -// -------------------------------------------------- - -// Extra small screen / phone -@screen-xs: 480px; -@screen-phone: @screen-xs; - -// Small screen / tablet -@screen-sm: 768px; -@screen-tablet: @screen-sm; - -// Medium screen / desktop -@screen-md: 992px; -@screen-desktop: @screen-md; - -// Large screen / wide desktop -@screen-lg: 1600px; -@screen-lg-desktop: @screen-lg; - -// So media queries don't overlap when required, provide a maximum -@screen-xs-max: (@screen-sm - 1); -@screen-sm-max: (@screen-md - 1); -@screen-md-max: (@screen-lg - 1); - - -// Grid system -// -------------------------------------------------- - -// Number of columns in the grid system -@grid-columns: 12; -// Padding, to be divided by two and applied to the left and right of all columns -@grid-gutter-width: 30px; -// Point at which the navbar stops collapsing -@grid-float-breakpoint: @screen-desktop; - - -// Navbar -// ------------------------- - - -// Basics of a navbar -@navbar-height: 50px; -@navbar-margin-bottom: @line-height-computed; -@navbar-default-color: #777; -@navbar-default-bg: #f8f8f8; -@navbar-default-border: darken(@navbar-default-bg, 6.5%); -@navbar-border-radius: @border-radius-base; -@navbar-padding-horizontal: floor(@grid-gutter-width / 2); -@navbar-padding-vertical: ((@navbar-height - @line-height-computed) / 2); - -// Navbar links -@navbar-default-link-color: #777; -@navbar-default-link-hover-color: #333; -@navbar-default-link-hover-bg: transparent; -@navbar-default-link-active-color: #555; -@navbar-default-link-active-bg: darken(@navbar-default-bg, 6.5%); -@navbar-default-link-disabled-color: #ccc; -@navbar-default-link-disabled-bg: transparent; - -// Navbar brand label -@navbar-default-brand-color: @navbar-default-link-color; -@navbar-default-brand-hover-color: darken(@navbar-default-link-color, 10%); -@navbar-default-brand-hover-bg: transparent; - -// Navbar toggle -@navbar-default-toggle-hover-bg: #ddd; -@navbar-default-toggle-icon-bar-bg: #ccc; -@navbar-default-toggle-border-color: #ddd; - - -// Inverted navbar -// -// Reset inverted navbar basics -@navbar-inverse-color: @gray-light; -@navbar-inverse-bg: #222; -@navbar-inverse-border: darken(@navbar-inverse-bg, 10%); - -// Inverted navbar links -@navbar-inverse-link-color: @gray-light; -@navbar-inverse-link-hover-color: #fff; -@navbar-inverse-link-hover-bg: transparent; -@navbar-inverse-link-active-color: @navbar-inverse-link-hover-color; -@navbar-inverse-link-active-bg: darken(@navbar-inverse-bg, 10%); -@navbar-inverse-link-disabled-color: #444; -@navbar-inverse-link-disabled-bg: transparent; - -// Inverted navbar brand label -@navbar-inverse-brand-color: @navbar-inverse-link-color; -@navbar-inverse-brand-hover-color: #fff; -@navbar-inverse-brand-hover-bg: transparent; - -// Inverted navbar search -// Normal navbar needs no special styles or vars -@navbar-inverse-search-bg: lighten(@navbar-inverse-bg, 25%); -@navbar-inverse-search-bg-focus: #fff; -@navbar-inverse-search-border: @navbar-inverse-bg; -@navbar-inverse-search-placeholder-color: #ccc; - -// Inverted navbar toggle -@navbar-inverse-toggle-hover-bg: #333; -@navbar-inverse-toggle-icon-bar-bg: #fff; -@navbar-inverse-toggle-border-color: #333; - - -// Navs -// ------------------------- - -@nav-link-padding: 10px 15px; -@nav-link-hover-bg: @gray-lighter; - -@nav-disabled-link-color: @gray-light; -@nav-disabled-link-hover-color: @gray-light; - -@nav-open-link-hover-color: #fff; -@nav-open-caret-border-color: #fff; - -// Tabs -@nav-tabs-border-color: #ddd; - -@nav-tabs-link-hover-border-color: @gray-lighter; - -@nav-tabs-active-link-hover-bg: @body-bg; -@nav-tabs-active-link-hover-color: @gray; -@nav-tabs-active-link-hover-border-color: #ddd; - -@nav-tabs-justified-link-border-color: #ddd; -@nav-tabs-justified-active-link-border-color: @body-bg; - -// Pills -@nav-pills-active-link-hover-bg: @component-active-bg; -@nav-pills-active-link-hover-color: #fff; - - -// Pagination -// ------------------------- - -@pagination-bg: #fff; -@pagination-border: #ddd; - -@pagination-hover-bg: @gray-lighter; - -@pagination-active-bg: @brand-primary; -@pagination-active-color: #fff; - -@pagination-disabled-color: @gray-light; - - -// Pager -// ------------------------- - -@pager-border-radius: 15px; -@pager-disabled-color: @gray-light; - - -// Jumbotron -// ------------------------- - -@jumbotron-padding: 30px; -@jumbotron-color: inherit; -@jumbotron-bg: @gray-lighter; - -@jumbotron-heading-color: inherit; - - -// Form states and alerts -// ------------------------- - -@state-warning-text: #c09853; -@state-warning-bg: #fcf8e3; -@state-warning-border: darken(spin(@state-warning-bg, -10), 3%); - -@state-danger-text: #b94a48; -@state-danger-bg: #f2dede; -@state-danger-border: darken(spin(@state-danger-bg, -10), 3%); - -@state-success-text: #468847; -@state-success-bg: #dff0d8; -@state-success-border: darken(spin(@state-success-bg, -10), 5%); - -@state-info-text: #3a87ad; -@state-info-bg: #d9edf7; -@state-info-border: darken(spin(@state-info-bg, -10), 7%); - - -// Tooltips -// ------------------------- -@tooltip-max-width: 200px; -@tooltip-color: #fff; -@tooltip-bg: #000; - -@tooltip-arrow-width: 5px; -@tooltip-arrow-color: @tooltip-bg; - - -// Popovers -// ------------------------- -@popover-bg: #fff; -@popover-max-width: 276px; -@popover-border-color: rgba(0,0,0,.2); -@popover-fallback-border-color: #ccc; - -@popover-title-bg: darken(@popover-bg, 3%); - -@popover-arrow-width: 10px; -@popover-arrow-color: #fff; - -@popover-arrow-outer-width: (@popover-arrow-width + 1); -@popover-arrow-outer-color: rgba(0,0,0,.25); -@popover-arrow-outer-fallback-color: #999; - - -// Labels -// ------------------------- - -@label-default-bg: @gray-light; -@label-primary-bg: @brand-primary; -@label-success-bg: @brand-success; -@label-info-bg: @brand-info; -@label-warning-bg: @brand-warning; -@label-danger-bg: @brand-danger; - -@label-color: #fff; -@label-link-hover-color: #fff; - - -// Modals -// ------------------------- -@modal-inner-padding: 20px; - -@modal-title-padding: 15px; -@modal-title-line-height: @line-height-base; - -@modal-content-bg: #fff; -@modal-content-border-color: rgba(0,0,0,.2); -@modal-content-fallback-border-color: #999; - -@modal-backdrop-bg: #000; -@modal-header-border-color: #e5e5e5; -@modal-footer-border-color: @modal-header-border-color; - - -// Alerts -// ------------------------- -@alert-padding: 15px; -@alert-border-radius: @border-radius-base; -@alert-link-font-weight: bold; - -@alert-success-bg: @state-success-bg; -@alert-success-text: @state-success-text; -@alert-success-border: @state-success-border; - -@alert-info-bg: @state-info-bg; -@alert-info-text: @state-info-text; -@alert-info-border: @state-info-border; - -@alert-warning-bg: @state-warning-bg; -@alert-warning-text: @state-warning-text; -@alert-warning-border: @state-warning-border; - -@alert-danger-bg: @state-danger-bg; -@alert-danger-text: @state-danger-text; -@alert-danger-border: @state-danger-border; - - -// Progress bars -// ------------------------- -@progress-bg: #f5f5f5; -@progress-bar-color: #fff; - -@progress-bar-bg: @brand-primary; -@progress-bar-success-bg: @brand-success; -@progress-bar-warning-bg: @brand-warning; -@progress-bar-danger-bg: @brand-danger; -@progress-bar-info-bg: @brand-info; - - -// List group -// ------------------------- -@list-group-bg: #fff; -@list-group-border: #ddd; -@list-group-border-radius: @border-radius-base; - -@list-group-hover-bg: #f5f5f5; -@list-group-active-color: #fff; -@list-group-active-bg: @component-active-bg; -@list-group-active-border: @list-group-active-bg; - -@list-group-link-color: #555; -@list-group-link-heading-color: #333; - - -// Panels -// ------------------------- -@panel-bg: #fff; -@panel-inner-border: #ddd; -@panel-border-radius: @border-radius-base; -@panel-footer-bg: #f5f5f5; - -@panel-default-text: @gray-dark; -@panel-default-border: #ddd; -@panel-default-heading-bg: #f5f5f5; - -@panel-primary-text: #fff; -@panel-primary-border: @brand-primary; -@panel-primary-heading-bg: @brand-primary; - -@panel-success-text: @state-success-text; -@panel-success-border: @state-success-border; -@panel-success-heading-bg: @state-success-bg; - -@panel-warning-text: @state-warning-text; -@panel-warning-border: @state-warning-border; -@panel-warning-heading-bg: @state-warning-bg; - -@panel-danger-text: @state-danger-text; -@panel-danger-border: @state-danger-border; -@panel-danger-heading-bg: @state-danger-bg; - -@panel-info-text: @state-info-text; -@panel-info-border: @state-info-border; -@panel-info-heading-bg: @state-info-bg; - - -// Thumbnails -// ------------------------- -@thumbnail-padding: 4px; -@thumbnail-bg: @body-bg; -@thumbnail-border: #ddd; -@thumbnail-border-radius: @border-radius-base; - -@thumbnail-caption-color: @text-color; -@thumbnail-caption-padding: 9px; - - -// Wells -// ------------------------- -@well-bg: #f5f5f5; - - -// Badges -// ------------------------- -@badge-color: #fff; -@badge-link-hover-color: #fff; -@badge-bg: @gray-light; - -@badge-active-color: @link-color; -@badge-active-bg: #fff; - -@badge-font-weight: bold; -@badge-line-height: 1; -@badge-border-radius: 10px; - - -// Breadcrumbs -// ------------------------- -@breadcrumb-bg: #f5f5f5; -@breadcrumb-color: #ccc; -@breadcrumb-active-color: @gray-light; - - -// Carousel -// ------------------------ - -@carousel-text-shadow: 0 1px 2px rgba(0,0,0,.6); - -@carousel-control-color: #fff; -@carousel-control-width: 15%; -@carousel-control-opacity: .5; -@carousel-control-font-size: 20px; - -@carousel-indicator-active-bg: #fff; -@carousel-indicator-border-color: #fff; - -@carousel-caption-color: #fff; - - -// Close -// ------------------------ -@close-color: #000; -@close-font-weight: bold; -@close-text-shadow: 0 1px 0 #fff; - - -// Code -// ------------------------ -@code-color: #c7254e; -@code-bg: #f9f2f4; - -@pre-bg: #f5f5f5; -@pre-color: @gray-dark; -@pre-border-color: #ccc; -@pre-scrollable-max-height: 340px; - -// Type -// ------------------------ -@text-muted: @gray-light; -@abbr-border-color: @gray-light; -@headings-small-color: @gray-light; -@blockquote-small-color: @gray-light; -@blockquote-border-color: @gray-lighter; -@page-header-border-color: @gray-lighter; - -// Miscellaneous -// ------------------------- - -// Hr border color -@hr-border: @gray-lighter; - -// Horizontal forms & lists -@component-offset-horizontal: 180px; - - -// Container sizes -// -------------------------------------------------- - -// Small screen / tablet -@container-tablet: ((720px + @grid-gutter-width)); - -// Medium screen / desktop -@container-desktop: ((940px + @grid-gutter-width)); - -// Large screen / wide desktop -@container-lg-desktop: ((1140px + @grid-gutter-width)); diff --git a/docs/theme/docker/static/favicon.png b/docs/theme/docker/static/favicon.png deleted file mode 100644 index ee01a5ee8a9ea542f17123ed9c587510a2e26aef..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 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 diff --git a/docs/theme/docker/static/img/container3.png b/docs/theme/docker/static/img/container3.png deleted file mode 100644 index 0e8b59f75daf8dfc2e3860d7f4eaa021684ab247..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 263 zcmeAS@N?(olHy`uVBq!ia0vp^av;pX1|+Qw)-3{3k|nMYCBgY=CFO}lsSJ)O`AMk? zp1FzXsX?iUDV2pMQ*D5XR(iTPhE&{2dUIpzbNj;#3~FtROgbKK*d6u=bUbaeVAR^i z&>`AzgQ0`9;Rmxoe8VQ*1zCCyM@1J%EMsGlxp3vc8OM(wo4L%Vv#ofV!0<$!X`}Ka zNAU%JoK$LC12(pv$Xbx}B1?~_BA`FYChOyhqs^C+el~83NHpndZ#~NH-duI%QDC>b zu3SO46&(FECl7_>ZA$qv?x_(tj(Yzw{`td(R?}z%XsUVSGS<<{Y4-89ZJ6 KT-G@yGywpIYhvU8 diff --git a/docs/theme/docker/static/img/docker-letters-logo.gif b/docs/theme/docker/static/img/docker-letters-logo.gif deleted file mode 100644 index b394ae4eccd7f6ed90586dc152546a872b163c1b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7287 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 RQHxvTVi&#m#UTa+06X*r`HTPn diff --git a/docs/theme/docker/static/img/docker-top-logo.png b/docs/theme/docker/static/img/docker-top-logo.png deleted file mode 100644 index 4955f499bdc39daa24c3e6b779283e113eeaf1ce..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3426 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 GVgC=t-J44Q diff --git a/docs/theme/docker/static/img/docs-splash-colhead320.png b/docs/theme/docker/static/img/docs-splash-colhead320.png deleted file mode 100755 index 2f6d1b693d5e909c2e3fe0dec48c4be88ad68028..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1313 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 P00000NkvXXu0mjfh3RP# diff --git a/docs/theme/docker/static/img/fork-us.png b/docs/theme/docker/static/img/fork-us.png deleted file mode 100644 index efb749c1f98a6c3cee2a9c6fefdd2adc422c36cc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 380 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 B7G?kd diff --git a/docs/theme/docker/static/img/glyphicons-halflings.png b/docs/theme/docker/static/img/glyphicons-halflings.png deleted file mode 100755 index a9969993201f9cee63cf9f49217646347297b643..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 12799 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 diff --git a/docs/theme/docker/static/img/hiring_graphic.png b/docs/theme/docker/static/img/hiring_graphic.png deleted file mode 100644 index b3a6b996440f5366e5bde53f392b0759e87abe17..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6954 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 diff --git a/docs/theme/docker/static/img/menu_arrow_down.gif b/docs/theme/docker/static/img/menu_arrow_down.gif deleted file mode 100644 index 8257c3846ba839fdea9b07ad21e29062e9454b90..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2103 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 ul > li > a').not(':last').not(':first').click(function(){ - - var index = $.inArray(this.href, openmenus) - - if (index > -1) { - console.log(index); - openmenus.splice(index, 1); - - - $(this).parent().children('ul').slideUp(200, function() { - $(this).parent().removeClass('open'); // toggle after effect - }); - } - else { - openmenus.push(this.href); - - var current = $(this); - - setTimeout(function() { - // $('.sidebar > ul > li').removeClass('current'); - current.parent().addClass('current').addClass('open'); // toggle before effect - current.parent().children('ul').hide(); - current.parent().children('ul').slideDown(200); - }, 100); - } - return false; - }); - - // add class to all those which have children - $('.sidebar > ul > li').not(':last').not(':first').addClass('has-children'); - - - if (doc_version == "") { - $('.version-flyer ul').html('
  • Local
  • '); - } - - if (doc_version == "latest") { - $('.version-flyer .version-note').hide(); - } - - // mark the active documentation in the version widget - $(".version-flyer a:contains('" + doc_version + "')").parent().addClass('active-slug').setAttribute("title", "Current version"); - - - -}); \ No newline at end of file diff --git a/docs/theme/docker/theme.conf b/docs/theme/docker/theme.conf deleted file mode 100755 index 5843e97d70..0000000000 --- a/docs/theme/docker/theme.conf +++ /dev/null @@ -1,11 +0,0 @@ -[theme] -inherit = basic -pygments_style = monokai - -[options] -full_logo = true -textcolor = #444444 -headingcolor = #0c3762 -linkcolor = #8C7B65 -visitedlinkcolor = #AFA599 -hoverlinkcolor = #4e4334 From f87a97f7df838742a602f1984f4552b803e3f92d Mon Sep 17 00:00:00 2001 From: "O.S.Tezer" Date: Thu, 1 May 2014 17:13:34 +0300 Subject: [PATCH 357/436] Improve code/comment/output markings & display consistency This PR aims to increase the consistency across the docs for code blocks and code/comment/output markings. Rule followed here is "what's visible on the screen should be reflected" Issue: - Docs had various code blocks showing: comments, commands & outputs. - All three of these items were inconsistently marked. Some examples as to how this PR aims to introduce improvements: 1. Removed `> ` from in front of the "outputs". Eg, ` > REPOSITORY TAG ID CREATED` replaced with: ` REPOSITORY TAG ID CREATED`. 2. Introduced `$` for commands. Eg, ` sudo chkconfig docker on` replaced with: ` $ sudo chkconfig docker on` 3. Comments: ` > # ` replaced with: ` # `. > Please note: > Due to a vast amount of items reviewed and changed for this PR, there > might be some individually incorrect replacements OR patterns of incorrect > replacements. This PR needs to be reviewed and if there is anything missing, > it should be improved or amended. Closes: https://github.com/dotcloud/docker/issues/5286 Docker-DCO-1.1-Signed-off-by: O.S. Tezer (github: ostezer) --- docs/sources/articles/runmetrics.md | 23 +++-- docs/sources/contributing/devenvironment.md | 23 +++-- .../examples/cfengine_process_management.md | 2 +- docs/sources/examples/couchdb_data_volumes.md | 16 ++-- docs/sources/examples/hello_world.md | 12 +-- docs/sources/examples/mongodb.md | 12 +-- docs/sources/examples/nodejs_web_app.md | 48 +++++------ docs/sources/examples/postgresql_service.md | 8 +- .../sources/examples/running_redis_service.md | 24 +++--- docs/sources/examples/running_riak_service.md | 4 +- docs/sources/examples/using_supervisord.md | 4 +- docs/sources/installation/archlinux.md | 4 +- docs/sources/installation/binaries.md | 12 +-- docs/sources/installation/cruxlinux.md | 22 ++--- docs/sources/installation/fedora.md | 16 ++-- docs/sources/installation/frugalware.md | 4 +- docs/sources/installation/gentoolinux.md | 10 +-- docs/sources/installation/google.md | 10 +-- docs/sources/installation/mac.md | 44 +++++----- docs/sources/installation/openSUSE.md | 12 +-- docs/sources/installation/rackspace.md | 10 +-- docs/sources/installation/rhel.md | 10 +-- docs/sources/installation/ubuntulinux.md | 86 +++++++++---------- docs/sources/installation/windows.md | 2 +- .../introduction/working-with-docker.md | 36 ++++---- .../api/archive/docker_remote_api_v1.4.md | 2 +- .../api/archive/docker_remote_api_v1.5.md | 2 +- .../api/archive/docker_remote_api_v1.6.md | 2 +- .../api/archive/docker_remote_api_v1.7.md | 2 +- .../api/archive/docker_remote_api_v1.8.md | 2 +- .../reference/api/docker_remote_api_v1.10.md | 2 +- .../reference/api/docker_remote_api_v1.11.md | 2 +- .../reference/api/docker_remote_api_v1.9.md | 2 +- .../reference/api/registry_index_spec.md | 2 +- docs/sources/reference/builder.md | 4 +- docs/sources/reference/commandline/cli.md | 16 ++-- docs/sources/reference/run.md | 14 +-- .../sources/use/ambassador_pattern_linking.md | 2 +- docs/sources/use/basics.md | 52 +++++------ docs/sources/use/chef.md | 4 +- docs/sources/use/networking.md | 2 +- docs/sources/use/port_redirection.md | 32 +++---- docs/sources/use/puppet.md | 6 +- docs/sources/use/working_with_volumes.md | 6 +- docs/sources/use/workingwithrepository.md | 6 +- 45 files changed, 307 insertions(+), 309 deletions(-) diff --git a/docs/sources/articles/runmetrics.md b/docs/sources/articles/runmetrics.md index 4cc210bb52..50d46047c0 100644 --- a/docs/sources/articles/runmetrics.md +++ b/docs/sources/articles/runmetrics.md @@ -26,7 +26,7 @@ corresponding to existing containers. To figure out where your control groups are mounted, you can run: - grep cgroup /proc/mounts + $ grep cgroup /proc/mounts ## Enumerating Cgroups @@ -287,7 +287,7 @@ an interface) can do some serious accounting. For instance, you can setup a rule to account for the outbound HTTP traffic on a web server: - iptables -I OUTPUT -p tcp --sport 80 + $ iptables -I OUTPUT -p tcp --sport 80 There is no `-j` or `-g` flag, so the rule will just count matched packets and go to the following @@ -295,7 +295,7 @@ rule. Later, you can check the values of the counters, with: - iptables -nxvL OUTPUT + $ iptables -nxvL OUTPUT Technically, `-n` is not required, but it will prevent iptables from doing DNS reverse lookups, which are probably @@ -337,11 +337,11 @@ though. The exact format of the command is: - ip netns exec + $ ip netns exec For example: - ip netns exec mycontainer netstat -i + $ ip netns exec mycontainer netstat -i `ip netns` finds the "mycontainer" container by using namespaces pseudo-files. Each process belongs to one network @@ -369,14 +369,13 @@ measure network usage. From there, you can examine the pseudo-file named control group (i.e. in the container). Pick any one of them. Putting everything together, if the "short ID" of a container is held in -the environment variable `$CID`, then you can do -this: +the environment variable `$CID`, then you can do this: - TASKS=/sys/fs/cgroup/devices/$CID*/tasks - PID=$(head -n 1 $TASKS) - mkdir -p /var/run/netns - ln -sf /proc/$PID/ns/net /var/run/netns/$CID - ip netns exec $CID netstat -i + $ TASKS=/sys/fs/cgroup/devices/$CID*/tasks + $ PID=$(head -n 1 $TASKS) + $ mkdir -p /var/run/netns + $ ln -sf /proc/$PID/ns/net /var/run/netns/$CID + $ ip netns exec $CID netstat -i ## Tips for high-performance metric collection diff --git a/docs/sources/contributing/devenvironment.md b/docs/sources/contributing/devenvironment.md index f7c66274e8..bcefa00369 100644 --- a/docs/sources/contributing/devenvironment.md +++ b/docs/sources/contributing/devenvironment.md @@ -32,8 +32,8 @@ Again, you can do it in other ways but you need to do more work. ## Check out the Source - git clone http://git@github.com/dotcloud/docker - cd docker + $ git clone http://git@github.com/dotcloud/docker + $ cd docker To checkout a different revision just use `git checkout` with the name of branch or revision number. @@ -45,7 +45,7 @@ Dockerfile in the current directory. Essentially, it will install all the build and runtime dependencies necessary to build and test Docker. This command will take some time to complete when you first execute it. - sudo make build + $ sudo make build If the build is successful, congratulations! You have produced a clean build of docker, neatly encapsulated in a standard build environment. @@ -54,7 +54,7 @@ build of docker, neatly encapsulated in a standard build environment. To create the Docker binary, run this command: - sudo make binary + $ sudo make binary This will create the Docker binary in `./bundles/-dev/binary/` @@ -65,7 +65,7 @@ The binary is available outside the container in the directory host docker executable with this binary for live testing - for example, on ubuntu: - sudo service docker stop ; sudo cp $(which docker) $(which docker)_ ; sudo cp ./bundles/-dev/binary/docker--dev $(which docker);sudo service docker start + $ sudo service docker stop ; sudo cp $(which docker) $(which docker)_ ; sudo cp ./bundles/-dev/binary/docker--dev $(which docker);sudo service docker start > **Note**: > Its safer to run the tests below before swapping your hosts docker binary. @@ -74,7 +74,7 @@ on ubuntu: To execute the test cases, run this command: - sudo make test + $ sudo make test If the test are successful then the tail of the output should look something like this @@ -105,11 +105,10 @@ something like this PASS ok github.com/dotcloud/docker/utils 0.017s -If $TESTFLAGS is set in the environment, it is passed as extra -arguments to `go test`. You can use this to select certain tests to run, -eg. +If $TESTFLAGS is set in the environment, it is passed as extra arguments +to `go test`. You can use this to select certain tests to run, e.g. - TESTFLAGS=`-run \^TestBuild\$` make test + $ TESTFLAGS=`-run \^TestBuild\$` make test If the output indicates "FAIL" and you see errors like this: @@ -124,7 +123,7 @@ is recommended. You can run an interactive session in the newly built container: - sudo make shell + $ sudo make shell # type 'exit' or Ctrl-D to exit @@ -134,7 +133,7 @@ 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 by: - sudo make docs + $ sudo make docs # when its done, you can point your browser to http://yourdockerhost:8000 # type Ctrl-C to exit diff --git a/docs/sources/examples/cfengine_process_management.md b/docs/sources/examples/cfengine_process_management.md index 965ad252d2..0c7b6a8a1f 100644 --- a/docs/sources/examples/cfengine_process_management.md +++ b/docs/sources/examples/cfengine_process_management.md @@ -95,7 +95,7 @@ your container with the docker build command, e.g. Start the container with `apache2` and `sshd` running and managed, forwarding a port to our SSH instance: - docker run -p 127.0.0.1:222:22 -d managed_image "/usr/sbin/sshd" "/etc/init.d/apache2 start" + $ docker run -p 127.0.0.1:222:22 -d managed_image "/usr/sbin/sshd" "/etc/init.d/apache2 start" We now clearly see one of the benefits of the cfe-docker integration: it allows to start several processes as part of a normal `docker run` command. diff --git a/docs/sources/examples/couchdb_data_volumes.md b/docs/sources/examples/couchdb_data_volumes.md index 10abe7af02..17490487aa 100644 --- a/docs/sources/examples/couchdb_data_volumes.md +++ b/docs/sources/examples/couchdb_data_volumes.md @@ -20,28 +20,28 @@ different versions of CouchDB on the same data, etc. Note that we're marking `/var/lib/couchdb` as a data volume. - COUCH1=$(sudo docker run -d -p 5984 -v /var/lib/couchdb shykes/couchdb:2013-05-03) + $ COUCH1=$(sudo docker run -d -p 5984 -v /var/lib/couchdb shykes/couchdb:2013-05-03) ## Add data to the first database We're assuming your Docker host is reachable at `localhost`. If not, replace `localhost` with the public IP of your Docker host. - HOST=localhost - URL="http://$HOST:$(sudo docker port $COUCH1 5984 | grep -Po '\d+$')/_utils/" - echo "Navigate to $URL in your browser, and use the couch interface to add data" + $ HOST=localhost + $ URL="http://$HOST:$(sudo docker port $COUCH1 5984 | grep -Po '\d+$')/_utils/" + $ echo "Navigate to $URL in your browser, and use the couch interface to add data" ## Create second database This time, we're requesting shared access to `$COUCH1`'s volumes. - COUCH2=$(sudo docker run -d -p 5984 --volumes-from $COUCH1 shykes/couchdb:2013-05-03) + $ COUCH2=$(sudo docker run -d -p 5984 --volumes-from $COUCH1 shykes/couchdb:2013-05-03) ## Browse data on the second database - HOST=localhost - URL="http://$HOST:$(sudo docker port $COUCH2 5984 | grep -Po '\d+$')/_utils/" - echo "Navigate to $URL in your browser. You should see the same data as in the first database"'!' + $ HOST=localhost + $ URL="http://$HOST:$(sudo docker port $COUCH2 5984 | grep -Po '\d+$')/_utils/" + $ echo "Navigate to $URL in your browser. You should see the same data as in the first database"'!' Congratulations, you are now running two Couchdb containers, completely isolated from each other *except* for their data. diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md index ba573527c1..48f4a43102 100644 --- a/docs/sources/examples/hello_world.md +++ b/docs/sources/examples/hello_world.md @@ -80,7 +80,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. @@ -98,7 +98,7 @@ from the `ubuntu` image. - sudo docker logs $container_id + $ sudo docker logs $container_id Check the logs make sure it is working correctly. @@ -107,7 +107,7 @@ Check the logs make sure it is working correctly. - 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. @@ -120,7 +120,7 @@ Attach to the container to see the results in real-time. Exit from the container attachment by pressing Control-C. - sudo docker ps + $ sudo docker ps Check the process list to make sure it is running. @@ -128,7 +128,7 @@ 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. @@ -137,7 +137,7 @@ Stop the container, since we don't need it anymore. - sudo docker ps + $ sudo docker ps Make sure it is really stopped. diff --git a/docs/sources/examples/mongodb.md b/docs/sources/examples/mongodb.md index 36a5a58ad8..4b5f95d023 100644 --- a/docs/sources/examples/mongodb.md +++ b/docs/sources/examples/mongodb.md @@ -21,7 +21,7 @@ apt source and installs the database software on Ubuntu. Create an empty file called Dockerfile: - touch Dockerfile + $ touch Dockerfile Next, define the parent image you want to use to build your own image on top of. Here, we'll use [Ubuntu](https://index.docker.io/_/ubuntu/) @@ -69,21 +69,21 @@ container. Now, lets build the image which will go through the Dockerfile we made and run all of the commands. - sudo docker build -t /mongodb . + $ sudo docker build -t /mongodb . 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 -d /mongodb) # Lean and mean - MONGO_ID=$(sudo docker run -d /mongodb --noprealloc --smallfiles) + $ MONGO_ID=$(sudo docker run -d /mongodb --noprealloc --smallfiles) # Check the logs out - sudo docker logs $MONGO_ID + $ sudo docker logs $MONGO_ID # Connect and play around - mongo --port + $ mongo --port Sweet! diff --git a/docs/sources/examples/nodejs_web_app.md b/docs/sources/examples/nodejs_web_app.md index f7d63dadcf..bc0e908d2d 100644 --- a/docs/sources/examples/nodejs_web_app.md +++ b/docs/sources/examples/nodejs_web_app.md @@ -134,16 +134,16 @@ Go to the directory that has your `Dockerfile` and run the following command to build a Docker image. The `-t` flag let's you tag your image so it's easier to find later using the `docker images` command: - sudo docker build -t /centos-node-hello . + $ sudo docker build -t /centos-node-hello . Your image will now be listed by Docker: - sudo docker images + $ sudo docker images - > # Example - > REPOSITORY TAG ID CREATED - > centos 6.4 539c0211cd76 8 weeks ago - > gasi/centos-node-hello latest d64d3505b0d2 2 hours ago + # Example + REPOSITORY TAG ID CREATED + centos 6.4 539c0211cd76 8 weeks ago + gasi/centos-node-hello latest d64d3505b0d2 2 hours ago ## Run the image @@ -151,44 +151,44 @@ Running your image with `-d` runs the container in detached mode, leaving the container running in the background. The `-p` flag redirects a public port to a private port in the container. Run the image you previously built: - sudo docker run -p 49160:8080 -d /centos-node-hello + $ sudo docker run -p 49160:8080 -d /centos-node-hello Print the output of your app: # Get container ID - sudo docker ps + $ sudo docker ps # Print app output - sudo docker logs + $ sudo docker logs - > # Example - > Running on http://localhost:8080 + # Example + Running on http://localhost:8080 ## Test To test your app, get the the port of your app that Docker mapped: - sudo docker ps + $ sudo docker ps - > # Example - > ID IMAGE COMMAND ... PORTS - > ecce33b30ebf gasi/centos-node-hello:latest node /src/index.js 49160->8080 + # Example + ID IMAGE COMMAND ... PORTS + ecce33b30ebf gasi/centos-node-hello:latest node /src/index.js 49160->8080 In the example above, Docker mapped the `8080` port of the container to `49160`. Now you can call your app using `curl` (install if needed via: `sudo apt-get install curl`): - curl -i localhost:49160 + $ curl -i localhost:49160 - > HTTP/1.1 200 OK - > X-Powered-By: Express - > Content-Type: text/html; charset=utf-8 - > Content-Length: 12 - > Date: Sun, 02 Jun 2013 03:53:22 GMT - > Connection: keep-alive - > - > Hello World + HTTP/1.1 200 OK + X-Powered-By: Express + Content-Type: text/html; charset=utf-8 + Content-Length: 12 + Date: Sun, 02 Jun 2013 03:53:22 GMT + Connection: keep-alive + + Hello World We hope this tutorial helped you get up and running with Node.js and CentOS on Docker. You can get the full source code at diff --git a/docs/sources/examples/postgresql_service.md b/docs/sources/examples/postgresql_service.md index 1a10cd4415..14d9e647a3 100644 --- a/docs/sources/examples/postgresql_service.md +++ b/docs/sources/examples/postgresql_service.md @@ -125,14 +125,14 @@ prompt, you can create a table and populate it. psql (9.3.1) Type "help" for help. - docker=# CREATE TABLE cities ( + $ docker=# CREATE TABLE cities ( docker(# name varchar(80), docker(# location point docker(# ); CREATE TABLE - docker=# INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); + $ docker=# INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); INSERT 0 1 - docker=# select * from cities; + $ docker=# select * from cities; name | location ---------------+----------- San Francisco | (-194,53) @@ -143,7 +143,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/running_redis_service.md b/docs/sources/examples/running_redis_service.md index 2bfa8a05bc..ca67048625 100644 --- a/docs/sources/examples/running_redis_service.md +++ b/docs/sources/examples/running_redis_service.md @@ -29,7 +29,7 @@ image. Next we build an image from our `Dockerfile`. Replace `` with your own user name. - sudo docker build -t /redis . + $ sudo docker build -t /redis . ## Run the service @@ -42,7 +42,7 @@ Importantly, we're not exposing any ports on our container. Instead we're going to use a container link to provide access to our Redis database. - sudo docker run --name redis -d /redis + $ sudo docker run --name redis -d /redis ## Create your web application container @@ -52,19 +52,19 @@ created with an alias of `db`. This will create a secure tunnel to the `redis` container and expose the Redis instance running inside that container to only this container. - sudo docker run --link redis:db -i -t ubuntu:12.10 /bin/bash + $ sudo docker run --link redis:db -i -t ubuntu:12.10 /bin/bash Once inside our freshly created container we need to install Redis to get the `redis-cli` binary to test our connection. - apt-get update - apt-get -y install redis-server - service redis-server stop + $ apt-get update + $ apt-get -y install redis-server + $ service redis-server stop As we've used the `--link redis:db` option, Docker has created some environment variables in our web application container. - env | grep DB_ + $ env | grep DB_ # Should return something similar to this with your values DB_NAME=/violet_wolf/db @@ -79,13 +79,13 @@ with `DB`. The `DB` comes from the link alias specified when we launched the container. Let's use the `DB_PORT_6379_TCP_ADDR` variable to connect to our Redis container. - redis-cli -h $DB_PORT_6379_TCP_ADDR - redis 172.17.0.33:6379> - redis 172.17.0.33:6379> set docker awesome + $ redis-cli -h $DB_PORT_6379_TCP_ADDR + $ redis 172.17.0.33:6379> + $ redis 172.17.0.33:6379> set docker awesome OK - redis 172.17.0.33:6379> get docker + $ redis 172.17.0.33:6379> get docker "awesome" - redis 172.17.0.33:6379> exit + $ redis 172.17.0.33:6379> exit We could easily use this or other environment variables in our web application to make a connection to our `redis` diff --git a/docs/sources/examples/running_riak_service.md b/docs/sources/examples/running_riak_service.md index 61594f9cd8..852035f9a4 100644 --- a/docs/sources/examples/running_riak_service.md +++ b/docs/sources/examples/running_riak_service.md @@ -19,7 +19,7 @@ Riak pre-installed. Create an empty file called Dockerfile: - touch Dockerfile + $ touch Dockerfile Next, define the parent image you want to use to build your image on top of. We'll use [Ubuntu](https://index.docker.io/_/ubuntu/) (tag: @@ -126,7 +126,7 @@ Populate it with the following program definitions: Now you should be able to build a Docker image for Riak: - docker build -t "/riak" . + $ docker build -t "/riak" . ## Next steps diff --git a/docs/sources/examples/using_supervisord.md b/docs/sources/examples/using_supervisord.md index 8e85ae05d2..29d2fa4525 100644 --- a/docs/sources/examples/using_supervisord.md +++ b/docs/sources/examples/using_supervisord.md @@ -99,13 +99,13 @@ launches. We can now build our new container. - sudo docker build -t /supervisord . + $ sudo docker build -t /supervisord . ## Running our Supervisor container Once We've got a built image we can launch a container from it. - sudo docker run -p 22 -p 80 -t -i /supervisord + $ sudo docker run -p 22 -p 80 -t -i /supervisord 2013-11-25 18:53:22,312 CRIT Supervisor running as root (no user in config file) 2013-11-25 18:53:22,312 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing 2013-11-25 18:53:22,342 INFO supervisord started with pid 1 diff --git a/docs/sources/installation/archlinux.md b/docs/sources/installation/archlinux.md index 6e970b96f6..c6d4f73fb8 100644 --- a/docs/sources/installation/archlinux.md +++ b/docs/sources/installation/archlinux.md @@ -60,8 +60,8 @@ have not done so before. There is a systemd service unit created for docker. To start the docker service: - sudo systemctl start docker + $ sudo systemctl start docker To start on system boot: - sudo systemctl enable docker + $ sudo systemctl enable docker diff --git a/docs/sources/installation/binaries.md b/docs/sources/installation/binaries.md index b02c28828b..36aa0ae249 100644 --- a/docs/sources/installation/binaries.md +++ b/docs/sources/installation/binaries.md @@ -46,8 +46,8 @@ Linux kernel (it even builds on OSX!). ## Get the docker binary: - wget https://get.docker.io/builds/Linux/x86_64/docker-latest -O docker - chmod +x docker + $ wget https://get.docker.io/builds/Linux/x86_64/docker-latest -O docker + $ chmod +x docker > **Note**: > If you have trouble downloading the binary, you can also get the smaller @@ -58,7 +58,7 @@ Linux kernel (it even builds on OSX!). ## Run the docker daemon # start the docker in daemon mode from the directory you unpacked - sudo ./docker -d & + $ sudo ./docker -d & ## Giving non-root access @@ -87,16 +87,16 @@ all the client commands. To upgrade your manual installation of Docker, first kill the docker daemon: - killall docker + $ killall docker Then follow the regular installation steps. ## Run your first container! # check your docker version - sudo ./docker version + $ sudo ./docker version # run a container and open an interactive shell in the container - sudo ./docker run -i -t ubuntu /bin/bash + $ sudo ./docker run -i -t ubuntu /bin/bash Continue with the [*Hello World*](/examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/cruxlinux.md b/docs/sources/installation/cruxlinux.md index f37d720389..d1a4de7367 100644 --- a/docs/sources/installation/cruxlinux.md +++ b/docs/sources/installation/cruxlinux.md @@ -39,24 +39,24 @@ do so via: Download the `httpup` file to `/etc/ports/`: - curl -q -o - http://crux.nu/portdb/?a=getup&q=prologic > /etc/ports/prologic.httpup + $ curl -q -o - http://crux.nu/portdb/?a=getup&q=prologic > /etc/ports/prologic.httpup Add `prtdir /usr/ports/prologic` to `/etc/prt-get.conf`: - vim /etc/prt-get.conf + $ vim /etc/prt-get.conf # or: - echo "prtdir /usr/ports/prologic" >> /etc/prt-get.conf + $ echo "prtdir /usr/ports/prologic" >> /etc/prt-get.conf Update ports and prt-get cache: - ports -u - prt-get cache + $ ports -u + $ prt-get cache To install (*and its dependencies*): - prt-get depinst docker + $ prt-get depinst docker Use `docker-bin` for the upstream binary or `docker-git` to build and install from the master @@ -70,20 +70,20 @@ and Docker Daemon to work properly. Please read the `README.rst`: - prt-get readme docker + $ prt-get readme docker There is a `test_kernel_config.sh` script in the above ports which you can use to test your Kernel configuration: - cd /usr/ports/prologic/docker - ./test_kernel_config.sh /usr/src/linux/.config + $ cd /usr/ports/prologic/docker + $ ./test_kernel_config.sh /usr/src/linux/.config ## Starting Docker There is a rc script created for Docker. To start the Docker service: - sudo su - - /etc/rc.d/docker start + $ sudo su - + $ /etc/rc.d/docker start To start on system boot: diff --git a/docs/sources/installation/fedora.md b/docs/sources/installation/fedora.md index 70d8c1462e..93b5b05b13 100644 --- a/docs/sources/installation/fedora.md +++ b/docs/sources/installation/fedora.md @@ -30,35 +30,35 @@ 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. - sudo yum -y remove docker + $ 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`. - sudo yum -y install wmdocker - sudo yum -y remove docker + $ sudo yum -y install wmdocker + $ sudo yum -y remove docker Install the `docker-io` package which will install Docker on our host. - sudo yum -y install docker-io + $ sudo yum -y install docker-io To update the `docker-io` package: - sudo yum -y update docker-io + $ sudo yum -y update docker-io Now that it's installed, let's start the Docker daemon. - sudo systemctl start docker + $ sudo systemctl start docker If we want Docker to start at boot, we should also: - sudo systemctl enable docker + $ sudo systemctl enable docker Now let's verify that Docker is working. - sudo docker run -i -t fedora /bin/bash + $ sudo docker run -i -t fedora /bin/bash **Done!**, now continue with the [*Hello World*](/examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/frugalware.md b/docs/sources/installation/frugalware.md index 1d640cf8fd..eb409d8d39 100644 --- a/docs/sources/installation/frugalware.md +++ b/docs/sources/installation/frugalware.md @@ -49,8 +49,8 @@ is all that is needed. There is a systemd service unit created for Docker. To start Docker as service: - sudo systemctl start lxc-docker + $ sudo systemctl start lxc-docker To start on system boot: - sudo systemctl enable lxc-docker + $ sudo systemctl enable lxc-docker diff --git a/docs/sources/installation/gentoolinux.md b/docs/sources/installation/gentoolinux.md index 49700ea563..92329dca90 100644 --- a/docs/sources/installation/gentoolinux.md +++ b/docs/sources/installation/gentoolinux.md @@ -43,7 +43,7 @@ use flags to pull in the proper dependencies of the major storage drivers, with the "device-mapper" use flag being enabled by default, since that is the simplest installation path. - sudo emerge -av app-emulation/docker + $ sudo emerge -av app-emulation/docker If any issues arise from this ebuild or the resulting binary, including and especially missing kernel configuration flags and/or dependencies, @@ -61,18 +61,18 @@ and/or AUFS, depending on the storage driver you`ve decided to use). To start the docker daemon: - sudo /etc/init.d/docker start + $ sudo /etc/init.d/docker start To start on system boot: - sudo rc-update add docker default + $ sudo rc-update add docker default ### systemd To start the docker daemon: - sudo systemctl start docker.service + $ sudo systemctl start docker.service To start on system boot: - sudo systemctl enable docker.service + $ sudo systemctl enable docker.service diff --git a/docs/sources/installation/google.md b/docs/sources/installation/google.md index bec7d0ba13..4c22808dcb 100644 --- a/docs/sources/installation/google.md +++ b/docs/sources/installation/google.md @@ -45,19 +45,19 @@ page_keywords: Docker, Docker documentation, installation, google, Google Comput $ gcutil ssh docker-playground - docker-playground:~$ + $ docker-playground:~$ 5. Install the latest Docker release and configure it to start when the instance boots: - docker-playground:~$ curl get.docker.io | bash - docker-playground:~$ sudo update-rc.d docker defaults + $ docker-playground:~$ curl get.docker.io | bash + $ docker-playground:~$ sudo update-rc.d docker defaults 6. Start a new container: - docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' - docker on GCE \o/ + $ docker-playground:~$ sudo docker run busybox echo 'docker on GCE \o/' + $ docker on GCE \o/ diff --git a/docs/sources/installation/mac.md b/docs/sources/installation/mac.md index 1cef06b55b..15736f5c6c 100644 --- a/docs/sources/installation/mac.md +++ b/docs/sources/installation/mac.md @@ -40,7 +40,7 @@ image that is used for the job. If you are using Homebrew on your machine, simply run the following command to install `boot2docker`: - brew install boot2docker + $ brew install boot2docker #### Manual installation @@ -49,13 +49,13 @@ Open up a new terminal window, if you have not already. Run the following commands to get boot2docker: # Enter the installation directory - cd ~/bin + $ cd ~/bin # Get the file - curl https://raw.github.com/boot2docker/boot2docker/master/boot2docker > boot2docker + $ curl https://raw.github.com/boot2docker/boot2docker/master/boot2docker > boot2docker # Mark it executable - chmod +x boot2docker + $ chmod +x boot2docker ### Docker OS X Client @@ -67,25 +67,25 @@ The `docker` daemon is accessed using the Run the following command to install the `docker` client: - brew install docker + $ brew install docker #### Manual installation Run the following commands to get it downloaded and set up: # Get the docker client file - DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ - curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ - gunzip $DIR/ld.tgz && \ - tar xvf $DIR/ld.tar -C $DIR/ && \ - cp $DIR/usr/local/bin/docker ./docker + $ DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ + $ curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ + $ gunzip $DIR/ld.tgz && \ + $ tar xvf $DIR/ld.tar -C $DIR/ && \ + $ cp $DIR/usr/local/bin/docker ./docker # Set the environment variable for the docker daemon - export DOCKER_HOST=tcp://127.0.0.1:4243 + $ export DOCKER_HOST=tcp://127.0.0.1:4243 # Copy the executable file - sudo mkdir -p /usr/local/bin - sudo cp docker /usr/local/bin/ + $ sudo mkdir -p /usr/local/bin + $ sudo cp docker /usr/local/bin/ And that's it! Let's check out how to use it. @@ -97,13 +97,13 @@ Inside the `~/bin` directory, run the following commands: # Initiate the VM - ./boot2docker init + $ ./boot2docker init # Run the VM (the docker daemon) - ./boot2docker up + $ ./boot2docker up # To see all available commands: - ./boot2docker + $ ./boot2docker # Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} @@ -113,7 +113,7 @@ Once the VM with the `docker` daemon is up, you can use the `docker` client just like any other application. - docker version + $ docker version # Client version: 0.7.6 # Go version (client): go1.2 # Git commit (client): bc3b2ec @@ -137,7 +137,7 @@ interact with our containers as if they were running locally: If you feel the need to connect to the VM, you can simply run: - ./boot2docker ssh + $ ./boot2docker ssh # User: docker # Pwd: tcuser @@ -154,7 +154,7 @@ See the GitHub page for ### If SSH complains about keys: - ssh-keygen -R '[localhost]:2022' + $ ssh-keygen -R '[localhost]:2022' ### Upgrading to a newer release of boot2docker @@ -162,9 +162,9 @@ To upgrade an initialised VM, you can use the following 3 commands. Your persistence disk will not be changed, so you won't lose your images and containers: - ./boot2docker stop - ./boot2docker download - ./boot2docker start + $ ./boot2docker stop + $ ./boot2docker download + $ ./boot2docker start ### About the way Docker works on Mac OS X: diff --git a/docs/sources/installation/openSUSE.md b/docs/sources/installation/openSUSE.md index 2d7804d291..07f2ca43d2 100644 --- a/docs/sources/installation/openSUSE.md +++ b/docs/sources/installation/openSUSE.md @@ -30,14 +30,14 @@ To proceed with Docker installation please add the right Virtualization repository. # openSUSE 12.3 - sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization + $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization # openSUSE 13.1 - sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization + $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization Install the Docker package. - sudo zypper in docker + $ sudo zypper in docker It's also possible to install Docker using openSUSE's1-click install. Just visit [this](http://software.opensuse.org/package/docker) page, @@ -47,17 +47,17 @@ the docker package. Now that it's installed, let's start the Docker daemon. - sudo systemctl start docker + $ sudo systemctl start docker If we want Docker to start at boot, we should also: - sudo systemctl enable docker + $ sudo systemctl enable docker The docker package creates a new group named docker. Users, other than root user, need to be part of this group in order to interact with the Docker daemon. - sudo usermod -G docker + $ sudo usermod -G docker **Done!** Now continue with the [*Hello World*]( diff --git a/docs/sources/installation/rackspace.md b/docs/sources/installation/rackspace.md index 8cce292b79..c93af388ed 100644 --- a/docs/sources/installation/rackspace.md +++ b/docs/sources/installation/rackspace.md @@ -29,16 +29,16 @@ you will need to set the kernel manually. **Do not attempt this on a production machine!** # update apt - apt-get update + $ apt-get update # install the new kernel - apt-get install linux-generic-lts-raring + $ apt-get install linux-generic-lts-raring Great, now you have the kernel installed in `/boot/`, next you need to make it boot next time. # find the exact names - find /boot/ -name '*3.8*' + $ find /boot/ -name '*3.8*' # this should return some results @@ -51,7 +51,7 @@ the right files. Take special care to double check the kernel and initrd entries. # now edit /boot/grub/menu.lst - vi /boot/grub/menu.lst + $ vi /boot/grub/menu.lst It will probably look something like this: @@ -78,7 +78,7 @@ Reboot the server (either via command line or console) Verify the kernel was updated - uname -a + $ uname -a # Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux # nice! 3.8. diff --git a/docs/sources/installation/rhel.md b/docs/sources/installation/rhel.md index 874e92adc8..632743a2b9 100644 --- a/docs/sources/installation/rhel.md +++ b/docs/sources/installation/rhel.md @@ -49,23 +49,23 @@ To proceed with `docker-io` installation, please remove `docker` first. Next, let's install the `docker-io` package which will install Docker on our host. - sudo yum -y install docker-io + $ sudo yum -y install docker-io To update the `docker-io` package - sudo yum -y update docker-io + $ sudo yum -y update docker-io Now that it's installed, let's start the Docker daemon. - sudo service docker start + $ sudo service docker start If we want Docker to start at boot, we should also: - sudo chkconfig docker on + $ sudo chkconfig docker on Now let's verify that Docker is working. - sudo docker run -i -t fedora /bin/bash + $ sudo docker run -i -t fedora /bin/bash **Done!** Now continue with the [*Hello World*](/examples/hello_world/#hello-world) example. diff --git a/docs/sources/installation/ubuntulinux.md b/docs/sources/installation/ubuntulinux.md index 04173cf917..d40e17b646 100644 --- a/docs/sources/installation/ubuntulinux.md +++ b/docs/sources/installation/ubuntulinux.md @@ -33,13 +33,13 @@ installs all its prerequisites from Ubuntu's repository. To install the latest Ubuntu package (may not be the latest Docker release): - sudo apt-get update - sudo apt-get install docker.io - sudo ln -sf /usr/bin/docker.io /usr/local/bin/docker + $ sudo apt-get update + $ sudo apt-get install docker.io + $ sudo ln -sf /usr/bin/docker.io /usr/local/bin/docker To verify that everything has worked as expected: - sudo docker run -i -t ubuntu /bin/bash + $ sudo docker run -i -t ubuntu /bin/bash Which should download the `ubuntu` image, and then start `bash` in a container. @@ -61,11 +61,11 @@ VirtualBox guest additions. If you didn't install the headers for your kernel. But it is safer to include them if you're not sure. # install the backported kernel - sudo apt-get update - sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring + $ sudo apt-get update + $ sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring # reboot - sudo reboot + $ sudo reboot ### Installation @@ -90,7 +90,7 @@ should exist. If it doesn't, you need to install the package Then, add the Docker repository key to your local keychain. - sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --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. @@ -98,21 +98,21 @@ the `lxc-docker` package. *You may receive a warning that the package isn't trusted. Answer yes to continue installation.* - sudo sh -c "echo deb https://get.docker.io/ubuntu docker main\ + $ sudo sh -c "echo deb https://get.docker.io/ubuntu docker main\ > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker + $ sudo apt-get update + $ sudo apt-get install lxc-docker > **Note**: > > There is also a simple `curl` script available to help with this process. > -> curl -s https://get.docker.io/ubuntu/ | sudo sh +> $ curl -s https://get.docker.io/ubuntu/ | sudo sh Now verify that the installation has worked by downloading the `ubuntu` image and launching a container. - sudo docker run -i -t ubuntu /bin/bash + $ sudo docker run -i -t ubuntu /bin/bash Type `exit` to exit @@ -134,8 +134,8 @@ available as a driver and we recommend using it if you can. To make sure AUFS is installed, run the following commands: - sudo apt-get update - sudo apt-get install linux-image-extra-`uname -r` + $ sudo apt-get update + $ sudo apt-get install linux-image-extra-`uname -r` ### Installation @@ -147,20 +147,20 @@ Docker is available as a Debian package, which makes installation easy. First add the Docker repository key to your local keychain. - sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --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. - sudo sh -c "echo deb http://get.docker.io/ubuntu docker main\ + $ sudo sh -c "echo deb http://get.docker.io/ubuntu docker main\ > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker + $ sudo apt-get update + $ sudo apt-get install lxc-docker Now verify that the installation has worked by downloading the `ubuntu` image and launching a container. - sudo docker run -i -t ubuntu /bin/bash + $ sudo docker run -i -t ubuntu /bin/bash Type `exit` to exit @@ -194,16 +194,16 @@ than `docker` should own the Unix socket with the **Example:** # Add the docker group if it doesn't already exist. - sudo groupadd docker + $ sudo groupadd docker # Add the connected user "${USER}" to the docker group. # Change the user name to match your preferred user. # You may have to logout and log back in again for # this to take effect. - sudo gpasswd -a ${USER} docker + $ sudo gpasswd -a ${USER} docker # Restart the Docker daemon. - sudo service docker restart + $ sudo service docker restart ### Upgrade @@ -211,28 +211,28 @@ To install the latest version of docker, use the standard `apt-get` method: # update your sources list - sudo apt-get update + $ sudo apt-get update # install the latest - sudo apt-get install lxc-docker + $ sudo apt-get install lxc-docker ## Memory and Swap Accounting If you want to enable memory and swap accounting, you must add the following command-line parameters to your kernel: - cgroup_enable=memory swapaccount=1 + $ cgroup_enable=memory swapaccount=1 On systems using GRUB (which is the default for Ubuntu), you can add those parameters by editing `/etc/default/grub` and extending `GRUB_CMDLINE_LINUX`. Look for the following line: - GRUB_CMDLINE_LINUX="" + $ GRUB_CMDLINE_LINUX="" And replace it by the following one: - GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" + $ GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1" Then run `sudo update-grub`, and reboot. @@ -247,7 +247,7 @@ On Linux Mint, the `cgroup-lite` package is not installed by default. Before Docker will work correctly, you will need to install this via: - sudo apt-get update && sudo apt-get install cgroup-lite + $ sudo apt-get update && sudo apt-get install cgroup-lite ## Docker and UFW @@ -255,22 +255,22 @@ Docker uses a bridge to manage container networking. By default, UFW drops all forwarding traffic. As a result you will need to enable UFW forwarding: - sudo nano /etc/default/ufw - ---- + $ sudo nano /etc/default/ufw + # Change: # DEFAULT_FORWARD_POLICY="DROP" # to - DEFAULT_FORWARD_POLICY="ACCEPT" + $ DEFAULT_FORWARD_POLICY="ACCEPT" Then reload UFW: - sudo ufw reload + $ sudo ufw reload UFW's default set of rules denies all incoming traffic. If you want to be able to reach your containers from another host then you should allow incoming connections on the Docker port (default 4243): - sudo ufw allow 4243/tcp + $ sudo ufw allow 4243/tcp ## Docker and local DNS server warnings @@ -290,16 +290,16 @@ nameserver and Docker will default to using an external nameserver. This can be worked around by specifying a DNS server to be used by the Docker daemon for the containers: - sudo nano /etc/default/docker + $ 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 The Docker daemon has to be restarted: - sudo restart docker + $ sudo restart docker > **Warning**: > If you're doing this on a laptop which connects to various networks, @@ -308,7 +308,7 @@ The Docker daemon has to be restarted: An alternative solution involves disabling dnsmasq in NetworkManager by following these steps: - sudo nano /etc/NetworkManager/NetworkManager.conf + $ sudo nano /etc/NetworkManager/NetworkManager.conf ---- # Change: dns=dnsmasq @@ -317,8 +317,8 @@ following these steps: NetworkManager and Docker need to be restarted afterwards: - sudo restart network-manager - sudo restart docker + $ sudo restart network-manager + $ sudo restart docker > **Warning**: This might make DNS resolution slower on some networks. @@ -336,7 +336,7 @@ Substitute `http://mirror.yandex.ru/mirrors/docker/` for `http://get.docker.io/ubuntu` in the instructions above. For example: - sudo sh -c "echo deb http://mirror.yandex.ru/mirrors/docker/ docker main\ + $ sudo sh -c "echo deb http://mirror.yandex.ru/mirrors/docker/ docker main\ > /etc/apt/sources.list.d/docker.list" - sudo apt-get update - sudo apt-get install lxc-docker + $ sudo apt-get update + $ sudo apt-get install lxc-docker diff --git a/docs/sources/installation/windows.md b/docs/sources/installation/windows.md index a5730862ad..ec633508c4 100644 --- a/docs/sources/installation/windows.md +++ b/docs/sources/installation/windows.md @@ -55,7 +55,7 @@ right away. Let's try the “hello world” example. Run - docker run busybox echo hello world + $ docker run busybox echo hello world This will download the small busybox image and print hello world. diff --git a/docs/sources/introduction/working-with-docker.md b/docs/sources/introduction/working-with-docker.md index e76c80cffa..d6bdb2260d 100644 --- a/docs/sources/introduction/working-with-docker.md +++ b/docs/sources/introduction/working-with-docker.md @@ -60,7 +60,7 @@ 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 + $ docker run -i -t ubuntu /bin/bash ### Our first Docker command @@ -70,7 +70,7 @@ version` command. # Usage: [sudo] docker version # Example: - docker version + $ 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 @@ -97,7 +97,7 @@ binary: # Usage: [sudo] docker # Example: - docker + $ docker You will get an output with all currently available commands. @@ -116,12 +116,12 @@ Try typing Docker followed with a `[command]` to see the instructions: # Usage: [sudo] docker [command] [--help] # Example: - docker attach + $ docker attach Help outputs . . . Or you can pass the `--help` flag to the `docker` binary. - docker images --help + $ docker images --help You will get an output with all available options: @@ -156,12 +156,12 @@ image is constructed. # Usage: [sudo] docker search [image name] # Example: - docker search nginx + $ docker search nginx NAME DESCRIPTION STARS OFFICIAL TRUSTED - dockerfile/nginx Trusted Nginx (http://nginx.org/) Build 6 [OK] + $ 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] + $ dockerfiles/django-uwsgi-nginx dockerfile and configuration files to buil... 2 [OK] . . . > **Note:** To learn more about trusted builds, check out [this]( @@ -174,7 +174,7 @@ Downloading a Docker image is called *pulling*. To do this we hence use the # Usage: [sudo] docker pull [image name] # Example: - docker pull dockerfile/nginx + $ docker pull dockerfile/nginx Pulling repository dockerfile/nginx 0ade68db1d05: Pulling dependent layers @@ -193,12 +193,12 @@ In order to get a full list of available images, you can use the # Usage: [sudo] docker images # Example: - docker images + $ 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 + $ dockerfile/nginx latest 0ade68db1d05 3 weeks ago 578.8 MB ## Working with containers @@ -215,7 +215,7 @@ 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 + $ 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 @@ -242,10 +242,10 @@ both running and stopped. # Usage: [sudo] docker ps [-a] # Example: - docker ps + $ 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 + 842a50a13032 $ dockerfile/nginx:latest nginx 35 minutes ago Up 30 minutes 0.0.0.0:80->80/tcp nginx_web ### Stopping a container @@ -254,7 +254,7 @@ end the active process. # Usage: [sudo] docker stop [container ID] # Example: - docker stop nginx_web + $ docker stop nginx_web nginx_web If the `docker stop` command succeeds it will return the name of @@ -266,7 +266,7 @@ Stopped containers can be started again. # Usage: [sudo] docker start [container ID] # Example: - docker start nginx_web + $ docker start nginx_web nginx_web If the `docker start` command succeeds it will return the name of the @@ -358,7 +358,7 @@ Docker uses the `Dockerfile` to build images. The build process is initiated by # Use the Dockerfile at the current location # Usage: [sudo] docker build . # Example: - docker build -t="my_nginx_image" . + $ docker build -t="my_nginx_image" . Uploading context 25.09 kB Uploading context @@ -385,7 +385,7 @@ image, here `my_nginx_image`. We can see our new image using the `docker images` command. - docker images + $ docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE my_nginx_img latest 626e92c5fab1 57 seconds ago 337.6 MB 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 index f31f87e55f..2e7e94f7d4 100644 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.4.md +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.4.md @@ -1127,4 +1127,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors 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 index 1d0b7e203f..08457bfd94 100644 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.5.md +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.5.md @@ -1134,4 +1134,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors 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 index ebf2843e93..bca09a3a0e 100644 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.6.md +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.6.md @@ -1236,4 +1236,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors 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 index 0f18e09d0a..818fbba11c 100644 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.7.md +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.7.md @@ -1230,4 +1230,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors 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 index 53a8e4d7e1..0d2997693c 100644 --- a/docs/sources/reference/api/archive/docker_remote_api_v1.8.md +++ b/docs/sources/reference/api/archive/docker_remote_api_v1.8.md @@ -1276,4 +1276,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors 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 bbf3592cfc..721244b49e 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.10.md +++ b/docs/sources/reference/api/docker_remote_api_v1.10.md @@ -1297,4 +1297,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.md b/docs/sources/reference/api/docker_remote_api_v1.11.md index 40dee1af63..59e07a46b8 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.11.md +++ b/docs/sources/reference/api/docker_remote_api_v1.11.md @@ -1301,4 +1301,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ 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 bc62b20ac4..d8be62a7a7 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.9.md +++ b/docs/sources/reference/api/docker_remote_api_v1.9.md @@ -1313,4 +1313,4 @@ stdout and stderr on the same socket. This might change in the future. 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 + $ docker -d -H="192.168.1.9:4243" --api-enable-cors diff --git a/docs/sources/reference/api/registry_index_spec.md b/docs/sources/reference/api/registry_index_spec.md index fb5617d101..93ba469221 100644 --- a/docs/sources/reference/api/registry_index_spec.md +++ b/docs/sources/reference/api/registry_index_spec.md @@ -111,7 +111,7 @@ supports: It's possible to run: - docker pull https:///repositories/samalba/busybox + $ docker pull https:///repositories/samalba/busybox In this case, Docker bypasses the Index. However the security is not guaranteed (in case Registry A is corrupted) because there won't be any diff --git a/docs/sources/reference/builder.md b/docs/sources/reference/builder.md index 3e278425c2..98e9e0f544 100644 --- a/docs/sources/reference/builder.md +++ b/docs/sources/reference/builder.md @@ -18,7 +18,7 @@ This file will describe the steps to assemble the image. Then call `docker build` with the path of you source repository as argument (for example, `.`): - sudo docker build . + $ sudo docker build . The path to the source repository defines where to find the *context* of the build. The build is run by the Docker daemon, not by the CLI, so the @@ -28,7 +28,7 @@ whole context must be transferred to the daemon. The Docker CLI reports You can specify a repository and tag at which to save the new image if the build succeeds: - sudo docker build -t shykes/myapp . + $ sudo docker build -t shykes/myapp . The Docker daemon will run your steps one-by-one, committing the result to a new image if necessary, before finally outputting the ID of your diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index 75a5be33b6..ef5c3bc1f7 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -35,11 +35,11 @@ will set the value to the opposite of the default value. Options like `-a=[]` indicate they can be specified multiple times: - docker run -a stdin -a stdout -a stderr -i -t ubuntu /bin/bash + $ docker run -a stdin -a stdout -a stderr -i -t ubuntu /bin/bash Sometimes this can use a more complex value string, as for `-v`: - docker run -v /host:/container example/mysql + $ docker run -v /host:/container example/mysql ### Strings and Integers @@ -100,10 +100,10 @@ To use lxc as the execution driver, use `docker -d -e lxc`. The docker client will also honor the `DOCKER_HOST` environment variable to set the `-H` flag for the client. - docker -H tcp://0.0.0.0:4243 ps + $ docker -H tcp://0.0.0.0:4243 ps # or - export DOCKER_HOST="tcp://0.0.0.0:4243" - docker ps + $ export DOCKER_HOST="tcp://0.0.0.0:4243" + $ docker ps # both are equal To run the daemon with [systemd socket activation]( @@ -448,7 +448,7 @@ by default. 77af4d6b9913 19 hours ago 1.089 GB committest latest b6fa739cedf5 19 hours ago 1.089 GB 78a85c484f71 19 hours ago 1.089 GB - docker latest 30557a29d5ab 20 hours ago 1.089 GB + $ docker latest 30557a29d5ab 20 hours ago 1.089 GB 0124422dd9f9 20 hours ago 1.089 GB 18ad6fad3402 22 hours ago 1.082 GB f9f1e26352f0 23 hours ago 1.089 GB @@ -462,7 +462,7 @@ by default. 77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB committest latest b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB 78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB - docker latest 30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB + $ docker latest 30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB 0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB 18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB @@ -640,7 +640,7 @@ If you want to login to a private registry you can specify this by adding the server name. example: - docker login localhost:8080 + $ docker login localhost:8080 ## logs diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index 9de08ec1a6..a8acb97071 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -22,7 +22,7 @@ running containers, and so here we try to give more in-depth guidance. As you`ve seen in the [*Examples*](/examples/#example-list), the basic run command takes this form: - docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] + $ docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] To learn how to interpret the types of `[OPTIONS]`, see [*Option types*](/commandline/cli/#cli-options). @@ -99,7 +99,7 @@ https://github.com/dotcloud/docker/blob/ of the three standard streams (`stdin`, `stdout`, `stderr`) you'd like to connect instead, as in: - docker run -a stdin -a stdout -i -t ubuntu /bin/bash + $ docker run -a stdin -a stdout -i -t ubuntu /bin/bash For interactive processes (like a shell) you will typically want a tty as well as persistent standard input (`stdin`), so you'll use `-i -t` together in most @@ -233,7 +233,7 @@ Dockerfile instruction and how the operator can override that setting. Recall the optional `COMMAND` in the Docker commandline: - docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] + $ docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] This command is optional because the person who created the `IMAGE` may have already provided a default `COMMAND` using the Dockerfile `CMD`. As the @@ -259,12 +259,12 @@ runtime by using a string to specify 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) @@ -335,7 +335,7 @@ container running Redis: # The redis-name container exposed port 6379 $ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES - 4241164edf6f dockerfiles/redis:latest /redis-stable/src/re 5 seconds ago Up 4 seconds 6379/tcp redis-name + 4241164edf6f $ dockerfiles/redis:latest /redis-stable/src/re 5 seconds ago Up 4 seconds 6379/tcp redis-name # Note that there are no public ports exposed since we didn᾿t use -p or -P $ docker port 4241164edf6f 6379 diff --git a/docs/sources/use/ambassador_pattern_linking.md b/docs/sources/use/ambassador_pattern_linking.md index a04dbdffc0..2bdd434f6e 100644 --- a/docs/sources/use/ambassador_pattern_linking.md +++ b/docs/sources/use/ambassador_pattern_linking.md @@ -146,7 +146,7 @@ remote IP and port - in this case `192.168.1.52:6379`. # 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 # 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 diff --git a/docs/sources/use/basics.md b/docs/sources/use/basics.md index b9d52877e4..ee3eeabd9d 100644 --- a/docs/sources/use/basics.md +++ b/docs/sources/use/basics.md @@ -10,7 +10,7 @@ This guide assumes you have a working installation of Docker. To check your Docker install, run the following command: # Check that you have a working install - docker info + $ docker info If you get `docker: command not found` or something like `/var/lib/docker/repositories: permission denied` @@ -23,7 +23,7 @@ for installation instructions. ## Download a pre-built image # Download an ubuntu image - sudo docker pull ubuntu + $ sudo docker pull ubuntu This will find the `ubuntu` image by name on [*Docker.io*](../workingwithrepository/#find-public-images-on-dockerio) and @@ -46,7 +46,7 @@ cache. # To detach the tty without exiting the shell, # use the escape sequence Ctrl-p + Ctrl-q # note: This will continue to exist in a stopped state once exited (see "docker ps -a") - sudo docker run -i -t ubuntu /bin/bash + $ sudo docker run -i -t ubuntu /bin/bash ## Bind Docker to another host/port or a Unix socket @@ -87,70 +87,70 @@ when no `-H` was passed in. `host[:port]` or `:port` # Run docker in daemon mode - sudo /docker -H 0.0.0.0:5555 -d & + $ sudo /docker -H 0.0.0.0:5555 -d & # Download an ubuntu image - sudo docker -H :5555 pull ubuntu + $ sudo docker -H :5555 pull ubuntu You can use multiple `-H`, for example, if you want to listen on both TCP and a Unix socket # Run docker in daemon mode - sudo /docker -H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock -d & + $ sudo /docker -H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock -d & # Download an ubuntu image, use default Unix socket - sudo docker pull ubuntu + $ sudo docker pull ubuntu # OR use the TCP port - sudo docker -H tcp://127.0.0.1:4243 pull ubuntu + $ sudo docker -H tcp://127.0.0.1:4243 pull ubuntu ## Starting a long-running worker process # Start a very useful long-running process - JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + $ JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") # Collect the output of the job so far - sudo docker logs $JOB + $ sudo docker logs $JOB # Kill the job - sudo docker kill $JOB + $ sudo docker kill $JOB ## Listing containers - sudo docker ps # Lists only running containers - sudo docker ps -a # Lists all containers + $ sudo docker ps # Lists only running containers + $ sudo docker ps -a # Lists all containers ## Controlling containers # Start a new container - JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") + $ JOB=$(sudo docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done") # Stop the container - docker stop $JOB + $ docker stop $JOB # Start the container - docker start $JOB + $ docker start $JOB # Restart the container - docker restart $JOB + $ docker restart $JOB # SIGKILL a container - docker kill $JOB + $ docker kill $JOB # Remove a container - docker stop $JOB # Container must be stopped to remove it - docker rm $JOB + $ docker stop $JOB # Container must be stopped to remove it + $ docker rm $JOB ## Bind a service on a TCP port # Bind port 4444 of this container, and tell netcat to listen on it - JOB=$(sudo docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444) + $ JOB=$(sudo docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444) # Which public port is NATed to my container? - PORT=$(sudo docker port $JOB 4444 | awk -F: '{ print $2 }') + $ PORT=$(sudo docker port $JOB 4444 | awk -F: '{ print $2 }') # Connect to the public port - echo hello world | nc 127.0.0.1 $PORT + $ echo hello world | nc 127.0.0.1 $PORT # Verify that the network connection worked - echo "Daemon received: $(sudo docker logs $JOB)" + $ echo "Daemon received: $(sudo docker logs $JOB)" ## Committing (saving) a container state @@ -163,10 +163,10 @@ will be stored (as a diff). See which images you already have using the `docker images` command. # Commit your container to a new named image - sudo docker commit + $ sudo docker commit # List your containers - sudo docker images + $ sudo docker images You now have a image state from which you can create new instances. diff --git a/docs/sources/use/chef.md b/docs/sources/use/chef.md index 5145107a38..897c2b429a 100644 --- a/docs/sources/use/chef.md +++ b/docs/sources/use/chef.md @@ -43,7 +43,7 @@ The next step is to pull a Docker image. For this, we have a resource: This is equivalent to running: - docker pull samalba/docker-registry + $ docker pull samalba/docker-registry There are attributes available to control how long the cookbook will allow for downloading (5 minute default). @@ -68,7 +68,7 @@ managed by Docker. This is equivalent to running the following command, but under upstart: - docker run --detach=true --publish='5000:5000' --env='SETTINGS_FLAVOR=local' --volume='/mnt/docker:/docker-storage' samalba/docker-registry + $ docker run --detach=true --publish='5000:5000' --env='SETTINGS_FLAVOR=local' --volume='/mnt/docker:/docker-storage' samalba/docker-registry The resources will accept a single string or an array of values for any docker flags that allow multiple values. diff --git a/docs/sources/use/networking.md b/docs/sources/use/networking.md index 2249ca42cd..00d0684256 100644 --- a/docs/sources/use/networking.md +++ b/docs/sources/use/networking.md @@ -84,7 +84,7 @@ In this scenario: inet addr:192.168.227.1 Bcast:192.168.227.255 Mask:255.255.255.0 # Run a container - $ docker run -i -t base /bin/bash + docker run -i -t base /bin/bash # Container IP in the 192.168.227/24 range root@261c272cd7d5:/# ifconfig eth0 diff --git a/docs/sources/use/port_redirection.md b/docs/sources/use/port_redirection.md index ef0e644ace..9f2ce98eae 100644 --- a/docs/sources/use/port_redirection.md +++ b/docs/sources/use/port_redirection.md @@ -11,7 +11,7 @@ port. When this service runs inside a container, one can connect to the port after finding the IP address of the container as follows: # Find IP address of container with ID - docker inspect | grep IPAddress | cut -d '"' -f 4 + $ docker inspect | grep IPAddress | cut -d '"' -f 4 However, this IP address is local to the host system and the container port is not reachable by the outside world. Furthermore, even if the @@ -40,7 +40,7 @@ To bind a port of the container to a specific interface of the host system, use the `-p` parameter of the `docker run` command: # General syntax - docker run -p [([:[host_port]])|():][/udp] + $ docker run -p [([:[host_port]])|():][/udp] When no host interface is provided, the port is bound to all available interfaces of the host machine (aka INADDR_ANY, or 0.0.0.0). When no @@ -48,32 +48,32 @@ host port is provided, one is dynamically allocated. The possible combinations of options for TCP port are the following: # Bind TCP port 8080 of the container to TCP port 80 on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1:80:8080 + $ docker run -p 127.0.0.1:80:8080 # Bind TCP port 8080 of the container to a dynamically allocated TCP port on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1::8080 + $ docker run -p 127.0.0.1::8080 # Bind TCP port 8080 of the container to TCP port 80 on all available interfaces of the host machine. - docker run -p 80:8080 + $ docker run -p 80:8080 # Bind TCP port 8080 of the container to a dynamically allocated TCP port on all available interfaces of the host machine. - docker run -p 8080 + $ docker run -p 8080 UDP ports can also be bound by adding a trailing `/udp`. All the combinations described for TCP work. Here is only one example: # Bind UDP port 5353 of the container to UDP port 53 on 127.0.0.1 of the host machine. - docker run -p 127.0.0.1:53:5353/udp + $ docker run -p 127.0.0.1:53:5353/udp The command `docker port` lists the interface and 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 + $ docker port dyn-bound 8080 127.0.0.1:49160 ## Linking a container @@ -99,24 +99,24 @@ exposure is done either through the `--expose` parameter to the `docker run` 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`: # Link - docker run --name client --link server:linked-server + $ docker run --name client --link server:linked-server `client` locally refers to `server` as `linked-server`. The following environment variables, among others, are available on `client`: # The default protocol, ip, and port of the service running in the container - LINKED-SERVER_PORT=tcp://172.17.0.8:80 + $ LINKED-SERVER_PORT=tcp://172.17.0.8:80 # A specific protocol, ip, and port of various services - LINKED-SERVER_PORT_80_TCP=tcp://172.17.0.8:80 - LINKED-SERVER_PORT_80_TCP_PROTO=tcp - LINKED-SERVER_PORT_80_TCP_ADDR=172.17.0.8 - LINKED-SERVER_PORT_80_TCP_PORT=80 + $ LINKED-SERVER_PORT_80_TCP=tcp://172.17.0.8:80 + $ LINKED-SERVER_PORT_80_TCP_PROTO=tcp + $ LINKED-SERVER_PORT_80_TCP_ADDR=172.17.0.8 + $ LINKED-SERVER_PORT_80_TCP_PORT=80 This tells `client` that a service is running on port 80 of `server` and that `server` is accessible at the IP address 172.17.0.8 diff --git a/docs/sources/use/puppet.md b/docs/sources/use/puppet.md index c1ac95f4ab..a0d20ab446 100644 --- a/docs/sources/use/puppet.md +++ b/docs/sources/use/puppet.md @@ -23,7 +23,7 @@ The module is available on the [Puppet Forge](https://forge.puppetlabs.com/garethr/docker/) and can be installed using the built-in module tool. - puppet module install garethr/docker + $ puppet module install garethr/docker It can also be found on [GitHub](https://github.com/garethr/garethr-docker) if you would @@ -47,7 +47,7 @@ defined type which can be used like so: This is equivalent to running: - docker pull ubuntu + $ docker pull ubuntu Note that it will only be downloaded if an image of that name does not already exist. This is downloading a large binary so on first run can @@ -71,7 +71,7 @@ managed by Docker. This is equivalent to running the following command, but under upstart: - docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done" + $ docker run -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done" Run also contains a number of optional parameters: diff --git a/docs/sources/use/working_with_volumes.md b/docs/sources/use/working_with_volumes.md index 5817309e62..c403532bcc 100644 --- a/docs/sources/use/working_with_volumes.md +++ b/docs/sources/use/working_with_volumes.md @@ -50,8 +50,8 @@ not. 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 + # BUILD-USING: $ docker build -t data . + # RUN-USING: $ docker run -name DATA data FROM busybox VOLUME ["/var/volume1", "/var/volume2"] CMD ["/bin/true"] @@ -108,7 +108,7 @@ For example: # Usage: # sudo docker run [OPTIONS] -v /(dir. on host):/(dir. in container):(Read-Write or Read-Only) [ARG..] # Example: - sudo docker run -i -t -v /var/log:/logs_from_host:ro ubuntu bash + $ sudo docker run -i -t -v /var/log:/logs_from_host:ro ubuntu bash The command above mounts the host directory `/var/log` into the container with *read only* permissions as `/logs_from_host`. diff --git a/docs/sources/use/workingwithrepository.md b/docs/sources/use/workingwithrepository.md index e3daf05fc7..07f130a909 100644 --- a/docs/sources/use/workingwithrepository.md +++ b/docs/sources/use/workingwithrepository.md @@ -109,7 +109,7 @@ share one of your own images, then you must register a unique user name first. You can create your username and login on [Docker.io](https://index.docker.io/account/signup/), or by running - sudo docker login + $ sudo docker login This will prompt you for a username, which will become a public namespace for your public repositories. @@ -199,10 +199,10 @@ identify a host), like this: # Tag to create a repository with the full registry location. # The location (e.g. localhost.localdomain:5000) becomes # a permanent part of the repository name - sudo docker tag 0u812deadbeef localhost.localdomain:5000/repo_name + $ sudo docker tag 0u812deadbeef localhost.localdomain:5000/repo_name # Push the new repository to its home location on localhost - sudo docker push localhost.localdomain:5000/repo_name + $ sudo docker push localhost.localdomain:5000/repo_name Once a repository has your registry's host name as part of the tag, you can push and pull it like any other repository, but it will **not** be From d1297feef8b124e69efc99a58294f498ecb8c022 Mon Sep 17 00:00:00 2001 From: Alexandr Morozov Date: Wed, 2 Apr 2014 23:26:06 +0400 Subject: [PATCH 358/436] Timestamps for docker logs. Fixes #1165 Docker-DCO-1.1-Signed-off-by: Alexandr Morozov (github: LK4D4) --- api/client/commands.go | 9 +- api/client/utils.go | 15 ++- api/server/server.go | 43 +++++++ daemon/container.go | 12 ++ .../reference/api/docker_remote_api.md | 4 + .../reference/api/docker_remote_api_v1.11.md | 36 ++++++ docs/sources/reference/commandline/cli.md | 7 +- integration-cli/docker_cli_logs_test.go | 95 +++++++++++++++ server/server.go | 91 ++++++++++++++ utils/utils.go | 112 +++++++++++++----- 10 files changed, 386 insertions(+), 38 deletions(-) diff --git a/api/client/commands.go b/api/client/commands.go index 415bddaac4..89f9b0a4c4 100644 --- a/api/client/commands.go +++ b/api/client/commands.go @@ -1583,6 +1583,7 @@ func (cli *DockerCli) CmdDiff(args ...string) error { func (cli *DockerCli) CmdLogs(args ...string) error { cmd := cli.Subcmd("logs", "CONTAINER", "Fetch the logs of a container") follow := cmd.Bool([]string{"f", "-follow"}, false, "Follow log output") + times := cmd.Bool([]string{"t", "-timestamps"}, false, "Show timestamps") if err := cmd.Parse(args); err != nil { return nil } @@ -1603,14 +1604,16 @@ func (cli *DockerCli) CmdLogs(args ...string) error { } v := url.Values{} - v.Set("logs", "1") v.Set("stdout", "1") v.Set("stderr", "1") + if *times { + v.Set("timestamps", "1") + } if *follow && container.State.Running { - v.Set("stream", "1") + v.Set("follow", "1") } - if err := cli.hijack("POST", "/containers/"+name+"/attach?"+v.Encode(), container.Config.Tty, nil, cli.out, cli.err, nil); err != nil { + if err := cli.streamHelper("GET", "/containers/"+name+"/logs?"+v.Encode(), container.Config.Tty, nil, cli.out, cli.err, nil); err != nil { return err } return nil diff --git a/api/client/utils.go b/api/client/utils.go index 4ef09ba783..7f7498dee7 100644 --- a/api/client/utils.go +++ b/api/client/utils.go @@ -130,6 +130,10 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } func (cli *DockerCli) stream(method, path string, in io.Reader, out io.Writer, headers map[string][]string) error { + return cli.streamHelper(method, path, true, in, out, nil, headers) +} + +func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in io.Reader, stdout, stderr io.Writer, headers map[string][]string) error { if (method == "POST" || method == "PUT") && in == nil { in = bytes.NewReader([]byte{}) } @@ -184,9 +188,16 @@ func (cli *DockerCli) stream(method, path string, in io.Reader, out io.Writer, h } if api.MatchesContentType(resp.Header.Get("Content-Type"), "application/json") { - return utils.DisplayJSONMessagesStream(resp.Body, out, cli.terminalFd, cli.isTerminal) + return utils.DisplayJSONMessagesStream(resp.Body, stdout, cli.terminalFd, cli.isTerminal) } - if _, err := io.Copy(out, resp.Body); err != nil { + if stdout != nil || stderr != nil { + // When TTY is ON, use regular copy + if setRawTerminal { + _, err = io.Copy(stdout, resp.Body) + } else { + _, err = utils.StdCopy(stdout, stderr, resp.Body) + } + utils.Debugf("[stream] End of stdout") return err } return nil diff --git a/api/server/server.go b/api/server/server.go index 279d297965..5db9df1901 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -328,6 +328,48 @@ func getContainersJSON(eng *engine.Engine, version version.Version, w http.Respo return nil } +func getContainersLogs(eng *engine.Engine, version version.Version, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + if err := parseForm(r); err != nil { + return err + } + if vars == nil { + return fmt.Errorf("Missing parameter") + } + + var ( + job = eng.Job("inspect", vars["name"], "container") + c, err = job.Stdout.AddEnv() + ) + if err != nil { + return err + } + if err = job.Run(); err != nil { + return err + } + + var outStream, errStream io.Writer + outStream = utils.NewWriteFlusher(w) + + if c.GetSubEnv("Config") != nil && !c.GetSubEnv("Config").GetBool("Tty") && version.GreaterThanOrEqualTo("1.6") { + errStream = utils.NewStdWriter(outStream, utils.Stderr) + outStream = utils.NewStdWriter(outStream, utils.Stdout) + } else { + errStream = outStream + } + + job = eng.Job("logs", vars["name"]) + job.Setenv("follow", r.Form.Get("follow")) + job.Setenv("stdout", r.Form.Get("stdout")) + job.Setenv("stderr", r.Form.Get("stderr")) + job.Setenv("timestamps", r.Form.Get("timestamps")) + job.Stdout.Add(outStream) + job.Stderr.Set(errStream) + if err := job.Run(); err != nil { + fmt.Fprintf(outStream, "Error: %s\n", err) + } + return nil +} + func postImagesTag(eng *engine.Engine, version version.Version, w http.ResponseWriter, r *http.Request, vars map[string]string) error { if err := parseForm(r); err != nil { return err @@ -1017,6 +1059,7 @@ func createRouter(eng *engine.Engine, logging, enableCors bool, dockerVersion st "/containers/{name:.*}/changes": getContainersChanges, "/containers/{name:.*}/json": getContainersByName, "/containers/{name:.*}/top": getContainersTop, + "/containers/{name:.*}/logs": getContainersLogs, "/containers/{name:.*}/attach/ws": wsContainersAttach, }, "POST": { diff --git a/daemon/container.go b/daemon/container.go index 5e4b72bf12..1c6dc077dc 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -473,6 +473,18 @@ func (container *Container) StderrPipe() (io.ReadCloser, error) { return utils.NewBufReader(reader), nil } +func (container *Container) StdoutLogPipe() io.ReadCloser { + reader, writer := io.Pipe() + container.stdout.AddWriter(writer, "stdout") + return utils.NewBufReader(reader) +} + +func (container *Container) StderrLogPipe() io.ReadCloser { + reader, writer := io.Pipe() + container.stderr.AddWriter(writer, "stderr") + return utils.NewBufReader(reader) +} + func (container *Container) buildHostnameAndHostsFiles(IP string) { container.HostnamePath = path.Join(container.root, "hostname") ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md index a6aafbeee8..d6c25c75f2 100644 --- a/docs/sources/reference/api/docker_remote_api.md +++ b/docs/sources/reference/api/docker_remote_api.md @@ -45,6 +45,10 @@ You can still call an old version of the api using You can now use the `-until` parameter to close connection after timestamp. +`GET /containers/(id)/logs` + +This url is prefered method for getting container logs now. + ### v1.10 #### Full Documentation diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.md b/docs/sources/reference/api/docker_remote_api_v1.11.md index 40dee1af63..ddff4e19d0 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.11.md +++ b/docs/sources/reference/api/docker_remote_api_v1.11.md @@ -300,6 +300,42 @@ List processes running inside the container `id` - **404** – no such container - **500** – server error +### Get container logs + +`GET /containers/(id)/logs` + +Get stdout and stderr logs from the container ``id`` + + **Example request**: + + GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1×tamps=1&follow=1 HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + Content-Type: application/vnd.docker.raw-stream + + {{ STREAM }} + + Query Parameters: + +   + + - **follow** – 1/True/true or 0/False/false, return stream. + Default false + - **stdout** – 1/True/true or 0/False/false, if logs=true, return + stdout log. Default false + - **stderr** – 1/True/true or 0/False/false, if logs=true, return + stderr log. Default false + - **timestamps** – 1/True/true or 0/False/false, if logs=true, print + timestamps for every log line. Default false + + Status Codes: + + - **200** – no error + - **404** – no such container + - **500** – server error + ### Inspect changes on a container's filesystem `GET /containers/(id)/changes` diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index 75a5be33b6..49e5860ea9 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -649,13 +649,14 @@ Fetch the logs of a container Usage: docker logs [OPTIONS] CONTAINER -f, --follow=false: Follow log output + -t, --timestamps=false: Show timestamps The `docker logs` command batch-retrieves all logs present at the time of execution. -The `docker logs --follow` command combines `docker logs` and `docker -attach`: it will first return all logs from the beginning and then -continue streaming new output from the container'sstdout and stderr. +The ``docker logs --follow`` command will first return all logs from the +beginning and then continue streaming new output from the container's stdout +and stderr. ## port diff --git a/integration-cli/docker_cli_logs_test.go b/integration-cli/docker_cli_logs_test.go index 8fcf4d7333..75235b6bb8 100644 --- a/integration-cli/docker_cli_logs_test.go +++ b/integration-cli/docker_cli_logs_test.go @@ -3,7 +3,10 @@ package main import ( "fmt" "os/exec" + "regexp" + "strings" "testing" + "time" ) // This used to work, it test a log of PageSize-1 (gh#4851) @@ -74,3 +77,95 @@ func TestLogsContainerMuchBiggerThanPage(t *testing.T) { logDone("logs - logs container running echo much bigger than page size") } + +func TestLogsTimestamps(t *testing.T) { + testLen := 100 + runCmd := exec.Command(dockerBinary, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("for i in $(seq 1 %d); do echo =; done;", testLen)) + + out, _, _, err := runCommandWithStdoutStderr(runCmd) + errorOut(err, t, fmt.Sprintf("run failed with errors: %v", err)) + + cleanedContainerID := stripTrailingCharacters(out) + exec.Command(dockerBinary, "wait", cleanedContainerID).Run() + + logsCmd := exec.Command(dockerBinary, "logs", "-t", cleanedContainerID) + out, _, _, err = runCommandWithStdoutStderr(logsCmd) + errorOut(err, t, fmt.Sprintf("failed to log container: %v %v", out, err)) + + lines := strings.Split(out, "\n") + + if len(lines) != testLen+1 { + t.Fatalf("Expected log %d lines, received %d\n", testLen+1, len(lines)) + } + + ts := regexp.MustCompile(`^\[.*?\]`) + + for _, l := range lines { + if l != "" { + _, err := time.Parse("["+time.StampMilli+"]", ts.FindString(l)) + if err != nil { + t.Fatalf("Failed to parse timestamp from %v: %v", l, err) + } + } + } + + deleteContainer(cleanedContainerID) + + logDone("logs - logs with timestamps") +} + +func TestLogsSeparateStderr(t *testing.T) { + msg := "stderr_log" + runCmd := exec.Command(dockerBinary, "run", "-d", "busybox", "sh", "-c", fmt.Sprintf("echo %s 1>&2", msg)) + + out, _, _, err := runCommandWithStdoutStderr(runCmd) + errorOut(err, t, fmt.Sprintf("run failed with errors: %v", err)) + + cleanedContainerID := stripTrailingCharacters(out) + exec.Command(dockerBinary, "wait", cleanedContainerID).Run() + + logsCmd := exec.Command(dockerBinary, "logs", cleanedContainerID) + stdout, stderr, _, err := runCommandWithStdoutStderr(logsCmd) + errorOut(err, t, fmt.Sprintf("failed to log container: %v %v", out, err)) + + if stdout != "" { + t.Fatalf("Expected empty stdout stream, got %v", stdout) + } + + stderr = strings.TrimSpace(stderr) + if stderr != msg { + t.Fatalf("Expected %v in stderr stream, got %v", msg, stderr) + } + + deleteContainer(cleanedContainerID) + + logDone("logs - separate stderr (without pseudo-tty)") +} + +func TestLogsStderrInStdout(t *testing.T) { + msg := "stderr_log" + runCmd := exec.Command(dockerBinary, "run", "-d", "-t", "busybox", "sh", "-c", fmt.Sprintf("echo %s 1>&2", msg)) + + out, _, _, err := runCommandWithStdoutStderr(runCmd) + errorOut(err, t, fmt.Sprintf("run failed with errors: %v", err)) + + cleanedContainerID := stripTrailingCharacters(out) + exec.Command(dockerBinary, "wait", cleanedContainerID).Run() + + logsCmd := exec.Command(dockerBinary, "logs", cleanedContainerID) + stdout, stderr, _, err := runCommandWithStdoutStderr(logsCmd) + errorOut(err, t, fmt.Sprintf("failed to log container: %v %v", out, err)) + + if stderr != "" { + t.Fatalf("Expected empty stderr stream, got %v", stdout) + } + + stdout = strings.TrimSpace(stdout) + if stdout != msg { + t.Fatalf("Expected %v in stdout stream, got %v", msg, stdout) + } + + deleteContainer(cleanedContainerID) + + logDone("logs - stderr in stdout (with pseudo-tty)") +} diff --git a/server/server.go b/server/server.go index 51dd24b3fe..ea3487bf88 100644 --- a/server/server.go +++ b/server/server.go @@ -124,6 +124,7 @@ func InitServer(job *engine.Job) engine.Status { "container_copy": srv.ContainerCopy, "insert": srv.ImageInsert, "attach": srv.ContainerAttach, + "logs": srv.ContainerLogs, "search": srv.ImagesSearch, "changes": srv.ContainerChanges, "top": srv.ContainerTop, @@ -2252,6 +2253,96 @@ func (srv *Server) ContainerResize(job *engine.Job) engine.Status { return job.Errorf("No such container: %s", name) } +func (srv *Server) ContainerLogs(job *engine.Job) engine.Status { + if len(job.Args) != 1 { + return job.Errorf("Usage: %s CONTAINER\n", job.Name) + } + + var ( + name = job.Args[0] + stdout = job.GetenvBool("stdout") + stderr = job.GetenvBool("stderr") + follow = job.GetenvBool("follow") + times = job.GetenvBool("timestamps") + format string + ) + if !(stdout || stderr) { + return job.Errorf("You must choose at least one stream") + } + if times { + format = time.StampMilli + } + container := srv.daemon.Get(name) + if container == nil { + return job.Errorf("No such container: %s", name) + } + cLog, err := container.ReadLog("json") + if err != nil && os.IsNotExist(err) { + // Legacy logs + utils.Debugf("Old logs format") + if stdout { + cLog, err := container.ReadLog("stdout") + if err != nil { + utils.Errorf("Error reading logs (stdout): %s", err) + } else if _, err := io.Copy(job.Stdout, cLog); err != nil { + utils.Errorf("Error streaming logs (stdout): %s", err) + } + } + if stderr { + cLog, err := container.ReadLog("stderr") + if err != nil { + utils.Errorf("Error reading logs (stderr): %s", err) + } else if _, err := io.Copy(job.Stderr, cLog); err != nil { + utils.Errorf("Error streaming logs (stderr): %s", err) + } + } + } else if err != nil { + utils.Errorf("Error reading logs (json): %s", err) + } else { + dec := json.NewDecoder(cLog) + for { + l := &utils.JSONLog{} + + if err := dec.Decode(l); err == io.EOF { + break + } else if err != nil { + utils.Errorf("Error streaming logs: %s", err) + break + } + logLine := l.Log + if times { + logLine = fmt.Sprintf("[%s] %s", l.Created.Format(format), logLine) + } + if l.Stream == "stdout" && stdout { + fmt.Fprintf(job.Stdout, "%s", logLine) + } + if l.Stream == "stderr" && stderr { + fmt.Fprintf(job.Stderr, "%s", logLine) + } + } + } + if follow { + errors := make(chan error, 2) + if stdout { + stdoutPipe := container.StdoutLogPipe() + go func() { + errors <- utils.WriteLog(stdoutPipe, job.Stdout, format) + }() + } + if stderr { + stderrPipe := container.StderrLogPipe() + go func() { + errors <- utils.WriteLog(stderrPipe, job.Stderr, format) + }() + } + err := <-errors + if err != nil { + utils.Errorf("%s", err) + } + } + return engine.StatusOK +} + func (srv *Server) ContainerAttach(job *engine.Job) engine.Status { if len(job.Args) != 1 { return job.Errorf("Usage: %s CONTAINER\n", job.Name) diff --git a/utils/utils.go b/utils/utils.go index 8b6db8c464..066cfbac5a 100644 --- a/utils/utils.go +++ b/utils/utils.go @@ -341,18 +341,15 @@ func (r *bufReader) Close() error { type WriteBroadcaster struct { sync.Mutex buf *bytes.Buffer - writers map[StreamWriter]bool -} - -type StreamWriter struct { - wc io.WriteCloser - stream string + streams map[string](map[io.WriteCloser]struct{}) } func (w *WriteBroadcaster) AddWriter(writer io.WriteCloser, stream string) { w.Lock() - sw := StreamWriter{wc: writer, stream: stream} - w.writers[sw] = true + if _, ok := w.streams[stream]; !ok { + w.streams[stream] = make(map[io.WriteCloser]struct{}) + } + w.streams[stream][writer] = struct{}{} w.Unlock() } @@ -362,33 +359,83 @@ type JSONLog struct { Created time.Time `json:"time"` } +func (jl *JSONLog) Format(format string) (string, error) { + if format == "" { + return jl.Log, nil + } + if format == "json" { + m, err := json.Marshal(jl) + return string(m), err + } + return fmt.Sprintf("[%s] %s", jl.Created.Format(format), jl.Log), nil +} + +func WriteLog(src io.Reader, dst io.WriteCloser, format string) error { + dec := json.NewDecoder(src) + for { + l := &JSONLog{} + + if err := dec.Decode(l); err == io.EOF { + return nil + } else if err != nil { + Errorf("Error streaming logs: %s", err) + return err + } + line, err := l.Format(format) + if err != nil { + return err + } + fmt.Fprintf(dst, "%s", line) + } +} + +type LogFormatter struct { + wc io.WriteCloser + timeFormat string +} + func (w *WriteBroadcaster) Write(p []byte) (n int, err error) { + created := time.Now().UTC() w.Lock() defer w.Unlock() + if writers, ok := w.streams[""]; ok { + for sw := range writers { + if n, err := sw.Write(p); err != nil || n != len(p) { + // On error, evict the writer + delete(writers, sw) + } + } + } w.buf.Write(p) - for sw := range w.writers { - lp := p - if sw.stream != "" { - lp = nil - for { - line, err := w.buf.ReadString('\n') + lines := []string{} + for { + line, err := w.buf.ReadString('\n') + if err != nil { + w.buf.Write([]byte(line)) + break + } + lines = append(lines, line) + } + + if len(lines) != 0 { + for stream, writers := range w.streams { + if stream == "" { + continue + } + var lp []byte + for _, line := range lines { + b, err := json.Marshal(&JSONLog{Log: line, Stream: stream, Created: created}) if err != nil { - w.buf.Write([]byte(line)) - break - } - b, err := json.Marshal(&JSONLog{Log: line, Stream: sw.stream, Created: time.Now().UTC()}) - if err != nil { - // On error, evict the writer - delete(w.writers, sw) - continue + Errorf("Error making JSON log line: %s", err) } lp = append(lp, b...) lp = append(lp, '\n') } - } - if n, err := sw.wc.Write(lp); err != nil || n != len(lp) { - // On error, evict the writer - delete(w.writers, sw) + for sw := range writers { + if _, err := sw.Write(lp); err != nil { + delete(writers, sw) + } + } } } return len(p), nil @@ -397,15 +444,20 @@ func (w *WriteBroadcaster) Write(p []byte) (n int, err error) { func (w *WriteBroadcaster) CloseWriters() error { w.Lock() defer w.Unlock() - for sw := range w.writers { - sw.wc.Close() + for _, writers := range w.streams { + for w := range writers { + w.Close() + } } - w.writers = make(map[StreamWriter]bool) + w.streams = make(map[string](map[io.WriteCloser]struct{})) return nil } func NewWriteBroadcaster() *WriteBroadcaster { - return &WriteBroadcaster{writers: make(map[StreamWriter]bool), buf: bytes.NewBuffer(nil)} + return &WriteBroadcaster{ + streams: make(map[string](map[io.WriteCloser]struct{})), + buf: bytes.NewBuffer(nil), + } } func GetTotalUsedFds() int { From 24f9187a0467ca66c30e26c3d9e3ee58daeb720f Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Mon, 31 Mar 2014 11:06:39 +0200 Subject: [PATCH 359/436] beam: Add simple framing system for UnixConn This is needed for Send/Recieve to correctly handle borders between the messages. The framing uses a single 32bit uint32 length for each frame, of which the high bit is used to indicate whether the message contains a file descriptor or not. This is enough to separate out each message sent and to decide to which message each file descriptors belongs, even though multiple Sends may be coalesced into a single read, and/or one Send can be split into multiple writes. Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: alexlarsson) Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- pkg/beam/unix.go | 166 ++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 136 insertions(+), 30 deletions(-) diff --git a/pkg/beam/unix.go b/pkg/beam/unix.go index b480c47eb9..b2d0d94150 100644 --- a/pkg/beam/unix.go +++ b/pkg/beam/unix.go @@ -21,6 +21,43 @@ func debugCheckpoint(msg string, args ...interface{}) { type UnixConn struct { *net.UnixConn + fds []*os.File +} + +// Framing: +// In order to handle framing in Send/Recieve, as these give frame +// boundaries we use a very simple 4 bytes header. It is a big endiand +// uint32 where the high bit is set if the message includes a file +// descriptor. The rest of the uint32 is the length of the next frame. +// We need the bit in order to be able to assign recieved fds to +// the right message, as multiple messages may be coalesced into +// a single recieve operation. +func makeHeader(data []byte, fds []int) ([]byte, error) { + header := make([]byte, 4) + + length := uint32(len(data)) + + if length > 0x7fffffff { + return nil, fmt.Errorf("Data to large") + } + + if len(fds) != 0 { + length = length | 0x80000000 + } + header[0] = byte((length >> 24) & 0xff) + header[1] = byte((length >> 16) & 0xff) + header[2] = byte((length >> 8) & 0xff) + header[3] = byte((length >> 0) & 0xff) + + return header, nil +} + +func parseHeader(header []byte) (uint32, bool) { + length := uint32(header[0])<<24 | uint32(header[1])<<16 | uint32(header[2])<<8 | uint32(header[3]) + hasFd := length&0x80000000 != 0 + length = length & ^uint32(0x80000000) + + return length, hasFd } func FileConn(f *os.File) (*UnixConn, error) { @@ -33,7 +70,7 @@ func FileConn(f *os.File) (*UnixConn, error) { conn.Close() return nil, fmt.Errorf("%d: not a unix connection", f.Fd()) } - return &UnixConn{uconn}, nil + return &UnixConn{UnixConn: uconn}, nil } @@ -52,7 +89,7 @@ func (conn *UnixConn) Send(data []byte, f *os.File) error { if f != nil { fds = append(fds, int(f.Fd())) } - if err := sendUnix(conn.UnixConn, data, fds...); err != nil { + if err := conn.sendUnix(data, fds...); err != nil { return err } @@ -76,42 +113,104 @@ func (conn *UnixConn) Receive() (rdata []byte, rf *os.File, rerr error) { } debugCheckpoint("===DEBUG=== Receive() -> '%s'[%d]. Hit enter to continue.\n", rdata, fd) }() - for { - data, fds, err := receiveUnix(conn.UnixConn) + + // Read header + header := make([]byte, 4) + nRead := uint32(0) + + for nRead < 4 { + n, err := conn.receiveUnix(header[nRead:]) if err != nil { return nil, nil, err } - var f *os.File - if len(fds) > 1 { - for _, fd := range fds[1:] { - syscall.Close(fd) - } - } - if len(fds) >= 1 { - f = os.NewFile(uintptr(fds[0]), "") - } - return data, f, nil + nRead = nRead + uint32(n) } - panic("impossibru") - return nil, nil, nil + + length, hasFd := parseHeader(header) + + if hasFd { + if len(conn.fds) == 0 { + return nil, nil, fmt.Errorf("No expected file descriptor in message") + } + + rf = conn.fds[0] + conn.fds = conn.fds[1:] + } + + rdata = make([]byte, length) + + nRead = 0 + for nRead < length { + n, err := conn.receiveUnix(rdata[nRead:]) + if err != nil { + return nil, nil, err + } + nRead = nRead + uint32(n) + } + + return } -func receiveUnix(conn *net.UnixConn) ([]byte, []int, error) { - buf := make([]byte, 4096) - oob := make([]byte, 4096) +func (conn *UnixConn) receiveUnix(buf []byte) (int, error) { + oob := make([]byte, syscall.CmsgSpace(4)) bufn, oobn, _, _, err := conn.ReadMsgUnix(buf, oob) if err != nil { - return nil, nil, err + return 0, err } - return buf[:bufn], extractFds(oob[:oobn]), nil + fd := extractFd(oob[:oobn]) + if fd != -1 { + f := os.NewFile(uintptr(fd), "") + conn.fds = append(conn.fds, f) + } + + return bufn, nil } -func sendUnix(conn *net.UnixConn, data []byte, fds ...int) error { - _, _, err := conn.WriteMsgUnix(data, syscall.UnixRights(fds...), nil) - return err +func (conn *UnixConn) sendUnix(data []byte, fds ...int) error { + header, err := makeHeader(data, fds) + if err != nil { + return err + } + + // There is a bug in conn.WriteMsgUnix where it doesn't correctly return + // the number of bytes writte (http://code.google.com/p/go/issues/detail?id=7645) + // So, we can't rely on the return value from it. However, we must use it to + // send the fds. In order to handle this we only write one byte using WriteMsgUnix + // (when we have to), as that can only ever block or fully suceed. We then write + // the rest with conn.Write() + // The reader side should not rely on this though, as hopefully this gets fixed + // in go later. + written := 0 + if len(fds) != 0 { + oob := syscall.UnixRights(fds...) + wrote, _, err := conn.WriteMsgUnix(header[0:1], oob, nil) + if err != nil { + return err + } + written = written + wrote + } + + for written < len(header) { + wrote, err := conn.Write(header[written:]) + if err != nil { + return err + } + written = written + wrote + } + + written = 0 + for written < len(data) { + wrote, err := conn.Write(data[written:]) + if err != nil { + return err + } + written = written + wrote + } + + return nil } -func extractFds(oob []byte) (fds []int) { +func extractFd(oob []byte) int { // Grab forklock to make sure no forks accidentally inherit the new // fds before they are made CLOEXEC // There is a slight race condition between ReadMsgUnix returns and @@ -122,20 +221,27 @@ func extractFds(oob []byte) (fds []int) { defer syscall.ForkLock.Unlock() scms, err := syscall.ParseSocketControlMessage(oob) if err != nil { - return + return -1 } + + foundFd := -1 for _, scm := range scms { - gotFds, err := syscall.ParseUnixRights(&scm) + fds, err := syscall.ParseUnixRights(&scm) if err != nil { continue } - fds = append(fds, gotFds...) for _, fd := range fds { - syscall.CloseOnExec(fd) + if foundFd == -1 { + syscall.CloseOnExec(fd) + foundFd = fd + } else { + syscall.Close(fd) + } } } - return + + return foundFd } func socketpair() ([2]int, error) { From cac0cea03f85191b3d92cdaeae827fdd93fb1b29 Mon Sep 17 00:00:00 2001 From: Eiichi Tsukata Date: Wed, 30 Apr 2014 15:20:22 +0900 Subject: [PATCH 360/436] drop CAP_SYSLOG capability Kernel capabilities for privileged syslog operations are currently splitted into CAP_SYS_ADMIN and CAP_SYSLOG since the following commit: http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=ce6ada35bdf710d16582cc4869c26722547e6f11 This patch drops CAP_SYSLOG to prevent containers from messing with host's syslog (e.g. `dmesg -c` clears up host's printk ring buffer). Closes #5491 Docker-DCO-1.1-Signed-off-by: Eiichi Tsukata (github: Etsukata) Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/execdriver/lxc/init.go | 1 + daemon/execdriver/native/template/default_template.go | 1 + pkg/libcontainer/container.json | 5 +++++ pkg/libcontainer/types.go | 1 + 4 files changed, 8 insertions(+) diff --git a/daemon/execdriver/lxc/init.go b/daemon/execdriver/lxc/init.go index 324bd5eff7..52d75fc9f8 100644 --- a/daemon/execdriver/lxc/init.go +++ b/daemon/execdriver/lxc/init.go @@ -149,6 +149,7 @@ func setupCapabilities(args *execdriver.InitArgs) error { capability.CAP_MAC_OVERRIDE, capability.CAP_MAC_ADMIN, capability.CAP_NET_ADMIN, + capability.CAP_SYSLOG, } c, err := capability.NewPid(os.Getpid()) diff --git a/daemon/execdriver/native/template/default_template.go b/daemon/execdriver/native/template/default_template.go index c354637fcb..5dbe21ecb0 100644 --- a/daemon/execdriver/native/template/default_template.go +++ b/daemon/execdriver/native/template/default_template.go @@ -25,6 +25,7 @@ func New() *libcontainer.Container { libcontainer.GetCapability("MAC_ADMIN"), libcontainer.GetCapability("NET_ADMIN"), libcontainer.GetCapability("MKNOD"), + libcontainer.GetCapability("SYSLOG"), }, Namespaces: libcontainer.Namespaces{ libcontainer.GetNamespace("NEWNS"), diff --git a/pkg/libcontainer/container.json b/pkg/libcontainer/container.json index f15a49ab05..20c1121911 100644 --- a/pkg/libcontainer/container.json +++ b/pkg/libcontainer/container.json @@ -91,6 +91,11 @@ "value" : 27, "key" : "MKNOD", "enabled" : true + }, + { + "value" : 34, + "key" : "SYSLOG", + "enabled" : false } ], "networks" : [ diff --git a/pkg/libcontainer/types.go b/pkg/libcontainer/types.go index ade3c32f1d..f5fe6cffa9 100644 --- a/pkg/libcontainer/types.go +++ b/pkg/libcontainer/types.go @@ -53,6 +53,7 @@ var ( {Key: "MAC_OVERRIDE", Value: capability.CAP_MAC_OVERRIDE, Enabled: false}, {Key: "MAC_ADMIN", Value: capability.CAP_MAC_ADMIN, Enabled: false}, {Key: "NET_ADMIN", Value: capability.CAP_NET_ADMIN, Enabled: false}, + {Key: "SYSLOG", Value: capability.CAP_SYSLOG, Enabled: false}, } ) From fa1e390cad4fd36683e9667795967c711a4867e3 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Thu, 1 May 2014 20:51:16 +0000 Subject: [PATCH 361/436] add apparmor to the Dockerfile Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- Dockerfile | 1 + 1 file changed, 1 insertion(+) diff --git a/Dockerfile b/Dockerfile index be2233ff87..bd9f415f2d 100644 --- a/Dockerfile +++ b/Dockerfile @@ -47,6 +47,7 @@ RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq \ ruby1.9.1 \ ruby1.9.1-dev \ s3cmd=1.1.0* \ + apparmor \ --no-install-recommends # Get and compile LXC 0.8 (since it is the most stable) From ae686c0486cf6e2c0c394c5eb7a26e7d59cf1472 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Thu, 1 May 2014 21:49:53 +0000 Subject: [PATCH 362/436] Revert "add apparmor to the Dockerfile" This reverts commit fa1e390cad4fd36683e9667795967c711a4867e3. Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- Dockerfile | 1 - 1 file changed, 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index bd9f415f2d..be2233ff87 100644 --- a/Dockerfile +++ b/Dockerfile @@ -47,7 +47,6 @@ RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq \ ruby1.9.1 \ ruby1.9.1-dev \ s3cmd=1.1.0* \ - apparmor \ --no-install-recommends # Get and compile LXC 0.8 (since it is the most stable) From de191e86321f7d3136ff42ff75826b8107399497 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Thu, 1 May 2014 21:52:29 +0000 Subject: [PATCH 363/436] skip apparmor with dind Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- hack/dind | 3 +++ pkg/apparmor/apparmor.go | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/hack/dind b/hack/dind index e3641a342f..d4731aff75 100755 --- a/hack/dind +++ b/hack/dind @@ -9,6 +9,9 @@ # Usage: dind CMD [ARG...] +# apparmor sucks and Docker needs to know that it's in a container (c) @tianon +export container=docker + # First, make sure that cgroups are mounted correctly. CGROUP=/sys/fs/cgroup diff --git a/pkg/apparmor/apparmor.go b/pkg/apparmor/apparmor.go index 0987398124..6fdb1f8958 100644 --- a/pkg/apparmor/apparmor.go +++ b/pkg/apparmor/apparmor.go @@ -13,7 +13,7 @@ import ( ) func IsEnabled() bool { - if _, err := os.Stat("/sys/kernel/security/apparmor"); err == nil { + if _, err := os.Stat("/sys/kernel/security/apparmor"); err == nil && os.Getenv("container") == "" { buf, err := ioutil.ReadFile("/sys/module/apparmor/parameters/enabled") return err == nil && len(buf) > 1 && buf[0] == 'Y' } From 1c4202a6142d238d41f10deff1f0548f7591350b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Petazzoni?= Date: Wed, 30 Apr 2014 18:00:42 -0700 Subject: [PATCH 364/436] Mount /proc and /sys read-only, except in privileged containers. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It has been pointed out that some files in /proc and /sys can be used to break out of containers. However, if those filesystems are mounted read-only, most of the known exploits are mitigated, since they rely on writing some file in those filesystems. This does not replace security modules (like SELinux or AppArmor), it is just another layer of security. Likewise, it doesn't mean that the other mitigations (shadowing parts of /proc or /sys with bind mounts) are useless. Those measures are still useful. As such, the shadowing of /proc/kcore is still enabled with both LXC and native drivers. Special care has to be taken with /proc/1/attr, which still needs to be mounted read-write in order to enable the AppArmor profile. It is bind-mounted from a private read-write mount of procfs. All that enforcement is done in dockerinit. The code doing the real work is in libcontainer. The init function for the LXC driver calls the function from libcontainer to avoid code duplication. Docker-DCO-1.1-Signed-off-by: Jérôme Petazzoni (github: jpetazzo) --- daemon/execdriver/lxc/driver.go | 5 ++ daemon/execdriver/lxc/lxc_template.go | 23 +++-- daemon/execdriver/native/create.go | 2 - integration-cli/docker_cli_run_test.go | 38 ++++++-- pkg/libcontainer/mount/init.go | 12 +-- pkg/libcontainer/nsinit/init.go | 14 ++- .../security/restrict/restrict.go | 86 ++++++++++++------- 7 files changed, 113 insertions(+), 67 deletions(-) diff --git a/daemon/execdriver/lxc/driver.go b/daemon/execdriver/lxc/driver.go index 6ee7f3c1dd..3fe44202ac 100644 --- a/daemon/execdriver/lxc/driver.go +++ b/daemon/execdriver/lxc/driver.go @@ -5,6 +5,7 @@ import ( "github.com/dotcloud/docker/daemon/execdriver" "github.com/dotcloud/docker/pkg/cgroups" "github.com/dotcloud/docker/pkg/label" + "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" "github.com/dotcloud/docker/pkg/system" "github.com/dotcloud/docker/utils" "io/ioutil" @@ -35,6 +36,10 @@ func init() { return err } + if err := restrict.Restrict("/", "/empty"); err != nil { + return err + } + if err := setupCapabilities(args); err != nil { return err } diff --git a/daemon/execdriver/lxc/lxc_template.go b/daemon/execdriver/lxc/lxc_template.go index bc94e7a19d..03d32e72b5 100644 --- a/daemon/execdriver/lxc/lxc_template.go +++ b/daemon/execdriver/lxc/lxc_template.go @@ -82,15 +82,12 @@ lxc.pivotdir = lxc_putold # NOTICE: These mounts must be applied within the namespace -# WARNING: procfs is a known attack vector and should probably be disabled -# if your userspace allows it. eg. see http://blog.zx2c4.com/749 +# WARNING: mounting procfs and/or sysfs read-write is a known attack vector. +# See e.g. http://blog.zx2c4.com/749 and http://bit.ly/T9CkqJ +# We mount them read-write here, but later, dockerinit will call the Restrict() function to remount them read-only. +# We cannot mount them directly read-only, because that would prevent loading AppArmor profiles. lxc.mount.entry = proc {{escapeFstabSpaces $ROOTFS}}/proc proc nosuid,nodev,noexec 0 0 - -# WARNING: sysfs is a known attack vector and should probably be disabled -# if your userspace allows it. eg. see http://bit.ly/T9CkqJ -{{if .Privileged}} lxc.mount.entry = sysfs {{escapeFstabSpaces $ROOTFS}}/sys sysfs nosuid,nodev,noexec 0 0 -{{end}} {{if .Tty}} lxc.mount.entry = {{.Console}} {{escapeFstabSpaces $ROOTFS}}/dev/console none bind,rw 0 0 @@ -111,14 +108,14 @@ lxc.mount.entry = {{$value.Source}} {{escapeFstabSpaces $ROOTFS}}/{{escapeFstabS {{if .AppArmor}} lxc.aa_profile = unconfined {{else}} -# not unconfined +# Let AppArmor normal confinement take place (i.e., not unconfined) {{end}} {{else}} -# restrict access to proc -lxc.mount.entry = {{.RestrictionSource}} {{escapeFstabSpaces $ROOTFS}}/proc/sys none bind,ro 0 0 -lxc.mount.entry = {{.RestrictionSource}} {{escapeFstabSpaces $ROOTFS}}/proc/irq none bind,ro 0 0 -lxc.mount.entry = {{.RestrictionSource}} {{escapeFstabSpaces $ROOTFS}}/proc/acpi none bind,ro 0 0 -lxc.mount.entry = {{escapeFstabSpaces $ROOTFS}}/dev/null {{escapeFstabSpaces $ROOTFS}}/proc/sysrq-trigger none bind,ro 0 0 +# Restrict access to some stuff in /proc. Note that /proc is already mounted +# read-only, so we don't need to bother about things that are just dangerous +# to write to (like sysrq-trigger). Also, recent kernels won't let a container +# peek into /proc/kcore, but let's cater for people who might run Docker on +# older kernels. Just in case. lxc.mount.entry = {{escapeFstabSpaces $ROOTFS}}/dev/null {{escapeFstabSpaces $ROOTFS}}/proc/kcore none bind,ro 0 0 {{end}} diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index 00e6fc4b26..6f663f916e 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -84,8 +84,6 @@ func (d *driver) setPrivileged(container *libcontainer.Container) error { } container.Cgroups.DeviceAccess = true - // add sysfs as a mount for privileged containers - container.Mounts = append(container.Mounts, libcontainer.Mount{Type: "sysfs"}) delete(container.Context, "restriction_path") if apparmor.IsEnabled() { diff --git a/integration-cli/docker_cli_run_test.go b/integration-cli/docker_cli_run_test.go index 83867267ae..b9737feeea 100644 --- a/integration-cli/docker_cli_run_test.go +++ b/integration-cli/docker_cli_run_test.go @@ -725,24 +725,46 @@ func TestUnPrivilegedCannotMount(t *testing.T) { logDone("run - test un-privileged cannot mount") } -func TestSysNotAvaliableInNonPrivilegedContainers(t *testing.T) { - cmd := exec.Command(dockerBinary, "run", "busybox", "ls", "/sys/kernel") +func TestSysNotWritableInNonPrivilegedContainers(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "busybox", "touch", "/sys/kernel/profiling") if code, err := runCommand(cmd); err == nil || code == 0 { - t.Fatal("sys should not be available in a non privileged container") + t.Fatal("sys should not be writable in a non privileged container") } deleteAllContainers() - logDone("run - sys not avaliable in non privileged container") + logDone("run - sys not writable in non privileged container") } -func TestSysAvaliableInPrivilegedContainers(t *testing.T) { - cmd := exec.Command(dockerBinary, "run", "--privileged", "busybox", "ls", "/sys/kernel") +func TestSysWritableInPrivilegedContainers(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "--privileged", "busybox", "touch", "/sys/kernel/profiling") if code, err := runCommand(cmd); err != nil || code != 0 { - t.Fatalf("sys should be available in privileged container") + t.Fatalf("sys should be writable in privileged container") } deleteAllContainers() - logDone("run - sys avaliable in privileged container") + logDone("run - sys writable in privileged container") +} + +func TestProcNotWritableInNonPrivilegedContainers(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "busybox", "touch", "/proc/sysrq-trigger") + if code, err := runCommand(cmd); err == nil || code == 0 { + t.Fatal("proc should not be writable in a non privileged container") + } + + deleteAllContainers() + + logDone("run - proc not writable in non privileged container") +} + +func TestProcWritableInPrivilegedContainers(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "--privileged", "busybox", "touch", "/proc/sysrq-trigger") + if code, err := runCommand(cmd); err != nil || code != 0 { + t.Fatalf("proc should be writable in privileged container") + } + + deleteAllContainers() + + logDone("run - proc writable in privileged container") } diff --git a/pkg/libcontainer/mount/init.go b/pkg/libcontainer/mount/init.go index 735970cded..cc3ce2158e 100644 --- a/pkg/libcontainer/mount/init.go +++ b/pkg/libcontainer/mount/init.go @@ -11,7 +11,6 @@ import ( "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/libcontainer" "github.com/dotcloud/docker/pkg/libcontainer/mount/nodes" - "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" "github.com/dotcloud/docker/pkg/system" ) @@ -51,11 +50,6 @@ func InitializeMountNamespace(rootfs, console string, container *libcontainer.Co if err := nodes.CopyN(rootfs, nodes.DefaultNodes); err != nil { return fmt.Errorf("copy dev nodes %s", err) } - if restrictionPath := container.Context["restriction_path"]; restrictionPath != "" { - if err := restrict.Restrict(rootfs, restrictionPath); err != nil { - return fmt.Errorf("restrict %s", err) - } - } if err := SetupPtmx(rootfs, console, container.Context["mount_label"]); err != nil { return err } @@ -124,10 +118,11 @@ func setupBindmounts(rootfs string, bindMounts libcontainer.Mounts) error { } // TODO: this is crappy right now and should be cleaned up with a better way of handling system and -// standard bind mounts allowing them to be more dymanic +// standard bind mounts allowing them to be more dynamic func newSystemMounts(rootfs, mountLabel string, mounts libcontainer.Mounts) []mount { systemMounts := []mount{ {source: "proc", path: filepath.Join(rootfs, "proc"), device: "proc", flags: defaultMountFlags}, + {source: "sysfs", path: filepath.Join(rootfs, "sys"), device: "sysfs", flags: defaultMountFlags}, } if len(mounts.OfType("devtmpfs")) == 1 { @@ -138,8 +133,5 @@ func newSystemMounts(rootfs, mountLabel string, mounts libcontainer.Mounts) []mo mount{source: "devpts", path: filepath.Join(rootfs, "dev", "pts"), device: "devpts", flags: syscall.MS_NOSUID | syscall.MS_NOEXEC, data: label.FormatMountLabel("newinstance,ptmxmode=0666,mode=620,gid=5", mountLabel)}, ) - if len(mounts.OfType("sysfs")) == 1 { - systemMounts = append(systemMounts, mount{source: "sysfs", path: filepath.Join(rootfs, "sys"), device: "sysfs", flags: defaultMountFlags}) - } return systemMounts } diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index faec12af32..bafb877cd9 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -16,6 +16,7 @@ import ( "github.com/dotcloud/docker/pkg/libcontainer/mount" "github.com/dotcloud/docker/pkg/libcontainer/network" "github.com/dotcloud/docker/pkg/libcontainer/security/capabilities" + "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" "github.com/dotcloud/docker/pkg/libcontainer/utils" "github.com/dotcloud/docker/pkg/system" "github.com/dotcloud/docker/pkg/user" @@ -68,18 +69,25 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, if err := system.Sethostname(container.Hostname); err != nil { return fmt.Errorf("sethostname %s", err) } - if err := FinalizeNamespace(container); err != nil { - return fmt.Errorf("finalize namespace %s", err) - } runtime.LockOSThread() + if restrictionPath := container.Context["restriction_path"]; restrictionPath != "" { + if err := restrict.Restrict("/", restrictionPath); err != nil { + return err + } + } + if err := apparmor.ApplyProfile(os.Getpid(), container.Context["apparmor_profile"]); err != nil { return err } if err := label.SetProcessLabel(container.Context["process_label"]); err != nil { return fmt.Errorf("set process label %s", err) } + + if err := FinalizeNamespace(container); err != nil { + return fmt.Errorf("finalize namespace %s", err) + } return system.Execv(args[0], args[0:], container.Env) } diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index 291d6ca5dc..8c08ea1806 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -9,43 +9,67 @@ import ( "github.com/dotcloud/docker/pkg/system" ) -const flags = syscall.MS_BIND | syscall.MS_REC | syscall.MS_RDONLY - -var restrictions = map[string]string{ - // dirs - "/proc/sys": "", - "/proc/irq": "", - "/proc/acpi": "", - - // files - "/proc/sysrq-trigger": "/dev/null", - "/proc/kcore": "/dev/null", +// "restrictions" are container paths (files, directories, whatever) that have to be masked. +// maskPath is a "safe" path to be mounted over maskedPath. It can take two special values: +// - if it is "", then nothing is mounted; +// - if it is "EMPTY", then an empty directory is mounted instead. +// If remountRO is true then the maskedPath is remounted read-only (regardless of whether a maskPath was used). +type restriction struct { + maskedPath string + maskPath string + remountRO bool } -// Restrict locks down access to many areas of proc -// by using the asumption that the user does not have mount caps to -// revert the changes made here -func Restrict(rootfs, empty string) error { - for dest, source := range restrictions { - dest = filepath.Join(rootfs, dest) +var restrictions = []restriction{ + {"/proc", "", true}, + {"/sys", "", true}, + {"/proc/kcore", "/dev/null", false}, +} - // we don't have a "/dev/null" for dirs so have the requester pass a dir - // for us to bind mount - switch source { - case "": - source = empty - default: - source = filepath.Join(rootfs, source) - } - if err := system.Mount(source, dest, "bind", flags, ""); err != nil { - if os.IsNotExist(err) { - continue +// This has to be called while the container still has CAP_SYS_ADMIN (to be able to perform mounts). +// However, afterwards, CAP_SYS_ADMIN should be dropped (otherwise the user will be able to revert those changes). +// "empty" should be the path to an empty directory. +func Restrict(rootfs, empty string) error { + for _, restriction := range restrictions { + dest := filepath.Join(rootfs, restriction.maskedPath) + if restriction.maskPath != "" { + var source string + if restriction.maskPath == "EMPTY" { + source = empty + } else { + source = filepath.Join(rootfs, restriction.maskPath) + } + if err := system.Mount(source, dest, "", syscall.MS_BIND, ""); err != nil { + return fmt.Errorf("unable to bind-mount %s over %s: %s", source, dest, err) } - return fmt.Errorf("unable to mount %s over %s %s", source, dest, err) } - if err := system.Mount("", dest, "bind", flags|syscall.MS_REMOUNT, ""); err != nil { - return fmt.Errorf("unable to mount %s over %s %s", source, dest, err) + if restriction.remountRO { + if err := system.Mount("", dest, "", syscall.MS_REMOUNT|syscall.MS_RDONLY, ""); err != nil { + return fmt.Errorf("unable to remount %s readonly: %s", dest, err) + } } } + + // This weird trick will allow us to mount /proc read-only, while being able to use AppArmor. + // This is because apparently, loading an AppArmor profile requires write access to /proc/1/attr. + // So we do another mount of procfs, ensure it's write-able, and bind-mount a subset of it. + tmpProcPath := filepath.Join(rootfs, ".proc") + if err := os.Mkdir(tmpProcPath, 0700); err != nil { + return fmt.Errorf("unable to create temporary proc mountpoint %s: %s", tmpProcPath, err) + } + if err := system.Mount("proc", tmpProcPath, "proc", 0, ""); err != nil { + return fmt.Errorf("unable to mount proc on temporary proc mountpoint: %s", err) + } + if err := system.Mount("proc", tmpProcPath, "", syscall.MS_REMOUNT, ""); err != nil { + return fmt.Errorf("unable to remount proc read-write: %s", err) + } + rwAttrPath := filepath.Join(rootfs, ".proc", "1", "attr") + roAttrPath := filepath.Join(rootfs, "proc", "1", "attr") + if err := system.Mount(rwAttrPath, roAttrPath, "", syscall.MS_BIND, ""); err != nil { + return fmt.Errorf("unable to bind-mount %s on %s: %s", rwAttrPath, roAttrPath, err) + } + if err := system.Unmount(tmpProcPath, 0); err != nil { + return fmt.Errorf("unable to unmount temporary proc filesystem: %s", err) + } return nil } From 83982e8b1d0cd825e1762b5540db8ae77c34f065 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Wed, 30 Apr 2014 19:09:25 -0700 Subject: [PATCH 365/436] Update to enable cross compile Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/nsinit/init.go | 1 - pkg/libcontainer/security/restrict/restrict.go | 2 ++ pkg/libcontainer/security/restrict/unsupported.go | 9 +++++++++ 3 files changed, 11 insertions(+), 1 deletion(-) create mode 100644 pkg/libcontainer/security/restrict/unsupported.go diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index bafb877cd9..90b97a9f99 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -84,7 +84,6 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, if err := label.SetProcessLabel(container.Context["process_label"]); err != nil { return fmt.Errorf("set process label %s", err) } - if err := FinalizeNamespace(container); err != nil { return fmt.Errorf("finalize namespace %s", err) } diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index 8c08ea1806..a9bdc4bacb 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -1,3 +1,5 @@ +// +build linux + package restrict import ( diff --git a/pkg/libcontainer/security/restrict/unsupported.go b/pkg/libcontainer/security/restrict/unsupported.go new file mode 100644 index 0000000000..6898baab3d --- /dev/null +++ b/pkg/libcontainer/security/restrict/unsupported.go @@ -0,0 +1,9 @@ +// +build !linux + +package restrict + +import "fmt" + +func Restrict(rootfs, empty string) error { + return fmt.Errorf("not supported") +} From f5139233b930e436707a65cc032aa2952edd6e4a Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Thu, 1 May 2014 10:08:18 -0700 Subject: [PATCH 366/436] Update restrictions for better handling of mounts This also cleans up some of the left over restriction paths code from before. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/execdriver/lxc/driver.go | 60 +++++++---------- daemon/execdriver/lxc/lxc_template.go | 12 +--- daemon/execdriver/native/create.go | 4 +- daemon/execdriver/native/driver.go | 7 -- pkg/libcontainer/mount/init.go | 7 +- pkg/libcontainer/nsinit/init.go | 4 +- .../security/restrict/restrict.go | 65 ++++++------------- .../security/restrict/unsupported.go | 2 +- 8 files changed, 54 insertions(+), 107 deletions(-) diff --git a/daemon/execdriver/lxc/driver.go b/daemon/execdriver/lxc/driver.go index 3fe44202ac..92a79ff5a5 100644 --- a/daemon/execdriver/lxc/driver.go +++ b/daemon/execdriver/lxc/driver.go @@ -2,12 +2,6 @@ package lxc import ( "fmt" - "github.com/dotcloud/docker/daemon/execdriver" - "github.com/dotcloud/docker/pkg/cgroups" - "github.com/dotcloud/docker/pkg/label" - "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" - "github.com/dotcloud/docker/pkg/system" - "github.com/dotcloud/docker/utils" "io/ioutil" "log" "os" @@ -18,6 +12,13 @@ import ( "strings" "syscall" "time" + + "github.com/dotcloud/docker/daemon/execdriver" + "github.com/dotcloud/docker/pkg/cgroups" + "github.com/dotcloud/docker/pkg/label" + "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" + "github.com/dotcloud/docker/pkg/system" + "github.com/dotcloud/docker/utils" ) const DriverName = "lxc" @@ -27,31 +28,26 @@ func init() { if err := setupEnv(args); err != nil { return err } - if err := setupHostname(args); err != nil { return err } - if err := setupNetworking(args); err != nil { return err } - - if err := restrict.Restrict("/", "/empty"); err != nil { - return err + if !args.Privileged { + if err := restrict.Restrict(); err != nil { + return err + } } - if err := setupCapabilities(args); err != nil { return err } - if err := setupWorkingDirectory(args); err != nil { return err } - if err := system.CloseFdsFrom(3); err != nil { return err } - if err := changeUser(args); err != nil { return err } @@ -69,10 +65,9 @@ func init() { } type driver struct { - root string // root path for the driver to use - apparmor bool - sharedRoot bool - restrictionPath string + root string // root path for the driver to use + apparmor bool + sharedRoot bool } func NewDriver(root string, apparmor bool) (*driver, error) { @@ -80,15 +75,10 @@ func NewDriver(root string, apparmor bool) (*driver, error) { if err := linkLxcStart(root); err != nil { return nil, err } - restrictionPath := filepath.Join(root, "empty") - if err := os.MkdirAll(restrictionPath, 0700); err != nil { - return nil, err - } return &driver{ - apparmor: apparmor, - root: root, - sharedRoot: rootIsShared(), - restrictionPath: restrictionPath, + apparmor: apparmor, + root: root, + sharedRoot: rootIsShared(), }, nil } @@ -419,16 +409,14 @@ func (d *driver) generateLXCConfig(c *execdriver.Command) (string, error) { if err := LxcTemplateCompiled.Execute(fo, struct { *execdriver.Command - AppArmor bool - ProcessLabel string - MountLabel string - RestrictionSource string + AppArmor bool + ProcessLabel string + MountLabel string }{ - Command: c, - AppArmor: d.apparmor, - ProcessLabel: process, - MountLabel: mount, - RestrictionSource: d.restrictionPath, + Command: c, + AppArmor: d.apparmor, + ProcessLabel: process, + MountLabel: mount, }); err != nil { return "", err } diff --git a/daemon/execdriver/lxc/lxc_template.go b/daemon/execdriver/lxc/lxc_template.go index 03d32e72b5..19fa43c4c2 100644 --- a/daemon/execdriver/lxc/lxc_template.go +++ b/daemon/execdriver/lxc/lxc_template.go @@ -1,10 +1,11 @@ package lxc import ( - "github.com/dotcloud/docker/daemon/execdriver" - "github.com/dotcloud/docker/pkg/label" "strings" "text/template" + + "github.com/dotcloud/docker/daemon/execdriver" + "github.com/dotcloud/docker/pkg/label" ) const LxcTemplate = ` @@ -110,13 +111,6 @@ lxc.aa_profile = unconfined {{else}} # Let AppArmor normal confinement take place (i.e., not unconfined) {{end}} -{{else}} -# Restrict access to some stuff in /proc. Note that /proc is already mounted -# read-only, so we don't need to bother about things that are just dangerous -# to write to (like sysrq-trigger). Also, recent kernels won't let a container -# peek into /proc/kcore, but let's cater for people who might run Docker on -# older kernels. Just in case. -lxc.mount.entry = {{escapeFstabSpaces $ROOTFS}}/dev/null {{escapeFstabSpaces $ROOTFS}}/proc/kcore none bind,ro 0 0 {{end}} # limits diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index 6f663f916e..5562d08986 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -24,7 +24,7 @@ func (d *driver) createContainer(c *execdriver.Command) (*libcontainer.Container container.Cgroups.Name = c.ID // check to see if we are running in ramdisk to disable pivot root container.NoPivotRoot = os.Getenv("DOCKER_RAMDISK") != "" - container.Context["restriction_path"] = d.restrictionPath + container.Context["restrictions"] = "true" if err := d.createNetwork(container, c); err != nil { return nil, err @@ -84,7 +84,7 @@ func (d *driver) setPrivileged(container *libcontainer.Container) error { } container.Cgroups.DeviceAccess = true - delete(container.Context, "restriction_path") + delete(container.Context, "restrictions") if apparmor.IsEnabled() { container.Context["apparmor_profile"] = "unconfined" diff --git a/daemon/execdriver/native/driver.go b/daemon/execdriver/native/driver.go index a397387f11..e674d57333 100644 --- a/daemon/execdriver/native/driver.go +++ b/daemon/execdriver/native/driver.go @@ -57,7 +57,6 @@ type driver struct { root string initPath string activeContainers map[string]*exec.Cmd - restrictionPath string } func NewDriver(root, initPath string) (*driver, error) { @@ -68,14 +67,8 @@ func NewDriver(root, initPath string) (*driver, error) { if err := apparmor.InstallDefaultProfile(filepath.Join(root, "../..", BackupApparmorProfilePath)); err != nil { return nil, err } - restrictionPath := filepath.Join(root, "empty") - if err := os.MkdirAll(restrictionPath, 0700); err != nil { - return nil, err - } - return &driver{ root: root, - restrictionPath: restrictionPath, initPath: initPath, activeContainers: make(map[string]*exec.Cmd), }, nil diff --git a/pkg/libcontainer/mount/init.go b/pkg/libcontainer/mount/init.go index cc3ce2158e..6a54f2444e 100644 --- a/pkg/libcontainer/mount/init.go +++ b/pkg/libcontainer/mount/init.go @@ -123,15 +123,12 @@ func newSystemMounts(rootfs, mountLabel string, mounts libcontainer.Mounts) []mo systemMounts := []mount{ {source: "proc", path: filepath.Join(rootfs, "proc"), device: "proc", flags: defaultMountFlags}, {source: "sysfs", path: filepath.Join(rootfs, "sys"), device: "sysfs", flags: defaultMountFlags}, + {source: "shm", path: filepath.Join(rootfs, "dev", "shm"), device: "tmpfs", flags: defaultMountFlags, data: label.FormatMountLabel("mode=1777,size=65536k", mountLabel)}, + {source: "devpts", path: filepath.Join(rootfs, "dev", "pts"), device: "devpts", flags: syscall.MS_NOSUID | syscall.MS_NOEXEC, data: label.FormatMountLabel("newinstance,ptmxmode=0666,mode=620,gid=5", mountLabel)}, } if len(mounts.OfType("devtmpfs")) == 1 { systemMounts = append(systemMounts, mount{source: "tmpfs", path: filepath.Join(rootfs, "dev"), device: "tmpfs", flags: syscall.MS_NOSUID | syscall.MS_STRICTATIME, data: label.FormatMountLabel("mode=755", mountLabel)}) } - systemMounts = append(systemMounts, - mount{source: "shm", path: filepath.Join(rootfs, "dev", "shm"), device: "tmpfs", flags: defaultMountFlags, data: label.FormatMountLabel("mode=1777,size=65536k", mountLabel)}, - mount{source: "devpts", path: filepath.Join(rootfs, "dev", "pts"), device: "devpts", flags: syscall.MS_NOSUID | syscall.MS_NOEXEC, data: label.FormatMountLabel("newinstance,ptmxmode=0666,mode=620,gid=5", mountLabel)}, - ) - return systemMounts } diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index 90b97a9f99..755847948e 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -72,8 +72,8 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, runtime.LockOSThread() - if restrictionPath := container.Context["restriction_path"]; restrictionPath != "" { - if err := restrict.Restrict("/", restrictionPath); err != nil { + if container.Context["restrictions"] != "" { + if err := restrict.Restrict(); err != nil { return err } } diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index a9bdc4bacb..2b7cea5a48 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -11,67 +11,42 @@ import ( "github.com/dotcloud/docker/pkg/system" ) -// "restrictions" are container paths (files, directories, whatever) that have to be masked. -// maskPath is a "safe" path to be mounted over maskedPath. It can take two special values: -// - if it is "", then nothing is mounted; -// - if it is "EMPTY", then an empty directory is mounted instead. -// If remountRO is true then the maskedPath is remounted read-only (regardless of whether a maskPath was used). -type restriction struct { - maskedPath string - maskPath string - remountRO bool -} - -var restrictions = []restriction{ - {"/proc", "", true}, - {"/sys", "", true}, - {"/proc/kcore", "/dev/null", false}, -} - // This has to be called while the container still has CAP_SYS_ADMIN (to be able to perform mounts). // However, afterwards, CAP_SYS_ADMIN should be dropped (otherwise the user will be able to revert those changes). -// "empty" should be the path to an empty directory. -func Restrict(rootfs, empty string) error { - for _, restriction := range restrictions { - dest := filepath.Join(rootfs, restriction.maskedPath) - if restriction.maskPath != "" { - var source string - if restriction.maskPath == "EMPTY" { - source = empty - } else { - source = filepath.Join(rootfs, restriction.maskPath) - } - if err := system.Mount(source, dest, "", syscall.MS_BIND, ""); err != nil { - return fmt.Errorf("unable to bind-mount %s over %s: %s", source, dest, err) - } - } - if restriction.remountRO { - if err := system.Mount("", dest, "", syscall.MS_REMOUNT|syscall.MS_RDONLY, ""); err != nil { - return fmt.Errorf("unable to remount %s readonly: %s", dest, err) - } +func Restrict() error { + // remount proc and sys as readonly + for _, dest := range []string{"proc", "sys"} { + if err := system.Mount("", dest, "", syscall.MS_REMOUNT|syscall.MS_RDONLY, ""); err != nil { + return fmt.Errorf("unable to remount %s readonly: %s", dest, err) } } + if err := system.Mount("/proc/kcore", "/dev/null", "", syscall.MS_BIND, ""); err != nil { + return fmt.Errorf("unable to bind-mount /dev/null over /proc/kcore") + } + // This weird trick will allow us to mount /proc read-only, while being able to use AppArmor. // This is because apparently, loading an AppArmor profile requires write access to /proc/1/attr. // So we do another mount of procfs, ensure it's write-able, and bind-mount a subset of it. - tmpProcPath := filepath.Join(rootfs, ".proc") - if err := os.Mkdir(tmpProcPath, 0700); err != nil { - return fmt.Errorf("unable to create temporary proc mountpoint %s: %s", tmpProcPath, err) + var ( + rwAttrPath = filepath.Join(".proc", "1", "attr") + roAttrPath = filepath.Join("proc", "1", "attr") + ) + + if err := os.Mkdir(".proc", 0700); err != nil { + return fmt.Errorf("unable to create temporary proc mountpoint .proc: %s", err) } - if err := system.Mount("proc", tmpProcPath, "proc", 0, ""); err != nil { + if err := system.Mount("proc", ".proc", "proc", 0, ""); err != nil { return fmt.Errorf("unable to mount proc on temporary proc mountpoint: %s", err) } - if err := system.Mount("proc", tmpProcPath, "", syscall.MS_REMOUNT, ""); err != nil { + if err := system.Mount("proc", ".proc", "", syscall.MS_REMOUNT, ""); err != nil { return fmt.Errorf("unable to remount proc read-write: %s", err) } - rwAttrPath := filepath.Join(rootfs, ".proc", "1", "attr") - roAttrPath := filepath.Join(rootfs, "proc", "1", "attr") if err := system.Mount(rwAttrPath, roAttrPath, "", syscall.MS_BIND, ""); err != nil { return fmt.Errorf("unable to bind-mount %s on %s: %s", rwAttrPath, roAttrPath, err) } - if err := system.Unmount(tmpProcPath, 0); err != nil { + if err := system.Unmount(".proc", 0); err != nil { return fmt.Errorf("unable to unmount temporary proc filesystem: %s", err) } - return nil + return os.RemoveAll(".proc") } diff --git a/pkg/libcontainer/security/restrict/unsupported.go b/pkg/libcontainer/security/restrict/unsupported.go index 6898baab3d..464e8d498d 100644 --- a/pkg/libcontainer/security/restrict/unsupported.go +++ b/pkg/libcontainer/security/restrict/unsupported.go @@ -4,6 +4,6 @@ package restrict import "fmt" -func Restrict(rootfs, empty string) error { +func Restrict() error { return fmt.Errorf("not supported") } From 3f74bdd93f08b3001f11a137210ee67a6d23c084 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Thu, 1 May 2014 11:11:29 -0700 Subject: [PATCH 367/436] Mount attr and task as rw for selinux support Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/security/restrict/restrict.go | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index 2b7cea5a48..74de70aa6a 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -28,11 +28,6 @@ func Restrict() error { // This weird trick will allow us to mount /proc read-only, while being able to use AppArmor. // This is because apparently, loading an AppArmor profile requires write access to /proc/1/attr. // So we do another mount of procfs, ensure it's write-able, and bind-mount a subset of it. - var ( - rwAttrPath = filepath.Join(".proc", "1", "attr") - roAttrPath = filepath.Join("proc", "1", "attr") - ) - if err := os.Mkdir(".proc", 0700); err != nil { return fmt.Errorf("unable to create temporary proc mountpoint .proc: %s", err) } @@ -42,8 +37,10 @@ func Restrict() error { if err := system.Mount("proc", ".proc", "", syscall.MS_REMOUNT, ""); err != nil { return fmt.Errorf("unable to remount proc read-write: %s", err) } - if err := system.Mount(rwAttrPath, roAttrPath, "", syscall.MS_BIND, ""); err != nil { - return fmt.Errorf("unable to bind-mount %s on %s: %s", rwAttrPath, roAttrPath, err) + for _, path := range []string{"attr", "task"} { + if err := system.Mount(filepath.Join(".proc", "1", path), filepath.Join("proc", "1", path), "", syscall.MS_BIND, ""); err != nil { + return fmt.Errorf("unable to bind-mount %s: %s", path, err) + } } if err := system.Unmount(".proc", 0); err != nil { return fmt.Errorf("unable to unmount temporary proc filesystem: %s", err) From 24e0df8136c238cb3e231b939a82058950e6eb02 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Thu, 1 May 2014 13:55:23 -0700 Subject: [PATCH 368/436] Fix /proc/kcore mount of /dev/null Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/libcontainer/security/restrict/restrict.go | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index 74de70aa6a..411bc06807 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -20,8 +20,7 @@ func Restrict() error { return fmt.Errorf("unable to remount %s readonly: %s", dest, err) } } - - if err := system.Mount("/proc/kcore", "/dev/null", "", syscall.MS_BIND, ""); err != nil { + if err := system.Mount("/dev/null", "/proc/kcore", "", syscall.MS_BIND, ""); err != nil { return fmt.Errorf("unable to bind-mount /dev/null over /proc/kcore") } From 71e3757174c3c1617d636ddd7462c39617ba5a77 Mon Sep 17 00:00:00 2001 From: Victor Marmol Date: Thu, 1 May 2014 15:51:38 -0700 Subject: [PATCH 369/436] Adding Rohit Jnagal and Victor Marmol to pkg/libcontainer maintainers. Docker-DCO-1.1-Signed-off-by: Victor Marmol (github: vmarmol) --- pkg/libcontainer/MAINTAINERS | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pkg/libcontainer/MAINTAINERS b/pkg/libcontainer/MAINTAINERS index 1cb551364d..41f04602ee 100644 --- a/pkg/libcontainer/MAINTAINERS +++ b/pkg/libcontainer/MAINTAINERS @@ -1,2 +1,4 @@ Michael Crosby (@crosbymichael) Guillaume J. Charmes (@creack) +Rohit Jnagal (@rjnagal) +Victor Marmol (@vmarmol) From de49e7c0a640aada97ace458a4e5d63f5f52d4eb Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Thu, 1 May 2014 14:39:43 +1000 Subject: [PATCH 370/436] Bring back archived remote API versions - git mv archived/* . - put the links back into the summary document - reduce the header depth by 1 so the TOC lists each API version - update the mkdocs.yaml to render the archived API docs, but not add them to the menu/nav Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/mkdocs.yml | 14 ++- .../reference/api/docker_remote_api.md | 103 ++++++++++-------- .../{archive => }/docker_remote_api_v1.0.md | 0 .../{archive => }/docker_remote_api_v1.1.md | 0 .../{archive => }/docker_remote_api_v1.2.md | 0 .../{archive => }/docker_remote_api_v1.3.md | 0 .../{archive => }/docker_remote_api_v1.4.md | 0 .../{archive => }/docker_remote_api_v1.5.md | 0 .../{archive => }/docker_remote_api_v1.6.md | 0 .../{archive => }/docker_remote_api_v1.7.md | 0 .../{archive => }/docker_remote_api_v1.8.md | 0 11 files changed, 72 insertions(+), 45 deletions(-) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.0.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.1.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.2.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.3.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.4.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.5.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.6.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.7.md (100%) rename docs/sources/reference/api/{archive => }/docker_remote_api_v1.8.md (100%) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 29b926816c..705ff0a549 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -103,12 +103,24 @@ pages: - ['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.11.md', 'Reference', 'Docker Remote API v1.10'] - ['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'] - ['reference/api/docker_io_oauth_api.md', 'Reference', 'Docker IO OAuth API'] - ['reference/api/docker_io_accounts_api.md', 'Reference', 'Docker IO Accounts API'] +#archived API references +- ['reference/api/docker_remote_api_v1.9.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.8.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.7.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.6.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.5.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.4.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.3.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.2.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.1.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.0.md', '**HIDDEN**'] + # Contribute: - ['contributing/index.md', '**HIDDEN**'] - ['contributing/contributing.md', 'Contribute', 'Contributing'] diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md index d6c25c75f2..8a490b52ee 100644 --- a/docs/sources/reference/api/docker_remote_api.md +++ b/docs/sources/reference/api/docker_remote_api.md @@ -4,8 +4,6 @@ page_keywords: API, Docker, rcli, REST, documentation # Docker Remote API -## 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 @@ -21,9 +19,8 @@ page_keywords: API, Docker, rcli, REST, documentation `{'username': string, 'password': string, 'email': string, 'serveraddress' : string}` -## 2. Versions -The current version of the API is 1.11 +The current version of the API is v1.11 Calling /images//insert is the same as calling /v1.11/images//insert @@ -31,13 +28,13 @@ Calling /images//insert is the same as calling You can still call an old version of the api using /v1.11/images//insert -### v1.11 +## v1.11 -#### Full Documentation +### Full Documentation -[*Docker Remote API v1.11*](../docker_remote_api_v1.11/) +[*Docker Remote API v1.11*](/reference/api/docker_remote_api_v1.11/) -#### What's new +### What's new `GET /events` @@ -49,13 +46,13 @@ after timestamp. This url is prefered method for getting container logs now. -### v1.10 +## v1.10 -#### Full Documentation +### Full Documentation -[*Docker Remote API v1.10*](../docker_remote_api_v1.10/) +[*Docker Remote API v1.10*](/reference/api/docker_remote_api_v1.10/) -#### What's new +### What's new `DELETE /images/(name)` @@ -72,13 +69,13 @@ You can now use the force parameter to force delete of an You can now use the force paramter to force delete a container, even if it is currently running -### v1.9 +## v1.9 -#### Full Documentation +### Full Documentation -[*Docker Remote API v1.9*](../docker_remote_api_v1.9/) +[*Docker Remote API v1.9*](/reference/api/docker_remote_api_v1.9/) -#### What's new +### What's new `POST /build` @@ -88,11 +85,13 @@ uses to resolve the proper registry auth credentials for pulling the base image. Clients which previously implemented the version accepting an AuthConfig object must be updated. -### v1.8 +## v1.8 -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.8*](/reference/api/docker_remote_api_v1.8/) + +### What's new `POST /build` @@ -118,11 +117,13 @@ progressDetail object was added in the JSON. It's now possible to get the current value and the total of the progress without having to parse the string. -### v1.7 +## v1.7 -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.7*](/reference/api/docker_remote_api_v1.7/) + +### What's new `GET /images/json` @@ -215,11 +216,13 @@ This URI no longer exists. The `images --viz` output is now generated in the client, using the `/images/json` data. -### v1.6 +## v1.6 -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.6*](/reference/api/docker_remote_api_v1.6/) + +### What's new `POST /containers/(id)/attach` @@ -227,15 +230,17 @@ output is now generated in the client, using the You can now split stderr from stdout. This is done by prefixing a header to each transmition. See [`POST /containers/(id)/attach`]( -../docker_remote_api_v1.9/#post--containers-(id)-attach "POST /containers/(id)/attach"). +/reference/api/docker_remote_api_v1.9/#post--containers-(id)-attach "POST /containers/(id)/attach"). The WebSocket attach is unchanged. Note that attach calls on the previous API version didn't change. Stdout and stderr are merged. -### v1.5 +## v1.5 -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.5*](/reference/api/docker_remote_api_v1.5/) + +### What's new `POST /images/create` @@ -256,11 +261,13 @@ The format of the Ports entry has been changed to a list of dicts each containing PublicPort, PrivatePort and Type describing a port mapping. -### v1.4 +## v1.4 -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.4*](/reference/api/docker_remote_api_v1.4/) + +### What's new `POST /images/create` @@ -278,14 +285,16 @@ You can now use ps args with docker top, like docker top **New!** Image's name added in the events -### v1.3 +## v1.3 docker v0.5.0 [51f6c4a](https://github.com/dotcloud/docker/commit/51f6c4a7372450d164c61e0054daf0223ddbd909) -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.3*](/reference/api/docker_remote_api_v1.3/) + +### What's new `GET /containers/(id)/top` @@ -316,14 +325,16 @@ Start containers (/containers//start): - You can now pass host-specific configuration (e.g. bind mounts) in the POST body for start calls -### v1.2 +## v1.2 docker v0.4.2 [2e7649b](https://github.com/dotcloud/docker/commit/2e7649beda7c820793bd46766cbc2cfeace7b168) -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.2*](/reference/api/docker_remote_api_v1.2/) + +### What's new The auth configuration is now handled by the client. @@ -346,14 +357,16 @@ Only checks the configuration but doesn't store it on the server Now returns a JSON structure with the list of images deleted/untagged. -### v1.1 +## v1.1 docker v0.4.0 [a8ae398](https://github.com/dotcloud/docker/commit/a8ae398bf52e97148ee7bd0d5868de2e15bd297f) -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.1*](/reference/api/docker_remote_api_v1.1/) + +### What's new `POST /images/create` @@ -371,13 +384,15 @@ Uses json stream instead of HTML hijack, it looks like this: {"error":"Invalid..."} ... -### v1.0 +## v1.0 docker v0.3.4 [8d73740](https://github.com/dotcloud/docker/commit/8d73740343778651c09160cde9661f5f387b36f4) -#### Full Documentation +### Full Documentation -#### What's new +[*Docker Remote API v1.0*](/reference/api/docker_remote_api_v1.0/) + +### What's new Initial version diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.0.md b/docs/sources/reference/api/docker_remote_api_v1.0.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.0.md rename to docs/sources/reference/api/docker_remote_api_v1.0.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.1.md b/docs/sources/reference/api/docker_remote_api_v1.1.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.1.md rename to docs/sources/reference/api/docker_remote_api_v1.1.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.2.md b/docs/sources/reference/api/docker_remote_api_v1.2.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.2.md rename to docs/sources/reference/api/docker_remote_api_v1.2.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.3.md b/docs/sources/reference/api/docker_remote_api_v1.3.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.3.md rename to docs/sources/reference/api/docker_remote_api_v1.3.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.4.md b/docs/sources/reference/api/docker_remote_api_v1.4.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.4.md rename to docs/sources/reference/api/docker_remote_api_v1.4.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.5.md b/docs/sources/reference/api/docker_remote_api_v1.5.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.5.md rename to docs/sources/reference/api/docker_remote_api_v1.5.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.6.md b/docs/sources/reference/api/docker_remote_api_v1.6.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.6.md rename to docs/sources/reference/api/docker_remote_api_v1.6.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.7.md b/docs/sources/reference/api/docker_remote_api_v1.7.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.7.md rename to docs/sources/reference/api/docker_remote_api_v1.7.md diff --git a/docs/sources/reference/api/archive/docker_remote_api_v1.8.md b/docs/sources/reference/api/docker_remote_api_v1.8.md similarity index 100% rename from docs/sources/reference/api/archive/docker_remote_api_v1.8.md rename to docs/sources/reference/api/docker_remote_api_v1.8.md From 5a8ffe7ef1c33996b9032fec2cf7cb2bf64793f0 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Thu, 1 May 2014 16:03:45 +1000 Subject: [PATCH 371/436] make sure the intermediate index.html files are generated consistently Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/mkdocs.yml | 28 ++++++++++----------------- docs/sources/docker-io/index.md | 15 -------------- docs/sources/reference/commandline.md | 7 ------- 3 files changed, 10 insertions(+), 40 deletions(-) delete mode 100644 docs/sources/docker-io/index.md delete mode 100644 docs/sources/reference/commandline.md diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 705ff0a549..dd6b987f11 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -91,6 +91,7 @@ pages: # Reference - ['reference/index.md', '**HIDDEN**'] +- ['reference/commandline/index.md', '**HIDDEN**'] - ['reference/commandline/cli.md', 'Reference', 'Command line'] - ['reference/builder.md', 'Reference', 'Dockerfile'] - ['reference/run.md', 'Reference', 'Run Reference'] @@ -99,6 +100,7 @@ pages: - ['articles/security.md', 'Reference', 'Security'] - ['articles/baseimages.md', 'Reference', 'Creating a Base Image'] - ['use/networking.md', 'Reference', 'Advanced networking'] +- ['reference/api/index.md', '**HIDDEN**'] - ['reference/api/docker-io_api.md', 'Reference', 'Docker.io API'] - ['reference/api/registry_api.md', 'Reference', 'Docker Registry API'] - ['reference/api/registry_index_spec.md', 'Reference', 'Registry & Index Spec'] @@ -109,24 +111,6 @@ pages: - ['reference/api/docker_io_oauth_api.md', 'Reference', 'Docker IO OAuth API'] - ['reference/api/docker_io_accounts_api.md', 'Reference', 'Docker IO Accounts API'] -#archived API references -- ['reference/api/docker_remote_api_v1.9.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.8.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.7.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.6.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.5.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.4.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.3.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.2.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.1.md', '**HIDDEN**'] -- ['reference/api/docker_remote_api_v1.0.md', '**HIDDEN**'] - -# Contribute: -- ['contributing/index.md', '**HIDDEN**'] -- ['contributing/contributing.md', 'Contribute', 'Contributing'] -- ['contributing/devenvironment.md', 'Contribute', 'Development environment'] -# - ['about/license.md', 'About', 'License'] - - ['jsearch.md', '**HIDDEN**'] # - ['static_files/README.md', 'static_files', 'README'] @@ -138,3 +122,11 @@ pages: - ['terms/repository.md', '**HIDDEN**'] - ['terms/filesystem.md', '**HIDDEN**'] - ['terms/image.md', '**HIDDEN**'] + +# TODO: our theme adds a dropdown even for sections that have no subsections. + #- ['faq.md', 'FAQ'] + +# Contribute: +- ['contributing/index.md', '**HIDDEN**'] +- ['contributing/contributing.md', 'Contribute', 'Contributing'] +- ['contributing/devenvironment.md', 'Contribute', 'Development environment'] diff --git a/docs/sources/docker-io/index.md b/docs/sources/docker-io/index.md deleted file mode 100644 index 747b4ee491..0000000000 --- a/docs/sources/docker-io/index.md +++ /dev/null @@ -1,15 +0,0 @@ -title -: Documentation - -description -: -- todo: change me - -keywords -: todo, docker, documentation, basic, builder - -Use -=== - -Contents: - -{{ site_name }} diff --git a/docs/sources/reference/commandline.md b/docs/sources/reference/commandline.md deleted file mode 100644 index b15f529394..0000000000 --- a/docs/sources/reference/commandline.md +++ /dev/null @@ -1,7 +0,0 @@ - -# Commands - -## Contents: - -- [Command Line](cli/) - From 314bd02d2ccd7ab59b67d02a53669028695dd3bc Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 00:25:10 +0000 Subject: [PATCH 372/436] remove when httputil.NewClientConn when not in hijack Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/client/utils.go | 48 ++++++++++++++++----------------------------- 1 file changed, 17 insertions(+), 31 deletions(-) diff --git a/api/client/utils.go b/api/client/utils.go index 7f7498dee7..152e3540ff 100644 --- a/api/client/utils.go +++ b/api/client/utils.go @@ -33,6 +33,18 @@ var ( ErrConnectionRefused = errors.New("Cannot connect to the Docker daemon. Is 'docker -d' running on this host?") ) +func (cli *DockerCli) HTTPClient() *http.Client { + tr := &http.Transport{ + Dial: func(network, addr string) (net.Conn, error) { + return net.Dial(cli.proto, cli.addr) + }, + } + if cli.proto != "unix" { + tr.TLSClientConfig = cli.tlsConfig + } + return &http.Client{Transport: tr} +} + func (cli *DockerCli) dial() (net.Conn, error) { if cli.tlsConfig != nil && cli.proto != "unix" { return tls.Dial(cli.proto, cli.addr, cli.tlsConfig) @@ -61,7 +73,7 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b re := regexp.MustCompile("/+") path = re.ReplaceAllString(path, "/") - req, err := http.NewRequest(method, fmt.Sprintf("/v%s%s", api.APIVERSION, path), params) + req, err := http.NewRequest(method, fmt.Sprintf("http://v%s%s", api.APIVERSION, path), params) if err != nil { return nil, -1, err } @@ -92,22 +104,13 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } else if method == "POST" { req.Header.Set("Content-Type", "plain/text") } - dial, err := cli.dial() + resp, err := cli.HTTPClient().Do(req) if err != nil { if strings.Contains(err.Error(), "connection refused") { return nil, -1, ErrConnectionRefused } return nil, -1, err } - clientconn := httputil.NewClientConn(dial, nil) - resp, err := clientconn.Do(req) - if err != nil { - clientconn.Close() - if strings.Contains(err.Error(), "connection refused") { - return nil, -1, ErrConnectionRefused - } - return nil, -1, err - } if resp.StatusCode < 200 || resp.StatusCode >= 400 { body, err := ioutil.ReadAll(resp.Body) @@ -119,14 +122,7 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } return nil, resp.StatusCode, fmt.Errorf("Error: %s", bytes.TrimSpace(body)) } - - wrapper := utils.NewReadCloserWrapper(resp.Body, func() error { - if resp != nil && resp.Body != nil { - resp.Body.Close() - } - return clientconn.Close() - }) - return wrapper, resp.StatusCode, nil + return resp.Body, resp.StatusCode, nil } func (cli *DockerCli) stream(method, path string, in io.Reader, out io.Writer, headers map[string][]string) error { @@ -142,7 +138,7 @@ func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in re := regexp.MustCompile("/+") path = re.ReplaceAllString(path, "/") - req, err := http.NewRequest(method, fmt.Sprintf("/v%s%s", api.APIVERSION, path), in) + req, err := http.NewRequest(method, fmt.Sprintf("http://v%s%s", api.APIVERSION, path), in) if err != nil { return err } @@ -157,17 +153,7 @@ func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in req.Header[k] = v } } - - dial, err := cli.dial() - if err != nil { - if strings.Contains(err.Error(), "connection refused") { - return fmt.Errorf("Cannot connect to the Docker daemon. Is 'docker -d' running on this host?") - } - return err - } - clientconn := httputil.NewClientConn(dial, nil) - resp, err := clientconn.Do(req) - defer clientconn.Close() + resp, err := cli.HTTPClient().Do(req) if err != nil { if strings.Contains(err.Error(), "connection refused") { return fmt.Errorf("Cannot connect to the Docker daemon. Is 'docker -d' running on this host?") From 41db1756268376465fd92038dfba1cca7f219595 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Fri, 2 May 2014 10:46:41 +1000 Subject: [PATCH 373/436] Force the older API docs to be generated. Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/mkdocs.yml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index dd6b987f11..c16436e892 100755 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -105,8 +105,18 @@ pages: - ['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.11.md', 'Reference', 'Docker Remote API v1.10'] +- ['reference/api/docker_remote_api_v1.11.md', 'Reference', 'Docker Remote API v1.11'] - ['reference/api/docker_remote_api_v1.10.md', 'Reference', 'Docker Remote API v1.10'] +- ['reference/api/docker_remote_api_v1.9.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.8.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.7.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.6.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.5.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.4.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.3.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.2.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.1.md', '**HIDDEN**'] +- ['reference/api/docker_remote_api_v1.0.md', '**HIDDEN**'] - ['reference/api/remote_api_client_libraries.md', 'Reference', 'Docker Remote API Client Libraries'] - ['reference/api/docker_io_oauth_api.md', 'Reference', 'Docker IO OAuth API'] - ['reference/api/docker_io_accounts_api.md', 'Reference', 'Docker IO Accounts API'] From 76fa7d588adfe644824d9a00dafce2d2991a7013 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Thu, 1 May 2014 19:09:12 -0700 Subject: [PATCH 374/436] Apply apparmor before restrictions There is not need for the remount hack, we use aa_change_onexec so the apparmor profile is not applied until we exec the users app. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- pkg/apparmor/apparmor.go | 2 +- pkg/apparmor/apparmor_disabled.go | 4 +-- pkg/libcontainer/console/console.go | 5 ++-- pkg/libcontainer/nsinit/init.go | 13 +++++----- .../security/restrict/restrict.go | 25 +------------------ 5 files changed, 12 insertions(+), 37 deletions(-) diff --git a/pkg/apparmor/apparmor.go b/pkg/apparmor/apparmor.go index 6fdb1f8958..704ee29ed0 100644 --- a/pkg/apparmor/apparmor.go +++ b/pkg/apparmor/apparmor.go @@ -20,7 +20,7 @@ func IsEnabled() bool { return false } -func ApplyProfile(pid int, name string) error { +func ApplyProfile(name string) error { if name == "" { return nil } diff --git a/pkg/apparmor/apparmor_disabled.go b/pkg/apparmor/apparmor_disabled.go index 77543e4a87..8d86ce9d4a 100644 --- a/pkg/apparmor/apparmor_disabled.go +++ b/pkg/apparmor/apparmor_disabled.go @@ -2,12 +2,10 @@ package apparmor -import () - func IsEnabled() bool { return false } -func ApplyProfile(pid int, name string) error { +func ApplyProfile(name string) error { return nil } diff --git a/pkg/libcontainer/console/console.go b/pkg/libcontainer/console/console.go index 05cd08a92e..5f06aea225 100644 --- a/pkg/libcontainer/console/console.go +++ b/pkg/libcontainer/console/console.go @@ -4,11 +4,12 @@ package console import ( "fmt" - "github.com/dotcloud/docker/pkg/label" - "github.com/dotcloud/docker/pkg/system" "os" "path/filepath" "syscall" + + "github.com/dotcloud/docker/pkg/label" + "github.com/dotcloud/docker/pkg/system" ) // Setup initializes the proper /dev/console inside the rootfs path diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index 755847948e..22345f603f 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -72,18 +72,17 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, runtime.LockOSThread() + if err := apparmor.ApplyProfile(container.Context["apparmor_profile"]); err != nil { + return fmt.Errorf("set apparmor profile %s: %s", container.Context["apparmor_profile"], err) + } + if err := label.SetProcessLabel(container.Context["process_label"]); err != nil { + return fmt.Errorf("set process label %s", err) + } if container.Context["restrictions"] != "" { if err := restrict.Restrict(); err != nil { return err } } - - if err := apparmor.ApplyProfile(os.Getpid(), container.Context["apparmor_profile"]); err != nil { - return err - } - if err := label.SetProcessLabel(container.Context["process_label"]); err != nil { - return fmt.Errorf("set process label %s", err) - } if err := FinalizeNamespace(container); err != nil { return fmt.Errorf("finalize namespace %s", err) } diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index 411bc06807..cfff09f512 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -4,8 +4,6 @@ package restrict import ( "fmt" - "os" - "path/filepath" "syscall" "github.com/dotcloud/docker/pkg/system" @@ -23,26 +21,5 @@ func Restrict() error { if err := system.Mount("/dev/null", "/proc/kcore", "", syscall.MS_BIND, ""); err != nil { return fmt.Errorf("unable to bind-mount /dev/null over /proc/kcore") } - - // This weird trick will allow us to mount /proc read-only, while being able to use AppArmor. - // This is because apparently, loading an AppArmor profile requires write access to /proc/1/attr. - // So we do another mount of procfs, ensure it's write-able, and bind-mount a subset of it. - if err := os.Mkdir(".proc", 0700); err != nil { - return fmt.Errorf("unable to create temporary proc mountpoint .proc: %s", err) - } - if err := system.Mount("proc", ".proc", "proc", 0, ""); err != nil { - return fmt.Errorf("unable to mount proc on temporary proc mountpoint: %s", err) - } - if err := system.Mount("proc", ".proc", "", syscall.MS_REMOUNT, ""); err != nil { - return fmt.Errorf("unable to remount proc read-write: %s", err) - } - for _, path := range []string{"attr", "task"} { - if err := system.Mount(filepath.Join(".proc", "1", path), filepath.Join("proc", "1", path), "", syscall.MS_BIND, ""); err != nil { - return fmt.Errorf("unable to bind-mount %s: %s", path, err) - } - } - if err := system.Unmount(".proc", 0); err != nil { - return fmt.Errorf("unable to unmount temporary proc filesystem: %s", err) - } - return os.RemoveAll(".proc") + return nil } From 877ad96d89093af8b16112c3534f4ceceaf1b7b3 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Fri, 2 May 2014 16:53:59 +0200 Subject: [PATCH 375/436] cli.md: Fix up Markdown formatting by adding one ` --- docs/sources/reference/commandline/cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index cfcab2af47..df55c4b2a2 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -244,7 +244,7 @@ See also: This example specifies that the `PATH` is `.`, and so all the files in the local directory get -tar`d and sent to the Docker daemon. The `PATH` +`tar`d and sent to the Docker daemon. The `PATH` specifies where to find the files for the "context" of the build on the Docker daemon. Remember that the daemon could be running on a remote machine and that no parsing of the Dockerfile From 8c9192cd76ad46bda3d0ec5ba7eb4a30669afb40 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 00:40:13 +0000 Subject: [PATCH 376/436] move hijack to it's own file Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/client/hijack.go | 133 ++++++++++++++++++++++++++++++++++++++++++ api/client/utils.go | 134 +------------------------------------------ 2 files changed, 134 insertions(+), 133 deletions(-) create mode 100644 api/client/hijack.go diff --git a/api/client/hijack.go b/api/client/hijack.go new file mode 100644 index 0000000000..0a9d5d8ef2 --- /dev/null +++ b/api/client/hijack.go @@ -0,0 +1,133 @@ +package client + +import ( + "crypto/tls" + "fmt" + "io" + "net" + "net/http" + "net/http/httputil" + "os" + "runtime" + "strings" + + "github.com/dotcloud/docker/api" + "github.com/dotcloud/docker/dockerversion" + "github.com/dotcloud/docker/pkg/term" + "github.com/dotcloud/docker/utils" +) + +func (cli *DockerCli) dial() (net.Conn, error) { + if cli.tlsConfig != nil && cli.proto != "unix" { + return tls.Dial(cli.proto, cli.addr, cli.tlsConfig) + } + return net.Dial(cli.proto, cli.addr) +} + +func (cli *DockerCli) hijack(method, path string, setRawTerminal bool, in io.ReadCloser, stdout, stderr io.Writer, started chan io.Closer) error { + defer func() { + if started != nil { + close(started) + } + }() + + req, err := http.NewRequest(method, fmt.Sprintf("/v%s%s", api.APIVERSION, path), nil) + if err != nil { + return err + } + req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION) + req.Header.Set("Content-Type", "plain/text") + req.Host = cli.addr + + dial, err := cli.dial() + if err != nil { + if strings.Contains(err.Error(), "connection refused") { + return fmt.Errorf("Cannot connect to the Docker daemon. Is 'docker -d' running on this host?") + } + return err + } + clientconn := httputil.NewClientConn(dial, nil) + defer clientconn.Close() + + // Server hijacks the connection, error 'connection closed' expected + clientconn.Do(req) + + rwc, br := clientconn.Hijack() + defer rwc.Close() + + if started != nil { + started <- rwc + } + + var receiveStdout chan error + + var oldState *term.State + + if in != nil && setRawTerminal && cli.isTerminal && os.Getenv("NORAW") == "" { + oldState, err = term.SetRawTerminal(cli.terminalFd) + if err != nil { + return err + } + defer term.RestoreTerminal(cli.terminalFd, oldState) + } + + if stdout != nil || stderr != nil { + receiveStdout = utils.Go(func() (err error) { + defer func() { + if in != nil { + if setRawTerminal && cli.isTerminal { + term.RestoreTerminal(cli.terminalFd, oldState) + } + // For some reason this Close call blocks on darwin.. + // As the client exists right after, simply discard the close + // until we find a better solution. + if runtime.GOOS != "darwin" { + in.Close() + } + } + }() + + // When TTY is ON, use regular copy + if setRawTerminal { + _, err = io.Copy(stdout, br) + } else { + _, err = utils.StdCopy(stdout, stderr, br) + } + utils.Debugf("[hijack] End of stdout") + return err + }) + } + + sendStdin := utils.Go(func() error { + if in != nil { + io.Copy(rwc, in) + utils.Debugf("[hijack] End of stdin") + } + if tcpc, ok := rwc.(*net.TCPConn); ok { + if err := tcpc.CloseWrite(); err != nil { + utils.Debugf("Couldn't send EOF: %s\n", err) + } + } else if unixc, ok := rwc.(*net.UnixConn); ok { + if err := unixc.CloseWrite(); err != nil { + utils.Debugf("Couldn't send EOF: %s\n", err) + } + } + // Discard errors due to pipe interruption + return nil + }) + + if stdout != nil || stderr != nil { + if err := <-receiveStdout; err != nil { + utils.Debugf("Error receiveStdout: %s", err) + return err + } + } + + if !cli.isTerminal { + if err := <-sendStdin; err != nil { + utils.Debugf("Error sendStdin: %s", err) + return err + } + } + return nil +} diff --git a/api/client/utils.go b/api/client/utils.go index 152e3540ff..6f574b48db 100644 --- a/api/client/utils.go +++ b/api/client/utils.go @@ -2,7 +2,6 @@ package client import ( "bytes" - "crypto/tls" "encoding/base64" "encoding/json" "errors" @@ -11,12 +10,9 @@ import ( "io/ioutil" "net" "net/http" - "net/http/httputil" "net/url" "os" gosignal "os/signal" - "regexp" - goruntime "runtime" "strconv" "strings" "syscall" @@ -35,23 +31,14 @@ var ( func (cli *DockerCli) HTTPClient() *http.Client { tr := &http.Transport{ + TLSClientConfig: cli.tlsConfig, Dial: func(network, addr string) (net.Conn, error) { return net.Dial(cli.proto, cli.addr) }, } - if cli.proto != "unix" { - tr.TLSClientConfig = cli.tlsConfig - } return &http.Client{Transport: tr} } -func (cli *DockerCli) dial() (net.Conn, error) { - if cli.tlsConfig != nil && cli.proto != "unix" { - return tls.Dial(cli.proto, cli.addr, cli.tlsConfig) - } - return net.Dial(cli.proto, cli.addr) -} - func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo bool) (io.ReadCloser, int, error) { params := bytes.NewBuffer(nil) if data != nil { @@ -69,9 +56,6 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } } } - // fixme: refactor client to support redirect - re := regexp.MustCompile("/+") - path = re.ReplaceAllString(path, "/") req, err := http.NewRequest(method, fmt.Sprintf("http://v%s%s", api.APIVERSION, path), params) if err != nil { @@ -134,10 +118,6 @@ func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in in = bytes.NewReader([]byte{}) } - // fixme: refactor client to support redirect - re := regexp.MustCompile("/+") - path = re.ReplaceAllString(path, "/") - req, err := http.NewRequest(method, fmt.Sprintf("http://v%s%s", api.APIVERSION, path), in) if err != nil { return err @@ -189,118 +169,6 @@ func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in return nil } -func (cli *DockerCli) hijack(method, path string, setRawTerminal bool, in io.ReadCloser, stdout, stderr io.Writer, started chan io.Closer) error { - defer func() { - if started != nil { - close(started) - } - }() - // fixme: refactor client to support redirect - re := regexp.MustCompile("/+") - path = re.ReplaceAllString(path, "/") - - req, err := http.NewRequest(method, fmt.Sprintf("/v%s%s", api.APIVERSION, path), nil) - if err != nil { - return err - } - req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION) - req.Header.Set("Content-Type", "plain/text") - req.Host = cli.addr - - dial, err := cli.dial() - if err != nil { - if strings.Contains(err.Error(), "connection refused") { - return fmt.Errorf("Cannot connect to the Docker daemon. Is 'docker -d' running on this host?") - } - return err - } - clientconn := httputil.NewClientConn(dial, nil) - defer clientconn.Close() - - // Server hijacks the connection, error 'connection closed' expected - clientconn.Do(req) - - rwc, br := clientconn.Hijack() - defer rwc.Close() - - if started != nil { - started <- rwc - } - - var receiveStdout chan error - - var oldState *term.State - - if in != nil && setRawTerminal && cli.isTerminal && os.Getenv("NORAW") == "" { - oldState, err = term.SetRawTerminal(cli.terminalFd) - if err != nil { - return err - } - defer term.RestoreTerminal(cli.terminalFd, oldState) - } - - if stdout != nil || stderr != nil { - receiveStdout = utils.Go(func() (err error) { - defer func() { - if in != nil { - if setRawTerminal && cli.isTerminal { - term.RestoreTerminal(cli.terminalFd, oldState) - } - // For some reason this Close call blocks on darwin.. - // As the client exists right after, simply discard the close - // until we find a better solution. - if goruntime.GOOS != "darwin" { - in.Close() - } - } - }() - - // When TTY is ON, use regular copy - if setRawTerminal { - _, err = io.Copy(stdout, br) - } else { - _, err = utils.StdCopy(stdout, stderr, br) - } - utils.Debugf("[hijack] End of stdout") - return err - }) - } - - sendStdin := utils.Go(func() error { - if in != nil { - io.Copy(rwc, in) - utils.Debugf("[hijack] End of stdin") - } - if tcpc, ok := rwc.(*net.TCPConn); ok { - if err := tcpc.CloseWrite(); err != nil { - utils.Debugf("Couldn't send EOF: %s\n", err) - } - } else if unixc, ok := rwc.(*net.UnixConn); ok { - if err := unixc.CloseWrite(); err != nil { - utils.Debugf("Couldn't send EOF: %s\n", err) - } - } - // Discard errors due to pipe interruption - return nil - }) - - if stdout != nil || stderr != nil { - if err := <-receiveStdout; err != nil { - utils.Debugf("Error receiveStdout: %s", err) - return err - } - } - - if !cli.isTerminal { - if err := <-sendStdin; err != nil { - utils.Debugf("Error sendStdin: %s", err) - return err - } - } - return nil - -} - func (cli *DockerCli) resizeTty(id string) { height, width := cli.getTtySize() if height == 0 && width == 0 { From 59fe77bfa638001cbe9af386f350d6e0dbb23398 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 11:14:24 -0700 Subject: [PATCH 377/436] Don't restrict lxc because of apparmor We don't have the flexibility to do extra things with lxc because it is a black box and most fo the magic happens before we get a chance to interact with it in dockerinit. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/execdriver/lxc/driver.go | 6 ------ pkg/libcontainer/nsinit/init.go | 2 +- pkg/libcontainer/security/restrict/restrict.go | 4 ++-- 3 files changed, 3 insertions(+), 9 deletions(-) diff --git a/daemon/execdriver/lxc/driver.go b/daemon/execdriver/lxc/driver.go index 92a79ff5a5..2c06211c0d 100644 --- a/daemon/execdriver/lxc/driver.go +++ b/daemon/execdriver/lxc/driver.go @@ -16,7 +16,6 @@ import ( "github.com/dotcloud/docker/daemon/execdriver" "github.com/dotcloud/docker/pkg/cgroups" "github.com/dotcloud/docker/pkg/label" - "github.com/dotcloud/docker/pkg/libcontainer/security/restrict" "github.com/dotcloud/docker/pkg/system" "github.com/dotcloud/docker/utils" ) @@ -34,11 +33,6 @@ func init() { if err := setupNetworking(args); err != nil { return err } - if !args.Privileged { - if err := restrict.Restrict(); err != nil { - return err - } - } if err := setupCapabilities(args); err != nil { return err } diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index 22345f603f..a123757708 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -79,7 +79,7 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, return fmt.Errorf("set process label %s", err) } if container.Context["restrictions"] != "" { - if err := restrict.Restrict(); err != nil { + if err := restrict.Restrict("proc", "sys"); err != nil { return err } } diff --git a/pkg/libcontainer/security/restrict/restrict.go b/pkg/libcontainer/security/restrict/restrict.go index cfff09f512..e1296b1d7f 100644 --- a/pkg/libcontainer/security/restrict/restrict.go +++ b/pkg/libcontainer/security/restrict/restrict.go @@ -11,9 +11,9 @@ import ( // This has to be called while the container still has CAP_SYS_ADMIN (to be able to perform mounts). // However, afterwards, CAP_SYS_ADMIN should be dropped (otherwise the user will be able to revert those changes). -func Restrict() error { +func Restrict(mounts ...string) error { // remount proc and sys as readonly - for _, dest := range []string{"proc", "sys"} { + for _, dest := range mounts { if err := system.Mount("", dest, "", syscall.MS_REMOUNT|syscall.MS_RDONLY, ""); err != nil { return fmt.Errorf("unable to remount %s readonly: %s", dest, err) } From 9f152aacf8427cbd20a70d52d633f8a6d624aff5 Mon Sep 17 00:00:00 2001 From: Gabriel Monroy Date: Fri, 2 May 2014 13:27:17 -0600 Subject: [PATCH 378/436] deregister containers before removing driver and containerGraph references This is required to address a race condition described in #5553, where a container can be partially deleted -- for example, the root filesystem but not the init filesystem -- which makes it impossible to delete the container without re-adding the missing filesystems manually. This behavior has been witnessed when rebooting boxes that are configured to remove containers on shutdown in parallel with stopping the Docker daemon. Docker-DCO-1.1-Signed-off-by: Gabriel Monroy (github: gabrtv) --- daemon/daemon.go | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/daemon/daemon.go b/daemon/daemon.go index 64a53989d0..22182f389f 100644 --- a/daemon/daemon.go +++ b/daemon/daemon.go @@ -272,6 +272,10 @@ func (daemon *Daemon) Destroy(container *Container) error { return err } + // Deregister the container before removing its directory, to avoid race conditions + daemon.idIndex.Delete(container.ID) + daemon.containers.Remove(element) + if err := daemon.driver.Remove(container.ID); err != nil { return fmt.Errorf("Driver %s failed to remove root filesystem %s: %s", daemon.driver, container.ID, err) } @@ -285,9 +289,6 @@ func (daemon *Daemon) Destroy(container *Container) error { utils.Debugf("Unable to remove container from link graph: %s", err) } - // Deregister the container before removing its directory, to avoid race conditions - daemon.idIndex.Delete(container.ID) - daemon.containers.Remove(element) if err := os.RemoveAll(container.root); err != nil { return fmt.Errorf("Unable to remove filesystem for %v: %v", container.ID, err) } From 45be6f6dff1a8be328e5ade008aae8f9062f5cef Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 19:49:12 +0000 Subject: [PATCH 379/436] fix https Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/client/cli.go | 7 +++++++ api/client/utils.go | 8 +++++--- integration/https_test.go | 8 +++++--- 3 files changed, 17 insertions(+), 6 deletions(-) diff --git a/api/client/cli.go b/api/client/cli.go index b58d3c3c75..49fb3c978f 100644 --- a/api/client/cli.go +++ b/api/client/cli.go @@ -65,8 +65,13 @@ func NewDockerCli(in io.ReadCloser, out, err io.Writer, proto, addr string, tlsC var ( isTerminal = false terminalFd uintptr + scheme = "http" ) + if tlsConfig != nil { + scheme = "https" + } + if in != nil { if file, ok := in.(*os.File); ok { terminalFd = file.Fd() @@ -86,6 +91,7 @@ func NewDockerCli(in io.ReadCloser, out, err io.Writer, proto, addr string, tlsC isTerminal: isTerminal, terminalFd: terminalFd, tlsConfig: tlsConfig, + scheme: scheme, } } @@ -99,4 +105,5 @@ type DockerCli struct { isTerminal bool terminalFd uintptr tlsConfig *tls.Config + scheme string } diff --git a/api/client/utils.go b/api/client/utils.go index 6f574b48db..8f303dcd98 100644 --- a/api/client/utils.go +++ b/api/client/utils.go @@ -57,7 +57,7 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } } - req, err := http.NewRequest(method, fmt.Sprintf("http://v%s%s", api.APIVERSION, path), params) + req, err := http.NewRequest(method, fmt.Sprintf("/v%s%s", api.APIVERSION, path), params) if err != nil { return nil, -1, err } @@ -82,7 +82,8 @@ func (cli *DockerCli) call(method, path string, data interface{}, passAuthInfo b } } req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION) - req.Host = cli.addr + req.URL.Host = cli.addr + req.URL.Scheme = cli.scheme if data != nil { req.Header.Set("Content-Type", "application/json") } else if method == "POST" { @@ -123,7 +124,8 @@ func (cli *DockerCli) streamHelper(method, path string, setRawTerminal bool, in return err } req.Header.Set("User-Agent", "Docker-Client/"+dockerversion.VERSION) - req.Host = cli.addr + req.URL.Host = cli.addr + req.URL.Scheme = cli.scheme if method == "POST" { req.Header.Set("Content-Type", "plain/text") } diff --git a/integration/https_test.go b/integration/https_test.go index 0b4abea881..34c16cf9f9 100644 --- a/integration/https_test.go +++ b/integration/https_test.go @@ -3,10 +3,12 @@ package docker import ( "crypto/tls" "crypto/x509" - "github.com/dotcloud/docker/api/client" "io/ioutil" + "strings" "testing" "time" + + "github.com/dotcloud/docker/api/client" ) const ( @@ -56,7 +58,7 @@ func TestHttpsInfoRogueCert(t *testing.T) { if err == nil { t.Fatal("Expected error but got nil") } - if err.Error() != errBadCertificate { + if !strings.Contains(err.Error(), errBadCertificate) { t.Fatalf("Expected error: %s, got instead: %s", errBadCertificate, err) } }) @@ -74,7 +76,7 @@ func TestHttpsInfoRogueServerCert(t *testing.T) { t.Fatal("Expected error but got nil") } - if err.Error() != errCaUnknown { + if !strings.Contains(err.Error(), errCaUnknown) { t.Fatalf("Expected error: %s, got instead: %s", errBadCertificate, err) } From a7ccbfd5f143af8a7accc69803b1588e568328ac Mon Sep 17 00:00:00 2001 From: "Guillaume J. Charmes" Date: Fri, 2 May 2014 13:55:45 -0700 Subject: [PATCH 380/436] Month devpts before mounting subdirs Docker-DCO-1.1-Signed-off-by: Guillaume J. Charmes (github: creack) --- pkg/libcontainer/mount/init.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/libcontainer/mount/init.go b/pkg/libcontainer/mount/init.go index 6a54f2444e..cfe61d1532 100644 --- a/pkg/libcontainer/mount/init.go +++ b/pkg/libcontainer/mount/init.go @@ -128,7 +128,7 @@ func newSystemMounts(rootfs, mountLabel string, mounts libcontainer.Mounts) []mo } if len(mounts.OfType("devtmpfs")) == 1 { - systemMounts = append(systemMounts, mount{source: "tmpfs", path: filepath.Join(rootfs, "dev"), device: "tmpfs", flags: syscall.MS_NOSUID | syscall.MS_STRICTATIME, data: label.FormatMountLabel("mode=755", mountLabel)}) + systemMounts = append([]mount{{source: "tmpfs", path: filepath.Join(rootfs, "dev"), device: "tmpfs", flags: syscall.MS_NOSUID | syscall.MS_STRICTATIME, data: label.FormatMountLabel("mode=755", mountLabel)}}, systemMounts...) } return systemMounts } From 12a4b376fd42931d959cd925983243e94c981de4 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Fri, 2 May 2014 22:56:35 +0200 Subject: [PATCH 381/436] cli.md: Add space --- docs/sources/reference/commandline/cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index cfcab2af47..c14a9041a7 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -991,7 +991,7 @@ optionally suffixed with `:ro` or `:rw` to mount the volumes in read-only or read-write mode, respectively. By default, the volumes are mounted in the same mode (read write or read only) as the reference container. -The `-a` flag tells `docker run` to bind to the container'sstdin, stdout or +The `-a` flag tells `docker run` to bind to the container's stdin, stdout or stderr. This makes it possible to manipulate the output and input as needed. $ sudo echo "test" | docker run -i -a stdin ubuntu cat - From 4706a1ad76ed9bc6c0555499d0bd8b8eea3b3604 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Fri, 2 May 2014 23:13:28 +0200 Subject: [PATCH 382/436] cli.md: Add another sudo --- docs/sources/reference/commandline/cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index cfcab2af47..59c15ccd49 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -498,7 +498,7 @@ Import to docker via pipe and *stdin*. **Import from a local directory:** - $ sudo tar -c . | docker import - exampleimagedir + $ sudo tar -c . | sudo docker import - exampleimagedir Note the `sudo` in this example – you must preserve the ownership of the files (especially root ownership) during the From 8913ec4912e529be44b7cc2aaf465b0d9b03ffc9 Mon Sep 17 00:00:00 2001 From: "Guillaume J. Charmes" Date: Fri, 2 May 2014 14:15:54 -0700 Subject: [PATCH 383/436] Remove unused daemon/sorter.go Docker-DCO-1.1-Signed-off-by: Guillaume J. Charmes (github: creack) --- daemon/sorter.go | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 daemon/sorter.go diff --git a/daemon/sorter.go b/daemon/sorter.go deleted file mode 100644 index c1525aa350..0000000000 --- a/daemon/sorter.go +++ /dev/null @@ -1,25 +0,0 @@ -package daemon - -import "sort" - -type containerSorter struct { - containers []*Container - by func(i, j *Container) bool -} - -func (s *containerSorter) Len() int { - return len(s.containers) -} - -func (s *containerSorter) Swap(i, j int) { - s.containers[i], s.containers[j] = s.containers[j], s.containers[i] -} - -func (s *containerSorter) Less(i, j int) bool { - return s.by(s.containers[i], s.containers[j]) -} - -func sortContainers(containers []*Container, predicate func(i, j *Container) bool) { - s := &containerSorter{containers, predicate} - sort.Sort(s) -} From cf0076b92dd11b3bda9ac7982e374d4531925ff9 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 21:43:51 +0000 Subject: [PATCH 384/436] add _ping endpoint Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/server/server.go | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/api/server/server.go b/api/server/server.go index 5db9df1901..18c9a93d97 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -3,7 +3,6 @@ package server import ( "bufio" "bytes" - "code.google.com/p/go.net/websocket" "crypto/tls" "crypto/x509" "encoding/base64" @@ -21,6 +20,8 @@ import ( "strings" "syscall" + "code.google.com/p/go.net/websocket" + "github.com/dotcloud/docker/api" "github.com/dotcloud/docker/engine" "github.com/dotcloud/docker/pkg/listenbuffer" @@ -976,6 +977,11 @@ func writeCorsHeaders(w http.ResponseWriter, r *http.Request) { w.Header().Add("Access-Control-Allow-Methods", "GET, POST, DELETE, PUT, OPTIONS") } +func ping(eng *engine.Engine, version version.Version, w http.ResponseWriter, r *http.Request, vars map[string]string) error { + w.Write([]byte{'O', 'K'}) + return nil +} + func makeHttpHandler(eng *engine.Engine, logging bool, localMethod string, localRoute string, handlerFunc HttpApiFunc, enableCors bool, dockerVersion version.Version) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { // log the request @@ -1044,6 +1050,7 @@ func createRouter(eng *engine.Engine, logging, enableCors bool, dockerVersion st } m := map[string]map[string]HttpApiFunc{ "GET": { + "/_ping": ping, "/events": getEvents, "/info": getInfo, "/version": getVersion, From 3c422fe5bf45391a509fd3c7f33033baefb0a234 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 21:51:20 +0000 Subject: [PATCH 385/436] add doc Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- .../reference/api/docker_remote_api.md | 5 +++++ .../reference/api/docker_remote_api_v1.11.md | 20 +++++++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md index 8a490b52ee..47f4724b1a 100644 --- a/docs/sources/reference/api/docker_remote_api.md +++ b/docs/sources/reference/api/docker_remote_api.md @@ -36,6 +36,11 @@ You can still call an old version of the api using ### What's new +`GET /_ping` + +**New!** +You can now ping the server via the `_ping` endpoint. + `GET /events` **New!** diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.md b/docs/sources/reference/api/docker_remote_api_v1.11.md index ebaa3e6e44..5ad174565d 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.11.md +++ b/docs/sources/reference/api/docker_remote_api_v1.11.md @@ -1162,6 +1162,26 @@ Show the docker version information - **200** – no error - **500** – server error +### Ping the docker server + +`GET /_ping` + +Ping the docker server + + **Example request**: + + GET /_ping HTTP/1.1 + + **Example response**: + + HTTP/1.1 200 OK + + OK + + Status Codes: + + - **200** - no error + ### Create a new image from a container's changes `POST /commit` From e318af6fb097ce5157b6766d8dfe921403858756 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Fri, 2 May 2014 22:59:43 +0200 Subject: [PATCH 386/436] cli.md: sudo at the right place Docker-DCO-1.1-Signed-off-by: Felix Rabe (github: felixrabe) --- docs/sources/reference/commandline/cli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index cfcab2af47..ddbbb27f05 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -994,7 +994,7 @@ the same mode (read write or read only) as the reference container. The `-a` flag tells `docker run` to bind to the container'sstdin, stdout or stderr. This makes it possible to manipulate the output and input as needed. - $ sudo echo "test" | docker run -i -a stdin ubuntu cat - + $ echo "test" | sudo docker run -i -a stdin ubuntu cat - This pipes data into a container and prints the container's ID by attaching only to the container'sstdin. @@ -1005,7 +1005,7 @@ This isn't going to print anything unless there's an error because We've only attached to the stderr of the container. The container's logs still store what's been written to stderr and stdout. - $ sudo cat somefile | docker run -i -a stdin mybuilder dobuild + $ cat somefile | sudo docker run -i -a stdin mybuilder dobuild This is how piping a file into a container could be done for a build. The container's ID will be printed after the build is done and the build From c65de2c0207ac67e5023ada8709490ef4627bd01 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 2 May 2014 22:03:59 +0000 Subject: [PATCH 387/436] return write error Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- api/server/server.go | 4 ++-- docs/sources/reference/api/docker_remote_api_v1.11.md | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/api/server/server.go b/api/server/server.go index 18c9a93d97..ab0f98fa47 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -978,8 +978,8 @@ func writeCorsHeaders(w http.ResponseWriter, r *http.Request) { } func ping(eng *engine.Engine, version version.Version, w http.ResponseWriter, r *http.Request, vars map[string]string) error { - w.Write([]byte{'O', 'K'}) - return nil + _, err := w.Write([]byte{'O', 'K'}) + return err } func makeHttpHandler(eng *engine.Engine, logging bool, localMethod string, localRoute string, handlerFunc HttpApiFunc, enableCors bool, dockerVersion version.Version) http.HandlerFunc { diff --git a/docs/sources/reference/api/docker_remote_api_v1.11.md b/docs/sources/reference/api/docker_remote_api_v1.11.md index 5ad174565d..53e07b380c 100644 --- a/docs/sources/reference/api/docker_remote_api_v1.11.md +++ b/docs/sources/reference/api/docker_remote_api_v1.11.md @@ -1181,6 +1181,7 @@ Ping the docker server Status Codes: - **200** - no error + - **500** - server error ### Create a new image from a container's changes From de75af9fe2d91df7297e498d320b496addfb52f4 Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Thu, 1 May 2014 16:10:20 -0700 Subject: [PATCH 388/436] engine: catchall handler is shadowed by specific handlers This allows using `Engine.Register` and `Engine.RegisterCatchall` on the same engine without the catchall hiding all other handlers. Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- engine/engine.go | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/engine/engine.go b/engine/engine.go index dc1984ccb5..6f80e54b7e 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -118,13 +118,12 @@ func (eng *Engine) Job(name string, args ...string) *Job { if eng.Logging { job.Stderr.Add(utils.NopWriteCloser(eng.Stderr)) } - if eng.catchall != nil { + + // Catchall is shadowed by specific Register. + if handler, exists := eng.handlers[name]; exists { + job.handler = handler + } else if eng.catchall != nil { job.handler = eng.catchall - } else { - handler, exists := eng.handlers[name] - if exists { - job.handler = handler - } } return job } From 3b73c26194836c1e2b737146a5b0c840226c65d2 Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Thu, 1 May 2014 18:39:46 -0700 Subject: [PATCH 389/436] Engine: empty job names are illegal, catchall or not Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- engine/engine.go | 3 ++- engine/engine_test.go | 16 ++++++++++++++++ 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/engine/engine.go b/engine/engine.go index 6f80e54b7e..58b43eca04 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -122,7 +122,8 @@ func (eng *Engine) Job(name string, args ...string) *Job { // Catchall is shadowed by specific Register. if handler, exists := eng.handlers[name]; exists { job.handler = handler - } else if eng.catchall != nil { + } else if eng.catchall != nil && name != "" { + // empty job names are illegal, catchall or not. job.handler = eng.catchall } return job diff --git a/engine/engine_test.go b/engine/engine_test.go index 8023bd58f3..de7f74012e 100644 --- a/engine/engine_test.go +++ b/engine/engine_test.go @@ -133,3 +133,19 @@ func TestParseJob(t *testing.T) { t.Fatalf("Job was not called") } } + +func TestCatchallEmptyName(t *testing.T) { + eng := New() + var called bool + eng.RegisterCatchall(func(job *Job) Status { + called = true + return StatusOK + }) + err := eng.Job("").Run() + if err == nil { + t.Fatalf("Engine.Job(\"\").Run() should return an error") + } + if called { + t.Fatalf("Engine.Job(\"\").Run() should return an error") + } +} From 015a2abafa92ecc61fe5828a285a1e6dcfa07693 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Fri, 2 May 2014 23:27:39 +0200 Subject: [PATCH 390/436] cli.md: More typos I've seen one other missing space that I addressed in another PR already. I don't know whether that is a common occurrence in the docs. About the second diff chunk, it looks like some copy-paste mistake to me. Docker-DCO-1.1-Signed-off-by: Felix Rabe (github: felixrabe) --- docs/sources/reference/commandline/cli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index cfcab2af47..08d3c2b4cf 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -537,7 +537,7 @@ Return low-level information on a container/image By default, this will render all results in a JSON array. If a format is specified, the given template will be executed for each result. -Go's[text/template](http://golang.org/pkg/text/template/) package +Go's [text/template](http://golang.org/pkg/text/template/) package describes all the details of the format. ### Examples @@ -798,7 +798,7 @@ removed before the image is removed. $ sudo docker images REPOSITORY TAG IMAGE ID CREATED SIZE - test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) + test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB) $ sudo docker rmi test Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8 From f37ce76bf68d4935accd1018c904e80e42066f9f Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Thu, 1 May 2014 16:08:39 -0700 Subject: [PATCH 391/436] api/server: better error checking to avoid unnecessary panics Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- api/server/server.go | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/api/server/server.go b/api/server/server.go index 5db9df1901..0f887a8aea 100644 --- a/api/server/server.go +++ b/api/server/server.go @@ -1267,6 +1267,9 @@ func ListenAndServe(proto, addr string, job *engine.Job) error { // ServeApi loops through all of the protocols sent in to docker and spawns // off a go routine to setup a serving http.Server for each. func ServeApi(job *engine.Job) engine.Status { + if len(job.Args) == 0 { + return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name) + } var ( protoAddrs = job.Args chErrors = make(chan error, len(protoAddrs)) @@ -1279,6 +1282,9 @@ func ServeApi(job *engine.Job) engine.Status { for _, protoAddr := range protoAddrs { protoAddrParts := strings.SplitN(protoAddr, "://", 2) + if len(protoAddrParts) != 2 { + return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name) + } go func() { log.Printf("Listening for HTTP on %s (%s)\n", protoAddrParts[0], protoAddrParts[1]) chErrors <- ListenAndServe(protoAddrParts[0], protoAddrParts[1], job) From 205bd91fcab30292ac5f246ce9bdbb045ad1023f Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Sat, 3 May 2014 02:11:00 +0200 Subject: [PATCH 392/436] run.md: Convert some backticks to apo's --- docs/sources/reference/run.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index a8acb97071..97012873d2 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -291,7 +291,7 @@ the container you might have an HTTP service listening on port 80 (and so you 42800. To help a new client container reach the server container's internal port -operator `--expose``d by the operator or `EXPOSE``d by the developer, the +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`. From 4a3b0e8d5d2653cfecbfee370be2406265211253 Mon Sep 17 00:00:00 2001 From: Felix Rabe Date: Sat, 3 May 2014 02:20:59 +0200 Subject: [PATCH 393/436] run.md: Close braces Docker-DCO-1.1-Signed-off-by: Felix Rabe (github: felixrabe) --- docs/sources/reference/run.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index a8acb97071..e2fb060d65 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -220,7 +220,7 @@ in `docker run`. We'll go through what the developer might have set in each Dockerfile instruction and how the operator can override that setting. - [CMD (Default Command or Options)](#cmd-default-command-or-options) - - [ENTRYPOINT (Default Command to Execute at Runtime]( + - [ENTRYPOINT (Default Command to Execute at Runtime)]( #entrypoint-default-command-to-execute-at-runtime) - [EXPOSE (Incoming Ports)](#expose-incoming-ports) - [ENV (Environment Variables)](#env-environment-variables) @@ -243,7 +243,7 @@ operator (the person running a container from the image), you can override that If the image also specifies an `ENTRYPOINT` then the `CMD` or `COMMAND` get appended as arguments to the `ENTRYPOINT`. -## ENTRYPOINT (Default Command to Execute at Runtime +## ENTRYPOINT (Default Command to Execute at Runtime) --entrypoint="": Overwrite the default entrypoint set by the image From 3d605683b3d272982399635a55ee81b2a7535e81 Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Sun, 27 Apr 2014 15:06:09 -0700 Subject: [PATCH 394/436] Move 'auth' to the registry subsystem This is the first step towards separating the registry subsystem from the deprecated `Server` object. * New service `github.com/dotcloud/docker/registry/Service` * The service is installed by default in `builtins` * The service only exposes `auth` for now... * ...Soon to be followed by `pull`, `push` and `search`. Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- builtins/builtins.go | 4 +++ registry/registry.go | 39 ++++++++++++++++++++++++++ registry/service.go | 54 ++++++++++++++++++++++++++++++++++++ server/server.go | 66 ++------------------------------------------ 4 files changed, 100 insertions(+), 63 deletions(-) create mode 100644 registry/service.go diff --git a/builtins/builtins.go b/builtins/builtins.go index 374bd48701..bd3b33d0d3 100644 --- a/builtins/builtins.go +++ b/builtins/builtins.go @@ -4,12 +4,16 @@ import ( api "github.com/dotcloud/docker/api/server" "github.com/dotcloud/docker/daemon/networkdriver/bridge" "github.com/dotcloud/docker/engine" + "github.com/dotcloud/docker/registry" "github.com/dotcloud/docker/server" ) func Register(eng *engine.Engine) { daemon(eng) remote(eng) + // FIXME: engine.Installer.Install can fail. These errors + // should be passed up. + registry.NewService().Install(eng) } // remote: a RESTful api for cross-docker communication diff --git a/registry/registry.go b/registry/registry.go index 1bd73cdeb5..55154e364b 100644 --- a/registry/registry.go +++ b/registry/registry.go @@ -13,10 +13,12 @@ import ( "net/http/cookiejar" "net/url" "regexp" + "runtime" "strconv" "strings" "time" + "github.com/dotcloud/docker/dockerversion" "github.com/dotcloud/docker/utils" ) @@ -757,3 +759,40 @@ func NewRegistry(authConfig *AuthConfig, factory *utils.HTTPRequestFactory, inde r.reqFactory = factory return r, nil } + +func HTTPRequestFactory(metaHeaders map[string][]string) *utils.HTTPRequestFactory { + // FIXME: this replicates the 'info' job. + httpVersion := make([]utils.VersionInfo, 0, 4) + httpVersion = append(httpVersion, &simpleVersionInfo{"docker", dockerversion.VERSION}) + httpVersion = append(httpVersion, &simpleVersionInfo{"go", runtime.Version()}) + httpVersion = append(httpVersion, &simpleVersionInfo{"git-commit", dockerversion.GITCOMMIT}) + if kernelVersion, err := utils.GetKernelVersion(); err == nil { + httpVersion = append(httpVersion, &simpleVersionInfo{"kernel", kernelVersion.String()}) + } + httpVersion = append(httpVersion, &simpleVersionInfo{"os", runtime.GOOS}) + httpVersion = append(httpVersion, &simpleVersionInfo{"arch", runtime.GOARCH}) + ud := utils.NewHTTPUserAgentDecorator(httpVersion...) + md := &utils.HTTPMetaHeadersDecorator{ + Headers: metaHeaders, + } + factory := utils.NewHTTPRequestFactory(ud, md) + return factory +} + +// simpleVersionInfo is a simple implementation of +// the interface VersionInfo, which is used +// to provide version information for some product, +// component, etc. It stores the product name and the version +// in string and returns them on calls to Name() and Version(). +type simpleVersionInfo struct { + name string + version string +} + +func (v *simpleVersionInfo) Name() string { + return v.name +} + +func (v *simpleVersionInfo) Version() string { + return v.version +} diff --git a/registry/service.go b/registry/service.go new file mode 100644 index 0000000000..530a7f7afe --- /dev/null +++ b/registry/service.go @@ -0,0 +1,54 @@ +package registry + +import ( + "github.com/dotcloud/docker/engine" +) + +// Service exposes registry capabilities in the standard Engine +// interface. Once installed, it extends the engine with the +// following calls: +// +// 'auth': Authenticate against the public registry +// 'search': Search for images on the public registry (TODO) +// 'pull': Download images from any registry (TODO) +// 'push': Upload images to any registry (TODO) +type Service struct { +} + +// NewService returns a new instance of Service ready to be +// installed no an engine. +func NewService() *Service { + return &Service{} +} + +// Install installs registry capabilities to eng. +func (s *Service) Install(eng *engine.Engine) error { + eng.Register("auth", s.Auth) + return nil +} + +// Auth contacts the public registry with the provided credentials, +// and returns OK if authentication was sucessful. +// It can be used to verify the validity of a client's credentials. +func (s *Service) Auth(job *engine.Job) engine.Status { + var ( + err error + authConfig = &AuthConfig{} + ) + + job.GetenvJson("authConfig", authConfig) + // TODO: this is only done here because auth and registry need to be merged into one pkg + if addr := authConfig.ServerAddress; addr != "" && addr != IndexServerAddress() { + addr, err = ExpandAndVerifyRegistryUrl(addr) + if err != nil { + return job.Error(err) + } + authConfig.ServerAddress = addr + } + status, err := Login(authConfig, HTTPRequestFactory(nil)) + if err != nil { + return job.Error(err) + } + job.Printf("%s\n", status) + return engine.StatusOK +} diff --git a/server/server.go b/server/server.go index f55107d3bd..16f9129311 100644 --- a/server/server.go +++ b/server/server.go @@ -139,7 +139,6 @@ func InitServer(job *engine.Job) engine.Status { "events": srv.Events, "push": srv.ImagePush, "containers": srv.Containers, - "auth": srv.Auth, } { if err := job.Eng.Register(name, handler); err != nil { return job.Error(err) @@ -148,24 +147,6 @@ func InitServer(job *engine.Job) engine.Status { return engine.StatusOK } -// simpleVersionInfo is a simple implementation of -// the interface VersionInfo, which is used -// to provide version information for some product, -// component, etc. It stores the product name and the version -// in string and returns them on calls to Name() and Version(). -type simpleVersionInfo struct { - name string - version string -} - -func (v *simpleVersionInfo) Name() string { - return v.name -} - -func (v *simpleVersionInfo) Version() string { - return v.version -} - // ContainerKill send signal to the container // If no signal is given (sig 0), then Kill with SIGKILL and wait // for the container to exit. @@ -215,29 +196,6 @@ func (srv *Server) ContainerKill(job *engine.Job) engine.Status { return engine.StatusOK } -func (srv *Server) Auth(job *engine.Job) engine.Status { - var ( - err error - authConfig = ®istry.AuthConfig{} - ) - - job.GetenvJson("authConfig", authConfig) - // TODO: this is only done here because auth and registry need to be merged into one pkg - if addr := authConfig.ServerAddress; addr != "" && addr != registry.IndexServerAddress() { - addr, err = registry.ExpandAndVerifyRegistryUrl(addr) - if err != nil { - return job.Error(err) - } - authConfig.ServerAddress = addr - } - status, err := registry.Login(authConfig, srv.HTTPRequestFactory(nil)) - if err != nil { - return job.Error(err) - } - job.Printf("%s\n", status) - return engine.StatusOK -} - func (srv *Server) Events(job *engine.Job) engine.Status { if len(job.Args) != 1 { return job.Errorf("Usage: %s FROM", job.Name) @@ -654,7 +612,7 @@ func (srv *Server) ImagesSearch(job *engine.Job) engine.Status { job.GetenvJson("authConfig", authConfig) job.GetenvJson("metaHeaders", metaHeaders) - r, err := registry.NewRegistry(authConfig, srv.HTTPRequestFactory(metaHeaders), registry.IndexServerAddress()) + r, err := registry.NewRegistry(authConfig, registry.HTTPRequestFactory(metaHeaders), registry.IndexServerAddress()) if err != nil { return job.Error(err) } @@ -1457,7 +1415,7 @@ func (srv *Server) ImagePull(job *engine.Job) engine.Status { return job.Error(err) } - r, err := registry.NewRegistry(&authConfig, srv.HTTPRequestFactory(metaHeaders), endpoint) + r, err := registry.NewRegistry(&authConfig, registry.HTTPRequestFactory(metaHeaders), endpoint) if err != nil { return job.Error(err) } @@ -1680,7 +1638,7 @@ func (srv *Server) ImagePush(job *engine.Job) engine.Status { } img, err := srv.daemon.Graph().Get(localName) - r, err2 := registry.NewRegistry(authConfig, srv.HTTPRequestFactory(metaHeaders), endpoint) + r, err2 := registry.NewRegistry(authConfig, registry.HTTPRequestFactory(metaHeaders), endpoint) if err2 != nil { return job.Error(err2) } @@ -2558,24 +2516,6 @@ func NewServer(eng *engine.Engine, config *daemonconfig.Config) (*Server, error) return srv, nil } -func (srv *Server) HTTPRequestFactory(metaHeaders map[string][]string) *utils.HTTPRequestFactory { - httpVersion := make([]utils.VersionInfo, 0, 4) - httpVersion = append(httpVersion, &simpleVersionInfo{"docker", dockerversion.VERSION}) - httpVersion = append(httpVersion, &simpleVersionInfo{"go", goruntime.Version()}) - httpVersion = append(httpVersion, &simpleVersionInfo{"git-commit", dockerversion.GITCOMMIT}) - if kernelVersion, err := utils.GetKernelVersion(); err == nil { - httpVersion = append(httpVersion, &simpleVersionInfo{"kernel", kernelVersion.String()}) - } - httpVersion = append(httpVersion, &simpleVersionInfo{"os", goruntime.GOOS}) - httpVersion = append(httpVersion, &simpleVersionInfo{"arch", goruntime.GOARCH}) - ud := utils.NewHTTPUserAgentDecorator(httpVersion...) - md := &utils.HTTPMetaHeadersDecorator{ - Headers: metaHeaders, - } - factory := utils.NewHTTPRequestFactory(ud, md) - return factory -} - func (srv *Server) LogEvent(action, id, from string) *utils.JSONMessage { now := time.Now().UTC().Unix() jm := utils.JSONMessage{Status: action, ID: id, From: from, Time: now} From c4089ad80bcc1466535696ac0b11d388df529391 Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Sun, 27 Apr 2014 15:21:42 -0700 Subject: [PATCH 395/436] Move 'search' to the registry subsystem This continues the effort to separate all registry logic from the deprecated `Server` object. * 'search' is exposed by `github.com/dotcloud/docker/registry/Service` * Added proper documentation of Search while I was at it Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- registry/service.go | 52 ++++++++++++++++++++++++++++++++++++++++++++- server/server.go | 34 ----------------------------- 2 files changed, 51 insertions(+), 35 deletions(-) diff --git a/registry/service.go b/registry/service.go index 530a7f7afe..1c7a93deac 100644 --- a/registry/service.go +++ b/registry/service.go @@ -9,7 +9,7 @@ import ( // following calls: // // 'auth': Authenticate against the public registry -// 'search': Search for images on the public registry (TODO) +// 'search': Search for images on the public registry // 'pull': Download images from any registry (TODO) // 'push': Upload images to any registry (TODO) type Service struct { @@ -24,6 +24,7 @@ func NewService() *Service { // Install installs registry capabilities to eng. func (s *Service) Install(eng *engine.Engine) error { eng.Register("auth", s.Auth) + eng.Register("search", s.Search) return nil } @@ -52,3 +53,52 @@ func (s *Service) Auth(job *engine.Job) engine.Status { job.Printf("%s\n", status) return engine.StatusOK } + +// Search queries the public registry for images matching the specified +// search terms, and returns the results. +// +// Argument syntax: search TERM +// +// Option environment: +// 'authConfig': json-encoded credentials to authenticate against the registry. +// The search extends to images only accessible via the credentials. +// +// 'metaHeaders': extra HTTP headers to include in the request to the registry. +// The headers should be passed as a json-encoded dictionary. +// +// Output: +// Results are sent as a collection of structured messages (using engine.Table). +// Each result is sent as a separate message. +// Results are ordered by number of stars on the public registry. +func (s *Service) Search(job *engine.Job) engine.Status { + if n := len(job.Args); n != 1 { + return job.Errorf("Usage: %s TERM", job.Name) + } + var ( + term = job.Args[0] + metaHeaders = map[string][]string{} + authConfig = &AuthConfig{} + ) + job.GetenvJson("authConfig", authConfig) + job.GetenvJson("metaHeaders", metaHeaders) + + r, err := NewRegistry(authConfig, HTTPRequestFactory(metaHeaders), IndexServerAddress()) + if err != nil { + return job.Error(err) + } + results, err := r.SearchRepositories(term) + if err != nil { + return job.Error(err) + } + outs := engine.NewTable("star_count", 0) + for _, result := range results.Results { + out := &engine.Env{} + out.Import(result) + outs.Add(out) + } + outs.ReverseSort() + if _, err := outs.WriteListTo(job.Stdout); err != nil { + return job.Error(err) + } + return engine.StatusOK +} diff --git a/server/server.go b/server/server.go index 16f9129311..04cc17a35a 100644 --- a/server/server.go +++ b/server/server.go @@ -126,7 +126,6 @@ func InitServer(job *engine.Job) engine.Status { "insert": srv.ImageInsert, "attach": srv.ContainerAttach, "logs": srv.ContainerLogs, - "search": srv.ImagesSearch, "changes": srv.ContainerChanges, "top": srv.ContainerTop, "version": srv.DockerVersion, @@ -600,39 +599,6 @@ func (srv *Server) recursiveLoad(address, tmpImageDir string) error { return nil } -func (srv *Server) ImagesSearch(job *engine.Job) engine.Status { - if n := len(job.Args); n != 1 { - return job.Errorf("Usage: %s TERM", job.Name) - } - var ( - term = job.Args[0] - metaHeaders = map[string][]string{} - authConfig = ®istry.AuthConfig{} - ) - job.GetenvJson("authConfig", authConfig) - job.GetenvJson("metaHeaders", metaHeaders) - - r, err := registry.NewRegistry(authConfig, registry.HTTPRequestFactory(metaHeaders), registry.IndexServerAddress()) - if err != nil { - return job.Error(err) - } - results, err := r.SearchRepositories(term) - if err != nil { - return job.Error(err) - } - outs := engine.NewTable("star_count", 0) - for _, result := range results.Results { - out := &engine.Env{} - out.Import(result) - outs.Add(out) - } - outs.ReverseSort() - if _, err := outs.WriteListTo(job.Stdout); err != nil { - return job.Error(err) - } - return engine.StatusOK -} - // FIXME: 'insert' is deprecated and should be removed in a future version. func (srv *Server) ImageInsert(job *engine.Job) engine.Status { fmt.Fprintf(job.Stderr, "Warning: '%s' is deprecated and will be removed in a future version. Please use 'build' and 'ADD' instead.\n", job.Name) From 328d65dcff423b14e76f03ee65445032da31ed42 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Sat, 3 May 2014 00:54:52 +0000 Subject: [PATCH 396/436] remove fixme Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- builtins/builtins.go | 26 +++++++++++++++----------- docker/docker.go | 4 +++- 2 files changed, 18 insertions(+), 12 deletions(-) diff --git a/builtins/builtins.go b/builtins/builtins.go index bd3b33d0d3..40d421f154 100644 --- a/builtins/builtins.go +++ b/builtins/builtins.go @@ -8,17 +8,19 @@ import ( "github.com/dotcloud/docker/server" ) -func Register(eng *engine.Engine) { - daemon(eng) - remote(eng) - // FIXME: engine.Installer.Install can fail. These errors - // should be passed up. - registry.NewService().Install(eng) +func Register(eng *engine.Engine) error { + if err := daemon(eng); err != nil { + return err + } + if err := remote(eng); err != nil { + return err + } + return registry.NewService().Install(eng) } // remote: a RESTful api for cross-docker communication -func remote(eng *engine.Engine) { - eng.Register("serveapi", api.ServeApi) +func remote(eng *engine.Engine) error { + return eng.Register("serveapi", api.ServeApi) } // daemon: a default execution and storage backend for Docker on Linux, @@ -36,7 +38,9 @@ func remote(eng *engine.Engine) { // // These components should be broken off into plugins of their own. // -func daemon(eng *engine.Engine) { - eng.Register("initserver", server.InitServer) - eng.Register("init_networkdriver", bridge.InitDriver) +func daemon(eng *engine.Engine) error { + if err := eng.Register("initserver", server.InitServer); err != nil { + return err + } + return eng.Register("init_networkdriver", bridge.InitDriver) } diff --git a/docker/docker.go b/docker/docker.go index 7c366001b7..db33341413 100644 --- a/docker/docker.go +++ b/docker/docker.go @@ -128,7 +128,9 @@ func main() { eng := engine.New() // Load builtins - builtins.Register(eng) + if err := builtins.Register(eng); err != nil { + log.Fatal(err) + } // load the daemon in the background so we can immediately start // the http api so that connections don't fail while the daemon // is booting From dca1c0073f42b0d75e914119eae863d6e6087cd6 Mon Sep 17 00:00:00 2001 From: Mateusz Sulima Date: Sat, 3 May 2014 12:22:33 +0200 Subject: [PATCH 397/436] hello_world.md - $container_id variable case sensitivity If you run the tutorial step-by-step, following error occurs: ```$ sudo docker logs $container_id Usage: docker logs CONTAINER Fetch the logs of a container -f, --follow=false: Follow log output``` This is obviously because bash variables are case-sensitive, so it mustn't be `CONTAINER_ID` above. Docker-DCO-1.1-Signed-off-by: Mateusz Sulima (github: github_handle) --- docs/sources/examples/hello_world.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/examples/hello_world.md b/docs/sources/examples/hello_world.md index 48f4a43102..177857816c 100644 --- a/docs/sources/examples/hello_world.md +++ b/docs/sources/examples/hello_world.md @@ -80,7 +80,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. From bfac0b24ed66277c66807466e9d429624b1179e6 Mon Sep 17 00:00:00 2001 From: James Turnbull Date: Sun, 4 May 2014 03:16:21 +0200 Subject: [PATCH 398/436] Fixed a couple of single dashes in links document Docker-DCO-1.1-Signed-off-by: James Turnbull (github: jamtur01) --- docs/sources/use/working_with_links_names.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/sources/use/working_with_links_names.md b/docs/sources/use/working_with_links_names.md index 40260feabf..dab66cef06 100644 --- a/docs/sources/use/working_with_links_names.md +++ b/docs/sources/use/working_with_links_names.md @@ -50,7 +50,7 @@ For example, there is an image called `crosbymichael/redis` 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. - $ 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 container. The name also allows @@ -61,9 +61,9 @@ apply a link to connect both containers. If you noticed when running 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 Docker to link the +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 access network and environment information from the containers that are From 8d7ed2cae49918c9f31e9fd068b28c8e114e939b Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Sat, 3 May 2014 20:34:21 -0600 Subject: [PATCH 399/436] Update vendored deps that have a proper version number to use said specific versions Docker-DCO-1.1-Signed-off-by: Andrew Page (github: tianon) --- hack/vendor.sh | 4 ++-- .../coreos/go-systemd/dbus/methods_test.go | 3 ++- vendor/src/github.com/coreos/go-systemd/dbus/set.go | 7 +++++++ .../github.com/coreos/go-systemd/dbus/set_test.go | 13 +++++++++++++ .../go-systemd/fixtures/enable-disable.service | 5 +++++ 5 files changed, 29 insertions(+), 3 deletions(-) create mode 100644 vendor/src/github.com/coreos/go-systemd/fixtures/enable-disable.service diff --git a/hack/vendor.sh b/hack/vendor.sh index 4200d90867..79322cd9af 100755 --- a/hack/vendor.sh +++ b/hack/vendor.sh @@ -59,5 +59,5 @@ rm -rf src/code.google.com/p/go mkdir -p src/code.google.com/p/go/src/pkg/archive mv tmp-tar src/code.google.com/p/go/src/pkg/archive/tar -clone git github.com/godbus/dbus cb98efbb933d8389ab549a060e880ea3c375d213 -clone git github.com/coreos/go-systemd 4c14ed39b8a643ac44b4f95b5a53c00e94261475 +clone git github.com/godbus/dbus v1 +clone git github.com/coreos/go-systemd v1 diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/methods_test.go b/vendor/src/github.com/coreos/go-systemd/dbus/methods_test.go index 9e2f22323f..d943e7ebfc 100644 --- a/vendor/src/github.com/coreos/go-systemd/dbus/methods_test.go +++ b/vendor/src/github.com/coreos/go-systemd/dbus/methods_test.go @@ -18,12 +18,13 @@ package dbus import ( "fmt" - "github.com/guelfey/go.dbus" "math/rand" "os" "path/filepath" "reflect" "testing" + + "github.com/godbus/dbus" ) func setupConn(t *testing.T) *Conn { diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/set.go b/vendor/src/github.com/coreos/go-systemd/dbus/set.go index 88378b29a1..45ad1fb399 100644 --- a/vendor/src/github.com/coreos/go-systemd/dbus/set.go +++ b/vendor/src/github.com/coreos/go-systemd/dbus/set.go @@ -21,6 +21,13 @@ func (s *set) Length() (int) { return len(s.data) } +func (s *set) Values() (values []string) { + for val, _ := range s.data { + values = append(values, val) + } + return +} + func newSet() (*set) { return &set{make(map[string] bool)} } diff --git a/vendor/src/github.com/coreos/go-systemd/dbus/set_test.go b/vendor/src/github.com/coreos/go-systemd/dbus/set_test.go index d8d174d0c4..c4435f8800 100644 --- a/vendor/src/github.com/coreos/go-systemd/dbus/set_test.go +++ b/vendor/src/github.com/coreos/go-systemd/dbus/set_test.go @@ -18,9 +18,22 @@ func TestBasicSetActions(t *testing.T) { t.Fatal("set should contain 'foo'") } + v := s.Values() + if len(v) != 1 { + t.Fatal("set.Values did not report correct number of values") + } + if v[0] != "foo" { + t.Fatal("set.Values did not report value") + } + s.Remove("foo") if s.Contains("foo") { t.Fatal("set should not contain 'foo'") } + + v = s.Values() + if len(v) != 0 { + t.Fatal("set.Values did not report correct number of values") + } } diff --git a/vendor/src/github.com/coreos/go-systemd/fixtures/enable-disable.service b/vendor/src/github.com/coreos/go-systemd/fixtures/enable-disable.service new file mode 100644 index 0000000000..74c9459088 --- /dev/null +++ b/vendor/src/github.com/coreos/go-systemd/fixtures/enable-disable.service @@ -0,0 +1,5 @@ +[Unit] +Description=enable disable test + +[Service] +ExecStart=/bin/sleep 400 From 6799d14cb8cb9986d4a38473cddd009b96e717c8 Mon Sep 17 00:00:00 2001 From: lukemarsden Date: Sun, 4 May 2014 17:52:48 +0100 Subject: [PATCH 400/436] Update devenvironment.md `git clone` should use `https` URL. --- docs/sources/contributing/devenvironment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/contributing/devenvironment.md b/docs/sources/contributing/devenvironment.md index bcefa00369..24e250dbb0 100644 --- a/docs/sources/contributing/devenvironment.md +++ b/docs/sources/contributing/devenvironment.md @@ -32,7 +32,7 @@ Again, you can do it in other ways but you need to do more work. ## Check out the Source - $ git clone http://git@github.com/dotcloud/docker + $ git clone https://git@github.com/dotcloud/docker $ cd docker To checkout a different revision just use `git checkout` From a304dcef00d639b2f5dbf8d7561f1f8de7124573 Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Mon, 5 May 2014 12:54:10 +0200 Subject: [PATCH 401/436] nat: Fix --expose protocol parsing A command like: docker run --expose 5353/tcp -P fedora sleep 10 Currently fails with: Error: Cannot start container 5c558de5f0bd85ff14e13e3691aefbe531346297a27d4b3562732baa8785b34a: unknown protocol This is because nat.SplitProtoPort() confuses the order of the port and proto in 5353/tcp, assuming the protocol is first. However, in all other places in docker the protocol is last, so the fix is just to swap these. Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: alexlarsson) --- nat/nat.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nat/nat.go b/nat/nat.go index f3af362f8b..7aad775d70 100644 --- a/nat/nat.go +++ b/nat/nat.go @@ -69,7 +69,7 @@ func SplitProtoPort(rawPort string) (string, string) { if l == 1 { return "tcp", rawPort } - return parts[0], parts[1] + return parts[1], parts[0] } // We will receive port specs in the format of ip:public:private/proto and these need to be From 46755dfc1aa30a418a11dc8e352c600ef365b969 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Mon, 5 May 2014 10:38:44 +1000 Subject: [PATCH 402/436] Rearrange the existing info a little, and add example style guide Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/README.md | 55 +++++++++++++++++++++++++------------------------- 1 file changed, 28 insertions(+), 27 deletions(-) diff --git a/docs/README.md b/docs/README.md index bbc741d593..47b390bda4 100755 --- a/docs/README.md +++ b/docs/README.md @@ -1,8 +1,4 @@ -Docker Documentation -==================== - -Overview --------- +# Docker Documentation The source for Docker documentation is here under `sources/` and uses extended Markdown, as implemented by [mkdocs](http://mkdocs.org). @@ -37,8 +33,13 @@ may include features not yet part of any official docker release. The development and `docs.docker.io` (which points to the `docs` branch`) should be used for the latest official release. -Getting Started ---------------- +## Contributing + +- Follow the contribution guidelines ([see + `../CONTRIBUTING.md`](../CONTRIBUTING.md)). +- [Remember to sign your work!](../CONTRIBUTING.md#sign-your-work) + +## Getting Started Docker documentation builds are done in a Docker container, which installs all the required tools, adds the local `docs/` directory and @@ -47,40 +48,40 @@ you can connect and see your changes. In the root of the `docker` source directory: - cd docker - -Run: - make docs If you have any issues you need to debug, you can use `make docs-shell` and then run `mkdocs serve` -# Contributing +### Examples -* Follow the contribution guidelines ([see - `../CONTRIBUTING.md`](../CONTRIBUTING.md)). -* [Remember to sign your work!](../CONTRIBUTING.md#sign-your-work) +When writing examples give the user hints by making them resemble what +they see in their shell: -Working using GitHub's file editor ----------------------------------- +- Indent shell examples by 4 spaces so they get rendered as code. +- Start typed commands with `$ ` (dollar space), so that they are easily +differentiated from program output. +- Program output has no prefix. +- Comments begin with `# ` (hash space). +- In-container shell commands begin with `$$ ` (dollar dollar space). -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 on-line (though there can be some differences between GitHub -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 ------- +### Images When you need to add images, try to make them as small as possible (e.g. as gifs). Usually images should go in the same directory as the `.md` file which references them, or in a subdirectory if one already exists. -Publishing Documentation ------------------------- +## 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 on-line (though there can be some differences between GitHub +Markdown and [MkDocs Markdown](http://www.mkdocs.org/user-guide/writing-your-docs/)). +Just be careful not to create many commits. And you must still +[sign your work!](../CONTRIBUTING.md#sign-your-work) + +## Publishing Documentation To publish a copy of the documentation you need a `docs/awsconfig` file containing AWS settings to deploy to. The release script will From e625bad3d7e5eb08568cbd09d9d574b8c63fd203 Mon Sep 17 00:00:00 2001 From: Dan Walsh Date: Fri, 2 May 2014 16:47:29 -0400 Subject: [PATCH 403/436] Fix docker man page to reference selinux-enable flag Docker-DCO-1.1-Signed-off-by: Daniel Walsh (github: rhatdan) --- contrib/man/md/docker.1.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/contrib/man/md/docker.1.md b/contrib/man/md/docker.1.md index 02c541262b..d1ddf192b5 100644 --- a/contrib/man/md/docker.1.md +++ b/contrib/man/md/docker.1.md @@ -23,7 +23,7 @@ its own man page which explain usage and arguements. To see the man page for a command run **man docker **. # OPTIONS -**-D**=*ture*|*false* +**-D**=*true*|*false* Enable debug mode. Default is false. **-H**, **--host**=[unix:///var/run/docker.sock]: tcp://[host[:port]] to bind or @@ -73,6 +73,9 @@ port=[4243] or path =[/var/run/docker.sock] is omitted, default values are used. **-v**=*true*|*false* Print version information and quit. Default is false. +**--selinux-enabled=*true*|*false* + Enable selinux support. Default is false. + # COMMANDS **docker-attach(1)** Attach to a running container From 56d71ae79bbbdd0d1eb97408c6132687a33ec113 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Mon, 5 May 2014 22:52:12 +1000 Subject: [PATCH 404/436] Several reader issues fixed - Fix boot2docker url - move HomeBrew instructions to a separate section - fix docker client 5-liner to work (its still ugly) - fix and update program output Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/installation/mac.md | 65 ++++++++++++++------------------ 1 file changed, 29 insertions(+), 36 deletions(-) diff --git a/docs/sources/installation/mac.md b/docs/sources/installation/mac.md index 15736f5c6c..d5b65cd5ab 100644 --- a/docs/sources/installation/mac.md +++ b/docs/sources/installation/mac.md @@ -28,22 +28,14 @@ Once the download is complete, open the disk image, run the set up file (i.e. `VirtualBox.pkg`) and install VirtualBox. Do not simply copy the package without running the installer. -### boot2docker +### Manual Installation +#### boot2docker [boot2docker](https://github.com/boot2docker/boot2docker) provides a -handy script to easily manage the VM running the `docker` +handy script to manage the VM running the `docker` daemon. It also takes care of the installation for the OS image that is used for the job. -#### With Homebrew - -If you are using Homebrew on your machine, simply run the following -command to install `boot2docker`: - - $ brew install boot2docker - -#### Manual installation - Open up a new terminal window, if you have not already. Run the following commands to get boot2docker: @@ -52,33 +44,23 @@ Run the following commands to get boot2docker: $ cd ~/bin # Get the file - $ curl https://raw.github.com/boot2docker/boot2docker/master/boot2docker > boot2docker + $ curl https://raw.githubusercontent.com/boot2docker/boot2docker/master/boot2docker > boot2docker # Mark it executable $ chmod +x boot2docker -### Docker OS X Client +#### Docker OS X Client -The `docker` daemon is accessed using the -`docker` client. - -#### With Homebrew - -Run the following command to install the `docker` -client: - - $ brew install docker - -#### Manual installation +The `docker` daemon is accessed using the `docker` client. Run the following commands to get it downloaded and set up: # Get the docker client file $ DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ - $ curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ - $ gunzip $DIR/ld.tgz && \ - $ tar xvf $DIR/ld.tar -C $DIR/ && \ - $ cp $DIR/usr/local/bin/docker ./docker + curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ + gunzip $DIR/ld.tgz && \ + tar xvf $DIR/ld.tar -C $DIR/ && \ + cp $DIR/usr/local/bin/docker ./docker # Set the environment variable for the docker daemon $ export DOCKER_HOST=tcp://127.0.0.1:4243 @@ -87,6 +69,18 @@ Run the following commands to get it downloaded and set up: $ sudo mkdir -p /usr/local/bin $ sudo cp docker /usr/local/bin/ +### (OR) With Homebrew + +If you are using Homebrew on your machine, simply run the following +command to install `boot2docker`: + + $ brew install boot2docker + +Run the following command to install the `docker` +client: + + $ brew install docker + And that's it! Let's check out how to use it. ## How To Use Docker On Mac OS X @@ -104,8 +98,7 @@ commands: # To see all available commands: $ ./boot2docker - - # Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} + Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} ### The `docker` client @@ -114,12 +107,12 @@ use the `docker` client just like any other application. $ docker version - # Client version: 0.7.6 - # Go version (client): go1.2 - # Git commit (client): bc3b2ec - # Server version: 0.7.5 - # Git commit (server): c348c04 - # Go version (server): go1.2 + Client version: 0.10.0 + Client API version: 1.10 + Server version: 0.10.0 + Server API version: 1.10 + Last stable version: 0.10.0 + ### Forwarding VM Port Range to Host From 10766e1fb46770a407b2b17ade313dd5ae85054e Mon Sep 17 00:00:00 2001 From: Aaron Huslage Date: Mon, 5 May 2014 10:28:52 -0400 Subject: [PATCH 405/436] Post-commit hook URL fix Updating CONTRIBUTING to include the correct URL for the post-commit hook. Docker-DCO-1.1-Signed-off-by: Aaron Huslage (github: huslage) --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5a1ad4b0ab..d77afbc443 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -82,7 +82,7 @@ editors have plugins that do this automatically, and there's also a git pre-commit hook: ``` -curl -o .git/hooks/pre-commit https://raw.github.com/edsrzf/gofmt-git-hook/master/fmt-check && chmod +x .git/hooks/pre-commit +curl -o .git/hooks/pre-commit https://raw.githubusercontent.com/edsrzf/gofmt-git-hook/master/fmt-check && chmod +x .git/hooks/pre-commit ``` Pull requests descriptions should be as clear as possible and include a From c34bb099e51300f4355f949cc514bab8370c82c1 Mon Sep 17 00:00:00 2001 From: James Turnbull Date: Mon, 5 May 2014 16:42:23 +0200 Subject: [PATCH 406/436] Fixed the horrible OSX installation docs Docker-DCO-1.1-Signed-off-by: James Turnbull (github: jamtur01) --- docs/sources/installation/mac.md | 169 +++++++++++++++++-------------- 1 file changed, 92 insertions(+), 77 deletions(-) diff --git a/docs/sources/installation/mac.md b/docs/sources/installation/mac.md index d5b65cd5ab..c30e0b6440 100644 --- a/docs/sources/installation/mac.md +++ b/docs/sources/installation/mac.md @@ -1,12 +1,8 @@ -page_title: Installation on Mac OS X 10.6 Snow Leopard -page_description: Please note this project is currently under heavy development. It should not be used in production. -page_keywords: Docker, Docker documentation, requirements, virtualbox, ssh, linux, os x, osx, mac +page_title: Installation on Mac OS X +page_description: Instructions for installing Docker on OS X using boot2docker. +page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac -# Mac OS X - -> **Note**: -> These instructions are available with the new release of Docker (version -> 0.8). However, they are subject to change. +# Installing Docker on Mac OS X > **Note**: > Docker is still under heavy development! We don't recommend using it in @@ -14,33 +10,50 @@ page_keywords: Docker, Docker documentation, requirements, virtualbox, ssh, linu > our blog post, [Getting to Docker 1.0]( > http://blog.docker.io/2013/08/getting-to-docker-1-0/) -Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer. +> **Note:** +> Docker is supported on Mac OS X 10.6 "Snow Leopard" or newer. -## How To Install Docker On Mac OS X +Docker has two key components: the Docker daemon and the `docker` binary +which acts as a client. The client passes instructions to the daemon +which builds, runs and manages your Docker containers. As Docker uses +some Linux-specific kernel features you can't use it directly on OS X. +Instead we run the Docker daemon inside a lightweight virtual machine on your local +OS X host. We can then use a native client `docker` binary to communicate +with the Docker daemon inside our virtual machine. To make this process +easier we've designed a helper application called +[boot2docker](https://github.com/boot2docker/boot2docker) to install +that virtual machine and run our Docker daemon. -### VirtualBox +[boot2docker](https://github.com/boot2docker/boot2docker) uses +VirtualBox to create the virtual machine so we'll need to install that +first. + +## Installing VirtualBox Docker on OS X needs VirtualBox to run. To begin with, head over to [VirtualBox Download Page](https://www.virtualbox.org/wiki/Downloads) and get the tool for `OS X hosts x86/amd64`. -Once the download is complete, open the disk image, run the set up file -(i.e. `VirtualBox.pkg`) and install VirtualBox. Do -not simply copy the package without running the installer. +Once the download is complete, open the disk image, run `VirtualBox.pkg` +and install VirtualBox. -### Manual Installation -#### boot2docker +> **Note**: +> Do not simply copy the package without running the +> installer. + +## Installing boot2docker + +### Installing manually [boot2docker](https://github.com/boot2docker/boot2docker) provides a -handy script to manage the VM running the `docker` -daemon. It also takes care of the installation for the OS -image that is used for the job. +handy script to manage the VM running the Docker daemon. It also takes +care of the installation of that VM. -Open up a new terminal window, if you have not already. - -Run the following commands to get boot2docker: +Open up a new terminal window and run the following commands to get +boot2docker: # Enter the installation directory + $ mkdir -p ~/bin $ cd ~/bin # Get the file @@ -49,62 +62,69 @@ Run the following commands to get boot2docker: # Mark it executable $ chmod +x boot2docker -#### Docker OS X Client +### Installing the Docker OS X Client -The `docker` daemon is accessed using the `docker` client. +The Docker daemon is accessed using the `docker` binary. Run the following commands to get it downloaded and set up: - # Get the docker client file + # Get the docker binary $ DIR=$(mktemp -d ${TMPDIR:-/tmp}/dockerdl.XXXXXXX) && \ curl -f -o $DIR/ld.tgz https://get.docker.io/builds/Darwin/x86_64/docker-latest.tgz && \ gunzip $DIR/ld.tgz && \ tar xvf $DIR/ld.tar -C $DIR/ && \ cp $DIR/usr/local/bin/docker ./docker - # Set the environment variable for the docker daemon - $ export DOCKER_HOST=tcp://127.0.0.1:4243 - # Copy the executable file $ sudo mkdir -p /usr/local/bin $ sudo cp docker /usr/local/bin/ -### (OR) With Homebrew +### Configure the Docker OS X Client + +The Docker client, `docker`, uses an environment variable `DOCKER_HOST` +to specify the location of the Docker daemon to connect to. Specify your +local boot2docker virtual machine as the value of that variable. + + $ export DOCKER_HOST=tcp://127.0.0.1:4243 + +## Installing boot2docker with Homebrew If you are using Homebrew on your machine, simply run the following command to install `boot2docker`: $ brew install boot2docker -Run the following command to install the `docker` -client: +Run the following command to install the Docker client: $ brew install docker And that's it! Let's check out how to use it. -## How To Use Docker On Mac OS X +# How To Use Docker On Mac OS X -### The `docker` daemon (via boot2docker) +## Running the Docker daemon via boot2docker -Inside the `~/bin` directory, run the following -commands: +Firstly we need to initialize our boot2docker virtual machine. Run the +`boot2docker` command. - # Initiate the VM - $ ./boot2docker init + $ boot2docker init - # Run the VM (the docker daemon) - $ ./boot2docker up +This will setup our initial virtual machine. - # To see all available commands: - $ ./boot2docker +Next we need to start the Docker daemon. + + $ boot2docker up + +There are a variety of others commands available using the `boot2docker` +script. You can see these like so: + + $ boot2docker Usage ./boot2docker {init|start|up|pause|stop|restart|status|info|delete|ssh|download} -### The `docker` client +## The Docker client -Once the VM with the `docker` daemon is up, you can -use the `docker` client just like any other -application. +Once the virtual machine with the Docker daemon is up, you can use the `docker` +binary just like any other application. $ docker version Client version: 0.10.0 @@ -113,20 +133,23 @@ application. Server API version: 1.10 Last stable version: 0.10.0 +## Using Docker port forwarding with boot2docker -### Forwarding VM Port Range to Host +In order to forward network ports from Docker with boot2docker we need to +manually forward the port range Docker uses inside VirtualBox. To do +this we take the port range that Docker uses by default with the `-P` +option, ports 49000-49900, and run the following command. -If we take the port range that docker uses by default with the -P option -(49000-49900), and forward same range from host to vm, we'll be able to -interact with our containers as if they were running locally: +> **Note:** +> The boot2docker virtual machine must be powered off for this +> to work. - # vm must be powered off for i in {49000..49900}; do VBoxManage modifyvm "boot2docker-vm" --natpf1 "tcp-port$i,tcp,,$i,,$i"; VBoxManage modifyvm "boot2docker-vm" --natpf1 "udp-port$i,udp,,$i,,$i"; done -### SSH-ing The VM +## Connecting to the VM via SSH If you feel the need to connect to the VM, you can simply run: @@ -135,37 +158,29 @@ If you feel the need to connect to the VM, you can simply run: # User: docker # Pwd: tcuser -You can now continue with the [*Hello -World*](/examples/hello_world/#hello-world) example. +If SSH complains about keys then run: -## Learn More + $ ssh-keygen -R '[localhost]:2022' -### boot2docker: +## Upgrading to a newer release of boot2docker + +To upgrade an initialized boot2docker virtual machine, you can use the +following 3 commands. Your virtual machine's disk will not be changed, +so you won't lose your images and containers: + + $ boot2docker stop + $ boot2docker download + $ boot2docker start + +# Learn More + +## boot2docker See the GitHub page for [boot2docker](https://github.com/boot2docker/boot2docker). -### If SSH complains about keys: +# Next steps - $ ssh-keygen -R '[localhost]:2022' +You can now continue with the [*Hello +World*](/examples/hello_world/#hello-world) example. -### Upgrading to a newer release of boot2docker - -To upgrade an initialised VM, you can use the following 3 commands. Your -persistence disk will not be changed, so you won't lose your images and -containers: - - $ ./boot2docker stop - $ ./boot2docker download - $ ./boot2docker start - -### About the way Docker works on Mac OS X: - -Docker has two key components: the `docker` daemon and the `docker` client. -The tool works by client commanding the daemon. In order to work and do its -magic, the daemon makes use of some Linux Kernel features (e.g. LXC, name -spaces etc.), which are not supported by OS X. Therefore, the solution of -getting Docker to run on OS X consists of running it inside a lightweight -virtual machine. In order to simplify things, Docker comes with a bash -script to make this whole process as easy as possible (i.e. -boot2docker). From a60159f3b102244fc5470642bd32eb99d5ac329c Mon Sep 17 00:00:00 2001 From: Johan Euphrosine Date: Wed, 30 Apr 2014 15:46:56 -0700 Subject: [PATCH 407/436] runconfig: add -net container:name option Docker-DCO-1.1-Signed-off-by: Johan Euphrosine (github: proppy) --- daemon/container.go | 15 +++++++-- daemon/execdriver/driver.go | 5 +-- daemon/execdriver/native/create.go | 16 +++++++++ runconfig/hostconfig.go | 24 ++++++++------ runconfig/parse.go | 53 +++++++++++++++++++++--------- 5 files changed, 84 insertions(+), 29 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 1c6dc077dc..22c2ef3abe 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -325,7 +325,7 @@ func (container *Container) Attach(stdin io.ReadCloser, stdinCloser io.Closer, s }) } -func populateCommand(c *Container, env []string) { +func populateCommand(c *Container, env []string) error { var ( en *execdriver.Network context = make(map[string][]string) @@ -351,6 +351,14 @@ func populateCommand(c *Container, env []string) { // TODO: this can be removed after lxc-conf is fully deprecated mergeLxcConfIntoOptions(c.hostConfig, context) + if netContainer := c.hostConfig.UseContainerNetwork; netContainer != "" { + nc := c.daemon.Get(netContainer) + if nc == nil { + return fmt.Errorf("no such container to join network: %q", netContainer) + } + en.ContainerID = nc.ID + } + resources := &execdriver.Resources{ Memory: c.Config.Memory, MemorySwap: c.Config.MemorySwap, @@ -372,6 +380,7 @@ func populateCommand(c *Container, env []string) { } c.command.SysProcAttr = &syscall.SysProcAttr{Setsid: true} c.command.Env = env + return nil } func (container *Container) Start() (err error) { @@ -415,7 +424,9 @@ func (container *Container) Start() (err error) { if err := container.setupWorkingDirectory(); err != nil { return err } - populateCommand(container, env) + if err := populateCommand(container, env); err != nil { + return err + } if err := setupMountsForContainer(container); err != nil { return err } diff --git a/daemon/execdriver/driver.go b/daemon/execdriver/driver.go index 27a575cb3a..994a27e501 100644 --- a/daemon/execdriver/driver.go +++ b/daemon/execdriver/driver.go @@ -89,8 +89,9 @@ type Driver interface { // Network settings of the container type Network struct { - Interface *NetworkInterface `json:"interface"` // if interface is nil then networking is disabled - Mtu int `json:"mtu"` + Interface *NetworkInterface `json:"interface"` // if interface is nil then networking is disabled + Mtu int `json:"mtu"` + ContainerID string `json:"container_id"` // id of the container to join network. } type NetworkInterface struct { diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index 5562d08986..b2dd395bb5 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -3,6 +3,7 @@ package native import ( "fmt" "os" + "path/filepath" "github.com/dotcloud/docker/daemon/execdriver" "github.com/dotcloud/docker/daemon/execdriver/native/configuration" @@ -75,6 +76,21 @@ func (d *driver) createNetwork(container *libcontainer.Container, c *execdriver. } container.Networks = append(container.Networks, &vethNetwork) } + + if c.Network.ContainerID != "" { + cmd := d.activeContainers[c.Network.ContainerID] + if cmd == nil || cmd.Process == nil { + return fmt.Errorf("%s is not a valid running container to join", c.Network.ContainerID) + } + nspath := filepath.Join("/proc", fmt.Sprint(cmd.Process.Pid), "ns", "net") + container.Networks = append(container.Networks, &libcontainer.Network{ + Type: "netns", + Context: libcontainer.Context{ + "nspath": nspath, + }, + }) + } + return nil } diff --git a/runconfig/hostconfig.go b/runconfig/hostconfig.go index 3235bf1f4e..dce88c4460 100644 --- a/runconfig/hostconfig.go +++ b/runconfig/hostconfig.go @@ -7,16 +7,17 @@ import ( ) type HostConfig struct { - Binds []string - ContainerIDFile string - LxcConf []utils.KeyValuePair - Privileged bool - PortBindings nat.PortMap - Links []string - PublishAllPorts bool - Dns []string - DnsSearch []string - VolumesFrom []string + Binds []string + ContainerIDFile string + LxcConf []utils.KeyValuePair + Privileged bool + PortBindings nat.PortMap + Links []string + PublishAllPorts bool + Dns []string + DnsSearch []string + VolumesFrom []string + UseContainerNetwork string } func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { @@ -42,5 +43,8 @@ func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { if VolumesFrom := job.GetenvList("VolumesFrom"); VolumesFrom != nil { hostConfig.VolumesFrom = VolumesFrom } + if UseContainerNetwork := job.Getenv("UseContainerNetwork"); UseContainerNetwork != "" { + hostConfig.UseContainerNetwork = UseContainerNetwork + } return hostConfig } diff --git a/runconfig/parse.go b/runconfig/parse.go index d395b49e80..06e380d4fa 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -2,14 +2,15 @@ package runconfig import ( "fmt" + "io/ioutil" + "path" + "strings" + "github.com/dotcloud/docker/nat" "github.com/dotcloud/docker/opts" flag "github.com/dotcloud/docker/pkg/mflag" "github.com/dotcloud/docker/pkg/sysinfo" "github.com/dotcloud/docker/utils" - "io/ioutil" - "path" - "strings" ) var ( @@ -61,7 +62,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID") flWorkingDir = cmd.String([]string{"w", "-workdir"}, "", "Working directory inside the container") flCpuShares = cmd.Int64([]string{"c", "-cpu-shares"}, 0, "CPU shares (relative weight)") - + flNetMode = cmd.String([]string{"#net", "-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'disable': disable networking for this container, 'container:name_or_id': reuses another container network stack)") // For documentation purpose _ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify all received signal to the process (even in non-tty mode)") _ = cmd.String([]string{"#name", "-name"}, "", "Assign a name to the container") @@ -197,6 +198,11 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf // boo, there's no debug output for docker run //utils.Debugf("Environment variables for the container: %#v", envVariables) + netMode, useContainerNetwork, err := parseNetMode(*flNetMode) + if err != nil { + return nil, nil, cmd, fmt.Errorf("-net: invalid net mode: %v", err) + } + config := &Config{ Hostname: hostname, Domainname: domainname, @@ -204,7 +210,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf ExposedPorts: ports, User: *flUser, Tty: *flTty, - NetworkDisabled: !*flNetwork, + NetworkDisabled: !*flNetwork || netMode == "disable", OpenStdin: *flStdin, Memory: flMemory, CpuShares: *flCpuShares, @@ -220,16 +226,17 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf } hostConfig := &HostConfig{ - Binds: binds, - ContainerIDFile: *flContainerIDFile, - LxcConf: lxcConf, - Privileged: *flPrivileged, - PortBindings: portBindings, - Links: flLinks.GetAll(), - PublishAllPorts: *flPublishAll, - Dns: flDns.GetAll(), - DnsSearch: flDnsSearch.GetAll(), - VolumesFrom: flVolumesFrom.GetAll(), + Binds: binds, + ContainerIDFile: *flContainerIDFile, + LxcConf: lxcConf, + Privileged: *flPrivileged, + PortBindings: portBindings, + Links: flLinks.GetAll(), + PublishAllPorts: *flPublishAll, + Dns: flDns.GetAll(), + DnsSearch: flDnsSearch.GetAll(), + VolumesFrom: flVolumesFrom.GetAll(), + UseContainerNetwork: useContainerNetwork, } if sysInfo != nil && flMemory > 0 && !sysInfo.SwapLimit { @@ -274,3 +281,19 @@ func parseKeyValueOpts(opts opts.ListOpts) ([]utils.KeyValuePair, error) { } return out, nil } + +func parseNetMode(netMode string) (string, string, error) { + parts := strings.Split(netMode, ":") + if len(parts) < 1 { + return "", "", fmt.Errorf("'netmode' cannot be empty", netMode) + } + mode := parts[0] + var container string + if mode == "container" { + if len(parts) < 2 { + return "", "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) + } + container = parts[1] + } + return mode, container, nil +} From 7118416aeeb779373685d192c26a329e9acdef89 Mon Sep 17 00:00:00 2001 From: Johan Euphrosine Date: Fri, 2 May 2014 01:47:12 -0700 Subject: [PATCH 408/436] runconfig/parse: add test for parseNetMode Docker-DCO-1.1-Signed-off-by: Johan Euphrosine (github: proppy) --- runconfig/parse.go | 17 +++++++++-------- runconfig/parse_test.go | 33 ++++++++++++++++++++++++++++++++- 2 files changed, 41 insertions(+), 9 deletions(-) diff --git a/runconfig/parse.go b/runconfig/parse.go index 06e380d4fa..262a04eb4b 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -284,16 +284,17 @@ func parseKeyValueOpts(opts opts.ListOpts) ([]utils.KeyValuePair, error) { func parseNetMode(netMode string) (string, string, error) { parts := strings.Split(netMode, ":") - if len(parts) < 1 { - return "", "", fmt.Errorf("'netmode' cannot be empty", netMode) - } - mode := parts[0] - var container string - if mode == "container" { - if len(parts) < 2 { + switch mode := parts[0]; mode { + case "bridge", "disable": + return mode, "", nil + case "container": + var container string + if len(parts) < 2 || parts[1] == "" { return "", "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) } container = parts[1] + return mode, container, nil + default: + return "", "", fmt.Errorf("invalid netmode: %q", netMode) } - return mode, container, nil } diff --git a/runconfig/parse_test.go b/runconfig/parse_test.go index fd28c4593e..9ac925f2ac 100644 --- a/runconfig/parse_test.go +++ b/runconfig/parse_test.go @@ -1,8 +1,9 @@ package runconfig import ( - "github.com/dotcloud/docker/utils" "testing" + + "github.com/dotcloud/docker/utils" ) func TestParseLxcConfOpt(t *testing.T) { @@ -21,3 +22,33 @@ func TestParseLxcConfOpt(t *testing.T) { } } } + +func TestParseNetMode(t *testing.T) { + testFlags := []struct { + flag string + mode string + container string + err bool + }{ + {"", "", "", true}, + {"bridge", "bridge", "", false}, + {"disable", "disable", "", false}, + {"container:foo", "container", "foo", false}, + {"container:", "", "", true}, + {"container", "", "", true}, + {"unknown", "", "", true}, + } + + for _, to := range testFlags { + mode, container, err := parseNetMode(to.flag) + if mode != to.mode { + t.Fatalf("-net %s: expected net mode: %q, got: %q", to.flag, to.mode, mode) + } + if container != to.container { + t.Fatalf("-net %s: expected net container: %q, got: %q", to.flag, to.container, container) + } + if (err != nil) != to.err { + t.Fatal("-net %s: expected an error got none", to.flag) + } + } +} From 2c2cc051d831f54d1bb070642edcd876ff669e78 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 14:06:05 -0700 Subject: [PATCH 409/436] Update --net flags and container mode Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/container.go | 35 ++++++++++++++++++-------------- runconfig/hostconfig.go | 26 +++++++++++------------- runconfig/parse.go | 44 ++++++++++++++++++++--------------------- runconfig/parse_test.go | 2 +- 4 files changed, 54 insertions(+), 53 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 22c2ef3abe..bbd4aa6a58 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -338,27 +338,32 @@ func populateCommand(c *Container, env []string) error { Interface: nil, } - if !c.Config.NetworkDisabled { - network := c.NetworkSettings - en.Interface = &execdriver.NetworkInterface{ - Gateway: network.Gateway, - Bridge: network.Bridge, - IPAddress: network.IPAddress, - IPPrefixLen: network.IPPrefixLen, + parts := strings.SplitN(c.hostConfig.NetworkMode, ":", 2) + switch parts[0] { + case "none": + case "bridge": + if !c.Config.NetworkDisabled { + network := c.NetworkSettings + en.Interface = &execdriver.NetworkInterface{ + Gateway: network.Gateway, + Bridge: network.Bridge, + IPAddress: network.IPAddress, + IPPrefixLen: network.IPPrefixLen, + } } + case "container": + nc := c.daemon.Get(parts[1]) + if nc == nil { + return fmt.Errorf("no such container to join network: %q", parts[1]) + } + en.ContainerID = nc.ID + default: + return fmt.Errorf("invalid network mode: %s", c.hostConfig.NetworkMode) } // TODO: this can be removed after lxc-conf is fully deprecated mergeLxcConfIntoOptions(c.hostConfig, context) - if netContainer := c.hostConfig.UseContainerNetwork; netContainer != "" { - nc := c.daemon.Get(netContainer) - if nc == nil { - return fmt.Errorf("no such container to join network: %q", netContainer) - } - en.ContainerID = nc.ID - } - resources := &execdriver.Resources{ Memory: c.Config.Memory, MemorySwap: c.Config.MemorySwap, diff --git a/runconfig/hostconfig.go b/runconfig/hostconfig.go index dce88c4460..83688367e3 100644 --- a/runconfig/hostconfig.go +++ b/runconfig/hostconfig.go @@ -7,17 +7,17 @@ import ( ) type HostConfig struct { - Binds []string - ContainerIDFile string - LxcConf []utils.KeyValuePair - Privileged bool - PortBindings nat.PortMap - Links []string - PublishAllPorts bool - Dns []string - DnsSearch []string - VolumesFrom []string - UseContainerNetwork string + Binds []string + ContainerIDFile string + LxcConf []utils.KeyValuePair + Privileged bool + PortBindings nat.PortMap + Links []string + PublishAllPorts bool + Dns []string + DnsSearch []string + VolumesFrom []string + NetworkMode string } func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { @@ -25,6 +25,7 @@ func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { ContainerIDFile: job.Getenv("ContainerIDFile"), Privileged: job.GetenvBool("Privileged"), PublishAllPorts: job.GetenvBool("PublishAllPorts"), + NetworkMode: job.Getenv("NetworkMode"), } job.GetenvJson("LxcConf", &hostConfig.LxcConf) job.GetenvJson("PortBindings", &hostConfig.PortBindings) @@ -43,8 +44,5 @@ func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { if VolumesFrom := job.GetenvList("VolumesFrom"); VolumesFrom != nil { hostConfig.VolumesFrom = VolumesFrom } - if UseContainerNetwork := job.Getenv("UseContainerNetwork"); UseContainerNetwork != "" { - hostConfig.UseContainerNetwork = UseContainerNetwork - } return hostConfig } diff --git a/runconfig/parse.go b/runconfig/parse.go index 262a04eb4b..42ad5c1958 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -50,7 +50,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf flAutoRemove = cmd.Bool([]string{"#rm", "-rm"}, false, "Automatically remove the container when it exits (incompatible with -d)") flDetach = cmd.Bool([]string{"d", "-detach"}, false, "Detached mode: Run container in the background, print new container id") - flNetwork = cmd.Bool([]string{"n", "-networking"}, true, "Enable networking for this container") + flNetwork = cmd.Bool([]string{"#n", "#-networking"}, true, "Enable networking for this container") flPrivileged = cmd.Bool([]string{"#privileged", "-privileged"}, false, "Give extended privileges to this container") flPublishAll = cmd.Bool([]string{"P", "-publish-all"}, false, "Publish all exposed ports to the host interfaces") flStdin = cmd.Bool([]string{"i", "-interactive"}, false, "Keep stdin open even if not attached") @@ -62,7 +62,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID") flWorkingDir = cmd.String([]string{"w", "-workdir"}, "", "Working directory inside the container") flCpuShares = cmd.Int64([]string{"c", "-cpu-shares"}, 0, "CPU shares (relative weight)") - flNetMode = cmd.String([]string{"#net", "-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'disable': disable networking for this container, 'container:name_or_id': reuses another container network stack)") + flNetMode = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:name_or_id': reuses another container network stack)") // For documentation purpose _ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify all received signal to the process (even in non-tty mode)") _ = cmd.String([]string{"#name", "-name"}, "", "Assign a name to the container") @@ -198,7 +198,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf // boo, there's no debug output for docker run //utils.Debugf("Environment variables for the container: %#v", envVariables) - netMode, useContainerNetwork, err := parseNetMode(*flNetMode) + netMode, err := parseNetMode(*flNetMode) if err != nil { return nil, nil, cmd, fmt.Errorf("-net: invalid net mode: %v", err) } @@ -210,7 +210,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf ExposedPorts: ports, User: *flUser, Tty: *flTty, - NetworkDisabled: !*flNetwork || netMode == "disable", + NetworkDisabled: !*flNetwork, OpenStdin: *flStdin, Memory: flMemory, CpuShares: *flCpuShares, @@ -226,17 +226,17 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf } hostConfig := &HostConfig{ - Binds: binds, - ContainerIDFile: *flContainerIDFile, - LxcConf: lxcConf, - Privileged: *flPrivileged, - PortBindings: portBindings, - Links: flLinks.GetAll(), - PublishAllPorts: *flPublishAll, - Dns: flDns.GetAll(), - DnsSearch: flDnsSearch.GetAll(), - VolumesFrom: flVolumesFrom.GetAll(), - UseContainerNetwork: useContainerNetwork, + Binds: binds, + ContainerIDFile: *flContainerIDFile, + LxcConf: lxcConf, + Privileged: *flPrivileged, + PortBindings: portBindings, + Links: flLinks.GetAll(), + PublishAllPorts: *flPublishAll, + Dns: flDns.GetAll(), + DnsSearch: flDnsSearch.GetAll(), + VolumesFrom: flVolumesFrom.GetAll(), + NetworkMode: netMode, } if sysInfo != nil && flMemory > 0 && !sysInfo.SwapLimit { @@ -282,19 +282,17 @@ func parseKeyValueOpts(opts opts.ListOpts) ([]utils.KeyValuePair, error) { return out, nil } -func parseNetMode(netMode string) (string, string, error) { +func parseNetMode(netMode string) (string, error) { parts := strings.Split(netMode, ":") switch mode := parts[0]; mode { - case "bridge", "disable": - return mode, "", nil + case "bridge", "none": + return mode, nil case "container": - var container string if len(parts) < 2 || parts[1] == "" { - return "", "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) + return "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) } - container = parts[1] - return mode, container, nil + return netMode, nil default: - return "", "", fmt.Errorf("invalid netmode: %q", netMode) + return "", fmt.Errorf("invalid netmode: %q", netMode) } } diff --git a/runconfig/parse_test.go b/runconfig/parse_test.go index 9ac925f2ac..e1b4cf9f93 100644 --- a/runconfig/parse_test.go +++ b/runconfig/parse_test.go @@ -40,7 +40,7 @@ func TestParseNetMode(t *testing.T) { } for _, to := range testFlags { - mode, container, err := parseNetMode(to.flag) + mode, err := parseNetMode(to.flag) if mode != to.mode { t.Fatalf("-net %s: expected net mode: %q, got: %q", to.flag, to.mode, mode) } From a785882b29b9f0b24ace8249576c5d8d7f8c1d94 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 14:17:31 -0700 Subject: [PATCH 410/436] Setup host networking for lxc and native Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/container.go | 2 ++ daemon/execdriver/driver.go | 7 ++++--- daemon/execdriver/lxc/init.go | 9 +++++---- daemon/execdriver/lxc/lxc_template.go | 5 +++-- daemon/execdriver/native/create.go | 5 ++++- runconfig/parse.go | 2 ++ 6 files changed, 20 insertions(+), 10 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index bbd4aa6a58..6769da9b25 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -341,6 +341,8 @@ func populateCommand(c *Container, env []string) error { parts := strings.SplitN(c.hostConfig.NetworkMode, ":", 2) switch parts[0] { case "none": + case "host": + en.HostNetworking = true case "bridge": if !c.Config.NetworkDisabled { network := c.NetworkSettings diff --git a/daemon/execdriver/driver.go b/daemon/execdriver/driver.go index 994a27e501..4837a398ea 100644 --- a/daemon/execdriver/driver.go +++ b/daemon/execdriver/driver.go @@ -89,9 +89,10 @@ type Driver interface { // Network settings of the container type Network struct { - Interface *NetworkInterface `json:"interface"` // if interface is nil then networking is disabled - Mtu int `json:"mtu"` - ContainerID string `json:"container_id"` // id of the container to join network. + Interface *NetworkInterface `json:"interface"` // if interface is nil then networking is disabled + Mtu int `json:"mtu"` + ContainerID string `json:"container_id"` // id of the container to join network. + HostNetworking bool `json:"host_networking"` } type NetworkInterface struct { diff --git a/daemon/execdriver/lxc/init.go b/daemon/execdriver/lxc/init.go index 52d75fc9f8..e21e717645 100644 --- a/daemon/execdriver/lxc/init.go +++ b/daemon/execdriver/lxc/init.go @@ -3,15 +3,16 @@ package lxc import ( "encoding/json" "fmt" - "github.com/dotcloud/docker/daemon/execdriver" - "github.com/dotcloud/docker/pkg/netlink" - "github.com/dotcloud/docker/pkg/user" - "github.com/syndtr/gocapability/capability" "io/ioutil" "net" "os" "strings" "syscall" + + "github.com/dotcloud/docker/daemon/execdriver" + "github.com/dotcloud/docker/pkg/netlink" + "github.com/dotcloud/docker/pkg/user" + "github.com/syndtr/gocapability/capability" ) // Clear environment pollution introduced by lxc-start diff --git a/daemon/execdriver/lxc/lxc_template.go b/daemon/execdriver/lxc/lxc_template.go index 19fa43c4c2..7fdc5ce92b 100644 --- a/daemon/execdriver/lxc/lxc_template.go +++ b/daemon/execdriver/lxc/lxc_template.go @@ -14,12 +14,13 @@ const LxcTemplate = ` lxc.network.type = veth lxc.network.link = {{.Network.Interface.Bridge}} lxc.network.name = eth0 -{{else}} +lxc.network.mtu = {{.Network.Mtu}} +{{else if not .Network.HostNetworking}} # network is disabled (-n=false) lxc.network.type = empty lxc.network.flags = up -{{end}} lxc.network.mtu = {{.Network.Mtu}} +{{end}} # root filesystem {{$ROOTFS := .Rootfs}} diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index b2dd395bb5..5070ef7838 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -53,6 +53,10 @@ func (d *driver) createContainer(c *execdriver.Command) (*libcontainer.Container } func (d *driver) createNetwork(container *libcontainer.Container, c *execdriver.Command) error { + if c.Network.HostNetworking { + container.Namespaces.Get("NEWNET").Enabled = false + return nil + } container.Networks = []*libcontainer.Network{ { Mtu: c.Network.Mtu, @@ -90,7 +94,6 @@ func (d *driver) createNetwork(container *libcontainer.Container, c *execdriver. }, }) } - return nil } diff --git a/runconfig/parse.go b/runconfig/parse.go index 42ad5c1958..eb9886bb97 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -292,6 +292,8 @@ func parseNetMode(netMode string) (string, error) { return "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) } return netMode, nil + case "host": + return netMode, nil default: return "", fmt.Errorf("invalid netmode: %q", netMode) } From 5ca6532011436eee85ccb555a0832a82450454ea Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 14:45:39 -0700 Subject: [PATCH 411/436] Update host networking with hostname and files Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/container.go | 43 +++++++++++++++++++++++++++++++++++------ runconfig/parse_test.go | 30 ---------------------------- 2 files changed, 37 insertions(+), 36 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 6769da9b25..9a08f87133 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -343,7 +343,7 @@ func populateCommand(c *Container, env []string) error { case "none": case "host": en.HostNetworking = true - case "bridge": + case "bridge", "": // empty string to support existing containers if !c.Config.NetworkDisabled { network := c.NetworkSettings en.Interface = &execdriver.NetworkInterface{ @@ -503,9 +503,18 @@ func (container *Container) StderrLogPipe() io.ReadCloser { return utils.NewBufReader(reader) } -func (container *Container) buildHostnameAndHostsFiles(IP string) { +func (container *Container) buildHostname() { container.HostnamePath = path.Join(container.root, "hostname") - ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) + + if container.Config.Domainname != "" { + ioutil.WriteFile(container.HostnamePath, []byte(fmt.Sprintf("%s.%s\n", container.Config.Hostname, container.Config.Domainname)), 0644) + } else { + ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) + } +} + +func (container *Container) buildHostnameAndHostsFiles(IP string) { + container.buildHostname() hostsContent := []byte(` 127.0.0.1 localhost @@ -523,12 +532,11 @@ ff02::2 ip6-allrouters } else if !container.Config.NetworkDisabled { hostsContent = append([]byte(fmt.Sprintf("%s\t%s\n", IP, container.Config.Hostname)), hostsContent...) } - ioutil.WriteFile(container.HostsPath, hostsContent, 0644) } func (container *Container) allocateNetwork() error { - if container.Config.NetworkDisabled { + if container.Config.NetworkDisabled || container.hostConfig.NetworkMode == "host" { return nil } @@ -981,14 +989,22 @@ func (container *Container) setupContainerDns() error { if container.ResolvConfPath != "" { return nil } + var ( config = container.hostConfig daemon = container.daemon ) + + if config.NetworkMode == "host" { + container.ResolvConfPath = "/etc/resolv.conf" + return nil + } + resolvConf, err := utils.GetResolvConf() if err != nil { return err } + // If custom dns exists, then create a resolv.conf for the container if len(config.Dns) > 0 || len(daemon.config.Dns) > 0 || len(config.DnsSearch) > 0 || len(daemon.config.DnsSearch) > 0 { var ( @@ -1028,7 +1044,22 @@ func (container *Container) setupContainerDns() error { } func (container *Container) initializeNetworking() error { - if container.daemon.config.DisableNetwork { + var err error + if container.hostConfig.NetworkMode == "host" { + container.Config.Hostname, err = os.Hostname() + if err != nil { + return err + } + + parts := strings.SplitN(container.Config.Hostname, ".", 2) + if len(parts) > 1 { + container.Config.Hostname = parts[0] + container.Config.Domainname = parts[1] + } + container.HostsPath = "/etc/hosts" + + container.buildHostname() + } else if container.daemon.config.DisableNetwork { container.Config.NetworkDisabled = true container.buildHostnameAndHostsFiles("127.0.1.1") } else { diff --git a/runconfig/parse_test.go b/runconfig/parse_test.go index e1b4cf9f93..8ad40b9d2d 100644 --- a/runconfig/parse_test.go +++ b/runconfig/parse_test.go @@ -22,33 +22,3 @@ func TestParseLxcConfOpt(t *testing.T) { } } } - -func TestParseNetMode(t *testing.T) { - testFlags := []struct { - flag string - mode string - container string - err bool - }{ - {"", "", "", true}, - {"bridge", "bridge", "", false}, - {"disable", "disable", "", false}, - {"container:foo", "container", "foo", false}, - {"container:", "", "", true}, - {"container", "", "", true}, - {"unknown", "", "", true}, - } - - for _, to := range testFlags { - mode, err := parseNetMode(to.flag) - if mode != to.mode { - t.Fatalf("-net %s: expected net mode: %q, got: %q", to.flag, to.mode, mode) - } - if container != to.container { - t.Fatalf("-net %s: expected net container: %q, got: %q", to.flag, to.container, container) - } - if (err != nil) != to.err { - t.Fatal("-net %s: expected an error got none", to.flag) - } - } -} From c1c6b3ccd915084bc9472992afa16f677a074785 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 15:32:26 -0700 Subject: [PATCH 412/436] Add docs for --net flag Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- docs/sources/reference/run.md | 46 +++++++++++++++++++++++++++++++++-- 1 file changed, 44 insertions(+), 2 deletions(-) diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index 0125394d4f..521e8010e2 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -136,8 +136,8 @@ PID files): ## Network Settings - -n=true : Enable networking for this container - --dns=[] : Set custom dns servers for the container + --dns=[] : Set custom dns servers for the container + --net=bridge : Set the network mode By default, all containers have networking enabled and they can make any outgoing connections. The operator can completely disable networking @@ -148,6 +148,48 @@ 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`. +Supported networking modes are: + +* none - no networking in the container +* bridge - (default) connect the container to the bridge via veth interfaces +* host - use the host's network stack inside the container +* container - use another container's network stack + +#### Mode: none +With the networking mode set to `none` a container will not have a access to +any external routes. The container will still have a `loopback` interface +enabled in the container but it does not have any routes to external traffic. + +#### Mode: bridge +With the networking mode set to `bridge` a container will use docker's default +networking setup. A bridge is setup on the host, commonly named `docker0`, +and a pair of veth interfaces will be created for the container. One side of +the veth pair will remain on the host attached to the bridge while the other +side of the pair will be placed inside the container's namespaces in addition +to the `loopback` interface. An IP address will be allocated for containers +on the bridge's network and trafic will be routed though this bridge to the +container. + +#### Mode: host +With the networking mode set to `host` a container will share the host's +network stack and all interfaces from the host will be available to the +container. The container's hostname will match the hostname on the host +system. Publishing ports and linking to other containers will not work +when sharing the host's network stack. + +#### Mode: container +With the networking mode set to `container` a container will share the +network stack of another container. The other container's name must be +provided in the format of `--net container:`. + +Example running a redis container with redis binding to localhost then +running the redis-cli and connecting to the redis server over the +localhost interface. + + $ docker run -d --name redis example/redis --bind 127.0.0.1 + $ # use the redis container's network stack to access localhost + $ docker run --rm -ti --net container:redis example/redis-cli -h 127.0.0.1 + ## Clean Up (–rm) By default a container's file system persists even after the container From 0b187b909be1dac60194250bc6e9ff292a0bd5c9 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Fri, 2 May 2014 16:59:28 -0700 Subject: [PATCH 413/436] Address code review feedback Also make sure we copy the joining containers hosts and resolv.conf with the hostname if we are joining it's network stack. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/container.go | 40 ++++++++++++++++++++++++++++++++++------ runconfig/hostconfig.go | 17 +++++++++++++++-- runconfig/parse.go | 17 +++++++---------- 3 files changed, 56 insertions(+), 18 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 9a08f87133..123eca0263 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -338,7 +338,7 @@ func populateCommand(c *Container, env []string) error { Interface: nil, } - parts := strings.SplitN(c.hostConfig.NetworkMode, ":", 2) + parts := strings.SplitN(string(c.hostConfig.NetworkMode), ":", 2) switch parts[0] { case "none": case "host": @@ -354,9 +354,9 @@ func populateCommand(c *Container, env []string) error { } } case "container": - nc := c.daemon.Get(parts[1]) - if nc == nil { - return fmt.Errorf("no such container to join network: %q", parts[1]) + nc, err := c.getNetworkedContainer() + if err != nil { + return err } en.ContainerID = nc.ID default: @@ -536,7 +536,8 @@ ff02::2 ip6-allrouters } func (container *Container) allocateNetwork() error { - if container.Config.NetworkDisabled || container.hostConfig.NetworkMode == "host" { + mode := container.hostConfig.NetworkMode + if container.Config.NetworkDisabled || mode.IsContainer() || mode.IsHost() { return nil } @@ -1045,7 +1046,7 @@ func (container *Container) setupContainerDns() error { func (container *Container) initializeNetworking() error { var err error - if container.hostConfig.NetworkMode == "host" { + if container.hostConfig.NetworkMode.IsHost() { container.Config.Hostname, err = os.Hostname() if err != nil { return err @@ -1059,6 +1060,16 @@ func (container *Container) initializeNetworking() error { container.HostsPath = "/etc/hosts" container.buildHostname() + } else if container.hostConfig.NetworkMode.IsContainer() { + // we need to get the hosts files from the container to join + nc, err := container.getNetworkedContainer() + if err != nil { + return err + } + container.HostsPath = nc.HostsPath + container.ResolvConfPath = nc.ResolvConfPath + container.Config.Hostname = nc.Config.Hostname + container.Config.Domainname = nc.Config.Domainname } else if container.daemon.config.DisableNetwork { container.Config.NetworkDisabled = true container.buildHostnameAndHostsFiles("127.0.1.1") @@ -1268,3 +1279,20 @@ func (container *Container) GetMountLabel() string { } return container.MountLabel } + +func (container *Container) getNetworkedContainer() (*Container, error) { + parts := strings.SplitN(string(container.hostConfig.NetworkMode), ":", 2) + switch parts[0] { + case "container": + nc := container.daemon.Get(parts[1]) + if nc == nil { + return nil, fmt.Errorf("no such container to join network: %s", parts[1]) + } + if !nc.State.IsRunning() { + return nil, fmt.Errorf("cannot join network of a non running container: %s", parts[1]) + } + return nc, nil + default: + return nil, fmt.Errorf("network mode not set to container") + } +} diff --git a/runconfig/hostconfig.go b/runconfig/hostconfig.go index 83688367e3..79ffad723b 100644 --- a/runconfig/hostconfig.go +++ b/runconfig/hostconfig.go @@ -1,11 +1,24 @@ package runconfig import ( + "strings" + "github.com/dotcloud/docker/engine" "github.com/dotcloud/docker/nat" "github.com/dotcloud/docker/utils" ) +type NetworkMode string + +func (n NetworkMode) IsHost() bool { + return n == "host" +} + +func (n NetworkMode) IsContainer() bool { + parts := strings.SplitN(string(n), ":", 2) + return len(parts) > 1 && parts[0] == "container" +} + type HostConfig struct { Binds []string ContainerIDFile string @@ -17,7 +30,7 @@ type HostConfig struct { Dns []string DnsSearch []string VolumesFrom []string - NetworkMode string + NetworkMode NetworkMode } func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { @@ -25,7 +38,7 @@ func ContainerHostConfigFromJob(job *engine.Job) *HostConfig { ContainerIDFile: job.Getenv("ContainerIDFile"), Privileged: job.GetenvBool("Privileged"), PublishAllPorts: job.GetenvBool("PublishAllPorts"), - NetworkMode: job.Getenv("NetworkMode"), + NetworkMode: NetworkMode(job.Getenv("NetworkMode")), } job.GetenvJson("LxcConf", &hostConfig.LxcConf) job.GetenvJson("PortBindings", &hostConfig.PortBindings) diff --git a/runconfig/parse.go b/runconfig/parse.go index eb9886bb97..0d511ef2ec 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -62,7 +62,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID") flWorkingDir = cmd.String([]string{"w", "-workdir"}, "", "Working directory inside the container") flCpuShares = cmd.Int64([]string{"c", "-cpu-shares"}, 0, "CPU shares (relative weight)") - flNetMode = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:name_or_id': reuses another container network stack)") + flNetMode = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:': reuses another container network stack)") // For documentation purpose _ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify all received signal to the process (even in non-tty mode)") _ = cmd.String([]string{"#name", "-name"}, "", "Assign a name to the container") @@ -200,7 +200,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf netMode, err := parseNetMode(*flNetMode) if err != nil { - return nil, nil, cmd, fmt.Errorf("-net: invalid net mode: %v", err) + return nil, nil, cmd, fmt.Errorf("--net: invalid net mode: %v", err) } config := &Config{ @@ -282,19 +282,16 @@ func parseKeyValueOpts(opts opts.ListOpts) ([]utils.KeyValuePair, error) { return out, nil } -func parseNetMode(netMode string) (string, error) { +func parseNetMode(netMode string) (NetworkMode, error) { parts := strings.Split(netMode, ":") switch mode := parts[0]; mode { - case "bridge", "none": - return mode, nil + case "bridge", "none", "host": case "container": if len(parts) < 2 || parts[1] == "" { - return "", fmt.Errorf("'container:' netmode requires a container id or name", netMode) + return "", fmt.Errorf("invalid container format container:") } - return netMode, nil - case "host": - return netMode, nil default: - return "", fmt.Errorf("invalid netmode: %q", netMode) + return "", fmt.Errorf("invalid --net: %s", netMode) } + return NetworkMode(netMode), nil } From 7da186c3e58c83605f0389d1214909b1cbbead39 Mon Sep 17 00:00:00 2001 From: unclejack Date: Mon, 5 May 2014 20:29:20 +0300 Subject: [PATCH 414/436] import sha512 to make sha512 ssl certs work Docker-DCO-1.1-Signed-off-by: Cristian Staretu (github: unclejack) --- registry/registry.go | 1 + 1 file changed, 1 insertion(+) diff --git a/registry/registry.go b/registry/registry.go index 1bd73cdeb5..28b28c2b5c 100644 --- a/registry/registry.go +++ b/registry/registry.go @@ -3,6 +3,7 @@ package registry import ( "bytes" "crypto/sha256" + _ "crypto/sha512" "encoding/json" "errors" "fmt" From f2d7c77c638040f64af6f968044f12e44653859d Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 10:47:55 -0700 Subject: [PATCH 415/436] Add alex as devmapper and btrfs maintainer Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/graphdriver/btrfs/MAINTAINERS | 1 + daemon/graphdriver/devmapper/MAINTAINERS | 1 + 2 files changed, 2 insertions(+) create mode 100644 daemon/graphdriver/btrfs/MAINTAINERS create mode 100644 daemon/graphdriver/devmapper/MAINTAINERS diff --git a/daemon/graphdriver/btrfs/MAINTAINERS b/daemon/graphdriver/btrfs/MAINTAINERS new file mode 100644 index 0000000000..9e629d5fcc --- /dev/null +++ b/daemon/graphdriver/btrfs/MAINTAINERS @@ -0,0 +1 @@ +Alexander Larsson (@alexlarsson) diff --git a/daemon/graphdriver/devmapper/MAINTAINERS b/daemon/graphdriver/devmapper/MAINTAINERS new file mode 100644 index 0000000000..9e629d5fcc --- /dev/null +++ b/daemon/graphdriver/devmapper/MAINTAINERS @@ -0,0 +1 @@ +Alexander Larsson (@alexlarsson) From 5b094530c09bca403819c06635c2f7fbaf98b937 Mon Sep 17 00:00:00 2001 From: Alexander Larsson Date: Wed, 23 Apr 2014 11:00:12 +0200 Subject: [PATCH 416/436] cgroups: Update systemd to match fs backend This updates systemd.Apply to match the fs backend by: * Always join blockio controller (for stats) * Support CpusetCpus * Support MemorySwap Also, it removes the generic UnitProperties in favour of a single option to set the slice. Docker-DCO-1.1-Signed-off-by: Alexander Larsson (github: alexlarsson) --- .../execdriver/native/configuration/parse.go | 11 ++ pkg/cgroups/cgroups.go | 2 +- pkg/cgroups/systemd/apply_nosystemd.go | 2 +- pkg/cgroups/systemd/apply_systemd.go | 151 ++++++++++++++++-- 4 files changed, 153 insertions(+), 13 deletions(-) diff --git a/daemon/execdriver/native/configuration/parse.go b/daemon/execdriver/native/configuration/parse.go index c3846af910..94af91aab1 100644 --- a/daemon/execdriver/native/configuration/parse.go +++ b/daemon/execdriver/native/configuration/parse.go @@ -27,6 +27,8 @@ var actions = map[string]Action{ "cgroups.memory_swap": memorySwap, // set the memory swap limit "cgroups.cpuset.cpus": cpusetCpus, // set the cpus used + "systemd.slice": systemdSlice, // set parent Slice used for systemd unit + "apparmor_profile": apparmorProfile, // set the apparmor profile to apply "fs.readonly": readonlyFs, // make the rootfs of the container read only @@ -41,6 +43,15 @@ func cpusetCpus(container *libcontainer.Container, context interface{}, value st return nil } +func systemdSlice(container *libcontainer.Container, context interface{}, value string) error { + if container.Cgroups == nil { + return fmt.Errorf("cannot set slice when cgroups are disabled") + } + container.Cgroups.Slice = value + + return nil +} + func apparmorProfile(container *libcontainer.Container, context interface{}, value string) error { container.Context["apparmor_profile"] = value return nil diff --git a/pkg/cgroups/cgroups.go b/pkg/cgroups/cgroups.go index 86623845ae..0f93320725 100644 --- a/pkg/cgroups/cgroups.go +++ b/pkg/cgroups/cgroups.go @@ -22,7 +22,7 @@ type Cgroup struct { CpusetCpus string `json:"cpuset_cpus,omitempty"` // CPU to use Freezer string `json:"freezer,omitempty"` // set the freeze value for the process - UnitProperties [][2]string `json:"unit_properties,omitempty"` // systemd unit properties + Slice string `json:"slice,omitempty"` // Parent slice to use for systemd } type ActiveCgroup interface { diff --git a/pkg/cgroups/systemd/apply_nosystemd.go b/pkg/cgroups/systemd/apply_nosystemd.go index 226aa59f9d..4faa749745 100644 --- a/pkg/cgroups/systemd/apply_nosystemd.go +++ b/pkg/cgroups/systemd/apply_nosystemd.go @@ -11,6 +11,6 @@ func UseSystemd() bool { return false } -func systemdApply(c *Cgroup, pid int) (cgroups.ActiveCgroup, error) { +func Apply(c *Cgroup, pid int) (cgroups.ActiveCgroup, error) { return nil, fmt.Errorf("Systemd not supported") } diff --git a/pkg/cgroups/systemd/apply_systemd.go b/pkg/cgroups/systemd/apply_systemd.go index e1246f6e70..12dede9581 100644 --- a/pkg/cgroups/systemd/apply_systemd.go +++ b/pkg/cgroups/systemd/apply_systemd.go @@ -3,9 +3,10 @@ package systemd import ( - "fmt" "io/ioutil" + "os" "path/filepath" + "strconv" "strings" "sync" @@ -16,6 +17,7 @@ import ( ) type systemdCgroup struct { + cleanupDirs []string } type DeviceAllow struct { @@ -69,20 +71,42 @@ func getIfaceForUnit(unitName string) string { return "Unit" } +type cgroupArg struct { + File string + Value string +} + func Apply(c *cgroups.Cgroup, pid int) (cgroups.ActiveCgroup, error) { var ( unitName = c.Parent + "-" + c.Name + ".scope" slice = "system.slice" properties []systemd1.Property + cpuArgs []cgroupArg + cpusetArgs []cgroupArg + memoryArgs []cgroupArg + res systemdCgroup ) - for _, v := range c.UnitProperties { - switch v[0] { - case "Slice": - slice = v[1] - default: - return nil, fmt.Errorf("Unknown unit propery %s", v[0]) + // First set up things not supported by systemd + + // -1 disables memorySwap + if c.MemorySwap >= 0 && (c.Memory != 0 || c.MemorySwap > 0) { + memorySwap := c.MemorySwap + + if memorySwap == 0 { + // By default, MemorySwap is set to twice the size of RAM. + memorySwap = c.Memory * 2 } + + memoryArgs = append(memoryArgs, cgroupArg{"memory.memsw.limit_in_bytes", strconv.FormatInt(memorySwap, 10)}) + } + + if c.CpusetCpus != "" { + cpusetArgs = append(cpusetArgs, cgroupArg{"cpuset.cpus", c.CpusetCpus}) + } + + if c.Slice != "" { + slice = c.Slice } properties = append(properties, @@ -111,11 +135,12 @@ func Apply(c *cgroups.Cgroup, pid int) (cgroups.ActiveCgroup, error) { })}) } - // Always enable accounting, this gets us the same behaviour as the raw implementation, + // Always enable accounting, this gets us the same behaviour as the fs implementation, // plus the kernel has some problems with joining the memory cgroup at a later time. properties = append(properties, systemd1.Property{"MemoryAccounting", dbus.MakeVariant(true)}, - systemd1.Property{"CPUAccounting", dbus.MakeVariant(true)}) + systemd1.Property{"CPUAccounting", dbus.MakeVariant(true)}, + systemd1.Property{"BlockIOAccounting", dbus.MakeVariant(true)}) if c.Memory != 0 { properties = append(properties, @@ -162,10 +187,114 @@ func Apply(c *cgroups.Cgroup, pid int) (cgroups.ActiveCgroup, error) { return nil, err } } - return &systemdCgroup{}, nil + + if len(cpuArgs) != 0 { + mountpoint, err := cgroups.FindCgroupMountpoint("cpu") + if err != nil { + return nil, err + } + + path := filepath.Join(mountpoint, cgroup) + + for _, arg := range cpuArgs { + if err := ioutil.WriteFile(filepath.Join(path, arg.File), []byte(arg.Value), 0700); err != nil { + return nil, err + } + } + } + + if len(memoryArgs) != 0 { + mountpoint, err := cgroups.FindCgroupMountpoint("memory") + if err != nil { + return nil, err + } + + path := filepath.Join(mountpoint, cgroup) + + for _, arg := range memoryArgs { + if err := ioutil.WriteFile(filepath.Join(path, arg.File), []byte(arg.Value), 0700); err != nil { + return nil, err + } + } + } + + if len(cpusetArgs) != 0 { + // systemd does not atm set up the cpuset controller, so we must manually + // join it. Additionally that is a very finicky controller where each + // level must have a full setup as the default for a new directory is "no cpus", + // so we avoid using any hierarchies here, creating a toplevel directory. + mountpoint, err := cgroups.FindCgroupMountpoint("cpuset") + if err != nil { + return nil, err + } + initPath, err := cgroups.GetInitCgroupDir("cpuset") + if err != nil { + return nil, err + } + + rootPath := filepath.Join(mountpoint, initPath) + + path := filepath.Join(mountpoint, initPath, c.Parent+"-"+c.Name) + + res.cleanupDirs = append(res.cleanupDirs, path) + + if err := os.MkdirAll(path, 0755); err != nil && !os.IsExist(err) { + return nil, err + } + + foundCpus := false + foundMems := false + + for _, arg := range cpusetArgs { + if arg.File == "cpuset.cpus" { + foundCpus = true + } + if arg.File == "cpuset.mems" { + foundMems = true + } + if err := ioutil.WriteFile(filepath.Join(path, arg.File), []byte(arg.Value), 0700); err != nil { + return nil, err + } + } + + // These are required, if not specified inherit from parent + if !foundCpus { + s, err := ioutil.ReadFile(filepath.Join(rootPath, "cpuset.cpus")) + if err != nil { + return nil, err + } + + if err := ioutil.WriteFile(filepath.Join(path, "cpuset.cpus"), s, 0700); err != nil { + return nil, err + } + } + + // These are required, if not specified inherit from parent + if !foundMems { + s, err := ioutil.ReadFile(filepath.Join(rootPath, "cpuset.mems")) + if err != nil { + return nil, err + } + + if err := ioutil.WriteFile(filepath.Join(path, "cpuset.mems"), s, 0700); err != nil { + return nil, err + } + } + + if err := ioutil.WriteFile(filepath.Join(path, "cgroup.procs"), []byte(strconv.Itoa(pid)), 0700); err != nil { + return nil, err + } + } + + return &res, nil } func (c *systemdCgroup) Cleanup() error { - // systemd cleans up, we don't need to do anything + // systemd cleans up, we don't need to do much + + for _, path := range c.cleanupDirs { + os.RemoveAll(path) + } + return nil } From 412324cfbe9b5e256d9af31b21e6ae142d39612c Mon Sep 17 00:00:00 2001 From: Rohit Jnagal Date: Mon, 5 May 2014 18:12:25 +0000 Subject: [PATCH 417/436] Check supplied hostname before using it. Docker-DCO-1.1-Signed-off-by: Rohit Jnagal (github: rjnagal) --- pkg/libcontainer/nsinit/init.go | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/pkg/libcontainer/nsinit/init.go b/pkg/libcontainer/nsinit/init.go index faec12af32..99974c6c35 100644 --- a/pkg/libcontainer/nsinit/init.go +++ b/pkg/libcontainer/nsinit/init.go @@ -65,8 +65,10 @@ func Init(container *libcontainer.Container, uncleanRootfs, consolePath string, if err := mount.InitializeMountNamespace(rootfs, consolePath, container); err != nil { return fmt.Errorf("setup mount namespace %s", err) } - if err := system.Sethostname(container.Hostname); err != nil { - return fmt.Errorf("sethostname %s", err) + if container.Hostname != "" { + if err := system.Sethostname(container.Hostname); err != nil { + return fmt.Errorf("sethostname %s", err) + } } if err := FinalizeNamespace(container); err != nil { return fmt.Errorf("finalize namespace %s", err) From db5f6b4aa0b34adbc9ba189a042e77e7bcdee681 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 12:34:21 -0700 Subject: [PATCH 418/436] Improve libcontainer namespace and cap format Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- .../execdriver/native/configuration/parse.go | 29 +-- .../native/configuration/parse_test.go | 19 +- daemon/execdriver/native/create.go | 4 +- .../native/template/default_template.go | 47 ++-- pkg/libcontainer/container.go | 4 +- pkg/libcontainer/container.json | 207 +++++------------- pkg/libcontainer/container_test.go | 14 +- pkg/libcontainer/nsinit/exec.go | 10 +- pkg/libcontainer/nsinit/execin.go | 29 ++- pkg/libcontainer/nsinit/unsupported.go | 2 +- .../security/capabilities/capabilities.go | 11 +- pkg/libcontainer/types.go | 45 ++-- pkg/libcontainer/types_linux.go | 12 +- 13 files changed, 170 insertions(+), 263 deletions(-) diff --git a/daemon/execdriver/native/configuration/parse.go b/daemon/execdriver/native/configuration/parse.go index c3846af910..3bfc7d7e79 100644 --- a/daemon/execdriver/native/configuration/parse.go +++ b/daemon/execdriver/native/configuration/parse.go @@ -2,12 +2,13 @@ package configuration import ( "fmt" - "github.com/dotcloud/docker/pkg/libcontainer" - "github.com/dotcloud/docker/utils" "os/exec" "path/filepath" "strconv" "strings" + + "github.com/dotcloud/docker/pkg/libcontainer" + "github.com/dotcloud/docker/utils" ) type Action func(*libcontainer.Container, interface{}, string) error @@ -97,38 +98,22 @@ func memorySwap(container *libcontainer.Container, context interface{}, value st } func addCap(container *libcontainer.Container, context interface{}, value string) error { - c := container.CapabilitiesMask.Get(value) - if c == nil { - return fmt.Errorf("%s is not a valid capability", value) - } - c.Enabled = true + container.CapabilitiesMask[value] = true return nil } func dropCap(container *libcontainer.Container, context interface{}, value string) error { - c := container.CapabilitiesMask.Get(value) - if c == nil { - return fmt.Errorf("%s is not a valid capability", value) - } - c.Enabled = false + container.CapabilitiesMask[value] = false return nil } func addNamespace(container *libcontainer.Container, context interface{}, value string) error { - ns := container.Namespaces.Get(value) - if ns == nil { - return fmt.Errorf("%s is not a valid namespace", value[1:]) - } - ns.Enabled = true + container.Namespaces[value] = true return nil } func dropNamespace(container *libcontainer.Container, context interface{}, value string) error { - ns := container.Namespaces.Get(value) - if ns == nil { - return fmt.Errorf("%s is not a valid namespace", value[1:]) - } - ns.Enabled = false + container.Namespaces[value] = false return nil } diff --git a/daemon/execdriver/native/configuration/parse_test.go b/daemon/execdriver/native/configuration/parse_test.go index c28176f2ef..1b0316b688 100644 --- a/daemon/execdriver/native/configuration/parse_test.go +++ b/daemon/execdriver/native/configuration/parse_test.go @@ -1,8 +1,9 @@ package configuration import ( - "github.com/dotcloud/docker/daemon/execdriver/native/template" "testing" + + "github.com/dotcloud/docker/daemon/execdriver/native/template" ) func TestSetReadonlyRootFs(t *testing.T) { @@ -38,10 +39,10 @@ func TestConfigurationsDoNotConflict(t *testing.T) { t.Fatal(err) } - if !container1.CapabilitiesMask.Get("NET_ADMIN").Enabled { + if !container1.CapabilitiesMask["NET_ADMIN"] { t.Fatal("container one should have NET_ADMIN enabled") } - if container2.CapabilitiesMask.Get("NET_ADMIN").Enabled { + if container2.CapabilitiesMask["NET_ADMIN"] { t.Fatal("container two should not have NET_ADMIN enabled") } } @@ -137,10 +138,10 @@ func TestAddCap(t *testing.T) { t.Fatal(err) } - if !container.CapabilitiesMask.Get("MKNOD").Enabled { + if !container.CapabilitiesMask["MKNOD"] { t.Fatal("container should have MKNOD enabled") } - if !container.CapabilitiesMask.Get("SYS_ADMIN").Enabled { + if !container.CapabilitiesMask["SYS_ADMIN"] { t.Fatal("container should have SYS_ADMIN enabled") } } @@ -153,14 +154,14 @@ func TestDropCap(t *testing.T) { } ) // enabled all caps like in privileged mode - for _, c := range container.CapabilitiesMask { - c.Enabled = true + for key := range container.CapabilitiesMask { + container.CapabilitiesMask[key] = true } if err := ParseConfiguration(container, nil, opts); err != nil { t.Fatal(err) } - if container.CapabilitiesMask.Get("MKNOD").Enabled { + if container.CapabilitiesMask["MKNOD"] { t.Fatal("container should not have MKNOD enabled") } } @@ -176,7 +177,7 @@ func TestDropNamespace(t *testing.T) { t.Fatal(err) } - if container.Namespaces.Get("NEWNET").Enabled { + if container.Namespaces["NEWNET"] { t.Fatal("container should not have NEWNET enabled") } } diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index 5562d08986..12aa64c9df 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -79,8 +79,8 @@ func (d *driver) createNetwork(container *libcontainer.Container, c *execdriver. } func (d *driver) setPrivileged(container *libcontainer.Container) error { - for _, c := range container.CapabilitiesMask { - c.Enabled = true + for key := range container.CapabilitiesMask { + container.CapabilitiesMask[key] = true } container.Cgroups.DeviceAccess = true diff --git a/daemon/execdriver/native/template/default_template.go b/daemon/execdriver/native/template/default_template.go index 5dbe21ecb0..249c5d5fe8 100644 --- a/daemon/execdriver/native/template/default_template.go +++ b/daemon/execdriver/native/template/default_template.go @@ -9,30 +9,30 @@ import ( // New returns the docker default configuration for libcontainer func New() *libcontainer.Container { container := &libcontainer.Container{ - CapabilitiesMask: libcontainer.Capabilities{ - libcontainer.GetCapability("SETPCAP"), - libcontainer.GetCapability("SYS_MODULE"), - libcontainer.GetCapability("SYS_RAWIO"), - libcontainer.GetCapability("SYS_PACCT"), - libcontainer.GetCapability("SYS_ADMIN"), - libcontainer.GetCapability("SYS_NICE"), - libcontainer.GetCapability("SYS_RESOURCE"), - libcontainer.GetCapability("SYS_TIME"), - libcontainer.GetCapability("SYS_TTY_CONFIG"), - libcontainer.GetCapability("AUDIT_WRITE"), - libcontainer.GetCapability("AUDIT_CONTROL"), - libcontainer.GetCapability("MAC_OVERRIDE"), - libcontainer.GetCapability("MAC_ADMIN"), - libcontainer.GetCapability("NET_ADMIN"), - libcontainer.GetCapability("MKNOD"), - libcontainer.GetCapability("SYSLOG"), + CapabilitiesMask: map[string]bool{ + "SETPCAP": false, + "SYS_MODULE": false, + "SYS_RAWIO": false, + "SYS_PACCT": false, + "SYS_ADMIN": false, + "SYS_NICE": false, + "SYS_RESOURCE": false, + "SYS_TIME": false, + "SYS_TTY_CONFIG": false, + "AUDIT_WRITE": false, + "AUDIT_CONTROL": false, + "MAC_OVERRIDE": false, + "MAC_ADMIN": false, + "NET_ADMIN": false, + "MKNOD": true, + "SYSLOG": false, }, - Namespaces: libcontainer.Namespaces{ - libcontainer.GetNamespace("NEWNS"), - libcontainer.GetNamespace("NEWUTS"), - libcontainer.GetNamespace("NEWIPC"), - libcontainer.GetNamespace("NEWPID"), - libcontainer.GetNamespace("NEWNET"), + Namespaces: map[string]bool{ + "NEWNS": true, + "NEWUTS": true, + "NEWIPC": true, + "NEWPID": true, + "NEWNET": true, }, Cgroups: &cgroups.Cgroup{ Parent: "docker", @@ -40,7 +40,6 @@ func New() *libcontainer.Container { }, Context: libcontainer.Context{}, } - container.CapabilitiesMask.Get("MKNOD").Enabled = true if apparmor.IsEnabled() { container.Context["apparmor_profile"] = "docker-default" } diff --git a/pkg/libcontainer/container.go b/pkg/libcontainer/container.go index ddcc6cab70..5acdff3d29 100644 --- a/pkg/libcontainer/container.go +++ b/pkg/libcontainer/container.go @@ -18,8 +18,8 @@ type Container struct { WorkingDir string `json:"working_dir,omitempty"` // current working directory Env []string `json:"environment,omitempty"` // environment to set Tty bool `json:"tty,omitempty"` // setup a proper tty or not - Namespaces Namespaces `json:"namespaces,omitempty"` // namespaces to apply - CapabilitiesMask Capabilities `json:"capabilities_mask,omitempty"` // capabilities to drop + Namespaces map[string]bool `json:"namespaces,omitempty"` // namespaces to apply + CapabilitiesMask map[string]bool `json:"capabilities_mask,omitempty"` // capabilities to drop Networks []*Network `json:"networks,omitempty"` // nil for host's network stack Cgroups *cgroups.Cgroup `json:"cgroups,omitempty"` // cgroups Context Context `json:"context,omitempty"` // generic context for specific options (apparmor, selinux) diff --git a/pkg/libcontainer/container.json b/pkg/libcontainer/container.json index 20c1121911..33d79600d4 100644 --- a/pkg/libcontainer/container.json +++ b/pkg/libcontainer/container.json @@ -1,151 +1,62 @@ { - "mounts" : [ - { - "type" : "devtmpfs" - } - ], - "tty" : true, - "environment" : [ - "HOME=/", - "PATH=PATH=$PATH:/bin:/usr/bin:/sbin:/usr/sbin", - "container=docker", - "TERM=xterm-256color" - ], - "hostname" : "koye", - "cgroups" : { - "parent" : "docker", - "name" : "docker-koye" - }, - "capabilities_mask" : [ - { - "value" : 8, - "key" : "SETPCAP", - "enabled" : false + "namespaces": { + "NEWNET": true, + "NEWPID": true, + "NEWIPC": true, + "NEWUTS": true, + "NEWNS": true + }, + "networks": [ + { + "gateway": "localhost", + "type": "loopback", + "address": "127.0.0.1/0", + "mtu": 1500 + }, + { + "gateway": "172.17.42.1", + "context": { + "prefix": "veth", + "bridge": "docker0" }, - { - "enabled" : false, - "value" : 16, - "key" : "SYS_MODULE" - }, - { - "value" : 17, - "key" : "SYS_RAWIO", - "enabled" : false - }, - { - "key" : "SYS_PACCT", - "value" : 20, - "enabled" : false - }, - { - "value" : 21, - "key" : "SYS_ADMIN", - "enabled" : false - }, - { - "value" : 23, - "key" : "SYS_NICE", - "enabled" : false - }, - { - "value" : 24, - "key" : "SYS_RESOURCE", - "enabled" : false - }, - { - "key" : "SYS_TIME", - "value" : 25, - "enabled" : false - }, - { - "enabled" : false, - "value" : 26, - "key" : "SYS_TTY_CONFIG" - }, - { - "key" : "AUDIT_WRITE", - "value" : 29, - "enabled" : false - }, - { - "value" : 30, - "key" : "AUDIT_CONTROL", - "enabled" : false - }, - { - "enabled" : false, - "key" : "MAC_OVERRIDE", - "value" : 32 - }, - { - "enabled" : false, - "key" : "MAC_ADMIN", - "value" : 33 - }, - { - "key" : "NET_ADMIN", - "value" : 12, - "enabled" : false - }, - { - "value" : 27, - "key" : "MKNOD", - "enabled" : true - }, - { - "value" : 34, - "key" : "SYSLOG", - "enabled" : false - } - ], - "networks" : [ - { - "mtu" : 1500, - "address" : "127.0.0.1/0", - "type" : "loopback", - "gateway" : "localhost" - }, - { - "mtu" : 1500, - "address" : "172.17.42.2/16", - "type" : "veth", - "context" : { - "bridge" : "docker0", - "prefix" : "veth" - }, - "gateway" : "172.17.42.1" - } - ], - "namespaces" : [ - { - "key" : "NEWNS", - "value" : 131072, - "enabled" : true, - "file" : "mnt" - }, - { - "key" : "NEWUTS", - "value" : 67108864, - "enabled" : true, - "file" : "uts" - }, - { - "enabled" : true, - "file" : "ipc", - "key" : "NEWIPC", - "value" : 134217728 - }, - { - "file" : "pid", - "enabled" : true, - "value" : 536870912, - "key" : "NEWPID" - }, - { - "enabled" : true, - "file" : "net", - "key" : "NEWNET", - "value" : 1073741824 - } - ] + "type": "veth", + "address": "172.17.42.2/16", + "mtu": 1500 + } + ], + "capabilities_mask": { + "SYSLOG": false, + "MKNOD": true, + "NET_ADMIN": false, + "MAC_ADMIN": false, + "MAC_OVERRIDE": false, + "AUDIT_CONTROL": false, + "AUDIT_WRITE": false, + "SYS_TTY_CONFIG": false, + "SETPCAP": false, + "SYS_MODULE": false, + "SYS_RAWIO": false, + "SYS_PACCT": false, + "SYS_ADMIN": false, + "SYS_NICE": false, + "SYS_RESOURCE": false, + "SYS_TIME": false + }, + "cgroups": { + "name": "docker-koye", + "parent": "docker" + }, + "hostname": "koye", + "environment": [ + "HOME=/", + "PATH=PATH=$PATH:/bin:/usr/bin:/sbin:/usr/sbin", + "container=docker", + "TERM=xterm-256color" + ], + "tty": true, + "mounts": [ + { + "type": "devtmpfs" + } + ] } diff --git a/pkg/libcontainer/container_test.go b/pkg/libcontainer/container_test.go index d710a6a53c..c02385af3f 100644 --- a/pkg/libcontainer/container_test.go +++ b/pkg/libcontainer/container_test.go @@ -15,7 +15,7 @@ func TestContainerJsonFormat(t *testing.T) { var container *Container if err := json.NewDecoder(f).Decode(&container); err != nil { - t.Fatal("failed to decode container config") + t.Fatalf("failed to decode container config: %s", err) } if container.Hostname != "koye" { t.Log("hostname is not set") @@ -27,32 +27,32 @@ func TestContainerJsonFormat(t *testing.T) { t.Fail() } - if !container.Namespaces.Contains("NEWNET") { + if !container.Namespaces["NEWNET"] { t.Log("namespaces should contain NEWNET") t.Fail() } - if container.Namespaces.Contains("NEWUSER") { + if container.Namespaces["NEWUSER"] { t.Log("namespaces should not contain NEWUSER") t.Fail() } - if !container.CapabilitiesMask.Contains("SYS_ADMIN") { + if _, exists := container.CapabilitiesMask["SYS_ADMIN"]; !exists { t.Log("capabilities mask should contain SYS_ADMIN") t.Fail() } - if container.CapabilitiesMask.Get("SYS_ADMIN").Enabled { + if container.CapabilitiesMask["SYS_ADMIN"] { t.Log("SYS_ADMIN should not be enabled in capabilities mask") t.Fail() } - if !container.CapabilitiesMask.Get("MKNOD").Enabled { + if !container.CapabilitiesMask["MKNOD"] { t.Log("MKNOD should be enabled in capabilities mask") t.Fail() } - if container.CapabilitiesMask.Contains("SYS_CHROOT") { + if container.CapabilitiesMask["SYS_CHROOT"] { t.Log("capabilities mask should not contain SYS_CHROOT") t.Fail() } diff --git a/pkg/libcontainer/nsinit/exec.go b/pkg/libcontainer/nsinit/exec.go index 8886efeb32..5d0d772a0f 100644 --- a/pkg/libcontainer/nsinit/exec.go +++ b/pkg/libcontainer/nsinit/exec.go @@ -159,10 +159,12 @@ func InitializeNetworking(container *libcontainer.Container, nspid int, pipe *Sy // GetNamespaceFlags parses the container's Namespaces options to set the correct // flags on clone, unshare, and setns -func GetNamespaceFlags(namespaces libcontainer.Namespaces) (flag int) { - for _, ns := range namespaces { - if ns.Enabled { - flag |= ns.Value +func GetNamespaceFlags(namespaces map[string]bool) (flag int) { + for key, enabled := range namespaces { + if enabled { + if ns := libcontainer.GetNamespace(key); ns != nil { + flag |= ns.Value + } } } return flag diff --git a/pkg/libcontainer/nsinit/execin.go b/pkg/libcontainer/nsinit/execin.go index 608437f855..40b95093dd 100644 --- a/pkg/libcontainer/nsinit/execin.go +++ b/pkg/libcontainer/nsinit/execin.go @@ -23,11 +23,13 @@ func ExecIn(container *libcontainer.Container, nspid int, args []string) (int, e return -1, err } - for _, nsv := range container.Namespaces { + for key, enabled := range container.Namespaces { // skip the PID namespace on unshare because it it not supported - if nsv.Enabled && nsv.Key != "NEWPID" { - if err := system.Unshare(nsv.Value); err != nil { - return -1, err + if enabled && key != "NEWPID" { + if ns := libcontainer.GetNamespace(key); ns != nil { + if err := system.Unshare(ns.Value); err != nil { + return -1, err + } } } } @@ -59,7 +61,7 @@ func ExecIn(container *libcontainer.Container, nspid int, args []string) (int, e // if the container has a new pid and mount namespace we need to // remount proc and sys to pick up the changes - if container.Namespaces.Contains("NEWNS") && container.Namespaces.Contains("NEWPID") { + if container.Namespaces["NEWNS"] && container.Namespaces["NEWPID"] { pid, err := system.Fork() if err != nil { return -1, err @@ -102,13 +104,18 @@ dropAndExec: } func getNsFds(pid int, container *libcontainer.Container) ([]uintptr, error) { - fds := make([]uintptr, len(container.Namespaces)) - for i, ns := range container.Namespaces { - f, err := os.OpenFile(filepath.Join("/proc/", strconv.Itoa(pid), "ns", ns.File), os.O_RDONLY, 0) - if err != nil { - return fds, err + fds := []uintptr{} + + for key, enabled := range container.Namespaces { + if enabled { + if ns := libcontainer.GetNamespace(key); ns != nil { + f, err := os.OpenFile(filepath.Join("/proc/", strconv.Itoa(pid), "ns", ns.File), os.O_RDONLY, 0) + if err != nil { + return fds, err + } + fds = append(fds, f.Fd()) + } } - fds[i] = f.Fd() } return fds, nil } diff --git a/pkg/libcontainer/nsinit/unsupported.go b/pkg/libcontainer/nsinit/unsupported.go index f213f2ec88..929b3dba5b 100644 --- a/pkg/libcontainer/nsinit/unsupported.go +++ b/pkg/libcontainer/nsinit/unsupported.go @@ -23,6 +23,6 @@ func SetupCgroups(container *libcontainer.Container, nspid int) (cgroups.ActiveC return nil, libcontainer.ErrUnsupported } -func GetNamespaceFlags(namespaces libcontainer.Namespaces) (flag int) { +func GetNamespaceFlags(namespaces map[string]bool) (flag int) { return 0 } diff --git a/pkg/libcontainer/security/capabilities/capabilities.go b/pkg/libcontainer/security/capabilities/capabilities.go index 4b81e708c7..ad13e672c7 100644 --- a/pkg/libcontainer/security/capabilities/capabilities.go +++ b/pkg/libcontainer/security/capabilities/capabilities.go @@ -1,9 +1,10 @@ package capabilities import ( + "os" + "github.com/dotcloud/docker/pkg/libcontainer" "github.com/syndtr/gocapability/capability" - "os" ) // DropCapabilities drops capabilities for the current process based @@ -26,9 +27,11 @@ func DropCapabilities(container *libcontainer.Container) error { // getCapabilitiesMask returns the specific cap mask values for the libcontainer types func getCapabilitiesMask(container *libcontainer.Container) []capability.Cap { drop := []capability.Cap{} - for _, c := range container.CapabilitiesMask { - if !c.Enabled { - drop = append(drop, c.Value) + for key, enabled := range container.CapabilitiesMask { + if !enabled { + if c := libcontainer.GetCapability(key); c != nil { + drop = append(drop, c.Value) + } } } return drop diff --git a/pkg/libcontainer/types.go b/pkg/libcontainer/types.go index f5fe6cffa9..8f056c817d 100644 --- a/pkg/libcontainer/types.go +++ b/pkg/libcontainer/types.go @@ -2,6 +2,7 @@ package libcontainer import ( "errors" + "github.com/syndtr/gocapability/capability" ) @@ -38,31 +39,30 @@ var ( namespaceList = Namespaces{} capabilityList = Capabilities{ - {Key: "SETPCAP", Value: capability.CAP_SETPCAP, Enabled: false}, - {Key: "SYS_MODULE", Value: capability.CAP_SYS_MODULE, Enabled: false}, - {Key: "SYS_RAWIO", Value: capability.CAP_SYS_RAWIO, Enabled: false}, - {Key: "SYS_PACCT", Value: capability.CAP_SYS_PACCT, Enabled: false}, - {Key: "SYS_ADMIN", Value: capability.CAP_SYS_ADMIN, Enabled: false}, - {Key: "SYS_NICE", Value: capability.CAP_SYS_NICE, Enabled: false}, - {Key: "SYS_RESOURCE", Value: capability.CAP_SYS_RESOURCE, Enabled: false}, - {Key: "SYS_TIME", Value: capability.CAP_SYS_TIME, Enabled: false}, - {Key: "SYS_TTY_CONFIG", Value: capability.CAP_SYS_TTY_CONFIG, Enabled: false}, - {Key: "MKNOD", Value: capability.CAP_MKNOD, Enabled: false}, - {Key: "AUDIT_WRITE", Value: capability.CAP_AUDIT_WRITE, Enabled: false}, - {Key: "AUDIT_CONTROL", Value: capability.CAP_AUDIT_CONTROL, Enabled: false}, - {Key: "MAC_OVERRIDE", Value: capability.CAP_MAC_OVERRIDE, Enabled: false}, - {Key: "MAC_ADMIN", Value: capability.CAP_MAC_ADMIN, Enabled: false}, - {Key: "NET_ADMIN", Value: capability.CAP_NET_ADMIN, Enabled: false}, - {Key: "SYSLOG", Value: capability.CAP_SYSLOG, Enabled: false}, + {Key: "SETPCAP", Value: capability.CAP_SETPCAP}, + {Key: "SYS_MODULE", Value: capability.CAP_SYS_MODULE}, + {Key: "SYS_RAWIO", Value: capability.CAP_SYS_RAWIO}, + {Key: "SYS_PACCT", Value: capability.CAP_SYS_PACCT}, + {Key: "SYS_ADMIN", Value: capability.CAP_SYS_ADMIN}, + {Key: "SYS_NICE", Value: capability.CAP_SYS_NICE}, + {Key: "SYS_RESOURCE", Value: capability.CAP_SYS_RESOURCE}, + {Key: "SYS_TIME", Value: capability.CAP_SYS_TIME}, + {Key: "SYS_TTY_CONFIG", Value: capability.CAP_SYS_TTY_CONFIG}, + {Key: "MKNOD", Value: capability.CAP_MKNOD}, + {Key: "AUDIT_WRITE", Value: capability.CAP_AUDIT_WRITE}, + {Key: "AUDIT_CONTROL", Value: capability.CAP_AUDIT_CONTROL}, + {Key: "MAC_OVERRIDE", Value: capability.CAP_MAC_OVERRIDE}, + {Key: "MAC_ADMIN", Value: capability.CAP_MAC_ADMIN}, + {Key: "NET_ADMIN", Value: capability.CAP_NET_ADMIN}, + {Key: "SYSLOG", Value: capability.CAP_SYSLOG}, } ) type ( Namespace struct { - Key string `json:"key,omitempty"` - Enabled bool `json:"enabled,omitempty"` - Value int `json:"value,omitempty"` - File string `json:"file,omitempty"` + Key string `json:"key,omitempty"` + Value int `json:"value,omitempty"` + File string `json:"file,omitempty"` } Namespaces []*Namespace ) @@ -98,9 +98,8 @@ func (n Namespaces) Get(ns string) *Namespace { type ( Capability struct { - Key string `json:"key,omitempty"` - Enabled bool `json:"enabled"` - Value capability.Cap `json:"value,omitempty"` + Key string `json:"key,omitempty"` + Value capability.Cap `json:"value,omitempty"` } Capabilities []*Capability ) diff --git a/pkg/libcontainer/types_linux.go b/pkg/libcontainer/types_linux.go index 1f937e0c97..c14531df20 100644 --- a/pkg/libcontainer/types_linux.go +++ b/pkg/libcontainer/types_linux.go @@ -6,11 +6,11 @@ import ( func init() { namespaceList = Namespaces{ - {Key: "NEWNS", Value: syscall.CLONE_NEWNS, File: "mnt", Enabled: true}, - {Key: "NEWUTS", Value: syscall.CLONE_NEWUTS, File: "uts", Enabled: true}, - {Key: "NEWIPC", Value: syscall.CLONE_NEWIPC, File: "ipc", Enabled: true}, - {Key: "NEWUSER", Value: syscall.CLONE_NEWUSER, File: "user", Enabled: true}, - {Key: "NEWPID", Value: syscall.CLONE_NEWPID, File: "pid", Enabled: true}, - {Key: "NEWNET", Value: syscall.CLONE_NEWNET, File: "net", Enabled: true}, + {Key: "NEWNS", Value: syscall.CLONE_NEWNS, File: "mnt"}, + {Key: "NEWUTS", Value: syscall.CLONE_NEWUTS, File: "uts"}, + {Key: "NEWIPC", Value: syscall.CLONE_NEWIPC, File: "ipc"}, + {Key: "NEWUSER", Value: syscall.CLONE_NEWUSER, File: "user"}, + {Key: "NEWPID", Value: syscall.CLONE_NEWPID, File: "pid"}, + {Key: "NEWNET", Value: syscall.CLONE_NEWNET, File: "net"}, } } From b25208ee3e4d652d8b1f86ffac343b718118b745 Mon Sep 17 00:00:00 2001 From: Kevin Menard Date: Mon, 5 May 2014 15:43:11 -0400 Subject: [PATCH 419/436] It's its. --- docs/sources/introduction/working-with-docker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/introduction/working-with-docker.md b/docs/sources/introduction/working-with-docker.md index d6bdb2260d..8d946e6846 100644 --- a/docs/sources/introduction/working-with-docker.md +++ b/docs/sources/introduction/working-with-docker.md @@ -293,7 +293,7 @@ A `#` sign is used to provide a comment: > **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 +> `Dockerfile` and its instructions see the [Dockerfile > Reference](http://docs.docker.io/reference/builder/). ### First steps with the Dockerfile From 01fec73ba4cff45ac08c0330ea0d67aff70ebf8e Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 13:54:37 -0700 Subject: [PATCH 420/436] Update after namespace refactor Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/execdriver/native/create.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/daemon/execdriver/native/create.go b/daemon/execdriver/native/create.go index 51cc2ddfd3..a7b3d9a107 100644 --- a/daemon/execdriver/native/create.go +++ b/daemon/execdriver/native/create.go @@ -54,7 +54,7 @@ func (d *driver) createContainer(c *execdriver.Command) (*libcontainer.Container func (d *driver) createNetwork(container *libcontainer.Container, c *execdriver.Command) error { if c.Network.HostNetworking { - container.Namespaces.Get("NEWNET").Enabled = false + container.Namespaces["NEWNET"] = false return nil } container.Networks = []*libcontainer.Network{ From 4994b0fe5459996691dde18155a7b712762e8e53 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 14:45:14 -0700 Subject: [PATCH 421/436] Move envconfig generation to lxc driver Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/container.go | 36 +-------------------------------- daemon/execdriver/lxc/driver.go | 15 ++++++++++++++ daemon/volumes.go | 13 ++++-------- 3 files changed, 20 insertions(+), 44 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 123eca0263..7313804326 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -168,19 +168,6 @@ func (container *Container) WriteHostConfig() (err error) { return ioutil.WriteFile(container.hostConfigPath(), data, 0666) } -func (container *Container) generateEnvConfig(env []string) error { - data, err := json.Marshal(env) - if err != nil { - return err - } - p, err := container.EnvConfigPath() - if err != nil { - return err - } - ioutil.WriteFile(p, data, 0600) - return nil -} - func (container *Container) Attach(stdin io.ReadCloser, stdinCloser io.Closer, stdout io.Writer, stderr io.Writer) chan error { var cStdout, cStderr io.ReadCloser @@ -422,15 +409,10 @@ func (container *Container) Start() (err error) { if err != nil { return err } - env := container.createDaemonEnvironment(linkedEnv) - // TODO: This is only needed for lxc so we should look for a way to - // remove this dep - if err := container.generateEnvConfig(env); err != nil { - return err - } if err := container.setupWorkingDirectory(); err != nil { return err } + env := container.createDaemonEnvironment(linkedEnv) if err := populateCommand(container, env); err != nil { return err } @@ -851,22 +833,6 @@ func (container *Container) jsonPath() string { return path.Join(container.root, "config.json") } -func (container *Container) EnvConfigPath() (string, error) { - p := path.Join(container.root, "config.env") - if _, err := os.Stat(p); err != nil { - if os.IsNotExist(err) { - f, err := os.Create(p) - if err != nil { - return "", err - } - f.Close() - } else { - return "", err - } - } - return p, nil -} - // This method must be exported to be used from the lxc template // This directory is only usable when the container is running func (container *Container) RootfsPath() string { diff --git a/daemon/execdriver/lxc/driver.go b/daemon/execdriver/lxc/driver.go index 2c06211c0d..d787d8d873 100644 --- a/daemon/execdriver/lxc/driver.go +++ b/daemon/execdriver/lxc/driver.go @@ -1,6 +1,7 @@ package lxc import ( + "encoding/json" "fmt" "io/ioutil" "log" @@ -85,6 +86,9 @@ func (d *driver) Run(c *execdriver.Command, pipes *execdriver.Pipes, startCallba if err := execdriver.SetTerminal(c, pipes); err != nil { return -1, err } + if err := d.generateEnvConfig(c); err != nil { + return -1, err + } configPath, err := d.generateLXCConfig(c) if err != nil { return -1, err @@ -416,3 +420,14 @@ func (d *driver) generateLXCConfig(c *execdriver.Command) (string, error) { } return root, nil } + +func (d *driver) generateEnvConfig(c *execdriver.Command) error { + data, err := json.Marshal(c.Env) + if err != nil { + return err + } + p := path.Join(d.root, "containers", c.ID, "config.env") + c.Mounts = append(c.Mounts, execdriver.Mount{p, "/.dockerenv", false, true}) + + return ioutil.WriteFile(p, data, 0600) +} diff --git a/daemon/volumes.go b/daemon/volumes.go index a6570845bf..a15e3084b2 100644 --- a/daemon/volumes.go +++ b/daemon/volumes.go @@ -2,14 +2,15 @@ package daemon import ( "fmt" - "github.com/dotcloud/docker/archive" - "github.com/dotcloud/docker/daemon/execdriver" - "github.com/dotcloud/docker/utils" "io/ioutil" "os" "path/filepath" "strings" "syscall" + + "github.com/dotcloud/docker/archive" + "github.com/dotcloud/docker/daemon/execdriver" + "github.com/dotcloud/docker/utils" ) type BindMap struct { @@ -34,14 +35,8 @@ func prepareVolumesForContainer(container *Container) error { } func setupMountsForContainer(container *Container) error { - envPath, err := container.EnvConfigPath() - if err != nil { - return err - } - mounts := []execdriver.Mount{ {container.daemon.sysInitPath, "/.dockerinit", false, true}, - {envPath, "/.dockerenv", false, true}, {container.ResolvConfPath, "/etc/resolv.conf", false, true}, } From a1a029f6d7f980960135c1346a1e9f7830692fac Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Mon, 5 May 2014 22:05:14 +0000 Subject: [PATCH 422/436] add etchosts Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- daemon/container.go | 24 ++------ pkg/networkfs/MAINTAINERS | 1 + pkg/networkfs/etchosts/etchosts.go | 34 ++++++++++++ pkg/networkfs/etchosts/etchosts_test.go | 74 +++++++++++++++++++++++++ 4 files changed, 114 insertions(+), 19 deletions(-) create mode 100644 pkg/networkfs/MAINTAINERS create mode 100644 pkg/networkfs/etchosts/etchosts.go create mode 100644 pkg/networkfs/etchosts/etchosts_test.go diff --git a/daemon/container.go b/daemon/container.go index 123eca0263..76bab3719b 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -22,6 +22,7 @@ import ( "github.com/dotcloud/docker/links" "github.com/dotcloud/docker/nat" "github.com/dotcloud/docker/pkg/label" + "github.com/dotcloud/docker/pkg/networkfs/etchosts" "github.com/dotcloud/docker/runconfig" "github.com/dotcloud/docker/utils" ) @@ -513,26 +514,11 @@ func (container *Container) buildHostname() { } } -func (container *Container) buildHostnameAndHostsFiles(IP string) { +func (container *Container) buildHostnameAndHostsFiles(IP string) error { container.buildHostname() - hostsContent := []byte(` -127.0.0.1 localhost -::1 localhost ip6-localhost ip6-loopback -fe00::0 ip6-localnet -ff00::0 ip6-mcastprefix -ff02::1 ip6-allnodes -ff02::2 ip6-allrouters -`) - container.HostsPath = path.Join(container.root, "hosts") - - if container.Config.Domainname != "" { - hostsContent = append([]byte(fmt.Sprintf("%s\t%s.%s %s\n", IP, container.Config.Hostname, container.Config.Domainname, container.Config.Hostname)), hostsContent...) - } else if !container.Config.NetworkDisabled { - hostsContent = append([]byte(fmt.Sprintf("%s\t%s\n", IP, container.Config.Hostname)), hostsContent...) - } - ioutil.WriteFile(container.HostsPath, hostsContent, 0644) + return etchosts.Build(container.HostsPath, IP, container.Config.Hostname, container.Config.Domainname) } func (container *Container) allocateNetwork() error { @@ -1072,12 +1058,12 @@ func (container *Container) initializeNetworking() error { container.Config.Domainname = nc.Config.Domainname } else if container.daemon.config.DisableNetwork { container.Config.NetworkDisabled = true - container.buildHostnameAndHostsFiles("127.0.1.1") + return container.buildHostnameAndHostsFiles("127.0.1.1") } else { if err := container.allocateNetwork(); err != nil { return err } - container.buildHostnameAndHostsFiles(container.NetworkSettings.IPAddress) + return container.buildHostnameAndHostsFiles(container.NetworkSettings.IPAddress) } return nil } diff --git a/pkg/networkfs/MAINTAINERS b/pkg/networkfs/MAINTAINERS new file mode 100644 index 0000000000..ceeb0cfd18 --- /dev/null +++ b/pkg/networkfs/MAINTAINERS @@ -0,0 +1 @@ +Victor Vieux (@vieux) diff --git a/pkg/networkfs/etchosts/etchosts.go b/pkg/networkfs/etchosts/etchosts.go new file mode 100644 index 0000000000..169797071a --- /dev/null +++ b/pkg/networkfs/etchosts/etchosts.go @@ -0,0 +1,34 @@ +package etchosts + +import ( + "bytes" + "fmt" + "io/ioutil" +) + +var defaultContent = map[string]string{ + "localhost": "127.0.0.1", + "localhost ip6-localhost ip6-loopback": "::1", + "ip6-localnet": "fe00::0", + "ip6-mcastprefix": "ff00::0", + "ip6-allnodes": "ff02::1", + "ip6-allrouters": "ff02::2", +} + +func Build(path, IP, hostname, domainname string) error { + content := bytes.NewBuffer(nil) + if IP != "" { + if domainname != "" { + content.WriteString(fmt.Sprintf("%s\t%s.%s %s\n", IP, hostname, domainname, hostname)) + } else { + content.WriteString(fmt.Sprintf("%s\t%s\n", IP, hostname)) + } + } + + for hosts, ip := range defaultContent { + if _, err := content.WriteString(fmt.Sprintf("%s\t%s\n", ip, hosts)); err != nil { + return err + } + } + return ioutil.WriteFile(path, content.Bytes(), 0644) +} diff --git a/pkg/networkfs/etchosts/etchosts_test.go b/pkg/networkfs/etchosts/etchosts_test.go new file mode 100644 index 0000000000..da5662d64f --- /dev/null +++ b/pkg/networkfs/etchosts/etchosts_test.go @@ -0,0 +1,74 @@ +package etchosts + +import ( + "bytes" + "io/ioutil" + "os" + "testing" +) + +func TestBuildHostnameDomainname(t *testing.T) { + file, err := ioutil.TempFile("", "") + if err != nil { + t.Fatal(err) + } + defer os.Remove(file.Name()) + + err = Build(file.Name(), "10.11.12.13", "testhostname", "testdomainname") + if err != nil { + t.Fatal(err) + } + + content, err := ioutil.ReadFile(file.Name()) + if err != nil { + t.Fatal(err) + } + + if expected := "10.11.12.13\ttesthostname.testdomainname testhostname\n"; !bytes.Contains(content, []byte(expected)) { + t.Fatalf("Expected to find '%s' got '%s'", expected, content) + } +} + +func TestBuildHostname(t *testing.T) { + file, err := ioutil.TempFile("", "") + if err != nil { + t.Fatal(err) + } + defer os.Remove(file.Name()) + + err = Build(file.Name(), "10.11.12.13", "testhostname", "") + if err != nil { + t.Fatal(err) + } + + content, err := ioutil.ReadFile(file.Name()) + if err != nil { + t.Fatal(err) + } + + if expected := "10.11.12.13\ttesthostname\n"; !bytes.Contains(content, []byte(expected)) { + t.Fatalf("Expected to find '%s' got '%s'", expected, content) + } +} + +func TestBuildNoIP(t *testing.T) { + file, err := ioutil.TempFile("", "") + if err != nil { + t.Fatal(err) + } + defer os.Remove(file.Name()) + + err = Build(file.Name(), "", "testhostname", "") + if err != nil { + t.Fatal(err) + } + + content, err := ioutil.ReadFile(file.Name()) + if err != nil { + t.Fatal(err) + } + + if expected := ""; !bytes.Contains(content, []byte(expected)) { + t.Fatalf("Expected to find '%s' got '%s'", expected, content) + } +} From 3744452ecf46351758478e99795e20b186a1bee4 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Mon, 5 May 2014 22:51:32 +0000 Subject: [PATCH 423/436] add resolvconf Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- daemon/container.go | 23 +--- daemon/daemon.go | 3 +- daemon/networkdriver/bridge/driver.go | 14 ++- pkg/networkfs/resolvconf/resolvconf.go | 87 +++++++++++++ pkg/networkfs/resolvconf/resolvconf_test.go | 133 ++++++++++++++++++++ utils/utils.go | 54 +------- utils/utils_test.go | 103 --------------- 7 files changed, 237 insertions(+), 180 deletions(-) create mode 100644 pkg/networkfs/resolvconf/resolvconf.go create mode 100644 pkg/networkfs/resolvconf/resolvconf_test.go diff --git a/daemon/container.go b/daemon/container.go index 76bab3719b..68d2d2a62a 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -23,6 +23,7 @@ import ( "github.com/dotcloud/docker/nat" "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/networkfs/etchosts" + "github.com/dotcloud/docker/pkg/networkfs/resolvconf" "github.com/dotcloud/docker/runconfig" "github.com/dotcloud/docker/utils" ) @@ -987,7 +988,7 @@ func (container *Container) setupContainerDns() error { return nil } - resolvConf, err := utils.GetResolvConf() + resolvConf, err := resolvconf.Get() if err != nil { return err } @@ -995,8 +996,8 @@ func (container *Container) setupContainerDns() error { // If custom dns exists, then create a resolv.conf for the container if len(config.Dns) > 0 || len(daemon.config.Dns) > 0 || len(config.DnsSearch) > 0 || len(daemon.config.DnsSearch) > 0 { var ( - dns = utils.GetNameservers(resolvConf) - dnsSearch = utils.GetSearchDomains(resolvConf) + dns = resolvconf.GetNameservers(resolvConf) + dnsSearch = resolvconf.GetSearchDomains(resolvConf) ) if len(config.Dns) > 0 { dns = config.Dns @@ -1009,21 +1010,7 @@ func (container *Container) setupContainerDns() error { dnsSearch = daemon.config.DnsSearch } container.ResolvConfPath = path.Join(container.root, "resolv.conf") - f, err := os.Create(container.ResolvConfPath) - if err != nil { - return err - } - defer f.Close() - for _, dns := range dns { - if _, err := f.Write([]byte("nameserver " + dns + "\n")); err != nil { - return err - } - } - if len(dnsSearch) > 0 { - if _, err := f.Write([]byte("search " + strings.Join(dnsSearch, " ") + "\n")); err != nil { - return err - } - } + return resolvconf.Build(container.ResolvConfPath, dns, dnsSearch) } else { container.ResolvConfPath = "/etc/resolv.conf" } diff --git a/daemon/daemon.go b/daemon/daemon.go index 22182f389f..00b6d9eee2 100644 --- a/daemon/daemon.go +++ b/daemon/daemon.go @@ -29,6 +29,7 @@ import ( "github.com/dotcloud/docker/pkg/graphdb" "github.com/dotcloud/docker/pkg/label" "github.com/dotcloud/docker/pkg/mount" + "github.com/dotcloud/docker/pkg/networkfs/resolvconf" "github.com/dotcloud/docker/pkg/selinux" "github.com/dotcloud/docker/pkg/sysinfo" "github.com/dotcloud/docker/runconfig" @@ -981,7 +982,7 @@ func (daemon *Daemon) SetServer(server Server) { } func (daemon *Daemon) checkLocaldns() error { - resolvConf, err := utils.GetResolvConf() + resolvConf, err := resolvconf.Get() if err != nil { return err } diff --git a/daemon/networkdriver/bridge/driver.go b/daemon/networkdriver/bridge/driver.go index 4828e3b9cf..c64aa423d1 100644 --- a/daemon/networkdriver/bridge/driver.go +++ b/daemon/networkdriver/bridge/driver.go @@ -2,6 +2,11 @@ package bridge import ( "fmt" + "io/ioutil" + "log" + "net" + "strings" + "github.com/dotcloud/docker/daemon/networkdriver" "github.com/dotcloud/docker/daemon/networkdriver/ipallocator" "github.com/dotcloud/docker/daemon/networkdriver/portallocator" @@ -9,11 +14,8 @@ import ( "github.com/dotcloud/docker/engine" "github.com/dotcloud/docker/pkg/iptables" "github.com/dotcloud/docker/pkg/netlink" + "github.com/dotcloud/docker/pkg/networkfs/resolvconf" "github.com/dotcloud/docker/utils" - "io/ioutil" - "log" - "net" - "strings" ) const ( @@ -222,13 +224,13 @@ func setupIPTables(addr net.Addr, icc bool) error { // If it can't find an address which doesn't conflict, it will return an error. func createBridge(bridgeIP string) error { nameservers := []string{} - resolvConf, _ := utils.GetResolvConf() + resolvConf, _ := resolvconf.Get() // we don't check for an error here, because we don't really care // if we can't read /etc/resolv.conf. So instead we skip the append // if resolvConf is nil. It either doesn't exist, or we can't read it // for some reason. if resolvConf != nil { - nameservers = append(nameservers, utils.GetNameserversAsCIDR(resolvConf)...) + nameservers = append(nameservers, resolvconf.GetNameserversAsCIDR(resolvConf)...) } var ifaceAddr string diff --git a/pkg/networkfs/resolvconf/resolvconf.go b/pkg/networkfs/resolvconf/resolvconf.go new file mode 100644 index 0000000000..d6854fb3b1 --- /dev/null +++ b/pkg/networkfs/resolvconf/resolvconf.go @@ -0,0 +1,87 @@ +package resolvconf + +import ( + "bytes" + "io/ioutil" + "regexp" + "strings" +) + +func Get() ([]byte, error) { + resolv, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + return nil, err + } + return resolv, nil +} + +// getLines parses input into lines and strips away comments. +func getLines(input []byte, commentMarker []byte) [][]byte { + lines := bytes.Split(input, []byte("\n")) + var output [][]byte + for _, currentLine := range lines { + var commentIndex = bytes.Index(currentLine, commentMarker) + if commentIndex == -1 { + output = append(output, currentLine) + } else { + output = append(output, currentLine[:commentIndex]) + } + } + return output +} + +// GetNameservers returns nameservers (if any) listed in /etc/resolv.conf +func GetNameservers(resolvConf []byte) []string { + nameservers := []string{} + re := regexp.MustCompile(`^\s*nameserver\s*(([0-9]+\.){3}([0-9]+))\s*$`) + for _, line := range getLines(resolvConf, []byte("#")) { + var ns = re.FindSubmatch(line) + if len(ns) > 0 { + nameservers = append(nameservers, string(ns[1])) + } + } + return nameservers +} + +// GetNameserversAsCIDR returns nameservers (if any) listed in +// /etc/resolv.conf as CIDR blocks (e.g., "1.2.3.4/32") +// This function's output is intended for net.ParseCIDR +func GetNameserversAsCIDR(resolvConf []byte) []string { + nameservers := []string{} + for _, nameserver := range GetNameservers(resolvConf) { + nameservers = append(nameservers, nameserver+"/32") + } + return nameservers +} + +// GetSearchDomains returns search domains (if any) listed in /etc/resolv.conf +// If more than one search line is encountered, only the contents of the last +// one is returned. +func GetSearchDomains(resolvConf []byte) []string { + re := regexp.MustCompile(`^\s*search\s*(([^\s]+\s*)*)$`) + domains := []string{} + for _, line := range getLines(resolvConf, []byte("#")) { + match := re.FindSubmatch(line) + if match == nil { + continue + } + domains = strings.Fields(string(match[1])) + } + return domains +} + +func Build(path string, dns, dnsSearch []string) error { + content := bytes.NewBuffer(nil) + for _, dns := range dns { + if _, err := content.WriteString("nameserver " + dns + "\n"); err != nil { + return err + } + } + if len(dnsSearch) > 0 { + if _, err := content.WriteString("search " + strings.Join(dnsSearch, " ") + "\n"); err != nil { + return err + } + } + + return ioutil.WriteFile(path, content.Bytes(), 0644) +} diff --git a/pkg/networkfs/resolvconf/resolvconf_test.go b/pkg/networkfs/resolvconf/resolvconf_test.go new file mode 100644 index 0000000000..fd20712376 --- /dev/null +++ b/pkg/networkfs/resolvconf/resolvconf_test.go @@ -0,0 +1,133 @@ +package resolvconf + +import ( + "bytes" + "io/ioutil" + "os" + "testing" +) + +func TestGet(t *testing.T) { + resolvConfUtils, err := Get() + if err != nil { + t.Fatal(err) + } + resolvConfSystem, err := ioutil.ReadFile("/etc/resolv.conf") + if err != nil { + t.Fatal(err) + } + if string(resolvConfUtils) != string(resolvConfSystem) { + t.Fatalf("/etc/resolv.conf and GetResolvConf have different content.") + } +} + +func TestGetNameservers(t *testing.T) { + for resolv, result := range map[string][]string{` +nameserver 1.2.3.4 +nameserver 40.3.200.10 +search example.com`: {"1.2.3.4", "40.3.200.10"}, + `search example.com`: {}, + `nameserver 1.2.3.4 +search example.com +nameserver 4.30.20.100`: {"1.2.3.4", "4.30.20.100"}, + ``: {}, + ` nameserver 1.2.3.4 `: {"1.2.3.4"}, + `search example.com +nameserver 1.2.3.4 +#nameserver 4.3.2.1`: {"1.2.3.4"}, + `search example.com +nameserver 1.2.3.4 # not 4.3.2.1`: {"1.2.3.4"}, + } { + test := GetNameservers([]byte(resolv)) + if !strSlicesEqual(test, result) { + t.Fatalf("Wrong nameserver string {%s} should be %v. Input: %s", test, result, resolv) + } + } +} + +func TestGetNameserversAsCIDR(t *testing.T) { + for resolv, result := range map[string][]string{` +nameserver 1.2.3.4 +nameserver 40.3.200.10 +search example.com`: {"1.2.3.4/32", "40.3.200.10/32"}, + `search example.com`: {}, + `nameserver 1.2.3.4 +search example.com +nameserver 4.30.20.100`: {"1.2.3.4/32", "4.30.20.100/32"}, + ``: {}, + ` nameserver 1.2.3.4 `: {"1.2.3.4/32"}, + `search example.com +nameserver 1.2.3.4 +#nameserver 4.3.2.1`: {"1.2.3.4/32"}, + `search example.com +nameserver 1.2.3.4 # not 4.3.2.1`: {"1.2.3.4/32"}, + } { + test := GetNameserversAsCIDR([]byte(resolv)) + if !strSlicesEqual(test, result) { + t.Fatalf("Wrong nameserver string {%s} should be %v. Input: %s", test, result, resolv) + } + } +} + +func TestGetSearchDomains(t *testing.T) { + for resolv, result := range map[string][]string{ + `search example.com`: {"example.com"}, + `search example.com # ignored`: {"example.com"}, + ` search example.com `: {"example.com"}, + ` search example.com # ignored`: {"example.com"}, + `search foo.example.com example.com`: {"foo.example.com", "example.com"}, + ` search foo.example.com example.com `: {"foo.example.com", "example.com"}, + ` search foo.example.com example.com # ignored`: {"foo.example.com", "example.com"}, + ``: {}, + `# ignored`: {}, + `nameserver 1.2.3.4 +search foo.example.com example.com`: {"foo.example.com", "example.com"}, + `nameserver 1.2.3.4 +search dup1.example.com dup2.example.com +search foo.example.com example.com`: {"foo.example.com", "example.com"}, + `nameserver 1.2.3.4 +search foo.example.com example.com +nameserver 4.30.20.100`: {"foo.example.com", "example.com"}, + } { + test := GetSearchDomains([]byte(resolv)) + if !strSlicesEqual(test, result) { + t.Fatalf("Wrong search domain string {%s} should be %v. Input: %s", test, result, resolv) + } + } +} + +func strSlicesEqual(a, b []string) bool { + if len(a) != len(b) { + return false + } + + for i, v := range a { + if v != b[i] { + return false + } + } + + return true +} + +func TestBuild(t *testing.T) { + file, err := ioutil.TempFile("", "") + if err != nil { + t.Fatal(err) + } + defer os.Remove(file.Name()) + + err = Build(file.Name(), []string{"ns1", "ns2", "ns3"}, []string{"search1"}) + if err != nil { + t.Fatal(err) + } + + content, err := ioutil.ReadFile(file.Name()) + if err != nil { + t.Fatal(err) + } + + if expected := "nameserver ns1\nnameserver ns2\nnameserver ns3\nsearch search1\n"; !bytes.Contains(content, []byte(expected)) { + t.Fatalf("Expected to find '%s' got '%s'", expected, content) + } +} diff --git a/utils/utils.go b/utils/utils.go index 066cfbac5a..4ef44b5617 100644 --- a/utils/utils.go +++ b/utils/utils.go @@ -9,7 +9,6 @@ import ( "encoding/json" "errors" "fmt" - "github.com/dotcloud/docker/dockerversion" "index/suffixarray" "io" "io/ioutil" @@ -23,6 +22,8 @@ import ( "strings" "sync" "time" + + "github.com/dotcloud/docker/dockerversion" ) type KeyValuePair struct { @@ -779,17 +780,6 @@ func IsGIT(str string) bool { return strings.HasPrefix(str, "git://") || strings.HasPrefix(str, "github.com/") || strings.HasPrefix(str, "git@github.com:") || (strings.HasSuffix(str, ".git") && IsURL(str)) } -// GetResolvConf opens and read the content of /etc/resolv.conf. -// It returns it as byte slice. -func GetResolvConf() ([]byte, error) { - resolv, err := ioutil.ReadFile("/etc/resolv.conf") - if err != nil { - Errorf("Error openning resolv.conf: %s", err) - return nil, err - } - return resolv, nil -} - // CheckLocalDns looks into the /etc/resolv.conf, // it returns true if there is a local nameserver or if there is no nameserver. func CheckLocalDns(resolvConf []byte) bool { @@ -825,46 +815,6 @@ func GetLines(input []byte, commentMarker []byte) [][]byte { return output } -// GetNameservers returns nameservers (if any) listed in /etc/resolv.conf -func GetNameservers(resolvConf []byte) []string { - nameservers := []string{} - re := regexp.MustCompile(`^\s*nameserver\s*(([0-9]+\.){3}([0-9]+))\s*$`) - for _, line := range GetLines(resolvConf, []byte("#")) { - var ns = re.FindSubmatch(line) - if len(ns) > 0 { - nameservers = append(nameservers, string(ns[1])) - } - } - return nameservers -} - -// GetNameserversAsCIDR returns nameservers (if any) listed in -// /etc/resolv.conf as CIDR blocks (e.g., "1.2.3.4/32") -// This function's output is intended for net.ParseCIDR -func GetNameserversAsCIDR(resolvConf []byte) []string { - nameservers := []string{} - for _, nameserver := range GetNameservers(resolvConf) { - nameservers = append(nameservers, nameserver+"/32") - } - return nameservers -} - -// GetSearchDomains returns search domains (if any) listed in /etc/resolv.conf -// If more than one search line is encountered, only the contents of the last -// one is returned. -func GetSearchDomains(resolvConf []byte) []string { - re := regexp.MustCompile(`^\s*search\s*(([^\s]+\s*)*)$`) - domains := []string{} - for _, line := range GetLines(resolvConf, []byte("#")) { - match := re.FindSubmatch(line) - if match == nil { - continue - } - domains = strings.Fields(string(match[1])) - } - return domains -} - // FIXME: Change this not to receive default value as parameter func ParseHost(defaultHost string, defaultUnix, addr string) (string, error) { var ( diff --git a/utils/utils_test.go b/utils/utils_test.go index 501ae67c2c..ccd212202c 100644 --- a/utils/utils_test.go +++ b/utils/utils_test.go @@ -377,20 +377,6 @@ func TestParseRepositoryTag(t *testing.T) { } } -func TestGetResolvConf(t *testing.T) { - resolvConfUtils, err := GetResolvConf() - if err != nil { - t.Fatal(err) - } - resolvConfSystem, err := ioutil.ReadFile("/etc/resolv.conf") - if err != nil { - t.Fatal(err) - } - if string(resolvConfUtils) != string(resolvConfSystem) { - t.Fatalf("/etc/resolv.conf and GetResolvConf have different content.") - } -} - func TestCheckLocalDns(t *testing.T) { for resolv, result := range map[string]bool{`# Dynamic nameserver 10.0.2.3 @@ -464,95 +450,6 @@ func TestParsePortMapping(t *testing.T) { } } -func TestGetNameservers(t *testing.T) { - for resolv, result := range map[string][]string{` -nameserver 1.2.3.4 -nameserver 40.3.200.10 -search example.com`: {"1.2.3.4", "40.3.200.10"}, - `search example.com`: {}, - `nameserver 1.2.3.4 -search example.com -nameserver 4.30.20.100`: {"1.2.3.4", "4.30.20.100"}, - ``: {}, - ` nameserver 1.2.3.4 `: {"1.2.3.4"}, - `search example.com -nameserver 1.2.3.4 -#nameserver 4.3.2.1`: {"1.2.3.4"}, - `search example.com -nameserver 1.2.3.4 # not 4.3.2.1`: {"1.2.3.4"}, - } { - test := GetNameservers([]byte(resolv)) - if !StrSlicesEqual(test, result) { - t.Fatalf("Wrong nameserver string {%s} should be %v. Input: %s", test, result, resolv) - } - } -} - -func TestGetNameserversAsCIDR(t *testing.T) { - for resolv, result := range map[string][]string{` -nameserver 1.2.3.4 -nameserver 40.3.200.10 -search example.com`: {"1.2.3.4/32", "40.3.200.10/32"}, - `search example.com`: {}, - `nameserver 1.2.3.4 -search example.com -nameserver 4.30.20.100`: {"1.2.3.4/32", "4.30.20.100/32"}, - ``: {}, - ` nameserver 1.2.3.4 `: {"1.2.3.4/32"}, - `search example.com -nameserver 1.2.3.4 -#nameserver 4.3.2.1`: {"1.2.3.4/32"}, - `search example.com -nameserver 1.2.3.4 # not 4.3.2.1`: {"1.2.3.4/32"}, - } { - test := GetNameserversAsCIDR([]byte(resolv)) - if !StrSlicesEqual(test, result) { - t.Fatalf("Wrong nameserver string {%s} should be %v. Input: %s", test, result, resolv) - } - } -} - -func TestGetSearchDomains(t *testing.T) { - for resolv, result := range map[string][]string{ - `search example.com`: {"example.com"}, - `search example.com # ignored`: {"example.com"}, - ` search example.com `: {"example.com"}, - ` search example.com # ignored`: {"example.com"}, - `search foo.example.com example.com`: {"foo.example.com", "example.com"}, - ` search foo.example.com example.com `: {"foo.example.com", "example.com"}, - ` search foo.example.com example.com # ignored`: {"foo.example.com", "example.com"}, - ``: {}, - `# ignored`: {}, - `nameserver 1.2.3.4 -search foo.example.com example.com`: {"foo.example.com", "example.com"}, - `nameserver 1.2.3.4 -search dup1.example.com dup2.example.com -search foo.example.com example.com`: {"foo.example.com", "example.com"}, - `nameserver 1.2.3.4 -search foo.example.com example.com -nameserver 4.30.20.100`: {"foo.example.com", "example.com"}, - } { - test := GetSearchDomains([]byte(resolv)) - if !StrSlicesEqual(test, result) { - t.Fatalf("Wrong search domain string {%s} should be %v. Input: %s", test, result, resolv) - } - } -} - -func StrSlicesEqual(a, b []string) bool { - if len(a) != len(b) { - return false - } - - for i, v := range a { - if v != b[i] { - return false - } - } - - return true -} - func TestReplaceAndAppendEnvVars(t *testing.T) { var ( d = []string{"HOME=/"} From 55f3e72d7f6b996c0874d402c95f4b8c9a7d80d9 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Mon, 5 May 2014 23:23:14 +0000 Subject: [PATCH 424/436] propagate errors write Docker-DCO-1.1-Signed-off-by: Victor Vieux (github: vieux) --- daemon/container.go | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/daemon/container.go b/daemon/container.go index 2a17ff1ece..20a320307b 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -487,18 +487,18 @@ func (container *Container) StderrLogPipe() io.ReadCloser { return utils.NewBufReader(reader) } -func (container *Container) buildHostname() { +func (container *Container) buildHostnameFile() error { container.HostnamePath = path.Join(container.root, "hostname") - if container.Config.Domainname != "" { - ioutil.WriteFile(container.HostnamePath, []byte(fmt.Sprintf("%s.%s\n", container.Config.Hostname, container.Config.Domainname)), 0644) - } else { - ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) + return ioutil.WriteFile(container.HostnamePath, []byte(fmt.Sprintf("%s.%s\n", container.Config.Hostname, container.Config.Domainname)), 0644) } + return ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644) } func (container *Container) buildHostnameAndHostsFiles(IP string) error { - container.buildHostname() + if err := container.buildHostnameFile(); err != nil { + return err + } container.HostsPath = path.Join(container.root, "hosts") return etchosts.Build(container.HostsPath, IP, container.Config.Hostname, container.Config.Domainname) @@ -998,7 +998,7 @@ func (container *Container) initializeNetworking() error { } container.HostsPath = "/etc/hosts" - container.buildHostname() + return container.buildHostnameFile() } else if container.hostConfig.NetworkMode.IsContainer() { // we need to get the hosts files from the container to join nc, err := container.getNetworkedContainer() From 41cfaa738c2d8583ecca50948c9df5eda3dfd7f1 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 16:48:56 -0700 Subject: [PATCH 425/436] Move Attach from container to daemon This moves the Attach method from the container to the daemon. This method mostly supports the http attach logic and does not have anything to do with the running of a container. Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/attach.go | 153 ++++++++++++++++++++++++++++++++++++++++++++ daemon/container.go | 144 ----------------------------------------- server/buildfile.go | 16 ++--- server/server.go | 2 +- 4 files changed, 162 insertions(+), 153 deletions(-) create mode 100644 daemon/attach.go diff --git a/daemon/attach.go b/daemon/attach.go new file mode 100644 index 0000000000..0e3b8b8a9d --- /dev/null +++ b/daemon/attach.go @@ -0,0 +1,153 @@ +package daemon + +import ( + "io" + + "github.com/dotcloud/docker/utils" +) + +func (daemon *Daemon) Attach(container *Container, stdin io.ReadCloser, stdinCloser io.Closer, stdout io.Writer, stderr io.Writer) chan error { + var ( + cStdout, cStderr io.ReadCloser + nJobs int + errors = make(chan error, 3) + ) + + if stdin != nil && container.Config.OpenStdin { + nJobs += 1 + if cStdin, err := container.StdinPipe(); err != nil { + errors <- err + } else { + go func() { + utils.Debugf("attach: stdin: begin") + defer utils.Debugf("attach: stdin: end") + // No matter what, when stdin is closed (io.Copy unblock), close stdout and stderr + if container.Config.StdinOnce && !container.Config.Tty { + defer cStdin.Close() + } else { + defer func() { + if cStdout != nil { + cStdout.Close() + } + if cStderr != nil { + cStderr.Close() + } + }() + } + if container.Config.Tty { + _, err = utils.CopyEscapable(cStdin, stdin) + } else { + _, err = io.Copy(cStdin, stdin) + } + if err == io.ErrClosedPipe { + err = nil + } + if err != nil { + utils.Errorf("attach: stdin: %s", err) + } + errors <- err + }() + } + } + if stdout != nil { + nJobs += 1 + if p, err := container.StdoutPipe(); err != nil { + errors <- err + } else { + cStdout = p + go func() { + utils.Debugf("attach: stdout: begin") + defer utils.Debugf("attach: stdout: end") + // If we are in StdinOnce mode, then close stdin + if container.Config.StdinOnce && stdin != nil { + defer stdin.Close() + } + if stdinCloser != nil { + defer stdinCloser.Close() + } + _, err := io.Copy(stdout, cStdout) + if err == io.ErrClosedPipe { + err = nil + } + if err != nil { + utils.Errorf("attach: stdout: %s", err) + } + errors <- err + }() + } + } else { + go func() { + if stdinCloser != nil { + defer stdinCloser.Close() + } + if cStdout, err := container.StdoutPipe(); err != nil { + utils.Errorf("attach: stdout pipe: %s", err) + } else { + io.Copy(&utils.NopWriter{}, cStdout) + } + }() + } + if stderr != nil { + nJobs += 1 + if p, err := container.StderrPipe(); err != nil { + errors <- err + } else { + cStderr = p + go func() { + utils.Debugf("attach: stderr: begin") + defer utils.Debugf("attach: stderr: end") + // If we are in StdinOnce mode, then close stdin + if container.Config.StdinOnce && stdin != nil { + defer stdin.Close() + } + if stdinCloser != nil { + defer stdinCloser.Close() + } + _, err := io.Copy(stderr, cStderr) + if err == io.ErrClosedPipe { + err = nil + } + if err != nil { + utils.Errorf("attach: stderr: %s", err) + } + errors <- err + }() + } + } else { + go func() { + if stdinCloser != nil { + defer stdinCloser.Close() + } + + if cStderr, err := container.StderrPipe(); err != nil { + utils.Errorf("attach: stdout pipe: %s", err) + } else { + io.Copy(&utils.NopWriter{}, cStderr) + } + }() + } + + return utils.Go(func() error { + defer func() { + if cStdout != nil { + cStdout.Close() + } + if cStderr != nil { + cStderr.Close() + } + }() + + // FIXME: how to clean up the stdin goroutine without the unwanted side effect + // of closing the passed stdin? Add an intermediary io.Pipe? + for i := 0; i < nJobs; i += 1 { + utils.Debugf("attach: waiting for job %d/%d", i+1, nJobs) + if err := <-errors; err != nil { + utils.Errorf("attach: job %d returned error %s, aborting all jobs", i+1, err) + return err + } + utils.Debugf("attach: job %d completed successfully", i+1) + } + utils.Debugf("attach: all jobs completed successfully") + return nil + }) +} diff --git a/daemon/container.go b/daemon/container.go index 20a320307b..f4cc125ca4 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -170,150 +170,6 @@ func (container *Container) WriteHostConfig() (err error) { return ioutil.WriteFile(container.hostConfigPath(), data, 0666) } -func (container *Container) Attach(stdin io.ReadCloser, stdinCloser io.Closer, stdout io.Writer, stderr io.Writer) chan error { - var cStdout, cStderr io.ReadCloser - - var nJobs int - errors := make(chan error, 3) - if stdin != nil && container.Config.OpenStdin { - nJobs += 1 - if cStdin, err := container.StdinPipe(); err != nil { - errors <- err - } else { - go func() { - utils.Debugf("attach: stdin: begin") - defer utils.Debugf("attach: stdin: end") - // No matter what, when stdin is closed (io.Copy unblock), close stdout and stderr - if container.Config.StdinOnce && !container.Config.Tty { - defer cStdin.Close() - } else { - defer func() { - if cStdout != nil { - cStdout.Close() - } - if cStderr != nil { - cStderr.Close() - } - }() - } - if container.Config.Tty { - _, err = utils.CopyEscapable(cStdin, stdin) - } else { - _, err = io.Copy(cStdin, stdin) - } - if err == io.ErrClosedPipe { - err = nil - } - if err != nil { - utils.Errorf("attach: stdin: %s", err) - } - errors <- err - }() - } - } - if stdout != nil { - nJobs += 1 - if p, err := container.StdoutPipe(); err != nil { - errors <- err - } else { - cStdout = p - go func() { - utils.Debugf("attach: stdout: begin") - defer utils.Debugf("attach: stdout: end") - // If we are in StdinOnce mode, then close stdin - if container.Config.StdinOnce && stdin != nil { - defer stdin.Close() - } - if stdinCloser != nil { - defer stdinCloser.Close() - } - _, err := io.Copy(stdout, cStdout) - if err == io.ErrClosedPipe { - err = nil - } - if err != nil { - utils.Errorf("attach: stdout: %s", err) - } - errors <- err - }() - } - } else { - go func() { - if stdinCloser != nil { - defer stdinCloser.Close() - } - if cStdout, err := container.StdoutPipe(); err != nil { - utils.Errorf("attach: stdout pipe: %s", err) - } else { - io.Copy(&utils.NopWriter{}, cStdout) - } - }() - } - if stderr != nil { - nJobs += 1 - if p, err := container.StderrPipe(); err != nil { - errors <- err - } else { - cStderr = p - go func() { - utils.Debugf("attach: stderr: begin") - defer utils.Debugf("attach: stderr: end") - // If we are in StdinOnce mode, then close stdin - if container.Config.StdinOnce && stdin != nil { - defer stdin.Close() - } - if stdinCloser != nil { - defer stdinCloser.Close() - } - _, err := io.Copy(stderr, cStderr) - if err == io.ErrClosedPipe { - err = nil - } - if err != nil { - utils.Errorf("attach: stderr: %s", err) - } - errors <- err - }() - } - } else { - go func() { - if stdinCloser != nil { - defer stdinCloser.Close() - } - - if cStderr, err := container.StderrPipe(); err != nil { - utils.Errorf("attach: stdout pipe: %s", err) - } else { - io.Copy(&utils.NopWriter{}, cStderr) - } - }() - } - - return utils.Go(func() error { - defer func() { - if cStdout != nil { - cStdout.Close() - } - if cStderr != nil { - cStderr.Close() - } - }() - - // FIXME: how to clean up the stdin goroutine without the unwanted side effect - // of closing the passed stdin? Add an intermediary io.Pipe? - for i := 0; i < nJobs; i += 1 { - utils.Debugf("attach: waiting for job %d/%d", i+1, nJobs) - if err := <-errors; err != nil { - utils.Errorf("attach: job %d returned error %s, aborting all jobs", i+1, err) - return err - } - utils.Debugf("attach: job %d completed successfully", i+1) - } - utils.Debugf("attach: all jobs completed successfully") - return nil - }) -} - func populateCommand(c *Container, env []string) error { var ( en *execdriver.Network diff --git a/server/buildfile.go b/server/buildfile.go index 8466f4290e..24b0b58f25 100644 --- a/server/buildfile.go +++ b/server/buildfile.go @@ -6,12 +6,6 @@ import ( "encoding/json" "errors" "fmt" - "github.com/dotcloud/docker/archive" - "github.com/dotcloud/docker/daemon" - "github.com/dotcloud/docker/nat" - "github.com/dotcloud/docker/registry" - "github.com/dotcloud/docker/runconfig" - "github.com/dotcloud/docker/utils" "io" "io/ioutil" "net/url" @@ -22,6 +16,13 @@ import ( "regexp" "sort" "strings" + + "github.com/dotcloud/docker/archive" + "github.com/dotcloud/docker/daemon" + "github.com/dotcloud/docker/nat" + "github.com/dotcloud/docker/registry" + "github.com/dotcloud/docker/runconfig" + "github.com/dotcloud/docker/utils" ) var ( @@ -644,10 +645,9 @@ func (b *buildFile) create() (*daemon.Container, error) { func (b *buildFile) run(c *daemon.Container) error { var errCh chan error - if b.verbose { errCh = utils.Go(func() error { - return <-c.Attach(nil, nil, b.outStream, b.errStream) + return <-b.daemon.Attach(c, nil, nil, b.outStream, b.errStream) }) } diff --git a/server/server.go b/server/server.go index 04cc17a35a..47565f0022 100644 --- a/server/server.go +++ b/server/server.go @@ -2369,7 +2369,7 @@ func (srv *Server) ContainerAttach(job *engine.Job) engine.Status { cStderr = job.Stderr } - <-container.Attach(cStdin, cStdinCloser, cStdout, cStderr) + <-srv.daemon.Attach(container, cStdin, cStdinCloser, cStdout, cStderr) // If we are in stdinonce mode, wait for the process to end // otherwise, simply return From 2b0f88383afba28fe7b0bba989d115c2f5e2cc87 Mon Sep 17 00:00:00 2001 From: Kevin Menard Date: Mon, 5 May 2014 20:08:35 -0400 Subject: [PATCH 426/436] Use the correct "it's." --- docs/sources/use/working_with_volumes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/use/working_with_volumes.md b/docs/sources/use/working_with_volumes.md index c403532bcc..7d6136b85a 100644 --- a/docs/sources/use/working_with_volumes.md +++ b/docs/sources/use/working_with_volumes.md @@ -59,7 +59,7 @@ more new volumes to any container created from that image: ### Creating and mounting a Data Volume Container If you have some persistent data that you want to share between -containers, or want to use from non-persistent containers, its best to +containers, or want to use from non-persistent containers, it's best to create a named Data Volume Container, and then to mount the data from it. From cd818950919f0da868b36e32033607d5e6c98466 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Mon, 5 May 2014 10:47:55 -0700 Subject: [PATCH 427/436] Add alex as devmapper and btrfs maintainer Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/graphdriver/btrfs/MAINTAINERS | 1 + daemon/graphdriver/devmapper/MAINTAINERS | 1 + 2 files changed, 2 insertions(+) create mode 100644 daemon/graphdriver/btrfs/MAINTAINERS create mode 100644 daemon/graphdriver/devmapper/MAINTAINERS diff --git a/daemon/graphdriver/btrfs/MAINTAINERS b/daemon/graphdriver/btrfs/MAINTAINERS new file mode 100644 index 0000000000..9e629d5fcc --- /dev/null +++ b/daemon/graphdriver/btrfs/MAINTAINERS @@ -0,0 +1 @@ +Alexander Larsson (@alexlarsson) diff --git a/daemon/graphdriver/devmapper/MAINTAINERS b/daemon/graphdriver/devmapper/MAINTAINERS new file mode 100644 index 0000000000..9e629d5fcc --- /dev/null +++ b/daemon/graphdriver/devmapper/MAINTAINERS @@ -0,0 +1 @@ +Alexander Larsson (@alexlarsson) From 53f38a14cd6b61a6b5df68cc3694dcba2b0c1eb7 Mon Sep 17 00:00:00 2001 From: Bryan Murphy Date: Mon, 7 Apr 2014 18:34:07 +0000 Subject: [PATCH 428/436] add linked containers to hosts file Docker-DCO-1.1-Signed-off-by: Bryan Murphy (github: bmurphy1976) Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) Tested-by: Solomon Hykes (github: shykes) --- daemon/container.go | 15 ++++++- docs/sources/reference/run.md | 9 +++- docs/sources/use/working_with_links_names.md | 29 +++++++++++++ integration-cli/docker_cli_links_test.go | 45 ++++++++++++++++++++ pkg/networkfs/etchosts/etchosts.go | 11 ++++- 5 files changed, 106 insertions(+), 3 deletions(-) create mode 100644 integration-cli/docker_cli_links_test.go diff --git a/daemon/container.go b/daemon/container.go index f4cc125ca4..7b6b65494e 100644 --- a/daemon/container.go +++ b/daemon/container.go @@ -357,7 +357,20 @@ func (container *Container) buildHostnameAndHostsFiles(IP string) error { } container.HostsPath = path.Join(container.root, "hosts") - return etchosts.Build(container.HostsPath, IP, container.Config.Hostname, container.Config.Domainname) + + extraContent := make(map[string]string) + + children, err := container.daemon.Children(container.Name) + if err != nil { + return err + } + + for linkAlias, child := range children { + _, alias := path.Split(linkAlias) + extraContent[alias] = child.NetworkSettings.IPAddress + } + + return etchosts.Build(container.HostsPath, IP, container.Config.Hostname, container.Config.Domainname, &extraContent) } func (container *Container) allocateNetwork() error { diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index 521e8010e2..b6cb0a08fe 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -1,4 +1,4 @@ -page_title: Docker Run Reference +page_title: Docker Run Reference page_description: Configure containers at runtime page_keywords: docker, run, configure, runtime @@ -407,6 +407,13 @@ 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' 172.17.0.32:6379> +Docker will also map the private IP address to the alias of a linked +container by inserting an entry into `/etc/hosts`. You can use this +mechanism to communicate with a linked container by its alias: + + $ docker run -d --name servicename busybox sleep 30 + $ docker run -i -t --link servicename:servicealias busybox ping -c 1 servicealias + ## VOLUME (Shared Filesystems) -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. diff --git a/docs/sources/use/working_with_links_names.md b/docs/sources/use/working_with_links_names.md index dab66cef06..6951e3c26f 100644 --- a/docs/sources/use/working_with_links_names.md +++ b/docs/sources/use/working_with_links_names.md @@ -109,3 +109,32 @@ the Redis container. CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds webapp d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db + +## Resolving Links by Name + +New in version v0.11. + +Linked containers can be accessed by hostname. Hostnames are mapped by +appending entries to '/etc/hosts' using the linked container's alias. + +For example, linking a container using '--link redis:db' will generate the +following '/etc/hosts' file: + + root@6541a75d44a0:/# cat /etc/hosts + 172.17.0.3 6541a75d44a0 + 172.17.0.2 db + + 127.0.0.1 localhost + ::1 localhost ip6-localhost ip6-loopback + fe00::0 ip6-localnet + ff00::0 ip6-mcastprefix + ff02::1 ip6-allnodes + ff02::2 ip6-allrouters + root@6541a75d44a0:/# + +Using this mechanism, you can communicate with the linked container by +name: + + root@6541a75d44a0:/# echo PING | redis-cli -h db + PONG + root@6541a75d44a0:/# diff --git a/integration-cli/docker_cli_links_test.go b/integration-cli/docker_cli_links_test.go new file mode 100644 index 0000000000..5b43b3f8a9 --- /dev/null +++ b/integration-cli/docker_cli_links_test.go @@ -0,0 +1,45 @@ +package main + +import ( + "fmt" + "os/exec" + "testing" +) + +func TestPingUnlinkedContainers(t *testing.T) { + runCmd := exec.Command(dockerBinary, "run", "--rm", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + exitCode, err := runCommand(runCmd) + + if exitCode == 0 { + t.Fatal("run ping did not fail") + } else if exitCode != 1 { + errorOut(err, t, fmt.Sprintf("run ping failed with errors: %v", err)) + } +} + +func TestPingLinkedContainers(t *testing.T) { + cmd := exec.Command(dockerBinary, "run", "-d", "--name", "container1", "busybox", "sleep", "10") + out, _, err := runCommandWithOutput(cmd) + errorOut(err, t, fmt.Sprintf("run container1 failed with errors: %v", err)) + idA := stripTrailingCharacters(out) + + cmd = exec.Command(dockerBinary, "run", "-d", "--name", "container2", "busybox", "sleep", "10") + out, _, err = runCommandWithOutput(cmd) + errorOut(err, t, fmt.Sprintf("run container2 failed with errors: %v", err)) + idB := stripTrailingCharacters(out) + + cmd = exec.Command(dockerBinary, "run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + out, _, err = runCommandWithOutput(cmd) + fmt.Printf("OUT: %s", out) + errorOut(err, t, fmt.Sprintf("run ping failed with errors: %v", err)) + + cmd = exec.Command(dockerBinary, "kill", idA) + _, err = runCommand(cmd) + errorOut(err, t, fmt.Sprintf("failed to kill container1: %v", err)) + + cmd = exec.Command(dockerBinary, "kill", idB) + _, err = runCommand(cmd) + errorOut(err, t, fmt.Sprintf("failed to kill container2: %v", err)) + + deleteAllContainers() +} diff --git a/pkg/networkfs/etchosts/etchosts.go b/pkg/networkfs/etchosts/etchosts.go index 169797071a..144a039bff 100644 --- a/pkg/networkfs/etchosts/etchosts.go +++ b/pkg/networkfs/etchosts/etchosts.go @@ -15,7 +15,7 @@ var defaultContent = map[string]string{ "ip6-allrouters": "ff02::2", } -func Build(path, IP, hostname, domainname string) error { +func Build(path, IP, hostname, domainname string, extraContent *map[string]string) error { content := bytes.NewBuffer(nil) if IP != "" { if domainname != "" { @@ -30,5 +30,14 @@ func Build(path, IP, hostname, domainname string) error { return err } } + + if extraContent != nil { + for hosts, ip := range *extraContent { + if _, err := content.WriteString(fmt.Sprintf("%s\t%s\n", ip, hosts)); err != nil { + return err + } + } + } + return ioutil.WriteFile(path, content.Bytes(), 0644) } From dc605c8be76760951d0d12e67409602c7b4b7973 Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Mon, 5 May 2014 19:51:03 -0700 Subject: [PATCH 429/436] Simplify integration test for link + hostname. Docker-DCO-1.1-Signed-off-by: Solomon Hykes (github: shykes) --- integration-cli/docker_cli_links_test.go | 27 ++++++------------------ 1 file changed, 6 insertions(+), 21 deletions(-) diff --git a/integration-cli/docker_cli_links_test.go b/integration-cli/docker_cli_links_test.go index 5b43b3f8a9..a159d1c799 100644 --- a/integration-cli/docker_cli_links_test.go +++ b/integration-cli/docker_cli_links_test.go @@ -18,28 +18,13 @@ func TestPingUnlinkedContainers(t *testing.T) { } func TestPingLinkedContainers(t *testing.T) { - cmd := exec.Command(dockerBinary, "run", "-d", "--name", "container1", "busybox", "sleep", "10") - out, _, err := runCommandWithOutput(cmd) - errorOut(err, t, fmt.Sprintf("run container1 failed with errors: %v", err)) + var out string + out, _, _ = cmd(t, "run", "-d", "--name", "container1", "busybox", "sleep", "10") idA := stripTrailingCharacters(out) - - cmd = exec.Command(dockerBinary, "run", "-d", "--name", "container2", "busybox", "sleep", "10") - out, _, err = runCommandWithOutput(cmd) - errorOut(err, t, fmt.Sprintf("run container2 failed with errors: %v", err)) + out, _, _ = cmd("run", "-d", "--name", "container2", "busybox", "sleep", "10") idB := stripTrailingCharacters(out) - - cmd = exec.Command(dockerBinary, "run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") - out, _, err = runCommandWithOutput(cmd) - fmt.Printf("OUT: %s", out) - errorOut(err, t, fmt.Sprintf("run ping failed with errors: %v", err)) - - cmd = exec.Command(dockerBinary, "kill", idA) - _, err = runCommand(cmd) - errorOut(err, t, fmt.Sprintf("failed to kill container1: %v", err)) - - cmd = exec.Command(dockerBinary, "kill", idB) - _, err = runCommand(cmd) - errorOut(err, t, fmt.Sprintf("failed to kill container2: %v", err)) - + cmd("run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + cmd("kill", idA) + cmd("kill", idB) deleteAllContainers() } From 9eeff6d099a951c3a3e45d63ce2f8cb158aaeb6c Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Tue, 6 May 2014 20:26:44 +1000 Subject: [PATCH 430/436] Update the run --net cli help to include the 'host' option and then add that to the run and cli docs Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/reference/commandline/cli.md | 32 +++++++++++------------ docs/sources/reference/run.md | 6 ++--- runconfig/parse.go | 2 +- 3 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md index 1bbc3585fd..8936bbe332 100644 --- a/docs/sources/reference/commandline/cli.md +++ b/docs/sources/reference/commandline/cli.md @@ -809,33 +809,33 @@ Run a command in a new container Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...] - -a, --attach=map[]: Attach to stdin, stdout or stderr + -a, --attach=[]: Attach to stdin, stdout or stderr. -c, --cpu-shares=0: CPU shares (relative weight) --cidfile="": Write the container ID to the file -d, --detach=false: Detached mode: Run container in the background, print new container id + --dns=[]: Set custom dns servers + --dns-search=[]: Set custom dns search domains -e, --env=[]: Set environment variables - --env-file="": Read in a line delimited file of ENV variables + --entrypoint="": Overwrite the default entrypoint of the image + --env-file=[]: Read in a line delimited file of ENV variables + --expose=[]: Expose a port from the container without publishing it to your host -h, --hostname="": Container host name -i, --interactive=false: Keep stdin open even if not attached - --privileged=false: Give extended privileges to this container + --link=[]: Add link to another container (name:alias) + --lxc-conf=[]: (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" -m, --memory="": Memory limit (format: , where unit = b, k, m or g) - -n, --networking=true: Enable networking for this container - -p, --publish=[]: Map a network port to the container + --name="": Assign a name to the container + --net="bridge": Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:': reuses another container network stack), 'host': use the host network stack inside the container + -P, --publish-all=false: Publish all exposed ports to the host interfaces + -p, --publish=[]: Publish a container's port to the host (format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort) (use 'docker port' to see the actual mapping) + --privileged=false: Give extended privileges to this container --rm=false: Automatically remove the container when it exits (incompatible with -d) + --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) -t, --tty=false: Allocate a pseudo-tty -u, --user="": Username or UID - --dns=[]: Set custom dns servers for the container - --dns-search=[]: Set custom DNS search domains for the container - -v, --volume=[]: 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. - --volumes-from="": Mount all volumes from the given container(s) - --entrypoint="": Overwrite the default entrypoint set by the image + -v, --volume=[]: Bind mount a volume (e.g. from the host: -v /host:/container, from docker: -v /container) + --volumes-from=[]: Mount volumes from the specified container(s) -w, --workdir="": Working directory inside the container - --lxc-conf=[]: (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" - --sig-proxy=true: Proxify all received signal to the process (even in non-tty mode) - --expose=[]: Expose a port from the container without publishing it to your host - --link="": Add link to another container (name:alias) - --name="": Assign the specified name to the container. If no name is specific docker will generate a random name - -P, --publish-all=false: Publish all exposed ports to the host interfaces The `docker run` command first `creates` a writeable container layer over the specified image, and then `starts` it using the specified command. That is, diff --git a/docs/sources/reference/run.md b/docs/sources/reference/run.md index b6cb0a08fe..b3415330fe 100644 --- a/docs/sources/reference/run.md +++ b/docs/sources/reference/run.md @@ -136,12 +136,12 @@ PID files): ## Network Settings - --dns=[] : Set custom dns servers for the container - --net=bridge : Set the network mode + --dns=[] : Set custom dns servers for the container + --net="bridge": Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:': reuses another container network stack), 'host': use the host network stack inside the container By default, all containers have networking enabled and they can make any outgoing connections. The operator can completely disable networking -with `docker run -n` which disables all incoming and +with `docker run --net none` which disables all incoming and outgoing networking. In cases like this, you would perform I/O through files or STDIN/STDOUT only. diff --git a/runconfig/parse.go b/runconfig/parse.go index 0d511ef2ec..74b7801532 100644 --- a/runconfig/parse.go +++ b/runconfig/parse.go @@ -62,7 +62,7 @@ func parseRun(cmd *flag.FlagSet, args []string, sysInfo *sysinfo.SysInfo) (*Conf flUser = cmd.String([]string{"u", "-user"}, "", "Username or UID") flWorkingDir = cmd.String([]string{"w", "-workdir"}, "", "Working directory inside the container") flCpuShares = cmd.Int64([]string{"c", "-cpu-shares"}, 0, "CPU shares (relative weight)") - flNetMode = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:': reuses another container network stack)") + flNetMode = cmd.String([]string{"-net"}, "bridge", "Set the Network mode for the container ('bridge': creates a new network stack for the container on the docker bridge, 'none': no networking for this container, 'container:': reuses another container network stack), 'host': use the host network stack inside the container") // For documentation purpose _ = cmd.Bool([]string{"#sig-proxy", "-sig-proxy"}, true, "Proxify all received signal to the process (even in non-tty mode)") _ = cmd.String([]string{"#name", "-name"}, "", "Assign a name to the container") From 14f65ab83b4f72ea56b3e98023e941474d4e9dd8 Mon Sep 17 00:00:00 2001 From: cyphar Date: Wed, 7 May 2014 00:42:22 +1000 Subject: [PATCH 431/436] pkg: networkfs: etchosts: fixed tests This patch fixes the fact that the tests for pkg/networkfs/etchosts couldn't build due to syntax errors. Docker-DCO-1.1-Signed-off-by: Aleksa Sarai (github: cyphar) --- pkg/networkfs/etchosts/etchosts_test.go | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pkg/networkfs/etchosts/etchosts_test.go b/pkg/networkfs/etchosts/etchosts_test.go index da5662d64f..44406c81b8 100644 --- a/pkg/networkfs/etchosts/etchosts_test.go +++ b/pkg/networkfs/etchosts/etchosts_test.go @@ -14,7 +14,7 @@ func TestBuildHostnameDomainname(t *testing.T) { } defer os.Remove(file.Name()) - err = Build(file.Name(), "10.11.12.13", "testhostname", "testdomainname") + err = Build(file.Name(), "10.11.12.13", "testhostname", "testdomainname", nil) if err != nil { t.Fatal(err) } @@ -36,7 +36,7 @@ func TestBuildHostname(t *testing.T) { } defer os.Remove(file.Name()) - err = Build(file.Name(), "10.11.12.13", "testhostname", "") + err = Build(file.Name(), "10.11.12.13", "testhostname", "", nil) if err != nil { t.Fatal(err) } @@ -58,7 +58,7 @@ func TestBuildNoIP(t *testing.T) { } defer os.Remove(file.Name()) - err = Build(file.Name(), "", "testhostname", "") + err = Build(file.Name(), "", "testhostname", "", nil) if err != nil { t.Fatal(err) } From 924979259ec4c9ef6beab0468325f1cb04deaacb Mon Sep 17 00:00:00 2001 From: cyphar Date: Wed, 7 May 2014 01:05:15 +1000 Subject: [PATCH 432/436] integration-cli: docker_cli_links: fixed broken tests The tests weren't ... tested when last edited, this patch fixes them so that they run and pass correctly. Docker-DCO-1.1-Signed-off-by: Aleksa Sarai (github: cyphar) --- integration-cli/docker_cli_links_test.go | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/integration-cli/docker_cli_links_test.go b/integration-cli/docker_cli_links_test.go index a159d1c799..55c41e0bbc 100644 --- a/integration-cli/docker_cli_links_test.go +++ b/integration-cli/docker_cli_links_test.go @@ -21,10 +21,10 @@ func TestPingLinkedContainers(t *testing.T) { var out string out, _, _ = cmd(t, "run", "-d", "--name", "container1", "busybox", "sleep", "10") idA := stripTrailingCharacters(out) - out, _, _ = cmd("run", "-d", "--name", "container2", "busybox", "sleep", "10") + out, _, _ = cmd(t, "run", "-d", "--name", "container2", "busybox", "sleep", "10") idB := stripTrailingCharacters(out) - cmd("run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") - cmd("kill", idA) - cmd("kill", idB) + cmd(t, "run", "--rm", "--link", "container1:alias1", "--link", "container2:alias2", "busybox", "sh", "-c", "ping -c 1 alias1 -W 1 && ping -c 1 alias2 -W 1") + cmd(t, "kill", idA) + cmd(t, "kill", idB) deleteAllContainers() } From 69d43b2674aa8ed69c641556cae68d405505a45b Mon Sep 17 00:00:00 2001 From: Victor Marmol Date: Tue, 6 May 2014 15:53:38 +0000 Subject: [PATCH 433/436] Remove support for MemoryReservation in systemd systems. This has been deperecated since systemd 208. Docker-DCO-1.1-Signed-off-by: Victor Marmol (github: vmarmol) --- pkg/cgroups/systemd/apply_systemd.go | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/pkg/cgroups/systemd/apply_systemd.go b/pkg/cgroups/systemd/apply_systemd.go index 12dede9581..c4b0937b63 100644 --- a/pkg/cgroups/systemd/apply_systemd.go +++ b/pkg/cgroups/systemd/apply_systemd.go @@ -146,11 +146,7 @@ func Apply(c *cgroups.Cgroup, pid int) (cgroups.ActiveCgroup, error) { properties = append(properties, systemd1.Property{"MemoryLimit", dbus.MakeVariant(uint64(c.Memory))}) } - if c.MemoryReservation != 0 { - properties = append(properties, - systemd1.Property{"MemorySoftLimit", dbus.MakeVariant(uint64(c.MemoryReservation))}) - } - // TODO: MemorySwap not available in systemd + // TODO: MemoryReservation and MemorySwap not available in systemd if c.CpuShares != 0 { properties = append(properties, From 543e60eb60fed2734c10953216003325beddd536 Mon Sep 17 00:00:00 2001 From: Victor Marmol Date: Mon, 5 May 2014 23:56:53 +0000 Subject: [PATCH 434/436] Export cpuacct CPU usage in total cores over the sampled period. Docker-DCO-1.1-Signed-off-by: Victor Marmol (github: vmarmol) --- pkg/cgroups/fs/cpuacct.go | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/pkg/cgroups/fs/cpuacct.go b/pkg/cgroups/fs/cpuacct.go index 4ea2b1f51b..892b5ab6b1 100644 --- a/pkg/cgroups/fs/cpuacct.go +++ b/pkg/cgroups/fs/cpuacct.go @@ -36,9 +36,9 @@ func (s *cpuacctGroup) Remove(d *data) error { func (s *cpuacctGroup) Stats(d *data) (map[string]float64, error) { var ( - startCpu, lastCpu, startSystem, lastSystem float64 - percentage float64 - paramData = make(map[string]float64) + startCpu, lastCpu, startSystem, lastSystem, startUsage, lastUsage float64 + percentage float64 + paramData = make(map[string]float64) ) path, err := d.path("cpuacct") if startCpu, err = s.getCpuUsage(d, path); err != nil { @@ -47,6 +47,10 @@ func (s *cpuacctGroup) Stats(d *data) (map[string]float64, error) { if startSystem, err = s.getSystemCpuUsage(d); err != nil { return nil, err } + startUsageTime := time.Now() + if startUsage, err = getCgroupParamFloat64(path, "cpuacct.usage"); err != nil { + return nil, err + } // sample for 100ms time.Sleep(100 * time.Millisecond) if lastCpu, err = s.getCpuUsage(d, path); err != nil { @@ -55,10 +59,15 @@ func (s *cpuacctGroup) Stats(d *data) (map[string]float64, error) { if lastSystem, err = s.getSystemCpuUsage(d); err != nil { return nil, err } + usageSampleDuration := time.Since(startUsageTime) + if lastUsage, err = getCgroupParamFloat64(path, "cpuacct.usage"); err != nil { + return nil, err + } var ( deltaProc = lastCpu - startCpu deltaSystem = lastSystem - startSystem + deltaUsage = lastUsage - startUsage ) if deltaSystem > 0.0 { percentage = ((deltaProc / deltaSystem) * clockTicks) * cpuCount @@ -66,6 +75,9 @@ func (s *cpuacctGroup) Stats(d *data) (map[string]float64, error) { // NOTE: a percentage over 100% is valid for POSIX because that means the // processes is using multiple cores paramData["percentage"] = percentage + + // Delta usage is in nanoseconds of CPU time so get the usage (in cores) over the sample time. + paramData["usage"] = deltaUsage / float64(usageSampleDuration.Nanoseconds()) return paramData, nil } From 8d07c2d1aeb3326f1f62854e6adfd26f0d8e0342 Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Tue, 6 May 2014 11:39:11 -0700 Subject: [PATCH 435/436] Fix logo in README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1922be5d8a..fae1bb916b 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ It benefits directly from the experience accumulated over several years of large-scale operation and support of hundreds of thousands of applications and databases. -![Docker L](docs/theme/docker/static/img/dockerlogo-h.png "Docker") +![Docker L](docs/theme/mkdocs/img/logo_compressed.png "Docker") ## Better than VMs From 62e8ddb5791b9ee62c3f4361084dda4a5d7760e1 Mon Sep 17 00:00:00 2001 From: Michael Crosby Date: Tue, 6 May 2014 17:04:04 -0700 Subject: [PATCH 436/436] Set container pid for process in native driver Docker-DCO-1.1-Signed-off-by: Michael Crosby (github: crosbymichael) --- daemon/execdriver/native/driver.go | 1 + 1 file changed, 1 insertion(+) diff --git a/daemon/execdriver/native/driver.go b/daemon/execdriver/native/driver.go index e674d57333..2e57729d4b 100644 --- a/daemon/execdriver/native/driver.go +++ b/daemon/execdriver/native/driver.go @@ -122,6 +122,7 @@ func (d *driver) Run(c *execdriver.Command, pipes *execdriver.Pipes, startCallba return &c.Cmd }, func() { if startCallback != nil { + c.ContainerPid = c.Process.Pid startCallback(c) } })