Glossaire Salesforce DevOps

Package Alias

Un nom lisible dans sfdx-project.json qui correspond à un ID de package ou de version de package, afin que les scripts et la CI n'aient pas à coder en dur des ID opaques.

Définition

Un package alias est une entrée du fichier sfdx-project.json d'un projet qui associe un nom lisible par un humain à l'ID de package réel (commençant par 0Ho) ou à l'ID de version de package (04t) que Salesforce attribue. Plutôt qu'un script de build ou un pipeline CI référence un package par son ID opaque, il référence l'alias, et Salesforce CLI le résout à l'exécution. Exécuter sf package version create ajoute automatiquement une nouvelle entrée d'alias pour la version produite, de sorte que le mappage reste à jour au fil de l'historique de release d'un package. Ignorer les alias et coder en dur des ID bruts dans les scripts est une source fréquente de confusion dès qu'un package a plusieurs versions actives, car rien dans l'ID lui-même n'indique ce qu'il représente. Notre guide Salesforce CLI couvre la façon dont les commandes de packaging s'intègrent à un build.

En pratique

Comment cela fonctionne dans Serpent

Serpent suit l'identité des packages et des versions en interne, de sorte que les tableaux de bord de release et l'historique de promotion affichent des noms lisibles plutôt que des ID bruts, sans qu'une équipe n'ait à maintenir manuellement des entrées d'alias dans chaque fichier de projet. Voir la gestion des releases dans Serpent pour la façon dont les versions de package sont suivies.

Mapping commit-vers-package dans Serpent
Questions fréquentes

Package Alias, expliqué

Chaque version de package a-t-elle besoin d'une nouvelle entrée d'alias ?
La CLI en ajoute une automatiquement à chaque création de version, donc vous avez rarement besoin de modifier sfdx-project.json à la main pour cela.

Démarrez gratuitement. Pas de carte bancaire, pas d'installation, aucun engagement.

Configuration en moins de 15 minutes. Aucun recrutement DevOps nécessaire.

Curieux de livrer plus vite avant de vous lancer ? Parlons-en

Sans engagement.