Création de processus CD Azure DevOps pour SPFx / Blogs / Perficient

Ce blog fournit une explication détaillée de l’approche technique pour implémenter les processus de déploiement continu (CD) dans Azure DevOps. Il se concentre sur l’automatisation du déploiement de solutions dans les environnements SharePoint. Cette approche accélère non seulement le cycle de publication, mais améliore également la fiabilité, minimise les erreurs et garantit que les mises à jour sont déployées rapidement et efficacement.

Le déploiement continu (CD) récupère les packages de code validés du processus de génération et les déploie dans un environnement de test ou de production. Les développeurs peuvent suivre les déploiements réussis et limiter les problèmes à des versions de packages spécifiques.

Condition préalable à la création d’un CD pour SPFx dans Azure DevOps

Pour configurer le déploiement continu (CI) pour SPFx dans Azure DevOps, assurez-vous que les éléments suivants sont déjà configurés :

• Un compte Azure DevOps avec l’accès requis
• Pipeline CI pour créer le fichier de package requis .sppkg pour le déploiement
• Accès requis à App Catalog pour le déploiement sur SharePoint Online

Mise en œuvre

Nous devons créer une nouvelle version dans Azure DevOps pour implémenter le CD. Cela nécessite les étapes suivantes :

• Création de la définition de version
• Lier l’artefact de construction
• Créer l’environnement
• Installer NodeJS
• Installer la CLI d’Office 365
• Connectez-vous au catalogue d’applications
• Ajouter un package de solutions au catalogue d’applications
• Déployer l’application
• Définir les variables d’environnement

Création de la définition de version

• Connectez-vous à Visual Studio Online (Azure DevOps)
• Sélectionnez votre projet pour configurer une définition de build.
• Dans le volet de navigation de gauche, cliquez sur Pipelines > Versions.
• Cliquez sur le bouton « + Nouveau » > cliquez sur « Nouveau pipeline de versions ».

• Sélectionnez modèle > Travail vide > Appliquer.

Lier l’artefact de construction

• Cliquez sur Ajouter un artefact.
• Sélectionnez Projet, Source, etc.

Note: Donnez un nom significatif à « Alias ​​source » et notez-le. Ce nom sera utilisé dans les étapes à venir.

Créer l’environnement

• Sous Étapes, cliquez sur « Étape 1 ».
• Nommez votre environnement.

Installation de NodeJS

• Allez dans l’onglet « Tâches »
• La fenêtre de configuration des tâches apparaîtra de la même manière que dans la définition de build.
• Sur l’agent par défaut, cliquez sur + signe.
• Recherchez « Nœud ».
• Ajoutez le programme d’installation de l’outil Node.js.
• Spécifiez 10.x dans le champ Spécification de version. Si votre projet est basé sur SharePoint Framework 1.7.1 ou une version antérieure, utilisez la version 8.x.

Installer la CLI d’Office 365

Office 365 Common Language Interface (CLI) est un projet open source de la communauté OfficeDev PnP.

• Ajoutez une tâche npm.
• Sous « Commande », sélectionnez personnalisé.
• Dans la zone « Commande et arguments », tapez installer -g @pnp/office365-cli.

Définir les variables d’environnement

Avant de nous connecter à SharePoint, nous pouvons définir certaines variables utilisées à plusieurs étapes du processus de déploiement. Définissez donc les variables de processus dans l’onglet « Variables » ci-dessous.

• Cliquez sur l’onglet Variables.
• Sous Variables du pipeline, ajoutez les variables ci-dessous.

Connectez-vous au catalogue d’applications

Nous devons nous authentifier auprès du catalogue d’applications de notre locataire.

• Ajoutez la tâche « Ligne de commande ».
• Dans le champ « Script », tapez la commande ci-dessous :

o365 spo login https://$(tenant).sharepoint.com/$(catalogsite) --authType password --userName $(username) --password $(password)

Ajouter un package de solutions au catalogue d’applications

Nous devons maintenant télécharger le package de solution dans le catalogue d’applications.

• Ajoutez la tâche « Ligne de commande ».
• Dans le champ « Script », tapez la commande ci-dessous :

o365 spo app add -p $(System.DefaultWorkingDirectory)/<Source alias>/drop/ webparts.sppkg --overwrite

Note: « Alias ​​source » est le nom d’alias défini lors de l’étape « Lier l’artefact de construction ».

Déployer le catalogue d’applications

Enfin, nous devons déployer le fichier d’application .sppkg sur le catalogue d’applications pour le rendre disponible à toutes les collections de sites au sein du locataire.

• Ajoutez la tâche « Ligne de commande ».
• Dans le champ « Script », tapez la commande ci-dessous.

o365 spo app deploy --name webparts.sppkg --appCatalogUrl https://$(tenant).sharepoint.com/$(catalogsite)

Conclusion

La configuration d’un déploiement continu (CD) pour SPFx dans Azure DevOps automatise le processus de déploiement du package de solution sur le catalogue d’applications dans l’environnement SharePoint. Ce processus permettra aux développeurs de se concentrer sur la garantie d’un processus de livraison transparent et cohérent, d’accélérer les itérations et de maintenir un environnement de développement plus agile et adaptable.