azure: un référentiel communautaire de modèles ARM

Modèles Azure Resource Manager contribués par la communauté

Ce référentiel GitHub, Azure/azure-quickstart-templates, contient des modèles Azure Resource Manager (ARM) contribués par la communauté. Selon le README, il contient tous les modèles ARM actuellement disponibles soumis par les membres de la communauté. Un index consultable de ces modèles est maintenu sur azure.com. Les métadonnées du référentiel indiquent que son langage principal est Bicep, un langage spécifique au domaine pour déployer des ressources Azure, et rapportent 14 846 étoiles, 16 210 forks et 986 problèmes ouverts. La page d'accueil du projet est l'URL raccourcie https://aka.ms/azqst, et la branche par défaut est master. Le référentiel n'est pas archivé, ce qui signifie qu'il est toujours ouvert aux contributions, bien que le README ne précise pas la fréquence des mises à jour.

Utilisation et contribution au référentiel

Le README pointe vers un guide de contribution dans le répertoire 1-CONTRIBUTION-GUIDE/README.md. Ce guide est la source désignée pour les instructions sur la façon d'utiliser les modèles ou d'en contribuer de nouveaux. Le README lui-même ne contient aucune commande d'utilisation ni instructions de déploiement étape par étape ; il se contente de fournir un lien vers le guide. Pour quiconque souhaite travailler avec les modèles, le guide de contribution est la première étape. Le référentiel renvoie également à l'index des modèles sur azure.com, qui fournit un catalogue consultable des exemples disponibles. Le README ne mentionne aucun prérequis pour contribuer, comme un abonnement Azure, Azure CLI ou PowerShell, et ne décrit pas non plus comment tester les modèles. Ces détails sont probablement dans le guide.

Politique contre les liens externes

Le référentiel applique une politique stricte de non-liens externes pour les exemples. Les pull requests contenant des liens vers des actifs non contrôlés par Microsoft seront rejetées, et les exemples existants avec de tels liens seront supprimés. La raison invoquée est d'éviter le risque d'usurpation de domaine ou de prise de contrôle hostile. Des exemples de liens interdits incluent les buckets S3, les comptes de stockage Azure non détenus par Microsoft et les dépôts Git non-Azure. Pour se conformer, les contributeurs sont invités à utiliser les modules Bicep et les fonctions de fichiers, ou à paramétrer les liens vers du contenu externe. Cette politique est clairement énoncée dans le README et s'applique à toutes les contributions d'exemples. La politique implique également que toute ressource externe référencée dans un modèle doit être soit supprimée, soit rendue paramétrable afin que l'utilisateur fournisse l'emplacement au moment du déploiement.

Code de conduite

Ce projet a adopté le code de conduite open source de Microsoft. Le README renvoie au texte du code de conduite et à une page de questions fréquentes. Il fournit également une adresse e-mail, opencode@microsoft.com, pour toute question ou commentaire supplémentaire. L'adoption d'un code de conduite signale les attentes du projet en matière de comportement de la communauté, bien que le README n'élabore pas sur les mécanismes d'application spécifiques au-delà de ce qui est dans le code de conduite lui-même. Le code de conduite est un document standard qui couvre le comportement attendu, les directives de signalement et le maintien d'un environnement accueillant. Le README ne liste aucune règle supplémentaire spécifique à la communauté.

Licence et conditions

Le référentiel est sous licence MIT, avec des droits d'auteur attribués à Microsoft Azure, daté de 2015. La licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, à condition que l'avis de droit d'auteur et l'avis de permission soient inclus dans toutes les copies ou portions substantielles. Le logiciel est fourni 'tel quel', sans garantie d'aucune sorte, y compris la qualité marchande, l'adéquation à un usage particulier et la non-contrefaçon. La licence n'accorde aucune garantie de sécurité, aucun engagement de support ni aucune garantie supplémentaire. Elle ne dit rien non plus sur le statut de propriété intellectuelle des modèles d'exemple eux-mêmes au-delà de la licence du logiciel. La licence MIT est permissive et permet une utilisation commerciale et privée, mais elle décline explicitement toute responsabilité et garantie.

Ce que le README ne dit pas

Le README est volontairement concis. Il ne décrit pas la structure des modèles individuels, ne fournit pas d'instructions de déploiement et ne liste pas de cas d'utilisation d'exemple. Il ne mentionne pas non plus d'historique de versions, de schéma de versioning ou de feuille de route de maintenance. Les métadonnées du référentiel montrent que le projet n'est pas archivé, mais le README n'explique ni la fréquence des mises à jour ni le processus de révision des contributions au-delà de la politique sur les liens externes. Pour tous ces détails, le guide de contribution et l'index des modèles azure.com sont les endroits référencés, mais le README lui-même les laisse non dits. Le README ne mentionne pas non plus comment signaler des problèmes, comment demander de nouveaux modèles, ou s'il existe un comité de révision. Il fournit simplement un pointeur vers le guide de contribution et l'index des modèles.

Conclusion éditoriale

Le référentiel Azure/azure-quickstart-templates est une collection communautaire de modèles Azure Resource Manager, régie par une politique stricte de non-liens externes et la licence MIT. Le README est concis et renvoie les utilisateurs au guide de contribution pour plus de détails.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes