VMware Code Stream fournit un plug-in REST qui vous permet d'intégrer VMware Code Stream à d'autres applications qui utilisent une API REST afin de pouvoir développer et fournir en continu des applications logicielles qui doivent interagir entre elles. Le plug-in REST appelle une API qui échange des informations entre VMware Code Stream et une autre application.

Avec le plug-in REST, vous pouvez effectuer les opérations suivantes :

  • Intégrez des systèmes basés sur des API REST externes dans un pipeline VMware Code Stream.
  • Intégrez un pipeline VMware Code Stream dans le flux de systèmes externes.

Le plug-in REST fonctionne avec n'importe quelle API REST et prend en charge les méthodes GET, POST, PUT, PATCH et DELETE pour échanger des informations entre VMware Code Stream et d'autres applications.

Tableau 1. Préparation d'un pipeline pour communiquer sur l'API REST
Actions... Résultat…
Ajoutez une tâche REST à votre pipeline.

La tâche REST transmet les informations entre les applications et peut fournir des informations relatives à l'état pour une tâche consécutive de l'étape du pipeline.

Dans la tâche REST, sélectionnez l'action REST et indiquez l'URL.

La tâche de pipeline appelle l'URL lorsque le pipeline s'exécute.

Pour les actions POST, PUT et PATCH, vous devez inclure une charge utile. Dans la charge utile, vous pouvez lier vos propriétés de pipeline et de tâche lorsque le pipeline s'exécute.

Observez l'exemple suivant.

Exemple d'utilisation du plug-in REST :

Vous pouvez ajouter une tâche REST pour créer une balise pour une build sur une validation Git et demander à la tâche de publier une demande pour obtenir l'ID d'archivage auprès du référentiel. La tâche peut envoyer une charge utile à votre référentiel et créer une balise pour la build, et le référentiel peut renvoyer la réponse avec la balise.

À l'instar de l'utilisation du plug-in REST pour appeler une API, vous pouvez inclure une tâche d'interrogation dans votre pipeline pour appeler une API REST et l'interroger jusqu'à ce qu'elle se termine et que la tâche de pipeline réponde aux critères de sortie.

Vous pouvez également utiliser les API REST pour importer et exporter un pipeline, et utiliser les exemples de script pour exécuter un pipeline.

Cette procédure permet d'obtenir une URL simple.

Procédure

  1. Pour créer un pipeline, cliquez sur Pipelines > Nouveau pipeline > Canevas vide.
  2. Dans votre étape de pipeline, cliquez sur + Tâche séquentielle.
  3. Dans le volet des tâches, ajoutez la tâche REST :
    1. Entrez un nom pour la tâche.
    2. Dans le menu déroulant Type, sélectionnez REST.
    3. Dans la zone Demande REST, sélectionnez GET.
      Pour que la tâche REST demande des données auprès d'une autre application, vous devez sélectionner la méthode GET. Pour envoyer des données à une autre application, vous sélectionnez la méthode POST.
    4. Entrez l'URL qui identifie le point de terminaison de l'API REST. Par exemple, https://www.google.com.
      Pour qu'une tâche REST importe des données d'une autre application, vous pouvez inclure la variable de charge utile. Par exemple, pour une action d'importation, vous pouvez entrer ${Stage0.export.responseBody}. Si la taille des données de réponse dépasse 5 Mo, la tâche REST peut échouer.

      Utilisez des variables secrètes pour masquer et chiffrer des informations sensibles. Utilisez une variable limitée pour les chaînes, les mots de passe et les URL qui doivent être masqués et chiffrés, ainsi que pour en restreindre l'utilisation dans les exécutions. Par exemple, utilisez une variable secrète pour un mot de passe ou une URL. Vous pouvez utiliser des variables secrètes et restreintes pour n'importe quel type de tâche dans votre pipeline.

    5. Pour accorder une autorisation pour la tâche, cliquez sur Ajouter des en-têtes et entrez une clé et une valeur d'en-tête.
    Ajout et configuration d'une tâche REST dans votre pipeline.
  4. Pour enregistrer votre pipeline, cliquez sur Enregistrer.
  5. Dans l'onglet Pipeline, cliquez sur Activer le pipeline.
    Activation d'un pipeline qui inclut une tâche REST.
  6. Cliquez sur Enregistrer, puis sur Fermer.
  7. Cliquez sur Exécuter.
  8. Pour surveiller l'exécution du pipeline, cliquez sur Exécutions.
    Surveillance de l'exécution d'un pipeline qui inclut une tâche REST.
  9. Pour vérifier que le plug-in REST renvoie les informations que vous attendez, examinez l'exécution du pipeline et les résultats de la tâche.
    1. Une fois le pipeline terminé, pour vérifier que l'autre application a renvoyé les données que vous avez demandées, cliquez sur le lien vers l'exécution du pipeline.
    2. Cliquez sur la tâche REST dans le pipeline.
    3. Dans l'exécution du pipeline, cliquez sur la tâche, examinez-en les détails et vérifiez que le plug-in REST a renvoyé les résultats attendus.
      Les détails de la tâche affichent le code, le corps, les clés d'en-tête et les valeurs de la réponse.
      Détails de la tâche REST d'un pipeline.
  10. Pour examiner le résultat JSON, cliquez sur EXAMINER LE RÉSULTAT JSON.
    Examen du résultat JSON d'une tâche REST dans un pipeline.

Résultats

Félicitations ! Vous avez configuré une tâche REST qui a appelé une API REST et échangé des informations entre VMware Code Stream et une autre application en utilisant le plug-in REST.

Que faire ensuite

Continuez à utiliser des tâches REST dans vos pipelines pour exécuter des commandes et intégrer VMware Code Stream à d'autres applications afin de pouvoir développer et proposer vos applications logicielles. Envisagez l'utilisation de tâches d'interrogation pour interroger l'API jusqu'à ce qu'elle se termine et que la tâche de pipeline réponde aux critères de sortie.