Cada aplicación web de los servidores tiene un archivo de entorno: una lista de configuraciones, una CLAVE=valor por línea, que la aplicación lee. Ploi Env Tool guarda un conjunto de esas configuraciones para cada ambiente y, al guardar, las escribe en el archivo de entorno de cada sitio que coincide a través de Ploi. Cambia muchos sitios con un clic, así que lee lo que hace antes de usarla.
Quién puede usarla
Ploi Env Tool está en el menú lateral del panel de administración; la página se titula Herramienta Env Ploi. Para llegar al panel, abre el menú de arriba a la derecha y elige Ir al Panel de Administrador. Solo los super administradores ven la entrada y pueden abrir la página; cualquier otra persona recibe una página de error 405.
La página
La página tiene cuatro secciones:
- Todos los sitios: configuraciones que se escriben en todos los sitios, sea cual sea su ambiente.
- Producción, Desarrollo y Staging: configuraciones que se escriben solo en los sitios de ese ambiente.
Un sitio recibe las configuraciones de Todos los sitios más las de su propio ambiente. Cuando la misma clave está en las dos, gana el valor del ambiente.
Cada sección tiene una tabla con Clave, Valor, Habilitado y Acción, que tiene el botón Eliminar de cada fila, y debajo Sitios coincidentes: los sitios en los que escribe la sección, cada uno con su dominio, proyecto, servidor y ambiente. Solo se listan las aplicaciones configuradas en Ploi, en un servidor con Ploi Id. Sin ninguna, dice Actualmente no hay sitios de Ploi que coincidan con este entorno. Cómo se configuran las aplicaciones está en Servidores y aplicaciones.
Los valores se guardan cifrados, pero la página los muestra completos en la tabla. Cualquiera que vea tu pantalla puede leerlos.
Cambia las configuraciones y escríbelas en los sitios
- En la sección que quieras, cambia una Clave o un Valor, o haz clic en Agregar clave para una fila nueva.
- Desmarca Habilitado para dejar de escribir una clave sin borrarla.
- Haz clic en Eliminar para quitar una fila de la lista. Quitar la última fila de una sección deja una fila vacía en su lugar; una fila vacía se descarta al guardar.
- Haz clic en el botón de guardar de la sección, como Guardar Producción.
Guardar hace dos cosas de inmediato, sin confirmación: guarda las filas de la sección y escribe las configuraciones en cada sitio de Sitios coincidentes. Guardar Todos los sitios escribe en todos los sitios.
- Las claves se pasan a mayúsculas. Una fila sin clave se descarta.
- Una clave puede aparecer solo una vez por sección. Si no, verás Las claves deben ser únicas dentro del entorno seleccionado. y no se guarda nada.
- Algunas claves ya vienen cargadas en Todos los sitios. Si quitas una, vuelve la próxima vez que abras la página; desmarca Habilitado en su lugar.
Qué pasa en cada sitio
Para cada clave habilitada, el archivo de entorno del sitio recibe la línea CLAVE=valor: la línea se agrega si faltaba, y su valor se reemplaza si ya estaba. Las líneas repetidas de la misma clave se reducen a una. El resto del archivo queda igual. Después se vuelve a leer el archivo para comprobar que cada valor quedó.
Al terminar verás Valores predeterminados del entorno de Ploi guardados, y la sección muestra cuántos sitios quedaron Actualizado, Sin cambios y Falló, con una línea por sitio:
- actualizado con Env actualizado.
- sin cambios con No se necesitan cambios.
- fallido con Ploi aceptó el cambio de env, pero falló la verificación., o el error que devolvió Ploi.
Última ejecución de sincronización n.º da el número de la ejecución. Cuando vuelves más tarde, la sección muestra en su lugar Ejecuciones de sincronización recientes: las últimas cinco, con cuántos sitios se actualizaron y fallaron, el resultado y cuándo corrió. El historial mantiene ocultos los valores que parecen secretos.
Riesgos
- Un guardado cambia el archivo de entorno de todos los sitios que coinciden, de todos los proyectos, a la vez. Un valor equivocado llega a todos.
- No hay forma de deshacer. Para volver atrás, pon el valor anterior y guarda de nuevo.
- Un sitio que falló puede conservar su archivo anterior o haberse cambiado sin pasar la comprobación. Revisa su mensaje, y guarda de nuevo cuando el problema esté resuelto.
Lo que no hace
- No borra líneas de los archivos de los sitios. Quitar una fila, o desmarcar Habilitado, solo deja de escribir esa clave; la línea que ya está en cada archivo se queda.
- No despliega ni reinicia los sitios.
- No toca aplicaciones sin identificador de Ploi.
- No elige sitios individuales: una sección siempre escribe en todos sus sitios que coinciden.