Como atualizar funções - Amazon CloudFront

Como atualizar funções

Quando testar uma função, você pode querer atualizar o código da função. Quando você atualiza o código de uma função, ela afeta apenas a cópia da função que está na fase DEVELOPMENT. O código da função na fase LIVE não muda. Para atualizar o código na fase LIVE, você publica a função, que o copia da fase DEVELOPMENT para LIVE.

Você pode atualizar o código de uma função no console do CloudFront ou com a AWS CLI.

Para atualizar seu código de função, você pode usar o editor de código visual no console do CloudFront.

Para atualizar o código da função (console)

  1. Para atualizar uma função existente, abra a página Functions (Funções) no console do CloudFront em https://console.aws.amazon.com/cloudfront/v3/home#/functions e, em seguida, selecione a função que deseja atualizar.

  2. Na página de função, selecione a guia Build (Criar). Em seguida, certifique-se de que a versão Development (Desenvolvimento) da função seja selecionada. Não é possível atualizar a versão ativa de uma função.

  3. Use o editor de código do console para atualizar seu código de função.

    Conforme você atualiza seu código, o editor de código pode exibir erros ou avisos sobre a sintaxe JavaScript.

  4. Quando terminar de atualizar seu código de função, selecione Save (Salvar).

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 atualizar seu código de função localmente, você pode usar a AWS CLI para atualizá-lo no CloudFront Functions com o comando aws cloudfront update-function, como no exemplo a seguir. Esse comando de exemplo usa arquivos de entrada para fornecer a configuração da função e o código de função atualizado para o comando. Para usar esse exemplo, faça o seguinte:

  • Substitua ExampleFunction pelo nome da função cujo código você está atualizando.

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

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

  • Substitua ETVABCEXAMPLE pelo valor ETag da função cujo código você está atualizando. Para obter esse valor, você pode usar o comando aws cloudfront describe-function.

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

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

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

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: ETVXYZEXAMPLE 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-19T23:41:15.389000+00:00' Stage: DEVELOPMENT Name: ExampleFunction Status: UNPUBLISHED