mirror of https://github.com/BlackLight/vmctl.git
80 lines
2.9 KiB
Markdown
80 lines
2.9 KiB
Markdown
# qemu-arch-linux-automation
|
|
|
|
Scripts and playbooks to automate the installation, configuration and
|
|
management of Arch Linux VMs in qemu.
|
|
|
|
## Dependencies
|
|
|
|
- `qemu`
|
|
- `curl`
|
|
- `expect`
|
|
|
|
## Installation
|
|
|
|
- Add the path to the `src` directory to your `PATH` environment variable
|
|
- Create a symbolic link to `src/` directory to your `PATH` environment variable
|
|
|
|
## Usage
|
|
|
|
### Install an Arch Linux virtual machine
|
|
|
|
```text
|
|
Usage: qemu-arch install [-o <output-disk-image>] [-a <architecture>] [-s <disk-size>]
|
|
[-m <memory>] [-h <hostname>] [-P <root-password>] [-u <non-root-username>]
|
|
[-p <non-root-user-password>] [-z <timezone>] [-l <locale>] [-M <arch-mirror-url>]
|
|
|
|
-o <output-disk-image> Path of the output disk image (default: ./arch.img)
|
|
-a <architecture> Target architecture (default: x86_64)
|
|
-s <disk-size> Disk size (default: 8G)
|
|
-m <memory> RAM size in KB (default: 2048)
|
|
-h <hostname> VM hostname (default: qemu)
|
|
-P <root-password> Root password. If not specified it will be prompted
|
|
-u <non-root-username> Username for the main non-root user
|
|
-p <non-root-user-password> Password for the non-root user. If not specified
|
|
it will be prompted
|
|
-z <timezone> System timezone (default: UTC)
|
|
-l <locale> System locale (default: en_US.UTF-8)
|
|
-M <arch-mirror-url> Arch Linux download mirror URL
|
|
(default: http://mirror.cj2.nl/archlinux/iso/latest/)
|
|
Consult https://archlinux.org/download/ for a
|
|
full list of the available download mirrors.
|
|
```
|
|
|
|
If you want to install an extra list of packages besides the default ones, then
|
|
specify them in a file named `PKGLIST` in the same directory as the disk image file.
|
|
|
|
If you want to run a custom post-installation script after the core system has been
|
|
installed, then create a custom script named `post-install.sh` in the same directory
|
|
as the disk image file.
|
|
|
|
#### Notes
|
|
|
|
The keyring population process may currently (as of March 2022) take a long time.
|
|
This is a [known issue](https://www.reddit.com/r/archlinux/comments/rbjbcr/pacman_keyring_update_taking_too_long/).
|
|
|
|
As a workaround, if you want to speed up the OS installation process, you can
|
|
temporarily disable pacman keyring checks upon package installation by
|
|
uncommenting the relevant lines in `src/helpers/install.sh` (function:
|
|
`install_os`).
|
|
|
|
### Resize an existing image
|
|
|
|
```bash
|
|
qemu-img resize "$imgfile" +10G
|
|
```
|
|
|
|
### Create a COW (Copy-On-Write) image on top of a disk image
|
|
|
|
```bash
|
|
qemu-img create -o backing_file="$imgfile",backing_fmt=raw -f qcow2 img1.cow
|
|
```
|
|
|
|
This is particularly useful if you want to have a "base" image and several customized
|
|
images built on it.
|
|
|
|
### Convert a raw qemu image to a VirtualBox
|
|
|
|
```bash
|
|
qemu-img convert -O vdi disk.img disk.vdi
|
|
```
|