Skip to content

Latest commit

 

History

History
107 lines (77 loc) · 3.15 KB

README.md

File metadata and controls

107 lines (77 loc) · 3.15 KB
Raw

Genstall

Gentoo Linux Install Scripts

Usage: On Bare Metal

This will cause destructive file system changes

Boot from a Live CD and run:

curl -L https://api.github.com/repos/p8952/genstall/tarball > genstall.tar.gz
tar xvf genstall.tar.gz
cd p8952-genstall-*
bash install.sh

Usage: With Packer & Vagrant

Prerequisites:

Build VirtualBox VM with Packer:

packer build --only=gentoo-amd64-vbox packer/gentoo-amd64.json

Import VirtualBox VM to Vagrant:

vagrant box add gentoo-amd64 gentoo-amd64-vbox-<timestamp>.box

Vagrantfile for VirtualBox VM:

Vagrant.configure(2) do |config|
	config.vm.box = "gentoo-amd64"
end

Launch VirtualBox VM with Vagrant:

vagrant up
vagrant ssh
exit
vagrant destroy

Build AWS AMI with Packer:

export AWS_ACCESS_KEY="ABCDEFGHIJKLMNOPQRSTUVWXYZ"
export AWS_SECRET_KEY="ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890"
packer build --only=gentoo-amd64-aws packer/gentoo-amd64.json

Import AWS AMI to Vagrant:

vagrant box add gentoo-amd64 gentoo-amd64-aws-<timestamp>.box

Vagrantfile for AWS AMI:

Vagrant.configure(2) do |config|
		config.vm.box = "gentoo-amd64"
		config.vm.provider :aws do |aws, override|
				aws.instance_type = "t2.micro"
				aws.region = "eu-west-1"
				aws.keypair_name = "AWS-Key"
				override.ssh.username = "ec2-user"
				override.ssh.private_key_path = "~/.ssh/AWS-Key.pem"
		end
end

Launch AWS AMI with Vagrant:

vagrant plugin install vagrant-aws
vagrant up --provider=aws
vagrant ssh
exit
vagrant destroy

Refer to Vagrant's documentation for further usage.

Configuration

Without any user defined configuration genstall will attempt to install a basic Gentoo system as per the Gentoo Handbook.

Additional settings can be configured in genstall.d/00-settings.sh, such as enabling LVM, installing custom software (Puppet, Chef, ect), and setting metadata (hostname, root password, network settings).

Variables in genstall.d/00-settings.sh prefixed with _ are internal variables and should not be changed.

Variable Value
DIST_MIRROR Portage Distfile Mirror(s)
SYNC_MIRROR Portage Rsync Mirror(s)
BOOT_SIZE Size of the boot partition, eg: +256M
SWAP_SIZE Size of the swap partition, eg: +1G
ROOT_SIZE Size of the root partition, eg: +10G
BOOT_FS The file system of the boot partition, eg: ext2
ROOT_FS The file system of the root partition, eg: ext4
TIMEZONE The system's timezone, eg: Europe/London
HOSTNAME The system's hostname, eg: my-gentoo-box
PASSWORD The system's root password
SOFTWARE Applications to be installed, eg: syslog & cron
DAEMONS Daemons to be added to the default runlevel, eg: sshd