Introduction
In this tutorial we will use a tutorial project to set up a local ECN with a set of example Microservices.
If you aren't already familiar with the core concepts of ioFog, you'll want to check out our Core Concepts section.
Prerequisites
The ioFog demo requires one of the following systems and tools to be installed. The scripts in this demo do not install any of these tools, but they check for sufficient versions.
Supported operating systems:
- Linux (kernel v3.10+)
- macOS 10.12+
Required tools:
Docker 25.00+: Open platform for developing, shipping, and running applications. (installation instructions)potctl 1.3.6+: CLI tool and a one-stop-shop for all your ioFog needs. (installation instructions)
Make sure to follow the Docker post-installation instructions so that the Docker daemon can work without sudo. Otherwise, the commands in this guide will not work.
Setup Demo Project
On Unix based systems, download our tar.gz package.
mkdir -p /tmp/iofog/demo
cd /tmp/iofog/demo
curl -L -o demo.tar.gz https://github.com/eclipse-iofog/demo/archive/v3.0.0-alpha1.tar.gz
tar -zxvf demo.tar.gz --strip-components=1
Bootstrap the Project
To get going, all we need to do is run:
./start.sh tutorial
We can optionally verify the ioFog stack is provisioned correctly. The automated tests run a smoke test suite on the ioFog stack, testing basic operations.
./test.sh
Under the hood, those shell scripts are using potctl and YAML files to set up your environment. You'll get to use potctl directly in the next few sections. Impatient to know more? Dive directly into its documentation.
Get To Know ioFog
With a working ioFog environment set up, we're now ready to get to know ioFog.
Continue To Next Step: Get To Know ioFog.
If you ran into an issue, have a question, or just want to get plugged into the community, head over to our Discussion Forum. We'd love to have you!