Documentación de Oracle Cloud Infrastructure

Reglas de caché

Las reglas de caché permiten almacenar de forma selectiva el contenido solicitado en los servidores de borde de Oracle Cloud Infrastructure, como páginas web o determinados tipos de archivo.

Uso de la consola

Para crear una regla de chaché
  1. Abra el menú de navegación y seleccione Identidad y seguridad. En Firewall de aplicación web, seleccione Políticas.

  2. Haga clic en el nombre de la política de WAF a la que desea agregar una regla de caché. Aparece la visión general de política de WAF.

  3. Haga clic en Reglas de caché.
  4. Haga clic en Crear regla de caché.
  5. En el cuadro de diálogo Crear regla de caché, introduzca lo siguiente:
    • Nombre: nombre único para la regla de acceso.
    • Acción de regla de caché: seleccione una de las siguientes opciones:
      • Caché: almacena en caché el contenido solicitado cuando se cumplen los criterios de la regla
        • Duración en caché.:duración del contenido en caché para la regla de caché.
        • Unidad de tiempo: unidad de tiempo para la duración en caché.
        • Activar caché de cliente: active esta casilla de control para especificar la duración del contenido de caché en el explorador del usuario.
      • Omitir caché: permite a las solicitudes no usar la caché y dirigirse al origen cuando se cumplen los criterios de la regla.
    • Condiciones: seleccione la condición y la dirección URL que deben coincidir para que se realice la acción. Debe coincidir al menos una condición para que se lleve a cabo la acción definida.
  6. Haga clic en Crear. La regla de caché se agrega a la lista de reglas de caché.
Para editar una regla de caché
  1. Abra el menú de navegación y seleccione Identidad y seguridad. En Firewall de aplicación web, seleccione Políticas.

  2. Haga clic en el nombre de la política de WAF para la que desea editar las reglas de caché. Aparece la visión general de política de WAF.

  3. Haga clic en Reglas de caché.
  4. Seleccione la casilla de control de la regla de caché que desea actualizar.
  5. Seleccione Editar en el menú desplegable Acciones.
  6. En el cuadro de diálogo Editar regla de caché, realice las actualizaciones necesarias.
  7. Haga clic en Guardar Cambios.
Para suprimir una regla de caché
  1. Abra el menú de navegación y seleccione Identidad y seguridad. En Firewall de aplicación web, seleccione Políticas.
  2. Haga clic en el nombre de la política de WAF en la que desea suprimir una regla de caché. Aparece la visión general de política de WAF.
  3. Haga clic en Reglas de caché.
  4. Seleccione la casilla de control de la regla de caché que desea suprimir.
  5. Seleccione Suprimir en el menú desplegable Acciones.
  6. En el cuadro de diálogo de confirmación, haga clic en Suprimir.
Para depurar la caché
  1. Abra el menú de navegación y seleccione Identidad y seguridad. En Firewall de aplicación web, seleccione Políticas.

  2. Haga clic en el nombre de la política de WAF en la que desea depurar la caché. Aparece la visión general de política de WAF.

  3. Haga clic en Reglas de caché.
  4. Seleccione Depurar caché en el menú desplegable Acciones.
  5. En el cuadro de diálogo Depurar caché, seleccione la condición y la dirección URL que desea depurar y haga clic en Depurar.

Criterios de reglas de caché disponibles

Los criterios de la regla de caché determinan si el contenido solicitado se debe almacenar en caché.

  • URL_IS: coincide si la concatenación de la consulta y la ruta de la URL solicitada es idéntica al contenido del campo value. Por ejemplo, si se define una regla para almacenar en caché el contenido de www.example.com/products, solo se almacenarán las solicitudes HTTP de www.example.com/products.
  • URL_STARTS_WITH: coincide si la concatenación de la ruta de la URL solicitada y la consulta comienza con el contenido del campo value. Por ejemplo, si esta regla se define para almacenar en caché contenido de www.example.com/products, todas las solicitudes HTTP que soliciten direcciones URL que empiecen por www.example.com/products se almacenarán en caché y las solicitudes posteriores recibirán contenido de la caché, incluidas las solicitudes de www.example.com/products/new-product y www.example.com/products/old-product.
  • URL_PART_ENDS_WITH: coincide si la concatenación de la ruta de la URL solicitada y la consulta termina con el contenido del campo value. Por ejemplo, si la regla se define para almacenar en caché el contenido de las direcciones URL que terminan por /product.jpg, las solicitudes HTTP de las direcciones URL www.example.com/products/new-product/product-banner.jpg y www.example.com/products/old-product/product-banner.jpg se almacenarán en caché y las solicitudes posteriores recibirán contenido de la caché.
  • URL_PART_CONTAINS: coincide si la concatenación de la ruta de la URL solicitada y la consulta contiene el contenido del campo value. Si la regla se define para almacenar en caché el contenido de las URL que contienen /product-banner, las solicitudes HTTP de las URL www.example.com/products/new-product/product-banner/blue.jpg y www.example.com/products/new-product/product-banner/red.jpg se almacenarán en caché y las solicitudes posteriores recibirán contenido de la caché.

Acciones de regla de caché disponibles

Se puede definir una regla de caché para realizar una de las dos acciones disponibles al recibir una solicitud:

  • CACHE: las solicitudes que coincidan con los criterios de la regla se almacenarán en caché y las solicitudes posteriores recibirán contenido de la caché.
  • BYPASS_CACHE: las solicitudes que coincidan con los criterios de la regla omitirán la caché y se dirigirán al origen.

Duración de caché

El contenido se puede almacenar en caché durante un periodo de tiempo especificado en los servidores de borde de Oracle Cloud Infrastructure o en caché localmente por el cliente. La duración se define en los campos cachingDuration y clientCachingDuration, en formato ISO 8601 ampliado.

Ejemplo de regla de caché

[
  {
    "action": "CACHE",
    "cachingDuration": "PT20M",
    "clientCachingDuration": "PT20M",
    "criteria": [
      {
        "condition": "URL_IS",
        "value": "/path/to-cache"
      }
    ],
    "isClientCachingEnabled": true,
    "name": "Caching Rule 1"
  },
  {
    "action": "BYPASS_CACHE",
    "criteria": [
      {
        "condition": "URL_PART_ENDS_WITH",
        "value": "urp-part-not-to-cache"
      }
    ],
    "isClientCachingEnabled": false,
    "name": "Do not cache"
  }
]

Mejores prácticas

El orden en el que se especifican las reglas de caché es importante. Las reglas se procesan en el orden en que se especifican y la primera regla de coincidencia se utiliza al procesar una solicitud. Es mejor agregar las reglas que omiten la caché al principio y las reglas de caché por debajo de las reglas de omisión.

Depurar cachés

Las cachés se pueden depurar con la operación PurgeCache. Las cachés se pueden depurar de forma selectiva especificando la ruta de la URL de un recurso, aunque también se pueden depurar todas las cachés para WAF si no se especifica ningún recurso para la API.

Ejemplos

Depurar la caché para recursos especificados:

{
  "resources": [
    "/path/to-purge",
    "/multiple-paths"
  ]
}