https://github.com/yaacov/mtv-demo-builder
Collections of scripts to build .qcow2 image running migration toolkit for virtualization
https://github.com/yaacov/mtv-demo-builder
Last synced: 7 months ago
JSON representation
Collections of scripts to build .qcow2 image running migration toolkit for virtualization
- Host: GitHub
- URL: https://github.com/yaacov/mtv-demo-builder
- Owner: yaacov
- Created: 2024-07-10T11:26:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T11:36:26.000Z (11 months ago)
- Last Synced: 2025-01-23T09:43:12.077Z (8 months ago)
- Language: Shell
- Size: 42 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MTV Demo Builder
This repository contains a collection of scripts to build a .qcow2 image running the Migration Toolkit for Virtualization (MTV).
## Architecture
The MTV Demo Builder is structured with several scripts designed to create and configure a Fedora cloud image. These scripts include:
1. **mtv-image-builder**: This script downloads the Fedora cloud .qcow image, sets up a demo user, and installs the setup and first-boot scripts.
2. **mtv-image-setup**: This script runs on the .qcow image before the first boot. It is used by the builder to set up the image.
3. **first-boot**: This script runs after the first boot, builds a kind cluster, downloads the necessary container images, and installs MTV on the cluster.
4. **kind-control-plan.service**: A service script to manage the kind cluster control plane.
## Scripts
### mtv-image-builder
This script is responsible for:
- Downloading the Fedora cloud .qcow image.
- Setting up the demo user.
- Installing the setup and first-boot scripts that will build a kind cluster and install MTV on the first boot.
### mtv-image-setup
This script runs on the .qcow image before the first boot and is used by the builder to set up the image.
### first-boot
This script runs after the first boot, builds the cluster, downloads the necessary container images, and installs MTV on the cluster.
### kind-control-plan.service
A service script that manages the kind cluster control plane.
## Building the image
```sh
bash mtv-image-builder.sh
```
The script will download the Fedora clound image, customize it, and ask to run for the first boot.
If successful the script will create a file `fedora-cloud.qcow2` that will include a fedora machine with demo user running kind cluster with MTV installed.
## Result
After the first boot, we have a .qcow image with a kind cluster installed and MTV running in the cluster. The VM will expose ports to access the UI, API services, and an SSH server.
- **Migration Toolkit Web User Interface**: `https://[VM IP or hostname]:30443`
- **Migration Toolkit Inventory Server**: `https://[VM IP or hostname]:30444/providers`
- **SSH Server**: Port 2222 (user: `demo`, password: `demo`)
To log into the machine via SSH:
```sh
ssh -p 2222 demo@[VM IP or hostname]
# Password: demo
```
## Running the QCOW Image
To run the .qcow image, use the following command:
```sh
IMAGE=mtv-demo-clean.qcow2
curl -LO https://github.com/yaacov/mtv-demo-builder/releases/download/v0.0.3/${IMAGE}.tar.gz
tar -xzvf ${IMAGE}.tar.gz
# IMPORATNT: on first boot, wait for first boot script to complete.
qemu-kvm -name mtv-demo \
-m 4096 -smp 4 \
-cpu host \
-drive file=${IMAGE},if=virtio \
-netdev user,id=net0,hostfwd=tcp::2222-:22,hostfwd=tcp::30443-:30443,hostfwd=tcp::30444-:30444 \
-device virtio-net,netdev=net0 \
-nographic
```
Replace `${IMAGE}` with the path to your .qcow2 image file.
After the VM finish booting and a login prompt apear, wait for the first boot script to start and finsh (only on first boot), then go to web console at: https://[VM IP or hostname]:30443
Notes:
- Set virtual machine memory to 4Gi or more.
- On graphic boot the first boot script output is hidded, to monitor progress you can login as demo user and check the machine logs.
## Contact
For any issues or questions, please open an issue in this repository.