Update README with new information, requirements and purpose.
This commit is contained in:
parent
abbbf8687c
commit
95a9649215
59
README
59
README
|
@ -1,27 +1,48 @@
|
||||||
Usage example:
|
# Arch Linux Appliance Builder
|
||||||
|
|
||||||
1) Create an aab.conf file describing your template.
|
This is a fork of [Proxmox AAB project](https://git.proxmox.com/) with the goal of building an updated Arch Linux LXC template for use with PVE, also to prevent removal of `pacman keyring`; disable `systemd-resolved` and enable `sshd`.
|
||||||
|
|
||||||
--- Example aab.conf:
|
## Requirements for building
|
||||||
Name: base
|
The best way to build this template is running inside of an Arch Linux environment and will need the following packages: **`lxc make perl-uuid`**
|
||||||
Version: 2015-08-21-1
|
|
||||||
Section: optional
|
|
||||||
Maintainer: Your Name
|
|
||||||
Headline: ArchLinux base image.
|
|
||||||
Architecture: x86_64
|
|
||||||
Source: http://archlinux.cu.be/$repo/os/$arch
|
|
||||||
--- End of example
|
|
||||||
|
|
||||||
2) Run as root:
|
Also to prevent an error when starting the container, you need to enable devices cgroup since LXC will apply [device cgroup limits](https://github.com/lxc/lxc/issues/2268#issuecomment-380019126).
|
||||||
|
|
||||||
# ./aab init
|
```Shell
|
||||||
# ./aab bootstrap
|
mount -o remount,rw /sys/fs/cgroup
|
||||||
|
mkdir /sys/fs/cgroup/devices
|
||||||
|
mount -t cgroup devices -o devices /sys/fs/cgroup/devices
|
||||||
|
mount -o remount,ro /sys/fs/cgroup
|
||||||
|
```
|
||||||
|
|
||||||
3) Maybe install additional packages
|
## To enable/disable services and install additional packages
|
||||||
|
|
||||||
# ./aab install base-devel
|
Go to the file `PVE/AAB.pm` and search for the following lines:
|
||||||
|
- Add new packages: `my @BASE_PACKAGES`
|
||||||
|
- Disable service: `print "Masking problematic systemd units...\n";`
|
||||||
|
- Enable serivce: `print "Enable systemd services...\n";`
|
||||||
|
|
||||||
4) Create the archive and clean up:
|
## Usage
|
||||||
|
|
||||||
# ./aab finalize
|
### with Make
|
||||||
# ./aab cleanup
|
- `make aab.conf`
|
||||||
|
- run as root `make build-current`
|
||||||
|
- go drink mate or kofi while is creating and compacting the template
|
||||||
|
- when done will have the following file `archlinux-base_${DATE}-1_${ARCH}.tar.zst`
|
||||||
|
- upload to your PVE and enjoy~
|
||||||
|
|
||||||
|
### or step by step
|
||||||
|
|
||||||
|
### 1. Create an aab.conf file describing your template.
|
||||||
|
- `make aab.conf`
|
||||||
|
- edit the source argument inside of `aab.conf` and change to a mirror of your choice
|
||||||
|
|
||||||
|
### 2. Run as root:
|
||||||
|
- `./aab init`
|
||||||
|
- `./aab bootstrap`
|
||||||
|
|
||||||
|
### 3. Maybe install additional packages
|
||||||
|
- `./aab install base-devel`
|
||||||
|
|
||||||
|
### 4. Create the archive and clean up:
|
||||||
|
- `./aab finalize`
|
||||||
|
- `./aab cleanup`
|
Loading…
Reference in New Issue