denv-r — CLI DENV-R

Pourquoi denv-r et pas denv-r ? Le paquet denv-r existe déjà sur PyPI et appartient à une autre société de cloud (denvrdata.com) ; il expose un module denv-r. Les deux ne peuvent pas cohabiter dans un même environnement Python. Notre marque est DENV-R : le paquet s'appelle donc denv-r, le module denv_r et la commande denv-r.

Pilotez DENV-R au clavier : tout ce que fait la console se fait ici en ligne de commande (scripts, CI/CD, automatisation). Enveloppe mince sur l'API REST, sans aucune dépendance externe (bibliothèque standard Python).

Installation

pip install denv-r-cli   # depuis PyPI (recommandé) : le paquet s'appelle denv-r-cli, la commande reste denv-r

Ou depuis les sources :

pip install ./cli           # depuis la racine du dépôt
python cli/denv_r.py --help  # sans installer

La commande installe l'exécutable denv-r (vérifiez avec denv-r --version).

Configuration

Créez un jeton d'accès depuis la console (Profil → API), puis :

denv-r configure            # enregistre URL + jeton dans ~/.config/denv-r/config.json
# ou par variables d'environnement :
export DENVR_API_URL="https://console.denv-r.com"
export DENVR_TOKEN="dvr_votre_jeton"

Priorité de résolution : option --url/--token > variable d'environnement > fichier de config. Un jeton lecture seule suffit pour lire ; les écritures exigent un jeton lecture-écriture.

Exemples

denv-r status                                   # santé de l'infrastructure
denv-r buckets list                             # mes espaces
denv-r buckets create --nom archives-2026 --offre standard --taille-to 20
denv-r buckets update 42 --taille-to 50 --no-versioning
denv-r buckets purge 42                         # vide puis supprime (tâche de fond)

denv-r creds create --nom ci --type restreinte --buckets 42,43
denv-r creds delete 7

denv-r clouds connect --provider ovh --endpoint s3.gra.io.cloud.ovh.net \
      --region gra --access-key AK --secret-key SK --no-lecture-seule
denv-r clouds resync 3
denv-r migrate --src-kind cloud --src-connexion 3 --src-bucket vieux-backup --dst-kind denvr
denv-r adopt --bucket photos --offre standard --connexion-id 3 --taille-to 4

# Control plane déclaratif (« Terraform du stockage ») :
denv-r policies set --type retention --params '{"min_jours": 90}'
denv-r plan                                     # dérive : intention vs réel
denv-r apply                                    # remédie les dérives auto-éligibles

# Le socle de calcul mutualisé DENV-R : un espace (réseau privé + cluster), des machines, des ports publiés.
denv-r espaces list                              # mes espaces + les tailles au tarif (S, M, L, VPC)
denv-r espaces create --code acme --taille S --wait   # prêt en ~10 min ; facturé à l'heure, sur la facture du mois suivant
denv-r machines create 12 --modele debian12 --hostname bastion --coeurs 2 --memoire-mo 2048 --disque-go 20 \
      --cles-ssh ~/.ssh/id_ed25519.pub
denv-r ports set 12 tcp:8443:10.41.0.20:443,udp:51820:10.41.0.20:51820 --wait   # la liste COMPLÈTE, appliquée sur les 2 passerelles
denv-r ports clear 12 --wait                     # referme tout
denv-r espaces close 12                          # demande la fermeture (ticket à l'équipe, qui détruit sur le socle)

# Revendeur : créer + provisionner un client en un appel (renvoie ses clés S3) :
denv-r clients create --email client@exemple.fr --societe "Client SARL" --provision
denv-r clients provision 123                     # provisionne un client déjà créé
denv-r clients list                              # état (is_active / provisionné) de chaque client

Toute commande accepte --help. La sortie est du JSON (facile à enchaîner avec jq).

Revendeurs

Les commandes d'écriture et le control plane acceptent --client-id <id> pour agir au nom d'un client de votre portefeuille (jeton revendeur requis).

Licence

Apache License 2.0. Le code est libre d'être lu, audité, modifié et redistribué ; la marque DENV-R reste celle de DENV-R SAS.