containervmm

module
v0.0.0-...-8222204 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 21, 2021 License: Apache-2.0

README

Container Virtual Machine Manager

Run Virtual Machines and manage their lifecycle inside a Docker container.

Requirements

  • Docker
  • KVM Support

Features

  • Configure either via CLI flags or environment variables
  • Ability to configure VM resources (CPUs, memory, disk size)
  • Mount additional disks
  • Mount host volumes
  • OS network configuration automatically handled by DHCP
  • Set custom DNS and NTP servers
  • Load Ignition to configure the OS

Usage

Container Virtual Machine Manager spins up a Virtual Machine inside a container

Usage:
  containervmm [options] [flags]

Examples:
containervmm --flatcar-version=2605.6.0

Flags:
      --debug                            enable debug
      --flatcar-channel string           flatcar channel (i.e. stable, beta, alpha) (default "stable")
      --flatcar-ignition string          base64-encoded Ignition Config
      --flatcar-ignition-dir string      dir path of the Ignition config (default "/")
      --flatcar-version string           flatcar version
      --guest-additional-disks strings   guest additional disk to mount (i.e. "dockerfs:20GB")
      --guest-cpus string                guest cpus (default "1")
      --guest-dns-servers strings        guest DNS Servers. If left empty, the DNS servers given are the one of the container
      --guest-host-volumes strings       guest host volume (i.e. "datashare:/usr/data")
      --guest-memory string              guest memory (default "1024M")
      --guest-name string                guest name (default "flatcar_production_qemu")
      --guest-ntp-servers strings        guest NTP Servers. If left empty, the NTP servers set are the default one from the distro
      --guest-root-disk-size string      guest root disk size (default "20G")
  -h, --help                             help for containervmm
      --sanity-checks                    run sanity checks (GPG verification of images) (default true)

Hypervisor supported

  • QEMU - Quick EMUlator
  • AWS Firecracker (Coming)

OS/Arch Supported

  • Flatcar Container Linux by Kinvolk (amd64)

Installation

Run:

docker run -it --rm --device /dev/kvm:/dev/kvm --device /dev/net/tun:/dev/net/tun containervmm --flatcar-version=2605.6.0

Directories

Path Synopsis
cmd
pkg
api

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL