For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create Runtime

Step-by-step guide to creating an Agent Runtime from a container image on GreenNode AgentBase.


Prerequisites


Quick Deploy with AgentBase Skills

If you use Claude Code, Cursor, or Codex, GreenNode provides a skills kit at github.com/vngcloud/greennode-agentbase-skills β€” a set of slash commands that automate the full workflow from scaffolding to deployment in one guided flow.

Install:

# Clone skills into your project
git clone https://github.com/vngcloud/greennode-agentbase-skills .claude/skills/agentbase

Use in Claude Code / Cursor:

Skill
What it does

/agentbase-wizard

Full 9-step workflow: scaffold β†’ configure β†’ code β†’ test β†’ deploy β†’ verify

/agentbase-deploy

Build container, push image, and deploy to Runtime

/agentbase-monitor

View logs, metrics, and Runtime status

/agentbase-identity

Configure IAM Identity for your agent

Recommended for developers who want to integrate deployment into an AI-assisted coding workflow without manual Portal steps.


Create via Portal

Step 1: Open Agent Runtime β†’ click Deploy a new Agent

A popup appears to choose the agent type:

Deploy a new Agent β€” choose agent type
Type
Description

Custom Agent

Agent you code and deploy yourself β€” full control over runtime, vCR, IAM, and scaling

OpenClaw

Platform-managed agent, pre-configured by GreenNode β€” quick deploy, no runtime configuration needed

Click DEPLOY in the Custom Agent card to continue.

Step 2: Fill in the required information

Field
Example
Notes

Name

my-order-agent

Unique, lowercase, hyphens allowed

Description

Production order agent

Optional

Image URL

vcr.vngcloud.vn/<repo>/my-agent:v1

Full image path including tag

Flavor

1x1-general

1 vCPU, 1 GB RAM

Min Replicas

1

Range: 1–10

Max Replicas

1

Set >1 to enable autoscaling

CPU Threshold

50

Scale out when CPU exceeds this % (25–75)

Memory Threshold

50

Scale out when RAM exceeds this % (25–75)

Registry Auth

Enable if private

Username = robot account backendName

Environment Variables

KEY=value

Non-sensitive config only

Step 3: Configure networking (optional)

  • Private VPC: enable to deploy inside your enterprise network

Step 4: Configure Endpoint β€” AgentBase automatically creates a DEFAULT Endpoint

Step 5: Review β†’ click Create

The Runtime transitions from CREATING β†’ ACTIVE once the container starts successfully.


Create via API

Requires $TOKEN β€” an IAM bearer token. See Getting Started to obtain one.

Public registry image:

Private registry image (imageAuth required):

Poll until ACTIVE:


Service Contract

Your agent container must satisfy the following requirements to work with the Runtime:

Port and Health Check

Requirement
Value
Notes

Listen port

8080

Required β€” not configurable

Health check

GET /health

Must return HTTP 200

Using the greennode-agentbase SDK (recommended):

Without SDK (FastAPI example):

Auto-Injected Environment Variables

The Runtime automatically injects these into every container:

Variable
Description

GREENNODE_CLIENT_ID

IAM service account client ID

GREENNODE_CLIENT_SECRET

IAM service account client secret

GREENNODE_AGENT_IDENTITY

The agent identity name

Request Headers

Incoming requests to your agent include:

Header
Description

X-GreenNode-AgentBase-User-Id

End-user ID β€” use as actorId for memory operations

X-GreenNode-AgentBase-Session-Id

Session ID β€” use as thread_id for LangGraph checkpointing


Next Steps

I want to...
Go to

Stop, start, or update the Runtime

Attach a Policy Group to a Gateway

Last updated