How to run scripts on edge nodes

Learn how to configure and install Azion CLI on edge nodes using Shell Script resources via Azion Console and API, including service binding and setup.

Last updated

View as Markdown Agent setup

To be able to orchestrate services on your device, you must configure all the resources needed to install, uninstall, and reload your services.

This guide presents how to install Azion CLI on your edge nodes through a resource of the type Shell Script configured on a specific edge service.

Requirements

  • An edge node with Orchestrator Agent installed and authorized.
  • The Dpkg package manager installed on this node.
Go to how to install Orchestrator agent Go to how to authorize an edge node

You can find the download links to the respective architectures on Azion CLI’s releases page. You must choose the correct download link based on the architecture of your edge node and replace the BINARY_URL in the script with the correct URL.

Creating an edge service

  1. Access Azion Console.
  2. On the upper-left corner of the page, open the Products menu, represented by three horizontal lines, and then select Edge Services.
  3. Click on the + Service button.
  4. Name this service Azion CLI Installation.
  5. Enter the variables and values for the resource, if necessary.
  6. Set the status as Active.
  7. Click the Save button.

Creating a resource

  1. Inside the service you’ve just created, called Azion CLI Installation, go to the Resources tab.
  2. Click on + Resource.
  3. Enter /scripts/install-cli in the Path field.
  4. Choose the type Shell Script.
  5. Choose the trigger Install.
  6. Add the following content to the Content block:
Shell
01#!/bin/bash
02
03# Define the URL of the binary to download
04BINARY_URL="https://github.com/aziontech/azion/releases/download/1.10.2/azion_1.10.2_linux_arm64.deb"
05
06# Download the binary
07wget $BINARY_URL -O /tmp/azion.deb
08
09# Install the binary
10# This assumes that you have dpkg installed on your system
11sudo dpkg -i /tmp/azion.deb
12
13# Clean up the downloaded binary
14rm /tmp/azion.deb
15
16echo "Installation completed successfully"
  1. Click the Save button.

This script will install the Azion binary in the following path: /usr/local/bin

Binding an edge service to an edge node

  1. On the upper-left corner of the page, open the Products menu, represented by three horizontal lines, and then select Edge Nodes.
  2. Select the edge node to which you want to bind a service.
  3. Go to the Services tab and click the + Service button.
  4. Choose the service Azion CLI Installation you’ve created.
  5. Click the Save button.

Accessing Azion CLI

After this process, in your edge node, access the folder:

cd /usr/local/bin

Run:

./azion -h

The output will be similar to:

Shell
01Azion CLI 1.10.2
02
03DESCRIPTION
04 The Azion Command Line Interface is a unified tool to manage your Azion projects and resources
05
06SYNOPSIS
07 azion <command> <subcommand> [flags]
08
09EXAMPLES
10 azion
11 azion -t azionb43a9554776zeg05b11cb1declkbabcc9la
12 azion --debug
13 azion -h
14...

Check the Azion API documentation and the OpenAPI specification to know more about all features available via API.