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 do Google Cloud, acesse a página Media CDN.

   Acesse Media CDN

2. Clique na guia Origens.

3. Clique em Criar origem.

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

5. Opcional: digite 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 IP endereço IP e insira o endereço IP ou FQDN.

7. Clique em Criar origem.

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

Para atualizar um endereço de origem, clique na origem e depois 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 visualizar 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 curto 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 visualizar 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 do Google Cloud, acesse a página Media CDN.

   Acesse Media CDN

2. Clique na guia Services.

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 digite uma 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. Em Valor, especifique também. {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 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 funciona o roteamento: primeiro correspondendo o host e, em seguida, o caminho
   • Como funciona o armazenamento em cache (com base no modo de cache e no TTL)
   • Como 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, o Media CDN responderá com um 404 erro 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 acessar o serviço recém-criado na lista de EdgeCacheService recursos em 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, o Media CDN responderá com um erro 404 para outros hosts.

• ORIGIN_NAME: o nome da origem relacionada

Para visualizar o serviço recém-criado na lista de recursos EdgeCacheService em seu 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 route rule to match against"
        priority    = 1
        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 do Google Cloud, acesse a página Media CDN.

   Acesse Media CDN

2. Clique na guia Services.

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 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 curto 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 do Google Cloud, acesse a página Media CDN.

   Acesse Media CDN

2. Clique na guia Services.

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

4. Clique na guia Origens.

5. Selecione sua origem e clique em Excluir.

gcloud

1. Para listar os recursos que você criou, 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 que você criou, 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 curto. 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 do origem. Use o seguinte formato:

   projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
   

   Substitua ORIGIN_ID pelo nome curto. da origem.