LogoLogo
HomeAPIBlog
3.0.0-SNAPSHOT
3.0.0-SNAPSHOT
  • INTRODUCTION
    • Getting Started
      • Running Local Development Servers
      • Beginner Tutorial: Hello World
      • Beginner Tutorial: Hello Database
      • Tutorial: Wheels, AJAX, and You
    • Frameworks and Wheels
    • Requirements
    • Manual Installation
    • Upgrading
    • Screencasts
  • Command Line Tools
    • CLI Overview
    • Quick Start Guide
    • Command Reference
      • Core Commands
        • wheels init
        • wheels info
        • wheels reload
        • wheels deps
        • wheels destroy
        • wheels watch
      • Code Generation
        • wheels generate app
        • wheels generate app-wizard
        • wheels generate controller
        • wheels generate model
        • wheels generate view
        • wheels generate property
        • wheels generate route
        • wheels generate resource
        • wheels generate api-resource
        • wheels generate frontend
        • wheels generate test
        • wheels generate snippets
        • wheels scaffold
      • Database Commands
        • wheels dbmigrate info
        • wheels dbmigrate latest
        • wheels dbmigrate up
        • wheels dbmigrate down
        • wheels dbmigrate reset
        • wheels dbmigrate exec
        • wheels dbmigrate create blank
        • wheels dbmigrate create table
        • wheels dbmigrate create column
        • wheels dbmigrate remove table
        • wheels db schema
        • wheels db seed
      • Testing Commands
        • wheels test
        • wheels test run
        • wheels test coverage
        • wheels test debug
      • Configuration Commands
        • wheels config list
        • wheels config set
        • wheels config env
      • Environment Management
        • wheels env
        • wheels env setup
        • wheels env list
        • wheels env switch
      • Plugin Management
        • wheels plugins
        • wheels plugins list
        • wheels plugins install
        • wheels plugins remove
      • Code Analysis
        • wheels analyze
        • wheels analyze code
        • wheels analyze performance
        • wheels analyze security
      • Security Commands
        • wheels security
        • wheels security scan
      • Performance Commands
        • wheels optimize
        • wheels optimize performance
      • Documentation Commands
        • wheels docs
        • wheels docs generate
        • wheels docs serve
      • CI/CD Commands
        • wheels ci init
      • Docker Commands
        • wheels docker init
        • wheels docker deploy
      • Deployment Commands
        • wheels deploy
        • wheels deploy audit
        • wheels deploy exec
        • wheels deploy hooks
        • wheels deploy init
        • wheels deploy lock
        • wheels deploy logs
        • wheels deploy proxy
        • wheels deploy push
        • wheels deploy rollback
        • wheels deploy secrets
        • wheels deploy setup
        • wheels deploy status
        • wheels deploy stop
    • CLI Development Guides
      • Creating Commands
      • Service Architecture
      • Migrations Guide
      • Testing Guide
  • Working with Wheels
    • Conventions
    • Configuration and Defaults
    • Directory Structure
    • Switching Environments
    • Testing Your Application
    • Using the Test Environment
    • Contributing to Wheels
    • Submitting Pull Requests
    • Documenting your Code
  • Handling Requests with Controllers
    • Request Handling
    • Rendering Content
    • Redirecting Users
    • Sending Files
    • Sending Email
    • Responding with Multiple Formats
    • Using the Flash
    • Using Filters
    • Verification
    • Event Handlers
    • Routing
    • URL Rewriting
      • Apache
      • IIS
      • Tomcat
      • Nginx
    • Obfuscating URLs
    • Caching
    • Nesting Controllers
    • CORS Requests
  • Displaying Views to Users
    • Pages
    • Partials
    • Linking Pages
    • Layouts
    • Form Helpers and Showing Errors
    • Displaying Links for Pagination
    • Date, Media, and Text Helpers
    • Creating Custom View Helpers
    • Localization
  • Database Interaction Through Models
    • Object Relational Mapping
    • Creating Records
    • Reading Records
    • Updating Records
    • Deleting Records
    • Column Statistics
    • Dynamic Finders
    • Getting Paginated Data
    • Associations
    • Nested Properties
    • Object Validation
    • Object Callbacks
    • Calculated Properties
    • Transactions
    • Dirty Records
    • Soft Delete
    • Automatic Time Stamps
    • Database Migrations
      • Migrations in Production
    • Using Multiple Data Sources
  • Plugins
    • Installing and Using Plugins
    • Developing Plugins
    • Publishing Plugins
  • Project Documentation
    • Overview
  • External Links
    • Source Code
    • Issue Tracker
    • Sponsor Us
    • Community
Powered by GitBook
LogoLogo
On this page
  • Synopsis
  • Description
  • Arguments
  • Options
  • Examples
  • Initialize GitHub Actions
  • Initialize with specific engines
  • Initialize with multiple databases
  • Initialize GitLab CI
  • Use full template with force overwrite
  • What It Does
  • Generated Configuration
  • Templates
  • Basic Template
  • Full Template
  • Minimal Template
  • Use Cases
  • Notes
  • See Also

Was this helpful?

Edit on GitHub
Export as PDF
  1. Command Line Tools
  2. Command Reference
  3. CI/CD Commands

wheels ci init

Initialize continuous integration configuration for your Wheels application.

Synopsis

wheels ci init [provider] [options]

Description

The wheels ci init command sets up continuous integration (CI) configuration files for your Wheels application. It generates CI/CD pipeline configurations for popular CI providers like GitHub Actions, GitLab CI, Jenkins, and others.

Arguments

Argument
Description
Default

provider

CI provider to configure (github, gitlab, jenkins, travis, circle)

github

Options

Option
Description

--template

Use a specific template (basic, full, minimal)

--branch

Default branch name

--engines

CFML engines to test (lucee5, lucee6, adobe2018, adobe2021, adobe2023)

--databases

Databases to test against (h2, mysql, postgresql, sqlserver)

--force

Overwrite existing CI configuration

--help

Show help information

Examples

Initialize GitHub Actions

wheels ci init github

Initialize with specific engines

wheels ci init github --engines=lucee6,adobe2023

Initialize with multiple databases

wheels ci init github --databases=mysql,postgresql

Initialize GitLab CI

wheels ci init gitlab --branch=develop

Use full template with force overwrite

wheels ci init github --template=full --force

What It Does

  1. Creates CI configuration files in the appropriate location:

    • GitHub Actions: .github/workflows/ci.yml

    • GitLab CI: .gitlab-ci.yml

    • Jenkins: Jenkinsfile

    • Travis CI: .travis.yml

    • CircleCI: .circleci/config.yml

  2. Configures test matrix for:

    • Multiple CFML engines

    • Multiple database systems

    • Different operating systems (if supported)

  3. Sets up common CI tasks:

    • Dependency installation

    • Database setup

    • Test execution

    • Code coverage reporting

    • Artifact generation

Generated Configuration

Example GitHub Actions configuration:

name: CI
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        cfengine: [lucee@5, lucee@6, adobe@2023]
        database: [h2]
    
    steps:
      - uses: actions/checkout@v4
      - name: Setup CommandBox
        uses: ortus-solutions/setup-commandbox@v2
      - name: Install dependencies
        run: box install
      - name: Start server
        run: box server start cfengine=${{ matrix.cfengine }}
      - name: Run tests
        run: box testbox run

Templates

Basic Template

  • Single engine and database

  • Essential test execution

  • Minimal configuration

Full Template

  • Multiple engines and databases

  • Code coverage

  • Deployment steps

  • Notifications

Minimal Template

  • Bare minimum for CI

  • Quick setup

  • No extras

Use Cases

  1. New Project Setup: Quickly add CI/CD to a new Wheels project

  2. Migration: Move from one CI provider to another

  3. Standardization: Apply consistent CI configuration across projects

  4. Multi-Engine Testing: Ensure compatibility across CFML engines

Notes

  • Requires a valid Wheels application structure

  • Some providers may require additional authentication setup

  • Database services are configured as Docker containers where possible

  • The command respects existing .gitignore patterns

See Also

PreviousCI/CD CommandsNextDocker Commands

Last updated 2 days ago

Was this helpful?

- Run tests locally

- Initialize Docker configuration

- Deployment commands

wheels test
wheels docker init
wheels deploy