liveBook · Manning

Repository

As explained in Platform Engineering on Kubernetes

A Git repository is a version-controlled storage location containing project files and their revision history.

A Git repository stores project source code and its revision history, then connects developer changes to automated build, packaging, deployment, and environment-management workflows. section 3.4.2 section 4.2

A repository supports several operational responsibilities:

  • Triggers service pipelines through webhooks when changes are merged into the main branch. section 3.4.2
  • Carries the files needed to build and deploy a service, including source code, a Dockerfile or image-building method, and Kubernetes manifests. section 3.4.2
  • Organizes services either together in one repository or separately, affecting webhook filtering, pipeline definitions, access management, and reuse. section 3.6
  • Acts as the source of truth for environment configurations that declare deployed services and their versions. section 4.1

Service and environment repositories

A service repository can contain a src directory, Dockerfile, and Kubernetes deployment configuration. After a release is published, an environment repository can be updated to point staging or production at the released service version. Argo CD can monitor that configuration and synchronize it with a live cluster. section 3.4.2 section 4.1 section 4.2

Figure 3.6 The service source code repository needs to have all the configurations for the service pipeline to work.

Use the repository layout to inspect how service source, container-building configuration, and deployment configuration give a pipeline the inputs it needs. section 3.4.2

How Platform Engineering on Kubernetes covers it

How deep it goes
Explains repository contents, webhook triggers, organizational choices, and GitOps synchronization, but stops short of Git internals.
Examples
Uses src directories, Dockerfiles, Kubernetes manifests, environment configurations, webhooks, and Argo CD synchronization as concrete artifacts.
What you can do after
Configure service and environment pipelines around repository changes, deployment inputs, version declarations, and GitOps synchronization.
How it connects
Connects repositories to service pipelines, environment pipelines, webhooks, Kubernetes, container registries, Helm, GitOps, and Argo CD.

Also explained in

Compare how 10 books explain repository →

Related concepts

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