aenvironment-deploy

AEnvironment Deploy

Automate deployment of sandboxed environment instances and services using the AEnvironment platform.

Overview

AEnvironment provides isolated sandbox environments for running agents and applications. This skill handles the complete deployment workflow:

• Instances: Short-lived environments for agents (IP-based access, no persistence)
• Services: Long-running services for apps (domain access, optional storage, multiple replicas)

Prerequisites

Install AEnvironment CLI:

pip install aenvironment --upgrade
aenv --help

Deployment Workflows

Workflow A: Deploy with Local Image Build

Build Docker image locally, register to EnvHub, and deploy.

When to use: Creating a new environment from scratch with local Dockerfile.

Requirements: Docker installed, registry credentials configured.

Script: scripts/deploy_with_local_build.py

Example:

python scripts/deploy_with_local_build.py \
  --env-name myagent \
  --owner-name john \
  --api-service-url https://api.example.com \
  --envhub-url https://envhub.example.com \
  --registry-host registry.example.com \
  --registry-username user \
  --registry-password pass \
  --registry-namespace myteam \
  --deploy-type instance \
  --ttl 24h \
  --env-vars '{"API_KEY":"xxx"}'

Workflow B: Deploy with Existing Image

Register existing Docker image to EnvHub and deploy.

When to use: You have a pre-built Docker image to deploy.

Requirements: Existing image accessible in registry.

Script: scripts/deploy_with_existing_image.py

Example:

python scripts/deploy_with_existing_image.py \
  --env-name myagent \
  --image-name registry.example.com/myteam/agent:1.0.0 \
  --owner-name john \
  --api-service-url https://api.example.com \
  --envhub-url https://envhub.example.com \
  --deploy-type instance \
  --ttl 48h

Workflow C: Deploy Existing Environment

Deploy from already registered environment in EnvHub.

When to use: Environment is already registered, just need to deploy.