View a markdown version of this page

Tutorial: Configurar Lambda para acceder ElastiCache en una VPC - Amazon ElastiCache

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Tutorial: Configurar Lambda para acceder ElastiCache en una VPC

En este tutorial puede aprender a crear una ElastiCache almacene en caché sin servidor, cree una función de Lambda y, a continuación, pruebe la función de Lambda y, si lo desea, límpiela después.

Paso 1: Crear un ElastiCache caché sin servidor.

Siga estos pasos para crear una caché sin servidor.

Paso 1.1: creación de una caché sin servidor

En este paso, creará una caché sin servidor en la Amazon VPC predeterminada de la región us-east-1 de su cuenta mediante el AWS Command Line Interface (CLI). Para obtener información sobre la creación de una caché sin servidor mediante el ElastiCache consola o API, consulte Creación de una caché sin servidor de Valkey.

aws elasticache create-serverless-cache \ --serverless-cache-name cache-01 \ --description "ElastiCache IAM auth application" \ --engine valkey

Tenga en cuenta que el valor del campo Estado está establecido en CREATING. ElastiCache crea su caché en aproximadamente un minuto.

Paso 1.2: copia del punto de conexión de caché sin servidor

Verifique que ElastiCache ha terminado de crear la caché con describe-serverless-caches comando.

aws elasticache describe-serverless-caches \ --serverless-cache-name cache-01

Copie la dirección del punto de conexión que aparece en el resultado. Necesitará esta dirección cuando cree el paquete de implementación para la función de Lambda.

Paso 1.3: creación de un rol de IAM

  1. Cree un documento de política de confianza de IAM, como se muestra a continuación, para su función que permita al servicio Lambda asumir la nueva función. Guarde la política en un archivo denominado trust-policy.json.

    { "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole" }] }
  2. Cree un documento de política de IAM, como se muestra a continuación. Guarde la política en un archivo denominado policy.json.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:Connect" ], "Resource": [ "arn:aws:elasticache:us-east-1:123456789012:serverlesscache:cache-01", "arn:aws:elasticache:us-east-1:123456789012:user:iam-user-01" ] } ] }
  3. Crear un rol de IAM.

    aws iam create-role \ --role-name "elasticache-iam-auth-app" \ --assume-role-policy-document file://trust-policy.json
  4. Creación de la política de IAM.

    aws iam create-policy \ --policy-name "elasticache-allow-all" \ --policy-document file://policy.json
  5. Adjunte la política de IAM al rol.

    aws iam attach-role-policy \ --role-name "elasticache-iam-auth-app" \ --policy-arn "arn:aws:iam::123456789012:policy/elasticache-allow-all"

Paso 1.4: Configurar la autenticación de IAM

importante

Este paso es necesario. Su función de Lambda se autentica en ElastiCache mediante IAM. Para que esto funcione, debe crear un IAM-enabled ElastiCache usuario, agréguelo a un grupo de usuarios y asocie ese grupo de usuarios a su caché. Sin esta configuración, los intentos de conexión de Lambda fallarán.

  1. Cree un IAM-enabled usuario. Es la identidad de usuario con la que se autenticará su función de Lambda.

    aws elasticache create-user \ --user-name iam-user-01 \ --user-id iam-user-01 \ --authentication-mode Type=iam \ --engine valkey \ --access-string "on ~* +@all"
  2. Cree un grupo de usuarios, añada el usuario a él y asocie el grupo a su caché.

    aws elasticache create-user-group \ --user-group-id iam-user-group-01 \ --engine valkey \ --user-ids iam-user-01 aws elasticache modify-serverless-cache \ --serverless-cache-name cache-01 \ --user-group-id iam-user-group-01

Paso 2: Cree una función Lambda para ElastiCache

Para crear una función Lambda para acceder a ElastiCache caché, siga estos pasos.

Paso 2.1: creación de una función de Lambda

En este tutorial, proporcionamos código de ejemplo en Python para su función de Lambda.

Python

El siguiente ejemplo de código Python lee y escribe un elemento en su ElastiCache caché. Copie el código y guárdelo en un archivo con el nombre app.py. Asegúrese de reemplazar el valor elasticache_endpoint del código por la dirección del punto de conexión que copió en el paso anterior.

from typing import Tuple, Union from urllib.parse import ParseResult, urlencode, urlunparse import botocore.session import valkey from botocore.model import ServiceId from botocore.signers import RequestSigner from cachetools import TTLCache, cached import uuid class ElastiCacheIAMProvider(valkey.CredentialProvider): def __init__(self, user, cache_name, is_serverless=False, region="us-east-1"): self.user = user self.cache_name = cache_name self.is_serverless = is_serverless self.region = region session = botocore.session.get_session() self.request_signer = RequestSigner( ServiceId("elasticache"), self.region, "elasticache", "v4", session.get_credentials(), session.get_component("event_emitter"), ) # Generated IAM tokens are valid for 15 minutes @cached(cache=TTLCache(maxsize=128, ttl=900)) def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]: query_params = {"Action": "connect", "User": self.user} if self.is_serverless: query_params["ResourceType"] = "ServerlessCache" url = urlunparse( ParseResult( scheme="https", netloc=self.cache_name, path="/", query=urlencode(query_params), params="", fragment="", ) ) signed_url = self.request_signer.generate_presigned_url( {"method": "GET", "url": url, "body": {}, "headers": {}, "context": {}}, operation_name="connect", expires_in=900, region_name=self.region, ) # RequestSigner only seems to work if the URL has a protocol, but # Elasticache only accepts the URL without a protocol # So strip it off the signed URL before returning return (self.user, signed_url.removeprefix("https://")) def lambda_handler(event, context): username = "iam-user-01" # replace with your user id cache_name = "cache-01" # replace with your cache name elasticache_endpoint = "cache-01-xxxxx.serverless.use1.cache.amazonaws.com" # replace with your cache endpoint creds_provider = ElastiCacheIAMProvider(user=username, cache_name=cache_name, is_serverless=True) valkey_client = valkey.Valkey(host=elasticache_endpoint, port=6379, credential_provider=creds_provider, ssl=True, ssl_cert_reqs="none") key='uuid' # create a random UUID - this will be the sample element we add to the cache uuid_in = uuid.uuid4().hex valkey_client.set(key, uuid_in) result = valkey_client.get(key) decoded_result = result.decode("utf-8") # check the retrieved item matches the item added to the cache and print # the results if decoded_result == uuid_in: print(f"Success: Inserted {uuid_in}. Fetched {decoded_result} from Valkey.") else: raise Exception(f"Bad value retrieved. Expected {uuid_in}, got {decoded_result}") return "Fetched value from Valkey"

Este código usa la biblioteca valkey-py de Python para colocar elementos en tu caché y recuperarlos. Este código usa cachetools para almacenar en caché durante 15 minutos los tokens de autenticación de IAM generados. Para crear un paquete de implementación que contenga valkey-py y cachetools, lleva a cabo los siguientes pasos.

En el directorio de tu proyecto que contiene el archivo de código fuente app.py, crea un paquete de carpetas en el que instalar las bibliotecas valkey-py y cachetools.

mkdir package

Instala valkey-py y cachetools usando pip.

pip install --target ./package valkey pip install --target ./package cachetools

Crea un archivo.zip que contenga las bibliotecas valkey-py y cachetools. En Linux y macOS, ejecute el siguiente comando. En Windows, utilice la utilidad zip que prefiera para crear un archivo .zip con las bibliotecas valkey-py y cachetools en la raíz.

cd package zip -r ../my_deployment_package.zip .

Añada el código de función al archivo .zip. En Linux y macOS, ejecute el siguiente comando. En Windows, añada app.py al directorio raíz del archivo .zip con la utilidad de compresión zip que prefiera.

cd .. zip my_deployment_package.zip app.py

Paso 2.2: crear el rol de IAM (rol de ejecución)

Adjunte el AWS política gestionada denominada AWSLambdaVPCAccessExecutionRole al rol.

aws iam attach-role-policy \ --role-name "elasticache-iam-auth-app" \ --policy-arn "arn:aws:iam::aws:policy/service-role/AWSLambdaVPCAccessExecutionRole"

Paso 2.3: cargar el paquete de despliegue (crear la función de Lambda)

En este paso, se crea la función Lambda (AccessValkey) mediante la función create AWS CLI comando.

Desde el directorio del proyecto que contiene el archivo.zip del paquete de implementación, ejecute el siguiente comando create-function de la CLI de Lambda.

Para la opción del rol, utilice el ARN del rol de ejecución que creó en el paso anterior. Para vpc-config, introduzca listas separadas por comas de las subredes de la VPC predeterminada y el ID del grupo de seguridad de la VPC predeterminada. Puede encontrar estos valores en la Consola de Amazon VPC. Para buscar las subredes de tu VPC predeterminadas, elige Sus VPCy, a continuación, elige tu AWS la VPC predeterminada de la cuenta. Para buscar el grupo de seguridad de esta VPC, vaya a Seguridad y elija Grupos de seguridad. Compruebe que ha seleccionado la región us-east-1.

aws lambda create-function \ --function-name AccessValkey \ --region us-east-1 \ --zip-file fileb://my_deployment_package.zip \ --role arn:aws:iam::123456789012:role/elasticache-iam-auth-app \ --handler app.lambda_handler \ --runtime python3.12 \ --timeout 30 \ --vpc-config SubnetIds=comma-separated-vpc-subnet-ids,SecurityGroupIds=default-security-group-id

Paso 3: Pruebe la función Lambda con ElastiCache

En este paso, invocará la función de Lambda manualmente utilizando el comando de invocación. Cuando se ejecuta la función Lambda, genera un UUID y lo escribe en el ElastiCache la caché que especificó en su código Lambda. A continuación, la función de Lambda recupera el elemento de la caché.

  1. Invoca la función Lambda (AccessValkey) utilizando el AWS Lambda invocar el comando.

    aws lambda invoke \ --function-name AccessValkey \ --region us-east-1 \ output.txt
  2. Compruebe que la función de Lambda se ha ejecutado correctamente del modo siguiente:

    • Revise el archivo output.txt.

    • Verifique los resultados en CloudWatch Registra al abrir el CloudWatch consola y eligiendo el grupo de registro para su función (/aws/lambda/AccessValkey). El flujo de registro debería contener una salida similar a lo siguiente:

      Success: Inserted 826e70c5f4d2478c8c18027125a3e01e. Fetched 826e70c5f4d2478c8c18027125a3e01e from Valkey.
    • Revise los resultados en el AWS Lambda consola.

Paso 4: limpieza (opcional)

Para limpiar, siga estos pasos.

Paso 4.1: eliminación de la función de Lambda

aws lambda delete-function \ --function-name AccessValkey

Paso 4.2: eliminación de la caché sin servidor

Elimine la caché.

aws elasticache delete-serverless-cache \ --serverless-cache-name cache-01

Quite usuarios y grupos de usuarios.

aws elasticache delete-user \ --user-id default-user-disabled aws elasticache delete-user \ --user-id iam-user-01 aws elasticache delete-user-group \ --user-group-id iam-user-group-01

Paso 4.3: eliminación de políticas y el rol de IAM

aws iam detach-role-policy \ --role-name "elasticache-iam-auth-app" \ --policy-arn "arn:aws:iam::123456789012:policy/elasticache-allow-all" aws iam detach-role-policy \ --role-name "elasticache-iam-auth-app" \ --policy-arn "arn:aws:iam::aws:policy/service-role/AWSLambdaVPCAccessExecutionRole" aws iam delete-role \ --role-name "elasticache-iam-auth-app" aws iam delete-policy \ --policy-arn "arn:aws:iam::123456789012:policy/elasticache-allow-all"