Added Docs/Readme
This commit is contained in:
66
Readme.md
Normal file
66
Readme.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# Brammp's alpine packages
|
||||||
|
|
||||||
|
# Package list
|
||||||
|
| Name | Description |
|
||||||
|
|------|:-----------:|
|
||||||
|
| minisatip | A small SAT>IP server from https://github.com/catalinii/minisatip |
|
||||||
|
| custom-firmware-mn88472 | Panasonic MN88472 firmware for Xbox One tuner |
|
||||||
|
|
||||||
|
# How to build packages
|
||||||
|
## Initial Setup
|
||||||
|
First follow `SetupEnv.md`
|
||||||
|
## Getting this repo
|
||||||
|
Make sure you are logged-in as the user from `SetupEnv.md`.
|
||||||
|
```
|
||||||
|
git clone https://git.bprieshof.nl/brammp/AlpinePackages.git
|
||||||
|
```
|
||||||
|
## Updating repo
|
||||||
|
Use the following command to update the local git repo.
|
||||||
|
```
|
||||||
|
git pull
|
||||||
|
```
|
||||||
|
|
||||||
|
## Building package
|
||||||
|
To build a package, go to the directory and use the `abuild` command.
|
||||||
|
```
|
||||||
|
cd ~/AlpinePackages/<PackageName>
|
||||||
|
abuild -r
|
||||||
|
```
|
||||||
|
* -r to install dependencies for building the package
|
||||||
|
|
||||||
|
## Serving/installing the packages
|
||||||
|
By default, the packages are stored in the `~/packages` directory.
|
||||||
|
The public signing is stored as `*.pub` in the `~/.abuild` directory.
|
||||||
|
The `packages` folder can be used as web root to act as a repo for the packages.
|
||||||
|
TIP: For easy of use, copy the public signing key to `packages` folder.
|
||||||
|
### Local system
|
||||||
|
The public signing does not have to be added, since `SetupEnv.md` has automatically done this.
|
||||||
|
#### Add as repo
|
||||||
|
Add the following to `/etc/apk/repositories`
|
||||||
|
```
|
||||||
|
/home/<yourusername>/packages/AlpinePackages/
|
||||||
|
```
|
||||||
|
To install the package use
|
||||||
|
```
|
||||||
|
apk add <pkgName>
|
||||||
|
```
|
||||||
|
#### Single shot install
|
||||||
|
```
|
||||||
|
apk add --repository /home/USER/packages/AlpinePackages <pkgName>
|
||||||
|
```
|
||||||
|
### On a remote system
|
||||||
|
Add/download the public signing key to `/etc/apk/keys`.
|
||||||
|
#### Add as repo
|
||||||
|
Add the following to `/etc/apk/repositories`
|
||||||
|
```
|
||||||
|
http://<IpOfserver/builder>/AlpinePackages/
|
||||||
|
```
|
||||||
|
To install the package use
|
||||||
|
```
|
||||||
|
apk add <pkgName>
|
||||||
|
```
|
||||||
|
#### Single shot install
|
||||||
|
```
|
||||||
|
apk add --repository http://<IpOfserver/builder>/AlpinePackages/ <pkgName>
|
||||||
|
```
|
||||||
|
|
||||||
34
SetupEnv.md
Normal file
34
SetupEnv.md
Normal file
@@ -0,0 +1,34 @@
|
|||||||
|
# Setting up build environment
|
||||||
|
The packages will be built with architecture of build system.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
To build a package for Alpine Linux you need an Alpine Linux installation. (For more info see: https://wiki.alpinelinux.org/wiki/Installation)
|
||||||
|
## Setup
|
||||||
|
### Install requirements
|
||||||
|
```
|
||||||
|
apk add alpine-sdk sudo git
|
||||||
|
```
|
||||||
|
### Setup user account
|
||||||
|
This is needed since `abuild` refuses to run as root.
|
||||||
|
```
|
||||||
|
adduser <yourusername>
|
||||||
|
addgroup <yourusername> abuild
|
||||||
|
```
|
||||||
|
Add the following to the sudoers file `/etc/sudoers` using the `visudo` command.
|
||||||
|
```
|
||||||
|
<yourusername> ALL=(ALL) ALL
|
||||||
|
```
|
||||||
|
### Set file permissions
|
||||||
|
```
|
||||||
|
chgrp abuild /var/cache/distfiles
|
||||||
|
chmod g+w /var/cache/distfiles
|
||||||
|
```
|
||||||
|
### Generating key for signing packages
|
||||||
|
Login as the newly created user, then run the following command.
|
||||||
|
```
|
||||||
|
abuild-keygen -a -i
|
||||||
|
```
|
||||||
|
* -a Will set `PACKAGER_PRIVKEY` to the generated key, this is for signing the packages
|
||||||
|
* -i Will install the key in to the `apk` package manager (/etc/apk/keys)
|
||||||
|
## Source
|
||||||
|
https://wiki.alpinelinux.org/wiki/Creating_an_Alpine_package
|
||||||
Reference in New Issue
Block a user