Skip to content

Creating robot software deployment with Robotair 🚀⿻

Estimated time to read: 3 minutes

The Deployments section of Robotair allows you to create or upload Docker Compose files for managing the deployment of services to your robots.

This section will walk you through creating a deployment and using it for over-the-air (OTA) updates.

Prerequisites⿻

  • A working ROS application (ROS/ROS 2).
  • A user account on Robotair, and access to a container registry (e.g., DockerHub).
  • Installed robotair on your robot and robot is successfully connected with robotair dashboard

1. Navigate to the Deployments Section⿻

  • Once you are logged in, head to the Deployments section and click on Create Deployment to start the process.

    image.png

2. Choose or Create a Docker Compose File⿻

  • You can either upload an existing Docker Compose file or create one directly in Robotair.
  • Provide a Name for your deployment. It’s recommended to use semantic versioning (e.g., 1.0.0, 1.1.0) for tracking different versions.
  • Upload a Local Deployment File: Choose this option to upload your own Docker Compose file if you already have one prepared. (We have not released the Assisted Deployment yet)

  • Private Container Images: If your images are stored in private container registries, don’t forget to provide the appropriate credentials in the Secrets section. For this example, we’re using public images.

    image.png

3. Review Your Deployment⿻

  • After uploading or creating your Docker Compose file, click Next.

  • Review the details of your deployment, including image names, volumes, networks, and other configurations.

    image.png

4. Create the Deployment⿻

  • After reviewing, click Create to confirm and finalize the deployment setup.

    image.png

  • You’ll be redirected to the Deployment Overview page. Here you can see all the deployments you have created.

    image.png

5. Deployment Overview⿻

  • You can open your Deployment and you will see the Deployment Overview page. Here, you can see the properties of your deployment, including:

    • Image name
    • Command
    • Ports
    • Volumes
    • Networks
    • Labels
    • Environmental Variables

    image.png

6. Assign Deployment to Robots⿻

  • From the deployment page, you can select which robots to deploy your services to.

    • You can choose multiple robots.
    • Select which services should run on each robot from the Services section.

    image.png

7. Monitor the Running Services⿻

  • Once your deployment is successfully deployed to the robots, you’ll see the list of services running on each robot.

    image.png