★ WELCOME ★

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
articles:linux:docker-reference-page [2022/02/12 15:06]
tom
articles:linux:docker-reference-page [2022/02/12 16:32] (current)
tom [Packaging & Distributing Your Own Docker Containers into Images]
Line 32: Line 32:
   * This can change, so get the latest information by doing an Internet search "Install Docker" and go to the official docker documentation. Also, you want to check with your distribution as well, because when I went to install Docker using the official docker documentation for Ubuntu I ran into some problems.   * This can change, so get the latest information by doing an Internet search "Install Docker" and go to the official docker documentation. Also, you want to check with your distribution as well, because when I went to install Docker using the official docker documentation for Ubuntu I ran into some problems.
   * Keep in mind that there are two base flavors of Mint. Linux Mint (based on Ubuntu) and Linux Mint LMDE (based on Debian). And your Mint is based upon a particular edition of the upstream repositories... So, you want to follow the Docker install instructions for your distribution edition or the upstream edition your Mint is based on. Try [cat /etc/upstream-release/lsb-release] in the terminal or visit https://en.wikipedia.org/wiki/Linux_Mint#Ubuntu-based_editions.   * Keep in mind that there are two base flavors of Mint. Linux Mint (based on Ubuntu) and Linux Mint LMDE (based on Debian). And your Mint is based upon a particular edition of the upstream repositories... So, you want to follow the Docker install instructions for your distribution edition or the upstream edition your Mint is based on. Try [cat /etc/upstream-release/lsb-release] in the terminal or visit https://en.wikipedia.org/wiki/Linux_Mint#Ubuntu-based_editions.
 +
 +===== Basic Commands =====
  
  
Line 46: Line 48:
  
 # Initial start of a container based on a specific version of image (pulls image from hub if not already downloaded to your machine: # Initial start of a container based on a specific version of image (pulls image from hub if not already downloaded to your machine:
-docker run [flags] [name-of-image or id-of-image]:[version] +docker run [flags] [name-of-image or id-of-image][:version] 
   -d = runs in detached mode (so you can continue to use your terminal instance.   -d = runs in detached mode (so you can continue to use your terminal instance.
   -p[host port]:[container port] = port binding the host's bare metal port and binding it to the application's port (i.e. -p6000:6000)   -p[host port]:[container port] = port binding the host's bare metal port and binding it to the application's port (i.e. -p6000:6000)
Line 62: Line 64:
 # To enter into a terminal of a running container # To enter into a terminal of a running container
 docker exec -it [container name or last 12 positions of container id] /bin/bash docker exec -it [container name or last 12 positions of container id] /bin/bash
 +
 +# To list Docker networks:
 +docker network ls
  
 </code> </code>
  
-In order for containers to talk to each other you have to setup a docker network. Normally, unless you are a developer, you would not have to do this, but if you do then review Nana's video, Developing with Containers chapter below. Or reference a more up-to-date tutorial or documentation.+===== Docker Networks ===== 
 + 
 +In order for containers to talk to each other you have to setup a docker network. Normally, unless you are a developer, you would not have to do this, but if you do then review Nana's video, Developing with Containers chapter below. Or reference a more up-to-date tutorial or documentation. However, you can also setup a Docker network automatically when you use Docker compose. See topic below.
  
 {{youtube>3c-iBn73dDE?medium&start=4208&end=5387}} {{youtube>3c-iBn73dDE?medium&start=4208&end=5387}}
  
 +===== Docker Compose =====
 +
 +Placeholders are in square [] brackets and comments are in curly {} braces in the template below. Note that in the template I have laid out 2 different Docker containers in a single compose file. When you do this, a common Docker network is created. Also, indentation must be precise for this to work (supposedly).
 +
 +<code>
 +version:'3' {This is the version of Docker Compose the script is for.}
 +services:
 +  [user assigned name]: {same as docker run --name flag}
 +    image: [image name][:version] {name of image from Docker hub}
 +    ports:
 +      - [host port]:[container application port]
 +    volumes:
 +      - [user reference name]:[container path] {for a "named" volume}; or
 +      - [host path]:[container path] {for a "defined" volume}; or
 +      - [container path] {for an anonymous volume}
 +    environment:
 +      - [environment setting]=[assigned value]
 +  [user assigned name]: {same as docker run --name flag}
 +    image: [image name][:version] {name of image from Docker hub}
 +    ports:
 +      - [host port]:[container application port]
 +    volumes:
 +      - [user reference name]:[container path] {for a "named" volume}; or
 +      - [host path]:[container path] {for a "defined" volume}; or
 +      - [container path] {for an anonymous volume}
 +    environment:
 +      - [environment setting]=[assigned value] 
 +
 +# For two containers to share a volume, you can set that after defining named volumes above and adding the volume after the container definition and using an already defined name (i.e).
 +
 +volumes:
 +  db-data: {assuming db-data was established above}
 +    driver: local {this is needed but not sure why}
 +
 +</code>
 +
 +The contents of the file above would be saved in a text file saved with a .yaml extension.
 +
 +To start a Docker compose file, run:
 +
 +<code>
 +docker-compose [flags] [command]
 +  -f [name of yaml file] 
 +
 +Commands:
 +
 +  up = start a Docker Compose configuration
 +  down = stop a Docker Compose configuration
 +
 +Examples:
 +
 +docker-compose -f mycontainers.yaml up
 +docker-compose -f mycontainers.yaml down
 +</code>
 +
 +===== Persistent Data with Docker Volumes =====
 + 
 +You need to do this when you want to store data/files between restarts of a Docker container. 
 +
 +You have three types of Docker volumes, i.e.
 +
 +<code>
 +# A defined volume (Note: I am only showing the -v flag).
 +docker run -v [host folder]:[container folder]
 +docker run -v /home/myvolume/data:/var/lib/mysql/data
 +
 +# An anonymous volume (Note: I am only showing the -v flag and I don't necessarily know where the persistent storage is kept but should be below /var/lib/docker/volumes).
 +docker run -v [container folder]
 +docker run -v /var/lib/mysql/data
 +
 +# A named volume (Note: I am only showing the -v flag, again I may not know where the storage is kept but should be below /var/lib/docker/volumes, plus I am able to reference it better than an anonymous volume).
 +
 +</code>
 +
 +===== Packaging & Distributing Your Own Docker Containers into Images =====
  
 +Again, check with Nina on how to do this. Clients of Dockerized applications would not normally have to do any of this.
  
 +{{youtube>3c-iBn73dDE?medium&start=6120&end=8844}}
Print/export