O Mainframe Connector permite-lhe acionar e monitorizar tarefas do Cloud Run a partir do seu mainframe. Por exemplo, pode usar esta funcionalidade para integrar a sua ferramenta de extração, transformação e carregamento (ETL) existente com o Mainframe Connector através de tarefas do Cloud Run.
Esta página aborda a forma como pode realizar as seguintes tarefas através do Mainframe Connector:
- Acionar uma tarefa do Cloud Run: inicie uma tarefa do Cloud Run a partir do conetor do mainframe
- Ver registos de tarefas do Cloud Run: veja os registos de tarefas do Cloud Run localmente no seu mainframe para monitorização
- Cancelar uma tarefa do Cloud Run: cancele uma tarefa do Cloud Run em curso
Para mais informações sobre a criação e a gestão de tarefas do Cloud Run, consulte a documentação do Cloud Run.
Antes de começar
- Se ainda não o fez, instale o Mainframe Connector no seu mainframe.
- Para executar os comandos do Cloud Run, certifique-se de que atribui as seguintes funções à sua conta de utilizador:
- Cloud Run Invoker
- Executor de tarefas do Cloud Run
- Executor de tarefas do Cloud Run com substituições
- Leitor do Cloud Run
- Visualizador de registos Para mais informações sobre a atribuição de funções a uma conta de utilizador, consulte o artigo Gerir o acesso através do IAM.
- Configure as Credenciais padrão da aplicação.
Execute uma tarefa do Cloud Run através do Mainframe Connector
Para executar uma tarefa do Cloud Run através do Mainframe Connector, siga estes passos:
Para acionar uma tarefa do Cloud Run a partir do seu mainframe, use o comando
cloud run job execute
do ficheiro de linguagem de controlo de tarefas (JCL) do mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job execute JOB_NAME /*
Substitua JOB_NAME pela tarefa do Cloud Run que quer executar.
Pode executar o comando
cloud run job execute
no modo síncrono e assíncrono. Se quiser acionar uma tarefa no modo síncrono e imprimir registos de tarefas à medida que a tarefa progride, use o comando anterior com a flag--tail_logs
.Para ver os registos de uma execução de tarefa específica do Cloud Run, use o comando
cloud run job logs
do seu ficheiro JCL do mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job logs EXECUTION_ID /*
Substitua EXECUTION_ID pelo ID de execução da tarefa do Cloud Run.
(Opcional) Para cancelar uma tarefa do Cloud Run, use o comando
cloud run job cancel
no ficheiro JCL do mainframe:Example JCL //STEP01 EXEC BQSH //STDIN DD * cloud run job cancel EXECUTION_ID /*
Substitua EXECUTION_ID pelo ID de execução da tarefa do Cloud Run que quer cancelar.