Configurar um serviço do CDN de mídia

Console

1. Ative a API Network Services.

   Ativar a API

2. Ative a API Certificate Manager.

   Ativar a API

gcloud

1. Ative a API Network Services:

   gcloud services enable networkservices.googleapis.com
   

2. Ative a API Certificate Manager:

   gcloud services enable certificatemanager.googleapis.com
   

Console

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

   Acesse Media CDN

2. Clique na guia Origins.

3. Clique em Criar origem.

4. Insira o nome da origem como cloud-storage-origin.

5. Opcional: insira uma descrição para a origem.

6. 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.

7. 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 editEditar.

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}"
}

Console

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

   Acesse Media CDN

2. Clique na guia Serviços.

3. Clique em Criar serviço.

4. Digite um nome exclusivo para o serviço (por exemplo, my-service) e clique em Avançar.

5. Na seção Roteamento, clique em Adicionar regra de host e insira um ou mais nomes de domínio de host.

6. Em Hosts, insira um nome de domínio de host, por exemplo, web.example.com.

7. 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.

8. 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

1. 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

2. 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

3. 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.

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}"
          }
        }
      }
    }
  }
}

Console

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

   Acesse Media CDN

2. Clique na guia Serviços.

3. 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

Console

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

   Acesse Media CDN

2. Clique na guia Serviços.

3. Selecione o serviço e clique em Excluir.

4. Clique na guia Origins.

5. Selecione sua origem e clique em Excluir.

gcloud

1. Para listar os recursos criados, use o comando gcloud edge-cache origins list e o comando gcloud edge-cache services list.

2. 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.

3. 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

1. Para listar os recursos criados, use o método edgeCacheServices.list e o método edgeCacheOrigins.list.

2. 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.

3. 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.