mirror of
https://codeberg.org/knightsub9/lxcafe.git
synced 2026-07-19 19:30:16 +02:00
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# lxcafe Repository
|
|
|
|
Linux Mint post-installation scripts.
|
|
|
|
## Structure
|
|
|
|
- **post_installation_script/** - Main post-installation scripts for Linux Mint XFCE
|
|
- **post_installation_script_test/** - Docker based testing environment for script development
|
|
- **.agents/** - Agent instructions for AI-assisted development
|
|
|
|
See individual README files in each directory for detailed information on usage and development.
|
|
|
|
## Test post installation script
|
|
To test the full functionality of post-installation script in a safe, isolated environment, use VirtualBox or similar virtualization
|
|
software to create a virtual machine with Linux Mint XFCE. Then, copy the script to the virtual machine and run it there.
|
|
This allows you to test the script without affecting your main system.
|
|
You can also make use of snapshot feature of the virtualization software to easily revert to a clean state after testing,
|
|
e.g. state directly after Linux Mint installation, before running the post-installation script.
|
|
This way you can test the script multiple times without needing to reinstall Linux Mint each time.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
## Release Process
|
|
|
|
This project uses a two-step release process.
|
|
|
|
### Versioning
|
|
- Version is stored in `VERSION` file (format: v0, v1, v2, ...)
|
|
- Major version increments only
|
|
- Script version stored in `SCRIPT_VERSION` variable
|
|
|
|
### Step 1: Prepare Release
|
|
- Make sure you are on main branch with no local changes. Script will abort otherwise
|
|
Run from repository root:
|
|
```bash
|
|
./01_prepare_release.sh
|
|
```
|
|
|
|
The script will:
|
|
- Update VERSION file and SCRIPT_VERSION in the script
|
|
- Create a release branch (e.g., `release/v1`)
|
|
- Push the release branch
|
|
|
|
### After step 1 (manual)
|
|
- Create and merge PR from release branch to main
|
|
|
|
### Step 2: Finalize Release (After PR Merged)
|
|
Run from repository root:
|
|
```bash
|
|
./02_finalise_release.sh
|
|
```
|
|
|
|
The script will:
|
|
- Create and push tag for release version to main
|
|
|
|
### After step 2 (manual)
|
|
- Create a release in gitea
|
|
|
|
### Requirements
|
|
- Clean working tree (no uncommitted changes)
|
|
- Git remote configured (origin) |