Differences
This shows you the differences between two versions of the page.
| 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 " | * This can change, so get the latest information by doing an Internet search " | ||
| * 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 / | * 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 / | ||
| + | |||
| + | ===== 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]: | -p[host port]: | ||
| 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 | ||
| </ | </ | ||
| - | 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> | {{youtube> | ||
| + | ===== 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). | ||
| + | |||
| + | < | ||
| + | version:' | ||
| + | services: | ||
| + | [user assigned name]: {same as docker run --name flag} | ||
| + | image: [image name][: | ||
| + | ports: | ||
| + | - [host port]: | ||
| + | volumes: | ||
| + | - [user reference name]: | ||
| + | - [host path]: | ||
| + | - [container path] {for an anonymous volume} | ||
| + | environment: | ||
| + | - [environment setting]=[assigned value] | ||
| + | [user assigned name]: {same as docker run --name flag} | ||
| + | image: [image name][: | ||
| + | ports: | ||
| + | - [host port]: | ||
| + | volumes: | ||
| + | - [user reference name]: | ||
| + | - [host path]: | ||
| + | - [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} | ||
| + | |||
| + | </ | ||
| + | |||
| + | 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: | ||
| + | |||
| + | < | ||
| + | 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 | ||
| + | </ | ||
| + | |||
| + | ===== 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. | ||
| + | |||
| + | < | ||
| + | # A defined volume (Note: I am only showing the -v flag). | ||
| + | docker run -v [host folder]: | ||
| + | docker run -v / | ||
| + | |||
| + | # 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 / | ||
| + | docker run -v [container folder] | ||
| + | docker run -v / | ||
| + | |||
| + | # 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 / | ||
| + | |||
| + | </ | ||
| + | |||
| + | ===== 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> | ||