Installer Azure DevOps en local sur un serveur unique

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Le moyen le plus simple de configurer Azure DevOps Server consiste à tout placer sur un seul serveur. Pour confirmer que cette configuration convient à votre équipe, consultez les recommandations matérielles. Si ce n’est pas le cas, envisagez plutôt une configuration à deux serveurs ou à plusieurs serveurs .

Si vous effectuez une mise à niveau à partir d’une version antérieure, apprenez-en davantage sur la compatibilité, les notes de publication et la prise en main de votre mise à niveau.

Notes

Les procédures d’installation d’un nouveau déploiement sont similaires pour toutes les versions de Azure DevOps Server. Les images présentées dans cet article peuvent faire référence Azure DevOps Server 2022 ou Azure DevOps Server 2019, mais les informations configurées sont les mêmes, sauf indication contraire.

Prérequis

  1. Préparez un seul ordinateur qui répond à la configuration requise.

  2. Si vous n’envisagez pas d’utiliser SQL Server Express, configurez une version prise en charge de SQL Server. Lorsque vous configurez SQL Server pour Azure DevOps localement, installez au minimum le moteur de base de données et Full-Text et les extractions sémantiques pour Recherche fonctionnalités.

    Nous vous recommandons d’utiliser SQL Server Express uniquement pour les déploiements personnels ou d’évaluation. Les copies payantes d’Azure DevOps localement incluent une licence SQL Server Standard. Pour plus d’informations, consultez tarification Azure DevOps Server et Tarification Team Foundation Server. Si vous utilisez la licence incluse, vous pouvez l’utiliser uniquement pour les bases de données créées avec ces produits.

  3. Le compte que vous utilisez pour configurer l’installation doit être membre du rôle serveur sysadmin dans SQL Server.

    Notes

    L’installation d’Azure DevOps en local implique un ensemble complexe d’opérations qui nécessitent un degré élevé de privilèges. Ces opérations incluent la création de bases de données, l’approvisionnement de connexions pour les comptes de service, etc. Techniquement, tout ce qui est nécessaire est :

    • Appartenance au rôle serveradmin.

    • AUTORISATIONS ALTER ANY LOGIN, CREATE ANY DATABASE et VIEW ANY DEFINITION étendues au serveur.

    • Autorisation CONTROL sur la base de données MASTER

      L’appartenance au rôle serveur sysadmin confère toutes ces appartenances et autorisations. C’est le moyen le plus simple de s’assurer que la configuration réussit. Si nécessaire, vous pouvez révoquer ces appartenances et autorisations après l’installation.

  4. Pour prendre en charge l’installation et la configuration de l’extension Recherche, vous devez fournir un nom d’utilisateur et un mot de passe. L’installation et la configuration de Recherche prennent en charge les fonctionnalités de recherche code, élément de travail et wiki. Pour plus d’informations, consultez Configurer la recherche. Notez que les noms d’utilisateur ne peuvent pas inclure de trait d’union ou de caractères spéciaux.

    Notes

    Recherche nécessite également Oracle Server JRE 8 (Update 60 ou version ultérieure). Vous pouvez télécharger et installer ou mettre à jour vers la dernière version en acceptant le Contrat de licence de code binaire Oracle pour Server JRE et en sélectionnant Configurer. Notez que cela définit la variable d’environnement JAVA_HOME pour qu’elle pointe vers le répertoire d’installation Java, et que server JRE ne fournit pas de mises à jour automatiques.

  5. Lors de la configuration de la couche Application, vous avez le choix entre les paramètres de site web. Passez en revue les paramètres du site Web pour comprendre les choix et les exigences.

Télécharger et installer

  1. Téléchargez Azure DevOps Server via l’un des canaux suivants :

  2. Démarrez l’installation.

    Le programme d’installation copie les fichiers sur votre ordinateur, puis démarre l’Assistant Centre de configuration Azure DevOps Server.

  3. Vous pouvez configurer votre installation en choisissant Démarrer l’Assistant, ou revenir ultérieurement et lancer l’Assistant Configuration du serveur comme décrit dans la section suivante.

    Capture d’écran du Centre de configuration, de l’Assistant Démarrer, de l’Assistant Démarrer, Azure DevOps Server 2022.

    Ici, nous montrons l’Assistant fourni pour Azure DevOps Server capture d’écran 2019 du Centre de configuration, de l’Assistant Démarrer, Azure DevOps Server 2019.

Choisir De base ou Avancé pour un nouveau déploiement

La première étape de la configuration de votre serveur consiste à choisir entre les deux options de déploiement.

  • Choisissez le scénario Nouveau déploiement - De base à installer sur un seul serveur. Ce scénario est optimisé pour la simplicité en utilisant les options par défaut pour la plupart des entrées.

    Capture d’écran de l’Assistant Configuration du serveur, Nouveau déploiement, option de base sélectionnée, 2022.

    Avec le scénario Nouveau déploiement - De base , vous allez spécifier les paramètres suivants :

    • Langue : sélectionnez la langue à utiliser pour la configuration.
    • instance SQL Server : indiquez si vous souhaitez installer SQL Server Express ou utiliser un SQL Server instance existant.
    • Couche Application : sélectionnez les paramètres de site web à utiliser, notamment l’utilisation des liaisons HTTP ou HTTPS. Pour plus d’informations, consultez Paramètres du site web.
    • Recherche : choisissez d’installer et de configurer les fonctionnalités de code Recherche ou d’utiliser un service de recherche existant. Pour plus d’informations, consultez Configurer la recherche.
  • Choisissez le scénario Nouveau déploiement - Avancé lorsque vous souhaitez un contrôle total sur toutes les entrées.

    Capture d’écran de l’Assistant Configuration du serveur, Nouveau déploiement, option Avancée sélectionnée, 2022.

    Vous allez spécifier les paramètres supplémentaires suivants :

    • Compte : sélectionnez le compte de service sous lequel vos processus s’exécutent. La valeur par défaut utilisée dans le scénario De base est NT AUTHORITY\NETWORK SERVICE dans les scénarios joints à un domaine et LOCAL SERVICE dans les scénarios de groupe de travail.
    • Couche Application :
      • Sous Paramètres SSH, indiquez s’il faut activer SSH et le port sur lequel il doit écouter. La valeur par défaut utilisée dans le scénario De base consiste à configurer SSH sur le port 22.
      • Sous Emplacement du cache de fichiers, sélectionnez l’emplacement du cache de fichiers utilisé pour les ressources fréquemment consultées. La valeur par défaut utilisée dans le scénario De base est le chemin AzureDevOpsServerData\ApplicationTier\_fileCache sur le lecteur local, qui a le plus d’espace libre.
    • Collection de projets : spécifiez le nom de la collection de projets à utiliser pour stocker vos projets. Le comportement par défaut du scénario de base consiste à créer une collection de projets nommée DefaultCollection.
    • Compte : sélectionnez le compte de service sous lequel vos processus s’exécutent. La valeur par défaut utilisée dans le scénario De base est NT AUTHORITY\NETWORK SERVICE dans les scénarios joints à un domaine et LOCAL SERVICE dans les scénarios de groupe de travail.
    • Couche Application :
      • Sous Paramètres SSH, indiquez s’il faut activer SSH et le port sur lequel il doit écouter. La valeur par défaut utilisée dans le scénario De base consiste à configurer SSH sur le port 22.
      • Sous Emplacement du cache de fichiers, sélectionnez l’emplacement du cache de fichiers utilisé pour les ressources fréquemment consultées. La valeur par défaut utilisée dans le scénario De base est le chemin AzureDevOpsServerData\ApplicationTier\_fileCache sur le lecteur local, qui a le plus d’espace libre.
    • Rapports : (Facultatif) Choisissez si vous souhaitez utiliser SQL Server Reporting Services pour créer des rapports. Vous devez spécifier les informations suivantes pour prendre en charge cette sélection :
      • instance Reporting Services
      • URL du serveur de rapports
      • URL du Gestionnaire de rapports
      • instance SQL Server Analysis Services
      • Nom du compte de lecteur de rapport
    • Collection de projets : spécifiez le nom de la collection de projets à utiliser pour stocker vos projets. Le comportement par défaut du scénario de base consiste à créer une collection de projets nommée DefaultCollection.
  • Après avoir examiné vos sélections et sélectionné Vérifier, l’Assistant exécute des vérifications de préparation pour valider votre environnement et vos sélections de paramètres. S’il réussit, vous pouvez configurer votre déploiement. Sinon, corrigez les erreurs et réexécutez les vérifications de préparation.

Configurer à l’aide de l’option De base

Cette section vous guide tout au long de la configuration de votre Azure DevOps Server à l’aide de l’option De base sélectionnée dans la page Assistant Configuration du serveur, Nouveau déploiement.

  1. Dans la page Bienvenue , choisissez vos options, puis sélectionnez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page d’accueil, 2022.

  2. Dans la page Nouveau déploiement , choisissez votre type de déploiement, puis sélectionnez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page Nouveau déploiement, 2022.

  3. Dans la page suivante, choisissez Nouveau déploiement - De base, puis sélectionnez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page Nouveau déploiement - De base, 2022.

  4. Dans la page Langue , choisissez l’option Langue de votre choix, puis sélectionnez Suivant.

    Capture d’écran de la page Langue.

  5. Dans la page Instance SQL Server, sélectionnez le SQL Server instance que vous souhaitez utiliser. À des fins d’évaluation, choisissez Installer SQL Server Express. À des fins de production, choisissez Utiliser une instance SQL Server existante. Choisissez ensuite Suivant.

    Capture d’écran de SQL Server page Instance.

    Si vous avez choisi Utiliser une instance SQL Server existante, entrez les informations de base de données dans la page suivante, puis choisissez Tester pour vérifier. Ensuite, choisissez Suivant.

    Capture d’écran de la page Base de données.

  6. Dans la page Couche Application , choisissez les paramètres de site web que vous souhaitez utiliser, notamment s’il faut utiliser des liaisons HTTP ou HTTPS, puis choisissez Suivant. Pour plus d’informations, consultez Paramètres du site web.

    Capture d’écran de l’Assistant Configuration du serveur, page Couche Application, 2022.

  7. Dans la page Recherche, choisissez d’installer et de configurer Recherche fonctionnalités ou d’utiliser un service de recherche existant. L’installation et la configuration de Recherche prennent en charge les fonctionnalités de recherche code, élément de travail et wiki. Pour plus d’informations, consultez Configurer la recherche. Choisissez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page Recherche, 2022.

    Capture d’écran de Recherche page pour Azure DevOps Server 2019.

  8. Dans la page Vérifier , passez en revue vos sélections, puis choisissez Vérifier. L’Assistant exécute des vérifications de préparation pour valider votre environnement et vos sélections de paramètres. S’il réussit, vous pouvez configurer votre déploiement. Sinon, corrigez les erreurs et réexécutez les vérifications de préparation.

    Capture d’écran de l’Assistant Configuration du serveur, page Révision, 2022.

  9. Vérifications de préparation. Une fois toutes les vérifications passées, vous êtes prêt à terminer la configuration. Choisissez Configurer.

    Conseil

    Vous pouvez revenir à n’importe quelle page précédente en choisissant Précédent ou le nom de la page dans le volet gauche. Si vous modifiez un paramètre de configuration, vous devez vérifier les paramètres en choisissant Cliquer ici pour réexécuter les vérifications de préparation.

    Capture d’écran de l’Assistant Configuration du serveur, page Vérifications de préparation, Azure DevOps Server 2022.

    Capture d’écran de la page Configurer le début, Azure DevOps Server 2019.

  10. L’Assistant passe à la page Configurer et commence à configurer chaque fonctionnalité et affiche la progression. Cette étape peut prendre plusieurs minutes. Si toutes les configurations réussissent, le message de réussite suivant s’affiche. Sélectionnez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page Configuration, progression de la configuration, 2022.

    Capture d’écran de la progression de la configuration, 2019.

  11. Dans la page Terminer , passez en revue les résultats de la configuration. Passez en revue vos résultats de configuration et choisissez Copier le chemin d’accès complet pour copier le lien vers le fichier journal de configuration. Choisissez le lien URL Azure DevOps Server pour vous connecter au portail web de votre serveur configuré.

    Capture d’écran de l’Assistant Configuration du serveur, page Terminé, Progression terminée, 2022.

    Dans cet exemple, le lien est /http:aaronha001/.

    Capture d’écran de l’Assistant Configuration du serveur, page Terminé, Progression terminée, 2019.

Configurer à l’aide de l’option Avancé

Cette section vous guide tout au long de la configuration de votre Azure DevOps Server à l’aide de l’option Avancé.

Notes

Les procédures d’installation d’un nouveau déploiement avec l’option Avancé sont similaires pour toutes les versions de Azure DevOps Server et de Team Foundation Server 2018, sauf que la création de rapports n’est pas prise en charge pour Azure DevOps Server 2022 et versions ultérieures. Les images présentées dans cette section font référence Azure DevOps Server 2019, mais les informations configurées sont les mêmes, sauf indication contraire.

  1. Dans la page Bienvenue , choisissez vos options, puis sélectionnez Suivant.

  2. Dans la page Nouveau déploiement , choisissez le type de déploiement, puis sélectionnez Suivant.

  3. Dans la page suivante, choisissez Nouveau déploiement - Avancé, puis sélectionnez Suivant.

    Capture d’écran de l’Assistant Configuration du serveur, page Nouveau déploiement - Avancé, 2022.

    Capture d’écran du nouveau déploiement, sélection avancée.

  4. Dans la page Langue , choisissez l’option Langue de votre choix, puis sélectionnez Suivant.

    Capture d’écran de Avancé, sélectionnez Langue, n’importe quelle version.

  5. Dans la page Base de données, spécifiez le SQL Server instance que vous avez configuré pour une utilisation avec Azure DevOps Server. Choisissez ensuite Suivant.

    Capture d’écran de Avancé, sélectionnez Base de données.

  6. Dans la page Compte , spécifiez le compte de service à utiliser.

    Capture d’écran de Avancé, sélectionnez Compte.

  7. Dans la page Couche Application , choisissez les paramètres de site web que vous souhaitez utiliser, notamment s’il faut utiliser des liaisons HTTP ou HTTPS, puis choisissez Suivant. Pour plus d’informations, consultez Paramètres du site web.

    Capture d’écran de La sélection avancée, page Niveau application.

  8. Dans la page Recherche, choisissez d’installer et de configurer Recherche fonctionnalités ou d’utiliser un service de recherche existant. L’installation et la configuration de Recherche prennent en charge les fonctionnalités de recherche code, élément de travail et wiki. Pour plus d’informations, consultez Configurer la recherche. Choisissez Suivant.

    Capture d’écran de la page Avancé Recherche.

  1. Dans la page Création de rapports, décochez la case Configurer la création de rapports si vous ne prévoyez pas d’utiliser SQL Server Reporting Services ou si vous n’avez pas encore installé SQL Server Analysis Services et SQL Server Reporting Services. Sinon, laissez la case cochée et choisissez Suivant.

    Capture d’écran de Avancé, sélectionnez Rapports.

  2. Reporting Services. Entrez le nom du serveur sur lequel vous avez installé SQL Server Reporting Services. Ensuite, choisissez Remplir les URL. Choisissez Suivant.

    Capture d’écran de Advanced, Reporting Services

  3. Analysis Services. Entrez le nom du serveur sur lequel vous avez installé SQL Server Reporting Services, puis choisissez Tester. Choisissez Suivant.

    Capture d’écran de Advanced, Analysis Services

  4. Compte de lecteur de rapport. Entrez les informations d’identification du compte de service que vous avez configuré pour la création de rapports, puis choisissez Tester. Choisissez Suivant.

    Capture d’écran de Advanced, Report Reader Account

  1. Dans la page Collection de projets, laissez la case à cocher Créer une collection de projets d’équipe cochée. Vous devez avoir au moins une collection de projets dans laquelle définir des projets. Laissez le nom du projet tel qu’il est , DefaultCollection, ou donnez-lui un nouveau nom et éventuellement une description.

    Capture d’écran de la page Avancé, Collection de projets.

    Notes

    La collection de projets est créée pour utiliser le modèle de processus Hérité, qui prend en charge la personnalisation via le portail web. Vous pouvez créer d’autres collections de projets si nécessaire pour prendre en charge le modèle de processus XML local ultérieurement. Consultez Gérer les collections de projets. Pour en savoir plus sur le modèle de processus d’héritage, consultez À propos de la personnalisation des processus et des processus hérités.

    Notes

    Lorsque Reporting Services est défini, la collection de projets créée prend en charge le modèle de processus XML local pour la personnalisation du suivi du travail. Pour créer une collection qui utilise le modèle de processus d’héritage, vous devez ajouter une collection de projets qui n’est pas configurée avec Reporting Services. Consultez Gérer les collections de projets. Pour en savoir plus sur le modèle de processus d’héritage, consultez À propos de la personnalisation des processus et des processus hérités.

  2. Dans la page Vérifier , passez en revue vos sélections, puis choisissez Vérifier. L’Assistant exécute des vérifications de préparation pour valider votre environnement et vos sélections de paramètres. S’il réussit, vous pouvez configurer votre déploiement. Sinon, corrigez les erreurs et réexécutez les vérifications de préparation.

    Capture d’écran de Avancé, Révision.

  3. Dans la page Vérifications de préparation , le système effectue une passe finale pour s’assurer que les paramètres de configuration sont valides. Une fois toutes les vérifications passées, vous êtes prêt à terminer la configuration. Choisissez Configurer.

    Conseil

    Vous pouvez revenir à n’importe quelle page précédente en choisissant Précédent ou le nom de la page dans le volet gauche. Si vous modifiez un paramètre de configuration, vous devez vérifier les paramètres en choisissant Cliquer ici pour réexécuter les vérifications de préparation.

    Capture d’écran de Advanced, Readiness Checks.

  4. L’Assistant passe à la page Configurer et commence à configurer chaque fonctionnalité et affiche la progression. Cette étape peut prendre plusieurs minutes. Si toutes les configurations réussissent, le message de réussite suivant s’affiche. Sélectionnez Suivant.

    Capture d’écran de la page Avancé, Configurer.

  5. Dans la page Terminer , passez en revue les résultats de la configuration. Passez en revue vos résultats de configuration et choisissez Copier le chemin d’accès complet pour copier le lien vers le fichier journal de configuration. Choisissez le lien URL Azure DevOps Server pour vous connecter au portail web de votre serveur configuré.

    Dans cet exemple, le lien est /http:aaronha001/.

    Capture d’écran de configuration avancée, page Terminé.

Création d’un projet

Votre portail web s’ouvre sur la page Créer un projet .

  1. Fournissez un nom de projet et une description facultative. Le nom du projet ne peut pas contenir d’espaces ou de caractères spéciaux (tels que / : \ ~ & % ; @ ' " ? <> | # $ * } { , + = [ ]), ne peut pas commencer par un trait de soulignement, ne peut pas commencer ou se terminer par un point et doit comporter 64 caractères ou moins.

    Les paramètres par défaut configurent un référentiel Git pour le contrôle de version et le processus Agile pour le suivi du travail. Pour choisir différentes options, développez Avancé.

    Capture d’écran du portail web, boîte de dialogue Créer un projet.

    Pour une comparaison des options de gestion de version, consultez Choisir le contrôle de version approprié pour votre projet. Pour passer en revue les processus de suivi du travail, consultez Choisir un processus.

  2. Une fois votre projet créé, la page de résumé du projet s’affiche. Pour plus d’informations, consultez Partager votre mission de projet, afficher l’activité du projet.

Étapes suivantes

Pour les administrateurs :

Pour les développeurs :