Skip to main content Link Menu Expand (external link) Document Search Copy Copied
Open Horizon

Using custom sample services

The Open Horizon All-in-One management hub deployment includes a set of default sample services that demonstrate edge computing capabilities. You can extend this by publishing your own custom sample services during the deployment process.

Overview

You can specify additional service repositories that are published to the Exchange during the All-in-One deployment. This is useful for:

  • Testing your own edge services in a development environment
  • Demonstrating custom solutions to stakeholders
  • Learning Open Horizon by working with your own code
  • Developing and validating services before production deployment

How it works

When you set the BYO_SAMPLES environment variable, the deployment script:

  1. Clones each repository you specify
  2. Runs make publish-only in each repository
  3. Publishes the service definition, service policy, and deployment policy to the Exchange
  4. Makes the services available for deployment to edge nodes

Your custom samples are published in addition to the default Open Horizon sample services (CPU, GPS, and Hello World).

Prerequisites

Before using custom samples, ensure that:

  • Each service repository follows the Open Horizon service structure
  • Each repository contains a Makefile with these targets:
    • publish-service: Publishes the service definition
    • publish-service-policy: Publishes the service policy
    • publish-deployment-policy: Publishes the deployment policy
  • Services are compatible with your target edge node architecture (AMD64, ARM, and so on.)

Step-by-step instructions

1. Create a samples file

Create a text file that contains the GitHub URLs of your service repositories. Each URL must be on a separate line. For example:

https://github.com/open-horizon/open-horizon-services/tree/main/web-helloworld-python
https://github.com/your-organization/your-custom-service
https://github.com/your-organization/another-service

Save this file (for example, as samples.txt) in a location that is accessible during deployment.

2. Set the environment variable

Before you run the deployment script, export the BYO_SAMPLES variable:

export BYO_SAMPLES=samples.txt

3. Run the deployment

Run the All-in-One deployment script:

curl -sSL https://raw.githubusercontent.com/open-horizon/devops/master/mgmt-hub/deploy-mgmt-hub.sh | bash

The script automatically detects the BYO_SAMPLES variable and publishes your custom services with the default samples.

4. Verify the deployment

After deployment completes, verify that your custom services were published:

export HZN_ORG_ID=myorg
export HZN_EXCHANGE_USER_AUTH=admin:<password>
hzn exchange service list

Verify that your custom services are listed along with the default samples.

Sample service repository structure

Your service repository must follow this structure:

your-service/
├── Makefile
├── service.json
├── service.policy.json
├── deployment.policy.json
├── horizon/
│   ├── pattern.json (optional)
│   └── ...
└── src/
    └── ... (your service code)

The Makefile must include the publish-only target that calls the individual publish targets.