Build

rio build

Build the source code as a Docker image

rio build [OPTIONS] COMMAND [ARGS]...

create

Create a new build on the Platform

rio build create [OPTIONS] BUILD_NAME REPOSITORY

Options

--strategy <strategy>

Strategy for building the Source

Options

Source | Docker

--branch <branch>

Git Repository branch

--context <context>

Context directory relative to the Git Repository root

--arch <arch>

Architecture for the Build

Options

amd64 | arm32v7 | arm64v8

--ros, --no-ros

Flag to enable ROS support

--sim, --no-sim

Flag to enable Simulation support

--ros-distro <ros_distro>

ROS Distribution to use for the Build

Options

kinetic | melodic | noetic

--dockerfile <dockerfile>

Path of Dockerfile, relative to the Context directory

--secret <secret>

Secret for the private git repository

--docker-push-secret <docker_push_secret>

Docker secret for pushing the image to an external registry.

--docker-push-repository <docker_push_repository>

External docker repository where Build will push the image.

--trigger-name <trigger_name>

Trigger name of the build

--wait <wait>

Wait for the Build to complete

Arguments

BUILD_NAME

Required argument

REPOSITORY

Required argument

delete

Delete the build from the Platform

rio build delete [OPTIONS] BUILD_NAME

Options

-f, --force

Skip confirmation

Arguments

BUILD_NAME

Required argument

import

Imports the build from the Shell context automagically

rio build import [OPTIONS] COMMAND [ARGS]...

docker

Imports the build from the current repository based on Dockerfiles

rio build import docker [OPTIONS]

Options

--arch <arch>

Architecture for the Build

Options

amd64 | arm32v7 | arm64v8

--ros, --no-ros

Flag to enable ROS support

--sim, --no-sim

Flag to enable Simulation support

--ros-distro <ros_distro>

ROS Distribution to use for the Build

Options

kinetic | melodic

--wait <wait>

Wait for the Build to complete

inspect

Inspect the build resource

rio build inspect [OPTIONS] BUILD_NAME

Options

-f, --format <format_type>
Options

json | yaml

Arguments

BUILD_NAME

Required argument

list

List the builds in the selected project

rio build list [OPTIONS]

Options

--phase <status>

Filter the Builds list by Phases

Options

BuildInProgress | Complete | BuildFailed

logs

Stream the live logs for the Build

rio build logs [OPTIONS] BUILD_NAME

Arguments

BUILD_NAME

Required argument

trigger

Trigger a build request for the build

rio build trigger [OPTIONS] BUILD_NAME

Options

--name <trigger_name>

Name for the Trigger [optional]

--tail

Tail the logs after triggering the build

Arguments

BUILD_NAME

Required argument