SchedulerxWorker parameters - SchedulerX - Centro de documentación de Alibaba Cloud

Configure SchedulerxWorker para controlar cómo se conecta su aplicación a SchedulerX, cómo gestiona los recursos y cómo maneja el apagado. Este tema enumera todos los parámetros disponibles agrupados por función, con sus valores predeterminados y guías de uso.

Parámetros de conexión

Estos parámetros establecen la conexión entre su aplicación y SchedulerX.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setEndpoint(String endpoint)`	El endpoint para una región específica.	Ninguna	Sí
`setNamespace(String namespace)`	El ID del namespace.	Ninguna	Sí
`setGroupId(String groupId)`	El application ID (ID de grupo). Se genera cuando crea la aplicación en la consola de SchedulerX.	Ninguna	Sí

Parámetros de autenticación

Autentique su aplicación con SchedulerX. Utilice un par de AccessKey o una appKey, pero no ambos.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setAliyunAccessKey(String aliyunAccessKey)`	El AccessKey ID de su cuenta de Alibaba Cloud. No es obligatorio si utiliza appKey para la autenticación.	Ninguna	Condicional
`setAliyunSecretKey(String aliyunSecretKey)`	El AccessKey secret de su cuenta de Alibaba Cloud. No es obligatorio si utiliza appKey para la autenticación.	Ninguna	Condicional

Parámetros de red

Anule la configuración de red detectada automáticamente cuando su entorno requiera una configuración explícita.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setHost(String host)`	La dirección IP de la aplicación. Establezca este valor cuando la dirección IP detectada automáticamente sea incorrecta, como en entornos con varias tarjetas de interfaz de red (NIC) o VPN.	Ninguna	No
`setPort(int port)`	El puerto en el que escucha la aplicación.	Ninguna	No

Parámetros del pool de recursos

Ajuste la asignación de recursos para la ejecución simultánea de trabajos.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setEnableBatchWork(boolean enableBatchWork)`	Habilita el cómputo en malla. Consulte la guía de cómputo en malla para obtener más detalles.	true	No
`setShareContainerPool(boolean shareConatinerPool)`	Permite que todos los trabajos de la aplicación compartan el mismo pool de contenedores. Habilite esta opción cuando se ejecuten muchos trabajos de forma concurrente. Cuando está habilitada, `setSharePoolSize` controla el tamaño del pool.	false	No
`setSharePoolSize(int sharePoolSize)`	El tamaño del pool de contenedores compartido. Solo aplica cuando `setShareContainerPool` se establece en `true`.	64	No

Parámetros de frecuencia de programación

Realice un fine-tune de la frecuencia de programación de trabajos y del comportamiento de retraso.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setMapMasterStatusCheckInterval(int interval)`	El intervalo, en milisegundos, con el que SchedulerX comprueba si todas las tareas del modelo Map han finalizado. Los valores más bajos aumentan la frecuencia de comprobación. Reduzca este valor para incrementar la frecuencia de activación en trabajos de retraso en segundos.	3000	No
`setEnableSecondDelayCycleIntervalMs(boolean enable)`	Cambia la unidad de retraso para trabajos de retraso en segundos de segundos a milisegundos en la consola. Establézcalo en `true` para aumentar la frecuencia de activación en trabajos de retraso en segundos.	false	No

Parámetros de apagado graceful

Controle cómo se apaga la aplicación. setGraceShutdownMode y setGraceShutdownTimeout funcionan en conjunto. El apagado graceful está deshabilitado de forma predeterminada. Para habilitarlo, configure ambos parámetros: elija un modo de apagado y establezca un valor de tiempo de espera mayor que 0.

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setGraceShutdownMode(String mode)`	El modo de apagado graceful. Valores válidos: `WAIT_ALL` (la aplicación se cierra solo después de que finalicen todos los trabajos y tareas recibidos) y `WAIT_RUNNING` (la aplicación se cierra después de que finalicen los trabajos en ejecución y las tareas que tienen hilos asignados).	Ninguna (deshabilitado)	No
`setGraceShutdownTimeout(long delay)`	El periodo de gracia de apagado en segundos. Si no se establece o se configura con un valor menor o igual a 0, el apagado graceful no surte efecto, incluso si `setGraceShutdownMode` está configurado.	Ninguna	No

Parámetros avanzados

Parámetro	Descripción	Valor predeterminado	Obligatorio
`setBlockAppStart(boolean block)`	Bloquea el inicio del proceso de la aplicación si SchedulerX no logra completar la inicialización.	Ninguna	No
`setClassLoader(ClassLoader userClassLoader)`	Un cargador de clases personalizado. Puede ser necesario para aplicaciones que no usan Spring y que emplean un framework de terceros.	Ninguna	No
`setLabel(String label)`	Etiquetas agregadas a la aplicación durante el inicio. Utilice etiquetas para designar workers específicos para la programación de trabajos. Adecuado para escenarios de versión canary y pruebas de estrés.	Ninguna	No
`setSlsCollectorEnable(boolean enable)`	Habilita la recopilación de registros de Simple Log Service (SLS).	true	No

Guía de cómputo en malla

El parámetro setEnableBatchWork controla el cómputo en malla y su valor predeterminado es true.

Si su aplicación no utiliza cómputo en malla, establezca setEnableBatchWork en false.
Si su aplicación utiliza cómputo en malla, conserve el valor predeterminado de true. Establecerlo en false provoca que la primera activación de trabajo en cada worker se retrase como mínimo 20 segundos.

Dependencias entre parámetros

Algunos parámetros dependen entre sí. Configúrelos en conjunto para evitar comportamientos inesperados.

Parámetro	Depende de	Relación
`setSharePoolSize`	`setShareContainerPool`	`setSharePoolSize` solo surte efecto cuando `setShareContainerPool` es `true`.
`setGraceShutdownTimeout`	`setGraceShutdownMode`	Ambos deben configurarse para que funcione el apagado graceful. El tiempo de espera debe ser mayor que 0.
`setAliyunAccessKey`	`setAliyunSecretKey`	Siempre configure ambos en conjunto. No son obligatorios si utiliza appKey para la autenticación.