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:
En esta página, se te guiará por los siguientes procedimientos:
- Crea un bucket de Cloud Storage para almacenar tu contenido.
- Habilita los servicios requeridos.
- Crea un recurso
EdgeCacheOriginpara conectar Media CDN a tu bucket. - Crea un recurso
EdgeCacheServicepara configurar el enrutamiento de solicitudes y el almacenamiento en caché del contenido en el origen. - Prueba si una respuesta se almacena en caché.
Antes de comenzar
Asegúrate de contar con lo siguiente:
Acceso a Media CDN para tu proyecto actual.
La Google Cloud CLI instalada. Usa la versión 345.0.0 o posterior.
Si es necesario, usa
gcloud versionpara verificar la versión ygcloud components updatepara actualizar la gcloud CLI instalada.Gcloud CLI proporciona el grupo de subcomandos
gcloud edge-cachepara administrar las configuraciones de Media CDN nuevas y existentes.Los permisos de Identity and Access Management (IAM) necesarios para crear recursos de CDN de Media.
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 Cacheroles/networkservices.edgeCacheViewer: Acceso de solo lectura a los recursos de Edge Cache.
Para crear un bucket de almacenamiento
- Rol de administrador de almacenamiento
(
roles/storage.admin)
Para habilitar SSL en Media CDN
- Rol de editor del Administrador de certificados (
roles/certificatemanager.editor)
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.
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.
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
Habilita la API de Network Services.
Habilita la API de Certificate Manager.
gcloud
Habilita la API de Network Services:
gcloud services enable networkservices.googleapis.comHabilita 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
En la consola de Google Cloud , ve a la página Media CDN.
Haz clic en la pestaña Orígenes.
Haz clic en Crear origen.
Ingresa el nombre del origen como
cloud-storage-origin.Ingresa una descripción para el origen (opcional).
En Dirección de origen, elige Seleccionar un bucket de Google Cloud Storage, navega al bucket de Cloud Storage llamado
my-buckety, 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.
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 formatoprojects/PROJECT/locations/globalORIGIN_ID: El nombre corto del origen nuevoADDRESS: El nombre del bucket,gs://my-bucketSi, en cambio, tienes un origen externo, reemplaza
ADDRESSpor 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
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-statusque devuelve el estado de la caché (comoHIToMISS).
De manera opcional, registra un nombre de dominio para este servicio.
Console
En la consola de Google Cloud , ve a la página Media CDN.
Haga clic en la pestaña Servicios.
Haz clic en Crear servicio.
Ingresa un nombre único para tu servicio, por ejemplo,
my-service, y haz clic en Siguiente.En la sección Enrutamiento, haz clic en Agregar regla de host y, luego, ingresa uno o más nombres de dominio de host.
En Hosts, ingresa un nombre de dominio de host, por ejemplo,
web.example.com.Haz clic en Add route rule.
- En Prioridad, especifica
1. - Haz clic en Add match condition, para Path match, especifica
/y, luego, haz clic en Listo. - Selecciona Fetch from an Origin y, luego, selecciona el origen que configuraste.
- Haz clic en Acciones de complementos.
- En Header action, haz clic en Agregar un elemento. A continuación, haz lo siguiente:
- En Prioridad, especifica