Aller au contenu principal

Stack Engine (IaC)

Stack Engine est le système infrastructure-as-code de SailOps. Il permet de décrire l'état souhaité d'un projet dans un fichier YAML, puis de demander à SailOps de planifier ou appliquer les changements.

Opérations​

OpérationEndpointDescription
PlanPOST /api/v1/stack/planSimulation sans modification
ApplyPOST /api/v1/stack/applyApplique la stack au projet
ExportGET /api/v1/stack/exportExporte l'état actuel en YAML ou JSON
Commencer par un plan

Exécutez toujours plan avant apply sur un projet existant. Le résultat indique les créations, mises à jour, suppressions et ressources inchangées.

Format de fichier​

Les stacks sont des documents YAML ou JSON. Elles peuvent définir des conteneurs, services (PostgreSQL, MariaDB, Valkey, NATS, Kafka, OpenSearch, Supabase, Keycloak, WordPress), gateways, routes et connexions.

containers:
- name: api
spec:
computeClass: standard
image: ghcr.io/myorg/api:v2.0.0
resources:
cpu: 500
memory: 512
ports:
- containerPort: 8080
autoscaling:
minReplicas: 1
maxReplicas: 5
cpuThreshold: 70

services:
postgresql:
- name: main-db
version: 16
flavor: small
computeClass: standard
storage: 20Gi
databases:
- app

mariadb:
- name: wp-db
version: "11.4"
flavor: small
computeClass: standard
storage: 10Gi
databases:
- wordpress

wordpress:
- name: blog
version: "7.1.2"
flavor: small
computeClass: standard
instances: 1
siteTitle: Company Blog
adminEmail: [email protected]
storage:
size: 1073741824
storageClass: standard
database:
existing: wp-db

Tags des ressources​

Les requêtes apply et plan acceptent un objet tags de niveau supérieur qui définit des tags par défaut sur chaque ressource créée par cette invocation :

{
"stack": "...",
"tags": { "environment": "staging", "team": "backend" }
}

Chaque ressource peut remplacer ces valeurs par défaut avec son propre champ tags. Un objet vide explicite {} efface tous les tags pour cette ressource. En l'absence de tags au niveau de la ressource et de valeurs par défaut, les tags existants sont conservés.

L'export d'une stack inclut les tags de chaque ressource qui en possède. Voir Tags des ressources pour les règles et limites.

Workflow recommandé​

  1. Exportez l'état actuel si le projet existe déjà.
  2. Modifiez la stack dans votre dépôt.
  3. Lancez plan.
  4. Relisez les changements.
  5. Lancez apply.

CI/CD​

Stockez le fichier stack dans votre dépôt et appliquez-le depuis votre pipeline avec une clé API de projet. Les secrets applicatifs doivent rester dans votre gestionnaire de secrets CI/CD et être injectés au moment de l'appel.

Sujets liés​