Get To Know ioFog
In this step of the tutorial we'll better familiarize ourselves with the ioFog environment we just set up in the previous step and iofogctl.
Check Your Environment
You can have a comprehensive view of your Edge Cloud Network (ECN) and the running docker containers by using our ./status.sh shell script.
$ ./status.shOr you can manually verify that the ioFog stack containers are correctly started. Note that it may take a minute or two for ioFog to start the tutorial microservices. The output should look like the following.
$ iofogctl get all
NAMESPACE
default
CONTROLLER STATUS AGE UPTIME IP PORT
local-controller online 1h4m 1h4m 0.0.0.0 51121
CONNECTOR STATUS AGE UPTIME IP
local-connector online 1h4m 1h4m 0.0.0.0
AGENT STATUS AGE UPTIME IP VERSION
local-agent RUNNING 1h4m 1h3m 91.178.63.198 1.3.0
APPLICATION STATUS MICROSERVICES
tutorial RUNNING Sensors, Rest API, Freeboard
MICROSERVICE STATUS AGENT CONFIG ROUTES VOLUMES PORTS
Rest API RUNNING local-agent {} 10101:80
Freeboard RUNNING local-agent {} 10102:80
Sensors RUNNING local-agent {} Rest API$ docker ps --filter "name=iofog"
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
840268cb60b4 iofog/freeboard:latest "nginx -g 'daemon of…" 2 minutes ago Up 2 minutes 0.0.0.0:10102->80/tcp iofog_yKVryMQkkxCQt8wv4Qnkpq9dXG3C4W8q
fba02fc87010 iofog/freeboard-api:latest "node /src/index.js" 2 minutes ago Up 2 minutes 0.0.0.0:10101->80/tcp iofog_tjG2LcvVkJtrzP9FHLqyGmBXptKZRxFT
b151f2e4946a iofog/sensors:latest "node /sensors/index" 2 minutes ago Up 2 minutes iofog_zL3qwCBhX9NBK4yWLjbkZY7QhKcJkChd
0789e92dd6d7 iofog/agent:latest "sh /start.sh" About an hour ago Up About an hour 0.0.0.0:54321->54321/tcp, 0.0.0.0:8081->22/tcp iofog-agent
cf378c878cdf iofog/connector:latest "sh /start.sh" About an hour ago Up About an hour 0.0.0.0:8080->8080/tcp iofog-connector
966ccd2092b8 iofog/controller:latest "sh /start.sh" About an hour ago Up About an hour 0.0.0.0:51121->51121/tcp, 0.0.0.0:8008->80/tcp iofog-controllerWe can also see that in the PORTS column some of these containers have published port mappings:
For example, there's a microservice running an instance of Freeboard, an open source visualization dashboard for IoT devices. It's running a web server that serves the dashboard.
Wait for the microservices to be in a RUNNING state. It may take a few minutes as the images need to be pulled.
watch iofogctl get microservicesGo ahead and try the web app out at http://localhost:10102/?load=dashboard.json
The Freeboard microservice doesn't know it's running locally, so it could just as well be running on real edge node hardware!
ioFog Containers
Our tutorial environment has three ioFog containers:
We can think of each of these containers as if they were deployed on separate devices. In production, our Controller is most often running on a cloud server and our Agents are each running on individual edge devices in the field. The Controller is controlling the Agent the same way it would if the devices were hundreds of miles away, and the Connector can broker communication between any microservices we run.
iofogctl vs component CLIs
We are currently in the process of migrating all our management system into one tool to rule them all: iofogctl !
However, this process is still ongoing and even though you can do everything you need for this tutorial (and much more...) in iofogctl, you must know that every ioFog component (Agent, Controller, and Connector) has its local CLI (iofog-agent, iofog-controller, and iofog-connector) that can prove itself useful.
In the following sections we will us iofogctl legacy ... commands to use the older component CLIs. Note that, because we have a local ECN, we could also use docker exec instead.
Agent's Container
Let's start by using iofogctl to retrieve a detailed description of our Agent.
$ iofogctl describe agent local-agent
apiVersion: iofog.org/v1
kind: AgentConfig
metadata:
name: local-agent
namespace: default
spec:
uuid: 62GHyYgrGrfbYfhxwk9Q8LQW34VVMtKq
name: local-agent
location: ""
latitude: -36.8486
longitude: 174.754
description: ""
dockerUrl: unix:///var/run/docker.sock
diskLimit: 50
diskDirectory: /var/lib/iofog-agent/
...Let's see how we can use the legacy iofog-agent CLI to find out its status.
$ iofogctl legacy agent local-agent status
ioFog daemon : RUNNING
Memory Usage : about 248.96 MiB
Disk Usage : about 17.91 MiB
CPU Usage : about 3.38 %
Running Microservices : 3
Connection to Controller : ok
Messages Processed : about 78,496
System Time : 23/10/2019 03:31 AM
System Available Disk : 43598.10 MB
System Available Memory : 763.71 MB
System Total CPU : 0.28 %There's also the legacy info command, used to view this Agent's settings:
$ iofogctl legacy agent local-agent info
Iofog UUID : 62GHyYgrGrfbYfhxwk9Q8LQW34VVMtKq
IP Address : 172.17.0.4
Network Interface : eth0(dynamic)
Developer's Mode : on
ioFog Controller : http://iofog-controller:51121/api/v3/
ioFog Certificate : /etc/iofog-agent/cert.crt
Docker URL : unix:///var/run/docker.sock
Disk Usage Limit : 50.00 GiB
Message Storage Directory : /var/lib/iofog-agent/
Memory RAM Limit : 1024.00 MiB
CPU Usage Limit : 80.00%
Log Disk Limit : 10.00 GiB
Log File Directory : /var/log/iofog-agent/
Log Rolling File Count : 10
Log Level : INFO
Status Update Frequency : 30
Get Changes Frequency : 60
Scan Devices Frequency : 60
Post Diagnostics Frequency : 10
Isolated Docker Containers Mode : off
GPS mode : auto
GPS coordinates(lat,lon) : -36.8486,174.754
Fog type : intel_amdController's Container
Let's list all the configured ioFog nodes using iofogctl.
$ iofogctl get agents
NAMESPACE
default
AGENT STATUS AGE UPTIME IP VERSION
local-agent RUNNING 1h26m 1h25m 91.178.63.198 1.3.0Now, let's try listing all the preconfigured ioFog nodes using the Controller CLI.
$ iofogctl legacy controller local-controller iofog list
{
"fogs": [
{
"lastActive": 1568371373399,
"daemonOperatingDuration": 5312950,
"daemonLastStart": 1568366050335,
"systemAvailableDisk": 46123114496,
"systemAvailableMemory": 890736640,
"repositoryCount": 2,
"systemTime": 1568371324278,
"lastStatusTime": 1568371365808,
"processedMessages": 149610,
"messageSpeed": 86,
"lastCommandTime": 0,
"logFileCount": 10,
"uuid": "62GHyYgrGrfbYfhxwk9Q8LQW34VVMtKq",
"name": "local-agent",
...This should give us a JSON response containing a list of edge nodes already registered with the Controller. In our case we should get a single node, "name": "local-agent". This "node" is the container environment of iofog-agent. Remember that in production, instead of being containers running locally on our machine, these nodes would be real edge hardware as part of our Edge Compute Network (ECN), where our microservices run.
Manage Our Microservices
Now that we know our way around a bit, let's learn how to manage and launch microservices!
