Uso de WebContentTools
Resumen de la información que se explica en la página
En esta sección describiremos cómo manejar la herramienta y daremos una descripción breve de las distintas tareas que podemos ejecutar
Antes de usar cualquiera de los pipelines de WebContentTools
Es muy importante que antes de usar cualquiera de las acciones de la herramienta (pipelines) validar que el equipo de desarrollo no está realizando ningún despliegue. Un despliegue es el proceso por el que se llevan las nuevas lógicas a la Web, se corrigen errores o se mejoran las funcionalidades. En el momento en el que el equipo de desarrollo Web está desplegando NO ES POSIBLE NI SE DEBE INTENTAR ejecutar ninguna de las acciones de WebContentsTools. Hacerlo podría implicar un despliegue incorrecto y ello podría hacer que la Web dejase de funcionar.
Por todo ello, antes de ejecutar cualquiera de las acciones, revisaremos si el equipo de desarrollo está desplegando. Para ello:
- Accederemos a la siguiente URL: despliegues.grupojuinsa.es
- Y nos validaremos con el siguiente usuario y contraseña:
- usuario: despliegues
- contraseña: fd13f7cfc6?
- El panel posee el siguiente aspecto:
- Sus contenidos son sencillos (de izquierda a derecha):
- El ID del despliegue.
- El entorno (DEV - STG - PRO y la web en la que se produce).
- El estado del despliegue:
- EN PROGRESO: se está ejecutando. Es el momento en el que los diseñadores y otros usuarios que pretendan realizar acciones con WebContentTools no deben hacerlo.
- COMPLETADO: despliegue terminado correctamente. Se pueden realizar acciones con WebContentTools.
- ERROR: despliegue terminado incorrectamente. Es méramente informativo. Se pueden realizar acciones con WebContentTools.
- Timestamp del inicio.
- Timestamp del fin.
- Duración del proceso.
- Usuario que ha desplegado.
Funcionamiento de la herramienta
- Una vez hemos accedido a la sección PIPELINES de la herramienta: Acceso a la herramienta WebContentTools - Soporte - Confluence (atlassian.net), podemos realizar la selección de valores:
Ejecutar una tarea
- Es la opción directa y la que buscaremos en la mayoría de las ocasiones. Con ellas realizaremos una acción sobre los entornos de las Webs. Dicha acción se ejecuta a través del botón RUN PIPELINE.
- Desde la ventana que aparece realizaremos las siguientes selecciones:
- BRANCH: siempre la misma MASTER.
- PIPELINE es la acción que deseamos ejecutar. En la siguiente sección describiremos cada una de ellas, sin embargo, como podrá imaginar a través de esta selección podremos indicar si deseamos mover los CMS de STG a PRO, si queremos mover los ficheros de la carpeta MEDIA, etc... es el verbo de lo que deseamos hacer.
- En función de la selección anterior, tendremos que determinar los siguientes parámetros. Existen dos tipos de acciones, y en función de la elegida, las variables a determinar:
- Tareas que realizan acciones sobre un entorno (DEV, STG O PRO) para una Web (JUINSA, BEST, LDKGARDEN...). En este primer caso, tendremos que indicar el entorno y la Web, dado que, por ejemplo, si queremos vaciar la caché es impensable que indiquemos el entorno DEV, STG o PRO y de qué Web, dado que no es lo mismo borrar la caché de UNIMASA PRO, que de UNIMASA STG al igual que no lo es de JUINSA DEV... Con estas acciones tendremos que elegir estos dos valores:
- Tareas que mueven contenidos entre el entorno de STG y PRO para una Web. Estas tareas no necesitan conocer el entorno, dado que son movimientos de información entre STG y PRO, por tanto, sólo tendremos que indicar la Web sobre la que procesar el movimiento.
- Tareas que realizan acciones sobre un entorno (DEV, STG O PRO) para una Web (JUINSA, BEST, LDKGARDEN...). En este primer caso, tendremos que indicar el entorno y la Web, dado que, por ejemplo, si queremos vaciar la caché es impensable que indiquemos el entorno DEV, STG o PRO y de qué Web, dado que no es lo mismo borrar la caché de UNIMASA PRO, que de UNIMASA STG al igual que no lo es de JUINSA DEV... Con estas acciones tendremos que elegir estos dos valores:
- BRANCH: siempre la misma MASTER.
- Tras la selección de la acción RUN será el botón que nos permitirá ejecutarla igual que CANCEL, finalizar el proceso sin hacer nada.
Al ejecutar cualquiera de las acciones, recibiremos información sobre la ejecución y avance de la misma en sus distintas fases. Para ver la información que el entorno nos ofrece, puede acceder al siguiente documento: Información de ejecución de WebContentTools - Soporte - Confluence (atlassian.net)
Acciones sobre el PIPELINE
- Clean Caché: borrado de cachés del entorno elegido.
- Clean Caché and Purge CDN: borrado de cachés y CDN del entorno elegido.
- Disabling maintenance: desactiva el modo de mantenimiento en la Web elegida.
- Enabling maintenance: activa el mode de mantenimiento en la Web elegida.
- Move All: movimiento completo de la base de datos de STG a PRO: catálogo, CMS, media y fotos.
- Move Attached Files: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Carga de ficheros adjuntos en la ficha de producto - Soporte - Confluence (atlassian.net).
- Move CMS: esta tarea copia al completo la base de datos páginas CMS, bloques CMS y carpeta WYSWYG de Staging a Pro ((Carga de contenidos sobre /wysiwyg en cada tienda B2B - Soporte - Confluence (atlassian.net))
- Move Email Template: esta tarea copia al completo las plantillas de email de Staging a Pro.
- Move Energy Efficiency: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Eficiencia energética en las Webs B2B - Soporte - Confluence (atlassian.net).
- Move Exclude TPV: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Exclusión de países y/o regiones para el pago con TPV - Soporte - Confluence (atlassian.net).
- Move Flickr Gallery: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Crear una galeria tipo Flicker - Soporte - Confluence (atlassian.net).
- Move Footer Content: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Footer en las Webs B2B - Soporte - Confluence (atlassian.net).
- Move Menu Category Images: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aqui: Imágenes de categorías en el menú
- Move Products: esta tarea se usa para la carga del catálogo.
- Move Products Details: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Información en la Ficha de Producto - Soporte - Confluence (atlassian.net).
- Move Rates: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Configuración del importe de portes fijo, porcentual, pedido mínimo, portes gratuitos por catálogo, tarifa, país y región - Información de portes en el carrito, minicarrito y checkout - Soporte - Confluence (atlassian.net).
- Move Store Locator: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Store Locator - Soporte - Confluence (atlassian.net).
- Move Trade Locator: esta tarea mueve los contenidos de Staging a Pro para el desarrollo descrito aquí: Buscador de comerciales (Trade Locator) - listado y localizador de comerciales por regiones y países - Soporte - Confluence (atlassian.net).
- Purge CDN: vacía el caché de Fastly.
- Reindex All: reindexa la la base de datos. Se usa, sobre todo, cuando hay cambios en producto o categorías que no se están viendo en el frontal.