liveBook · Manning

Container image

As explained in Kargo in Action

A container image is a packaged, immutable filesystem and metadata representation used to instantiate a container.

A container image packages an immutable filesystem and metadata for instantiating a container. In a delivery workflow, a registry holds images that can be discovered and promoted between environments. section 3.0 section 3.5

For demo-app, version 1.1.0 is pushed to a registry, selected by a semver constraint, and pinned by digest in a Freight. A Promotion updates the dev GitOps overlay; Argo CD then reconciles the change, and a pod pulls the image. section 3.5

Figure 3.3 End-to-end promotion of the demo-app image, from the container registry to a running pod in the demo-dev namespace. The six lettered steps, A through F, mark the boundary between layers. Kargo owns steps A through D; Argo CD owns steps E and F. The Warehouse and Stage are Kargo resources living in the cluster; the GitOps repository and the Argo CD Application are infrastructure Kargo writes to but does not own. The Freight object is the lineage record that ties the whole chain together.
End-to-end demo-app promotion flow

Trace the image from registry discovery through Git commit to a running pod, with the boundary between Kargo and Argo CD marked. section 3.5

How Kargo in Action covers it

How deep it goes
Follows registry selection, digest pinning, and GitOps promotion through deployment, while distinguishing Kargo’s work from Argo CD reconciliation.
Examples
Uses demo-app image versions 1.0.0 and 1.1.0 in a dev-to-staging-to-production promotion.
What you can do after
Apply a Kargo promotion workflow to advance a registry image and let Argo CD reconcile the resulting change.
How it connects
Connects images with container registries, semantic version constraints, Freight, promotion, GitOps, and Argo CD.

Also explained in

Compare how 32 books explain container image →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Kargo in Action. The section links point to the parts of the book it draws on.