Edgex Docker Compose (Levski)

This branch contains the docker compose files that pull and run the EdgeX Levski release images

Compose Tool

The Makefile in this folder expects docker-compose tool or the new Compose V2 plug-in for the Docker CLI. The docker-compose tool will be used if it is found in the path, otherwise it will try the docker compose CLI command.

Compose Files

This folder contains the following compose files:

Generated Compose files

Note to Developers:

• DO NOT EDIT the files directly for permanent changes. Make all permanent changes to the source compose files in the compose-builder folder and then regenerate these files
• Use make build from Compose Builder to regenerate all the following compose files.
• See each description for the convenience make commands that are provided to work with each of these compose files.

• docker-compose.yml Contains all the services required to run in secure configuration. Includes the Device Virtual & Device REST device services and the UI. Make Commands

  • Use make run <service(s)> and make down to start and stop the services using this compose file.

  • Use make pull <service(s)> to pull all or some images for the services in this compose file.

  • Use make get-token to generate a Kong access token for remote access of the services running from this compose file.

• docker-compose-amd64.yml Contains all the services required to run in secure configuration on amd64 system. Includes the Device Virtual & Device REST device services and the UI. Make Commands

  • Use make run amd64 and make down to start and stop the services using this compose file.
  • Use make pull amd64 <service(s)> to pull all or some images for the services in this compose file.
  • Use make get-token amd64 to generate a Kong access token for remote access of the services running from this compose file.

• docker-compose-with-app-sample.yml Contains all the services required to run in secure configuration with Sample application service. Includes the Device Virtual, Device REST, UI & App Sample services. Use this version when using the UI to make changes to the configurable pipeline on the Sample application service. Make Commands

  • Use make run app-sample and make down to start and stop the services using this compose file.
  • Use make pull app-sample <service(s)> to pull all or some images for the services in this compose file.

• docker-compose-with-app-sample-amd64.yml Contains all the services required to run in secure configuration with the Sample application service on amd64 system . Includes the Device Virtual, Device REST, UI & App Sample services. Use this version when using the UI to make changes to the configurable pipeline on the Sample application service.

  Make Commands

  • Use make run no-secty app-sample amd64 and make down to start and stop the services using this compose file.
  • Use make pull no-secty ui app-sample <service(s)> to pull all or some images for the services in this compose file.

• docker-compose-no-secty.yml Contains just the services needed to run in non-secure configuration. Includes the Device Virtual & Device REST device services and the UI. Make Commands

  • Use make run no-secty and make down to start and stop the services using this compose file.
  • Use make pull no-secty <service(s)> to pull all or some images for the services in this compose file.

• docker-compose-no-secty-amd64.yml Contains just the services needed to run in non-secure configuration on amd64 system. Includes the Device Virtual & Device REST device services and the UI.

  Make Commands

  • Use make run no-secty amd64 and make down to start and stop the services using this compose file.
  • Use make pull no-secty amd64 <service(s)> to pull all or some images for the services in this compose file.

• docker-compose-no-secty-with-app-sample.yml Contains just the services needed to run in non-secure configuration with Sample application service. Includes the Device Virtual, Device REST, UI & App Sample services. Use this version when using the UI to make changes to the configurable pipeline on the Sample application service. Make Commands

  • Use make run no-secty app-sample and make down to start and stop the services using this compose file.
  • Use make pull no-secty app-sample <service(s)> to pull all or some images for the services in this compose file.

• docker-compose-no-secty-with-app-sample-amd64.yml Contains just the services needed to run in non-secure configuration with the Sample application service on amd64 system . Includes the Device Virtual, Device REST, UI & App Sample services. Use this version when using the UI to make changes to the configurable pipeline on the Sample application service.

  Make Commands

  • Use make run no-secty app-sample amd64 and make down to start and stop the services using this compose file.
  • Use make pull no-secty app-sample <service(s)> to pull all or some images for the services in this compose file.

TAF Compose files

The compose files under the taf subfolder are used for the automated TAF tests. These compose files are also generated from Compose Builder when the make build command is used.

Additional make commands

• make clean

  Runs down command and removes all stopped containers, all volumes and all networks used by the EdgeX stack. Use this command when needing to do a fresh restart.

• make get-token For secure mode only. Runs command via docker to generate a new API Gateway token.

• make get-consul-acl-token For secure mode only. Runs command via docker to retrieve a Consul Access token.

Additional compose files

• docker-compose-portainer.yml Stand-alone compose file for running Portainer which is a Docker container management tool. Visit here https://www.portainer.io/ for more details on Portianer. Use make portainerand make portainer-down to start and stop Portainer.