Siga estas instrucciones para reemplazar los binarios GroundRunner y GroundRunnerMonitor en una máquina host con una versión más reciente.
Notas importantes sobre la planificación
- El servicio GroundRunner no soporta el apagado graceful. Cuando se detiene el servicio, cualquier operación en curso finaliza inmediatamente. Los resultados de esas operaciones se perderán y será necesario volver a ejecutar los comandos.
- Dado que la interrupción del servicio es perjudicial, le recomendamos encarecidamente que coordine una ventana de despliegue con las partes interesadas antes de realizar la actualización, y que se asegure de que no hay trabajos críticos en ejecución o programados para ejecutarse durante el periodo de mantenimiento.
Requisitos previos (todas las plataformas)
- Compruebe si necesita actualizarse. La versión actual (a 1 de junio de 2026) es la 9.21.1.
Consulte ¿Cómo compruebo la versión de un GroundRunner? para saber qué versión de GroundRunner está utilizando.
Si su GroundRunner no está actualizado, aparecerá el siguiente banner. - Si su GroundRunner no está actualizado, registre el número de versión que aparece en el campo Version.
Para plataformas Windows
- El Windows
GroundRunner.zip, obtenido de Workiva.
(Consulte Instalar y gestionar GroundRunners para más detalles) - Permisos de administrador para ambos:
- La máquina donde está instalado el GroundRunner.
- El directorio donde se instalan los binarios.
- Permiso para detener e iniciar el servicio GroundRunner.
Para plataformas Linux
- El Windows
GroundRunner.zip, obtenido de Workiva.
(Consulte Instalar y gestionar GroundRunners para más detalles) - Las utilidades de Linux
unzip(1),tar(1), ygzip(1)deben estar instaladas (son estándar en la mayoría de las instalaciones). - Permisos de propiedad de archivos (chown).
- Permisos de administrador para ambos:
- La máquina donde está instalado el GroundRunner.
- El directorio donde se instalan los binarios.
- Permiso para detener e iniciar el servicio GroundRunner.
Instalación en Windows
- Extraiga
GroundRunner.zipa un directorio temporal. - Abra la consola de Servicios: pulse
Win + R, escribaservices.msc, y pulse Enter. - Busque GroundRunner en la lista, haga clic con el botón derecho y seleccione Detener.
- Espere a que el estado muestre Detenido.
- Haga una copia de seguridad de los binarios existentes.
En el Explorador de archivos, vaya al directorio de instalación de GroundRunner y copieGroundRunner.exeyGroundRunnerMonitor.exey cualquier archivo de configuración a una ubicación de copia de seguridad (por ejemplo, cámbieles el nombre aGroundRunner.exe.bakyGroundRunnerMonitor.exe.bak). - Sustituya los binarios copiando
GroundRunner.exeyGroundRunnerMonitor.exedel directorio extraído al directorio de instalación, sobrescribiendo los archivos existentes. - De vuelta en la consola de Servicios, haga clic con el botón derecho del ratón en GroundRunner y seleccione Iniciar.
- Compruebe que el estado muestra Running.
Instalación de Linux (systemd)
Estas instrucciones son para sistemas Linux estándar no mejorados en seguridad. Si su host ejecuta SELinux, AppArmor u otro software de seguridad, consulte Mandatory Access Control (SELinux / AppArmor) al final de esta sección.
-
Extraiga los artefactos del archivo zip.
Nota: La extracción del archivo zip a
/tmp/groundrunner-updatese utiliza a modo de ejemplo. Puede extraer el zip donde mejor se ajuste a las políticas de su organización.unzip GroundRunner.zip -d /tmp/groundrunner-update
-
Detener el proceso en ejecución. Si utiliza systemd, utilice este comando:
sudo systemctl stop <nombre-del-servicio>
NOTA IMPORTANTE: Si usted no tiene su GroundRunner configurado como un servicio systemd, por favor configúrelo como un servicio systemd antes de realizar la actualización. Puede encontrar documentación sobre cómo configurar un servicio systemd en la documentación de su distribución Linux. Si utiliza una distribución de Linux que no sea Systemd, consulte la documentación de su distribución.
-
Haga una copia de seguridad de los binarios y configuraciones en el directorio GroundRunner:
cd /ruta_a_groundrunner_dir_de_instalacion tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version
Nota: Puedes hacer una copia de seguridad de todo el directorio de instalación (es decir, incluyendo logs y otras carpetas/archivos) pero eso puede crear un archivo de copia de seguridad extremadamente grande.
-
Sustituye los binarios:
cd /ruta_para_groundrunner_instalar_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .
-
Establece los permisos del ejecutable:
chmod +x GroundRunner GroundRunnerMonitor
Nota: Si su GroundRunner es ejecutado por un usuario específico del sistema, puede que necesite
chownlos nuevos ejecutables. -
Inicie el servicio:
sudo systemctl start <nombre del servicio>
-
Comprueba el estado del servicio para asegurarte de que funciona correctamente:
sudo systemctl status <nombre del servicio>
-
Limpia:
rm -rf /tmp/groundrunner-update
Control de acceso obligatorio (SELinux / AppArmor)
Si el host aplica una política de control de acceso obligatoria (SELinux, AppArmor o similar), la sustitución de binarios en disco puede provocar el fallo del servicio.
Consulte la documentación de su distribución para gestionar las políticas de seguridad en torno a los servicios personalizados.
Nota: Otro software de seguridad - como FAPOLICYD, IMA/EVM, o la supervisión personalizada de la integridad de los archivos - también puede bloquear la ejecución de los binarios reemplazados. Si el servicio no se inicia tras una actualización y ha descartado SELinux/AppArmor, compruebe si algún marco de seguridad adicional de su sistema requiere listas de confianza o firmas de archivos actualizadas.
Verificación
Puede confirmar que el GroundRunner está activo y que su versión es correcta siguiendo las instrucciones proporcionadas en ¿Cómo compruebo el estado de un GroundRunner?
Le animamos a crear y ejecutar una "cadena piloto" que ejecute un conjunto de comandos de prueba en el GroundRunner para garantizar una instalación correcta.
También le recomendamos que supervise su sistema y la actividad del GroundRunner inmediatamente después de actualizarlo y reiniciarlo. Esto le permite estar seguro de que funciona correctamente. Puede hacerlo mediante un comando CLI para transmitir y ver las nuevas entradas de registro a medida que se producen.
Para Windows
Para ver el final del archivo de registro mediante PowerShell, introduzca lo siguiente:
Get-Content -Path "C:\path_to_\output.log" -Tail 10 -Wait
Esto mantiene la ventana de PowerShell abierta y carga nuevas entradas de registro en tiempo real. -tail 10 carga las últimas 10 líneas inmediatamente.
Para Linux
Para ver el final del archivo de registro y transmitir las nuevas entradas en tiempo real, introduzca lo siguiente:
tail -f /ruta_a/salida.log
Retrocede
Si la nueva versión no funciona correctamente, puede volver a la versión anterior siguiendo estos pasos:
- Detenga el servicio GroundRunner como se ha descrito anteriormente.
- Cambie el nombre de los archivos instalados
GroundRunner.exeyGroundRunnerMonitor.exe. - Copie
GroundRunner.exe.bakyGroundRunnerMonitor.exe.bakde la ubicación de la copia de seguridad al directorio de instalación. - Cambie el nombre de estos archivos eliminando la extensión ".bak".
- Reinicie el servicio GroundRunner siguiendo los pasos adecuados descritos anteriormente.
Nota: Estas mismas instrucciones se aplican a Linux GroundRunners, pero tendrá que extraer los binarios de la copia de seguridad tarball.
Notas
- No cambie el nombre de los binarios. El mecanismo de actualización automática se basa en los nombres de ejecutables predeterminados (
GroundRunneryGroundRunnerMonitoren Linux, yGroundRunner.exeyGroundRunnerMonitor.exeen Windows) para detectar y aplicar futuras actualizaciones. Cambiarles el nombre interrumpirá las actualizaciones automáticas. - macOS sólo es compatible con fines de desarrollo. No es una plataforma de producción compatible.
- Otros gestores de servicios: Los ejemplos anteriores utilizan systemd (Linux) y el gestor de control de servicios de Windows. Si su entorno utiliza un gestor de servicios o un supervisor de procesos diferente, realice los pasos de parada, sustitución e inicio equivalentes para su configuración.
- Por defecto, los GroundRunner utilizan una cuenta administrativa local sin acceso a recursos remotos como las unidades compartidas. Para acceder a un recurso compartido, como una ruta UNC de Windows, inicia el GroundRunner con una cuenta de usuario con privilegios adecuados al recurso. Si utilizas una cuenta de usuario distinta a la del administrador local del sistema por defecto, concédele permisos para gestionar el directorio de instalación de GroundRunner para activar las actualizaciones automáticas.