?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.61 KB

/proc/thread-self/root/opt/cloudlinux/venv/lib/python3.11/site-packages/clconfigure/Readme.md

Text Base64

# Overview

This is a short overview of what is going on in this tool.

## Idea

cloudlinux-reconfigure automatically updates system configuration according to
"specification" of different editions. Right now "specifications" are defined
in `spec/` package as python scripts with the only method `provision(...)`.

There are some limitations that developers should stick to:
- `provision` method *must* be able to configure server no matter what edition was 
  installed previously. This means, e.g. if we make transition between `Admin` and `Solo`
  the latter is responsible for erasing `cloudlinux-admin-meta` package before installation
  of the `cloudlinux-solo-meta`

## Future

Here are couple notes for the future

### Provisioning responsibilities
Maybe we can add additional `deprovision` method which will be responsible for the 
cleanup of the edition that we are leaving. This will shift the responsibility e.g.
of removing meta packages to the module which performed provisioning previously.

On the other hand, it will increase migration time.

### Project structure
We can consider grouping actions not by the `edition`, but by the `project`, e.g.
```
spec/
    accelerate_wp/
        provision(edition, ...)
        deprovision(edition, ...)
    cagefs/
        provision(edition, ...)
        deprovision(edition, ...)
    lve-utils/
        provision(edition, ...)
        deprovision(edition, ...)
```

### Ansible?
We can use ansible playbooks instead of python to describe provisioning.
User-friendly playbooks with wide possibilities and also options like dry-run
which allow us to draw nice-looking progress for user.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
cli DIR	-	drwxr-xr-x	2026-03-05 22:36:41	Edit Download recursive recursive
spec DIR	-	drwxr-xr-x	2026-03-05 22:36:41	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2026-03-05 22:40:02	Edit Download recursive recursive
awp.py	1.75 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
cagefs.py	1.81 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
clpro.py	868 B	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
files.py	933 B	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
limits.py	2.86 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
linksafe.py	1.75 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
lve.py	965 B	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
packages.py	3.18 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
Readme.md	1.61 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
services.py	2.29 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
watcher.py	4.94 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive
__init__.py	3.09 KB	lrw-r--r--	2026-02-17 10:47:15	Edit Download recursive recursive

Directory Contents