Nous avons amélioré l'automatisation lors de l'installation des mises à niveau de votre projet Sitefinity. Si vous utilisez Sitefinity 10.0 ou une version ultérieure, l'interface de ligne de commande (CLI) de Sitefinity est la nouvelle voie rapide pour mettre à niveau vos sites Web et vos applications.
Mises à niveau. Nous en avons déjà parlé. Je suppose que nous sommes tous d'accord pour dire qu'une certaine anxiété de mise à niveau est une donnée. Et ce n’est pas aussi simple que «s’il n’est pas cassé, ne le réparez pas.» Comme dans tout système logiciel, le processus de mise à niveau est une fatalité qui ne doit pas être prise à la légère. De grands projets, de multiples dépendances, du code personnalisé – cela demande une planification minutieuse, une exécution précise et beaucoup de temps et de ressources.
Puis, en fin de compte, la question du contrôle que nous avons sur le processus. Et le résultat. D'accord, la mise à niveau est un processus complexe impliquant plusieurs opérations avec potentiellement beaucoup de détails à suivre. Mais bon, ça doit être dur ou intimidant? Complexe n'est pas forcément égal à compliqué.
Mises à niveau via Sitefinity CLI: Automatic for the People
Chez Sitefinity, nous essayons constamment d'automatiser de nombreux aspects du processus de mise à niveau. Nos clients du cloud bénéficient déjà des mises à niveau automatisées de Sitefinity . Pour ceux d'entre vous qui déploient sur site ou auto-hébergés, nous souhaitons vous encourager également à toujours profiter des dernières améliorations en termes de performances, de productivité et de sécurité que chaque nouvelle version apporte. Nous voulons que vous procédiez avec confiance, pas avec peur. Voici donc l'affaire: la mise à niveau de Sitefinity n'a jamais été aussi simple.
La CLI Sitefinity prend désormais en charge les mises à niveau vers la dernière version pour les projets exécutés sur Sitefinity CMS 10.0 et supérieur. L'interface de ligne de commande de mise à niveau installera automatiquement les packages NuGet, gérera les références et les redirections de liaison, ainsi que les mises à jour du framework.
Les mises à niveau sont gérées de manière à gagner du temps et des efforts en minimisant les tâches manuelles, tout en réduisant considérablement la marge d'erreur.
Et NuGet?
Pour utiliser Upgrade CLI, vous devez disposer d'une installation Sitefinity basée sur NuGet. NuGet est le gestionnaire de packages pour .NET. Une solution permettant aux développeurs de créer, partager et consommer du code sans effort et efficacement. Chaque package NuGet contient du code compilé et des fichiers de contenu dans une archive avec une extension .nupkg.
Sitefinity est fourni avec son propre ensemble de packages NuGet contenant du code réutilisable pour simplifier et rationaliser diverses tâches de vos projets. Une application particulièrement pratique consiste à obtenir et installer des mises à niveau. Autrement dit, les NuGets sont toujours instrumentaux, mais la procédure est juste un peu plus simple et fiable lorsqu'elle est gérée par l'interface de ligne de commande Sitefinity.
Assurez-vous de consulter cet excellent résumé de la procédure de mise à niveau de Sitefinity Qui cartographie les méthodes de mise à niveau disponibles en fonction de votre version actuelle de Sitefinity CMS. Et au fait, ce billet de blog est toujours très pertinent si vous voulez continuer à mettre à jour manuellement à l'aide des packages NuGet.
Pour revenir au point, une mise à niveau de Sitefinity est effectuée en deux étapes. La première consiste à mettre à jour les fichiers binaires et toutes les références de vos projets. La seconde consiste à mettre à jour les fichiers de configuration et le schéma dB lorsque vous démarrez le projet pour la première fois après l'étape 1.
La CLI Sitefinity gère entièrement la première étape, mettant à jour les fichiers binaires et les références entre les projets. Cependant, l'interface de ligne de commande (CLI) peut être intégrée dans un processus CI (Continuous Integration), ce qui permettra la deuxième étape. C'est ainsi que Sitefinity Cloud le gère.
Etape par étape: la procédure de mise à niveau
Alors, que fait la CLI Sitefinity? Décomposons les étapes, en gardant à l'esprit que la commande de mise à niveau ne concerne que les projets liés à Sitefinity. Les projets de votre solution qui ne font référence à aucun package Sitefinity ne seront pas modifiés.
La commande CLI upgrade a la syntaxe suivante et voici ce qu'elle fait réellement.
sf upgrade "{{chemin vers le solution que vous souhaitez mettre à niveau}} " " {{version vers laquelle vous mettez à niveau}} "
- Restauration des packages NuGet
- Change the target framework des projets si nécessaire
- Téléchargez les packages Sitefinity spécifiés dans le paramètre d'entrée
- Lancez Visual Studio
- Vérifiez et corrigez les références brisées dans les fichiers.csproj
- Correction des redirections de liaison – le cas échéant
En fonction de la version actuelle de Sitefinity sur laquelle vous vous trouvez, une liste des packages nécessaires est créée à mettre à jour (pour chaque projet Sitefinity de votre solution). Une invite avec le nouveau CLUF Sitefinity (contrat de licence utilisateur final) apparaîtra, que vous devrez accepter pour terminer la mise à niveau (en tapant «Y» dans la console).
La console du gestionnaire de packages s'ouvre dans Visual Studio. Une fois l'instance VS lancée, un script PowerShell est exécuté, en fonction du paramètre d'entrée de l'étape 1, qui déclenche la mise à niveau de NuGet.
Une fois les packages NuGet mis à niveau, Visual Studio se ferme et l'étape suivante consiste à vérifier et à corriger les références brisées dans les fichiers .csproj.
En passant, vous pouvez personnaliser la séquence en ajoutant les paramètres facultatifs suivants à la commande :
– packageSources spécifie un flux NuGet autre que celui par défaut
– acceptLicense acceptera automatiquement le CLUF et sautera l'étape d'acceptation de la licence
– skipPrompts désactivera l'invite pour garder le projet sous contrôle de code source
Une remarque importante à faire ici est que vous devez reconstruire votre projet une fois que la CLI a terminé le processus de mise à niveau. Maintenant, vous pouvez exécuter l'application, qui déclenchera une mise à jour de la base de données et des fichiers de configuration.
Voilà donc, il vous suffit d'exécuter la commande Upgrade, asseyez-vous et regardez-le faire sa magie. Répondez aux invites, le cas échéant, gardez le projet sous contrôle de code source et ne fermez pas Visual Studio à moins que, pour une raison quelconque, vous ne deviez annuler la mise à niveau. Voici les principaux avantages de la mise à niveau via CLI:
- La CLI Sitefinity gère automatiquement les références brisées ou manquantes
- Le framework cible est automatiquement défini sur la version appropriée du framework Sitefinity
- La CLI Sitefinity corrige automatiquement les redirections de liaison
- Tous les projets de la solution sont automatiquement mis à niveau sans avoir à exécuter manuellement chacun d'entre eux
- Peut s'exécuter dans un pipeline d'intégration continue pour déclencher une mise à jour des fichiers de configuration et du schéma de base de données après avoir reconstruit et exécuté le site ou l'application mis à jour [19659044] Interface de ligne de commande GitHub de Sitefinity » title= »Sitefinity-GitHub-CLI-inline »/>
Avant de terminer, nous vous invitons à explorer la documentation dûment mise à jour sur la procédure de mise à niveau de Sitefinity . Assurez-vous de disposer de la dernière version de la CLI Sitefinity . Avec lui, les mises à niveau sont d'autant plus faciles. J'espère que nous sommes tous d'accord sur l'importance de rester à jour ne peut être surestimée. Alors, faites ce qu'il faut et mettez à niveau.
Source link