Open Source Application Deployment

How to deploy open source applications on Catalyst 9000

Learn about app hosting of open source application such as iPerf3, TRex Traffic Generator, and AWS Greengrass using Docker image on Catalyst 9000.

Application Hosting supports open source applications for a wide variety of use cases. Browse open source applications to host on Cisco Catalyst 9000. You can deploy open source applications that have been built with Docker and saved as tarball (.tar) files.

Step 1: Generate .tar file of Docker application

Follow these instructions to create a tarball file.

1. Navigate to the application's site (for example, https://hub.docker.com/r/mlabbe/iperf3) and use the developer's instructions to pull the Docker image

   docker pull <image>
   

2. Save the image as a tarball.

   docker save <image> -o <image>.tar
   

Step 2: Deployment

Follow these instructions to deploy an application from a tarball.

1. Copy the downloaded Docker tarball to usbflash1.

2. Install the application from usbflash1:

   app-hosting install appid <appname> package usbflash1:<path to tar file>
   

3. Activate the application with pre-configured resources:

   app-hosting activate appid <appname>
   

4. Start the app:

   app-hosting start appid <appname>
   

The following sections include application-specific instructions for iPerf3, TRex Traffic Generator, and AWS Greengrass.