Skip to content

Commit 54a521c

Browse files
now with consume extension notes
Signed-off-by: Joe Kimmel <[email protected]>
1 parent 7366ebe commit 54a521c

File tree

4 files changed

+72
-1
lines changed

4 files changed

+72
-1
lines changed

content/docs/extension-guide/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
+++
2-
title="Extension Author Guide"
2+
title="Extension Guide"
33
weight=4
44
include_summaries=true
55
expand=true
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
+++
2+
title="Consume an extension"
3+
weight=4
4+
summary="A few notes to help you consume extensions"
5+
aliases = [
6+
"/docs/extension-author-guide/create-extension"
7+
]
8+
+++
9+
10+
<!--+if false+-->
11+
## Prerequisites
12+
13+
Before we get started, make sure you've got the following installed:
14+
15+
{{< download-button href="https://store.docker.com/search?type=edition&offering=community" color="blue" >}} Install Docker {{</>}}
16+
{{< download-button href="/docs/install-pack" color="pink" >}} Install pack {{</>}}
17+
18+
You may also need to [create an extension](/docs/extension-guide/create-extension) so that you can consume it.
19+
20+
## Overview
21+
<!--+end+-->
22+
23+
This is a few notes for using CNB image extensions.
24+
25+
- [consume in your builder](/docs/extension-guide/consume-extension/in-builder)
26+
- [consume via pack build](/docs/extension-guide/consume-extension/from-cli)
27+
28+
<!--+if false+-->
29+
---
30+
31+
<a href="/docs/extension-guide/consume-extension/in-builder" class="button bg-pink">Start Tutorial</a>
32+
<!--+end+-->
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
+++
2+
title="Specifying an Image Extension at Build Time"
3+
weight=405
4+
+++
5+
6+
<!-- test:suite=dockerfiles;weight=5 -->
7+
8+
### Specifying an Image Extension at Build Time
9+
10+
No builder can be truly omniscient, and whoever did yours surely was no exception! You need to add a little extra spice to the mix with this late-breaking extension, by doing something like:
11+
12+
`pack build [...] --extension=foo [...]`
13+
14+
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
+++
2+
title="Specifying an Image Extension in the Builder"
3+
weight=405
4+
+++
5+
6+
<!-- test:suite=dockerfiles;weight=5 -->
7+
8+
### Specifying an Image Extension in the Builder
9+
10+
You're pretty sharp, and you know what your buildpack users will need.
11+
That's why you're going to add something similar to the following lines directly to `builder.toml`:
12+
13+
```
14+
[[order-extensions]]
15+
[[order-extensions.group]]
16+
id = "foo"
17+
version = "0.0.1"
18+
19+
[[extensions]]
20+
id = "foo"
21+
version = "0.0.1"
22+
uri = "/local/path/to/extension/foo" # can be relative or absolute
23+
```
24+
25+

0 commit comments

Comments
 (0)