Criar funções - Amazon CloudFront

Criar funções

Antes de criar uma função, você deve escrever o código da função. Para obter mais informações sobre como escrever uma função, consulte Código de função de escrita (modelo de programação). Por exemplo, o código que pode ajudá-lo a começar, consulte Código de exemplo.

Quando você cria uma nova função no CloudFront Functions, a função está na fase DEVELOPMENT. Nessa fase, você pode testar a função e atualizá-la, se necessário. Quando estiver pronto para usar sua função com uma distribuição do CloudFront, você publica a função, que a copia da fase DEVELOPMENT para a LIVE. Quando estiver na fase LIVE, você poderá associar a função ao comportamento de cache de uma distribuição.

Você pode testar uma função no console do CloudFront ou com a AWS Command Line Interface (AWS CLI).

Quando você cria uma função no console, você pode começar com a função padrão, copiar uma função do código de exemplo no GitHub ou criar seu próprio código de função desde o início.

Para criar uma função (console)

  1. Faça login no AWS Management Console e abra a página Functions (Funções) no console do CloudFront em https://console.aws.amazon.com/cloudfront/v3/home#/functions.

  2. Escolha Create function.

  3. Digite um nome de função e selecione Continue (Continuar). O nome da função deve ser exclusivo na conta da AWS.

  4. Na página function, faça o seguinte:

    1. (Opcional) Insira uma descrição para a função.

    2. Modifique o código da função. O console fornece uma função padrão que pode ajudar você a começar. Ou você pode copiar do código de exemplo no GitHub. Para obter mais informações sobre como escrever código de função, consulte o seguinte:

    3. Selecione Salve (Salvar) para salvar a função.

Quando for bem-sucedido, você verá um banner na parte superior da página que diz Function name saved successfully ([Nome da função] salva com sucesso).

Depois de salvar sua função, você pode testá-la.

Depois de escrever o código da função, você pode criar a função com a AWS CLI usando o comando aws cloudfront create-function, como no exemplo a seguir. O seguinte comando de exemplo usa um arquivo de entrada para fornecer o código de função para o comando create-function. Para usar esse exemplo, faça o seguinte:

  • Substitua ExampleFunction por um nome para a função.

  • Substitua Example function por um comentário para descrever a função.

  • Substitua function.js pelo nome do arquivo que contém seu código de função. Execute o comando no diretório que contém esse arquivo.

  • Execute o comando em uma linha. No exemplo, as quebras de linha são fornecidas para tornar o exemplo mais legível.

aws cloudfront create-function \ --name ExampleFunction \ --function-config Comment="Example function",Runtime="cloudfront-js-1.0" \ --function-code fileb://function.js

Quando o comando é bem-sucedido, você vê uma saída como a seguinte descrevendo a função que acabou de ser criada.

nota

A seguinte saída é formatada como uma cadeia YAML. Esse recurso só está disponível na versão 2 da AWS CLI. Para obter mais informações, consulte Configuração do formato da saída da AWS CLI no Guia do usuário da AWS Command Line Interface.

ETag: ETVABCEXAMPLE FunctionSummary: FunctionConfig: Comment: Example function Runtime: cloudfront-js-1.0 FunctionMetadata: CreatedTime: '2021-04-18T20:38:56.915000+00:00' FunctionARN: arn:aws:cloudfront::111122223333:function/ExampleFunction LastModifiedTime: '2021-04-18T20:38:56.915000+00:00' Stage: DEVELOPMENT Name: ExampleFunction Status: UNPUBLISHED Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront::111122223333:function/ExampleFunction