Overview

This quick-start guide walks through deploying your first configuration with Miru. Here’s what we’ll cover: If you don’t already have an account, navigate to the sign-up page and follow the instructions.

​

Concepts

To begin, let’s define the primary concepts in Miru.

​

Config instances

A config instance, also known as a config or an instance, is a set of parameters used to modify the behavior of code. Config instances are stored as JSON files, which applications parse into a structured format for consumption.

​

Config schemas

A config schema defines the structure, types, and constraints of a config instance. It serves as a contract between code and configuration, ensuring that config instances are valid before being deployment to devices.

​

Config types

A config type represents a logical grouping of parameters used by your robot’s software. It consists of

1. The config instances in its domain (the actual parameters deployed to devices)
2. A versioned config schema, which defines the structure and constraints for those instances

For example, a Mobility config type houses configs related to the robot’s motion while a Perception config type houses configs related to the robot’s perception. Each config type has its own versioned schema, which its config instances must adhere to depending on the release they are deployed under.

​

Devices

A device is a machine to which config instances are deployed. This could be an NVIDIA Jetson, Raspberry Pi, industrial PC, or any other computer running your robot’s application.

​

Releases

A release is a version of software and its compatible config schemas. Within a fleet of robots, multiple software versions may be deployed — each release defines which config schemas are valid for that version. For example, software release v1.7.0 might specify the following schemas: Before deploying config instances to a device, the deployment’s release (v1.7.0) is used to verify that all required config instances are present and that each instance complies with the release’s schemas.

​

Deployments

A deployment is a set of config instances delivered to a device for consumption by your software. Deployments tie together config instances, releases, and devices to simplify configuration management and delivery.