CI/CD
How Facets handles continuous deployment alongside your existing CI tools: CI Integration for Docker images, the raptor CLI, and policy-driven releases.
Overview
Facets is built to streamline Continuous Deployment (CD), ensuring that your applications and infrastructure are consistently delivered across environments with speed, reliability, and compliance.
It works alongside your existing Continuous Integration (CI) system, allowing you to continue building and testing with the tools you already use, such as GitHub Actions, GitLab CI, Jenkins, or CircleCI, while Facets manages the deployment lifecycle.
This clear separation of responsibilities enables your teams to retain flexibility in how they handle builds, while relying on Facets for automated, policy-driven deployments to cloud and Kubernetes environments.
CI Integration
A CI Integration is an entity in Facets that provides a central repository for storing and managing Docker images for a service. Facets enables users to create CI Integration with support for multiple Container Registries, including AWS ECR and other platforms like ACR, GCR, Nexus, and Docker Hub.
Facets CLI
Raptor is the Facets CLI. It drives the Control Plane from your terminal or CI job: register built images as artifacts (raptor set artifact-uri), upload zip bundles (raptor set artifact-zip), trigger and inspect releases, and download environment kubeconfigs (raptor get kubeconfig). Images are pushed to your container registry with docker push; raptor registers the resulting URI.
CI/CD workflow
Configure CI/CD strategies in Facets: branch-per-environment, single-branch promotion, and advanced custom routing across environments and release streams.
CI pipelines
Wire the raptor CLI into a CI job to authenticate, log in to your registry, build and push a container image, register it with Facets, and trigger a release.
Attach image
Attach container images to services in Facets using project CI/CD, service-specific CI/CD, or manual selection, and register or push images with the raptor CLI.
Container registries
Connect ECR, ACR, Google Artifact Registry, Nexus, Docker Hub, JFrog, and other container registries to Facets, then map them to specific projects.
Artifacts
How CI Integration in Facets stores Docker images per environment or release stream, with promotion workflows that control and audit build promotions.
Facets CLI
Raptor is the official Facets command-line interface for driving blueprints, releases, IaC modules, and CI pipelines from your terminal without the UI.
Pipeline
How the Facets delivery pipeline connects environments and controls change propagation using criteria like a successful parent release or manual sign-off.
Environment variables
Manage environment variables in Facets: migrate from .env files or parameter stores, set project-wide and resource-specific values, and handle secrets securely.
CI/CD workflow
Configure CI/CD strategies in Facets: branch-per-environment, single-branch promotion, and advanced custom routing across environments and release streams.