Bienvenue

StackNGO est une plateforme cloud pour développeurs. Vous décrivez ce que vous voulez faire tourner dans des manifestes YAML, vous les appliquez avec la CLI sng, et la plateforme s'occupe du reste : conteneurs, réseau, certificats, stockage, secrets, DNS, registre d'images, supervision. Vous n'administrez aucun serveur.

sng sso login
sng tenant use acme
sng template gen App web
sng apply web.yml

Quelques minutes plus tard, votre application répond sur https://web-web.acme.dev.stackngo.app.

Trois façons d'utiliser StackNGO

Outil	Pour qui	Où en lire plus
Manifestes (App, SSMSecret, DNSRecord, …)	Tout le monde : c'est la source de vérité de votre tenant, versionnable dans git	Référence des manifestes
CLI sng	Développeurs et pipelines CI : applique les manifestes, lit l'état, pilote les opérations	Référence de la CLI
API HTTP	Intégrations, SDK, outillage maison : la même surface que la CLI, en REST + JSON	Référence de l'API

La console web (https://console.dev.stackngo.fr) repose sur la même API.

Comment lire cette documentation

• Démarrer : un parcours de quinze minutes, de l'installation de la CLI à une première application en ligne. Commencez ici.
• Guides : une page par tâche (déployer depuis docker compose, ajouter un domaine, faire tourner un secret, déployer depuis GitLab CI…). Chaque guide renvoie vers la référence pour le détail des champs.
• Référence : exhaustive et générée depuis le code pour les champs et les commandes. Trois entrées dans la barre de navigation : Manifestes, CLI, API.
• Sécurité et confidentialité : ce que la plateforme garantit pour vos données, vos accès et vos applications.
• Dépannage : index des conditions, des codes d'erreur et des messages.

Statut des fonctionnalités

Chaque page porte un badge en tête :

• Disponible : déployée et prise en charge.
• Bêta : en cours de déploiement, l'interface décrite est celle de la prochaine livraison et peut encore évoluer.
• À venir : en préparation, la page décrit l'interface cible pour recueillir vos retours.

Les manifestes sont tous en version v1alpha1. La politique de compatibilité explique ce que cela implique.

Quelques principes à connaître

• Un tenant, un espace isolé. Tout ce que vous créez vit dans votre tenant. Vous n'avez jamais à le préciser dans un manifeste : il découle de votre session.
• Déclaratif. Vous décrivez l'état voulu ; la plateforme l'applique, généralement en moins d'une minute, et vous dit où elle en est dans le status de chaque ressource.
• Sûr par défaut. Un service n'accepte que le trafic que vous autorisez, les conteneurs ne tournent jamais en administrateur, les secrets ne figurent jamais dans vos manifestes, et une permission manquante vaut toujours un refus.
• Tout passe par l'API. CLI, console, CI : même authentification, mêmes permissions, mêmes réponses.

Prêt ? Installez la CLI.