Startget CLI

Le CLI officiel pour interagir avec Startget Cloud. Il vous permet de gérer votre authentification et de piloter vos services (zone DNS, configurations de serveurs web Nginx, certificats SSL Certbot, et détails de domaines) directement depuis votre terminal, suivant une approche modulaire et structurée.

Installation

Installez le package globalement via npm :

npm install -g @startget-cloud/cli

Vérifiez que l'installation s'est bien déroulée :

startget --version

Authentification

1. Connexion (login)

Permet de s'authentifier auprès de l'API Gateway de Startget.

startget login [--email <email>] [--tenant <tenant>] [--api-url <url>]

• Comportement : Si l'e-mail ou le mot de passe ne sont pas fournis sous forme d'options (flags), le CLI vous invitera à les saisir de manière sécurisée (saisie de mot de passe masquée).
• Options :
  • --email : Adresse e-mail de votre compte Startget.
  • --tenant : Nom du tenant (défaut : cloud).
  • --api-url : URL de l'API Gateway (défaut : https://api.gateway.startget.cloud).
  • --json : Renvoie les informations de session au format JSON.

2. État de session (whoami)

Affiche les informations sur l'utilisateur actuellement connecté, son tenant, ses permissions et les domaines autorisés.

startget whoami [--json]

3. Déconnexion (logout)

Invalide les jetons d'accès actuels sur la Gateway et nettoie la session locale.

startget logout [--json]

Service Domaine (domain)

Permet d'obtenir des détails sur un domaine actif.

startget domain <info> <domain> [--json]

Actions disponibles :

• info : Récupère les détails généraux (Registrar, dates de création/expiration, serveurs d'hébergement/mail liés, statut DNS local, etc.).

  startget domain info devgroup.ga

Service Tarification (pricing)

Permet de vérifier la disponibilité et de consulter la grille des tarifs des extensions de domaine (TLDs) avec option de conversion de devises.

startget pricing domain [domain_name] [--currency <devise>] [--json]

Actions disponibles :

• Consulter le catalogue complet (si aucun domaine n'est spécifié) :

  startget pricing domain
  # Par défaut, le CLI affiche le prix final Startget en XAF (marge incluse)
  startget pricing domain --currency USD
  startget pricing domain -c XAF

• Vérifier la disponibilité et le tarif d'un domaine spécifique :

  startget pricing domain devgroup.ga
  # Avec conversion en dollars :
  startget pricing domain devgroup.ga --currency USD

Service DNS (dns)

Le sous-groupe de commandes dns vous permet de gérer les entrées DNS de vos domaines gérés par Startget (via le registrar LWS).

startget dns <action> <domain> [options]

Actions disponibles :

• list : Affiche la liste des enregistrements DNS actifs.

  startget dns list devgroup.ga

• add : Crée un nouvel enregistrement DNS.

  startget dns add devgroup.ga --type A --name test --value 1.2.3.4 [--ttl 3600]

• update : Met à jour un enregistrement DNS existant.

  startget dns update devgroup.ga --id 12345 --type A --name test --value 5.6.7.8

• delete : Retire un enregistrement DNS de la zone.

  startget dns delete devgroup.ga --id 12345

Service Hébergement (hosting)

Regroupe toutes les commandes d'administration liées à vos serveurs d'hébergement web publics (Nginx et certificats SSL).

startget hosting <config|ssl> <action> [hostname] [options]

1. Configurations Serveur Web (hosting config)

• list : Liste les fichiers de configuration de serveurs web actifs.

  startget hosting config list

• show : Affiche le contenu d'un fichier de configuration Nginx existant pour un hôte.

  startget hosting config show test.devgroup.ga

• set : Applique directement un contenu brut de configuration Nginx.

  startget hosting config set test.devgroup.ga --content "server { ... }"
  # ou via un fichier local :
  startget hosting config set test.devgroup.ga --file ./nginx.conf

• edit : Ouvre interactivement la configuration Nginx de l'hôte ciblé dans l'éditeur de votre terminal ( nano, vi ), la compare et la sauvegarde automatiquement en cas de modification.

  startget hosting config edit test.devgroup.ga

• reverse-proxy : Génère et applique une configuration de reverse proxy Nginx.

  startget hosting config reverse-proxy test.devgroup.ga --target-host 127.0.0.1 --target-port 8080

• static : Génère et applique une configuration de site statique Nginx.

  startget hosting config static test.devgroup.ga --root /var/www/html [--relative /app] [--index index.html] [--fallback]

• delete : Supprime la configuration web d'un hôte.

  startget hosting config delete test.devgroup.ga

• reload : Recharge la configuration Nginx sur l'ensemble de vos serveurs d'hébergement.

  startget hosting config reload

2. Certificats SSL (hosting ssl)

• issue : Demande ou renouvelle un certificat SSL Let's Encrypt (Certbot) pour un hôte.

  startget hosting ssl issue test.devgroup.ga --email [email protected] [--dry-run] [--force-renew]

Automatisation et intégration (Format JSON)

Pour faciliter l'intégration de Startget CLI dans vos scripts CI/CD (GitHub Actions, GitLab CI, scripts Bash, etc.), vous pouvez ajouter l'option --json à n'importe quelle commande pour obtenir une sortie structurée en JSON :

startget hosting config list --json

Configuration & Sécurité

Variables d'environnement

Le CLI reconnaît les variables d'environnement suivantes pour éviter de saisir manuellement les paramètres à chaque appel :

STARTGET_API_URL=https://api.gateway.startget.cloud
STARTGET_TENANT=cloud
[email protected]
STARTGET_PASSWORD=votre_mot_de_passe

Stockage des sessions

Le CLI conserve de manière sécurisée votre jeton d'accès et votre jeton de rafraîchissement localement dans votre répertoire utilisateur :

~/.startget/config.json

Ce répertoire et ce fichier de configuration sont créés avec les permissions strictes 0600 (lecture/écriture restreintes à votre utilisateur système uniquement).

Mode Agent

Le CLI peut maintenant fonctionner en mode conversationnel après authentification. Le principe est simple :

• vous vous connectez d'abord avec startget login
• vous fournissez une clé API DeepSeek au CLI
• vous lancez startget agent chat
• le modèle propose des actions, et le CLI exécute uniquement les outils Startget autorisés

Enregistrer la clé DeepSeek localement

startget agent key set

Le CLI n'écrit plus la clé en clair dans ~/.startget/config.json.

• macOS : stockage dans le Keychain système
• Linux avec secret-tool : stockage dans le coffre libsecret
• sinon : pas de persistance, utilisez DEEPSEEK_API_KEY

Alternative sans stockage local :

export DEEPSEEK_API_KEY="votre_cle"

Lancer le chat agent

startget agent chat

Changer de modèle

startget agent chat --model deepseek-v4-flash

Vérifier l'état local de la clé

startget agent key status

Ce que l'agent sait faire

• lire le profil connecté
• lister et vérifier les prix domaines
• lire les informations d'un domaine
• lire et gérer une zone DNS
• lire les configurations web hosting
• recharger Nginx
• lancer une émission de certificat SSL

Les actions sensibles demandent une confirmation locale avant exécution. Le terminal affiche aussi les phases d'analyse et d'exécution, avec un rendu plus lisible des résultats en tableaux et listes.