Skip to content

Commit d14730f

Browse files
committed
Describe use of sha256 hash with Wave
- https://github.com/seqeralabs/nf-tower-docs/issues/624
1 parent 08f4400 commit d14730f

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

docs/guide.md renamed to docs/guide.mdx

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,26 @@ If an access token is not provided, the following rate limits apply:
5454
- 25 container builds per day
5555
- 250 container pulls per hour
5656

57+
## Reproducible builds with SHA256 container image references
58+
59+
Referring to the SHA256 hash of a container imagine is a common best practice in pipeline development. For example, the SHA256 hash for a container might be similar to `sha256:3235...ce8f`. If you use the Wave service to augment your containers, such as to add Fusion to a container, the original SHA256 hash of the image is no longer correct.
60+
61+
To accommodate the new layers added to a container image augmented with Wave, you can use the freeze feature of Wave. In your pipeline configuration, ensure that you specify the following settings:
62+
63+
```
64+
wave.enabled = true
65+
wave.freeze = true
66+
wave.strategy = ['dockerfile']
67+
wave.build.repository = 'docker.io/<user>/<repository>'
68+
```
69+
70+
In your pipeline, you can use the SHA256 of the Wave augmented container, available in the target repository that you specify with the `wave.build.repository` parameter. For example:
71+
72+
```
73+
docker.enabled = 'true'
74+
process.container = 'docker.io/<user>/my-bio-container@sha256:3235....ce8f'
75+
```
76+
5777
## Tutorials
5878

5979
### Authenticate private repositories

0 commit comments

Comments
 (0)