Tutorial: creación de una función de CloudFront que incluya pares clave-valor - Amazon CloudFront
Requisitos previosCreación del almacén de clave-valorAñadido de pares clave-valor al almacénAsociación del almacén de clave-valor a la funciónPrueba y publicación del código de la función

Tutorial: creación de una función de CloudFront que incluya pares clave-valor

En este tutorial, se muestra cómo incluir pares clave-valor con una función de CloudFront. Los valores y las claves forman parte de un par clave-valor. Debe incluir el nombre (del par clave-valor) en el código de la función. Cuando se ejecute la función, CloudFront reemplaza el nombre por el valor.

Los pares clave-valor son variables que se almacenan en un almacén de clave-valor. Cuando se utiliza una clave en la función (en lugar de valores con codificación rígida), la función es más flexible. Puede cambiar el valor de la clave sin tener que implementar cambios en el código. Los pares clave-valor también pueden reducir el tamaño de la función. Para obtener más información, consulte Amazon CloudFront KeyValueStore.

Requisitos previos

Si no conoce las funciones de CloudFront Functions ni el almacén de clave-valor, le recomendamos que siga el tutorial que aparece en Tutorial: creación de una función simple con CloudFront Functions.

Después de completar ese tutorial, puede seguir este tutorial para ampliar la función que ha creado. En este tutorial, le recomendamos que primero cree el almacén de clave-valor.

Creación del almacén de clave-valor

En primer lugar, cree el almacén de clave-valor para usarlo en su función.

Creación del almacén clave-valor

  1. Planifique los pares clave-valor que desee incluir en la función. Anote los nombres de las claves. Los pares clave-valor que desee utilizar en una función deben estar en un único almacén de clave-valor.

  2. Decida el orden de trabajo. Hay dos formas de proceder:

    • Cree un almacén de clave-valor y añada pares clave-valor al almacén. A continuación, cree (o modifique) la función e incorpore los nombres de las claves.

    • O bien, puede crear (o modificar) la función e incorporar los nombres de las claves que quiera usar. A continuación, cree un almacén de clave-valor y añada los pares clave-valor.

  3. Inicie sesión en la AWS Management Console y abra la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home.

  4. En el panel de navegación, elija Funciones y, a continuación, elija la pestaña KeyValueStores.

  5. Elija Crear KeyValueStore e introduzca los siguientes campos:

    • Introduzca un nombre y una descripción (opcional) para el almacén.

    • Deje el URI de S3 en blanco. En este tutorial, introducirá los pares clave-valor de forma manual.

  6. Seleccione Crear. Aparece la página de detalles del nuevo almacén de clave-valor. Esta página incluye una sección de pares clave-valor que actualmente está vacía.

Añadido de pares clave-valor al almacén

A continuación, añada manualmente una lista de pares clave-valor al almacén de clave-valor que creó anteriormente.

Añadido de pares clave-valor al almacén de clave-valor

  1. En la sección de Pares clave-valor, seleccione el botón Agregar pares clave-valor.

  2. Elija Agregar etiqueta y, a continuación, introduzca un par clave-valor. Elija la marca de verificación para confirmar los cambios y repita este paso para añadir más.

  3. Cuando haya terminado, seleccione Guardar cambios para guardar todos los pares del almacén de clave-valor. En el cuadro de diálogo de confirmación, elija Listo.

Ahora tiene un almacén que contiene un grupo de pares clave-valor.

Asociación del almacén de clave-valor a la función

Ahora ha creado el almacén de clave-valor. Y ha creado o modificado una función que incluye los nombres de las claves del almacén de clave-valor. Ahora puede asociar el almacén de clave-valor y la función. La asociación se crea desde dentro de la función.

Asociación del almacén de clave-valor a la función

  1. Seleccione Funciones en el panel de navegación. La pestaña Funciones aparece en la parte superior de forma predeterminada.

  2. Elija el nombre de la función y, en la sección KeyValueStore asociado, elija Asociar KeyValueStore existente.

  3. Seleccione el almacén de clave-valor y elija Asociar KeyValueStore.

nota

Solo puede asociar un almacén de clave-valor a cada función.

Prueba y publicación del código de la función

Tras asociar el almacén de clave-valor a la función, puede probar y publicar el código de la función. Siempre debe probar el código de la función cada vez que lo modifique, incluso cuando haga lo siguiente:

  • Asociar un almacén de clave-valor a la función.

  • Modificar la función y su almacén de clave-valor para incluir un nuevo par de clave-valor.

  • Cambiar el valor de un par clave-valor.

Prueba y publicación del código de la función

  1. Para obtener más información sobre cómo probar una función, consulte Prueba de funciones. Asegúrese de elegir probar la función en la etapa de DEVELOPMENT.

  2. Publique la función cuando esté preparado para utilizarla (con los pares clave-valor nuevos o revisados) en un entorno LIVE.

    Al publicar, CloudFront copia la versión de la función de la etapa de DEVELOPMENT a la etapa de producción en vivo. La función tiene el código nuevo y está asociada al almacén de clave-valor. (No es necesario volver a realizar la asociación en la etapa de producción en vivo).

    Para obtener más información sobre cómo publicar la función, consulte Publicación de funciones.