Services

A service is a containerised workload running inside an environment. Simplifyd Cloud supports two service types:

Type	Description
`docker`	Any Docker image. Configure image, tag, vCPUs, memory, replicas, and region.
`postgres`	A managed PostgreSQL cluster (backed by CloudNativePG).

The service command can be shortened to svc:

edge svc list

All service commands require a workspace, project, and environment.

list

List all services in the active environment.

edge service list
edge service list --json

Example output

SLUG     NAME      TYPE      STATUS    REGION
api      API       docker    running   us-east-1
db       Database  postgres  running   us-east-1
worker   Worker    docker    stopped   us-east-1

create

Create a new service.

edge service create --name <name> --type <type> [flags]

Required flags

Flag	Description
`--name`	Service name
`--type`	Service type: `docker` or `postgres`

Optional flags

Flag	Description
`--image`	Docker image name (e.g. `nginx`)
`--tag`	Docker image tag (e.g. `latest`, `1.25`)
`--vcpus`	Number of vCPUs
`--memory`	Memory in MB
`--replicas`	Number of replicas
`--region`	Region slug

Examples

# Docker service with custom resources
edge service create \
  --name api \
  --type docker \
  --image my-org/api \
  --tag v2.1.0 \
  --vcpus 2 \
  --memory 512 \
  --replicas 3 \
  --region us-east-1

# Managed Postgres
edge service create --name db --type postgres

get

Get detailed information about a specific service.

edge service get <slug>
edge service get api --json

Example output

FIELD         VALUE
Slug          api
Name          API
Type          docker
Image         my-org/api
Tag           v2.1.0
vCPUs         2
Memory (MB)   512
Replicas      3
Region        us-east-1
Status        running

update

Update a service's configuration. Only the flags you pass are updated.

edge service update <slug> [flags]

Flags

Flag	Description
`--name`	New service name
`--vcpus`	New vCPU count
`--memory`	New memory in MB
`--replicas`	New replica count

Example

edge service update api --replicas 5 --memory 1024

delete

Delete a service. Prompts for confirmation unless --force is passed.

edge service delete <slug>
edge service delete api --force

Flags

Flag	Description
`--force`	Skip the confirmation prompt

Deleting a service is permanent. All deployments, variables, and ingress rules for that service are also removed.

ingress

Manage ingress rules for a service. Ingress exposes a service port to the public internet via an auto-assigned FQDN (or a custom domain).

ingress add

edge service ingress add <svc-slug> --protocol <protocol> --port <port> [--custom-fqdn <domain>]

Flag	Description
`--protocol`	`http` or `grpc` (required)
`--port`	Container port to expose (required)
`--custom-fqdn`	Custom domain name (optional)

# Expose port 8080 over HTTP
edge service ingress add api --protocol http --port 8080

# Use a custom domain
edge service ingress add api --protocol http --port 8080 --custom-fqdn api.acme.com

ingress delete

edge service ingress delete <svc-slug> <ingress-slug>

edge service ingress delete api ingress-01j2k3...

Services

On this page