Deploy with Helm#

Use Helm to deploy Smart Intersection to a Kubernetes cluster. This guide will help you:

  • Add the Helm chart repository.

  • Configure the Helm chart to match your deployment needs.

  • Deploy and verify the application.

Helm simplifies Kubernetes deployments by streamlining configurations and enabling easy scaling and updates. For more details, see Helm Documentation.

Prerequisites#

Before You Begin, ensure the following:

  • Kubernetes Cluster: Ensure you have a properly installed and configured Kubernetes cluster.

  • System Requirements: Verify that your system meets the minimum requirements.

  • Tools Installed: Install the required tools:

    • Kubernetes CLI (kubectl)

    • Helm 3 or later

Steps to Deploy#

To deploy the Smart Intersection Sample Application, copy and paste the entire block of following commands into your terminal and run them:

Clone the Repository and Install Prerequisites#

Note: Skip this step if you have already followed the steps as part of the Get Started guide.

Before you can deploy with Helm, you must clone the repository and run the installation script:

# Clone the repository
git clone https://github.com/open-edge-platform/edge-ai-suites.git

# Navigate to the Metro AI Suite directory
cd edge-ai-suites/metro-ai-suite/metro-vision-ai-app-recipe/

# Run the installation script for smart-intersection
./install.sh smart-intersection

Configure Proxy Settings (If Behind a Proxy)#

If you are deploying in a proxy environment, update the values.yml file with your proxy settings before installation:

# Edit the values.yml file to add proxy configuration
nano ./smart-intersection/chart/values.yaml

Update the existing proxy configuration in your values.yaml with following values:

http_proxy: "http://your-proxy-server:port"
https_proxy: "http://your-proxy-server:port"
no_proxy: "localhost,127.0.0.1,.local,.cluster.local"

Replace your-proxy-server:port with your actual proxy server details.

Switch to Stable Build (Optional)

To use stable releases from Docker Hub instead of weekly builds, update the values.yaml file with following information,

scene:
  repository: intel/scenescape-controller
  tag: v1.3.0
pgserver:
  repository: intel/scenescape-manager
  tag: v1.3.0
web:
  image:
    repository: intel/scenescape-manager
    tag: v1.3.0
dlstreamerPipelineServer:
  repository: intel/dlstreamer-pipeline-server
  tag: 3.1.0-ubuntu24

This updates the application to use stable images from Docker Hub.

Deploy the application#

Now you’re ready to deploy the Smart Intersection application:

# Install the chart
helm upgrade --install smart-intersection ./smart-intersection/chart \
  --create-namespace \
  --set grafana.service.type=NodePort \
  -n smart-intersection

Access Application Services using Node Port#

Access the Application UI using Node Port#

  • Get the Node Port Number using following command and use it to access the Application UI

kubectl get service smart-intersection-web -n smart-intersection -o jsonpath='{.spec.ports[0].nodePort}'

  • Go to https://<HOST_IP>:<Node_PORT>

    • Log in with credentials:

      • Username: admin

      • Password: Stored in supass. (Check ./smart-intersection/src/secrets/supass)

Access the Grafana UI using Node Port#

  • Get the Node Port Number using following command and use it to access the Grafana UI

kubectl get service smart-intersection-grafana -n smart-intersection -o jsonpath='{.spec.ports[0].nodePort}'

  • Go to http://<HOST_IP>:<Node_PORT>

    • Log in with credentials:

      • Username: admin

      • Password: admin

Access Application Services using Port Forwarding (Optional)#

Access the Application UI#

WEB_POD=$(kubectl get pods -n smart-intersection -l app=smart-intersection-web -o jsonpath="{.items[0].metadata.name}")
sudo -E kubectl -n smart-intersection port-forward $WEB_POD 443:443

  • Go to https://<HOST_IP>

    • Log in with credentials:

      • Username: admin

      • Password: Stored in supass. (Check ./smart-intersection/src/secrets/supass)

Access the Grafana UI#

GRAFANA_POD=$(kubectl get pods -n smart-intersection -l app=smart-intersection-grafana -o jsonpath="{.items[0].metadata.name}")
kubectl -n smart-intersection port-forward $GRAFANA_POD 3000:3000

  • Go to http://<HOST_IP>:<Node_PORT>

    • Log in with credentials:

      • Username: admin

      • Password: admin

Access the InfluxDB UI#

INFLUX_POD=$(kubectl get pods -n smart-intersection -l app=smart-intersection-influxdb -o jsonpath="{.items[0].metadata.name}")
kubectl -n smart-intersection port-forward $INFLUX_POD 8086:8086

Access the NodeRED UI#

NODE_RED_POD=$(kubectl get pods -n smart-intersection -l app=smart-intersection-nodered -o jsonpath="{.items[0].metadata.name}")
kubectl -n smart-intersection port-forward $NODE_RED_POD 1880:1880

Access the DL Streamer Pipeline Server#

DLS_PS_POD=$(kubectl get pods -n smart-intersection -l app=smart-intersection-dlstreamer-pipeline-server -o jsonpath="{.items[0].metadata.name}")
kubectl -n smart-intersection port-forward $DLS_PS_POD 8080:8080
kubectl -n smart-intersection port-forward $DLS_PS_POD 8555:8555

Uninstall the Application#

To uninstall the application, run the following command:

helm uninstall smart-intersection -n smart-intersection

Delete the Namespace#

To delete the namespace and all resources within it, run the following command:

kubectl delete namespace smart-intersection

What to Do Next#

Supporting Resources#