Differences

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

--- docker:containers:run_a_docker_container [2020/11/11 11:37] – 192.168.1.1
+++ docker:containers:run_a_docker_container [2020/11/11 12:12] (current) – 192.168.1.1
@@ Line 1: / Line 1: @@
 ====== Docker - Containers - Run a Docker Container ======
-By default, Docker runs a container in **attached** mode.  That means it’s attached to the terminal session and output of the process will be displayed on your terminal.
-Containers can also be run in detached mode, which runs the process in the background, and keeps the container running after exiting from the terminal session.
-----
 Launching a container is simple as **docker run** + the image name you would like to run + the command to run within the container.
@@ Line 12: / Line 5: @@
 If the image doesn't exist on your local machine, Docker will attempt to fetch it from the public image registry.
-For example, if you ran **/bin/echo hello world** as your command, the container will start, print hello world and then stop:
+Containers can be run in different modes:
-<code bash>
-docker run ubuntu /bin/echo hello world
-</code>
-<WRAP info>
-**NOTE**:  Docker containers stop running as soon as the command they issued is complete, so this example will stop the container when the echo command has displayed "hello world".
-</WRAP>
+  * **Attached mode**:  The default mode.  The container is  attached to the terminal session and output of the process will be displayed on your terminal.
+  * **Detached mode**:  Runs the process in the background, and keeps the container running after exiting from the terminal session.
+  * **Interactive mode**:  Allows you to execute commands inside the container that is still running.
 ----
-An alternative method is:
+===== Run a Container in Attached Mode =====
 <code bash>
-docker run -ti ubuntu
+docker container run nginx
 </code>
-  * **-t**:  Runs a terminal.
+<WRAP info>
-  * **-i**:  Allow us to interact with it.
+**NOTE:**  You can press **CTRL + C** to stop the running Nginx container.
+</WRAP>
-This allows continuous use of the container until the terminal is exited by running the **exit** command.
 ----
@@ Line 52: / Line 40: @@
 ===== Run a Container in Detached Mode =====
+Runs the container in the background.
 <code bash>
@@ Line 69: / Line 59: @@
 bb07d011cc9        nginx               "/docker-entrypoint.…"   7 minutes ago       Up 7 minutes        80/tcp              docker-nginx
 </code>
+----
+===== Run a Container in Interactive Mode =====
+<code bash>
+docker container run --name docker-nginx -it nginx /bin/bash
+</code>
+----
+===== Run a Container and Publish Container Ports =====
+<code bash>
+docker container run --name docker-nginx -d -p 8080:80 nginx
+</code>
+where:
+  * **8080** is the port of the Docker host.
+  * **80** is the port of the container where the application is running.
+<WRAP info>
+**NOTE:**  You can verify the port 8080 using the URL http://docker-host-ip:8080 in your web browser.
+An optional host-ip can also be set:
+<code bash>
+docker container run -p [host-ip]:[host-port]:[container-port]
+</code>
+</WRAP>
+----
+===== Remove the Container After Exit =====
+<code bash>
+docker container run --rm mongo
+</code>
+----
+===== Run a Container and Mount Host Volumes =====
+By default, Docker containers do not save the data. When a container is stopped and the process is completed, all data generated by the container is removed.
+Sometimes you may need to run a container that requires persistent storage. In that case, you can use Docker volume to make the data persist and also share it across the multiple containers.
+<code bash>
+docker container run --name docker-nginx -d -p 8080:80 -v /mnt:/var/www nginx
+</code>
+<WRAP info>
+**NOTE:**  Any data written to **/var/www** within the container is actually accessing **/mnt** on the host.
+This option is useful for anyone running a database or application that requires persistence within Docker.
+</WRAP>
+----
+===== Example =====
+For example, if you ran **/bin/echo hello world** as your command, the container will start, print hello world and then stop:
+<code bash>
+docker run ubuntu /bin/echo hello world
+</code>
+<WRAP info>
+**NOTE**:  Docker containers stop running as soon as the command they issued is complete, so this example will stop the container when the echo command has displayed "hello world".
+</WRAP>
+----
+An alternative method is:
+<code bash>
+docker run -ti ubuntu
+</code>
+  * **-t**:  Runs a terminal.
+  * **-i**:  Allow us to interact with it.
+This allows continuous use of the container until the terminal is exited by running the **exit** command.
+----