Uso de acciones y activadores de la función Edge

Las funciones de borde constan de dos componentes principales: acciones y activadores. Las acciones son archivos JavaScript que definen la lógica que debe ejecutarse en el borde. Los desencadenantes son reglas de enrutamiento basadas en URL que definen cuándo y en qué circunstancias deben ejecutarse esas acciones. Los desencadenantes conectan patrones de solicitud específicos (como dominios y rutas) con las acciones apropiadas. Sin un desencadenante asociado, una acción no tendrá impacto en el tráfico.

Acciones de la función de borde

Las acciones se escriben en JavaScript y requieren que un escucha de sucesos responda a un suceso desencadenante. Las acciones no afectan a su tráfico a menos que sean utilizadas por un activador.

Diferencias de planes

Las diferencias al trabajar con acciones dependen de su plan:

Planes estándar

  • Permitir sólo una acción por cuenta, denominada automáticamente con el nombre de su dominio (el nombre no se puede cambiar).
  • Para actualizar una acción, cargue un nuevo archivo JavaScript o edite el código directamente en el editor. La carga de un nuevo archivo sustituye a la acción existente.
  • Cuando subes un archivo JavaScript, su nombre siempre se establece con tu nombre de dominio.

Planes para empresas

  • Puede cargar un número ilimitado de scripts, cada uno con un nombre único si lo desea.
  • Al crear una acción, puede especificar un nombre personalizado.
  • Al cargar un archivo JavaScript, el nombre de la acción se toma del nombre del archivo.

Cómo trabajar con acciones

Puede crear, cargar, editar y gestionar acciones para definir la lógica que su función Edge ejecuta en respuesta a eventos desencadenantes. La consola proporciona herramientas para cada una de las operaciones básicas:

  • Crear una acción- Haga clic en Crear para añadir una acción utilizando el editor de código integrado. Después de añadir su código JavaScript, haga clic en Guardar para crear su acción.

  • Leer una acción- Haga clic en una acción existente de la tabla de acciones para abrirla en el editor. Esto le permite ver su código sin realizar cambios.

  • Actualizar una acción- Para modificar una acción, ábrala en el editor haciendo clic sobre ella en la lista. Realice los cambios y haga clic en Guardar. Cuando guarde los cambios, se cargará la acción actualizada. Si la acción está en uso, las actualizaciones surten efecto inmediatamente.

  • Cargar una acción- Haga clic en Cargar para cargar un archivo JavaScript. Si se carga o se crea una acción con el mismo nombre que una acción que ya existe se sobrescribe la acción existente. Cambie el nombre del archivo de acción antes de cargarlo o introduzca un nombre único durante la creación para evitar este comportamiento.

    La carga también puede utilizarse como parte de la creación o actualización de una acción, dependiendo de si el nombre ya existe.

  • Eliminar una acción: para eliminar una acción, haga clic en el ícono Eliminar Ícono Eliminar en la fila de la tabla para la acción seleccionada. No se puede eliminar una acción mientras esté asociada a un disparador. Para eliminar la acción, primero debe eliminar todos los activadores que la utilizan. La columna Usos muestra cuántos desencadenantes están vinculados a cada acción.

  • Asociar un desencadenante- Los desencadenantes son necesarios para que una acción se ejecute. Añada un activador desde la pestaña Activadores y seleccione la acción de la lista de acciones existentes. La columna Usos de la tabla de acciones muestra el número de activadores vinculados actualmente a cada acción.

Activadores de funciones de borde

Los desencadenantes (rutas) determinan cómo se enruta el tráfico del dominio a las acciones. Asocian patrones URL, basados en un dominio de la cuenta, con una acción predefinida. El patrón URL debe incluir el dominio y puede contener comodines como prefijo del dominio o al final de la ruta. Si no se especifica ninguna ruta, se añade implícitamente una /. URL no pueden contener comodines infijos ni parámetros de consulta.

Diferencias de planes

No hay diferencias entre los planes en cuanto al funcionamiento de los activadores. Todos los planes permiten añadir, editar y eliminar activadores.

Cómo trabajar con desencadenantes

Debe añadir un dominio antes de añadir activadores. Los desencadenantes definen cómo se dirige el tráfico a las acciones de su función Edge. Un activador conecta un patrón URL con una acción existente.

Los desencadenantes pueden crearse aunque todavía no existan acciones, pero no invocarán ninguna lógica hasta que se seleccione una acción.

  • Agregar un disparador: vaya a la pestaña Desencadenadores y haga clic en Agregar disparador. Introduzca un patrón URL y, a continuación, seleccione una acción de la lista de acciones existentes para asociarla a este patrón. Establece el vínculo entre una ruta y una acción.

    Para mantener activa una ruta de disparo sin ejecutar una función de borde, active Evitar funciones de borde. Por ejemplo, si my-function está asignado a gamma.cistest-load.com/*, pero desea que gamma.cistest-load.com/data lo anule, cree un disparador independiente para /data y active las funciones Evitar flanco. Esto garantiza que la ruta /data permanezca activa sin invocar my-function.

  • Editar un desen cadenador - Haga clic en el icono Editar en la fila de la tabla del desencadenador que desea modificar, realice los cambios y haga clic en Guardar.

  • Eliminar un disparador: haga clic en el ícono Eliminar Ícono Eliminar en la tabla la fila del disparador que desea modificar. Esta acción no se puede deshacer. Al borrar un desencadenante se elimina la asociación entre la ruta y la acción.