Dominio Propio en Cloud Run: hectorgarrido.cl Paso a Paso
Este artículo detalla el proceso para configurar un dominio propio (`hectorgarrido.cl`) en Cloud Run, desde la compra del dominio en NIC Chile hasta la configuración del DNS. Aprenderás a crear una zona administrada en Cloud DNS, mapear el dominio a tu servicio de Cloud Run y actualizar los nameservers en el registrador del dominio. Se utiliza la herramienta `gcloud` para interactuar con Google Cloud y se explica la arquitectura DNS involucrada, permitiendo a los lectores tener control total sobre sus dominios y una integración fluida con Cloud Run.

Elegir el Dominio
El dominio era claro: hectorgarrido.cl. Mi nombre, extensión .cl.
La extensión .cl es el ccTLD (Country Code Top-Level Domain) de Chile, administrado por NIC Chile. A diferencia de extensiones como .dev, no tiene restricciones técnicas de HTTPS a nivel de navegador — no está en la lista HSTS Preload. Esto significa que funciona tanto con HTTP como con HTTPS dependiendo de la configuración del servidor, aunque en este caso Cloud Run sirve HTTPS por defecto con certificados administrados por Google, así que en la práctica el sitio siempre opera sobre HTTPS.
Tener un .cl tiene una ventaja concreta para este proyecto: comunica origen local. Para un portafolio orientado al mercado laboral chileno, hectorgarrido.cl es más reconocible y contextualiza al profesional en el ecosistema local.
Dónde comprar
Los dominios .cl solo pueden ser registrados a través de registradores acreditados por NIC Chile, la entidad que administra el ccTLD del país. No cualquier registrador internacional los vende — hay que usar uno habilitado específicamente para .cl. Revisé las opciones principales:
| Registrador | Precio/año | Notas |
|---|---|---|
| NIC Chile (directo) | ~$7.990 CLP | El registrador oficial. Interfaz simple pero funcional |
| TocHost | ~$8.990 CLP | Registrador chileno acreditado, servicio local |
| DonWeb (Chile) | ~$9.490 CLP | Presencia regional, soporte en español |
| Namecheap | No disponible | No acreditado para .cl |
Elegí registrar directamente en NIC Chile. Al ser la entidad administradora, el proceso es el más directo y no hay intermediarios que puedan complicar transferencias o soporte. La verificación de propiedad para Google Search Console es igualmente sencilla — NIC Chile permite agregar registros TXT desde su panel.
El dominio costó 8 USD).
Arquitectura del DNS
Antes de tocar comandos, vale entender qué queremos lograr:
Usuario escribe: hectorgarrido.cl
↓
Resolvedor DNS consulta: ¿Qué NS tiene hectorgarrido.cl?
↓
Respuesta: ns-cloud-X.googledomains.com (Cloud DNS)
↓
Cloud DNS responde con: A/AAAA records → IPs de Cloud Run
↓
Navegador conecta a Cloud Run con SNI: hectorgarrido.cl
↓
Cloud Run verifica el Certificate Authority, sirve HTTPS
La pieza clave es que vamos a usar Google Cloud DNS como servidor de nombres autoritativo, en lugar del DNS que ofrece por defecto el registrador. Esto nos da:
- Control total de los registros desde
gcloudo la consola GCP - Integración directa con el dominio mapping de Cloud Run
- Mejor observabilidad (los logs de DNS queries están en Cloud Logging)
Paso 1: Crear la Zona Administrada en Cloud DNS
Cloud DNS organiza los registros dentro de "zonas administradas" (managed zones). Una zona corresponde exactamente a un dominio.
gcloud dns managed-zones create hectorgarrido-cl \
--dns-name="hectorgarrido.cl." \
--description="Zona DNS principal para hectorgarrido.cl" \
--project=blog-479107
Notar el punto final en hectorgarrido.cl. — en DNS, el punto final es técnicamente obligatorio para indicar que es un FQDN (Fully Qualified Domain Name). gcloud lo acepta con o sin él, pero es correcto incluirlo.
La zona se crea en estado activo inmediatamente. Lo que Cloud DNS no hace por nosotros es decirle al mundo que usamos sus servidores — eso sigue el Paso 2.
Los nameservers asignados
Después de crear la zona:
gcloud dns managed-zones describe hectorgarrido-cl \
--project=blog-479107 \
--format="value(nameServers)"
Output:
ns-cloud-b1.googledomains.com.
ns-cloud-b2.googledomains.com.
ns-cloud-b3.googledomains.com.
ns-cloud-b4.googledomains.com.
Estos cuatro nameservers hay que copiarlos. Son los que vamos a configurar en el registrador en el Paso 3.
Paso 2: Mapear el Dominio en Cloud Run
Cloud Run necesita saber que es responsable de servir hectorgarrido.cl. El proceso de "domain mapping" también activa la emisión automática del certificado TLS.
# Mapear el dominio raíz al servicio frontend
gcloud run domain-mappings create \
--service=blog-frontend \
--domain=hectorgarrido.cl \
--region=us-central1 \
--project=blog-479107
# Mapear www también
gcloud run domain-mappings create \
--service=blog-frontend \
--domain=www.hectorgarrido.cl \
--region=us-central1 \
--project=blog-479107
# Mapear el subdominio api al backend
gcloud run domain-mappings create \
--service=blog-backend \
--domain=api.hectorgarrido.cl \
--region=us-central1 \
--project=blog-479107
Después de crear cada mapping, Cloud Run devuelve los registros DNS que hay que crear. Para el dominio raíz, la respuesta se ve así:
NAME TYPE DATA
hectorgarrido.cl. A 216.239.32.21
hectorgarrido.cl. A 216.239.34.21
hectorgarrido.cl. A 216.239.36.21
hectorgarrido.cl. A 216.239.38.21
hectorgarrido.cl. AAAA 2001:4860:4802:32::15
hectorgarrido.cl. AAAA 2001:4860:4802:34::15
hectorgarrido.cl. AAAA 2001:4860:4802:36::15
hectorgarrido.cl. AAAA 2001:4860:4802:38::15
Cuatro registros A (IPv4) y cuatro registros AAAA (IPv6). Para www y api Cloud Run sugiere registros CNAME en lugar de A/AAAA, apuntando a ghs.googlehosted.com..
Paso 3: Crear los Registros DNS en Cloud DNS
Con los registros que Cloud Run nos indicó, los creamos en Cloud DNS:
Registros A y AAAA para el dominio raíz
# Registros IPv4 (A records)
gcloud dns record-sets create hectorgarrido.cl. \
--zone=hectorgarrido-cl \
--type=A \
--ttl=300 \
--rrdatas="216.239.32.21,216.239.34.21,216.239.36.21,216.239.38.21" \
--project=blog-479107
# Registros IPv6 (AAAA records)
gcloud dns record-sets create hectorgarrido.cl. \
--zone=hectorgarrido-cl \
--type=AAAA \
--ttl=300 \
--rrdatas="2001:4860:4802:32::15,2001:4860:4802:34::15,2001:4860:4802:36::15,2001:4860:4802:38::15" \
--project=blog-479107
CNAME para www y api
# www → frontend
gcloud dns record-sets create www.hectorgarrido.cl. \
--zone=hectorgarrido-cl \
--type=CNAME \
--ttl=300 \
--rrdatas="ghs.googlehosted.com." \
--project=blog-479107
# api → backend
gcloud dns record-sets create api.hectorgarrido.cl. \
--zone=hectorgarrido-cl \
--type=CNAME \
--ttl=300 \
--rrdatas="ghs.googlehosted.com." \
--project=blog-479107
TTL de 300 segundos
El TTL (Time To Live) de 300 segundos (5 minutos) es deliberadamente bajo. Durante la configuración inicial hay errores y ajustes, y un TTL bajo significa que los cambios se propagan en minutos, no en horas. Una vez estabilizado el sistema se puede subir a 3600 (1 hora) o más para reducir la carga en los resolvers.
Verificar los registros creados
gcloud dns record-sets list \
--zone=hectorgarrido-cl \
--project=blog-479107
Output esperado:
NAME TYPE TTL DATA
hectorgarrido.cl. A 300 216.239.32.21, ...
hectorgarrido.cl. AAAA 300 2001:4860:4802:32::15, ...
hectorgarrido.cl. NS 21600 ns-cloud-b1.googledomains.com., ...
hectorgarrido.cl. SOA 21600 ns-cloud-b1.googledomains.com. ...
www.hectorgarrido.cl. CNAME 300 ghs.googlehosted.com.
api.hectorgarrido.cl. CNAME 300 ghs.googlehosted.com.
Los registros NS y SOA los crea Cloud DNS automáticamente al crear la zona.
Paso 4: Apuntar el Registrador a Cloud DNS
Este es el cable que conecta todo. En el panel de Squarespace Domains, bajo la configuración de hectorgarrido.cl, cambié los nameservers por defecto a los cuatro de Cloud DNS:
ns-cloud-b1.googledomains.com
ns-cloud-b2.googledomains.com
ns-cloud-b3.googledomains.com
ns-cloud-b4.googledomains.com
Este cambio tiene una latencia particular: NIC Chile debe propagar el cambio de NS en los servidores raíz del TLD (.cl), lo que puede tomar entre 30 minutos y 48 horas. En la práctica propagó en menos de dos horas — NIC Chile actualiza sus servidores autoritativos con bastante frecuencia.
⚠️ Trampa común: El registrador normalmente ofrece configurar los registros DNS directamente en su plataforma (sin cambiar los NS). Es tentador porque parece más simple. El problema es que mezclas la gestión de DNS entre dos plataformas, lo cual es una fuente permanente de confusión. Si voy a usar Cloud DNS, todo el DNS debe estar en Cloud DNS.
Paso 5: Verificar la Propagación
Mientras espero la propagación, verifico con herramientas externas:
# Verificar qué NS responde actualmente
dig NS hectorgarrido.cl +short
# Verificar los A records
dig A hectorgarrido.cl +short
# Verificar desde un resolver específico (Google Public DNS)
dig A hectorgarrido.cl @8.8.8.8 +short
También usé dnschecker.org para ver la propagación desde múltiples ubicaciones geográficas simultáneamente. La zona verde cubre primero Europa y Norteamérica, luego Sudamérica.
El estado del certificate provisioning
Cloud Run emite certificados TLS automáticamente a través de Let's Encrypt una vez que los DNS records apuntan correctamente a sus IPs. Esto toma entre 15 y 60 minutos adicionales después de la propagación DNS.
El estado del mapping en Cloud Run puede seguirse así:
gcloud run domain-mappings describe \
--domain=hectorgarrido.cl \
--region=us-central1 \
--project=blog-479107
El campo relevante es resourceRecords y el estado del certificado. Cuando está listo aparece algo como:
status:
conditions:
- lastTransitionTime: '2026-02-20T...'
status: 'True'
type: Ready
mappedRouteName: blog-frontend
resourceRecords:
- name: hectorgarrido.cl
rrdata: 216.239.32.21
type: A
El type: Ready con status: 'True' es la señal de que el certificado está activo y el dominio sirve HTTPS.
Paso 6: Actualizar la Configuración del Backend
Con el dominio activo, hay variables de configuración que apuntan a las URLs anteriores:
CORS_ALLOWED_ORIGINS en Django
# settings.py — antes
CORS_ALLOWED_ORIGINS = [
"https://blog-frontend-HASH-uc.a.run.app",
"http://localhost:3000",
]
# settings.py — después
CORS_ALLOWED_ORIGINS = [
"https://hectorgarrido.cl",
"https://www.hectorgarrido.cl",
"http://localhost:3000",
]
DJANGO_ALLOWED_HOSTS
DJANGO_ALLOWED_HOSTS=api.hectorgarrido.cl,blog-backend-HASH-uc.a.run.app,localhost
Mantuve también la URL autogenerada del backend para no romper nada durante la transición.
REACT_APP_API_URL en el frontend
# .env.production
REACT_APP_API_URL=https://api.hectorgarrido.cl/api
seoConfig.js
// blog_frontend/src/seoConfig.js
export const CANONICAL_BASE = 'https://hectorgarrido.cl';
Este es el cambio más visible: ahora los canonical URLs generados con buildCanonical('/') producen https://hectorgarrido.cl/ en lugar de la URL de Cloud Run.
El Redirect www → raíz
Un detalle de UX: www.hectorgarrido.cl y hectorgarrido.cl deben ser equivalentes. Si los buscadores indexan ambas sin configuración de canonical, habrá contenido duplicado.
La solución fue en nginx.conf:
server {
listen 8080;
server_name www.hectorgarrido.cl;
return 301 https://hectorgarrido.cl$request_uri;
}
server {
listen 8080;
server_name hectorgarrido.cl;
# configuración normal...
}
En la práctica, el mapping de Cloud Run para www apunta al mismo servicio frontend, y nginx hace el redirect permanente (301) al dominio raíz.
Problemas Encontrados
Mixed content después de cambiar la API URL
Cuando el frontend ya cargaba desde https://hectorgarrido.cl pero la variable REACT_APP_API_URL todavía apuntaba a la URL de Cloud Run con HTTP en un ambiente de prueba, el navegador bloqueaba las peticiones por mixed content. La solución fue simple — asegurar que todas las referencias a la API usaran HTTPS — pero costó tiempo diagnosticarlo porque el error aparece en la consola del navegador, no en los logs del servidor.
El dominio raíz no puede ser CNAME
Esto es un límite técnico del sistema DNS: un registro CNAME en el apex del dominio (el dominio raíz, sin subdominio) no está permitido por el estándar RFC 1912. Es por eso que Cloud Run proporciona registros A y AAAA directamente para el dominio raíz, pero usa CNAME para subdominios como www y api.
Algunos registradores ofrecen registros propietarios tipo ALIAS o ANAME que emulan CNAME en el apex, pero Cloud DNS no los necesita porque proporciona las IPs directamente.
Propagación incompleta durante el primer deploy
En los primeros 30 minutos después de cambiar los nameservers, parte de las peticiones resolvían con los NS antiguos y parte con Cloud DNS. Esto provocó intermitencia: algunas peticiones al sitio llegaban bien, otras daban timeout. La solución fue esperar — no hay mucho más que hacer una vez que el cambio de NS está publicado.
Verificación Final
Con todo configurado, la lista de verificación:
# El dominio raíz carga el frontend
curl -I https://hectorgarrido.cl
# HTTP/2 200
# www hace redirect al raíz
curl -I https://www.hectorgarrido.cl
# HTTP/1.1 301 Moved Permanently
# Location: https://hectorgarrido.cl/
# La API responde
curl https://api.hectorgarrido.cl/api/blog/posts/ | head -c 200
# {"count":24,"next":...
# El certificado es válido
openssl s_client -connect hectorgarrido.cl:443 -servername hectorgarrido.cl \
< /dev/null 2>&1 | grep -E "subject|issuer|Verify"
# subject=CN = hectorgarrido.cl
# issuer=C = US, O = Google Trust Services, CN = WR2
# Verify return code: 0 (ok)
Certificado emitido por Google Trust Services (WR2), que es el CA que usa Cloud Run para sus certificados administrados.
Costos Adicionales
El dominio agrega dos líneas de costo:
| Concepto | Costo |
|---|---|
Dominio hectorgarrido.cl |
~8 USD) |
| Cloud DNS — zona administrada | $0.20 USD/mes (primeras 25 zonas) |
| Cloud DNS — queries | ~$0.40 USD/millón de queries |
Para el volumen actual del sitio (portafolio personal), el costo de Cloud DNS en queries es prácticamente cero — unos pocos centavos al mes.
El costo total de la infraestructura sigue siendo menos de $5 USD/mes, ahora incluyendo el dominio amortizado.
Reflexión
La configuración de DNS es uno de esos temas que parece intimidante antes de hacerlo y trivial después. La curva de aprendizaje real es entender el modelo conceptual: registrador ≠ nameserver ≠ zona DNS ≠ registros. Una vez clara esa distinción, los comandos son mecánicos.
Lo que más tiempo consumió no fue la configuración técnica sino esperar la propagación. DNS tiene latencias inherentes que no se pueden saltear. El antídoto es hacer los cambios con tiempo y no justo antes de "necesitar" que funcione.
El resultado: hectorgarrido.cl. Una URL que cabe en un currículum, y que además dice de dónde eres.
Anterior: De Blog Personal a Portafolio Profesional: Por Qué y Cómo
Siguiente: Conectar un Formulario de Contacto con Gmail en Django + React
Este artículo es parte de la serie "Construyendo un Blog con IA". El código fuente completo está en GitHub.