Skip to content

Commit

Permalink
secrets: Doc credential helper
Browse files Browse the repository at this point in the history
In the [current architecture](https://github.com/ostreedev/ostree-rs-ext/)
unfortunately it's going to be hard for us to fix this...it's explicitly
by design today: https://github.com/ostreedev/ostree-rs-ext/blob/c0e8c8fe9c3344b9d349e2c9371e1335e1173bef/lib/src/container/mod.rs#L427

To handle the "credential helper only" case we'd need to enhance
skopeo with something like `--no-root-homedir`.

Closes: #562
  • Loading branch information
cgwalters committed May 23, 2024
1 parent 5aea3ca commit 0fbc3ea
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion docs/src/building/secrets.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@
# Secrets (e.g. container pull secrets)

To have `bootc` fetch updates from registry which requires authentication,
you must include a pull secret in `/etc/ostree/auth.json`.
you must include a pull secret in `/etc/ostree/auth.json` (or
as of recent versions in `/usr/lib/ostree/auth.json`).

Another common case is to also fetch container images via
`podman` or equivalent. There is a [pull request to add `/etc/containers/auth.json`](https://github.com/containers/image/pull/1746)
Expand All @@ -12,6 +13,13 @@ Regardless, injecting this data is a good example of a generic
"secret". The bootc project does not currently include one
single opinionated mechanism for secrets.

## Using a credential helper

In order to use a credential helper as configured in `registries.conf`
such as `credential-helpers = ["ecr-login"]`, you must currently
also write a "no-op" authentication file with the contents `{}` (i.e. an
empty JSON object, not an empty file) into the pull secret location.

## Embedding in container build

This was mentioned above; you can include secrets in
Expand Down

0 comments on commit 0fbc3ea

Please sign in to comment.