On hosted installations of CircleCI, the AMI used for VM Service, which provides access to a dedicated Docker daemon via the machine
executor (see Executor Types: Using Machine) and setup_remote_docker
(see Running Docker Commands: Overview), is completely customizable.
By extending our default installed set of packages and dependencies to create your own custom VM Service AMI, you can install custom versions of Docker, as well as pre-bake any common frameworks, security tools, proxy settings, etc., into the AMI itself, simplifying the required setup and configuration steps that might otherwise have to live in the config.yml configuration files for any projects with jobs that require the machine
executor or setup_remote_docker
.
The customization process uses CircleCI's open-source image-builder repository—the following set of steps should help you create your custom VM Service AMI.
- install Packer
- clone the
picard-vm-image
branch of image-builder - fill in required groups in aws-vm.json
- add customizations (proxy settings, etc.) to the end of provision.sh
- run
packer build aws-vm.json
in the root of theimage-builder
directory - add your new AMI to the "Custom VM AMI" field in the"VM Provider" section of the Replicated Management Console (see below)
- restart CircleCI
- fork and run realitycheck (see Using realitycheck) to verify that your new VM service AMI is functional (check the
vm_jobs
workflow)
Comments
Please sign in to leave a comment.