Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mserajnik/arch-repo-create
A Docker image for creating Arch Linux package repositories
https://github.com/mserajnik/arch-repo-create
archlinux docker
Last synced: 7 days ago
JSON representation
A Docker image for creating Arch Linux package repositories
- Host: GitHub
- URL: https://github.com/mserajnik/arch-repo-create
- Owner: mserajnik
- License: agpl-3.0
- Created: 2024-10-24T12:06:50.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2024-10-25T20:00:51.000Z (about 2 months ago)
- Last Synced: 2024-11-05T14:33:44.444Z (about 2 months ago)
- Topics: archlinux, docker
- Language: Shell
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arch-repo-create [![GitHub Actions status][actions-status-badge]][actions-status]
> A Docker image for creating Arch Linux package repositories
This Docker image provides an easy way to create and manage Arch Linux package
package repositories. It is based on the
[official Arch Linux image][arch-linux-image] and builds packages using
[`makepkg`][makepkg] before adding them to a repository via
[`repo-add`][repo-add]. Dependencies are installed with [pikaur][pikaur] and
can therefore also come from the AUR. Both the packages and the repository can
optionally be signed by providing a GPG key.
The primary use case are CI/CD platforms that don't have an Arch Linux
environment available by default. See [my personal repository][repo-example]
for an example of how this image can be utilized in a GitHub Actions workflow.
## Usage
To get started, clone the Git repository and create a copy of the Docker
Compose example configuration:
```sh
git clone https://github.com/mserajnik/arch-repo-create.git
cd arch-repo-create
cp ./compose.yaml.example ./compose.yaml
```
Adjust the `REPOSITORY_NAME` environment variable in your `compose.yaml` as you
like. Optionally, you can also pass a GPG private key to the container which
will cause the packages and the repository to be signed. To do this, you need
to base64-encode the key. E.g., like this:
```sh
gpg --export-secret-key | base64
```
Then, copy the output and paste it as value for the `GPG_PRIVATE_KEY`
environment variable. If your GPG key is protected by a passphrase, you also
need to set `GPG_PASSPHRASE` accordingly.
Next, copy the packages you want to build and add to the repository to the
[`./packages`](packages) directory. Each package must be in its own
subdirectory and contain (at least) a `PKGBUILD` file, like this:
```sh
tree ./packages
./packages/
└── example-package
└── PKGBUILD
```
Finally, run the container:
```sh
docker compose run --rm build
```
Do not use `docker compose up`; the container is not supposed to keep running
after the one-off command has finished executing. Here, Docker Compose is used
mainly to have an easy way to start the container, considering how long the
base64 GPG key is and how cumbersome it would be to pass it via the command
line.
After the container has exited, the repository files will be inside the
[`./repository`](repository) directory. Simply deploy these files to a web
server to host your repository and add it to your Arch Linux system by editing
your `/etc/pacman.conf`. E.g., for a signed repository with the default name
`arch-repo`:
```ini
[arch-repo]
SigLevel = Required DatabaseRequired TrustedOnly
Server = https://your-domain.com/
```
### Recreating the repository
If you want to cleanly recreate the repository from scratch, delete all the
files from the [`./repository`](repository) directory before running the
container again:
```sh
rm -rf ./repository/*
docker compose run --rm build
```
Otherwise, the existing repository will be updated instead and old package
versions will be kept.
## Maintainer
[Michael Serajnik][maintainer]
## Contribute
You are welcome to help out!
[Open an issue][issues] or [make a pull request][pull-requests].
## License
[AGPL-3.0-or-later](LICENSE) © Michael Serajnik
[arch-linux-image]: https://hub.docker.com/_/archlinux/
[makepkg]: https://man.archlinux.org/man/makepkg.8.en
[pikaur]: https://github.com/actionless/pikaur
[repo-add]: https://man.archlinux.org/man/repo-add.8.en
[repo-example]: https://github.com/mserajnik/pkg.mser.at
[actions-status]: https://github.com/mserajnik/arch-repo-create/actions
[actions-status-badge]: https://github.com/mserajnik/arch-repo-create/actions/workflows/build-docker-image.yaml/badge.svg
[issues]: https://github.com/mserajnik/arch-repo-create/issues
[maintainer]: https://github.com/mserajnik
[pull-requests]: https://github.com/mserajnik/arch-repo-create/pulls