Charger et tester les applications personnalisées dans l’environnement Teams v4

Capture d’écran montrant la note de dépréciation du Kit de ressources Teams v4.

Après avoir ajouté la connexion d’API, vous pouvez tester la connexion d’API dans l’environnement local teams Toolkit et déployer votre application dans le cloud. Dans le pipeline CI/CD, après avoir été configuré avec une autre plateforme, vous devez créer un principal de service Azure pour provisionner et déployer des ressources.

Dans cette section, vous allez découvrir les points suivants :

Tester la connexion d’API dans un environnement local

Les étapes suivantes permettent de tester la connexion d’API dans l’environnement local du Kit de ressources Teams :

  1. Exécuter npm install

    Exécutez npm install sous bot le dossier ou api pour installer les packages ajoutés.

  2. Ajouter des informations d’identification d’API aux paramètres de l’application locale

    Teams Toolkit ne demande pas d’informations d’identification, mais laisse des espaces réservés dans le fichier de paramètres de l’application locale. Remplacez les espaces réservés par les informations d’identification appropriées pour accéder à l’API. Le fichier de paramètres de l’application locale est le .env.teamsfx.local fichier dans le bot dossier ou api .

  3. Utiliser le client d’API pour effectuer des demandes d’API

    Importez le client d’API à partir du code source qui a besoin d’accéder à l’API :

    import { yourApiClient } from '{relative path to the generated file}'
    
  4. Générer des requêtes http(s) vers l’API cible (avec Axios)

    Le client d’API généré est un client d’API Axios. Utilisez le client Axios pour effectuer des requêtes à l’API.

    Remarque

    Axios est un package nodejs populaire qui vous aide avec les requêtes http(s). Pour plus d’informations sur la façon d’effectuer des requêtes http(s), consultez l’exemple de documentation Axios pour apprendre à créer des http(s).

Déployer votre application sur Azure

Pour déployer votre application sur Azure, vous devez ajouter l’authentification aux paramètres de l’application pour l’environnement approprié. Par exemple, votre API peut avoir des informations d’identification différentes pour dev et prod. En fonction des besoins de l’environnement, configurez Teams Toolkit.

Teams Toolkit configure votre environnement local. L’exemple de code de stratégie de démarrage contient des commentaires qui vous indiquent les paramètres d’application que vous devez configurer. Pour plus d’informations sur les paramètres d’application, consultez Ajouter des paramètres d’application.

Provisionner et déployer des ressources CI/CD

Pour provisionner et déployer des ressources ciblant Azure dans CI/CD, vous devez créer un principal de service Azure à utiliser.

Procédez comme suit pour créer des principaux de service Azure :

  1. Inscrire une application Microsoft Entra dans un seul locataire.
  2. Attribuez un rôle à votre application Microsoft Entra pour accéder à votre abonnement Azure. Le rôle Contributor est recommandé.
  3. Créez un secret d’application Microsoft Entra.

Conseil

Enregistrez votre ID de locataire, l’ID d’application (AZURE_SERVICE_PRINCIPAL_NAME) et le secret (AZURE_SERVICE_PRINCIPAL_PASSWORD) pour une utilisation ultérieure.

Pour plus d’informations, consultez Instructions relatives aux principaux de service Azure. Les trois méthodes suivantes permettent de créer des principaux de service :

Voir aussi