DocsLifecycle schemaDocker Service

Docker Service

Deploy pre-built Docker images for databases, caches, and other infrastructure components.

The docker Service deploys a pre-built Docker image. Lifecycle does not build source for this Service type.

The examples use AWS-style cloud-secret references. Replace them with a provider and path from your Lifecycle operator. Do not commit passwords to lifecycle.yaml.

Examples

PostgreSQL database (internal only):

For other Services:

Field reference

Required fields

FieldTypeDescription
dockerImagestringDocker image name, for example, postgres or redis
defaultTagstringImage tag, for example, 15-alpine or 7-alpine

Optional fields

FieldTypeDescription
commandstringOverride container entrypoint
argumentsstringArguments passed to the command. Use %%SPLIT%% for spaces
envobjectEnvironment variables
portsarrayExposed container ports
deploymentobjectDeployment configuration. See the Deployment options section.
envLensbooleanEnable the Environment Lens ingress banner

Deployment options

The deployment section configures how Lifecycle deploys the Service to Kubernetes. All fields are optional.

See GitHub Service deployment options for information about each field.

FieldDescription
publictrue = creates ingress, false = internal only
capacityTypeNode type: SPOT (default) or ON_DEMAND
resourceCPU and memory requests/limits
readinessHealth check using httpGet or tcpSocketPort
hostnamesCustom hostname configuration. Lifecycle generates hostnames if omitted
networkIP whitelist, port mapping, gRPC support
serviceDisksPersistent volume mounts

public: false keeps a database or cache internal to the cluster.

For a database or cache that needs only cluster access, set public: false.

⚠️

Use SPOT or ON_DEMAND. Other spellings can prevent workload scheduling.

Typical images

Databases

Caches and queues