Purga de caché en Azure Front Door con la CLI de Azure

Azure Front Door almacena en caché los recursos hasta que el período de vida de dichos recursos (TTL) expira. Siempre que un cliente solicita un recurso con un período de vida expirado, el entorno de Azure Front Door recupera una nueva copia actualizada de este para atender la solicitud y almacena en caché la versión actualizada.

El procedimiento recomendado consiste en asegurarse de que los usuarios obtengan siempre la copia más reciente de los recursos. La manera de lograrlo es hacer una versión de los recursos para cada actualización y publicarlos como nuevas direcciones URL. Azure Front Door Estándar/Premium recuperará inmediatamente los nuevos recursos en las siguientes solicitudes de los clientes. A veces puede que quiera purgar contenido almacenado en caché de todos los nodos perimetrales y forzarlos todos para recuperar nuevos recursos actualizados. La razón por la que desea purgar el contenido almacenado en caché es porque ha hecho nuevas actualizaciones en la aplicación o desea actualizar los recursos que contienen información incorrecta.

Requisitos previos

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

• Repase Almacenamiento en caché de Azure Front Door para comprender cómo funciona el almacenamiento en caché.
• Tenga un perfil de Azure Front Door en funcionamiento. Consulte Creación de una instancia de Front Door: CLI para obtener información sobre cómo crear una.

Configuración de la purga de la memoria caché

Ejecute az afd endpoint purge para purgar la caché después de introducir los parámetros necesarios, como:

• nombre del grupo de recursos.

• Nombre del perfil de Azure Front Door dentro del grupo de recursos con los recursos que desea purgar

• Puntos de conexión con recursos que desea purgar

• Dominios o subdominios con recursos que desea purgar

  Importante

  No se admite la purga de caché para el dominio con caracteres comodín, tiene que especificar un subdominio para la purga de caché del dominio con caracteres comodín. Puede agregar tantos subdominios de un solo nivel del dominio del carácter comodín. Por ejemplo, para el dominio comodín *.afdxgatest.azfdtest.xyz, puede agregar subdominios en forma de contoso.afdxgatest.azfdtest.xyz o cart.afdxgatest.azfdtest.xyz sucesivamente. Para obtener más información, vea Dominios con caracteres comodín en Azure Front Door.

• Ruta de acceso al contenido que se va a purgar.

  • Estos formatos se admiten en las listas de rutas de acceso que se van a purgar:
    • Purga de ruta de acceso única: purgue recursos concretos mediante la especificación de la ruta de acceso completa del recurso (sin el protocolo y el dominio) con la extensión de archivo, por ejemplo, /pictures/strasbourg.png.
    • Purga de dominio raíz: purgue la raíz del punto de conexión con "/*" en la ruta de acceso.

az afd endpoint purge \
   --resource-group myRGFD \
   --profile-name contosoafd \
   --endpoint-name myendpoint \
   --domains www.contoso.com \
   --content-paths '/scripts/*'

Las purgas de la memoria caché en el perfil de Azure Front Door no distinguen mayúsculas y minúsculas. Además, es independiente de la cadena de consulta, lo que significa que purgar una dirección URL purgará todas sus variaciones de la cadena de consulta.

Nota

La purga de caché puede tardar hasta 10 minutos en propagarse por toda la red y por todas las ubicaciones de borde.

Pasos siguientes

Aprenda a crear un perfil de Azure Front Door.