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

Azure Front Door almacena en caché los recursos hasta que expira su período de vida (TTL). Cuando un cliente solicita un recurso con un TTL expirado, Azure Front Door recupera una nueva copia del recurso, atiende la solicitud y actualiza la memoria caché.

Para asegurarse de que los usuarios siempre obtienen los recursos más recientes, versione los recursos de cada actualización y publíquelos con nuevas direcciones URL. Azure Front Door captura los nuevos recursos para las solicitudes de cliente posteriores. A veces, es posible que tenga que purgar el contenido almacenado en caché de todos los nodos perimetrales para obligarlos a recuperar los recursos actualizados. Esta acción es útil cuando se realizan actualizaciones en la aplicación o necesitan corregir 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é.
• Asegúrese de que tiene un perfil de Azure Front Door en funcionamiento. Consulte Creación de una de la CLI de Azure Front Door para obtener información sobre cómo crear una.

Configuración de la purga de la memoria caché

Ejecute az afd endpoint purge con los parámetros necesarios:

• Definición de un nombre de grupo de recursos
• Nombre del perfil de Azure Front Door dentro del grupo de recursos.
• Puntos de conexión con recursos que se van a purgar.
• Dominios o subdominios con recursos que se van a purgar.

Importante

No se admite la purga de caché para dominios comodín. Especifique un subdominio para la purga de caché para un dominio comodín. Puede agregar varios 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 como contoso.afdxgatest.azfdtest.xyz o cart.afdxgatest.azfdtest.xyz. 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:
  • Formatos compatibles:
    • Purga de ruta de acceso única: especifique la ruta de acceso completa del recurso (sin el protocolo y el dominio), incluida 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 caché en el perfil de Azure Front Door no distinguen mayúsculas de minúsculas y son independientes de la cadena de consulta, lo que significa purgar una dirección URL purga todas sus variaciones de 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

Para continuar, aprenda a crear un perfil de Azure Front Door.