Skip to content

Deliver Overview

How everyday delivery input, lifecycle, and resources fit together.

Updated View as Markdown

Short definition

“Everyday delivery” is the whole chain from a code or artifact change to a running, reachable, rollback-ready deployment. It brings together Configuring Deployment Sources, Deployment Lifecycle, Projects and Resources, the runtime/health/network Profiles, and GitHub And Integrations.

flowchart LR
    subgraph Input
        SRC[Deployment source]
        PROF[Profile\nruntime/health/network]
    end
    subgraph Organization
        PRJ[Project]
        RES[Resource]
    end
    SRC --> DEP[Deployment]
    PROF --> DEP
    PRJ --> RES --> DEP
    DEP --> LIVE[Running app]
    LIVE -. failure .-> REC[Rollback / recovery]

Why this group exists

In the previous information architecture, “Deploy,” “Projects And Resources,” and “Integrations” were three separate groups, but in practice they almost always show up together — someone configuring a source is usually already configuring runtime and network profiles too. This content is merged into “Deliver” so you don’t have to jump across multiple navigation groups to solve one class of problem.

Where you see it in Web, CLI, and API

  • Web — the resource detail page puts Source, Runtime, Health, Network configuration, the deployment timeline, and preview environments on different tabs of the same page.
  • CLIappaloft deploy, appaloft resource configure-*, and the appaloft deployments * command family share the same business operations.
  • HTTP/API — the /api/deployments and /api/resources/{id}/* routes reuse the same input schema; no entrypoint gets its own private fields.

Common mistakes

  • Treating a “deployment” as a long-lived configuration container — a deployment is actually one attempt; long-lived configuration lives in a Resource’s Profile, see Product Mental Model.
  • Treating GitHub/provider/plugin integrations as unrelated “settings” — they directly decide your deployment source and execution boundary, see GitHub And Integrations.

Advanced details

When a deployment fails, first figure out which lifecycle phase it’s stuck in (detect / plan / execute / verify), and only then decide whether to fix the Source, the Profile, or go through Rollback And Recovery. Diagnosing phase by phase finds the root cause faster than “just click deploy again.”

Navigation

Type to search…

↑↓ navigate↵ selectEsc close