Simple Distro Kit - Virtual Machines
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.9 KiB

vm-sdk

vm-sdk is simple distro build system aimed at creating Vagrant boxes and other virtual machines.

Requirements

vm-sdk is designed to be used interactively from a terminal. It requires the following packages to be installed in addition to the dependencies required for libdevuansdk.

sudo permissions are required for the user that is running the build.

Devuan

virtualbox vagrant qemu qemu-utils

Gentoo

app-emulation/virtualbox app-emulation/vagrant app-emulation/qemu

Initial setup

After cloning the vm-sdk git repository, enter it and issue:

git submodule update --init

Updating

To update vm-sdk, go to the root dir of the git repo and issue:

git pull && git submodule update --init --recursive

Quick start

Edit the config file to match your needs. Sensible defaults are already there. Then run zsh. To avoid issues, it’s best to start a vanilla version, without preloaded config files so it doesn’t cause issues with libdevuansdk/vm-sdk functions.

; zsh -f -c 'source sdk'

Now is the time you choose the OS and (optionally) a blend you want to build the image for.

Currently supported distros

  • devuan
; load devuan

Once initialized, you can run the helper command:

; build_vagrant_dist

The image will automatically be build for you. Once finished, you will be able to find it in the dist/ directory in vm-sdk’s root.

For more info, see the doc/ directory.

Acknowledgments

Devuan’s SDK was originally conceived during a period of residency at the Schumacher college in Dartington, UK. Greatly inspired by the laborious and mindful atmosphere of its wonderful premises.

The Devuan SDK is Copyright (c) 2015-2017 by the Dyne.org Foundation

Devuan SDK components were designed, and are written and maintained by:

This source code is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this source code. If not, see http://www.gnu.org/licenses/.