Serpent est une plateforme DevOps pour les équipes Salesforce. Chaque changement obtient un espace suivi et contrôlable, pour que vous puissiez construire, réviser et livrer sans gérer manuellement les branches Git, les orgs et les déploiements. Cette page explique les objets principaux, indique quels termes sont standards chez Salesforce et lesquels sont propres à Serpent, et décrit ce à quoi s'attendre à chaque étape.
Les objets principaux
Workspace
Un terme Serpent. Le conteneur de premier niveau de votre équipe : il regroupe vos projets, membres, orgs et facturation. La plupart des équipes n'ont qu'un seul workspace.
Project
Un terme Serpent. Un pipeline de livraison à part entière : son propre dépôt, ses orgs connectées, sa politique de revue et son équipe. Vous créez des Work Items à l'intérieur d'un project, et ses paramètres déterminent comment les changements sont révisés et livrés.
Work Item
Un terme Serpent, et le premier à connaître. Un Work Item est l'unité de changement : une fonctionnalité ou un correctif, avec sa branche Git et son périmètre suivi déjà configurés pour vous. Voyez-le comme un ticket et sa branche réunis en un seul objet, pour que vous travailliez sur les changements Salesforce plutôt que de gérer des branches à la main.
Orgs, sandboxes et production
Des termes Salesforce standards. Un org est un environnement Salesforce. Les sandboxes sont des copies pour construire et tester ; la production est l'org en direct où travaillent vos utilisateurs. Un project relie les orgs sur lesquels il développe et vers lesquels il livre.
Dev Hub et scratch orgs
Des termes Salesforce standards. Un scratch org est un environnement temporaire piloté par le source, créé à la demande pour une seule tâche, puis supprimé. Un Dev Hub est l'org qui autorise leur création.
Review request
Le nom que Serpent donne à une pull request. Quand un Work Item est prêt, il passe par une review request pour qu'un coéquipier puisse approuver les changements avant leur déploiement. L'obligation de revue se configure par project.
Automation flow
Un terme Serpent. Un pipeline configurable qui exécute des étapes automatiquement, comme déployer au merge ou repromouvoir un changement, pour que le travail de livraison courant n'ait pas à être fait à la main.
Release
Un lot de changements déployés ensemble et suivi comme une seule unité, pour que vous voyiez ce qui a été livré et puissiez revenir en arrière si besoin.
Comment les pièces s'assemblent
Le flux se déroule de haut en bas : un workspace regroupe vos projects ; à l'intérieur d'un project, vous créez un Work Item pour chaque changement ; vous construisez le changement sur vos orgs ; vous l'envoyez via une review request ; et le travail approuvé est livré dans une release. Un Work Item correspond à une branche, une review request à une pull request, et une release à un déploiement.
À quoi s'attendre à la création d'un Work Item
Quand vous créez un Work Item, Serpent crée immédiatement sa branche Git et ouvre le Work Item, prêt pour vos changements. Cela suppose que le contrôle de source du project soit déjà connecté. Si aucune branche n'apparaît, le contrôle de source n'est pas encore connecté : ouvrez Project Settings > Source Control, connectez votre fournisseur, puis recréez le Work Item.
Quand utiliser Serpent
Tournez-vous vers Serpent quand vous voulez que les changements Salesforce soient suivis, révisés et livrés comme le ferait une équipe logicielle qui livre du code, mais sans configurer vous-même les branches, les scratch orgs et les scripts de déploiement. Il remplace la routine manuelle des change sets, des branches gérées à la main et des déploiements CLI ponctuels par un chemin guidé et contrôlable du work item jusqu'à la production.