mirror of
https://github.com/docker/docs.git
synced 2026-03-31 16:28:59 +07:00
dde577d154
This augments the CreateContainer call to detect the AuthConfig header
and use any supplied auth for pull operations. This will allow pulling
of protected image on to specific node during the create operation.
CLI usage example using username/password:
# Calculate the header
REPO_USER=yourusername
read -s PASSWORD
HEADER=$(echo "{\"username\":\"${REPO_USER}\",\"password\":\"${PASSWORD}\"}"|base64 -w 0 )
unset PASSWORD
echo HEADER=$HEADER
# Then add the following to your ~/.docker/config.json
"HttpHeaders": {
"X-Registry-Auth": "<HEADER string from above>"
}
# Now run a private image against swarm:
docker run --rm -it yourprivateimage:latest
CLI usage example using registry tokens: (Required engine 1.10 with new auth token support)
REPO=yourrepo/yourimage
REPO_USER=yourusername
read -s PASSWORD
AUTH_URL=https://auth.docker.io/token
TOKEN=$(curl -s -u "${REPO_USER}:${PASSWORD}" "${AUTH_URL}?scope=repository:${REPO}:pull&service=registry.docker.io" |
jq -r ".token")
HEADER=$(echo "{\"registrytoken\":\"${TOKEN}\"}"|base64 -w 0 )
echo HEADER=$HEADER
# Update the docker config as above, but the token will expire quickly...
Signed-off-by: Daniel Hiltgen <daniel.hiltgen@docker.com>
page_title, page_description, page_keywords
| page_title | page_description | page_keywords |
|---|---|---|
| Docker Swarm API | Swarm API | docker, swarm, clustering, api |
Docker Swarm API
The Docker Swarm API is mostly compatible with the Docker Remote API. This document is an overview of the differences between the Swarm API and the Docker Remote API.
Endpoints which behave differently
GET "/containers/{name:.*}/json": New fieldNodeadded:
"Node": {
"Id": "ODAI:IC6Q:MSBL:TPB5:HIEE:6IKC:VCAM:QRNH:PRGX:ERZT:OK46:PMFX",
"Ip": "0.0.0.0",
"Addr": "http://0.0.0.0:4243",
"Name": "vagrant-ubuntu-saucy-64",
},
-
GET "/containers/{name:.*}/json":HostIPreplaced by the the actual Node's IP ifHostIPis0.0.0.0 -
GET "/containers/json": Node's name prepended to the container name. -
GET "/containers/json":HostIPreplaced by the the actual Node's IP ifHostIPis0.0.0.0 -
GET "/containers/json": Containers started from theswarmofficial image are hidden by default, useall=1to display them. -
GET "/images/json": Use '--filter node=<Node name>' to show images of the specific node.