Herramientas de desarrollo · Generador de Crontab
Leer una expresión cron en voz alta: cómo */5 9-17 * * 1-5 se convierten en palabras
· Cómo funciona
cron revisión de código flujo de trabajo del desarrollador
Traducir una expresión al inglés es un proceso mecánico una vez que conoces el orden. Esta publicación brinda el algoritmo de lectura, lo aplica a ejemplos complicados y muestra cómo la explicación de un generador lo ayuda a verificar.
Un crontab en la diferencia que no puedes revisar: cinco campos con pasos y rangos, y ningún comentario que los explique
Una expresión de cinco tokens en una solicitud de extracción es una política ejecutable comprimida en puntuación. Los revisores que reconocen la forma pero no pueden decir el cronograma en voz alta probablemente pasen por alto un punto final inclusivo, un paso fuera de lugar o la relación especial entre los dos campos del día. Por tanto, la traducción es una comprobación de la corrección, no una documentación cosmética.
ToolAcre deriva su oración del objeto analizado utilizado por advertencias y vistas previas. Pega sólo los cinco campos, dejando el comando y los secretos afuera. Si el texto generado difiere del comentario del autor, pausa la revisión y resuelve la intención antes de que la expresión se instale en cualquier lugar.
Lea primero los campos del día: el día de la semana y el mes le indican qué días, luego los minutos y la hora le indican cuándo.
El alcance del calendario es más fácil de establecer antes del detalle del reloj. El mes y el día de la semana revelan qué partes del año o de la semana son elegibles; el día del mes puede agregar otra condición de calendario; hora y minuto y luego coloque las ejecuciones dentro de fechas coincidentes. Este orden de lectura es para revisión humana, mientras que el orden posicional almacenado de la expresión permanece en primer lugar.
Pregunte siempre si ambos campos de día están restringidos. Si es así, ToolAcre los une con “o” y emite una advertencia. Leerlos casualmente como filtros AND adyacentes cambia el horario. Un comodín en un campo de día elimina esa ambigüedad y permite que el otro campo actúe como única restricción de día.
Traducir cada token: * como 'cada', un número como 'en', un rango como 'desde–hasta', un paso como 'cada N comenzando en'
Una estrella significa cada valor permitido en esa posición. Un número selecciona un valor. Un guión incluye todos los valores entre sus puntos finales. Las comas combinan elementos y una barra diagonal muestra cada enésimo valor desde el inicio de un comodín, rango o inicio simple. El mínimo del campo determina dónde comienza un paso comodín.
Se aceptan nombres para meses y días laborables sin importar el caso, incluidos rangos como `JAN-MAR` y `MON-FRI`. El domingo puede escribirse 0 o 7 y está normalizado a 0. El código de descripción convierte valores expandidos contiguos en textos "finales" y valores no contiguos en una lista legible.
Ejemplo resuelto: la herramienta describe las horas seleccionadas, mientras que los valores de minutos expandidos identifican la ejecución final
`*/5 9-17 * * 1-5` selecciona valores de minutos 0 a 55 en pasos de cinco, horas 9 a 17 y días laborables de lunes a viernes. La herramienta describe pasos de minutos a lo largo del lapso de horas seleccionado. Al expandir los valores se muestra que el candidato final en la hora 17 incluida es 17:55.
Ese último candidato a menudo se pasa por alto cuando “9-17” se parafrasea como un límite de día hábil. Cron selecciona valores de hora completos y luego los combina con todos los minutos seleccionados. Si la intención termina en 17:00, la expresión no puede revisarse como correcta simplemente porque las palabras “nueve a cinco” le resultan familiares.
Ejemplo resuelto: 0 0 1,15 * 3 — leer el campo del día O descartar en voz alta para que no se pierda
Ahora lea `0 0 1,15 * 3`. Se selecciona medianoche, el día del mes es el primero o el decimoquinto y el día laborable es el miércoles. Debido a que ambos campos de día están restringidos, la condición del calendario es el primero o el quince de cada mes O todos los miércoles. No es "miércoles cuando la fecha es 1 o 15".
La advertencia de ToolAcre resalta esa unión y su descripción inserta la palabra "o". La vista previa de la próxima ejecución proporciona fechas concretas para la zona seleccionada. Revise los tres resultados porque una oración fluida por sí sola aún puede ocultar que el requisito subyacente era una intersección que el dialecto no puede expresar directamente.
Almacene un comentario de intención solo después de compararlo con la expresión
Un comentario encima de una expresión puede preservar la intención, pero también puede preservar una vieja mentira después de que cambian los campos. Genere o reconstruya manualmente la oración a partir de los tokens actuales durante la revisión. Si una edición cambia `0` a `*/5`, actualice el comentario solo después de confirmar el conjunto de minutos ampliado y la ejecución final.
Prefiera un comentario que indique la suposición de la zona del reloj de pared así como la frecuencia. La expresión no contiene ningún campo de zona horaria, mientras que la vista previa de ToolAcre le pide al revisor que elija uno. Esa nota ayuda a otra persona a reproducir la misma lista sin implicar que la elección del navegador configure el eventual programador.
Se rechazan las gramáticas de seis y siete campos, no se traducen
El analizador requiere exactamente cinco campos. Una entrada de seis campos recibe una explicación específica sobre el estilo de los segundos principales; las formas más largas no se interpretan. ToolAcre tampoco tiene campo de año. Por lo tanto, el algoritmo en inglés simple de este artículo se aplica únicamente a la gramática de cinco campos del repositorio.
No elimine un campo de Quartz, Spring u otro producto hasta que el texto restante se valide. Los operadores no compatibles pueden tener un significado esencial. La traducción requiere documentación para ambos sistemas, mientras que este generador proporciona evidencia solo para sus propios valores, nombres, rangos, listas, pasos, comodines y alias aceptados.
Conclusión: cada expresión tiene una oración, y el generador de Crontab produce esa oración para que puedas compararla con la intención.
Cada expresión admitida se puede expandir a valores de campo finitos y una oración de calendario. La lectura de esos valores expone candidatos marginales que las frases informales omiten. También fuerza la regla OR del campo diurno en la conversación antes de que la programación llegue a un host operativo.
Para revisar, pegue la expresión, compare la descripción generada con el requisito establecido, inspeccione las advertencias y muestre los próximos tiempos. Mantenga el comentario resultante al lado de la línea, pero trate la expresión analizada como la fuente ejecutable. El generador explica la intención del cronograma; no da fe de un comando ni lo instala.