bisos.vagrantBaseBoxes 0.23

bisos.vagrantBaseBoxes: Facilities for Creating and Managing Vagrant Packer Base Boxes

Contents

• Overview

• Table of Contents TOC

• A Standalone Piece of BISOS — ByStar Internet Services Operating System

• Installation of bisos.vagrantBaseBoxes Package

  • Installation With pip

  • Installation With pipx

• Usage of bisos.vagrantBaseBoxes Package

  • First Install the packer box specifications.

  • vagrantBoxProc.cs Menu

  • Build, Add, Run and then Clean All Base Boxes with vagrantBoxProc.cs

  • Build, Add, Run and then Clean a Specific Base Box with vagBox.cs (a planted vagrantBoxProc.cs seed)

• BISOS Use of Built Vagrant Boxes

• Support

Blee Panel Controls:	Show-All : Overview : Content : (1) : S&Q : Save : Quit : Bury
Panel Links:	Repo Blee Panel – Blee Panel
See Also:	At PYPI : bisos.PyC S

Overview

bisos.vagrantBaseBoxes provides various facilities for creation and management of Vagrant Packer Base Boxes.

bisos.vagrantBaseBoxes is a python package that uses the PyCS-Framework for its implementation. It is a BISOS-Capability and a Standalone-BISOS-Package.

bisos.vagrantBaseBoxes is data driven. By itself it is incomplete. It operates on well structured directories which contain packer base box specifications. Separating packer specifications from the bisos.vagrantBaseBoxes package allows for wide usage. BISOS-related packer specifications that can be processed with bisos.vagrantBaseBoxes are available at:

https://github.com/bxObjects/bro_vagrantDebianBaseBoxes

Table of Contents TOC

• Overview

• A Standalone Piece of BISOS — ByStar Internet Services Operating System

• Installation of bisos.vagrantBaseBoxes Package

  • Installation With pip

  • Installation With pipx

• Usage of bisos.vagrantBaseBoxes Package

  • First Install the packer box specifications.

  • vagrantBoxProc.cs Menu

  • Build, Add, Run and then Clean All Base Boxes with vagrantBoxProc.cs

  • Build, Add, Run and then Clean a Specific Base Box with vagBox.cs (a planted vagrantBoxProc.cs seed)

• BISOS Use of Built Vagrant Boxes

• Support

A Standalone Piece of BISOS — ByStar Internet Services Operating System

Layered on top of Debian, BISOS: (By* Internet Services Operating System) is a unified and universal framework for developing both internet services and software-service continuums that use internet services. See Bootstrapping ByStar, BISOS and Blee for information about getting started with BISOS.

BISOS is a foundation for The Libre-Halaal ByStar Digital Ecosystem which is described as a cure for losses of autonomy and privacy in a book titled: Nature of Polyexistentials

bisos.vagrantBaseBoxes is a standalone piece of BISOS. It can be used as a self-contained Python package separate from BISOS. Follow the installation and usage instructions below for your own use.

Installation of bisos.vagrantBaseBoxes Package

The sources for the bisos.vagrantBaseBoxes pip package are maintained at: https://github.com/bisos-pip/vagrantBaseBoxes.

The bisos.vagrantBaseBoxes pip package is available at PYPI as https://pypi.org/project/bisos.vagrantBaseBoxes

You can install bisos.vagrantBaseBoxes with pip or pipx.

Installation With pip

If you need access to bisos.vagrantBaseBoxes as a python module, you can install it with pip:

pip install bisos.vagrantBaseBoxes

See below for this packages list of commands.

Installation With pipx

If you only need access to bisos.vagrantBaseBoxes on command-line, you can install it with pipx:

pipx install bisos.vagrantBaseBoxes

The following commands are made available:

• vagrantBaseBoxes-sbom.cs (Software Bill of Material for vagrant and packer)

• vagrantBoxProc.cs (The primary command line for building, adding, running and cleaning base boxes.)\ (Also a seed for vagBox.cs)

• exmpl-vagBox.cs (Example for planting based on the vagrantBoxProc.cs as seed.)

• vagrantCommonCmnds.cs (A cheat sheet for common vagrant commands.)

Usage of bisos.vagrantBaseBoxes Package

First Install the packer box specifications.

Clone the packer box specifications somewhere. Perhaps in your home directory.

git clone https://github.com/bxObjects/bro_vagrantDebianBaseBoxes.git

For BISOS we use the /bisos/git/bxRepos/bxObjects canonical directory as a base for cloning bro_{vagrantDebianBaseBoxes}.

vagrantBoxProc.cs Menu

Run:

vagrantBoxProc.cs

Without any parameters and arguments, vagrantBoxProc.cs gives you a menu of common invokations.

Build, Add, Run and then Clean All Base Boxes with vagrantBoxProc.cs

Run:

find  /bisos/git/bxRepos/bxObjects/bro_vagrantDebianBaseBoxes/qemu -print | grep pkr.hcl |  vagrantBoxProc.cs --force="t"  -i vagBoxPath_buildAddRun

That will build, then add the boxes and then do a vagrant up on each of pkr.hcl files in the bro_{vagrantDebianBaseBoxes}/qemu directory hierarchy.

Next verify that all the boxes have been built properly by visiting them as VMs.

To clean them all – get rid of the build artifacts and vagrant destroy the machines – run:

find  /bisos/git/bxRepos/bxObjects/bro_vagrantDebianBaseBoxes/qemu -print | grep pkr.hcl |  vagrantBoxProc.cs --force="t"  -i vagBoxPath_clean

Build, Add, Run and then Clean a Specific Base Box with vagBox.cs (a planted vagrantBoxProc.cs seed)

Go to:

cd /bisos/git/bxRepos/bxObjects/bro_vagrantDebianBaseBoxes/qemu/debian/13/trixie/amd64/netinst

In there run:

vagBox.cs

vagBox.cs gives you a menu of common invokations.

To Build, Add and Run just the us.pkr.hcl box, execute:

vagBox.cs --force="t"  -i vagBoxPath_buildAddRun us.pkr.hcl

Next verify that your specific box has been built properly by visiting it as a VM.

To clean it – git rid of the build artifacts and vagrant destroy the machines – run:

vagBox.cs --force="t"  -i vagBoxPath_clean us.pkr.hcl

BISOS Use of Built Vagrant Boxes

In BISOS, we start from a Debian Vagrant Box which we consider as “fresh Debian” and we augment it to to become “Raw-BISOS”. This process is described in: https://github.com/bxgenesis/start

Based on a platform BPO (ByStar Portable Object), Raw-BISOS can then be further augmented to become a reproducible specific BISOS-Platform.

Support

For support, criticism, comments, and questions, please contact the author/maintainer

Mohsen Banan at: http://mohsen.1.banan.byname.net/contact