Introducción a VCL personalizado

Fastly admite una versión personalizada del lenguaje de configuración de barniz (VCL) para adaptar la configuración del servicio Fastly a sus necesidades.

Los fragmentos personalizados de VCL son bloques de lógica VCL que se añaden a la versión activa de VCL cargada en el sitio de Adobe Commerce. Un fragmento de VCL personalizado modifica la velocidad con la que los servicios de almacenamiento en caché responden al tráfico de solicitud. Por ejemplo, puede agregar un fragmento de VCL personalizado para permitir el tráfico de solicitudes solo desde direcciones IP de cliente especificadas. O bien, cree un fragmento para bloquear el tráfico de sitios web conocidos por enviar spam de referencia a sus sitios de Adobe Commerce.

Los fragmentos de VCL personalizados (generados, compilados y transmitidos a todas las cachés de Fastly) se cargan y activan sin tiempo de inactividad del servidor.

Rápidamente admite dos tipos de fragmentos de VCL personalizados:

Se recomienda utilizar fragmentos de VCL personalizados con diccionarios de Edge y listas de control de acceso (ACL) para almacenar los datos utilizados en el código personalizado.

Los datos de diccionario y ACL se implementan en los nodos de Fastly Edge accesibles en las regiones de red. Además, los datos se pueden actualizar dinámicamente en toda la red sin que sea necesario volver a implementar el código VCL para el entorno de ensayo o producción.

Tutorial

Este tutorial y ejemplos muestran el uso de fragmentos de VCL personalizados normales con diccionarios de Edge y ACL de Edge para personalizar la configuración del servicio de Fastly para Adobe Commerce. Para obtener información más detallada, consulte la documentación de Fastly:

Puede crear y administrar fragmentos de VCL personalizados desde el administrador de Adobe Commerce o mediante la API de Fastly:

Ejemplo de código de fragmento VCL

El siguiente ejemplo muestra el fragmento de VCL personalizado (formato JSON) que filtra el tráfico por dirección IP del cliente:

{
  "service_id": "FASTLY_SERVICE_ID",
  "version": "{Editable Version #}",
  "name": "apply_acl",
  "priority": "100",
  "dynamic": "1",
  "type": "hit",
  "content": "if ((client.ip ~ {ACLNAME}) && !req.http.Fastly-FF){ error 403; }"
}

La lógica VCL del campo content realiza las siguientes acciones:

La siguiente tabla proporciona detalles sobre los datos clave para los fragmentos de VCL personalizados. Para obtener una referencia más detallada, consulte la referencia de fragmentos de VCL en la documentación de Fastly.

Administrar VCL personalizada desde el administrador

Puede agregar fragmentos de VCL personalizados desde la sección Configuración rápida > Fragmentos de VCL personalizados en el administrador.

La vista Fragmentos de VCL personalizados solo muestra los fragmentos que se han agregado a través del administrador. Si se agregan fragmentos de código mediante la API de Fastly, use la API para administrarlos.

Los siguientes ejemplos muestran cómo crear y administrar fragmentos de VCL personalizados desde Admin y cómo utilizar los módulos de Fastly Edge y los diccionarios de Edge:

Administración de VCL mediante la API

El siguiente tutorial muestra cómo crear archivos de fragmento de VCL normales y añadirlos a la configuración del servicio de Fastly mediante la API de Fastly. Puede crear y administrar los fragmentos de código desde la aplicación terminal. No necesita una conexión SSH a un entorno específico.

Requisitos previos:

Añadir fragmentos de VCL

Este tutorial proporciona los pasos básicos para agregar fragmentos personalizados mediante la API de Fastly.

Requisitos previos

Paso 1: Localizar la versión activa de VCL

Utilice la operación obtener versión de la API de Fastly para obtener el número de versión de VCL activo:

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/active

En la respuesta JSON, anote el número de versión de VCL activo devuelto en la clave number, por ejemplo "number": 99. Necesita el número de versión al clonar el VCL para editarlo.

{
  "testing": false,
  "locked": true,
  "number": 99,
  "active": true,
  "service_id": "872zhjyxhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

Guarde el número de versión activo en una variable de entorno bash para utilizarlo en solicitudes de API posteriores:

export FASTLY_VERSION_ACTIVE=<Version>

Paso 2: clonar la versión activa de VCL y todos los fragmentos

Para poder añadir o modificar fragmentos de VCL personalizados, debe crear una copia de la versión de VCL activa para editarla. Use la operación clone de la API de Fastly:

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_VERSION_ACTIVE/clone -X PUT

En la respuesta JSON, el número de versión se incrementa y el valor de la clave active es false. Puede modificar la nueva versión de VCL inactiva localmente.

{
  "testing": false,
  "locked": false,
  "number": 100,
  "active": false,
  "service_id": "vW2bLFWhhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

Guarde el nuevo número de versión en una variable de entorno bash para utilizarlo en comandos posteriores:

export FASTLY_EDIT_VERSION=<Version>

Paso 3: Crear un fragmento de VCL personalizado

Cree y guarde su código VCL personalizado en un archivo JSON con el siguiente contenido y formato:

{
  "name": "<name>",
  "dynamic": "0",
  "type": "<type>",
  "priority": "100",
  "content": "<code all in one line>"
}

Los valores incluyen:

Paso 4: Añadir un fragmento de VCL a la configuración de Fastly

Utilice la operación de API de Fastly create snippet para agregar el fragmento de VCL personalizado a la versión de VCL.

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_EDIT_VERSION/snippet -H 'Content-Type: application/json' -X POST --data @<filename.json>

<filename.json> es el nombre del archivo que preparó en el paso anterior. Repita este comando para cada fragmento de VCL.

Si recibe una respuesta de 500 Internal Server Error del servicio Fastly, compruebe la sintaxis del archivo JSON para asegurarse de que está cargando un archivo válido.

Paso 5: Validar y activar fragmentos de VCL personalizados

Después de agregar un fragmento de VCL personalizado, inserta rápidamente el fragmento en la versión de VCL que está editando. Para aplicar cambios, complete los siguientes pasos para validar el código del fragmento de VCL y activar la versión de VCL.

Referencia rápida de API para fragmentos de VCL

Estos ejemplos de solicitud de API utilizan variables de entorno exportadas para proporcionar las credenciales y autenticarse con Fastly. Para obtener más información sobre estos comandos, consulte Referencia de la API de Fastly.