jenmwms / edgex-compose

EdgeX Foundry Docker Compose release compose files and tools for building EdgeX compose files

Edgex Docker Compose

This repository contains the docker compose files for EdgeX releases. Each release is now on it's own branch.

Example: The Hanoi release compose files are here.

This branch contains the pre-release docker compose files that pull and run the EdgeX images from the Nexus3 docker registry that are tagged with master. These images are built from the Edgex CI Pipeline when PRs are merged into the master branch.

Note: Docker does not re-pull newer instances of these images. You must pull the new image instances. See the make pull command described below that will do this for you.

These pre-release docker compose files are generated from the multiple source compose files located in the compose-builder folder. See README there for details on regenerating these files after making changes to the source files.

Compose Files

This folder contains the following compose files:

Generated Compose files

**NOTES: **

• 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. 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-arm64.yml Contains all the services required to run in secure configuration on ARM64 system. Includes the Device Virtual & Device REST device services. Make Commands

  • Use make run arm64 and make down to start and stop the services using this compose file.
  • Use make pull arm64 <service(s)> to pull all or some images for the services in this compose file.
  • Use make get-token arm64 to generate a Kong access token for remote access of the services running from 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. 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-arm64.yml Contains just the services needed to run in non-secure configuration on ARM64 system. Includes the Device Virtual & Device REST device services.

  Make Commands

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

• docker-compose-no-secty-with-ui.yml Contains just the services needed to run in non-secure configuration with the EdgeX UI. Includes the Device Virtual, Device REST & App Sample services. Make Commands

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

• docker-compose-no-secty-with-ui-arm64.yml Contains just the services needed to run in non-secure configuration with the EdgeX UI on ARM64 system . Includes the Device Virtual, Device REST & App Sample services.

  Make Commands

  • Use make run no-secty ui arm64 and make down to start and stop the services using this compose file.
  • Use make pull no-secty ui arm64 <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 commands via docker to generate a new API Gateway token.

• make get-consul-acl-token For secure mode only. Runs commands 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.