How to fix ERROR: services.web Additional property invalid is not allowed in Docker

# Common typos that cause this error:
services:
  web:
    port: "8080:80"      # ❌ Wrong - should be 'ports'
    volume:              # ❌ Wrong - should be 'volumes'
      - ./data:/data
    enviroment:          # ❌ Wrong - should be 'environment'
      - NODE_ENV=prod
    depend_on:           # ❌ Wrong - should be 'depends_on'
      - db

# Correct version:
services:
  web:
    ports:               # ✅ Correct (plural)
      - "8080:80"
    volumes:             # ✅ Correct (plural)
      - ./data:/data
    environment:         # ✅ Correct spelling
      - NODE_ENV=prod
    depends_on:          # ✅ Correct (with 's')
      - db

# ❌ WRONG - 'ports' is at the wrong indentation level
services:
  web:
    image: nginx
  ports:                 # This is at the services level, not under 'web'
    - "80:80"

# ❌ WRONG - Property appears as a new service
services:
  web:
    image: nginx
    environment:
      - NODE_ENV=prod
  restart: always        # This creates a service called 'restart'

# ✅ CORRECT - All properties properly indented under 'web'
services:
  web:
    image: nginx
    ports:               # Indented under 'web'
      - "80:80"
    environment:
      - NODE_ENV=prod
    restart: always      # Indented under 'web'

# ❌ Old approach with version field
version: "3.8"
services:
  web:
    image: nginx

# ✅ Modern approach - omit version field
services:
  web:
    image: nginx

# Check current version
docker compose version

# If you have the old docker-compose (with hyphen), upgrade to v2
# On Linux:
sudo apt-get update
sudo apt-get install docker-compose-plugin

# On macOS/Windows:
# Update Docker Desktop to get the latest docker compose

# Verify the update
docker compose version
# Should show: Docker Compose version v2.x.x

# Properties that need specific versions or contexts:

# ❌ 'deploy' is ignored in docker-compose, only works in Swarm
services:
  web:
    deploy:
      replicas: 3        # Use 'docker stack deploy' for this

# ❌ 'devices' in deploy.resources needs Compose v2.3+
services:
  gpu-app:
    deploy:
      resources:
        reservations:
          devices:       # Requires newer Compose
            - driver: nvidia

# ❌ Extension fields need version 2.1+ or 3.4+
x-logging: &logging      # Needs version that supports extensions
  driver: json-file

# ✅ For maximum compatibility, use the Compose Specification (no version)
services:
  web:
    image: nginx
    # ... modern properties work here

# These commands use DIFFERENT schemas:
docker compose up        # Compose Specification (more properties)
docker stack deploy      # Legacy version 3.x schema (fewer properties)

# For local development
docker compose -f docker-compose.yml up

# For Swarm deployment (stripped-down version)
docker stack deploy -c docker-stack.yml myapp