Skip to content

Commit c750f4b

Browse files
author
Natalie Arellano
committed
Move extension guide to buildpack-authors tutorial
Signed-off-by: Natalie Arellano <[email protected]>
1 parent 4af9073 commit c750f4b

File tree

8 files changed

+35
-53
lines changed

8 files changed

+35
-53
lines changed

content/docs/extension-guide/create-extension/_index.md

Lines changed: 0 additions & 33 deletions
This file was deleted.
Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,14 @@
11
+++
22
title="Write a basic extension"
33
weight=2
4-
expand=true
5-
include_summaries=true
4+
aliases = [
5+
"/docs/extension-author-guide/create-extension"
6+
]
7+
include_summaries=false
68
+++
9+
10+
This is a step-by-step tutorial for creating and using image extensions, which allow for customization of the build-time and runtime base images using Dockerfiles.
11+
12+
<!--more-->
13+
14+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/setup-local-environment" class="button bg-pink">Start Tutorial</a>

content/docs/extension-guide/create-extension/build-dockerfile.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/build-dockerfile.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
2-
title="Generating a build.Dockerfile"
3-
weight=404
2+
title="Extending the build-time base image with a build.Dockerfile"
3+
weight=4
44
aliases = [
55
"/docs/extension-author-guide/create-extension/build-dockerfile/",
66
]
@@ -91,4 +91,4 @@ Let's take a look at how the `samples/curl` extension fixes the error by switchi
9191
<!--+ if false+-->
9292
---
9393

94-
<a href="/docs/extension-guide/create-extension/run-dockerfile-switch" class="button bg-pink">Next Step</a>
94+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/run-dockerfile-switch" class="button bg-pink">Next Step</a>

content/docs/extension-guide/create-extension/building-blocks-extension.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/building-blocks-extension.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
2-
title="Building blocks of a CNB Image Extension"
3-
weight=403
2+
title="The building blocks of a CNB image extension"
3+
weight=3
44
aliases = [
55
"/docs/extension-author-guide/building-blocks-extension/"
66
]
@@ -45,5 +45,5 @@ For guidance around writing extensions and more advanced use cases, see [here](/
4545
<!--+ if false+-->
4646
---
4747

48-
<a href="/docs/extension-guide/create-extension/build-dockerfile" class="button bg-pink">Next Step</a>
48+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/build-dockerfile" class="button bg-pink">Next Step</a>
4949
<!--+ end +-->

content/docs/extension-guide/create-extension/run-dockerfile-extend.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/run-dockerfile-extend.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
2-
title="Generating a run.Dockerfile that extends the runtime base image"
3-
weight=406
2+
title="Extending the runtime base image with a run.Dockerfile"
3+
weight=6
44
+++
55

66
<!-- test:suite=dockerfiles;weight=6 -->

content/docs/extension-guide/create-extension/run-dockerfile-switch.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/run-dockerfile-switch.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
2-
title="Generating a run.Dockerfile that switches the runtime base image"
3-
weight=405
2+
title="Switching the runtime base image with a run.Dockerfile"
3+
weight=5
44
aliases = [
55
"/docs/extension-author-guide/run-dockerfile/"
66
]
@@ -145,5 +145,5 @@ Luckily, we can also use image extensions to dynamically install runtime depende
145145
<!--+ if false+-->
146146
---
147147

148-
<a href="/docs/extension-guide/create-extension/run-dockerfile-extend" class="button bg-pink">Next Step</a>
148+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/run-dockerfile-extend" class="button bg-pink">Next Step</a>
149149
<!--+ end +-->

content/docs/extension-guide/create-extension/setup-local-environment.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/setup-local-environment.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,23 @@
11
+++
22
title="Set up your local environment"
3-
weight=401
3+
weight=1
44
aliases = [
55
"/docs/extension-author-guide/create-extension/setup-local-environment/",
66
]
77
+++
88

9-
<!-- test:suite=dockerfiles;weight=1 -->
10-
119
Let's walk through a build that uses extensions, step by step. We will see an image extension that installs `curl` on
1210
the builder image, and switches the run image to an image that has `curl` installed.
1311

12+
### Check system requirements
13+
14+
Before we get started, make sure you've got the following installed:
15+
16+
{{< download-button href="https://store.docker.com/search?type=edition&offering=community" color="blue" >}} Install Docker {{</>}}
17+
{{< download-button href="/docs/install-pack" color="pink" >}} Install pack {{</>}}
18+
19+
<!-- test:suite=dockerfiles;weight=1 -->
20+
1421
### Ensure Docker is running
1522

1623
<!-- test:exec -->
@@ -78,5 +85,5 @@ git clone https://github.com/buildpacks/samples.git
7885
<!--+ if false +-->
7986
---
8087

81-
<a href="/docs/extension-guide/create-extension/why-dockerfiles" class="button bg-pink">Next Step</a>
88+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/why-dockerfiles" class="button bg-pink">Next Step</a>
8289
<!--+ end+-->

content/docs/extension-guide/create-extension/why-dockerfiles.md renamed to content/docs/for-buildpack-authors/tutorials/write-basic-extension/why-dockerfiles.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
+++
2-
title="Why Dockerfiles"
3-
weight=402
2+
title="Why this feature?"
3+
weight=2
44
aliases = [
55
"/docs/extension-author-guide/create-extension/why-dockerfiles/",
66
]
@@ -105,5 +105,5 @@ Let's take a look at how the `samples/vim` extension installs `vim` on the build
105105
<!--+ if false+-->
106106
---
107107

108-
<a href="/docs/extension-guide/create-extension/building-blocks-extension" class="button bg-pink">Next Step</a>
108+
<a href="/docs/for-buildpack-authors/tutorials/write-basic-extension/building-blocks-extension" class="button bg-pink">Next Step</a>
109109
<!--+ end +-->

0 commit comments

Comments
 (0)