Linux

info

A partir de la versión 7 de Passwork, las actualizaciones a través de git ya no son compatibles. Para actualizar Passwork, hemos preparado un script.

Actualización en línea

1. Obtenga el script:

wget

wget https://repos.passwork.pro/repository/linux/scripts/passwork.sh

curl

curl -O https://repos.passwork.pro/repository/linux/scripts/passwork.sh

peligro

El script de actualización de Passwork no debe estar ubicado en el directorio junto con los archivos del servidor de aplicaciones.

2. Asigne derechos de ejecución al script:

shell

chmod +x passwork.sh

De forma predeterminada, el script passwork.sh realizará:

• Creación de un archivo oculto .script_env en el directorio actual;
• Creación de un directorio passwork_archive para la copia de seguridad de Passwork;
• Obtención de la última versión disponible de Passwork, firma y clave pública;
• Instalación del archivo previamente obtenido en /var/www/

Acciones realizadas

1. Verificar que todas las herramientas del sistema necesarias estén instaladas — php, curl, jq, zip, unzip, file, stat, find
2. Verificar la versión de PHP y compararla con la requerida (8.3)
3. Verificar la disponibilidad del portal de clientes de Passwork para determinar el modo de instalación
4. Si Passwork ya está instalado (el archivo .env está presente), cambiar el modo a UPDATE; si no se encuentra el archivo, usar el modo INSTALL
5. Si el archivo .script_env existe, leer y obtener la clave API
6. Si la clave API no está configurada, solicitar al usuario que la introduzca y validar el formato
7. Obtener el número de la última versión disponible mediante solicitud API
8. Comparar la versión obtenida con la versión actual de Passwork
9. Si hay una nueva versión disponible, descargar el archivo usando la solicitud y la clave API
10. Verificar la recepción correcta del archivo ZIP
11. Obtener la firma digital y la clave pública
12. Verificar el archivo ZIP usando OpenSSL
13. Descomprimir el archivo ZIP en un directorio temporal
14. Realizar una copia de seguridad de la versión actual
15. Limpiar el directorio de la versión anterior, preservando los archivos de configuración y los registros
16. Verificar los derechos de acceso al directorio
17. Cambiar los permisos del propietario si el propietario no es root
18. Modificar la configuración de OPcache si no está configurada
19. Reiniciar el servidor web y el servicio php-fpm
20. Luego ejecutar el comando de actualización de versión update

info

Para usar una ruta de instalación no estándar, deshabilitar la verificación de certificados o cambiar el comportamiento, utilice — parámetros del script

3. Ejecute el script:

shell

sudo ./passwork.sh

En la primera ejecución, el script solicitará la clave API y realizará verificaciones básicas del entorno:

Ejemplo de ejecución exitosa del script:

Actualización sin conexión

Obtenga el script en otra máquina con acceso a Internet:

wget

wget https://repos.passwork.pro/repository/linux/scripts/passwork.sh

curl

curl -O https://repos.passwork.pro/repository/linux/scripts/passwork.sh

PowerShell

(New-Object System.Net.WebClient).DownloadFile("https://repos.passwork.pro/repository/linux/scripts/passwork.sh", "$PWD\passwork.sh")

info

O bien obtenga el script passwork.sh manualmente usando el enlace

peligro

El script de actualización de Passwork no debe estar ubicado en el directorio junto con los archivos del servidor de aplicaciones.

Asigne derechos de ejecución al script:

shell

chmod +x passwork.sh

Antes de ejecutar passwork.sh, debe:

• Obtener la versión 7 de Passwork del Portal de clientes de Passwork (obligatorio);
• Colocarlo en el directorio de ejecución o usar el argumento --input para especificar la ubicación (obligatorio);
• Obtener la firma del archivo y la clave pública de Passwork (opcional si se usa el argumento --skip).

De forma predeterminada, el script passwork.sh realizará:

• Creación de un directorio passwork_archive para la copia de seguridad de Passwork;
• Descompresión del archivo de Passwork;
• Instalación del archivo previamente obtenido en /var/www/

Acciones realizadas

1. Verificar que todas las herramientas del sistema necesarias estén instaladas — php, curl, jq, zip, unzip, file, stat, find
2. Verificar la versión de PHP y compararla con la requerida (8.3)
3. Verificar la disponibilidad del portal de clientes de Passwork para determinar el modo de instalación
4. Si la conexión falla o se usa la marca --offline, cambiar al modo sin conexión
5. Confirmar la instalación en modo sin conexión
6. Buscar el último archivo en formato Passwork-*.zip en el directorio
7. Extraer el número de versión del archivo ZIP y verificar que no sea inferior a 070000
8. Si Passwork ya está instalado (el archivo .env está presente), cambiar el modo a UPDATE; si no se encuentra el archivo, usar el modo INSTALL
9. Comparar la versión del archivo con la versión actual de Passwork
10. Mover el ZIP a un directorio temporal
11. Buscar y mover la firma digital y la clave pública de Passwork
12. Verificar el archivo ZIP usando OpenSSL
13. Descomprimir el archivo ZIP en un directorio temporal
14. Realizar una copia de seguridad de la versión actual
15. Limpiar el directorio de la versión anterior, preservando los archivos de configuración y los registros
16. Verificar los derechos de acceso al directorio
17. Cambiar los permisos del propietario si el propietario no es root
18. Modificar la configuración de OPcache si no está configurada
19. Reiniciar el servidor web y el servicio php-fpm
20. Luego ejecutar el comando de actualización de versión update

Después de la preparación, ejecute el script passwork.sh:

shell

sudo ./passwork.sh -offline

Ejemplo de ejecución exitosa del script:

Parámetros del script

-i, --input

Ruta al archivo en offline_mode. También define la ubicación de .script_env, passwork_archives:

shell

sudo ./passwork.sh -i "/home/administrator/passwork"

-o, --output

Ruta de instalación (predeterminado: /var/www):

shell

sudo ./passwork.sh -o "/var/www/passwork"

-offline, --offline

Modo sin conexión forzado. Requiere preparación manual:

shell

sudo ./passwork.sh -offline

-insecure, --insecure

Omitir la verificación de certificados (se usa si el servidor carece de certificados CA):

shell

sudo ./passwork.sh -insecure

-skip, --skip

Omitir la verificación de la firma del archivo de Passwork:

shell

  sudo ./passwork.sh -skip