This is the main project configuration file for the Overnode. The format of the file is documented below. The tutorial is in the Managing Containers section.
The file should have the following format:
idproperty is a unique within a cluster identifier of a project. Overnode can manage multiple projects in the same cluster and the
idfield value allows to identify a project.
versiondefines Docker Compose file format version, which will be used by a project. All Docker Compose files, which are referenced by the overnode.yml file, are required to have the same version value. Unfortunately, this limitation cannot be easily removed as it is in the core of the Docker Compose, which is used by the Overnode.
<stack-name>is a name of a stack. It can be any combination of letters, digits, underscore and dash symbols.
<compose-file-reference.yml>is a relative path to a referenced configuration for Docker Compose
<placement-rule>is a rule which defines what nodes are required to apply the referenced Docker Compose file. The allowed values:
*- all nodes
a set of comma-separated numbers and dash-separated ranges of numbers, for example: 1,3,5-9,12
It is possible to use variables in this file. The variables should be defined in the .env file.
For example, using
which could be defined as the following in the .env file: