Aumentar tamaño de memoria para Araí Docs

Para los entornos productivos de SEEI, es necesario ampliar los valores memory_limit, post_max_size y upload_max_filesize en PHP para el servicio de Arai-documentos ya que en ocasiones pueden resultar demasiado contenidos.

El objetivo es modificar el parámetro memory-limit de PHP en el deploy de Arai-Documentos.

A tal efecto se debe crear la carpeta ./prod/arai/config y dentro esa carpeta debe crearse el archivo de texto custom_php.ini.

El contenido del archivo custom_php.ini debe ser:

memory_limit = 1024M
post_max_size = 256M
upload_max_filesize = 16M

(Tiene que estar expresado siempre en megas, y pueden ser estos valores o el límite que necesite).

Nota: Los recursos que se modifican en esta guia tienen como tope los asignados al contenedor durante la definición del servicio.

Luego de guardar el archivo y dentro de la carpeta ./prod es necesario crear el config de docker para poder modificar la configuración del deploy.

docker config create custom_config ./config/custom_php.ini

Luego hay que editar el archivo docs.yml y al final del mismo agregar las siguientes líneas para vincular el config creado con el deploy (respetando la identación, siempre con espacios y no con tabs).

configs:
  custom_config:
    external: true

En el mismo archivo para el servicio api, agregar la vinculación del config con el archivo de configuración de PHP respetando la identación igual que en el caso anterior.

services:
  api:
    configs:
      source: custom_config
      target: /etc/php7/conf.d/app.ini

Acompañando lo anterior es recomendable aumentar los límites de recursos del servicio api, como se muestra en el siguiente ejemplo:

services:
  api:
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 1024M

El último paso va a ser re-deployar el stack de arai-documantos, para que se actualice el contenedor.

En caso de querer modificar algún otro parámetro de php, la secuencia sería la siguiente:

• Modificar el archivo creado custom_php.ini agregando el parámetro deseado
• Borrar el config creado mediante docker config rm custom_config
• Crear nuevamente el config con el archivo modificado como se indico anteriormente
• Volver a deployar el stack

Personalización de recursos de sudocu api-server

Tomando en cuenta el anterior aumento de recursos para el servicio docs api, es recomendable el aumentar los límites de recursos asignados para el contenedor de api-server. Los valores por defecto son los siguientes:

services:
  api-server:
    deploy:
      resources:
        limits:
          cpus: '0.50'
          memory: 1024M

Estos se pueden aumentar dependiendo de la necesidad actual, ademas es posible comentar el valor cpus sabiendo que cuando este esté en ejecución va a utilizar lo necesario, teniendo como límite el total de cpus de la máquina.

Luego de eso debe vovler a deployar el stack.