Building an IOx Application with Docker

Objective

In this lab you can learn to code, deploy, and test a Python Application to an IOx-enabled device in the DevNet Sandbox using the ioxclient Docker packaging.

Completion time: 35 minutes

Prerequisites

DevNet Account

A DevNet account will be necessary for accessing the required resources and Sandbox. If you don't already have an account, you can create one quickly here using this link.

Docker Platform

To create a Docker image and push it to the Docker Hub, you will need the correct Docker tools for your platform which are available at https://www.docker.com/products/overview. Download and install the correct version for your operating system.

Cisco AnyConnect Client

To access the DevNet Sandbox, you will need to use the Cisco AnyConnect Client for Virtual Private Network (VPN) access to the IOx instance. If you need to install it, you can find it at this link.

Note: If you are working on a DevNet Lab workstation, this software is already installed.

ioxclient

You will need the ioxclient to package and deploy the IOx Application. If you need to download it, you can find it at this link.

Note: The DevNet lab workstations may have the ioxclient utility already installed. You can verify the installation of the ioxclient by opening a command prompt and running:

ioxclient --version

Postman (Optional)

Postman is a tool to investigate, test, and utilize HTTP APIs. If you need to download it, you can find the correct version for your platform at https://www.getpostman.com/

Note: The DevNet lab workstations may have the Postman application already installed.

git (Optional)

One way to get the application template code is to use git. We have the option to download the code, so this step is optional. If you are working on a DevNet Lab workstation, the git software is already installed. If you need to install it, you can find it at this link.

Note: You can verify the installation of git by opening a command prompt and running:

git --version

Step 1 : Overview

Once you have verified the Prerequisites, to complete this lab you will:

  • Reserve an IOx Sandbox instance
  • Create a small IOx Application to run on the Sandbox IOx device
  • Package the IOx Application with the ioxclient Docker tools
  • Connect to the DevNet Sandbox
  • Deploy the IOx Application
  • Monitor and review the IOx Application
  • Test the output of the IOx Application