DataWorks:Nodo SSH

Notas de uso

• Cuando utiliza un nodo SSH para iniciar un proceso en un host remoto, si la tarea del nodo SSH finaliza de manera inesperada (por ejemplo, debido a un tiempo de espera agotado), el proceso en el host remoto no se ve afectado. DataWorks no envía ningún comando para finalizar el proceso.

• Los nodos SSH admiten la sintaxis estándar de Shell, pero no son compatibles con la sintaxis interactiva.

• Al usar un nodo SSH para ejecutar remotamente un script en una instancia de ECS, se crean archivos temporales en la instancia. Asegúrese de que la instancia de ECS cuente con espacio suficiente en disco y que el límite máximo de archivos cumpla con sus requisitos.

• Evite que varias tareas operen sobre el mismo archivo simultáneamente; de lo contrario, el nodo SSH podría fallar.

Requisitos previos

• Se ha creado el flujo de negocio.

  Data Studio realiza operaciones de desarrollo específicas del motor basadas en flujos de negocio. Antes de crear un nodo, debe crear primero un flujo de negocio. Para obtener más información, consulte Create a business flow.

• Se ha creado un origen de datos SSH.

  Antes de poder desarrollar y programar tareas recurrentes con un nodo SSH, debe crear un origen de datos SSH para acceder a su servidor SSH. Para crear un origen de datos, consulte SSH data source.

  Nota

  Los nodos SSH solo admiten orígenes de datos SSH creados con una cadena de conexión JDBC. Para evitar fallos en las tareas, asegúrese de que el origen de datos tenga conectividad de red con el resource group.

• (Opcional; obligatorio para usuarios de Resource Access Management (RAM)) El usuario de RAM utilizado para el desarrollo de tareas se ha agregado al espacio de trabajo destino y se le ha asignado el rol Development o Workspace Administrator (que otorga amplios permisos; asígnelo con precaución). Para obtener más información sobre cómo agregar miembros y conceder permisos, consulte Add members to a workspace.

Limitaciones

• Puede ejecutar tareas SSH en resource groups Serverless. Para obtener más información sobre cómo adquirir y utilizar resource groups Serverless, consulte Use Serverless resource groups.

• Regiones compatibles: 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) y US (Virginia).

• La longitud máxima de código para un nodo SSH es 128 KB.

Paso 1: Crear un nodo SSH

1. Inicie sesión en la consola de DataWorks. En la región destino, haga clic en Data Development and O&M > Data Development en el panel de navegación izquierdo. Seleccione un espacio de trabajo de la lista desplegable y haga clic en Go to Data Development.

2. Haga clic con el botón derecho en el flujo de trabajo destino y seleccione Create Node > SSH.

3. En el cuadro de diálogo Create Node, introduzca un Name para el nodo y haga clic en OK. Una vez creado el nodo, podrá desarrollar y configurar la tarea.

Paso 2: Desarrollar una tarea 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

Paso 3: Configurar la programación de la tarea

Para ejecutar periódicamente la tarea del nodo, haga clic en Scheduling en el lado derecho de la página de edición del nodo y configure los ajustes de programación según sus necesidades. Para obtener más información, consulte Overview of task scheduling properties.

Paso 5: Enviar y publicar la tarea

Después de configurar la tarea del nodo, envíela y publíquela. Una vez publicada, el nodo se ejecuta periódicamente según su configuración de programación.

1. Haga clic en el icono de la barra de herramientas para guardar el nodo.

2. Haga clic en el icono de la barra de herramientas para enviar la tarea del nodo.

   En el cuadro de diálogo Submission, introduzca una Change Description. Opcionalmente, elija si desea requerir una revisión de código después del envío.

   Nota

   • Debe configurar el Rerun attribute y los Parent Nodes del nodo antes de poder enviarlo.

   • La revisión de código ayuda a garantizar la calidad del código y evita errores causados por la publicación directa de código no revisado en producción. Si la revisión de código está habilitada, los revisores deben aprobar el código del nodo enviado antes de que pueda publicarse. Para obtener más información, consulte Code review.

Si utiliza un espacio de trabajo en modo estándar, después de enviar correctamente la tarea, haga clic en Publish en la esquina superior derecha de la página de edición del nodo para desplegar la tarea en el entorno de producción. Para obtener más información, consulte Publish a task.

Pasos siguientes

Operaciones de tareas: Después de enviar y publicar una tarea, esta se ejecuta periódicamente según la configuración del nodo. Puede hacer clic en O&M en la esquina superior derecha de la página de edición del nodo para ir al Operation Center y consultar el estado de programación y ejecución de la tarea programada. Para obtener más información, consulte Managing Scheduled Tasks.

Documentación relacionada

Para obtener información sobre la implementación de balanceo de carga y alta disponibilidad para nodos SSH, consulte Implement load balancing and high availability for SSH nodes.