Configuration¶
Configuration file¶
The configuration file genisys-connector.yml is written in YAML format.
connector:
# Server address to bind to.
bind: 127.0.0.1
# Application port
port: 7051
# Path to compute definitions
service_file: ./services.py
docker:
# URL of the Docker server
url: unix://var/run/docker.sock
Connector section¶
This section is related to the connector configuration.
bind
¶
The server address to bind to.
port
¶
The port that will be used to communicate with the connector via HTTP.
service_file
¶
A python file that defines an optional list of services that will be loaded by the connector during startup.
See Service definition below for more information on the format of the file.
Service definition¶
In order to manage Docker containers for a service, the adapter provides a simple service definition format to declare how to manage containers associated with a service.
A service definition looks like:
myService = {
"name": "myService"
"image": "docker_image:tag",
"command": "command",
"environment": {
"ENV_VARIABLE_A": "value",
"ENV_VARIABLE_B": "value",
},
"ports": ['8080']
}
A service definition must include a name and an image, it may optionally provide a command, an environment hash and an array of ports.
The image field is used to start a container, if the command field has been specified the container will be started using that command. The image tag must be specified.
The image field is also used when stopping containers, the image is used as reference to search in running containers.
The environment field is used to inject environment variables into the containers associated with the service.
The ports field is used to expose a list of ports on the Docker host.
An optional service_file (see service_file) can be used to define services using the format defined above. These definitions will be loaded during the connector startup.