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.

View as Markdown

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

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

Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token and informing the name of the service being created:

curl --location 'https://api.azionapi.net/edge_services/' \

--header 'Accept: application/json; version=3' \

--header 'Authorization: Token [TOKEN VALUE]' \

--header 'Content-Type: application/json' \

--data {

"name": "Azion CLI Installation"

}

Keep the ID of the edge service you’ve just created. You can access it in the response body, for example:

{

"id": 1196,

"name": "Azion CLI Installation",

"updated_at": "2024-01-18T17:24:33Z",

"last_editor": "xxxxx",

"active": false,

"bound_nodes": 0,

"permissions": [

"read",

"write"

]

}

When running the request in the terminal, the response might not return formatted as presented on the example above.

Run the following PATCH request in your terminal to set the service as active, replacing [TOKEN VALUE] with your personal token:

curl --location --request PATCH 'https://api.azionapi.net/edge_services/:id' \

--header 'Accept: application/json; version=3' \

--header 'Authorization: Token [TOKEN VALUE]' \

--header 'Content-Type: application/json' \

--data {

"active": true,

"name": "Azion CLI Installation",

"variables": [

{

"name": "string",

"value": "string"

}

]

}

If an edge service isn’t set as active, it isn’t available for binding to an edge node.

Creating a resource

Inside the service you’ve just created, called Azion CLI Installation, go to the Resources tab.
Click on + Resource.
Enter /scripts/install-cli in the Path field.
Choose the type Shell Script.
Choose the trigger Install.
Add the following content to the Content block:

#!/bin/bash

# Define the URL of the binary to download

BINARY_URL="https://github.com/aziontech/azion/releases/download/1.10.2/azion_1.10.2_linux_arm64.deb"

# Download the binary

wget $BINARY_URL -O /tmp/azion.deb

# Install the binary

# This assumes that you have dpkg installed on your system

sudo dpkg -i /tmp/azion.deb

# Clean up the downloaded binary

rm /tmp/azion.deb

echo "Installation completed successfully"

Click the Save button.

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

Run the following POST request in your terminal:

curl --location 'https://api.azionapi.net/edge_services/:id/resources' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"content_type": "Shell Script",

"name": "/scripts/install-cli/",

"content": #!/bin/bash

# Define the URL of the binary to download

BINARY_URL="https://github.com/aziontech/azion/releases/download/1.10.2/azion_1.10.2_linux_arm64.deb"

# Download the binary

wget $BINARY_URL -O /tmp/azion.deb

# Install the binary

# This assumes that you have dpkg installed on your system

sudo dpkg -i /tmp/azion.deb

# Clean up the downloaded binary

rm /tmp/azion.deb

echo "Installation completed successfully"

}

Replace [TOKEN VALUE] with your personal token, :id with the ID of the edge service and inform the following parameters in the request body:

Property	Description	Required
`content_type`	Content type of the resource being created	Yes
`name`	Name of the resource being created	Yes
`content`	Content that defines actions performed when the resource state changes in the edge node	Yes

Binding an edge service to an edge node

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

Run the following GET request in your terminal, replacing [TOKEN VALUE] with your personal token and retrieve the edge node ID you wish to bind to an edge service:

curl --location 'https://api.azionapi.net/edge_nodes/' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'

Run the following POST request in your terminal:

curl --location 'https://api.azionapi.net/edge_nodes/:id/services' \

--header 'Accept: application/json; version=3' \

--header 'Authorization: Token [TOKEN VALUE]' \

--header 'Content-Type: application/json' \

--data {

"service_id": :id,

"variables": [

{

"name": "string",

"value": "string"

}

]

}

Replace [TOKEN VALUE] with your personal token, :id with the ID of the edge node and inform the ID of the service in the request body:

Property	Description	Required
`service_id`	ID of the edge service being bound to the edge node	Yes
`variables`	Variables to be replaced during the processing on the edge node	No (requires checking)

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:

Azion CLI 1.10.2

DESCRIPTION

The Azion Command Line Interface is a unified tool to manage your Azion projects and resources

SYNOPSIS

azion <command> <subcommand> [flags]

EXAMPLES

azion

azion -t azionb43a9554776zeg05b11cb1declkbabcc9la

azion --debug

azion -h

...

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