Пълно ръководство за Docker и Docker Compose

# Базов образ - официален Node.js образ
FROM node:18-alpine

# Информация за създателя
LABEL maintainer="[email protected]"

# Работна директория в контейнера
WORKDIR /app

# Копиране на package.json и package-lock.json
COPY package*.json ./

# Инсталиране на зависимости
RUN npm ci --only=production

# Копиране на останалия код
COPY . .

# Създаване на не-root потребител за сигурност
RUN addgroup -g 1001 -S nodejs
RUN adduser -S nextjs -u 1001

# Промяна на собственика на файловете
RUN chown -R nextjs:nodejs /app
USER nextjs

# Порт, който приложението използва
EXPOSE 3000

# Команда за стартиране на приложението
CMD ["npm", "start"]

docker --version
docker-compose --version

docker run hello-world

# Официален Ubuntu образ
docker pull ubuntu:22.04

# Официален Node.js образ
docker pull node:18-alpine

# Официален Python образ
docker pull python:3.11-slim

# Nginx web сървър
docker pull nginx:alpine

# Стартиране на интерактивен Ubuntu контейнер
docker run -it ubuntu:22.04 /bin/bash

# След стартиране ще влезете в bash shell на контейнера
# Можете да изпълнявате команди като:
ls -la
cat /etc/os-release
exit  # за излизане

# Списък с всички работещи контейнери
docker ps

# Списък с всички контейнери (включително спрените)
docker ps -a

# Списък с всички образи
docker images

# Детайлна информация за контейнер
docker inspect 

# Статистики за ресурсите на контейнерите
docker stats

# Стартиране на Nginx на порт 8080
docker run -d -p 8080:80 --name my-nginx nginx:alpine

# Проверка дали работи
curl http://localhost:8080

# Или отворете http://localhost:8080 в браузъра си

# Спиране на контейнер
docker stop my-nginx

# Стартиране на спрян контейнер
docker start my-nginx

# Рестартиране на контейнер
docker restart my-nginx

# Изтриване на спрян контейнер
docker rm my-nginx

# Принудително изтриване на работещ контейнер
docker rm -f my-nginx

# Изтриване на всички спрени контейнери
docker container prune

# Преглед на логовете на контейнер
docker logs my-nginx

# Следене на логовете в реално време
docker logs -f my-nginx

# Последните 50 реда от логовете
docker logs --tail 50 my-nginx

# Логове с timestamps
docker logs -t my-nginx

{
  "name": "docker-example-app",
  "version": "1.0.0",
  "description": "Примерно приложение за Docker",
  "main": "server.js",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "nodemon": "^3.0.1"
  }
}

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.json({
    message: 'Здравей от Docker контейнер!',
    timestamp: new Date().toISOString(),
    nodeVersion: process.version
  });
});

app.get('/health', (req, res) => {
  res.json({ status: 'OK', uptime: process.uptime() });
});

app.listen(PORT, '0.0.0.0', () => {
  console.log(`Сървърът работи на порт ${PORT}`);
});

# Използваме официален Node.js образ базиран на Alpine Linux
FROM node:18-alpine

# Добавяме метаданни
LABEL maintainer="[email protected]"
LABEL version="1.0"
LABEL description="Примерно Node.js приложение с Docker"

# Инсталираме dumb-init за правилно управление на процеси
RUN apk add --no-cache dumb-init

# Създаваме не-root потребител за сигурност
RUN addgroup -g 1001 -S nodejs
RUN adduser -S nextjs -u 1001

# Задаваме работна директория
WORKDIR /app

# Копираме package файловете първо (за по-добро кеширане)
COPY --chown=nextjs:nodejs package*.json ./

# Инсталираме зависимостите
RUN npm ci --only=production && npm cache clean --force

# Копираме останалия код
COPY --chown=nextjs:nodejs . .

# Преминаваме към не-root потребител
USER nextjs

# Декларираме порта
EXPOSE 3000

# Добавяме health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD node healthcheck.js

# Използваме dumb-init като PID 1
ENTRYPOINT ["dumb-init", "--"]

# Стартираме приложението
CMD ["node", "server.js"]

const http = require('http');

const options = {
  hostname: 'localhost',
  port: 3000,
  path: '/health',
  method: 'GET',
  timeout: 2000
};

const req = http.request(options, (res) => {
  if (res.statusCode === 200) {
    process.exit(0);
  } else {
    process.exit(1);
  }
});

req.on('error', () => {
  process.exit(1);
});

req.end();

# Зависимости
node_modules
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Runtime данни
pids
*.pid
*.seed
*.pid.lock

# Coverage директория използвана от инструменти като istanbul
coverage
*.lcov

# Документация
README.md
.gitignore
.git

# IDE файлове
.vscode
.idea
*.swp
*.swo

# OS файлове
.DS_Store
Thumbs.db

# Docker файлове
Dockerfile*
docker-compose*

# Създаване на образ
docker build -t my-node-app:1.0 .

# Създаване с подробен изход
docker build -t my-node-app:1.0 --progress=plain .

# Създаване без кеш
docker build -t my-node-app:1.0 --no-cache .

# Стартиране на контейнер от нашия образ
docker run -d -p 3000:3000 --name my-app my-node-app:1.0

# Build stage
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build  # ако имаме build process

# Production stage
FROM node:18-alpine AS production
RUN apk add --no-cache dumb-init
RUN addgroup -g 1001 -S nodejs
RUN adduser -S nextjs -u 1001

WORKDIR /app
COPY --chown=nextjs:nodejs package*.json ./
RUN npm ci --only=production && npm cache clean --force

# Копираме само необходимите файлове от build stage
COPY --from=builder --chown=nextjs:nodejs /app/dist ./dist
COPY --chown=nextjs:nodejs server.js .

USER nextjs
EXPOSE 3000
ENTRYPOINT ["dumb-init", "--"]
CMD ["node", "server.js"]

version: '3.8'

services:
  # Web приложение
  web:
    build: .
    ports:
      - "3000:3000"
    env_file:
      - .env

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    env_file:
      - .env

# Стартиране на 3 инстанции на web услугата
docker-compose up --scale web=3

# Скалиране на multiple услуги
docker-compose up --scale web=3 --scale worker=2

# Скалиране без пресъздаване на други услуги
docker-compose up --scale web=5 --no-recreate

version: '3.8'

services:
  wordpress:
    image: wordpress:6-apache
    ports:
      - "8000:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wordpress_data:/var/www/html
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - db_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  wordpress_data:
  db_data:

version: '3.8'

services:
  # Prometheus за събиране на метрики
  prometheus:
    image: prom/prometheus:latest
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.console.libraries=/etc/prometheus/console_libraries'
      - '--web.console.templates=/etc/prometheus/consoles'
      - '--storage.tsdb.retention.time=200h'
      - '--web.enable-lifecycle'
    networks:
      - monitoring

  # Grafana за визуализация
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
    volumes:
      - grafana_data:/var/lib/grafana
      - ./grafana/dashboards:/etc/grafana/provisioning/dashboards
      - ./grafana/datasources:/etc/grafana/provisioning/datasources
    networks:
      - monitoring

  # Node Exporter за system метрики
  node-exporter:
    image: prom/node-exporter:latest
    ports:
      - "9100:9100"
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    command:
      - '--path.procfs=/host/proc'
      - '--path.rootfs=/rootfs'
      - '--path.sysfs=/host/sys'
      - '--collector.filesystem.mount-points-exclude=^/(sys|proc|dev|host|etc)($|/)'
    networks:
      - monitoring

  # AlertManager за alerts
  alertmanager:
    image: prom/alertmanager:latest
    ports:
      - "9093:9093"
    volumes:
      - ./alertmanager/alertmanager.yml:/etc/alertmanager/alertmanager.yml
      - alertmanager_data:/alertmanager
    networks:
      - monitoring

volumes:
  prometheus_data:
  grafana_data:
  alertmanager_data:

networks:
  monitoring:
    driver: bridge

version: '3.8'

services:
  # React Frontend
  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
      target: development
    ports:
      - "3000:3000"
    volumes:
      - ./frontend:/app
      - /app/node_modules
    environment:
      - REACT_APP_API_URL=http://localhost:5000
      - CHOKIDAR_USEPOLLING=true
    depends_on:
      - backend
    networks:
      - app-network

  # Node.js Backend API
  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile
      target: development
    ports:
      - "5000:5000"
      - "9229:9229"  # Debug port
    volumes:
      - ./backend:/app
      - /app/node_modules
    environment:
      - NODE_ENV=development
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=appdb
      - DB_USER=appuser
      - DB_PASSWORD=apppassword
      - REDIS_URL=redis://redis:6379
      - JWT_SECRET=your-secret-key
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
    networks:
      - app-network
    command: npm run dev

  # PostgreSQL Database
  postgres:
    image: postgres:15-alpine
    ports:
      - "5432:5432"
    environment:
      POSTGRES_DB: appdb
      POSTGRES_USER: appuser
      POSTGRES_PASSWORD: apppassword
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./database/init.sql:/docker-entrypoint-initdb.d/init.sql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U appuser -d appdb"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - app-network

  # Redis Cache
  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    command: redis-server --appendonly yes
    networks:
      - app-network

  # Nginx Reverse Proxy
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - frontend
      - backend
    networks:
      - app-network

  # Background Job Worker
  worker:
    build:
      context: ./backend
      dockerfile: Dockerfile
      target: development
    volumes:
      - ./backend:/app
      - /app/node_modules
    environment:
      - NODE_ENV=development
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=appdb
      - DB_USER=appuser
      - DB_PASSWORD=apppassword
      - REDIS_URL=redis://redis:6379
    depends_on:
      - postgres
      - redis
    networks:
      - app-network
    command: npm run worker

volumes:
  postgres_data:
  redis_data:

networks:
  app-network:
    driver: bridge

# Dependencies
node_modules
bower_components

# Logs
*.log
logs

# Runtime data
pids
*.pid
*.seed

# Coverage directory used by tools like istanbul
coverage

# Dependency directories
jspm_packages

# Optional npm cache directory
.npm

# Optional REPL history
.node_repl_history

# Output of 'npm pack'
*.tgz

# Yarn Integrity file
.yarn-integrity

# dotenv environment variables file
.env.local
.env.development.local
.env.test.local
.env.production.local

# IDE
.vscode
.idea
*.swp
*.swo

# OS
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db

# Git
.git
.gitignore

# Docker
Dockerfile*
docker-compose*
.dockerignore

# Documentation
README.md
CHANGELOG.md
LICENSE

# Tests
test
tests
__tests__
*.test.js
*.spec.js

# HTTP health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1

# TCP health check
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD nc -z localhost 5432 || exit 1

# Custom script health check
HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
  CMD ./healthcheck.sh

# Database health check
HEALTHCHECK --interval=30s --timeout=5s --retries=5 \
  CMD pg_isready -U $POSTGRES_USER -d $POSTGRES_DB || exit 1

# Build с множество tags
docker build -t myapp:1.2.3 -t myapp:1.2 -t myapp:1 -t myapp:latest .

# Push на всички версии
docker push myapp:1.2.3
docker push myapp:1.2
docker push myapp:1
docker push myapp:latest

# Named volume (препоръчително за production)
volumes:
  - postgres_data:/var/lib/postgresql/data

# Bind mount (добре за development)
volumes:
  - ./data:/var/lib/postgresql/data

# Tmpfs mount (за временни данни)
tmpfs:
  - /tmp

# Създаване на custom network
docker network create --driver bridge my-network

# Свързване на контейнер към мрежа
docker run --network my-network my-app

# В docker-compose
networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge
    internal: true  # Не позволява external достъп

# Преглед на използваното пространство
docker system df

# Почистване на неизползвани ресурси
docker system prune

# Агресивно почистване (внимавайте!)
docker system prune -a --volumes

# Почистване на конкретен тип ресурси
docker container prune  # Неизползвани контейнери
docker image prune      # Неизползвани образи
docker volume prune     # Неизползвани volumes
docker network prune    # Неизползвани мрежи

# Linux/Mac
sudo lsof -i :3000
netstat -tulpn | grep :3000

# Windows
netstat -ano | findstr :3000

# Спиране на контейнер, който използва порта
docker ps
docker stop 

# Преглед на ресурсите на всички контейнери
docker stats

# Преглед на ресурсите на конкретен контейнер
docker stats 

# Ограничаване на паметта
docker run -m 512m my-app

# В docker-compose
services:
  web:
    image: my-app
    deploy:
      resources:
        limits:
          memory: 512M
        reservations:
          memory: 256M

# Влизане в работещ контейнер
docker exec -it  /bin/bash

# Ако bash не е наличен (alpine образи)
docker exec -it  /bin/sh

# Стартиране на нов контейнер за debugging
docker run -it --rm  /bin/bash

# Копиране на файлове от/към контейнер
docker cp :/path/to/file ./local/path
docker cp ./local/file :/path/to/destination

# Преглед на логовете
docker logs 

# Следене на логове в реално време
docker logs -f 

# Последните N реда
docker logs --tail 100 

# Логове с timestamps
docker logs -t 

# Логове за определен период
docker logs --since="2023-01-01" --until="2023-01-02" 

# В docker-compose
docker-compose logs
docker-compose logs -f web
docker-compose logs --tail=50 db

# Пълна информация за контейнер
docker inspect 

# Специфична информация
docker inspect --format='{{.State.Status}}' 
docker inspect --format='{{.NetworkSettings.IPAddress}}' 

# Информация за образ
docker inspect 

# Процеси в контейнер
docker top 

# Файлови промени
docker diff