Skip to content

Commit

Permalink
doc: better usage of split-gpg2 in qubes-builder
Browse files Browse the repository at this point in the history
  • Loading branch information
ben-grande committed Dec 28, 2023
1 parent 9772b21 commit 3d93bad
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions salt/qubes-builder/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,6 @@ Qubes Executor lacking some dependencies on Debian such as
builder qube was Debian based, the executor qube still needs to be a Fedora
template.

A set of trusted keys is placed into the `qubes-builder` to be used to verify
the git repositories during this package installation. The split-gpg2 setup is
not used during installation as it can't restrict access to a certain set of
keys (GNUPGHOME) yet. Spit-gpg2 will be used for GPG operations transparently
when verifying and signing software, don't worry.

- Top
```sh
qubesctl top.enable qubes-builder
Expand Down Expand Up @@ -62,9 +56,9 @@ limit the scope, the action is `allowed`, else the action is to `ask`.

## Usage

The builder qube is named `qubes-builder.`
The builder qube is named `qubes-builder`.

When using the Qubes Executor, configure the builder.yml `dispvm` option to
When using the Qubes Executor, configure the `builder.yml` `dispvm` option to
either `dom0` or `dvm-qubes-builder`:
```yaml
executor:
Expand All @@ -76,5 +70,11 @@ executor:
Setting the Disposable VM to Dom0 works because it will use the
`default_dispvm` preference of `qubes-builder`, which is `dvm-qubes-builder`.

If you need to pull new commits, a set of trusted keys is present in
`/home/user/.gnupg/qubes-builder` to be used to verify commits or tags:
```sh
GNUPGHOME="$HOME/.gnupg/qubes-builder" git verify-commit "HEAD^{commit}"
```

There are no further modifications needed to comply with this package. Consult
upstream documentation on how to use the Qubes OS Builder.
upstream documentation on how to use the Qubes OS Builder V2.

0 comments on commit 3d93bad

Please sign in to comment.