astro remote

This command is only available on Astro.

Known issue in Astro CLI 1.38.0 (resolved in 1.38.1)Astro CLI 1.38.0 installs Remote Execution Agent Python and system dependencies from requirements.txt and packages.txt instead of requirements-client.txt and packages-client.txt when you run astro remote deploy. As a result, dependencies meant for the client may not be installed on the Remote Execution Agent as expected. Upgrade to Astro CLI 1.38.1 or later to resolve this issue.

The astro remote command group enables workflows for building and deploying remote client images as part of Remote Execution Deployments.

astro remote deploy

Builds and deploys a remote client image from your Astro project to a specified remote registry.

Usage

astro remote deploy

Options

Option	Description	Possible Values
`--build-secrets`	Mimics `docker build --secret` flag. See Build Secrets for more information.	String array Example input: `id=mysecret,src=secrets.txt`
`-h`, `--help`	Help for the command.	N/A
`-i`, `--image-name`	Name of a custom image to deploy, or image name with custom tag. The image must be present on the local machine.	String (image name)
`--platform`	Target platform for client image build. Defaults to host machine platform.	String. For example, `linux/amd64` or`linux/arm64`

Examples

Deploy with a specific platform:

$ astro remote deploy --platform linux/amd64,linux/arm64

Deploy a pre-built image:

$ astro remote deploy --image-name my-custom-image:tag

Deploy with build secrets:

$ astro remote deploy --build-secrets id=mysecret,src=secrets.txt

Overview

Install the CLI

Develop with the CLI

Configure the CLI

Release information

Archived versions

astro remote deploy

Usage

Options

Examples

​astro remote deploy

​Usage

​Options

​Examples

astro remote deploy

Usage

Options

Examples