Zoho Catalyst en production : ce que la documentation ne dit pas.
Déployer une première fonction sur Catalyst prend quelques minutes. La faire tourner sereinement pendant des mois demande quelques habitudes. Voici les cinq que j'applique sur chaque projet.
Catalyst est une plateforme serverless pratique quand votre système d'information tourne déjà autour de Zoho : fonctions, base de données, stockage et authentification sont à portée de main, à côté du CRM. Le piège, c'est justement cette facilité. On code vite, on déploie vite, et les questions de production arrivent plus tard, au pire moment.
01Séparer les environnements dès le premier jour
Catalyst distingue un environnement de développement et un environnement de production. Utilisez-les vraiment : chaque changement passe d'abord par le développement, avec des données de test, avant d'être promu.
- Jamais de test sur les données réelles. Un webhook branché par erreur sur le CRM de production peut modifier des centaines de fiches.
- Une configuration par environnement, et aucune valeur codée en dur qui pointe vers la production.
- Un compte de service dédié par intégration, avec les droits strictement nécessaires.
02Des fonctions idempotentes
Un webhook peut arriver deux fois. Une fonction peut échouer à mi-parcours et être relancée. Si votre traitement crée une facture, une tâche ou un e-mail, il doit produire le même résultat qu'il soit exécuté une ou trois fois.
// Traitement d'un deal gagné : rejouable sans doublon
export async function onDealWon(event, store) {
const key = `deal:${event.dealId}:won`
if (await store.has(key)) return { status: 'ignored' }
await createInvoice(event)
await store.put(key, Date.now())
return { status: 'done' }
}La clé d'idempotence se construit à partir de l'identifiant métier (ici le deal), pas d'un identifiant technique généré à chaque appel. Stockez-la dans une table dédiée de la base Catalyst, avec la date de traitement : elle sert aussi de journal.
Avant d'écrire une fonction, posez-vous la question : « que se passe-t-il si elle s'exécute deux fois ? » Si la réponse vous inquiète, ajoutez une clé d'idempotence.
03Secrets et configuration
Jetons d'API, clés de signature des webhooks, identifiants de services tiers : rien de tout cela ne doit apparaître dans le dépôt Git. Placez-les dans les variables d'environnement de chaque fonction, et vérifiez la signature des webhooks entrants avant tout traitement.
- Un secret différent par environnement.
- Une rotation planifiée, et documentée, des jetons sensibles.
- Un scan des secrets dans la CI pour bloquer une fuite avant le merge.
04Journaliser pour diagnostiquer
Quand un commercial signale qu'« une facture n'est pas partie », vous devez pouvoir retrouver en deux minutes ce qui s'est passé. Journalisez chaque étape importante avec l'identifiant métier concerné, sans jamais écrire de données personnelles ou de secrets dans les journaux.
log('invoice.created', { dealId, invoiceId, durationMs })
log('invoice.skipped', { dealId, reason: 'already-processed' })Des messages courts et structurés se filtrent facilement dans les journaux de la console Catalyst, et se branchent sans effort sur une alerte le jour où vous en avez besoin.
05Déployer depuis la CI, pas depuis un poste
La CLI Catalyst permet de déployer depuis n'importe quel poste. C'est pratique en développement, risqué en production : on finit par déployer une version locale non commitée. Faites du pipeline d'intégration continue le seul chemin vers la production.
# Étapes du pipeline, dans l'ordre
- lint et vérification des types
- tests unitaires et d'intégration (données de test)
- scan des dépendances et des secrets
- déploiement en développement, puis promotion en production après validation06Ce que je retiens
Aucune de ces habitudes n'est propre à Catalyst. Ce sont les bases de toute plateforme serverless, mais la proximité avec le CRM rend les erreurs plus visibles et plus coûteuses. Avec des environnements séparés, des fonctions rejouables, des secrets protégés, des journaux utiles et un déploiement automatisé, Catalyst tient très bien la production pour vos intégrations Zoho.