spinny:~/writing $ less docker-containers-complete-guide.md
12Docker روش ساختن، ارسال و اجرای نرمافزار را تغییر داد. به جای "روی دستگاه من کار میکند"، Docker تضمین میکند که اپلیکیشن شما در همه جا یکسان اجرا شود - روی لپتاپ شما، روی دستگاه همکار، در CI/CD و در تولید. در این راهنما، از صفر تا دیپلوی یک اپلیکیشن واقعی پیش خواهیم رفت.34## Docker چیست؟56Docker پلتفرمی است که اپلیکیشن شما و تمام وابستگیهایش را در یک واحد استاندارد به نام **کانتینر** بستهبندی میکند. کانتینر یک فرآیند ایزوله و سبک است که هسته سیستم عامل میزبان را به اشتراک میگذارد اما سیستم فایل، شبکه و فضای فرآیند خود را دارد.78```mermaid9graph TD10 subgraph "Traditional Deployment"11 A1[App 1] --> OS1[Guest OS]12 A2[App 2] --> OS2[Guest OS]13 OS1 --> HV[Hypervisor]14 OS2 --> HV15 HV --> HW1[Hardware]16 end1718 subgraph "Docker Deployment"19 B1[App 1] --> D1[Container]20 B2[App 2] --> D2[Container]21 D1 --> DE[Docker Engine]22 D2 --> DE23 DE --> HW2[Hardware]24 end25```2627### کانتینرها در مقابل ماشینهای مجازی2829| جنبه | کانتینرها | ماشینهای مجازی |30|------|----------|----------------|31| **راهاندازی** | ثانیه | دقیقه |32| **اندازه** | مگابایت | گیگابایت |33| **سیستم عامل** | هسته میزبان را به اشتراک میگذارد | سیستم عامل مهمان کامل |34| **ایزولاسیون** | سطح فرآیند | سطح سختافزار |35| **عملکرد** | تقریبا بومی | سربار از هایپروایزر |36| **تراکم** | صدها در هر میزبان | دهها در هر میزبان |3738## نصب Docker3940```bash41# macOS42brew install --cask docker4344# Ubuntu/Debian45curl -fsSL https://get.docker.com | sh46sudo usermod -aG docker $USER4748# Verify installation49docker --version50docker run hello-world51```5253## مفاهیم اصلی5455### ایمیجها5657ایمیج یک قالب فقط خواندنی با دستورالعملهای ایجاد کانتینر است. آن را مانند یک عکس فوری از اپلیکیشن و محیط آن در نظر بگیرید.5859```bash60# Pull an image from Docker Hub61docker pull node:20-alpine6263# List local images64docker images6566# Remove an image67docker rmi node:20-alpine68```6970### کانتینرها7172کانتینر یک نمونه در حال اجرا از یک ایمیج است. میتوانید کانتینرها را ایجاد، راهاندازی، متوقف و حذف کنید.7374```bash75# Run a container76docker run -d --name my-app -p 3000:3000 node:20-alpine7778# List running containers79docker ps8081# List all containers (including stopped)82docker ps -a8384# Stop a container85docker stop my-app8687# Remove a container88docker rm my-app8990# View logs91docker logs my-app9293# Execute a command inside a running container94docker exec -it my-app sh95```9697## نوشتن Dockerfile9899Dockerfile یک فایل متنی با دستورالعملهایی برای ساخت ایمیج است. هر دستورالعمل یک لایه ایجاد میکند.100101### Dockerfile پایه برای یک اپلیکیشن Node.js102103```dockerfile104# Use an official Node.js runtime as base image105FROM node:20-alpine106107# Set working directory108WORKDIR /app109110# Copy package files first (better caching)111COPY package.json package-lock.json ./112113# Install dependencies114RUN npm ci --only=production115116# Copy application code117COPY . .118119# Expose the port the app runs on120EXPOSE 3000121122# Command to run the application123CMD ["node", "server.js"]124```125126### ساخت و اجرا127128```bash129# Build the image130docker build -t my-node-app .131132# Run the container133docker run -d -p 3000:3000 my-node-app134135# Visit http://localhost:3000136```137138## بیلد چند مرحلهای139140بیلدهای چند مرحلهای با جداسازی محیط بیلد از محیط اجرا، ایمیجهای تولید شما را کوچک نگه میدارند.141142```dockerfile143# Stage 1: Build144FROM node:20-alpine AS builder145WORKDIR /app146COPY package.json package-lock.json ./147RUN npm ci148COPY . .149RUN npm run build150151# Stage 2: Production152FROM node:20-alpine AS runner153WORKDIR /app154COPY --from=builder /app/dist ./dist155COPY --from=builder /app/node_modules ./node_modules156COPY --from=builder /app/package.json ./157EXPOSE 3000158CMD ["node", "dist/server.js"]159```160161این یک ایمیج تولید میکند که فقط شامل خروجی کامپایل شده و وابستگیهای تولید است - بدون کد منبع، بدون وابستگیهای توسعه، بدون ابزارهای بیلد.162163### مثال چند مرحلهای Next.js164165```dockerfile166FROM node:20-alpine AS deps167WORKDIR /app168COPY package.json package-lock.json ./169RUN npm ci170171FROM node:20-alpine AS builder172WORKDIR /app173COPY --from=deps /app/node_modules ./node_modules174COPY . .175RUN npm run build176177FROM node:20-alpine AS runner178WORKDIR /app179ENV NODE_ENV=production180COPY --from=builder /app/public ./public181COPY --from=builder /app/.next/standalone ./182COPY --from=builder /app/.next/static ./.next/static183EXPOSE 3000184CMD ["node", "server.js"]185```186187## والیومها: دادههای پایدار188189به طور پیشفرض، دادههای داخل کانتینر هنگام حذف کانتینر از بین میروند. والیومها این مشکل را حل میکنند.190191```bash192# Create a named volume193docker volume create my-data194195# Run with a volume196docker run -d -v my-data:/app/data my-app197198# Bind mount (map host directory to container)199docker run -d -v $(pwd)/data:/app/data my-app200201# List volumes202docker volume ls203```204205## شبکه206207Docker شبکههای ایزوله برای ارتباط کانتینرها ایجاد میکند.208209```bash210# Create a custom network211docker network create my-network212213# Run containers on the same network214docker run -d --name api --network my-network my-api215docker run -d --name db --network my-network postgres:16216217# Containers can reach each other by name218# From "api" container: postgres://db:5432219```220221```mermaid222graph LR223 subgraph "my-network"224 API[api container\nport 3000] -- "db:5432" --> DB[db container\nport 5432]225 end226 User -- "localhost:3000" --> API227```228229## Docker Compose230231Docker Compose به شما امکان میدهد اپلیکیشنهای چند کانتینری را با یک فایل YAML تعریف و اجرا کنید.232233### docker-compose.yml234235```yaml236services:237 api:238 build: ./api239 ports:240 - "3000:3000"241 environment:242 - DATABASE_URL=postgres://user:pass@db:5432/mydb243 depends_on:244 - db245246 db:247 image: postgres:16-alpine248 environment:249 - POSTGRES_USER=user250 - POSTGRES_PASSWORD=pass251 - POSTGRES_DB=mydb252 volumes:253 - pgdata:/var/lib/postgresql/data254 ports:255 - "5432:5432"256257 redis:258 image: redis:7-alpine259 ports:260 - "6379:6379"261262volumes:263 pgdata:264```265266### دستورات267268```bash269# Start all services270docker compose up -d271272# View logs273docker compose logs -f274275# Stop all services276docker compose down277278# Rebuild and restart279docker compose up -d --build280281# Scale a service282docker compose up -d --scale api=3283```284285## .dockerignore286287مانند `.gitignore`، این فایل از کپی شدن فایلهای غیرضروری در ایمیج جلوگیری میکند.288289```plaintext290node_modules291.git292.env293*.md294.next295dist296coverage297```298299## بهترین شیوههای تولید300301### 1. از ایمیجهای پایه کوچک استفاده کنید302303```dockerfile304# Bad: 1GB+305FROM node:20306307# Good: ~180MB308FROM node:20-alpine309```310311### 2. با کاربر Root اجرا نکنید312313```dockerfile314FROM node:20-alpine315RUN addgroup -S app && adduser -S app -G app316USER app317WORKDIR /home/app318COPY --chown=app:app . .319```320321### 3. از تگهای ایمیج مشخص استفاده کنید322323```dockerfile324# Bad: can change unexpectedly325FROM node:latest326327# Good: pinned version328FROM node:20.11-alpine3.19329```330331### 4. از کش بیلد بهره ببرید332333دستورالعملهای Dockerfile خود را از کمترین تا بیشترین تغییر مرتب کنید:334335```dockerfile336FROM node:20-alpine337WORKDIR /app338339# These change rarely - cached340COPY package.json package-lock.json ./341RUN npm ci --only=production342343# This changes often - not cached344COPY . .345```346347### 5. بررسی سلامت348349```dockerfile350HEALTHCHECK --interval=30s --timeout=3s --retries=3 \351 CMD wget -qO- http://localhost:3000/health || exit 1352```353354### 6. از متغیرهای محیطی استفاده کنید355356```dockerfile357ENV NODE_ENV=production358ENV PORT=3000359```360361## برگه تقلب دستورات رایج Docker362363```bash364# Images365docker build -t name:tag . # Build image366docker images # List images367docker rmi image_name # Remove image368docker image prune # Remove unused images369370# Containers371docker run -d -p 3000:3000 image # Run detached372docker ps # List running373docker stop container_name # Stop374docker rm container_name # Remove375docker logs -f container_name # Follow logs376docker exec -it container sh # Shell into container377378# Compose379docker compose up -d # Start services380docker compose down # Stop services381docker compose logs -f # Follow all logs382docker compose ps # List services383384# Cleanup385docker system prune -a # Remove everything unused386```387388## از Docker به Kubernetes389390Docker کانتینرهای جداگانه را مدیریت میکند. وقتی نیاز دارید صدها کانتینر را در چندین سرور هماهنگ کنید، به Kubernetes نیاز دارید. Docker و Kubernetes مکمل یکدیگر هستند:3913921. **Docker**: کانتینرها را میسازد و اجرا میکند3932. **Kubernetes**: کانتینرها را در مقیاس بزرگ هماهنگ میکند (زمانبندی، مقیاسپذیری، خودترمیمی)394395اگر به مرحله بعدی علاقهمندید، مقاله من درباره مقدمهای بر Kubernetes را ببینید.396397## نتیجهگیری398399Docker یک مهارت اساسی برای توسعهدهندگان مدرن است. ناسازگاریهای محیطی را از بین میبرد، دیپلوی را ساده میکند و پایهای برای هماهنگی کانتینرها با Kubernetes است. با یک Dockerfile ساده شروع کنید، به Docker Compose برای اپلیکیشنهای چند سرویسی بروید، و با رشد خود بیلدهای چند مرحلهای و بهترین شیوههای امنیتی را بپذیرید.400401بهترین راه یادگیری Docker، کانتینری کردن پروژهای است که در حال حاضر روی آن کار میکنید. همین امروز شروع کنید.402
:Docker برای مبتدیان: از اولین Image تا Deploy در Productionlines 1-402 (END) — press q to close