Skip to content

Commit

Permalink
New page "Basics of BuildPacks" under the Getting Started side menu
Browse files Browse the repository at this point in the history
- Changed `app-journey` weight to 3 to move it down

- Added a new "Basics of Buildpacks" page

- Added a new image to depict what constitutes a `lifecycle`

Signed-off-by: QuillPusher <130300172+QuillPusher@users.noreply.github.com>
  • Loading branch information
QuillPusher committed Apr 14, 2024
1 parent 7c128e6 commit e25054a
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 1 deletion.
2 changes: 1 addition & 1 deletion content/docs/app-journey.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
+++
title="An App's Brief Journey from Source to Image"
weight=2
weight=3
getting-started=true
+++

Expand Down
63 changes: 63 additions & 0 deletions content/docs/buildpack-basics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
+++
title="Basics of BuildPacks"
weight=2
getting-started=true
+++

## Basic Concepts

### What is a Buildpack?

A `buildpack` is software that transforms application source code into
executable files by analyzing the code and determining the best way to
build it.

![buildpacks](/images/what.svg)

### What is a Builder?

A builder is an image that contains all the components necessary to
execute a build (for example, an ordered combination of buildpacks, a build
image and other files and configurations).

![create-builder diagram](/images/create-builder.svg)

### What is a Lifecycle?

A lifecycle is a series of steps that are used to create and manage a
buildpack. `create` is used to analyze, detect, restore, build, and export
buildpack execution. Next, `launcher` can be used to launch the application.
Finally, `rebase` can be used to push the latest changes to an existing
buildpack. All of these steps are part of a lifecycle.

![lifecycle](/images/lifecycle.png)

### What is a Platform

A platform typically refers to an organization or service provider (e.g.,
kpack, Tekton, Fly.io, Digital Ocean, Google Cloud, Heroku, SalesForce, etc.)
that incorporates Buildpacks within their products to make buildpack
functionality available to their end-users (typically, application
developers).

A platform can be a:

- A local CLI tool
- A plugin for a continuous integration service
- A cloud application platform

## Who uses Buildpacks (Personas)

### App Developers

Regular Application developers that utilize Buildpacks in their app packaging
workflows.

### Platform Operators

Operators of platforms (Google Cloud, Salesforce, etc.) that incorporate
Buildpacks within their platforms to simplify the end-user experience.

### Buildpack Authors

Buildpacks' internal developers working on Buildpack features.
Binary file added themes/buildpacks/static/images/lifecycle.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e25054a

Please sign in to comment.