change dir name orch,container

Containerization-Orchestration/Docker/3-Docker-File.md

@@ -0,0 +1,160 @@
+# 🚢 Understanding Dockerfile: A Complete Guide
+
+---
+
+## 📄 What is a Dockerfile?
+
+A **Dockerfile** is a simple text file containing instructions to create a **Docker image**. Docker images provide a consistent, reproducible environment to run applications inside containers. By defining dependencies, configurations, and the operating system, Dockerfiles automate image creation, ensuring version-controlled and portable environments.
+
+---
+
+### 🔑 Key Concepts:
+
+* 🏗️ **Base Image**: The foundational layer of your image, usually an official OS like Ubuntu, CentOS, or Alpine Linux.
+* 📝 **Instructions**: Commands that tell Docker what to install, how the image behaves, and which files to include.
+
+Common instructions include:
+
+| Instruction | Description                                                      |
+| ----------- | ---------------------------------------------------------------- |
+| 🏃‍♂️ `RUN` | Executes commands inside the container (e.g., install software). |
+| 📁 `COPY`   | Copies files from your local machine to the image.               |
+| ▶️ `CMD`    | Specifies the default command when the container starts.         |
+
+---
+
+## 🛠️ Step-by-Step Guide to Creating a Dockerfile
+
+---
+
+### 1️⃣ Create a File Named `Dockerfile`
+
+Create a file called `Dockerfile` in your project directory. If named differently, specify the filename during build.
+
+#### Example Dockerfile:
+
+```dockerfile
+# 🐧 Use Ubuntu 22.04 as the base image
+FROM ubuntu:22.04
+
+# 🏷️ Add metadata such as version information
+LABEL version="0.0.1"
+
+# 🔄 Update package lists and install essential tools
+RUN apt update && apt install -y bash vim curl
+
+# 🌐 Install Nginx web server
+RUN apt install -y nginx
+```
+
+**Explanation:**
+
+* `FROM ubuntu:22.04` — Use Ubuntu 22.04 as the base image.
+* `LABEL version="0.0.1"` — Adds version metadata.
+* `RUN` — Executes commands inside the container to install tools and software.
+
+---
+
+### 2️⃣ Example Using Alpine Linux
+
+Alpine Linux is lightweight and creates smaller images.
+
+```dockerfile
+# 🐧 Use Alpine as the base image
+FROM alpine
+
+# 🏷️ Add version metadata
+LABEL version="0.0.1"
+
+# 🔄 Update package lists and install essential tools
+RUN apk update && apk add bash vim curl
+```
+
+Perfect for a compact, minimalistic image.
+
+---
+
+### 3️⃣ Complex Dockerfile with a Script
+
+```dockerfile
+# 🐧 Start with Alpine as the base image
+FROM alpine
+
+# 🏷️ Add metadata
+LABEL version="0.0.1"
+
+# 🔄 Update packages and install essential tools
+RUN apk update && apk add bash vim curl iputils-ping
+
+# 📂 Copy the script into the image
+COPY <local-file-path> <container-destination-path>
+
+# 🏠 Set working directory
+WORKDIR <container-destination-path>
+
+# 🌿 Add environment variables
+ENV API_KEY="123445"
+
+# 👤 Set user and expose ports
+USER deploy
+EXPOSE 3210
+
+# ⚙️ Make the script executable
+RUN chmod +x app.sh
+
+# ▶️ Default command to run
+CMD ["./app.sh"]
+# Alternatively, ENTRYPOINT ensures always running the executable
+ENTRYPOINT ["bash", "./app.sh"]
+```
+
+---
+
+### ❤️ Health Check Setup
+
+```dockerfile
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
+  CMD curl -f http://localhost/ || exit 1
+```
+
+* ⏲️ **interval**: time between checks
+* ⏳ **timeout**: fail if check takes longer than 5 seconds
+* 🔄 **retries**: mark container unhealthy after failed attempts
+* 🛡️ **start-period**: grace period before counting failures
+
+---
+
+### 4️⃣ Build Your Docker Image
+
+```bash
+docker build -t <app-name> <path-to-dockerfile>
+```
+
+**Examples:**
+
+* Build with Dockerfile in current directory:
+
+  ```bash
+  docker build -t app-test .
+  ```
+* Use custom Dockerfile name:
+
+  ```bash
+  docker build -t app-test -f <CustomDockerfile> .
+  ```
+* Build without cache:
+
+  ```bash
+  docker build -t app-test:v1 -f <Custom-Dir> . --no-cache
+  ```
+
+---
+
+## 📋 Summary
+
+A **Dockerfile** is a powerful tool for automating Docker image creation:
+
+1. 📝 **Create a Dockerfile**: Define the image with `FROM`, `RUN`, `COPY`, and `CMD`.
+2. 🏗️ **Build the Image**: Use `docker build` to generate your image.
+3. 🚀 **Run the Container**: Use `docker run` to start your container.
+