Workflows
A Workflow in Atmosly is a configurable CI/CD pipeline that automates the process of building, testing, and deploying your application services. Workflows operate at the service level — each service within a project can have its own independent workflow.
Pipeline Stages
Every workflow consists of four sequential stages:
| Stage | Description |
|---|---|
| Source | Fetches source code from a Git repository or references a pre-built image from a container registry. |
| Build | Builds a Docker image from the source code using the specified Dockerfile, build context, and platform. |
| Push | Pushes the built image to the configured container registry (ECR, DockerHub, GCR, or GAR). |
| Deploy | Deploys the image to one or more target environments in your Kubernetes cluster. |
info
In deploy-only workflows (CD-only), the Build and Push stages are skipped. The workflow deploys a pre-built image directly from a container registry.
Pipeline Types
Atmosly supports different pipeline types depending on the workload:
| Type | Description |
|---|---|
| CI | Continuous Integration — builds and pushes the container image only. |
| App CD | Application Continuous Deployment — deploys the application service to target environments. |
| Cron CD | Deploys cron job workloads to target environments. |
| Queues & Workers CD | Deploys queue worker workloads to target environments. |
Workflow Statuses
Each workflow execution has a status that reflects its current state:
| Status | Description |
|---|---|
| Pending | The workflow is queued and waiting to start. |
| Running | The workflow is actively executing pipeline stages. |
| Succeeded | All stages completed successfully. |
| Failed | One or more stages failed during execution. |
| Error | An unexpected error occurred during execution. |
| Deployment Pending | The CI stages completed and the deployment is waiting to be triggered (manual deploy type). |
| Approval Pending | The deployment requires approval from designated approvers before proceeding. |
| Approval Rejected | An approver rejected the deployment. |
| Terminating | The workflow is being terminated by a user. |
| Terminated | The workflow was successfully terminated. |
| Termination Failed | The termination request failed — the workflow may still be running. |
Key Features
| Feature | Description |
|---|---|
| Visual Workflow Builder | Configure pipeline stages through a drag-and-drop visual interface powered by React Flow. |
| Multi-Environment Deployment | Deploy to multiple environments sequentially (e.g., Dev → Staging → Production) within a single workflow. |
| Approval Gates | Require designated approvers to approve deployments before they proceed. |
| Auto-Trigger (Webhooks) | Automatically trigger workflows on code push via GitHub, GitLab, or Bitbucket webhooks with branch matching (exact, wildcard). |
| Security Scanning | Integrate detect-secrets, Trivy vulnerability scanning, and SonarQube code quality checks. |
| Custom Scripts | Run custom shell scripts at pre-build, post-build, post-push, and post-deploy stages. |
| Build Optimization | Configure architecture (AMD64/ARM64), spot instances, build caching, and volume allocation. |
| CI Variables | Manage build-time variables with optional secret manager integration (AWS Secrets Manager, GCP Secret Manager). |
| Execution Analytics | View execution history with status breakdowns, charts, and filtering by time period. |
| Workflow Reports | Download security and quality reports (Trivy, SonarQube, detect-secrets) per execution. |
| Termination | Terminate running workflows at any time. |
Permissions
To manage workflows, your role must have the appropriate Workflow permissions:
| Permission | Description |
|---|---|
| View workflows | View workflow configurations and execution history |
| Add workflow | Create new workflows |
| Change workflow | Update workflow configurations and execute workflows |
| Delete workflow | Delete workflows |
| Add approver to workflows | Configure approval gates and assign approvers |
| Approve pipeline | Approve or reject deployment approvals |