Configurer et exécuter le générateur de démonstration Azure DevOps localement

Azure DevOps Services

Vous pouvez exécuter le projet Générateur de démonstration Azure DevOps en tant qu’application console ou exécutable sur votre ordinateur local. Cette approche vous donne plus de contrôle sur l’exécution de l’outil et vous permet de personnaliser son comportement pour des scénarios spécifiques.

Prerequisites

Avant de commencer, vérifiez que ces composants sont installés sur votre ordinateur :

• SDK .NET 8
• Visual Studio ou un autre IDE préféré
• Git pour cloner le référentiel

Configurer le générateur de démonstration localement

Procédez comme suit pour configurer et exécuter le générateur de démonstration sur votre ordinateur local :

1. Clonez le référentiel Générateur de démonstration Azure DevOps sur votre ordinateur local :

   git clone https://github.com/microsoft/AzDevOpsDemoGenerator.git
   cd AzDevOpsDemoGenerator
   

2. Ouvrez le fichier de solution ADOGenerator.sln dans Visual Studio ou votre IDE préféré.

3. Dans Visual Studio, définissez le projet de démarrage :

   1. Cliquez avec le bouton droit sur le projet ADOGenerator dans l’Explorateur de solutions.
   2. Sélectionnez Définir comme projet de démarrage.

4. Générez la solution pour restaurer toutes les dépendances et vérifiez que le projet se compile correctement :

   1. Dans Visual Studio : Cliquez avec le bouton droit sur la solution dans l’Explorateur de solutions, puis sélectionnez Générer la solution.
   2. À partir de la ligne de commande :

   dotnet build
   

5. Exécutez le projet en tant qu’application console à l’aide de l’une des méthodes suivantes :

   1. Dans Visual Studio : Appuyez F5 ou sélectionnez le bouton Démarrer .
   2. À partir de la ligne de commande :

   dotnet run --project src/ADOGenerator/ADOGenerator.csproj
   

Créer un exécutable

Créez un exécutable autonome que vous pouvez distribuer ou exécuter sur des machines sans le Kit de développement logiciel (SDK) .NET :

Publier le projet

Dans Visual Studio :

1. Cliquez avec le bouton droit sur le projet ADOGenerator dans l’Explorateur de solutions.
2. Cliquez sur Publier.
3. Suivez les invites pour configurer les paramètres de publication (dossier cible, configuration, runtime).

À partir de la ligne de commande :

dotnet publish src/ADOGenerator/ADOGenerator.csproj -c Release -r win-x64 --self-contained

Exécuter l’exécutable

Accédez au répertoire publié et exécutez l’exécutable :

cd src/ADOGenerator/bin/Release/net8.0/win-x64/publish
./ADOGenerator.exe

Considérations sur la configuration

Lors de l’exécution locale du générateur de démonstration Azure DevOps, gardez à l’esprit ces facteurs :

• Fichiers de configuration : vérifiez que les fichiers de configuration requis (par exemple appsettings.json) sont présents dans le répertoire de sortie.
• Dépendances : vérifiez que toutes les dépendances nécessaires sont incluses dans la sortie de build.
• Autorisations : l’application nécessite des autorisations appropriées pour accéder aux services Azure DevOps.
• Accès réseau : assurez-vous que votre machine peut se connecter à Azure DevOps Services via HTTPS.

Résolution des problèmes

Si vous rencontrez des problèmes lors de la configuration ou de l’exécution du générateur de démonstration :

1. Vérifier la sortie de la console : passez en revue les messages d’erreur dans la console pour connaître des problèmes spécifiques.
2. Vérifier les dépendances : vérifiez que tous les packages et dépendances requis sont correctement restaurés.
3. Valider la configuration : vérifiez que les fichiers de configuration contiennent des paramètres et des valeurs corrects.
4. Vérifier la connectivité : vérifiez la connectivité réseau à Azure DevOps Services.
5. Vérifiez la version de .NET : vérifiez que vous utilisez la version correcte du Kit de développement logiciel (SDK) .NET.

Approches secondaires

Étant donné que Microsoft ne développe plus activement le générateur de démonstration, tenez compte de ces alternatives pour l’automatisation de projet :

• Azure DevOps CLI pour la configuration et la gestion de projets scriptées
• Automatisation de l’API REST pour les solutions d’approvisionnement de projets personnalisées
• Scripts PowerShell utilisant les API REST d'Azure DevOps
• Modèles Azure Resource Manager pour la configuration de l’infrastructure et du projet

Contenu connexe

• Utiliser le générateur de démonstration
• Créer votre propre modèle
• Vue d’ensemble d’Azure DevOps CLI
• Informations de référence sur l’API REST Azure DevOps