59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# Portail Infra
|
|
|
|
Portail d'outils pour administrateurs systèmes et réseau, servi par un serveur Python unique :
|
|
|
|
- **cmdb** — inventaire (machines, réseaux, IP/MAC, salles & baies), recherche Active Directory, import/export CSV, snapshots de la base
|
|
- **cert-generator** — génération de certificats SSL (clés RSA, CSR)
|
|
- **switch-config** — mapper de VLAN et export de configuration switch
|
|
|
|
Le tout accessible depuis un seul serveur, avec navigation entre les 3 apps.
|
|
|
|
## Prérequis
|
|
|
|
- [mise](https://mise.jdx.dev/) — lanceur de tâches
|
|
- [uv](https://docs.astral.sh/uv/) — gestion des dépendances et de Python
|
|
|
|
`uv` installe automatiquement **Python 3.13** et les dépendances (`ldap3`) au premier lancement — rien d'autre à installer.
|
|
|
|
Installer mise et uv :
|
|
|
|
```bash
|
|
curl https://mise.run | sh # mise
|
|
curl -LsSf https://astral.sh/uv/install.sh | sh # uv
|
|
```
|
|
|
|
## Installation
|
|
|
|
Le dossier `cmdb` est un sous-module git — cloner avec `--recurse-submodules` :
|
|
|
|
```bash
|
|
git clone --recurse-submodules <url-du-repo>
|
|
cd VERSION2
|
|
```
|
|
|
|
Sous-module déjà cloné sans l'option :
|
|
|
|
```bash
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
## Lancer
|
|
|
|
```bash
|
|
mise run run
|
|
```
|
|
|
|
Puis ouvrir **http://127.0.0.1:8000** (redirige vers la CMDB).
|
|
|
|
Équivalent direct, sans mise :
|
|
|
|
```bash
|
|
uv run server.py # port 8000 par défaut
|
|
uv run server.py 8080 # port personnalisé
|
|
```
|
|
|
|
## Notes
|
|
|
|
- **Données** : la base `cmdb/cmdb.db` et le dossier `cmdb/snapshots/` restent **locaux** (non versionnés). Sauvegarde/migration via **Export CSV** ou **Snapshots** (Préférences ⚙).
|
|
- **Active Directory** : la recherche AD nécessite `ldap3` (installé par uv). Configuration dans Préférences → Active Directory.
|
|
- **Proxy d'entreprise** : si l'accès réseau passe par un proxy, exporter `http_proxy` / `https_proxy` avant de lancer.
|