Le connecteur Mainframe vous permet de déclencher et de surveiller des jobs Cloud Run à partir de votre mainframe. Par exemple, vous pouvez utiliser cette fonctionnalité pour intégrer votre outil d'extraction, de transformation et de chargement (ETL) existant à Mainframe Connector à l'aide d'emplois Cloud Run.
Cette page explique comment effectuer les tâches suivantes à l'aide de Mainframe Connector:
- Déclencher un job Cloud Run:lancez un job Cloud Run à partir du connecteur Mainframe.
- Afficher les journaux des tâches Cloud Run:affichez les journaux des tâches Cloud Run localement sur votre mainframe à des fins de surveillance.
- Annuler un job Cloud Run:annulez un job Cloud Run en cours.
Pour en savoir plus sur la création et la gestion de tâches Cloud Run, consultez la documentation Cloud Run.
Avant de commencer
- Si ce n'est pas déjà fait, installez Mainframe Connector sur votre mainframe.
- Pour exécuter les commandes Cloud Run, assurez-vous d'attribuer les rôles suivants à votre compte utilisateur :
- Demandeur Cloud Run
- Exécuteur de jobs Cloud Run
- Exécuteur de jobs Cloud Run avec forçages
- Lecteur Cloud Run
- Visionneuse de journaux Pour en savoir plus sur l'attribution de rôles à un compte utilisateur, consultez la section Gérer les accès à l'aide d'IAM.
Exécuter une tâche Cloud Run à l'aide du connecteur Mainframe
Pour exécuter une tâche Cloud Run à l'aide du connecteur Mainframe, procédez comme suit:
Pour déclencher une tâche Cloud Run à partir de votre mainframe, utilisez la commande
cloud run job run
à partir de votre fichier JCL (Job Control Language) de mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job run JOB_NAME /*
Remplacez JOB_NAME par la tâche Cloud Run que vous souhaitez exécuter.
Vous pouvez exécuter la commande
cloud run job run
en mode synchrone et asynchrone. Si vous souhaitez déclencher une tâche en mode synchrone et imprimer les journaux de tâche au fur et à mesure de son exécution, utilisez la commande précédente avec l'option--tail_logs
.Pour afficher les journaux d'une exécution de tâche Cloud Run spécifique, utilisez la commande
cloud run job logs
à partir de votre fichier JCL de mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job logs EXECUTION_ID /*
Remplacez EXECUTION_ID par l'ID d'exécution de la tâche Cloud Run.
(Facultatif) Pour annuler une tâche Cloud Run, utilisez la commande
cloud run job cancel
à partir de votre fichier JCL de mainframe:Example JCL //STEP01 EXEC BQSH //STDIN DD * cloud run job cancel EXECUTION_ID /*
Remplacez EXECUTION_ID par l'ID d'exécution de la tâche Cloud Run que vous souhaitez annuler.