Getting started

Let’s start deploying your first application on your device with SPEKTRA Edge. Here is the summary of the process:

1. Setting up your Raspberry Pi device and bringing it online on the SPEKTRA Edge dashboard.
2. Deploying a Nginx application on the device.
3. Verifying your application through the SPEKTRA Edge dashboard.

Once you’ve completed this guide, you’ll gain the fundamental knowlege how to deploy your applications on your device with SPEKTRA Edge platform.

What you need

• Raspberry Pi device. Please check our supported devices in case you need to use other devices.
• A tool to flash the SPEKTRA Edge OS on the device, e.g. Etcher OS image flasher.
• An access to the SPEKTRA Edge dashboard

And also, the cuttle CLI command is necessary to complete this guide, which is used to access the Nginx application from the local machine for the verification purpose. However, it is not required for deploying applications on SPEKTRA Edge.

Create a project

Let’s first create a project, which manages the group of devices. It’s the one stop shop to deploy and manage your devices and applications in an unified fashion.

To create your first project, log into your SPEKTRA Edge dashboard and click Create project on your right.

Enter a project name and the region close to your devices, and click Create:

You’ll then be redirected to the summary of projects, which you can select one you just created and add your first Raspberry Pi.

Add a device and download OS

SPEKTRA Edge builds a custom SPEKTRA Edge OS image configured for the Raspberry Pi device, which allow it to be provisioned for SPEKTRA Edge platform in the later stage.

Start by clicking Add device on the project overview and select Download bootable OS with default configuration option under the register devices section.

Select the device type as Rasberry Pi 4/5 with the supported OS version. Click Download once you give the root login password.

Device provisioning

Now, let’s flash the downloaded SPEKTRA Edge OS image to the device.

Here is the steps to follow to flash the OS image and boot the device:

• SD card
• On-board eMMC

Once it’s connected to the network, the new device should be shown as online and you should be able to develop application on it.

Let’s check the device serial number and other device information to double check if it’s the correct device. Click the name of the device to go to the Device overview page.

Here, you can check the device information including:

• Device status
• Device type
• OS version
• Device serial number
• IP addresses

Now, let’s set the device name for easy reference. Select the Edit details option of the Device overview pull-down menu shown by hovering to the vertical triple dots right next to the Device overview page title.

Let’s deploy your first application on this device.

Deploy your application

Now the device is ready, let’s deploy a Nginx application on your device.

SPEKTRA Edge provides the docker compose environment on your device so that the applications can be declared and deployed through the standard docker compose file format.

First, click the Deploy pod on the project overview page.

Select Deploy on a single device option and provide the following information:

1. Application name
2. Application description
3. Docker compose file

   services:
     app:
       image: nginx:latest
       ports:
       - 8080:80

4. Target device to deploy

Then, click Deploy to deploy your first application.

Congratulations. You just deployed the first application on your device through SPEKTRA Edge!

Verify your application

Now check the application through the applications overview page.

Here, you can see the application you just deployed successfully running on your device.

Click the application name on the page above and scroll down to the Logs section of the application detail page to check the application logs by clicking the Start button.

Here you can see your application successfully running on your device.

Accessing your application

You can access your application from your local machine with the SPEKTRA Edge port-forwarding feature.

Go to the application page and copy the port-forward command located under the Docker compose section.

Open the terminal on your local machine. Paste the command you just copied onto your terminal and run it to enable the port-fowarding to access your application from the local machine.

Here is the example port-forward command for your reference. It enables your application, which is listening on device’s port 8080, reachable through your local machine’s port 8080.

cuttle devices forward-port \
  projects/your-project/regions/us-west2/devices/raspberry-pi-5 \
  8080 tcp://127.0.0.1:8080

With the above port-forwarding command running, point your browser to http://localhost:8080 to access your application from your local machine.

Next steps

Great job! You successfully deployed and verified your first application running on your device with SPEKTRA Edge.

Please note that you can scale this process to 100+ or 1,000+ devices through the SPEKTRA Edge platform. Explore the following learning materials to make it a reality.

• Develop an application which runs on your devices through the SPEKTRA Edge platform.
• Deploy the application to your device through the SPEKTRA Edge dashboard.
• Manage and monitor your applications through the SPEKTRA Edge dashboard.

Let’s learn more about the SPEKTRA Edge way to develop and deploy your applications on the edge!