Configura un servicio de Media CDN

En esta guía de inicio rápido, se muestra cómo configurar un servicio de Media CDN frente a un bucket de Cloud Storage. Puedes usar esta configuración para realizar pruebas o como base para un entorno de producción.


Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:

GUIARME


En esta página, se te guiará por los siguientes procedimientos:

  1. Crea un bucket de Cloud Storage para almacenar tu contenido.
  2. Habilita los servicios requeridos.
  3. Crea un recurso EdgeCacheOrigin para conectar Media CDN a tu bucket.
  4. Crea un recurso EdgeCacheService para configurar el enrutamiento de solicitudes y el almacenamiento en caché del contenido en el origen.
  5. Prueba si una respuesta se almacena en caché.

Antes de comenzar

Asegúrate de contar con lo siguiente:

Roles obligatorios

Para obtener los permisos que necesitas para completar las tareas de este documento, pídele a tu administrador que te otorgue los siguientes roles:

  • roles/networkservices.edgeCacheAdmin: Acceso para crear, actualizar, borrar y administrar todos los recursos de Edge Cache.
  • roles/networkservices.edgeCacheUser: Acceso para ver y usar recursos de Edge Cache
  • roles/networkservices.edgeCacheViewer: Acceso de solo lectura a los recursos de Edge Cache.

Para crear un bucket de almacenamiento

Para habilitar SSL en Media CDN

También puedes obtener los permisos necesarios con roles personalizados o con otros roles predefinidos.

Cree un bucket de Cloud Storage

El contenido de Media CDN puede provenir de ubicaciones como un bucket de Cloud Storage, una ubicación de almacenamiento de terceros o un balanceador de cargas.

En esta guía de inicio rápido, almacenaremos contenido en un bucket de Cloud Storage.

  1. Crea un bucket de Cloud Storage de acceso público y llámalo my-bucket.

    Si prefieres que tu bucket de Cloud Storage no sea de acceso público, debes otorgar permisos a Media CDN para acceder a él. Para obtener más información, consulta Usa buckets privados de Cloud Storage.

  2. Sube un archivo al bucket.

Habilita los servicios obligatorios

Para configurar e implementar los servicios de Media CDN, debes habilitar la API de Network Services y la API de Certificate Manager para tu proyecto.

Console

  1. Habilita la API de Network Services.

    Habilitar la API

  2. Habilita la API de Certificate Manager.

    Habilitar la API

gcloud

  1. Habilita la API de Network Services:

    gcloud services enable networkservices.googleapis.com
    
  2. Habilita la API de Certificate Manager:

    gcloud services enable certificatemanager.googleapis.com
    

Para obtener más información sobre cómo habilitar e inhabilitar servicios, consulta la documentación de Service Usage.

Crea un recurso EdgeCacheOrigin

Crea un origen que apunte a tu bucket de Cloud Storage.

Console

  1. En la consola de Google Cloud , ve a la página Media CDN.

    Ir a Media CDN

  2. Haz clic en la pestaña Orígenes.

  3. Haz clic en Crear origen.

  4. Ingresa el nombre del origen como cloud-storage-origin.

  5. Ingresa una descripción para el origen (opcional).

  6. En Dirección de origen, elige Seleccionar un bucket de Google Cloud Storage, navega al bucket de Cloud Storage llamado my-bucket y, luego, haz clic en Seleccionar.

    Si, en cambio, tienes un origen externo, elige Especificar un FQDN o una dirección IP y, luego, ingresa el FQDN o la dirección IP.

  7. Haz clic en Crear origen.

Después de aproximadamente 10 minutos, el recurso EdgeCacheOrigin recién creado aparecerá en la lista de orígenes de tu proyecto en la página Orígenes.

Para actualizar una dirección de origen, haz clic en el origen y, luego, en Editar.

gcloud

Usa el comando gcloud edge-cache origins create:

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

Reemplaza lo siguiente:

  • ORIGIN: Es el nombre del origen nuevo.
  • ADDRESS: El nombre del bucket, gs://my-bucket

Si, en cambio, tienes un origen externo, reemplaza ADDRESS por el FQDN o la dirección IP.

Para ver el origen recién creado, usa el comando gcloud edge-cache origins list.

Para actualizar la dirección de origen, usa el comando gcloud edge-cache origins update.

API

Usa el método edgeCacheOrigins.create:

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

Reemplaza lo siguiente:

  • PARENT: El recurso principal en el formato projects/PROJECT/locations/global
  • ORIGIN_ID: El nombre corto del origen nuevo
  • ADDRESS: El nombre del bucket, gs://my-bucket

    Si, en cambio, tienes un origen externo, reemplaza ADDRESS por el FQDN o la dirección IP.

Para ver el origen recién creado, usa el método edgeCacheOrigins.list.

Para actualizar la dirección de origen, usa el 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}"
}

Crea un recurso EdgeCacheService

Tu recurso EdgeCacheService configura el enrutamiento, el certificado y la configuración de almacenamiento en caché, y puede apuntar a recursos EdgeCacheOrigin.

Crea un recurso EdgeCacheService básico que haga lo siguiente:

  • Almacena en caché todas las respuestas de nuestro origen configurado durante una hora
  • Establece un encabezado de respuesta x-cache-status que devuelve el estado de la caché (como HIT o MISS).

De manera opcional, registra un nombre de dominio para este servicio.

Console

  1. En la consola de Google Cloud , ve a la página Media CDN.

    Ir a Media CDN

  2. Haga clic en la pestaña Servicios.

  3. Haz clic en Crear servicio.

  4. Ingresa un nombre único para tu servicio, por ejemplo, my-service, y haz clic en Siguiente.

  5. En la sección Enrutamiento, haz clic en Agregar regla de host y, luego, ingresa uno o más nombres de dominio de host.

  6. En Hosts, ingresa un nombre de dominio de host, por ejemplo, web.example.com.

  7. Haz clic en Add route rule.

    1. En Prioridad, especifica 1.
    2. Haz clic en Add match condition, para Path match, especifica / y, luego, haz clic en Listo.
    3. Selecciona Fetch from an Origin y, luego, selecciona el origen que configuraste.
    4. Haz clic en Acciones de complementos.
    5. En Header action, haz clic en Agregar un elemento. A continuación, haz lo siguiente: