wheels docker init

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