astro remote

This command is only available on Astro.

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

Description

Builds and deploys a remote client image from your Astro project to a specified remote registry. The command blocks deployment if your client image uses a newer version of Astro Runtime than the target Deployment environment to ensure compatibility.

Options

Option	Description	Possible Values
`--build-secret`	Mimics `docker build --secret` flag. Repeat the flag to mount more than one secret. Replaces the deprecated `--build-secrets` 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-secret id=mysecret,src=secrets.txt

⌘I

Overview

Install the CLI

Develop with the CLI

Configure the CLI

Release information

Archived versions

astro remote deploy

Usage

Description

Options

Examples

​astro remote deploy

​Usage

​Description

​Options

​Examples

astro remote deploy

Usage

Description

Options

Examples