Stratégie de gestion des versions d’Auth0

Comprenez comment fonctionne la gestion des versions d’Auth0.

Nous estimons que la gestion des versions est un élément essentiel de notre offre et nous nous efforçons de fournir un système de gestion des versions cohérent pour nos produits, afin d’aider nos utilisateurs à gérer et à prévoir l’incidence de nos changements sur leur utilisation.

​

Gestion sémantique des versions

La gestion sémantique des versions (aussi appelé semver) est une stratégie de gestion des versions dont la principale caractéristique est de rendre les changements incompatibles faciles à repérer. Une version est composée de 3 nombres séparés par des points : ... Par exemple, 2.12.5, 0.1.0 et 10.5.35 sont des numéros semver valides.

• Le premier nombre représente un changement majeur : l’API de la bibliothèque a changé d’une manière non rétrocompatible. Lorsque la partie major d’une version augmente, l’API publique de cette bibliothèque a changé. Par exemple, du code et des fonctionnalités auparavant marqués comme dépréciés sont retirés de la base de code.
• Le deuxième nombre représente un changement mineur : de nouvelles fonctionnalités sont ajoutées à l’API de la bibliothèque, ou marquées comme dépréciées, tout en maintenant la rétrocompatibilité. Cette nouvelle version mineure est généralement sûre à utiliser, et nous encourageons les clients à faire la mise à jour. Toutefois, puisqu’il est impossible de connaître toutes les façons dont les clients utilisent un composant, il demeure possible que des changements aient une incidence sur son utilisation actuelle. Nous recommandons donc de vérifier et de tester avant d’effectuer une mise à jour.
• Le troisième nombre représente un changement de correctif : un bogue a été corrigé et cela ne devrait avoir aucune incidence sur l’API exposée aux utilisateurs. Cette mise à jour devrait être sûre, mais il est toujours recommandé d’effectuer des tests.

​

Utilisation en production

Auth0 fournit des liens vers notre réseau de diffusion de contenu (CDN), où nous hébergeons certaines de nos bibliothèques. La façon dont vous référencez un composant dans votre code déterminera si, et à quel moment, les changements seront appliqués automatiquement. Par exemple, si vous créez un lien vers la version majeure dans un script et qu’une nouvelle version mineure est publiée, vous recevrez la mise à jour dès sa sortie. Nous recommandons cette pratique dans les environnements de développement et pour faire des essais avec Auth0. Voici quelques exemples d’intégration des fichiers sources :

<!-- version majeure -->
<script src="https://cdn.auth0.com/example/1/library.js"></script>

<!-- version mineure -->
<script src="https://cdn.auth0.com/example/1.0/library.js"></script>

<!-- correctif (recommandé pour la production) -->
<script src="https://cdn.auth0.com/example/1.0.1/library.js"></script>

Lorsque des composants Auth0 sont déployés en production, nous encourageons nos utilisateurs à s’en tenir à une version précise et à l’utiliser pour effectuer des tests approfondis. Bien que l’ajout de nouvelles fonctionnalités de manière rétrocompatible ne devrait pas casser votre code, les interactions avec le résultat produit par le composant peuvent être difficiles à prévoir. Même des correctifs mineurs peuvent modifier certaines hypothèses que vous faisiez au sujet du composant et qui pourraient ne plus être valides.

Chaque composant open source d’Auth0 qui suit semver aura un tag correspondant à une version publiée dans son dépôt Git. Comme certains projets utilisent les outils npm pour publier des versions, les tags auront la lettre v comme préfixe. Par exemple, le tag de la version 5.2.3 sera v5.2.3.

​

En savoir plus

• Matrice de soutien des produits