​
Creating Clients

To deploy a concrete config, we must first create a client to deploy to. Navigate to the Clients page page.

Click + New Client and name the client Robot 1.

​
Creating Tag Types

Now we need to create tag types and their tags to organize our clients.

Navigate to the Tags page. We’ll walk through creating three tag types:

  • deployment_env
  • region
  • robot_model

Click + New Tag Type to open the create tag type form.

Each tag type can define a metadata schema that outlines required or optional fields for all tags of that type.

We’ve provided all the metadata schemas in the tag-types directory of the getting-started repository. You can upload these schemas or define them directly in the UI.

These are the metadata schemas for each tag type:

title: deployment_env
type: object
properties:
  obstacle_avoidance_enabled:
    type: boolean
  navigation_mode:
    type: string
    enum: [conservative, balanced, aggressive]
  telemetry_upload_interval_sec:
    type: integer
    minimum: 10
    maximum: 300
required:
  - obstacle_avoidance_enabled
  - navigation_mode

Upload deployment_env.schema.yaml to create the deployment_env tag type.

Repeat this process for the region and robot_model tag types.

​
Creating Tags

Now we can create tags to categorize clients and define metadata for overrides.

Navigate to the deployment_env page and click + New Tag to create a tag.

We’ll create a tag for each tag type. Use the following values when creating your tags.

​
Tagging Clients

Let’s revisit the Clients page page. Click the + Tags button for the Robot 1 client.

Using the select tags dropdown, we’ll tag the Robot 1 client with the

  • Outdoors tag of the Deployment Environment tag type.
  • US-West tag of the Region tag type.
  • Turtlebot 4 tag of the Robot Model tag type.

Each client may only have one tag per tag type.