Gestión de apps

Resumen

Esta página explica cómo activar, desactivar, actualizar y restringir por grupos las apps del servidor, desde la página de apps o con occ, y cómo configurar directorios de apps personalizados, el tiempo de espera de la tienda de apps y una tienda de apps autoalojada. Está dirigida a quienes administran el servidor.

Fuente: documentación de Nextcloud, «admin_manual/apps_management», versión 3ad9158, licencia CC BY 3.0; traducida y adaptada para APS Conecta Gestión.

En APS Conecta Gestión esto difiere

Ver «En APS Conecta Gestión».

Las apps de APS Conecta Gestión pueden ampliar, personalizar o restringir las funciones y la experiencia disponibles en el servidor APS Conecta Gestión para quien lo administra y para sus usuarios. Además de las apps integradas, como Archivos, Actividad y Fotos, otras apps como Calendario, Contactos y Talk pueden ampliar aún más su funcionalidad.

Después de instalar el servidor APS Conecta Gestión, puede convenir activar, desactivar o restringir algunas apps para grupos concretos, según las necesidades propias y las de los usuarios.

Apps

Durante la instalación del servidor APS Conecta Gestión, algunas apps se activan de forma predeterminada. Para ver qué apps están activadas, ir a la página de Apps.

Esas apps reciben soporte y desarrollo directamente de Nextcloud GmbH y tienen la etiqueta Destacadas.

Nota

El servidor APS Conecta Gestión necesita poder comunicarse con https://apps.nextcloud.com, https://ltd[1-3].nextcloud.com y https://garm[1-5].nextcloud.com para listar y descargar apps. Si es necesario, permitir estos hosts en el cortafuegos o en el proxy.

Nota

Para acceder a soluciones alternativas, soporte a largo plazo, corrección prioritaria de errores y consultoría a medida para las apps con soporte, contactar con Nextcloud GmbH.

Nota

Para desarrollar una app propia de APS Conecta Gestión, hay más información en el manual de desarrollo de Nextcloud.

Todas las apps deben tener la licencia AGPLv3+ o cualquier licencia compatible.

Gestión de apps

Se muestran las apps activadas, desactivadas y disponibles. También se muestran paquetes de apps adicionales y filtros, como Personalización, Seguridad y Monitorización, para encontrar más apps rápidamente.

En la página de Apps se pueden activar o desactivar aplicaciones. Algunas apps tienen opciones configurables en la página de Apps, como Activar solo para grupos específicos, pero principalmente se activan o desactivan aquí y se configuran en los ajustes de APS Conecta Gestión (configuraciones de administración o de usuario) o en config.php.

Al seleccionar una app se ven su descripción y las opciones de configuración disponibles. Al hacer clic en el botón Activar, la app se activa. Si la app no forma parte de la instalación de APS Conecta Gestión, se descarga desde la tienda de apps, se instala y se activa.

En esta página también se ofrecen las actualizaciones de las apps. Basta con hacer clic en el botón Actualizar para actualizar una app concreta, o usar el botón Actualizar todos de la parte superior de la página para actualizar todas las apps.

Nota

Versiones beta: también se pueden instalar versiones beta de las apps directamente desde aquí, cambiando APS Conecta Gestión al canal beta en la vista general de administración.

Notificaciones de actualización

La app predeterminada updatenotification envía a los administradores notificaciones sobre las actualizaciones disponibles de las apps y de APS Conecta Gestión. Además, desde APS Conecta Gestión 29, esta app también permite notificar a los usuarios sobre las apps actualizadas y los cambios que incluye la actualización. Esta notificación está activada de forma predeterminada si la app proporciona un registro de cambios.

Para desactivar las notificaciones a los usuarios, usar:

occ config:app:set --type boolean --value="false" updatenotification app_updated.enabled

De forma predeterminada, cuando se usa la app guests, los usuarios invitados no reciben notificaciones. Para activar las notificaciones para ellos, usar:

occ config:app:set --type boolean --value="true" updatenotification app_updated.notify_guests

Gestión de apps con occ

Además de gestionar las apps desde la interfaz web, los administradores pueden activar o desactivar apps con el comando occ.

Para activar una app, usar el siguiente comando:

occ app:enable <app-id>

Por ejemplo, para activar la app Archivos, ejecutar:

occ app:enable files

Para activar la app solo para grupos concretos, usar la opción --groups:

occ app:enable files --groups=admin

Este comando activa la app Archivos solo para el grupo «admin».

Para desactivar una app, usar:

occ app:disable <app-id>

Uso de API privadas

Si una app de terceros usa API privadas en lugar de API públicas, la instalación falla cuando en config.php está establecido 'appcodechecker' => true,.

Uso de directorios de apps personalizados

Usar el array apps_paths de config.php para establecer la ubicación de cualquier directorio de apps personalizado. La clave path define la ruta absoluta del sistema de archivos a la carpeta de apps. La clave url define la ruta web HTTP a esa carpeta, a partir de la raíz web de APS Conecta Gestión. La clave writable indica si un usuario puede instalar apps en esa carpeta.

Ejemplo: para que la carpeta predeterminada /apps/ contenga solo las apps que se distribuyen con APS Conecta Gestión, seguir este ejemplo para configurar una carpeta /extra-apps/ que se usará para almacenar cualquier app adicional que se instale:

"apps_paths" => [
    [
            "path"     => OC::$SERVERROOT . "/apps",
            "url"      => "/apps",
            "writable" => false,
    ],
    [
            "path"     => OC::$SERVERROOT . "/extra-apps",
            "url"      => "/extra-apps",
            "writable" => true,
    ],
],

Peligro

Asegurarse de que los valores elegidos para path y url de cualquier directorio de apps personalizado no entren en conflicto con directorios que ya existen en la raíz del servidor APS Conecta Gestión (el directorio de instalación).

Truco

Las rutas de apps pueden estar fuera de la raíz del servidor. Sin embargo, para cualquier path fuera de la raíz del servidor, hay que crear en la raíz del servidor un enlace simbólico que haga apuntar url a path. Por ejemplo, si path es /var/local/lib/nextcloud/extra-apps y url es /extra-apps, se usaría el comando ln para crear el enlace simbólico así: ln -sf /var/local/lib/nextcloud/extra-apps ./extra-apps

Configuración del tiempo de espera de la tienda de apps

El tiempo de espera de las solicitudes para obtener los metadatos de la tienda de apps puede configurarse con el ajuste de app appstore-timeout. El valor se indica en segundos. Este ajuste se configura con occ y no es un parámetro de config.php.

Por ejemplo, para establecer el tiempo de espera en 180 segundos:

occ config:app:set settings appstore-timeout --value=180

El tiempo de espera predeterminado es de 120 segundos. Para restaurar el valor predeterminado, eliminar el ajuste personalizado:

occ config:app:delete settings appstore-timeout

Cambiado en la versión 33.0.0: El tiempo de espera predeterminado de las solicitudes a la tienda de apps aumentó de 60 a 120 segundos y puede configurarse con occ.

Uso de una tienda de apps autoalojada

Esta sección explica cómo permitir la instalación de apps desde una tienda de apps autoalojada. Al menos uno de los directorios de apps configurados debe ser escribible.

Para activar una tienda de apps autoalojada:

1. Establecer el parámetro appstoreenabled en true.

   Este parámetro se usa para activar la tienda de apps en APS Conecta Gestión.

2. Establecer appstoreurl en la URL de la tienda de apps de APS Conecta Gestión propia.

   Este parámetro se usa para establecer la ruta HTTP a la tienda de apps de APS Conecta Gestión autoalojada.

"appstoreenabled" => true,
"appstoreurl" => "https://my.appstore.instance/v1",

De forma predeterminada, la tienda de apps está activada y configurada para usar https://apps.nextcloud.com/api/v1 como URL de la tienda de apps. APS Conecta Gestión obtiene apps.json y categories.json desde allí. Para volver a usar los valores predeterminados, eliminar los parámetros appstoreenabled y appstoreurl de la configuración.

Ejemplo: si categories.json está disponible en https://apps.nextcloud.com/api/v1/categories.json, la URL de la tienda de apps es https://apps.nextcloud.com/api/v1.

En APS Conecta Gestión

Nota

Los cambios del plan de actualización corresponden a la próxima versión. Consulte su estado en Novedades de instalador y seleccione una versión publicada para instalar.

En APS Conecta Gestión la tienda de aplicaciones está cerrada: la imagen del servidor fija NC_appstoreenabled en "0", de modo que ninguna vía —occ, las tareas de fondo o esta página— descarga de la tienda sin que alguien lo haya decidido. La puerta se abre solo para el comando que instala o actualiza una aplicación de la tienda, una a una, y se cierra con él. Ninguna imagen lleva una aplicación: cada una llega en su momento, por el canal que declara el manifiesto de la suite (apps.json, en el repositorio instalador):

Canal	Aplicaciones	Cómo llegan
Publicación firmada	Territorio, Epidemiología, IntraVox, la protección de cargas y el proveedor de archivos para búsqueda	La publicación firmada más reciente del repositorio de cada aplicación, la compatible con la versión de APS Conecta Gestión en marcha, verificada contra la clave de aplicaciones de la suite antes de desempacar
Tienda	Euro-Office, Talk, Custom Menu, Calendario, Contactos, carpetas de grupo, notificaciones, antivirus, búsqueda y su conector de Elasticsearch	La tienda, abierta solo para el comando que las instala
Opcionales	Farmacia, Estadística y Tótem	Solo cuando el establecimiento las elige en el paso 6 del instalador; sin la elección, no se instalan ni se descargan

La versión de cada publicación propia o fork queda registrada en el candado (/opt/aps-conecta/apps.lock.json). Las provisiones repetidas reutilizan el paquete verificado; una reparación conserva la versión registrada. Las aplicaciones se mueven solo con sudo aps-conecta actualizar, que respalda primero, aplica una aplicación a la vez, desinstala al final cada aplicación publicada que salió del manifiesto y mueve el candado solo si todo resultó (AIO). El botón Actualizar de esta página no es el camino: con la tienda cerrada no descarga nada.

Las versiones fijadas en el manifiesto cumplen la compatibilidad con APS Conecta Gestión y el mínimo del candado. Un rechazo identifica la aplicación y el motivo, y conserva el registro instalado. Solicite al responsable de la plataforma una versión compatible y repita sudo aps-conecta actualizar --revisar.

La política de aplicaciones restringe al grupo admin las aplicaciones de soporte y diagnóstico que trae el servidor, desactiva survey_client, nextcloud_announcements y office (la vista general de oficina; el editor de documentos es eurooffice) y apaga la telemetría de IntraVox. Agregar o quitar una aplicación es un cambio en el manifiesto de la suite, no una acción en la página Aplicaciones; lo que la instancia tiene sin estar declarado lo informa el registro de divergencia.