Logo

Command Palette

Search for a command to run...

Stacks are the core organizational unit in Cloud 66, representing a complete application environment including servers, services, databases, and configurations.

Model
uidstring

The unique identifier of the stack.

namestring

The display name of the stack.

account_idinteger

The ID of the account that owns this stack.

gitstring

The git repository URL associated with the stack.

git_branchstring

The git branch or reference being deployed.

environmentstring

The environment name for this stack (e.g., production, staging, development).

cloudstring

The cloud provider name or "no_cloud" for BYOS stacks.

fqdnstring

The fully qualified domain name for the stack.

languagestring

The primary programming language of the stack.

frameworkstring

The framework used by the stack (e.g., rails, nodejs, docker).

statusinteger

The current status code of the stack.

healthinteger

The current health state code of the stack.

last_activitystring

The date and time of the last activity on the stack.

last_activity_isodatetime

The date and time of the last activity in ISO 8601 format.

maintenance_modeboolean

Whether the stack is currently in maintenance mode.

has_loadbalancerboolean

Whether the stack has a load balancer configured.

created_atdatetime

The date and time the stack was created, in ISO 8601 format.

updated_atdatetime

The date and time the stack was last updated, in ISO 8601 format.

deploy_directorystring

The deployment directory path on the servers.

cloud_statusstring

The status of cloud resources for this stack.

backendstring

The backend type for the stack.

versionstring

The implementation version of the stack.

revisionstring

The current stack revision number.

is_busyboolean

Whether the stack is currently performing an operation.

account_namestring

The friendly name and email of the account owner.

is_clusterboolean

Whether this stack is a Kubernetes cluster.

is_inside_clusterboolean

Whether this stack is deployed inside a cluster.

cluster_namestring

The name of the cluster this stack belongs to, if applicable.

application_addressstring

The main application address for accessing the stack.

configstore_namespacestring

The UUID namespace for the stack's configuration store.

namespacesarray

For Kubernetes stacks, the list of namespaces used.

considerationsobject

Important considerations or warnings about the stack state.

redeploy_hookstring

The webhook URL for triggering redeployments (when exposed).

Example

{
  "uid": "stack-550e8400-e29b-41d4-a716",
  "name": "my-production-app",
  "account_id": 12345,
  "git": "git@github.com:mycompany/myapp.git",
  "git_branch": "main",
  "environment": "production",
  "cloud": "aws",
  "fqdn": "myapp.example.com",
  "language": "ruby",
  "framework": "rails",
  "status": 1,
  "health": 3,
  "last_activity": "2024-02-15 14:30:00 UTC",
  "last_activity_iso": "2024-02-15T14:30:00Z",
  "maintenance_mode": false,
  "has_loadbalancer": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-02-15T14:30:00Z",
  "deploy_directory": "/var/deploy/myapp",
  "cloud_status": "deployed",
  "backend": "kubernetes",
  "version": "4",
  "revision": "42",
  "is_busy": false,
  "account_name": "Production Team (team@example.com)",
  "is_cluster": false,
  "is_inside_cluster": true,
  "cluster_name": "production-cluster",
  "application_address": "https://myapp.example.com",
  "configstore_namespace": "550e8400-e29b-41d4-a716-446655440000",
  "namespaces": [
    "myapp-production",
    "myapp-staging"
  ],
  "considerations": {
    "warnings": [],
    "notices": [
      "Stack is healthy"
    ]
  },
  "redeploy_hook": "https://hooks.cloud66.com/stacks/redeploy/abc123def456"
}
Edit this page