cloudfoundry/cnb

Quick Reference

• Buildpacks.io → Cloud Native Buildpack website
• https://github.com/buildpack/pack → CLI used to consume the builder, along with source code, and construct an OCI image
• CNB Tutorial → Tutorial to get you started using pack, this builder, and your application to create a working OCI image
• https://github.com/buildpack/spec → Detailed definition of the interaction between a platform, a lifecycle, Cloud Native Buildpacks, and an application
• Get help from the Cloud Foundry Slack, and if you have any specific issues with a CNB, file an issue in the appropriate github repo.

What are Cloud Native Buildpacks (CNBs)?

CNBs are modular components used to turn your app source code into a runnable OCI image.

Buildpacks, in general, provide a higher-level abstraction for building apps compared to Dockerfiles. Cloud Native Buildpacks, a project initiated by Pivotal and Heroku, is a member of the Cloud Native Sandbox. The project unifies the buildpack ecosystem, through a platform-to-buildpack contract that embraces modern container standards, specifically the OCI image format.

What are these images (cloudfoundry/cnb)?

These images, called builders, contain internal operating system images (see the below sections for differences), the lifecycle executables for your application, and a collection of Cloud Native Buildpacks, all structured according to the https://github.com/buildpack/spec. These are https://github.com/buildpack/pack#working-with-builders-using-create-builder, and https://github.com/buildpack/pack#example-building-using-the-default-builder-image, the https://github.com/buildpack/pack.

The different tags refer to differences in the underlying file-system, which supports different operating systems:

• https://github.com/cloudfoundry/stacks/blob/master/bionic/base/build/Dockerfile → A minimal image based on Ubuntu 18.04 (Bionic Beaver), with the addition of a few packages (called https://github.com/buildpack/spec/blob/master/platform.md#mixins) - notably, git and build-essentials (added in order to successfully run go applications).
• https://github.com/cloudfoundry/cflinuxfs3 → An image based on Ubuntu 18.04 (Bionic Beaver) supplemented with https://github.com/cloudfoundry/cflinuxfs3/blob/master/receipt.cflinuxfs3.x86_64.
• https://github.com/cloudfoundry/stacks/tree/master/tiny/base/run → A minimal build image (same as base), with a tiny, distroless-like run image based on Ubuntu 18.04 (Bionic Beaver).

Note: At the moment, cflinuxfs3 is the only option when running python, php, httpd or nginx apps.

Supported Languages Ecosystems

Each language ecosystem is a combination of the language specific CNBs in conjunction with some combination of build system tooling.

https://github.com/cloudfoundry/java-buildpack-group

• https://github.com/cloudfoundry/archive-expanding-cnb
• https://github.com/cloudfoundry/azure-application-insights-cnb
• https://github.com/cloudfoundry/build-system-cnb
• https://github.com/cloudfoundry/debug-cnb
• https://github.com/cloudfoundry/dist-zip-cnb
• https://github.com/cloudfoundry/google-stackdriver-cnb
• https://github.com/cloudfoundry/jdbc-cnb
• https://github.com/cloudfoundry/jmx-cnb
• https://github.com/cloudfoundry/jvm-application-cnb
• https://github.com/cloudfoundry/openjdk-cnb
• https://github.com/cloudfoundry/procfile-cnb
• https://github.com/cloudfoundry/tomcat-cnb
• https://github.com/cloudfoundry/spring-boot-cnb
• https://github.com/cloudfoundry/spring-auto-reconfiguration-cnb

NodeJS

• https://github.com/cloudfoundry/node-engine-cnb
• https://github.com/cloudfoundry/npm-cnb
• https://github.com/cloudfoundry/yarn-cnb

Python

• https://github.com/cloudfoundry/python-cnb
• https://github.com/cloudfoundry/pip-cnb
• https://github.com/cloudfoundry/pipenv-cnb
• https://github.com/cloudfoundry/conda-cnb

Go

• https://github.com/cloudfoundry/go-compiler-cnb
• https://github.com/cloudfoundry/go-mod-cnb
• https://github.com/cloudfoundry/dep-cnb

PHP

• https://github.com/cloudfoundry/php-dist-cnb
• https://github.com/cloudfoundry/php-composer-cnb
• https://github.com/cloudfoundry/httpd-cnb
• https://github.com/cloudfoundry/nginx-cnb
• https://github.com/cloudfoundry/php-web-cnb

HTTPD

• https://github.com/cloudfoundry/httpd-cnb

Nginx

• https://github.com/cloudfoundry/nginx-cnb