Service configuration options
Overview
Service configurations allow you to customize many aspects of a Cloud 66 services. These are defined in the service.yml
file. If you're unfamiliar with service configurations, please read our introductory guide first.
Service configuration options
This is the complete list of all service configuration directives for Cloud 66 Container Service V1. For more detailed information about an option, click the link provided.
Option | Description |
---|---|
build_command | Specifies the command you would like to run during application build. |
build_root | Specifies the directory of your repository in which you wish to run your Docker build. |
command | Specifies the command used to start your container. |
deploy_command | Specifies the command you would like to run during application deploy (runs once per service). |
dns_behaviour | Specifies the dns behaviour for this service. Accepted values: versioned, non-versioned. Defaults to versioned. |
dockerfile_path | Specifies the location of the Dockerfile to be used for building this service, eg. docker/Dockerfile. |
tags | Arbitrary tags for services |
git_url | The URL for the Git repository from which your Docker image will be built. |
git_branch | The Git repository branch your Docker image will be based on. |
use_habitus | Use Habitus build workflow |
use_habitus_step | The Habitus step to use for the build. |
health | One of the values: default, none or a hash containing at least one of type, endpoint, protocol, accept or timeout. |
image | The image you would typically run docker pull from. |
load_balancing | Specifies the load balancing method for this service. Accepted values: roundrobin, sticky, closest. Default value is roundrobin |
log_folder | Folder your services logs to, mounted to /var/log/containers/service on the host filesystem. |
ports | The ports that are running within the container, as well as their corresponding external ports. |
privileged (default: false) | Boolean value to indicate whether the container should be run with extended privileges. |
requires | Array of other defined service names that should be started before this service during build and deployment. |
restart_on_deploy (default: true) | Boolean value to indicate whether the containers of this service should be restarted during deployment. |
stop_grace | Duration between the Docker TERM and KILL signals when Docker stop is run and a container is stopped. |
traffic_matches | The automatically configured traffic names in your Nginx config that will route traffic to these containers based on request DNS name. Allows microservices on the same port routes by subdomain for instance. |
volumes | Volumes mounted from host into container. Syntax: Array of absolute paths, with the format HOST_FOLDER:CONTAINER_FOLDER . Optional 'ro' on the end for read-only. e.g. /tmp/host:/tmp/container:ro |
work_dir | Specifies the working directory in your image for any command to be run. |