Aptible PaaS logoDocs

Deploying Apps

Aptible uses the following inputs to deploy Apps as one or more Containers across a fleet of instances (these instances form your Stack):

  • An Image: You provide the image used to run an App using Dockerfile Deploy or Direct Docker Image Deploy
  • Services (optional): Services to define the number of Containers for an App and what each Container should do
  • Configuration (optional): The configuration is a set of keys and values securely passed to the Containers as Environment variables. Secrets can be passed using Configuration.

Deploy Code in the Dashboard

The Deploy Code button in the Aptible Dashboard is the quickest way to deploy code to a new Environment. This process will guide you through the following steps:

  1. Setup an SSH Key: Authenticate with Aptible by setting up your SSH key (if you haven't done so already).
  2. Create a new Environment: Set up a new Environment where your resources will reside.
  3. Select App Type: Choose the type of App you want to deploy, whether it's from our starter templates, the Aptible demo App, or your own custom code.
  4. Push your code: Deploy your code to Aptible using a git push
  5. Create Databases (optional): Create and configure managed Database(s) for your App
  6. Set and configure your App with environment variables (optional): Customize your App by setting and configuring variables
  7. Set Services and Commands (optional): Fine-tune your App's Services and Commands
  8. View Logs: Track the progress of your resources as they deploy conveniently within the Dashboard
📘 This method uses Dockerfile Deploy to deploy. This means Aptible builds an Image on your behalf.

Creating an App

Apps can be created/provisioned using one of the following methods:

  • Using the Deploy Code button will automatically create a new App in a new Environment
  • Using the Aptible Dashboard by navigating to the respective Environment > selecting the "Apps" tab > selecting "Create App"

❗️Apps handles cannot start with "internal-" because applications with that prefix cannot have Endpoints allocated due to an AWS limitation.

Deploying 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:

📘 If your team already uses a Git-based deployment workflow, deploying your App to Aptible should be relatively straightforward.

Guides & Examples:

Next steps


Keep reading: