Skip to content

Commit e25054a

Browse files
committed
New page "Basics of BuildPacks" under the Getting Started side menu
- 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 <[email protected]>
1 parent 7c128e6 commit e25054a

File tree

3 files changed

+64
-1
lines changed

3 files changed

+64
-1
lines changed

content/docs/app-journey.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
22
title="An App's Brief Journey from Source to Image"
3-
weight=2
3+
weight=3
44
getting-started=true
55
+++
66

content/docs/buildpack-basics.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
+++
2+
title="Basics of BuildPacks"
3+
weight=2
4+
getting-started=true
5+
+++
6+
7+
## Basic Concepts
8+
9+
### What is a Buildpack?
10+
11+
A `buildpack` is software that transforms application source code into
12+
executable files by analyzing the code and determining the best way to
13+
build it.
14+
15+
![buildpacks](/images/what.svg)
16+
17+
### What is a Builder?
18+
19+
A builder is an image that contains all the components necessary to
20+
execute a build (for example, an ordered combination of buildpacks, a build
21+
image and other files and configurations).
22+
23+
![create-builder diagram](/images/create-builder.svg)
24+
25+
### What is a Lifecycle?
26+
27+
A lifecycle is a series of steps that are used to create and manage a
28+
buildpack. `create` is used to analyze, detect, restore, build, and export
29+
buildpack execution. Next, `launcher` can be used to launch the application.
30+
Finally, `rebase` can be used to push the latest changes to an existing
31+
buildpack. All of these steps are part of a lifecycle.
32+
33+
![lifecycle](/images/lifecycle.png)
34+
35+
### What is a Platform
36+
37+
A platform typically refers to an organization or service provider (e.g.,
38+
kpack, Tekton, Fly.io, Digital Ocean, Google Cloud, Heroku, SalesForce, etc.)
39+
that incorporates Buildpacks within their products to make buildpack
40+
functionality available to their end-users (typically, application
41+
developers).
42+
43+
A platform can be a:
44+
45+
- A local CLI tool
46+
- A plugin for a continuous integration service
47+
- A cloud application platform
48+
49+
## Who uses Buildpacks (Personas)
50+
51+
### App Developers
52+
53+
Regular Application developers that utilize Buildpacks in their app packaging
54+
workflows.
55+
56+
### Platform Operators
57+
58+
Operators of platforms (Google Cloud, Salesforce, etc.) that incorporate
59+
Buildpacks within their platforms to simplify the end-user experience.
60+
61+
### Buildpack Authors
62+
63+
Buildpacks' internal developers working on Buildpack features.
96.7 KB
Loading

0 commit comments

Comments
 (0)