Adicionar acionadores a uma função do Lambda@Edge - Amazon CloudFront

Adicionar acionadores a uma função do Lambda@Edge

É possível usar o console do AWS Lambda ou o console do Amazon CloudFront para adicionar um acionador à função do Lambda@Edge.

Importante

É possível criar acionadores somente para versões numeradas da função (não para $LATEST).

Lambda console
Como adicionar acionadores para eventos do CloudFront a uma função do Lambda@Edge

  1. Faça login no AWS Management Console e abra o console AWS Lambda em https://console.aws.amazon.com/lambda/.

  2. Na lista Region (Região) na parte superior da página, escolha US East (N. Virginia) (Leste dos EUA (Norte da Virgínia)).

  3. Na página Functions, selecione o nome da função à qual você deseja adicionar triggers.

  4. Na página de Function overview (Visão geral da função), escolha a guia Versions (Versões).

  5. Escolha a versão à qual você deseja adicionar triggers.

    Depois de escolher uma versão, o nome do botão mudará para Version: $LATEST ou para Version: número da versão.

  6. Selecione a guia Triggers.

  7. Escolha Add trigger.

  8. Em Configuração do gatilho, escolha Selecione uma origem, insira cloudfront e selecione CloudFront.

    nota

    Se você já tiver criado um ou mais triggers, o CloudFront será o serviço padrão.

  9. Especifique os seguintes valores para indicar quando você deseja que a função Lambda seja executada.

    1. Distribuição: escolha a distribuição à qual você deseja adicionar o acionador.

    2. Comportamento de cache: escolha o comportamento de cache que especifica os objetos nos quais você deseja executar a função.

      nota

      Se você especificar * para o comportamento do cache, a função do Lambda será implantada no comportamento do cache padrão.

    3. Evento do CloudFront: escolha o evento do CloudFront que faz com que a função seja executada.

    4. Incluir corpo: marque essa caixa de seleção se quiser acessar o corpo da solicitação na função.

    5. Confirmar implantação no Lambda@Edge: marque essa caixa de seleção para que o AWS Lambda replique a função para Regiões da AWS globalmente.

  10. Escolha Adicionar.

    A função começará a processar solicitações para os eventos do CloudFront especificados quando a distribuição atualizada do CloudFront for implantada. Para determinar se uma distribuição foi implantada, escolha Distributions no painel de navegação. Quando uma distribuição estiver implantada, o valor da coluna Status da distribuição mudará de Deploying (Implantando) para a data e hora da implantação.

CloudFront console
Como adicionar acionadores para eventos do CloudFront a uma função do Lambda@Edge

  1. Obtenha o Nome de região da Amazon (ARN) da função do Lambda à qual você deseja adicionar triggers:

    1. Faça login no AWS Management Console e abra o console AWS Lambda em https://console.aws.amazon.com/lambda/.

    2. Na lista de regiões na parte superior da página, escolha US East (N. Virginia) (Leste dos EUA (Norte da Virgínia)).

    3. Na lista de funções, selecione o nome da função à qual você deseja adicionar triggers.

    4. Na página Function overview (Visão geral da função), escolha a guia Versions (Versões) e escolha a versão numerada à qual você deseja adicionar acionadores.

    5. Selecione Copy ARN (Copiar ARN) para copiar o código para a área de transferência. O ARN da função do Lambda tem a seguinte aparência:

      arn:aws:lambda:us-east-1:123456789012:function:TestFunction:2

      O número no final (2, no exemplo) é o número da versão da função.

  2. Abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

  3. Na lista de distribuição, selecione o ID da distribuição à qual você deseja adicionar triggers.

  4. Escolha a guia Behaviors.

  5. Selecione o comportamento do cache ao qual você deseja adicionar acionadores e, em seguida, escolha Edit (Editar).

  6. Em Function associations (Associações da função), na lista Function type (Tipo da função), escolha Lambda@Edge para quando a função deve ser executada: para solicitações do visualizador, respostas do visualizador, solicitações da origem ou respostas da origem.

    Para obter mais informações, consulte Escolher o evento para acionar a função.

  7. Na caixa de texto Function ARN / Name (Função ARN/Nome), cole o ARN da função do Lambda que você deseja executar quando o evento escolhido ocorrer. Esse é o valor copiado do console do Lambda.

  8. Selecione Include body (Incluir corpo) se quiser acessar o corpo da solicitação na sua função.

    Se deseja apenas substituir o corpo da solicitação, você não precisa selecionar essa opção.

  9. Para executar a mesma função em outros tipos de evento, repita as etapas 6 e 7.

  10. Escolha Salvar alterações.

  11. Para adicionar acionadores em outros comportamentos de cache para essa distribuição, repita as etapas 5 a 10.

    A função começará a processar solicitações para os eventos do CloudFront especificados quando a distribuição atualizada do CloudFront for implantada. Para determinar se uma distribuição foi implantada, escolha Distributions no painel de navegação. Quando uma distribuição estiver implantada, o valor da coluna Status da distribuição mudará de Deploying (Implantando) para a data e hora da implantação.