What you will learn in Kargo in Action
Chapter by chapter
Chapter 1: Why CI/CD isn’t enough
The chapter introduces the promotion gap between CI and CD, why it makes releases risky, and where Kargo fits.
What you learn in chapter 1 →Chapter 2: The layer nobody designed
This introduction frames Lumen Retail’s promotion layer as the unintended result of reasonable engineering decisions, rather than careless work.
What you learn in chapter 2 →Chapter 3: Getting started with Kargo
This chapter introduces the plan to install Kargo and Argo CD, model a delivery workflow, run a first promotion, and troubleshoot common failures.
What you learn in chapter 3 →Concepts explained in this book
- promotion control planeAn architectural layer that coordinates artifact advancement between environments independently of build and runtime synchronization.
- artifact promotionThe controlled advancement of an artifact version from one deployment environment to another.
- KargoKargo is an open-source, Kubernetes-native promotion control plane for governing artifact advancement across deployment environments.
- stageAn explicit environment node in a Kargo promotion progression that represents a deployment state for artifact versions.
- FreightFreight is a Kargo immutable unit representing a tracked artifact version or collection of artifact versions.
- WarehouseA Warehouse is a Kargo resource that watches artifact sources and produces Freight.
- promotion recordA promotion record is durable evidence of an artifact's advancement between deployment environments and the decisions associated with that advancement.
- progression graphA directed graph representing deployment environments as stages and the governed paths by which artifacts advance between them.
- Kubernetes controllerA control loop that observes Kubernetes resources and acts to move their actual state toward the declared desired state.
- cryptographic hashA digest is a content-derived identifier, typically a cryptographic hash, that uniquely identifies an artifact version.
- ProjectA Project is a Kargo resource that scopes delivery resources to a Kubernetes namespace and its associated access controls.
- promotion workflowAn automated sequence of steps that governs advancing an artifact between deployment environments.
- semantic version constraintA rule that selects versions according to Semantic Versioning ordering or range conditions.
- custom resource definitionA Kubernetes API extension that defines a new resource type and its schema for storing domain-specific objects.
- argocd-update promotion stepThe argocd-update promotion step is a Kargo promotion-step type that updates an Argo CD application or related deployment state.
- Argo CD applicationAn Argo CD application is an Argo CD resource that defines an application's desired state, source, destination, and synchronization behavior.
- ArgoCDArgo CD is a GitOps continuous delivery tool that continuously reconciles Kubernetes application state with version-controlled configuration.
- GitOps repositoryA GitOps repository is a Git repository whose declarative configuration represents the desired state of an environment.
- image tagA mutable human-readable label associated with a container image version in a registry.
- Kargo Promotion controllerA Kargo Kubernetes controller that executes steps for Promotion resources and records their status.
- audit trailAn audit trail is a chronological record of actions, decisions, identities, and evidence that permits operational activity to be verified.
- container imageA container image is a packaged, immutable filesystem and metadata representation used to instantiate a container.
- stage controllerA Stage controller is a Kargo controller that evaluates Freight eligibility for a Stage and manages promotion eligibility and verification.
- artifact identityArtifact identity is the information that uniquely specifies a deployable artifact version, including identifiers such as a digest and provenance data.
- build artifactAn artifact is a deployable unit produced by continuous integration, such as a container image, Helm chart, or rendered manifest bundle.
- governanceGovernance is the set of policies, controls, accountability records, and decision procedures that constrain and document operational changes.
- promotion gapA promotion gap is a lack of reliable control, traceability, and evidence connecting a validated artifact to the version running in production.
- rollbackA deployment operation that returns an environment to a previous artifact or application state.
- continuous integrationContinuous integration is the practice of automatically building and testing changes and publishing the resulting artifacts.
- GitOps operatorA system that continuously compares declared version-controlled state with actual runtime state and applies changes to reconcile them.
- provenanceA complete, queryable record of an artifact's identity, approvals, verification, and movement across environments.
- productionA production environment is the operational environment that serves software to its real users or dependent systems.
- staging environmentA pre-production environment where an application version is validated before production.
- separation of dutiesSeparation of duties is a control that distributes approval, execution, and review responsibilities among different people or roles.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.
