Étape 2 : Créer le jeton & installer l’agent

Article
05/04/2023

Un jeton d’accès personnel (PAT) est créé dans Visual Studio Team Services. Ce jeton est votre mot de passe et est utilisé par l’agent de build VSTS pour l’authentification. Le jeton s’affiche uniquement lorsque vous le créez. Après cela, il n’est plus affiché. Par conséquent, une fois que vous l’avez créé, enregistrez-le dans un autre fichier dans un emplacement mémorisé.

Pour plus d’informations sur PAT, consultez Authentifier l’accès avec des jetons d’accès personnels pour VSTS et TFS.

Après avoir créé le jeton, vous installez l’agent de build et le configurez pour utiliser ce jeton.

Avant de commencer

Effectuez l’étape 1 : Ajouter un projet d’application et mettre à jour json.

Connectez-vous à Azure DevOps et créez le jeton

Accédez à https://app.vsaex.visualstudio.com/go/profileet connectez-vous avec votre compte professionnel ou scolaire. Une fois connecté, votre compte VSTS est répertorié. Dans l’exemple suivant, le compte est dev.azure.com/v-vabi:

Si vous n’avez pas de compte, sélectionnez Créer un compte, puis entrez un nom. Pour gérer votre code, choisissez votre préférence personnelle entre Git ou Team Foundation Version Control. Lorsque vous avez terminé, votre nouveau compte est créé et un site similaire à s’ouvre https://dev.azure.com/v-vabi/BizTalkVSTS :
Ouvrez votre compte DevOps (https://dev.azure.com/v-vabi/). Sélectionnez votre icône dans le deuxième coin supérieur droit, puis sélectionnez Paramètres> utilisateurJetons d’accès personnels :
Tous les jetons d’accès personnels sont affichés.

Important

Vous devez connaître le jeton d’accès. Si ce n’est pas le cas et que vous ne l’avez pas noté nulle part, il ne peut pas être récupéré. Dans ce cas, créez un agent.

Si vous n’avez pas d’agent existant, sélectionnez Ajouter, entrez une description, définissez la date d’expiration, puis sélectionnez votre compte. Dans Étendues sélectionnées, sélectionnez Pools d’agents (lire, gérer) :

Sélectionnez Créer le jeton. Notez la valeur du jeton ; vous en avez besoin dans les prochaines étapes.
Sélectionnez Cloner repos>dans Visual Studio :
Visual Studio s’ouvre. Dans Visual Studio, ouvrez votre solution BizTalk.

Installer l’agent de build

Notes

L’agent de build est installé sur l’ordinateur de développement BizTalk. Si vous utilisez des groupes de déploiement, l’agent de build est installé sur tous les serveurs BizTalk sur lesquels vous souhaitez déployer. Utilisez également ces mêmes étapes pour ajouter un ordinateur de build, qui peut être différent de l’ordinateur de développement BizTalk.

Si vous le souhaitez, vous pouvez créer des projets BizTalk à l’aide du pool d’agents Azure Pipelines au lieu de l’agent de build. Pour utiliser le pool d’agents Azure Pipelines, ignorez cette section et accédez à Étape 3 : Créer la définition de build.

Les étapes suivantes vous montrent comment installer l’agent de build sur un seul ordinateur. Pour plus d’informations sur l’utilisation des groupes de déploiement, consultez Groupes de déploiement.

Ouvrez votre compte et votre projet Azure DevOps, ce qui est quelque chose comme https://dev.azure.com/v-vabi/BizTalkVSTS. Sélectionnez l’icône des paramètres du projet, puis sélectionnez Pools d’agents :
Sélectionnez l’agent >par défautNouveau téléchargement de l’agent. Enregistrez le fichier dans vos dossiers Téléchargements .
Les étapes d’installation s’ouvrent automatiquement. Suivez ces étapes pour obtenir les détails les plus à jour. Voici quelques conseils :
1. Ouvrez Windows PowerShell en tant qu’administrateur.
2. Pour créer l’agent, entrez :
```
PS C:\> mkdir agent ; cd agent  

PS C:\agent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win7-x64-2.124.0.zip", "$PWD")
```
  La version du fichier vsts-agent change. Suivez donc les étapes d’installation de VSTS pour obtenir des détails spécifiques. Une fois que vous avez atteint Entrée, le retour de l’invite peut prendre quelques minutes.
3. Pour configurer l’agent, entrez :
```
PS C:\agent> .\config.cmd
```
4. Entrez les informations suivantes :
  - URL du serveur : entrez https://{your-account}.visualstudio.com.
  - Type d’authentification : entrez PAT.
  - Jeton d’accès personnel : collez votre jeton Azure DevOps.
  - Pool d’agents : entrez pour la valeur par défaut.
  - Nom de l’agent : entrez pour la valeur par défaut.
  - Remplacer : s’affiche uniquement si vous avez un agent existant.
  - Dossier de travail : entrez pour la valeur par défaut.
  - Exécuter l’agent en tant que service : entrez Y.
  - Compte d’utilisateur : cette valeur vous appartient, mais vous pouvez rencontrer un problème d’autorisations. Envisagez d’entrer votre compte connecté actuel, qui est un administrateur local.
5. Lorsque vous avez terminé, votre fenêtre PowerShell se présente comme suit :
Ouvrez services.msc et recherchez le nouveau service Azure Pipeline Agent. Il doit être en cours d’exécution.

Si le service ne parvient pas à démarrer, supprimez et reconfigurez un agent à l’aide d’un compte disposant de privilèges supplémentaires.

Ce que vous avez fait

Vous vous êtes connecté à votre compte Azure DevOps et vous avez créé un jeton de sécurité. Ce jeton de sécurité est semblable à un mot de passe et vous donne accès à votre projet Azure DevOps. Il n’est affiché qu’une seule fois. Veillez donc à l’enregistrer. Vous avez également cloné votre projet Azure DevOps dans Visual Studio et créé un agent qui s’exécute en tant que service sur votre ordinateur de développement BizTalk. Cet agent utilise le jeton de sécurité.

Étapes suivantes

Étape 3 : Créer la définition de build
Étape 4 : Créer la définition de mise en production
Configurer des variables et des jetons environnementaux

Partager via