Build from Source#

This section shows how to build the APM blueprint’s application images from source code.

Note

You only need to build from source if you want to customize the application code. For standard deployments, the prebuilt images referenced in the Docker Compose files are sufficient.

Prerequisites#

  1. Complete the steps in the Get Started section.

  2. Ensure Docker Engine and Docker Compose tool are installed, and the Docker daemon is running.

  3. If building behind a proxy, set http_proxy, https_proxy, and no_proxy in your shell before running any build commands.

Steps to Build from Source#

1. Clone the Repository#

git clone https://github.com/open-edge-platform/edge-ai-suites.git -b release-2026.2.0
cd edge-ai-suites/metro-ai-suite/agentic-predictive-maintenance-pipeline

2. Configure the Build#

Set the registry URL and tag for the images you want to build. If you leave REGISTRY empty, the images will be built and tagged locally.

export REGISTRY=            # e.g. "docker.io/myusername/" — leave empty for local builds
export TAG=2026.2.0

3. Build the Images#

The Makefile provides build targets for each service and for all services together.

Build all three application services:

make build

Build individual services:

make build-storage-service     # storage-service only
make build-detection-service   # detection-service only
make build-ui-service          # ui-service only

The build targets use the Dockerfiles located in services/<service-name>/Dockerfile.

The reasoning agent (apm-agent) is no longer built from this repo — it is an external image (Intel EAL’s agent-quality-handler microservice) pulled via docker/compose.agents.yaml. See the agent-service integration guide for its contract.

4. Verify the Build#

After the build completes, confirm that the images are present:

docker images | grep apm

You will see entries for apm-storage-service, apm-detection-service, and apm-ui-service.

5. Deploy with Local Images#

Run the setup script normally. It will use the locally built images when the REGISTRY variable is empty:

./setup.sh --use-case pipeline-defect-detection

Reused Microservices#

The following microservices are reused from the edge-ai-libraries microservices catalog and are pulled as prebuilt images — they are not built by the APM Makefile:

Microservice

Image

DL Streamer Pipeline Server

intel/dlstreamer-pipeline-server

OpenVINO Model Server (OVMS)

openvino/model_server

Model Download

intel/model-download

Agent Quality Handler (agent-service)

intel/agent-quality-handler

To customize these microservices, refer to their respective source directories under microservices/ in the edge-ai-libraries repository.