DataWorks:Nó SSH

Observações de uso

• Ao usar um nó SSH para iniciar um processo em um host remoto, se a tarefa do nó SSH for encerrada inesperadamente (por exemplo, devido a tempo limite), o processo no host remoto não será afetado. O DataWorks não envia comando para terminar o processo.

• Os nós SSH suportam sintaxe Shell padrão, mas não aceitam sintaxe interativa.

• A execução remota de script em uma instância ECS com nó SSH cria arquivos temporários na instância. Verifique se a instância ECS tem espaço em disco suficiente e se o limite máximo de arquivos atende aos seus requisitos.

• Evite que várias tarefas operem no mesmo arquivo simultaneamente. Caso contrário, o nó SSH pode falhar.

Pré-requisitos

• Fluxo de negócios criado.

  O Data Studio executa operações de desenvolvimento específicas do mecanismo com base nos fluxos de negócios. Crie um fluxo de negócios antes de criar um nó. Para mais informações, consulte Create a business flow.

• Source de dados SSH criada.

  Para desenvolver e agendar tarefas recorrentes com um nó SSH, crie uma source de dados SSH para acessar seu servidor SSH. Para criar uma source de dados, consulte SSH data source.

  Nota

  Os nós SSH suportam apenas sources de dados SSH criadas com string de conexão JDBC. Para evitar falhas na tarefa, verifique se a source de dados tem conectividade de rede com o grupo de recursos.

• (Opcional; obrigatório para usuários do Resource Access Management (RAM)) Usuário RAM usado no desenvolvimento da tarefa adicionado ao workspace de destino e com a função Development ou Workspace Administrator atribuída (concede permissões amplas — atribua com cautela). Para mais informações sobre como adicionar membros e conceder permissões, consulte Add members to a workspace.

Limitações

• Tarefas SSH podem ser executadas em grupos de recursos Serverless. Para mais informações sobre como adquirir e usar grupos de recursos Serverless, consulte Use Serverless resource groups.

• Regiões suportadas: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Hong Kong), Japan (Tokyo), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), UK (London), US (Silicon Valley) e US (Virginia).

• O tamanho máximo de código para um nó SSH é 128 KB.

Etapa 1: Criar um nó SSH

1. Faça login no console do DataWorks. Na região de destino, clique em Data Development and O&M > Data Development no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.

2. Clique com o botão direito no fluxo de trabalho de destino e selecione Create Node > SSH.

3. Na caixa de diálogo Create Node, insira um Name para o nó e clique em OK. Após criar o nó, desenvolva e configure a tarefa.

Etapa 2: Desenvolver uma tarefa SSH

# 1. Prepare the environment.
# On the remote host, find the file that you want to run. For example, a file named nihao.sh exists in the /tmp directory of the remote host.
# For testing purposes, you can run the following command in the SSH node to create the nihao.sh file.
echo "echo nihao,dataworks" >/tmp/nihao.sh
# 2. Use the SSH node to run the file on the remote host.
# Use the DataWorks SSH node to run the /tmp/nihao.sh file.
sh /tmp/nihao.sh

# Goal: Write the SSH node execution time to the /tmp/sshnode.log file every day.
# Implementation: Use the ${myDate} variable and assign it the value $[yyyy-mm-dd hh24:mi:ss]. This writes the execution time of the SSH node to the file.
echo ${myDate} >/tmp/sshnode.log
cat /tmp/sshnode.log

Etapa 3: Configurar o agendamento da tarefa

Para executar periodicamente a tarefa do nó, clique em Scheduling no lado direito da página de edição do nó e defina as configurações de agendamento conforme necessário. Para mais informações, consulte Overview of task scheduling properties.

Etapa 5: Enviar e publicar a tarefa

Após configurar a tarefa do nó, envie-a e publique-a. Depois de publicado, o nó executa periodicamente conforme sua configuração de agendamento.

1. Clique no ícone na barra de ferramentas para salvar o nó.

2. Clique no ícone na barra de ferramentas para enviar a tarefa do nó.

   Na caixa de diálogo Submission, insira uma Change Description. Opcionalmente, escolha se deseja exigir revisão de código após o envio.

   Nota

   • Configure o Rerun attribute e os Parent Nodes do nó antes de enviá-lo.

   • A revisão de código ajuda a garantir a qualidade e evita erros causados pela publicação direta de código não revisado em produção. Se a revisão de código estiver ativada, os revisores devem aprovar o código do nó enviado antes da publicação. Para mais informações, consulte Code review.

Em workspaces no modo padrão, após enviar a tarefa com sucesso, clique em Publish no canto superior direito da página de edição do nó para implantar a tarefa no ambiente de produção. Para mais informações, consulte Publish a task.

Próximas etapas

Operações da tarefa: Após o envio e a publicação, a tarefa executa periodicamente conforme a configuração do nó. Clique em O&M no canto superior direito da página de edição do nó para acessar o Operation Center e visualizar o status de agendamento e execução da tarefa agendada. Para mais informações, consulte Managing Scheduled Tasks.

Documentação relacionada

Para implementar balanceamento de carga e alta disponibilidade em nós SSH, consulte Implement load balancing and high availability for SSH nodes.