julesreyn / mp

Multipass Instance Manager - Python 3

This project provides a library for managing Linux instances using Multipass.

Features

• Generate unique instance names
• Launch new instances with specified parameters
• Upload configuration files to instances
• Install prerequisites on instances
• Initialize new instances with default or specified parameters

Usage

The main entry point of the application is the init_instance function in init-vm.py. This function initializes a new instance with the specified or default parameters.

Here's an example of how to use it:

python3 init-vm.py

If you want to use the library in your own code, you can import the init_instance function and call it like this:

from init-vm import init_instance

# Initialize a new instance with default parameters
init_instance()

Configuration

You can configure the default parameters for new instances by modifying the following constants in init-vm.py:

DEFAULT_INSTANCE_IMAGE: The image of the instance (default: "22.04") DEFAULT_INSTANCE_VCPUS: The number of CPUs (default: "1") DEFAULT_INSTANCE_MEMORY: The amount of memory (default: "2G")

Logging

The application logs its activity to a file in the logs/instances directory. The log file is named init-vm-.log, where is the date and time when the application was started.

The logs are also sended to Sysadmin's discord channel with the logger function. This function can report multiple levels of logs: INFO, WARNING, ERROR, CRITICAL.

All logs are saved, but only the WARNING, ERROR and CRITICAL logs are sended to the sysadmin's discord channel. You can find in the discord embed message :

• The log level
• The log message
• The log timestamp
• Instance name

Contributing

If you want to contribute to this project, you can fork the repository and submit a pull request with your changes. Please make sure to follow the coding standards and write tests for your code.