Reference implementation of the Cloud Native Buildpacks lifecycle
Go to file
Jesse Brown 0f224448e5
Merge pull request #1534 from buildpacks/dependabot/go_modules/github.com/go-viper/mapstructure/v2-2.4.0
Bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0
2025-08-21 12:37:38 -05:00
.github Merge pull request #1528 from buildpacks/dependabot/github_actions/actions/download-artifact-5 2025-08-12 14:38:56 -05:00
.vscode Update settings.json 2021-05-19 15:44:16 -05:00
acceptance Update to Go 1.24.6 2025-08-12 08:55:13 -05:00
api Restore cached launch layers not found in `appLayers` (#1346) 2024-07-03 10:04:57 -04:00
archive restoring archive/tar_windows.go 2025-04-20 18:39:44 -05:00
auth Fix auth by wrapping keychain in a ResolvedKeychain 2024-04-10 10:48:33 -04:00
buildpack fixup! Send stdout and stderr to the same stream (build and generate) 2025-08-11 09:53:26 -05:00
cache Update linter 2025-02-28 12:03:32 -06:00
cmd bump imgutil 2025-05-28 10:00:00 -05:00
env Remove Windows Support 2024-12-10 16:56:29 -06:00
image bump imgutil 2025-05-28 10:00:00 -05:00
internal Replace GoogleContainerTools/kaniko with chainguard-dev/kaniko 2025-06-26 09:37:01 -05:00
launch removing the os build constraint and moving the linux implementation into exec_d 2025-04-16 15:08:45 -05:00
layers Remove Windows Support 2024-12-10 16:56:29 -06:00
log code lint 2025-04-16 14:47:09 +02:00
phase Remove Windows Support 2024-12-10 16:56:29 -06:00
platform code lint 2025-04-16 14:47:09 +02:00
priv Remove Windows Support 2024-12-10 16:56:29 -06:00
testhelpers bump imgutil 2025-05-28 10:00:00 -05:00
tools Update to Go 1.24.6 2025-08-12 08:55:13 -05:00
.dockerignore Add ability to export Windows-based images 2020-06-26 11:15:41 -07:00
.gitignore Support insecure registries (#1140) 2023-09-22 12:29:58 -04:00
.gitpod.yml Minor tweaks to setup gitpod usage 2021-05-14 16:13:14 +00:00
.grype.yaml Silence non-impactful CVE - GHSA-v23v-6jw2-98fq (#1420) 2024-11-07 14:44:52 -05:00
CODEOWNERS Adds CODEOWNERS 2020-01-16 17:00:34 -05:00
CONTRIBUTING.md Update CONTRIBUTING.md 2021-05-11 16:02:18 +00:00
DEVELOPMENT.md Remove Windows Support 2024-12-10 16:56:29 -06:00
IMAGE.md Remove Windows Support 2024-12-10 16:56:29 -06:00
LICENSE Add LICENSE (apache 2.0) 2018-06-24 21:46:32 -04:00
Makefile Specify tool versions in go.mod 2025-07-03 09:31:27 +00:00
README.md Update README for 0.20.x (#1401) 2024-09-16 11:00:35 -04:00
RELEASE.md Add more detail to release instructions (#1406) 2024-10-24 09:45:23 -04:00
codecov.yml Update config 2021-04-09 12:35:11 -04:00
go.mod Bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 2025-08-21 15:21:02 +00:00
go.sum Bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 2025-08-21 15:21:02 +00:00
golangci.yaml code lint 2025-04-16 14:47:09 +02:00
lifecycle.toml Remove deprecated platform APIs (#1191) 2023-09-13 12:44:10 -07:00

README.md

Lifecycle

Build Status GoDoc codecov CII Best Practices Gitpod ready-to-code

A reference implementation of the Cloud Native Buildpacks specification.

Supported APIs

Lifecycle Version Platform APIs Buildpack APIs
0.20.x 0.7, 0.8, 0.9, 0.10, 0.11, 0.12, 0.13, 0.14 0.7, 0.8, 0.9, 0.10, 0.11
0.19.x 0.7, 0.8, 0.9, 0.10, 0.11, 0.12, 0.13 0.7, 0.8, 0.9, 0.10, 0.11
0.18.x 0.7, 0.8, 0.9, 0.10, 0.11, 0.12 0.7, 0.8, 0.9, 0.10
0.17.x 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 0.10, 0.11, 0.12 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 0.10
0.16.x 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 0.10, 0.11 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9
0.15.x 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 0.10 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9
0.14.x 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8
0.13.x 0.3, 0.4, 0.5, 0.6, 0.7, 0.8 0.2, 0.3, 0.4, 0.5, 0.6, 0.7

* denotes unreleased version

Usage

Build

Either:

  • analyzer - Reads metadata from the previous image and ensures registry access.
  • detector - Chooses buildpacks (via /bin/detect) and produces a build plan.
  • restorer - Restores layer metadata from the previous image and from the cache, and restores cached layers.
  • builder - Executes buildpacks (via /bin/build).
  • exporter - Creates an image and caches layers.

Or:

  • creator - Runs the five phases listed above in order.

Run

  • launcher - Invokes a chosen process.

Rebase

  • rebaser - Creates an image from a previous image with updated base layers.

Contributing

  • CONTRIBUTING - Information on how to contribute and grow your understanding of the lifecycle.
  • DEVELOPMENT - Further detail to help you during the development process.
  • RELEASE - Further details about our release process.