Search Results for ""

Executors and Images

An executor defines the underlying technology or environment in which to run a job. Set up your jobs to run in the docker, machine, macos or windows executor and specify an image with the tools and packages you need.

Executor Overview

Docker

jobs:
  build: # name of your job
    docker: # executor type
      - image: buildpack-deps:trusty # primary container will run Ubuntu Trusty

      steps:
        # Commands run in the primary container

Find out more about using the docker executor here.

Machine

jobs:
  build: # name of your job
    machine: # executor type
      image: circleci/classic:201708-01 # VM will run Ubuntu 14.04 for this release date

      steps:
        # Commands run in a Linux virtual machine environment

Find out more about using the machine executor here.

macOS

Available on CircleCI Cloud - not currently available on self-hosted installations

jobs:
  build: # name of your job
    macos: # executor type
      xcode: "9.0"

    steps:
      # Commands run in a macOS virtual machine environment
      # with Xcode 9.0 installed

Find out more about using the macos executor here.

Windows

Available on CircleCI Cloud with version 2.1 config - not currently available on self-hosted installations

Note: The Windows executor requires a 2.1 version configuration as well as having Pipelines enabled. Go to “Project” > “Settings” > “Advanced Settings” to enable Pipelines.

version: 2.1 # Use version 2.1 to enable Orb usage.

orbs:
  win: circleci/windows@1.0.0 # The Windows orb give you everything you need to start using the Windows executor.

jobs:
  build: # name of your job
    executor: win/vs2019 # executor type

    steps:
      # Commands are run in a Windows virtual machine environment
      - checkout
      - run: Write-Host 'Hello, Windows'

Find out more about using the windows executor here.

See Also