Vous pouvez tester ou publier une intégration à partir de l'éditeur d'intégrations une fois que vous avez ajouté et configuré l'intégration avec les déclencheurs, les tasks et les connexions périphériques nécessaires. Lorsque vous testez ou publiez une intégration à l'aide de la console Google Cloud, l'intégration est exécutée en mode synchrone.
Rôle requis
Pour vous assurer que le compte utilisateur dispose des autorisations nécessaires pour tester ou publier une intégration, demandez à votre administrateur d'accorder au compte utilisateur le rôle IAM Agent de service Application Integration (roles/integrations.serviceAgent
) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Votre administrateur peut également attribuer au compte utilisateur les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Tester une intégration
Si vous souhaitez vérifier que votre intégration fonctionne comme prévu, vous avez la possibilité de la tester avant de la publier. Tester une intégration vous permet de tester les valeurs des variables d'entrée d'intégration et d'identifier les erreurs dans le flux de connexion de l'intégration.
Pour tester l'exécution d'une intégration, procédez comme suit :
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez l'intégration que vous souhaitez tester.
- Dans la barre de navigation du concepteur, cliquez sur Tester.
Si plusieurs déclencheurs sont configurés dans votre intégration, sélectionnez celui à partir duquel vous souhaitez tester l'intégration. Le volet Tester l'intégration s'affiche.
- Cliquez sur Tester l'intégration.
Le test Apigee Integration exécute l'intégration et affiche le résultat d'exécution dans le volet Test d'intégration :
- Pour modifier les variables d'entrée, cliquez sur Modifier les variables d'entrée.
- Pour tester de nouveau l'intégration, cliquez sur Retester l'intégration.
- Pour restaurer les valeurs, cliquez sur Restaurer les valeurs.
- Pour afficher et inspecter les journaux d'exécution du test, cliquez sur Afficher les journaux.
- Si vous avez activé Cloud Logging, cliquez sur Afficher les journaux Cloud pour afficher les journaux dans Cloud Logging.
- Pour modifier l'intégration sans créer de nouvelle version de l'intégration, cliquez sur Modifier l'intégration.
- Pour fermer l'opération de test et revenir à l'éditeur d'intégrations, cliquez sur Fermer.
Publier une intégration
La publication d'une version d'intégration déploie cette version d'intégration et la place à l'état actif. Toute publication d'une version d'intégration antérieure est alors automatiquement annulée, et tous les services qui reposent sur la version d'intégration publiée précédemment utilisent automatiquement la dernière version publiée.
Pour publier une intégration, procédez comme suit :
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez l'intégration que vous souhaitez publier.
- Dans la barre de navigation du concepteur, cliquez sur la liste déroulante des versions, puis sélectionnez la version d'intégration que vous souhaitez publier.
- Cliquez sur Publier.
La boîte de dialogue Générer automatiquement la description de l'intégration s'affiche. Si vous souhaitez générer une description, cliquez sur Bien sûr, continuer. Sinon, cliquez sur Non, publier uniquement.
Une fois l'intégration publiée, vous pouvez afficher et inspecter les journaux d'exécution qui s'y rapportent. Pour afficher les journaux, cliquez sur Journaux dans la barre d'outils de l'éditeur d'intégrations.
Par défaut, Apigee Integration empêche toute modification d'une intégration une fois qu'elle est publiée. Pour apporter des modifications à l'intégration publiée, cliquez sur Activer la modification dans l'éditeur d'intégrations. La modification d'une intégration publiée entraîne la création d'une nouvelle version de cette intégration.
Annuler la publication d'une intégration
L'annulation de la publication d'une version d'intégration active annule le déploiement de cette version et la place à l'état d'instantané. Tous les services qui reposent sur la version publiée de l'intégration sont alors automatiquement arrêtés.
Pour annuler la publication d'une intégration, procédez comme suit :
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez l'intégration dont vous souhaitez annuler la publication.
- Dans la barre de navigation du concepteur, cliquez sur la liste déroulante des versions, puis sélectionnez la version d'intégration dont vous souhaitez annuler la publication.
- Cliquez sur Unpublish (Annuler la publication).
Une fois l'intégration annulée, vous pouvez cliquer sur Activer la modification dans l'éditeur d'intégrations pour la modifier. Si vous modifiez l'intégration, une nouvelle version de cette intégration est créée.
Quota et limites
Pour en savoir plus sur les quotas et les limites d'Apigee Integration, consultez la page Quotas et limites.
Bonne pratique
- Définissez la facilité d'utilisation d'une variable (variable d'entrée ou variable de sortie) avant de tester votre intégration. Consultez la page Variables d'intégration.
- Définissez la gestion des exceptions pour votre intégration.