Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[doc] Advanced documentation / add wiki section #53

Open
adlerweb opened this issue Feb 3, 2021 · 1 comment
Open

[doc] Advanced documentation / add wiki section #53

adlerweb opened this issue Feb 3, 2021 · 1 comment

Comments

@adlerweb
Copy link

adlerweb commented Feb 3, 2021

At the moment most documentation is in README.md. While this is sufficient for most basic stuff it took quite some time to understand how the tools used work together, especially when dealing with GPG or custom repositories. I couldn't really find any advanced documentation for either aurto or aurutils and while the aurto repo would be the place I would look for this first I'm not sure the readme is a good place for this rather specific stuff. Any ideas on how to make this knowledge accessible or easier to find for other aurto users? Maybe enable the wiki section?

Things I have on my notebook:

  • Importing GPG-keys, for example to allow signed packages to be verified
    aurto uses a dedicated user for most operations. Keys must be added to the keyring of this user, for example:
    sudo -u aurto gpg --search 0x123456789abcdef
  • Adding a key to the pacman keystore
    aurto uses aurutils/aurbuild to build packages. Since their chroot is synced, keys added there will also be available during aurto builds. For example:
    arch-chroot /var/lib/aurbuild/x86_64/root pacman-key -r 0x123456789abcdef
  • Adding an repository
    Additional repositorys may be specified in /etc/aurto/pacman-chroot.conf.
    (granted, thats somewhat already in readme...)
@alexheretic
Copy link
Owner

I wouldn't be against a wiki for aurto if that's helpful to people, I've enabled it: https://github.com/alexheretic/aurto/wiki

However, I think the real complexity lies with upstream aurutils & the arch core components, rather than aurto itself. I've tried to keep the scope of this project limited. Generally I'd advise people to use aurutils directly if their requirements outstrip aurto.

aurto uses a dedicated user for most operations

Not exactly right, whichever user that calls aurto init is used to do all non-root tasks. It doesn't have a dedicated user called "aurto" (unless that's been explicitly setup).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants