Skip to content

Commit

Permalink
Format markdown
Browse files Browse the repository at this point in the history
Produced via: `prettier --write --prose-wrap=always $(find -name '*.md' | grep -v vendor | grep -v .github)`
  • Loading branch information
mattmoor-sockpuppet authored and tekton-robot committed May 24, 2019
1 parent ea5cc07 commit 981b988
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 14 deletions.
8 changes: 5 additions & 3 deletions docs/developers/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,9 @@ If the image is a private registry, the service account should include an

## Builder namespace on containers

The `/builder/` namespace is reserved on containers for various system tools, such as the following:
The `/builder/` namespace is reserved on containers for various system tools,
such as the following:

- The environment variable HOME is set to `/builder/home`, used by the builder tools and injected on into all of the step containers
- Default location for output-images `/builder/output-images`
- The environment variable HOME is set to `/builder/home`, used by the builder
tools and injected on into all of the step containers
- Default location for output-images `/builder/output-images`
35 changes: 24 additions & 11 deletions docs/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -164,9 +164,17 @@ spec:

#### Surfacing the image digest built in a task

To surface the image digest in the output of the `taskRun` the builder tool should produce this information in a [OCI Image Spec](https://github.com/opencontainers/image-spec/blob/master/image-layout.md) `index.json` file. This file should be placed on a location as specified in the task definition under the resource `outputImageDir`. Annotations in `index.json` will be ignored, and if there are multiple versions of the image, the latest will be used.
To surface the image digest in the output of the `taskRun` the builder tool
should produce this information in a
[OCI Image Spec](https://github.com/opencontainers/image-spec/blob/master/image-layout.md)
`index.json` file. This file should be placed on a location as specified in the
task definition under the resource `outputImageDir`. Annotations in `index.json`
will be ignored, and if there are multiple versions of the image, the latest
will be used.

For example this build-push task defines the `outputImageDir` for the
`builtImage` resource in `/workspace/buildImage`

For example this build-push task defines the `outputImageDir` for the `builtImage` resource in `/workspace/buildImage`
```yaml
apiVersion: tekton.dev/v1alpha1
kind: Task
Expand All @@ -175,20 +183,24 @@ metadata:
spec:
inputs:
resources:
- name: workspace
type: git
- name: workspace
type: git
outputs:
resources:
- name: builtImage
type: image
outputImageDir: /workspace/builtImage
- name: builtImage
type: image
outputImageDir: /workspace/builtImage
steps: ...
```
If no value is specified for `outputImageDir`, it will default to `/builder/image-outputs/{resource-name}`.

*Please check the builder tool used on how to pass this path to create the output file.*
If no value is specified for `outputImageDir`, it will default to
`/builder/image-outputs/{resource-name}`.

_Please check the builder tool used on how to pass this path to create the
output file._

The `taskRun` will include the image digest in the `resourcesResult` field that is part of the `taskRun.Status`
The `taskRun` will include the image digest in the `resourcesResult` field that
is part of the `taskRun.Status`

for example:

Expand All @@ -201,7 +213,8 @@ status:
...
```

If the `index.json` file is not produced, the image digest will not be included in the `taskRun` output.
If the `index.json` file is not produced, the image digest will not be included
in the `taskRun` output.

### Cluster Resource

Expand Down

0 comments on commit 981b988

Please sign in to comment.