Configuração da invalidação de push para CDN de produção BYO
A invalidação por push limpa automaticamente o conteúdo na CDN de produção do cliente (por exemplo, www.yourdomain.com), sempre que um autor publicar alterações de conteúdo.
O conteúdo é removido por url e por tag/chave de cache.
A configuração da invalidação por push requer duas etapas:
Configuração
No momento, a invalidação por push é compatível com CDNs dos seguintes fornecedores:
A invalidação por push é ativada ao adicionar propriedades específicas à configuração do projeto (uma pasta de trabalho do Excel chamada .helix/config.xlsx no Sharepoint ou em uma planilha do Google chamada .helix/config no Google Drive).
As seções a seguir descrevem as propriedades específicas do fornecedor necessárias para configurar a invalidação por push.
Fastly
Propriedades de configuração:
Criar um token de API do Fastly
- ir para Tokens de API pessoal,
- clique em "Criar token",
- insira um nome (por exemplo,
"Production Site Purge Token"), - selecione "A specific service" (Um serviço específico) e seu serviço de produção na lista suspensa,
- marque a caixa de seleção "Purge select content (purge_select) — Purge by URL or surrogate key",
- selecione "Nunca expirar",
- clique em "Criar token",
- copie o valor do token gerado mostrado na janela pop-up.
Você pode validar as credenciais com este ferramenta.
Akamai
Propriedades de configuração
A invalidação por push usa o API de limpeza rápida do Akamai, especificamente Excluir por URL e Excluir por tag de cache.
As credenciais da API de Limpeza rápida consistem em
host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
Elas podem ser geradas seguindo as instruções em Criar um cliente de API com permissões personalizadas.
Gerenciamento de identidade e acesso
Criar cliente de API
Permissões de grupo/função necessárias:
Você pode validar as credenciais com este ferramenta.
Cloudflare
Propriedades de configuração
Criar um token de API
- ir para Tokens de API
- clique em "Criar token",
- vá para "Criar token personalizado" na parte inferior e clique em "Começar"
- digite um nome de token (por exemplo,
"Production Site Purge Token"), - Permissões: "Zona", "Limpeza de cache", "Limpeza"
- Recursos de região: "Incluir", "Zona específica", "<your production="" zone="">"
- clique em "Continuar para o resumo"
- clique em "Criar token",
- copie o valor do token gerado.
Observe que somente os sites no plano corporativo serão removidos cirurgicamente pelo URL e pela chave de cache. A Limpar tudo serão executados em sites não empresariais sempre que um autor publicar uma alteração de conteúdo.
Você pode validar as credenciais com este ferramenta.
CloudFront
NB: o CloudFront NÃO oferece suporte para limpeza por tag/chave de cache. A limpeza por tag/chave de cache sempre aciona uma limpeza de tudo.
Propriedades de configuração
Criar as credenciais do AWS
No Console do AWS, abra o painel IAM:
Selecione Usuários -> Adicionar usuários:
Insira um nome de usuário e marque "Access key - Programmatic access":
No painel "Definir permissões", clique em "Criar grupo":
Insira um nome de grupo e selecione a política CloudFrontFullAccess:
Criar o usuário:
Por fim, copie os valores da ID da chave de acesso e da chave de acesso secreta:
Você pode validar as credenciais com este ferramenta.
Cabeçalho da solicitação de aceitação
A CDN de produção precisa enviar o seguinte cabeçalho de aceitação para a origem para habilitar TTLs de cache longo:
X-Push-Invalidation: enabled