Skip to main content

​
What’s in a Deployment?

On Aptible, developers can deploy code, and in seconds, the platform will transform their code into app containers with zero-downtime — completely abstracting the complexities of the underlying infrastructure. Apps are made up of three components:
  • An Image: Deploy directly from a Docker image, or push your code to Aptible with git push and the platform will build a Docker image for you.
  • Services: Services define how many containers Aptible will start for your app, what command they will run, and their Memory and CPU Limits.
  • Configuration (optional): The configuration is a set of keys and values securely passed to the containers as environment variables. For example - secrets are passed as configurations.

​
Deploy Methods

​
Deploying with Git

Add a Dockerfile to your repository and push it to Aptible’s Git Remote. Aptible builds the image and deploys it for you. See Deploying with Git for Dockerfile requirements, SSH key setup, and private registry authentication.

​
Deploying with Docker Image

Build your image locally or in CI, push it to a registry, and deploy it with aptible deploy --docker-image. See Deploying with Docker Image for registry authentication and FAQs.
The Aptible Terraform provider only supports deploying via Docker Image.

​
The Deploy Process

The process is similar regardless of method:
  • You define your Services and Configuration (such as environment variables)
  • Aptible provisions the underlying infrastructure securely and reliably
For migrations or other commands that need to run before a release goes live, use .aptible.yml to define before_deploy hooks and after-success/after-failure commands.

​
Releases & Rollbacks

Every deploy, restart, configure, or scale operation launches a new Release — a new set of Containers for a Service. Services without an Endpoint deploy with zero container overlap by default; Services with an Endpoint get a zero-downtime, load-balancer-driven cutover instead. If a deployment fails, Aptible supports both:

​
Deployment Metadata

Link an App to its Source to see exactly what’s deployed where. Once linked (automatically via the Aptible Deploy GitHub Action, or manually via deployment metadata config vars), the Aptible Dashboard shows the currently-deployed revision and a full deployment history for each App.

​
Get Started

If you are just getting started, deploy a starter template.

​
Integrating with CI/CD

Aptible integrates with several continuous integration services to make it easier to deploy on Aptible—whether migrating from another platform or deploying for the first time.

Browse CI/CD integrations

How to deploy to Aptible from CI/CD