wheels docker init

This command works correctly without options (parameters). Option support is under development and will be available soon.

Initialize Docker configuration for your Wheels application.

Synopsis

wheels docker init [options]

Description

The wheels docker init command creates Docker configuration files for containerizing your Wheels application. It generates a Dockerfile, docker-compose.yml, and supporting configuration files optimized for Wheels applications.

Options

| Option | Description | Default | |--------|-------------|---------| | --engine | CFML engine (lucee5, lucee6, adobe2018, adobe2021, adobe2023) | lucee6 | | --database | Database system (mysql, postgresql, sqlserver, none) | mysql | | --port | Application port | 8080 | | --with-nginx | Include Nginx reverse proxy | false | | --with-redis | Include Redis for caching | false | | --production | Generate production-ready configuration | false | | --force | Overwrite existing Docker files | false | | --help | Show help information |

Examples

Basic initialization

wheels docker init

Initialize with Adobe ColdFusion

wheels docker init --engine=adobe2023

Production setup with Nginx

wheels docker init --production --with-nginx --port=80

Initialize with PostgreSQL

wheels docker init --database=postgresql

Full stack with Redis

wheels docker init --with-nginx --with-redis --database=postgresql

What It Does

1. Creates Dockerfile optimized for CFML applications:

   • Base image selection based on engine
   • Dependency installation
   • Application file copying
   • Environment configuration

2. Generates docker-compose.yml with:

   • Application service
   • Database service (if selected)
   • Nginx service (if selected)
   • Redis service (if selected)
   • Network configuration
   • Volume mappings

3. Additional files:

   • .dockerignore - Excludes unnecessary files
   • docker-entrypoint.sh - Container startup script
   • Configuration files for selected services

Generated Files

Dockerfile Example

FROM ortussolutions/commandbox:lucee5

# Set working directory
WORKDIR /app

# Copy application files
COPY . /app

# Install dependencies
RUN box install

# Expose port
EXPOSE 8080

# Start server
CMD ["box", "server", "start", "--console"]

docker-compose.yml Example

version: '3.8'

services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - WHEELS_ENV=development
      - DB_HOST=database
    depends_on:
      - database
    volumes:
      - ./:/app

  database:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=wheels
      - MYSQL_DATABASE=wheels_app
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

Configuration Options

Development Mode

• Hot reload enabled
• Source code mounted as volume
• Debug ports exposed
• Development databases

Production Mode

• Optimized image size
• Security hardening
• Health checks
• Restart policies
• Resource limits

Use Cases

1. Local Development: Consistent development environment across team
2. Testing: Isolated test environments with different configurations
3. CI/CD: Containerized testing in pipelines
4. Deployment: Production-ready containers for cloud deployment

Environment Variables

Common environment variables configured:

| Variable | Description | |----------|-------------| | WHEELS_ENV | Application environment | | WHEELS_DATASOURCE | Database connection name | | DB_HOST | Database hostname | | DB_PORT | Database port | | DB_NAME | Database name | | DB_USER | Database username | | DB_PASSWORD | Database password |

Notes

• Requires Docker and Docker Compose installed
• Database passwords are set to defaults in development
• Production configurations should use secrets management
• The command detects existing Docker files and prompts before overwriting

See Also

• wheels docker deploy - Deploy using Docker
• wheels deploy - General deployment commands
• wheels ci init - Initialize CI configuration