xref: /freebsd/release/tools/ec2.conf (revision 0b3105a37d7adcadcb720112fed4dc4e8040be99)
1#!/bin/sh
2#
3# $FreeBSD$
4#
5
6# Packages to install into the image we're creating.  This is a deliberately
7# minimalist set, providing only the packages necessary to bootstrap further
8# package installation as specified via EC2 user-data.
9export VM_EXTRA_PACKAGES="ec2-scripts firstboot-freebsd-update firstboot-pkgs"
10
11# Set to a list of third-party software to enable in rc.conf(5).
12export VM_RC_LIST="ec2_configinit ec2_fetchkey ec2_ephemeralswap ec2_loghostkey firstboot_freebsd_update firstboot_pkgs"
13
14# Build with a 1.5 GB UFS partition; the growfs rc.d script will expand
15# the partition to fill the root disk after the EC2 instance is launched.
16# Note that if this is set to <N>G, we will end up with an <N+1> GB disk
17# image since VMSIZE is the size of the UFS partition, not the disk which
18# it resides within.
19export VMSIZE=1536M
20
21# No swap space; the ec2_ephemeralswap rc.d script will allocate swap
22# space on EC2 ephemeral disks.  (If they exist -- the T2 low-cost instances
23# and the C4 compute-optimized instances don't have ephemeral disks.  But
24# it would be silly to bloat the image and increase costs for every instance
25# just for those two families, especially since instances ranging in size
26# from 1 GB of RAM to 60 GB of RAM would need different sizes of swap space
27# anyway.)
28export NOSWAP=YES
29
30vm_extra_pre_umount() {
31	# The firstboot_pkgs rc.d script will download the repository
32	# catalogue and install or update pkg when the instance first
33	# launches, so these files would just be replaced anyway; removing
34	# them from the image allows it to boot faster.
35	env ASSUME_ALWAYS_YES=yes pkg -c ${DESTDIR} delete -f -y pkg
36	rm ${DESTDIR}/var/db/pkg/repo-*.sqlite
37
38	# The size of the EC2 root disk can be configured at instance launch
39	# time; expand our filesystem to fill the disk.
40	echo 'growfs_enable="YES"' >> ${DESTDIR}/etc/rc.conf
41
42	# EC2 instances use DHCP to get their network configuration.
43	echo 'ifconfig_DEFAULT="SYNCDHCP"' >> ${DESTDIR}/etc/rc.conf
44
45	# Unless the system has been configured via EC2 user-data, the user
46	# will need to SSH in to do anything.
47	echo 'sshd_enable="YES"' >> ${DESTDIR}/etc/rc.conf
48
49	# The AWS CLI tools are generally useful, and small enough that they
50	# will download quickly; but users will often override this setting
51	# via EC2 user-data.
52	echo 'firstboot_pkgs_list="awscli"' >> ${DESTDIR}/etc/rc.conf
53
54	# The EC2 console is output-only, so while printing a backtrace can
55	# be useful, there's no point dropping into a debugger or waiting
56	# for a keypress.
57	echo 'debug.trace_on_panic=1' >> ${DESTDIR}/etc/sysctl.conf
58	echo 'debug.debugger_on_panic=0' >> ${DESTDIR}/etc/sysctl.conf
59	echo 'kern.panic_reboot_wait_time=0' >> ${DESTDIR}/etc/sysctl.conf
60
61	# The console is not interactive, so we might as well boot quickly.
62	echo 'autoboot_delay="-1"' >> ${DESTDIR}/boot/loader.conf
63	echo 'beastie_disable="YES"' >> ${DESTDIR}/boot/loader.conf
64
65	# The EC2 console is an emulated serial port.
66	echo 'console="comconsole"' >> ${DESTDIR}/boot/loader.conf
67
68	# Some older EC2 hardware used a version of Xen with a bug in its
69	# emulated serial port.  It is not clear if EC2 still has any such
70	# nodes, but apply the workaround just in case.
71	echo 'hw.broken_txfifo="1"' >> ${DESTDIR}/boot/loader.conf
72
73	# Some EC2 instances suffer a significant (~40%) reduction in
74	# throughput when using blkif indirect segment I/Os.  Disable this
75	# by default for now.
76	echo 'hw.xbd.xbd_enable_indirect="0"' >> ${DESTDIR}/boot/loader.conf
77
78	# The first time the AMI boots, the installed "first boot" scripts
79	# should be allowed to run:
80	# * ec2_configinit (download and process EC2 user-data)
81	# * ec2_fetchkey (arrange for SSH using the EC2-provided public key)
82	# * growfs (expand the filesystem to fill the provided disk)
83	# * firstboot_freebsd_update (install critical updates)
84	# * firstboot_pkgs (install packages)
85	touch ${DESTDIR}/firstboot
86
87	return 0
88}
89