Programming
Docker

Getting Started {.cols-2}

Getting started

Create and run a container in background

$ docker run -d -p 80:80 docker/getting-started

  • -d - Run the container in detached mode
  • -p 80:80 - Map port 80 to port 80 in the container
  • docker/getting-started - The image to use {.marker-none}

Create and run a container in foreground

$ docker run -it -p 8001:8080 --name my-nginx nginx

  • -it - Interactive bash mode
  • -p 8001:8080 - Map port 8001 to port 8080 in the container
  • --name my-nginx - Specify a name
  • nginx - The image to use {.marker-none}

General commands

ExampleDescription
docker psList running containers
docker ps -aList all containers
docker ps -sList running containers
(with CPU / memory)
docker imagesList all images
docker exec -it <container> bashConnecting to container
docker logs <container>Shows container's console log
docker stop <container>Stop a container
docker restart <container>Restart a container
docker rm <container>Remove a container
docker port <container>Shows container's port mapping
docker top <container>List processes
docker kill <container>Kill a container

Parameter <container> can be container id or name

Docker Containers {.cols-2}

Starting & Stopping

DescriptionExample
docker start my-nginxStarting
docker stop my-nginxStopping
docker restart my-nginxRestarting
docker pause my-nginxPausing
docker unpause my-nginxUnpausing
docker wait my-nginxBlocking a Container
docker kill my-nginxSending a SIGKILL
docker attach my-nginxConnecting to an Existing Container

Information

ExampleDescription
docker psList running containers
docker ps -aList all containers
docker logs my-nginxContainer Logs
docker inspect my-nginxInspecting Containers
docker events my-nginxContainers Events
docker port my-nginxPublic Ports
docker top my-nginxRunning Processes
docker stats my-nginxContainer Resource Usage
docker diff my-nginxLists the changes made to a container.

Creating

docker create [options] IMAGE
  -a, --attach               # attach stdout/err
  -i, --interactive          # attach stdin (interactive)
  -t, --tty                  # pseudo-tty
      --name NAME            # name your image
  -p, --publish 5000:5000    # port map (host:container)
      --expose 5432          # expose a port to containers
  -P, --publish-all          # publish all ports
      --link container:alias # linking
  -v, --volume `pwd`:/app    # mount (absolute paths needed)
  -e, --env NAME=hello       # env vars

Example

$ docker create --name my_redis --expose 6379 redis:3.0.2

Manipulating

Renaming a Container

docker rename my-nginx my-nginx

Removing a Container

docker rm my-nginx

Updating a Container

docker update --cpu-shares 512 -m 300M my-nginx

Docker Images {.cols-2}

Manipulating

ExampleDescription
docker imagesListing images
docker rmi nginxRemoving an image
docker load < ubuntu.tar.gzLoading a tarred repository
docker load --input ubuntu.tarLoading a tarred repository
docker save busybox > ubuntu.tarSave an image to a tar archive
docker historyShowing the history of an image
docker commit nginxSave a container as an image.
docker tag nginx eon01/nginxTagging an image
docker push eon01/nginxPushing an image

Building Images

$ docker build .
$ docker build github.com/creack/docker-firefox
$ docker build - < Dockerfile
$ docker build - < context.tar.gz
$ docker build -t eon/my-nginx .
$ docker build -f myOtherDockerfile .
$ curl example.com/remote/Dockerfile | docker build -f - .

Docker Networking {.cols-2}

Manipulating

Removing a network

docker network rm MyOverlayNetwork

Listing networks

docker network ls

Getting information about a network

docker network inspect MyOverlayNetwork

Connecting a running container to a network

docker network connect MyOverlayNetwork nginx

Connecting a container to a network when it starts

docker run -it -d --network=MyOverlayNetwork nginx

Disconnecting a container from a network

docker network disconnect MyOverlayNetwork nginx

Creating Networks

docker network create -d overlay MyOverlayNetwork
 
docker network create -d bridge MyBridgeNetwork
 
docker network create -d overlay \
  --subnet=192.168.0.0/16 \
  --subnet=192.170.0.0/16 \
  --gateway=192.168.0.100 \
  --gateway=192.170.0.100 \
  --ip-range=192.168.1.0/24 \
  --aux-address="my-router=192.168.1.5" \
  --aux-address="my-switch=192.168.1.6" \
  --aux-address="my-printer=192.170.1.5" \
  --aux-address="my-nas=192.170.1.6" \
  MyOverlayNetwork

Clean Up {.cols-2}

Clean All

Cleans up dangling images, containers, volumes, and networks (ie, not associated with a container)

docker system prune

Additionally, remove any stopped containers and all unused images (not just dangling images)

docker system prune -a

Containers

Stop all running containers

docker stop $(docker ps -a -q)

Delete stopped containers

docker container prune

Images

Remove all dangling (not tagged and is not associated with a container) images:

docker image prune

Remove all images which are not used by existing containers

docker image prune -a

Volumes

docker volume prune

Remove all volumes not used by at least one container

Miscellaneous {.cols-2}

Docker Hub

Docker SyntaxDescription
docker search search_wordSearch docker hub for images.
docker pull user/image Downloads an image from docker hub.
docker login Authenticate to docker hub
docker push user/image Uploads an image to docker hub.

Registry commands {.row-span-3}

Login to a Registry

$ docker login
$ docker login localhost:8080

Logout from a Registry

$ docker logout
$ docker logout localhost:8080

Searching an Image

$ docker search nginx
$ docker search nginx --stars=3 --no-trunc busybox

Pulling an Image

$ docker pull nginx
$ docker pull eon01/nginx localhost:5000/myadmin/nginx

Pushing an Image

$ docker push eon01/nginx
$ docker push eon01/nginx localhost:5000/myadmin/nginx

Batch clean

ExampleDescription
docker stop -f $(docker ps -a -q)Stopping all containers
docker rm -f $(docker ps -a -q)Removing all containers
docker rmi -f $(docker images -q)Removing all images

Volumes

Check volumes

$ docker volume ls

Cleanup unused volumes

$ docker volume prune