xref: /spdk/scripts/vagrant/create_vbox.sh (revision 9239ed33f6d988b0ed361db64ccd27eacdd367e6)
1#!/usr/bin/env bash
2
3# create_vbox.sh
4#
5# Creates a virtual box with vagrant in the $PWD.
6#
7# This script creates a subdirectory called $PWD/<distro> and copies the Vagrantfile
8# into that directory before running 'vagrant up'
9
10set -e
11
12VAGRANT_TARGET="$PWD"
13
14DIR="$(cd "$(dirname $0)" && pwd)"
15SPDK_DIR="$(cd "${DIR}/../../" && pwd)"
16
17# The command line help
18display_help() {
19	echo
20	echo " Usage: ${0##*/} [-b nvme-backing-file] [-n <num-cpus>] [-s <ram-size>] [-x <http-proxy>] [-hvrldcu] <distro>"
21	echo
22	echo "  distro = <centos7 | centos8| ubuntu1604 | ubuntu1804 | ubuntu2004 |"
23	echo "            fedora31 | fedora32 | fedora33 | freebsd11 | freebsd12 | arch | clearlinux>"
24	echo
25	echo "  -s <ram-size> in MB             Default: ${SPDK_VAGRANT_VMRAM}"
26	echo "  -n <num-cpus> 1 to 4            Default: ${SPDK_VAGRANT_VMCPU}"
27	echo "  -x <http-proxy>                 Default: \"${SPDK_VAGRANT_HTTP_PROXY}\""
28	echo "  -p <provider>                   \"libvirt\" or \"virtualbox\". Default: ${SPDK_VAGRANT_PROVIDER}"
29	echo "  -b <nvme-backing-file>          Emulated NVMe options."
30	echo "                                  If no -b option is specified then this option defaults to emulating single"
31	echo "                                  NVMe with 1 namespace and assumes path: /var/lib/libvirt/images/nvme_disk.img"
32	echo "                                  -b option can be used multiple times for attaching multiple files to the VM"
33	echo "                                  Parameters for -b option: <path>,<type>,<namespaces>,<cmb>"
34	echo "                                  Available types: nvme, ocssd."
35	echo "  -c                              Create all above disk, default 0"
36	echo "  -H                              Use hugepages for allocating VM memory. Only for libvirt provider. Default: false."
37	echo "  -u                              Use password authentication to the VM instead of SSH keys."
38	echo "  -l                              Use a local copy of spdk, don't try to rsync from the host."
39	echo "  -a                              Copy spdk/autorun.sh artifacts from VM to host system."
40	echo "  -d                              Deploy a test vm by provisioning all prerequisites for spdk autotest"
41	echo "  -o                              Add network interface for openstack tests"
42	echo "  --qemu-emulator=<path>          Path to custom QEMU binary. Only works with libvirt provider"
43	echo "  --vagrantfiles-dir=<path>       Destination directory to put Vagrantfile into."
44	echo "  --package-box                   Install all dependencies for SPDK and create a local vagrant box version."
45	echo " --vagrantfile=<path>             Path to a custom Vagrantfile"
46	echo "  -r dry-run"
47	echo "  -h help"
48	echo "  -v verbose"
49	echo
50	echo " Examples:"
51	echo
52	echo "  $0 -x http://user:password@host:port fedora33"
53	echo "  $0 -s 2048 -n 2 ubuntu16"
54	echo "  $0 -rv freebsd"
55	echo "  $0 fedora33"
56	echo "  $0 -b /var/lib/libvirt/images/nvme1.img,nvme,1 fedora33"
57	echo "  $0 -b /var/lib/libvirt/images/ocssd.img,ocssd fedora33"
58	echo "  $0 -b /var/lib/libvirt/images/nvme5.img,nvme,5 -b /var/lib/libvirt/images/ocssd.img,ocssd fedora33"
59	echo
60}
61
62# Set up vagrant proxy. Assumes git-bash on Windows
63# https://stackoverflow.com/questions/19872591/how-to-use-vagrant-in-a-proxy-environment
64SPDK_VAGRANT_HTTP_PROXY=""
65
66VERBOSE=0
67HELP=0
68COPY_SPDK_DIR=1
69COPY_SPDK_ARTIFACTS=0
70DRY_RUN=0
71DEPLOY_TEST_VM=0
72SPDK_VAGRANT_DISTRO="distro"
73SPDK_VAGRANT_VMCPU=4
74SPDK_VAGRANT_VMRAM=4096
75SPDK_VAGRANT_PROVIDER="virtualbox"
76SPDK_QEMU_EMULATOR=""
77SPDK_OPENSTACK_NETWORK=0
78OPTIND=1
79NVME_DISKS_TYPE=""
80NVME_DISKS_NAMESPACES=""
81NVME_FILE=""
82NVME_AUTO_CREATE=0
83VAGRANTFILE_DIR=""
84VAGRANT_PASSWORD_AUTH=0
85VAGRANT_PACKAGE_BOX=0
86VAGRANT_HUGE_MEM=0
87VAGRANTFILE=$DIR/Vagrantfile
88
89while getopts ":b:n:s:x:p:uvcraldoHh-:" opt; do
90	case "${opt}" in
91		-)
92			case "${OPTARG}" in
93				package-box) VAGRANT_PACKAGE_BOX=1 ;;
94				qemu-emulator=*) SPDK_QEMU_EMULATOR="${OPTARG#*=}" ;;
95				vagrantfiles-dir=*) VAGRANTFILE_DIR="${OPTARG#*=}" ;;
96				vagrantfile=*) [[ -n ${OPTARG#*=} ]] && VAGRANTFILE="${OPTARG#*=}" ;;
97				*) echo "Invalid argument '$OPTARG'" ;;
98			esac
99			;;
100		x)
101			http_proxy=$OPTARG
102			https_proxy=$http_proxy
103			SPDK_VAGRANT_HTTP_PROXY="${http_proxy}"
104			;;
105		n)
106			SPDK_VAGRANT_VMCPU=$OPTARG
107			;;
108		s)
109			SPDK_VAGRANT_VMRAM=$OPTARG
110			;;
111		p)
112			SPDK_VAGRANT_PROVIDER=$OPTARG
113			;;
114		v)
115			VERBOSE=1
116			;;
117		c)
118			NVME_AUTO_CREATE=1
119			;;
120		r)
121			DRY_RUN=1
122			;;
123		h)
124			display_help >&2
125			exit 0
126			;;
127		a)
128			COPY_SPDK_ARTIFACTS=1
129			;;
130		l)
131			COPY_SPDK_DIR=0
132			;;
133		d)
134			DEPLOY_TEST_VM=1
135			;;
136		o)
137			SPDK_OPENSTACK_NETWORK=1
138			;;
139		b)
140			NVME_FILE+="${OPTARG#*=} "
141			;;
142		u)
143			VAGRANT_PASSWORD_AUTH=1
144			;;
145		H)
146			VAGRANT_HUGE_MEM=1
147			;;
148		*)
149			echo "  Invalid argument: -$OPTARG" >&2
150			echo "  Try: \"$0 -h\"" >&2
151			exit 1
152			;;
153	esac
154done
155
156shift "$((OPTIND - 1))" # Discard the options and sentinel --
157
158SPDK_VAGRANT_DISTRO="$*"
159
160case "${SPDK_VAGRANT_DISTRO}" in
161	centos[78]) ;&
162	ubuntu1[68]04 | ubuntu2004) ;&
163	fedora3[1-3]) ;&
164	freebsd1[12]) ;&
165	arch | clearlinux)
166		export SPDK_VAGRANT_DISTRO
167		;;
168	*)
169		echo "  Invalid argument \"${SPDK_VAGRANT_DISTRO}\"" >&2
170		echo "  Try: \"$0 -h\"" >&2
171		exit 1
172		;;
173esac
174
175if [ -z "$NVME_FILE" ]; then
176	TMP="/var/lib/libvirt/images/nvme_disk.img"
177	NVME_DISKS_TYPE="nvme"
178else
179	TMP=""
180	for args in $NVME_FILE; do
181		while IFS=, read -r path type namespace cmb; do
182			TMP+="$path,"
183			if [ -z "$type" ]; then
184				type="nvme"
185			fi
186			if [[ -n $cmb ]]; then
187				NVME_CMB=${NVME_CMB:+$NVME_CMB,}true
188			fi
189			NVME_DISKS_TYPE+="$type,"
190			if [ -z "$namespace" ] && [ -n "$SPDK_QEMU_EMULATOR" ]; then
191				namespace="1"
192			fi
193			NVME_DISKS_NAMESPACES+="$namespace,"
194			if [ ${NVME_AUTO_CREATE} = 1 ]; then
195				$SPDK_DIR/scripts/vagrant/create_nvme_img.sh -t $type -n $path
196			fi
197		done <<< $args
198	done
199fi
200NVME_FILE=$TMP
201
202if [ ${VERBOSE} = 1 ]; then
203	echo
204	echo DIR=${DIR}
205	echo SPDK_DIR=${SPDK_DIR}
206	echo VAGRANT_TARGET=${VAGRANT_TARGET}
207	echo HELP=$HELP
208	echo DRY_RUN=$DRY_RUN
209	echo NVME_FILE=$NVME_FILE
210	echo NVME_DISKS_TYPE=$NVME_DISKS_TYPE
211	echo NVME_AUTO_CREATE=$NVME_AUTO_CREATE
212	echo NVME_DISKS_NAMESPACES=$NVME_DISKS_NAMESPACES
213	echo NVME_CMB=$NVME_CMB
214	echo SPDK_VAGRANT_DISTRO=$SPDK_VAGRANT_DISTRO
215	echo SPDK_VAGRANT_VMCPU=$SPDK_VAGRANT_VMCPU
216	echo SPDK_VAGRANT_VMRAM=$SPDK_VAGRANT_VMRAM
217	echo SPDK_VAGRANT_PROVIDER=$SPDK_VAGRANT_PROVIDER
218	echo SPDK_VAGRANT_HTTP_PROXY=$SPDK_VAGRANT_HTTP_PROXY
219	echo SPDK_QEMU_EMULATOR=$SPDK_QEMU_EMULATOR
220	echo SPDK_OPENSTACK_NETWORK=$SPDK_OPENSTACK_NETWORK
221	echo VAGRANT_PACKAGE_BOX=$VAGRANT_PACKAGE_BOX
222	echo VAGRANTFILE=$VAGRANTFILE
223	echo
224fi
225
226export SPDK_VAGRANT_HTTP_PROXY
227export SPDK_VAGRANT_VMCPU
228export SPDK_VAGRANT_VMRAM
229export SPDK_DIR
230export SPDK_OPENSTACK_NETWORK
231export COPY_SPDK_DIR
232export COPY_SPDK_ARTIFACTS
233export DEPLOY_TEST_VM
234export NVME_CMB
235export NVME_DISKS_TYPE
236export NVME_DISKS_NAMESPACES
237export NVME_FILE
238export VAGRANT_PASSWORD_AUTH
239export VAGRANT_HUGE_MEM
240
241if [ -n "$SPDK_VAGRANT_PROVIDER" ]; then
242	provider="--provider=${SPDK_VAGRANT_PROVIDER}"
243fi
244
245if [ -n "$SPDK_VAGRANT_PROVIDER" ]; then
246	export SPDK_VAGRANT_PROVIDER
247fi
248
249if [ -n "$SPDK_QEMU_EMULATOR" ] && [ "$SPDK_VAGRANT_PROVIDER" == "libvirt" ]; then
250	export SPDK_QEMU_EMULATOR
251fi
252
253if [ ${DRY_RUN} = 1 ]; then
254	echo "Environemnt Variables"
255	printenv SPDK_VAGRANT_DISTRO
256	printenv SPDK_VAGRANT_VMRAM
257	printenv SPDK_VAGRANT_VMCPU
258	printenv SPDK_VAGRANT_PROVIDER
259	printenv SPDK_VAGRANT_HTTP_PROXY
260	printenv SPDK_QEMU_EMULATOR
261	printenv NVME_DISKS_TYPE
262	printenv NVME_AUTO_CREATE
263	printenv NVME_DISKS_NAMESPACES
264	printenv NVME_FILE
265	printenv SPDK_DIR
266	printenv VAGRANT_HUGE_MEM
267	printenv VAGRANTFILE
268fi
269if [ -z "$VAGRANTFILE_DIR" ]; then
270	VAGRANTFILE_DIR="${VAGRANT_TARGET}/${SPDK_VAGRANT_DISTRO}-${SPDK_VAGRANT_PROVIDER}"
271	export VAGRANTFILE_DIR
272fi
273
274if [ -d "${VAGRANTFILE_DIR}" ]; then
275	echo "Error: ${VAGRANTFILE_DIR} already exists!"
276	exit 1
277fi
278
279if [[ ! -f $VAGRANTFILE ]]; then
280	echo "$VAGRANTFILE is not a regular file!"
281	exit 1
282fi
283
284if [ ${DRY_RUN} != 1 ]; then
285	mkdir -vp "${VAGRANTFILE_DIR}"
286	ln -s "$VAGRANTFILE" "${VAGRANTFILE_DIR}/Vagrantfile"
287	pushd "${VAGRANTFILE_DIR}"
288	if [ -n "${http_proxy}" ]; then
289		export http_proxy
290		export https_proxy
291		if echo "$SPDK_VAGRANT_DISTRO" | grep -q freebsd; then
292			cat > ~/vagrant_pkg.conf << EOF
293pkg_env: {
294http_proxy: ${http_proxy}
295}
296EOF
297		fi
298	fi
299	mkdir -p "${VAGRANTFILE_DIR}/output"
300	vagrant up $provider
301	if [ ${VAGRANT_PACKAGE_BOX} == 1 ]; then
302		vagrant ssh -c 'sudo spdk_repo/spdk/scripts/vagrant/update.sh'
303		vagrant halt
304		vagrant package --output spdk_${SPDK_VAGRANT_DISTRO}.box
305		vagrant box add spdk/${SPDK_VAGRANT_DISTRO} spdk_${SPDK_VAGRANT_DISTRO}.box \
306			&& rm spdk_${SPDK_VAGRANT_DISTRO}.box
307		vagrant destroy
308	fi
309	echo ""
310	echo "  SUCCESS!"
311	echo ""
312	echo "  cd to ${VAGRANTFILE_DIR} and type \"vagrant ssh\" to use."
313	echo "  Use vagrant \"suspend\" and vagrant \"resume\" to stop and start."
314	echo "  Use vagrant \"destroy\" followed by \"rm -rf ${VAGRANTFILE_DIR}\" to destroy all trace of vm."
315	echo ""
316fi
317