Esta página foi traduzida pela API Cloud Translation.

Configurar um serviço do CDN de mídia

Neste guia de início rápido, mostramos como configurar um serviço da Media CDN na frente de um bucket do Cloud Storage. Você pode usar essa configuração para testes ou como base para um ambiente de produção.

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

Nesta página, você vai aprender a fazer o seguinte:

Crie um bucket do Cloud Storage para armazenar seu conteúdo.
Ative os serviços necessários.
Crie um recurso EdgeCacheOrigin para conectar o Media CDN ao seu bucket.
Crie um recurso EdgeCacheService para configurar o roteamento de solicitações e o armazenamento em cache do conteúdo na origem.
Testar se uma resposta está sendo armazenada em cache.

Antes de começar

Verifique se você tem os recursos a seguir:

Acesso ao Media CDN para seu projeto atual.
A Google Cloud CLI instalada. Use a versão 345.0.0 ou mais recente.

Se necessário, use gcloud version para verificar a versão e gcloud components update para atualizar a CLI gcloud instalada.

A CLI gcloud fornece o grupo de subcomandos gcloud edge-cache para gerenciar configurações novas e atuais da Media CDN.
As permissões do Identity and Access Management (IAM) necessárias para criar recursos da Media CDN.

Criar um bucket do Cloud Storage

O conteúdo da Media CDN pode ser originado de locais como um bucket do Cloud Storage, um local de armazenamento de terceiros ou um balanceador de carga.

Neste guia de início rápido, vamos armazenar conteúdo em um bucket do Cloud Storage.

Crie um bucket do Cloud Storage acessível publicamente e nomeie-o como my-bucket.

Se você preferir não tornar seu bucket do Cloud Storage acessível publicamente, conceda permissões à Media CDN para acessar o bucket. Para mais informações, consulte Como usar buckets particulares do Cloud Storage.
Faça upload de um arquivo no bucket.

Ativar os serviços obrigatórios

Para configurar e implantar os serviços da Media CDN, é necessário ativar a API Network Services e a API Certificate Manager no projeto.

Console

Ative a API Network Services.

Ativar a API
Ative a API Certificate Manager.

Ativar a API

gcloud

Ative a API Network Services:

gcloud services enable networkservices.googleapis.com

Ative a API Certificate Manager:

gcloud services enable certificatemanager.googleapis.com

Para mais informações sobre como ativar e desativar serviços, consulte a documentação do Service Usage.

Criar um recurso `EdgeCacheOrigin`

Crie uma origem que aponte para seu bucket do Cloud Storage.

Console

No console Google Cloud , acesse a página Media CDN.

Acesse Media CDN
Clique na guia Origins.
Clique em Criar origem.
Insira o nome da origem como cloud-storage-origin.
Opcional: insira uma descrição para a origem.
Em Endereço de origem, escolha Selecionar um bucket do Google Cloud Storage, procure o bucket do Cloud Storage chamado my-bucket e clique em Selecione.

Se você tiver uma origem externa, escolha Especificar um FQDN ou endereço IP e insira o FQDN ou endereço IP.
Clique em Criar origem.

Após aproximadamente 10 minutos, o recurso EdgeCacheOrigin recém-criado aparece na lista de origens do projeto na página Origins.

Para atualizar um endereço de origem, clique na origem e em Editar.

gcloud

Use o comando gcloud edge-cache origins create:

gcloud edge-cache origins create ORIGIN \
    --origin-address="ADDRESS"

Substitua:

ORIGIN: o nome da nova origem
ADDRESS: o nome do bucket, gs://my-bucket

Se você tiver uma origem externa, substitua ADDRESS pelo FQDN ou endereço IP.

Para conferir a origem recém-criada, use o comando gcloud edge-cache origins list.

Para atualizar o endereço de origem, use o comando gcloud edge-cache origins update.

API

Use o método edgeCacheOrigins.create.

POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheOrigins?edgeCacheOriginId=ORIGIN_ID
{
  "name": "ORIGIN_ID",
  "originAddress: "ADDRESS"
}

Substitua:

PARENT: o recurso pai no formato projects/PROJECT/locations/global
ORIGIN_ID: o nome abreviado da nova origem
ADDRESS: o nome do bucket, gs://my-bucket

Se você tiver uma origem externa, substitua ADDRESS pelo FQDN ou endereço IP.

Para conferir a origem recém-criada, use o método edgeCacheOrigins.list.

Para atualizar o endereço de origem, use o método edgeCacheOrigins.patch.

Terraform

resource "google_network_services_edge_cache_origin" "default" {
  name           = "cloud-storage-origin"
  origin_address = "gs://my-bucket-${random_id.unique_suffix.hex}"
}

Criar um recurso `EdgeCacheService`

O recurso EdgeCacheService configura o roteamento, o certificado e as configurações de armazenamento em cache, além de poder apontar para recursos EdgeCacheOrigin.

Crie um recurso EdgeCacheService básico que faça o seguinte:

Armazena em cache todas as respostas da origem configurada por uma hora.
Define um cabeçalho de resposta x-cache-status que retorna o status do cache (como HIT ou MISS)

Se quiser, registre um nome de domínio para esse serviço.

Console

No console Google Cloud , acesse a página Media CDN.

Acesse Media CDN
Clique na guia Serviços.
Clique em Criar serviço.
Digite um nome exclusivo para o serviço (por exemplo, my-service) e clique em Avançar.
Na seção Roteamento, clique em Adicionar regra de host e insira um ou mais nomes de domínio de host.
Em Hosts, insira um nome de domínio de host, por exemplo, web.example.com.
Clique em Adicionar regra de rota.
1. Em Prioridade, especifique 1.
2. Clique em Adicionar condição de correspondência. Em Correspondência de caminho, especifique / e clique em Concluído.
3. Selecione Buscar em uma origem e, em seguida, selecione a origem que você configurou.
4. Clique em Ações de complemento.
5. Em Ação do cabeçalho, clique em Adicionar um item. Em seguida, siga estas etapas:
  1. Em Tipo, selecione Cabeçalhos de resposta a serem adicionados.
  2. Clique em Adicionar cabeçalho.
  3. Em Nome, especifique x-cache-status e em Valor, especifique {cdn_cache_status}.
  4. Clique em Concluído.
6. Em Rota de ação, clique em Adicionar um item. Em seguida, siga estas etapas:
  1. Em Tipo, selecione Política de CDN.
  2. Em Modo de cache, selecione FORCE_CACHE_ALL.
  3. Clique em Concluído.
7. Clique em Salvar.
Clique em Criar serviço.

O recurso EdgeCacheService recém-criado aparece na página Serviços na lista de serviços do seu projeto.

gcloud

No Cloud Shell, use um editor de texto para criar um arquivo local chamado my-service.yaml.

Esse arquivo indica o seguinte:
- Como o roteamento funciona: primeiro, ele corresponde ao host e, depois, ao caminho
- Como o armazenamento em cache funciona com base no modo de cache e no TTL
- Como as solicitações e respostas são modificadas, por exemplo, inserindo a variável cdn_cache_status em um cabeçalho de resposta

Cole o conteúdo de exemplo a seguir no arquivo e salve-o:

name: SERVICE
routing:
  hostRules:
  - hosts:
    - DOMAIN 
    pathMatcher: routes
  pathMatchers:
  - name: routes
    routeRules:
    - priority: 1
      matchRules:
      - prefixMatch: /
      origin: ORIGIN
      routeAction:
        cdnPolicy:
          cacheMode: CACHE_ALL_STATIC
          defaultTtl: 3600s
      headerAction:
        responseHeadersToAdd:
        - headerName: "x-cache-status"
          headerValue: "{cdn_cache_status}"

Substitua:

SERVICE: nome do serviço
DOMAIN: o domínio do novo serviço

Se você especificar o nome de domínio, a Media CDN vai responder com um erro 404 para outros hosts.
ORIGIN: o nome da origem relacionada

Use o comando gcloud edge-cache services import com o arquivo YAML:
```
gcloud edge-cache services import SERVICE \
    --source=my-service.yaml
```
Para conferir o serviço recém-criado na lista de recursos EdgeCacheService do seu projeto, use o comando gcloud edge-cache services list.

Observação: a Media CDN pode levar até 10 minutos para criar o serviço.

API

Use o método edgeCacheServices.create.

POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheServices?edgeCacheServiceId=SERVICE_ID
{
  "name": "SERVICE_ID",
  "routing": {
    "hostRules": [
      {
        "hosts": ["DOMAIN"],
        "pathMatcher": "routes"
      }
    ],
    "pathMatchers": [
      {
        "name": "routes",
        "routeRules": [
          {
            "priority": "1",
            "matchRules": [
              {
                "prefixMatch": "/"
              }
            ],
            "origin": "ORIGIN",
            "routeAction": {
               "cdnPolicy": {
                 "cacheMode": "CACHE_ALL_STATIC",
                 "defaultTtl": "3600s"
               }
            }
            "headerAction": {
              "responseHeadersToAdd": [
                {
                  "headerName": "x-cache-status",
                  "headerValue": "{cdn_cache_status}"
                }
              ]
            },
          }
        ]
      }
    ]
  }
}

Substitua:

PARENT: o recurso pai no formato projects/PROJECT/locations/global
SERVICE_ID: o nome do serviço
DOMAIN: o domínio do novo serviço

Se você especificar o nome de domínio, a Media CDN vai responder com um erro 404 para outros hosts.
ORIGIN_NAME: o nome da origem relacionada

Para conferir o serviço recém-criado na lista de recursos EdgeCacheService no projeto, use o método edgeCacheServices.list.

Terraform

resource "google_network_services_edge_cache_service" "default" {
  name = "cloud-media-service"
  routing {
    host_rule {
      hosts        = ["googlecloudexample.com"]
      path_matcher = "routes"
    }
    path_matcher {
      name = "routes"
      route_rule {
        description = "a default route rule, priority=10 (low)"
        priority    = 10
        match_rule {
          prefix_match = "/"
        }
        origin = google_network_services_edge_cache_origin.default.name
        route_action {
          cdn_policy {
            cache_mode  = "CACHE_ALL_STATIC"
            default_ttl = "3600s"
          }
        }
        header_action {
          response_header_to_add {
            header_name  = "x-cache-status"
            header_value = "{cdn_cache_status}"
          }
        }
      }
    }
  }
}

A criação do primeiro serviço pode levar vários minutos. A Media CDN provisiona endereços IP dedicados e envia sua configuração para milhares de locais de borda. Atualizações subsequentes de um serviço, como a mudança de uma configuração de rota ou parâmetros de correspondência, são mais rápidas.

Recuperar os endereços IP

Para conferir os endereços IP do serviço recém-criado, siga estas etapas:

Console

No console Google Cloud , acesse a página Media CDN.

Acesse Media CDN
Clique na guia Serviços.
Para os endereços IP do seu serviço, consulte a célula Endereços.

Se a célula estiver vazia, atualize o navegador.

gcloud

Use o comando gcloud edge-cache services describe:

gcloud edge-cache services describe SERVICE

Substitua SERVICE pelo nome do serviço.

A saída mostra os endereços IP atribuídos ao seu serviço:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS
name: projects/my-project/locations/global/edgeCacheServices/SERVICE
...

API

Use o método edgeCacheServices.get.

GET https://networkservices.googleapis.com/v1/SERVICE_NAME

Substitua SERVICE_NAME pelo nome completo do serviço. Use o seguinte formato:

projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID

Substitua SERVICE_ID pelo nome abreviado do serviço.

Os detalhes recuperados incluem os endereços IP atribuídos ao serviço:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS

Testar se uma resposta está sendo armazenada em cache

Antes de testar o serviço, verifique se você tem conteúdo armazenável em cache armazenado na origem para que a CDN de mídia possa recuperá-lo.

Para testar se o serviço está configurado corretamente para armazenar conteúdo em cache, use a ferramenta de linha de comando curl para emitir solicitações e verificar as respostas. curl também está disponível no Cloud Shell no console Google Cloud .

Se você quiser usar seu EdgeCacheService com seu domínio, atribua o endereço IP do EdgeCacheService a um registro de domínio. Para instruções, consulte Configurar seu domínio usando o Cloud DNS. Depois de configurar o domínio, acesse o conteúdo com o seguinte comando curl:

curl -svo /dev/null "http://DOMAIN_NAME/FILE_NAME"

Se você não configurou o DNS para apontar para os endereços IP provisionados, use a opção resolve para substituir o endereço usado pelo curl.

curl -svo /dev/null --resolve DOMAIN_NAME:80:IP_ADDRESS "http://DOMAIN_NAME/FILE_NAME"

Substitua:

DOMAIN_NAME : o domínio do host especificado ao criar o serviço
IP_ADDRESS: o endereço IP do serviço, conforme mostrado na coluna Endereços da lista de serviços.
FILE_NAME: o nome do arquivo que você fez upload para o bucket

Exemplo:

curl -svo /dev/null --resolve web.example.com:80:34.104.37.129 "http://web.example.com/file.mp4"

Inicialmente, o comando produz uma saída semelhante à seguinte, com o status miss, porque o CDN de mídia não tem os dados solicitados já recuperados da origem:

< HTTP/2 200 OK
...
< x-cache-status: den;miss
...

Quando você envia a mesma solicitação novamente quantas vezes quiser, ela produz uma saída semelhante à seguinte, com o status hit:

< HTTP/2 200 OK
...
< x-cache-status: den;hit
...

Se o status hit não aparecer, verifique o seguinte:

A resposta pode ser armazenada em cache.
O modo de cache configurado permite o armazenamento em cache do conteúdo.
A origem não está definindo diretivas de cache que impedem o armazenamento em cache. Para mais informações, consulte Configuração de cache.

Agora você testou um recurso EdgeCacheService básico que pode veicular conteúdo globalmente. Um serviço de nível de produção pode precisar de certificados SSL (TLS), várias origens e uma política de segurança do Google Cloud Armor.

Opcional: limpar

Exclua os recursos que você não pretende usar novamente.

Console

No console Google Cloud , acesse a página Media CDN.

Acesse Media CDN
Clique na guia Serviços.
Selecione o serviço e clique em Excluir.
Clique na guia Origins.
Selecione sua origem e clique em Excluir.

gcloud

Para listar os recursos criados, use o comando gcloud edge-cache origins list e o comando gcloud edge-cache services list.
Para excluir o serviço, use o comando gcloud edge-cache services delete:
```
gcloud edge-cache services delete SERVICE
```
Substitua SERVICE pelo nome do serviço.
Para excluir a origem, use o comando gcloud edge-cache origins delete:
```
gcloud edge-cache origins delete ORIGIN
```
Substitua ORIGIN pelo nome da origem.

API

Para listar os recursos criados, use o método edgeCacheServices.list e o método edgeCacheOrigins.list.
Para excluir o serviço, use o método edgeCacheServices.delete:
```
DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
```
Substitua SERVICE_NAME pelo nome completo do serviço. Use o seguinte formato:
```
projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
```
Substitua SERVICE_ID pelo nome abreviado do serviço.
Para excluir a origem, use o método edgeCacheOrigins.delete:
```
DELETE https://networkservices.googleapis.com/v1/ORIGIN
```
Substitua ORIGIN pelo nome completo da origem. Use o seguinte formato:
```
projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
```
Substitua ORIGIN_ID pelo nome abreviado da origem.

Repita esse processo para todos os outros recursos que você criou e não pretende usar novamente, como o bucket do Cloud Storage.

A seguir

Emitir e anexar um certificado SSL (TLS) ao seu EdgeCacheService.
Ver registros de solicitações com o Cloud Logging.
Configure solicitações assinadas para proteger seu conteúdo.
Otimize chaves de cache e TTLs e melhore as taxas de ocorrência em cache.
Configure a correspondência de rota avançada e crie outras origens.

Configurar um serviço do CDN de mídia Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar um bucket do Cloud Storage

Ativar os serviços obrigatórios

Console

gcloud

Criar um recurso EdgeCacheOrigin

Console

gcloud

API

Terraform

Criar um recurso EdgeCacheService

Console

gcloud

API

Terraform

Recuperar os endereços IP

Console

gcloud

API

Testar se uma resposta está sendo armazenada em cache

Opcional: limpar

Console

gcloud

API

A seguir

Configurar um serviço do CDN de mídia

Criar um recurso `EdgeCacheOrigin`

Criar um recurso `EdgeCacheService`