Helipod Docs

Deployments

Overview of deployment concepts, release controls, and rollout operations in Helipod.

Helipod keeps deployments simple for day-to-day shipping while still exposing the controls teams need for production reliability.

This page summarizes the core deployment concepts and where to configure them.

Getting started

TopicDescription
ReferenceHigh-level map of deployment settings and runtime behavior in Helipod.
Start CommandDefine how your service boots in runtime environments.
Pre-deploy commandRun setup tasks between build and release cutover.

Reference

Deployment behavior in Helipod is controlled through service source, runtime commands, health settings, and release actions. Most teams start with defaults, then refine these controls as systems mature.

Start Command

Use start command configuration when the default runtime entrypoint is not correct for your service (for example, custom process managers or alternate launch scripts).

Scaling & performance

TopicDescription
ScalingIncrease or decrease service capacity using resource sizing and replicas.
RegionsPlace workloads in regions that match user latency and data locality needs.
Performance OptimizationImprove build-to-live time and runtime responsiveness.
Serverless BehaviorConfigure idle and on-demand patterns for suitable workloads.

Scaling

Helipod supports vertical and horizontal scaling. Choose based on workload shape:

  • vertical scaling for stronger single-instance capacity,
  • horizontal scaling for throughput and resilience.

Regions

Regional placement helps reduce end-user latency and can simplify architecture choices when data dependencies are region-sensitive.

Performance optimization

High-impact optimization patterns include:

  • reducing image size,
  • tightening startup path,
  • tuning healthcheck thresholds,
  • separating latency-sensitive workloads from heavy async jobs.

Serverless behavior

For certain workloads, idle behavior can be tuned to lower cost when traffic is intermittent.

Health & reliability

TopicDescription
HealthchecksVerify service readiness and prevent unhealthy releases from serving traffic.
Restart PolicyControl restart behavior when a service exits or fails.

Healthchecks

Healthchecks provide a safety gate between deployment completion and live serving state. Configure probes that reflect real service readiness.

Restart policy

Restart policies help standardize failure recovery behavior and reduce manual intervention during transient runtime failures.

Deployment workflow

TopicDescription
Git AutodeploysTrigger builds and deployments from repository updates.
Image Auto UpdatesKeep image-based services current with controlled update behavior.
Staged ChangesReview pending changes before rollout.
Deployment ActionsPerform operational actions across deployment lifecycle states.
Deployment TeardownUnderstand cleanup behavior when deployments are replaced or removed.

Git autodeploys

Repository-linked services can deploy automatically on selected branch updates to keep delivery loops fast.

Image auto updates

For image sources, Helipod can stage new versions and apply them with approval or maintenance-window strategy.

Staged changes

Staged changes let teams inspect exactly what will be deployed before applying release actions, improving confidence and auditability.

Deployment actions

Deployment actions include common operational controls such as redeploy, rollback strategy execution, and lifecycle transitions.

Deployment teardown

When a deployment is replaced, Helipod handles teardown according to service lifecycle rules so active traffic can move safely to the healthy target.

Advanced

TopicDescription
Monorepo StrategiesDeploy only the services affected by repository-level changes.

Monorepo strategies

For monorepos, define clear service boundaries and watch paths to avoid unnecessary rebuilds and reduce deploy noise across unrelated services.

Next

How is this guide?

On this page