v2
What's New in ioFog 2?Core ConceptsArchitectureQuick Start With Local DeploymentQuick Start On Minikube and Vagrant
iofogctl - ioFog Unified Command Line InterfaceDownload And Install iofogctlGetting Familiar With iofogctliofogctl Resource ManagementConnecting To Existing Edge Compute NetworksLegacy Commands in iofogctl
IntroductionPrepare NetworkPrepare Remote HostsRemote - Deploy Control PlaneKubernetes - Prepare A ClusterKubernetes - Deploy Control Plane Using iofogctlKubernetes - Deploy Control Plane Using HelmSetup Agents
IntroductionAgent ConfigurationAttach / Detach an AgentVolume ManagementDocker Image Pruning
Writing MicroservicesioFog SDKDebugging
IntroductionGet To Know ioFogManage Our MicroservicesCreate Our First Microservice - JavaScriptDeploy Our Microservice
Distributed ApplicationsMicroservice Public PortsMove and Rename MicroservicesMicroservice Updates and LifecycleMicroservice Registry and Catalog ManagementMicroservice Logs
Kinds of ResourcesControl Plane YAML SpecificationAgent configuration YAML SpecificationApplication YAML SpecificationRoute YAML SpecificationCatalog Item YAML SpecificationRegistry YAML Specification
OverviewLegacy Controller CLI UsageController REST API Reference
OverviewLegacy Agent CLI UsageAgent Local API ReferenceAgent ConfigurationsRemote debugging using IntelliJ
System: Diagnostics MicroserviceSystem: Hardware Abstraction Layer MicroserviceSystem: Bluetooth REST API MicroserviceJSON REST API And Open Weather Map Microservices
Contributing GuidelinesCode of Conduct

Introduction

In this tutorial we will use a tutorial project to set up a local ECN with a set of example Microservices.

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:

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/v2.0.4.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

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.