Manifestes
Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.
Un manifeste est un document YAML avec apiVersion, kind, metadata.name et spec.
Tous les kinds sont en version v1alpha1. Cette section documente chaque kind champ par
champ, avec le statut observé, les conditions et les erreurs fréquentes.
metadata ne contient que name. Ne précisez pas de tenant : il est déduit de votre session.
Les labels, les annotations et toute autre clé de metadata sont refusés.
Kinds appliqués avec sng apply
Ce sont les manifestes que vous écrivez et versionnez. Ils passent par
sng apply, qui les valide (règles de cohérence comprises) avant de
les enregistrer dans l'état désiré de votre tenant.
| Kind | Groupe | Rôle | Statut |
|---|---|---|---|
| App | deploy.stackngo.io | Services, jobs, cronjobs façon docker compose | Disponible |
| SSMSecret | ssm.stackngo.io | Secret déclaré, généré et tourné par la plateforme | Disponible |
| CDNSite | cdn.stackngo.io | Site statique servi depuis un bucket | Disponible |
| IAMApplication | iam.stackngo.io | Client OIDC pour vos propres applications | Disponible |
| IAMRole | iam.stackngo.io | Rôle pour vos utilisateurs finaux | Disponible |
| IAMGroup | iam.stackngo.io | Groupe pour vos utilisateurs finaux | Disponible |
| RegistryRepository | registry.stackngo.io | Dépôt d'images OCI | Disponible |
| RegistryAccessKey | registry.stackngo.io | Clé d'accès au registre, pour tirer ou pousser des images | Disponible |
| DNSZone | dns.stackngo.io | Domaine que vous apportez | Bêta |
| DNSRecord | dns.stackngo.io | Enregistrement DNS dans une de vos zones | Bêta |
| Monitor | monitoring.stackngo.io | Sonde d'uptime HTTP, TCP, ICMP ou DNS | Bêta |
| NotificationChannel | monitoring.stackngo.io | Destination des alertes | Bêta |
| StatusPage | monitoring.stackngo.io | Page de statut publique | Bêta |
| MaintenanceWindow | monitoring.stackngo.io | Fenêtre de maintenance planifiée | Bêta |
Kinds gérés par l'API d'identité
Ces ressources décrivent des permissions. Vous ne les écrivez pas vous-même : elles sont
produites par sng tenant policy et sng tenant oidc (ou les routes /v1/iam/*), et la
plateforme les enregistre dans l'état désiré de votre tenant. Les pages de référence servent à lire ce
qui a été créé et à comprendre son effet.
| Kind | Groupe | Rôle | Statut |
|---|---|---|---|
| IAMPolicy | iam.stackngo.io | Document de permissions (Allow/Deny, actions, ressources) | Disponible |
| IAMPolicyBinding | iam.stackngo.io | Attache une policy à des utilisateurs, rôles, machines, trusts | Disponible |
| IAMOIDCTrust | iam.stackngo.io | Fédération d'un fournisseur OIDC (CI) | Bêta |
Kinds en préparation
L'interface est publiée pour recueillir vos retours. Rien n'est encore applicable.
| Kind | Groupe | Rôle | Statut |
|---|---|---|---|
| Workspace | tofu.stackngo.io | Module OpenTofu appliqué depuis le tenant | À venir |
| Provider | tofu.stackngo.io | Configuration d'un provider OpenTofu | À venir |
| GeneratedAPI | apibuilder.stackngo.io | API Go générée depuis des modèles | À venir |
| Model, View | apibuilder.stackngo.io | Briques d'une API générée | À venir |
| MailProvider, MailUser, MailTemplate | mail.stackngo.io | Envoi d'e-mails : serveur SMTP, expéditeur, gabarit | Bêta |
Lire une page de référence
Toutes les pages suivent le même plan : à quoi ça sert, un exemple minimal, un exemple complet
commenté, le tableau des champs (généré depuis le code, donc toujours à jour), les règles de
validation croisées, le statut et les conditions, ce qui se passe quand vous supprimez, les
erreurs fréquentes. Les
conventions communes expliquent ce que vous retrouverez partout :
conditions, observedGeneration, politiques de suppression.