Aller au contenu principal

Documentation

Documentation technique et utilisateur, en français

Pas de traduction automatique, pas de renvoi vers une base de connaissances anglophone. La documentation est rédigée en français par les équipes qui exploitent la plateforme, et versionnée avec elle.

Démarrage rapide

Provisionner par API ou par Terraform

Tout ce que fait le portail est disponible par API. Les clés d’API ont une portée limitée et une valeur affichée une seule fois à la création.

Authentification par clé d’API

bash
# Créez une clé depuis /app/securite → onglet Clés d'API.
# La valeur n'est affichée qu'une seule fois.

export SYNELIA_TOKEN="syn_live_…"

curl -sS https://api.synelia.cloud/v1/me \
  -H "Authorization: Bearer $SYNELIA_TOKEN" \
  -H "Accept: application/json"

Créer un Espace Cloud

bash
curl -sS -X POST https://api.synelia.cloud/v1/espaces \
  -H "Authorization: Bearer $SYNELIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "EC-DBA-04",
    "offerId": "off-souverain",
    "site": "ABJ",
    "cidr": "10.6.0.0/22",
    "options": {
      "backupPlanId": "bp-prod-quotidien",
      "supervision": true
    }
  }'

# Réponse : 202 Accepted + identifiant de job.
# Suivez l'avancement sur /v1/jobs/{id} ou dans le centre de tâches.

Provisionner avec Terraform

hcl
terraform {
  required_providers {
    synelia = {
      source  = "synelia/synelia"
      version = "~> 1.4"
    }
  }
}

provider "synelia" {
  # SYNELIA_TOKEN lu depuis l'environnement
  region = "ABJ"
}

resource "synelia_espace_cloud" "prod" {
  code     = "EC-DBA-04"
  offer_id = "off-souverain"
  site     = "ABJ"
  cidr     = "10.6.0.0/22"
}

resource "synelia_vm" "web" {
  count     = 2
  espace_id = synelia_espace_cloud.prod.id
  nom       = "web-prod-${count.index + 1}"
  image     = "ubuntu-24.04-lts"
  flavor    = "c2.medium"

  reseau {
    nom       = "prod-front"
    ip_public = count.index == 0
  }

  backup_plan_id = "bp-prod-quotidien"
  tags           = ["production", "web"]
}

Limites de débit et idempotence

L’API accepte 600 requêtes par minute et par clé, 60 pour les opérations de création. Toutes les opérations de création acceptent un en-tête Idempotency-Key : rejouer la même requête avec la même clé ne crée pas de doublon. Les opérations longues renvoient un 202 Accepted avec un identifiant de job à suivre.

Documentation contractuelle et d’exploitation

Réservée aux clients sous contrat, depuis leur espace client.

  • Dossier d’architecture technique, versionné et daté
  • Dossier d’exploitation : procédures, astreinte, escalade
  • Dossier de sécurité : durcissement, gestion des accès, chiffrement
  • Plan de réversibilité par service souscrit
  • Parcours de formation administrateur et exploitant, avec suivi de complétion
  • Accès à un environnement de bac à sable pour la formation
Ouvrir l’espace documentaire client

Contribuer à la documentation

Une imprécision, une procédure obsolète, un exemple qui ne fonctionne pas ?

Signalez-le depuis n’importe quelle page de documentation, ou par ticket. Nous traitons les corrections de documentation en gravité mineure, avec un délai de première réponse de quatre heures ouvrées — et nous créditons les contributions dans l’historique de la page.

Les procédures d’exploitation les plus consultées font l’objet d’une revue trimestrielle systématique, indépendamment des signalements.