ACI — Mantenimiento del backend

1.1 Por qué realizar operaciones de mantenimiento

Esta aplicación está diseñada para ser resiliente y no requiere un mantenimiento frecuente. Sin embargo, en algunas situaciones, puede que necesite reiniciar la pila para aplicar una nueva versión o recuperarse de un estado de error.

Por ejemplo, si el procesamiento de datos falla, pueden acumularse archivos temporales en los volúmenes de Redis o RabbitMQ. Reiniciar el Container Group elimina el estado en memoria y restablece la cola.

Nota: esta sección cubre únicamente el mantenimiento a nivel de ACI. La configuración de red o firewall específica de su organización queda fuera del alcance de este documento.

1.2 ¿Cuándo debería realizar el mantenimiento?

1.2.1 Los procesos de datos han fallado

La primera señal de que su aplicación necesita atención es cuando los procesos de datos lanzados desde Dynamics 365 muestran un estado de Failed. Antes de actuar, revise la descripción del error para descartar problemas en sus reglas de deduplicación u otras integraciones.

Si el error apunta al propio servidor, continúe con la sección 1.3, Cómo proceder.

1.2.2 Procesos de datos pendientes

Si la cola de trabajos se queda bloqueada en el mismo mensaje e impide los procesos de datos, borre el volumen de RabbitMQ y reinicie el Container Group.

1. Paso 1 — Elimine el contenido del file share de RabbitMQ:

   az storage file delete-batch \
     --account-name dqeunifystorage \
     --source rabbitvol

2. Paso 2 — Reinicie el Container Group:

   az container restart \
     --resource-group <resource-group> \
     --name dqe-unify

1.3 Cómo proceder

1.3.1 Paso 1 – Obtener los registros

Los registros son gestionados por ACI. Utilice Azure CLI para obtenerlos.

Ver los registros de Unify Server:

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name unify-server

Ver los registros de Queue Worker:

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name queue-worker

Seguir los registros en tiempo real:

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name unify-server \
  --follow

1.3.2 Paso 2 – Reconstruir / Actualizar la aplicación

Para desplegar una versión más reciente de la imagen, elimine el Container Group y vuelva a desplegar a partir del YAML actualizado.

1. Paso 1 — Elimine el Container Group existente:

   az container delete \
     --resource-group <resource-group> \
     --name dqe-unify \
     --yes

2. Paso 2 — Opcional: borre los volúmenes persistentes si es necesario:

   az storage file delete-batch --account-name dqeunifystorage --source redisvol
   az storage file delete-batch --account-name dqeunifystorage --source rabbitvol

3. Paso 3 — Vuelva a desplegar con el YAML actualizado:

   az container create \
     --resource-group <resource-group> \
     --file container-group.yaml

1.3.3 Paso 3 – Reiniciar

Para un reinicio simple sin volver a desplegar:

az container restart \
  --resource-group <resource-group> \
  --name dqe-unify

Supervise el reinicio:

az container show \
  --resource-group <resource-group> \
  --name dqe-unify \
  --query "containers[].{Name:name, State:instanceView.currentState.state}" \
  -o table

Todos los contenedores deben alcanzar el estado Running. Si un contenedor muestra Terminated o permanece bloqueado, revise sus registros y contacte con el soporte de DQE Software si el problema no se puede resolver.