Crear, modificar y eliminar zonas

En esta página se explica cómo crear, actualizar, enumerar y eliminar zonas gestionadas de Cloud DNS. Antes de usar esta página, familiarízate con la descripción general de Cloud DNS y los términos clave.

Antes de empezar

La API Cloud DNS requiere que crees un proyecto de Cloud DNS y que habilites la API Cloud DNS.

Si vas a crear una aplicación que use la API REST, también debes crear un ID de cliente de OAuth 2.0.

  1. Si aún no tienes una, regístrate para obtener una cuenta de Google.
  2. Habilita la API Cloud DNS en la Google Cloud consola. Puedes elegir un proyecto de Compute Engine o App Engine que ya tengas o crear uno.
  3. Si necesitas enviar solicitudes a la API REST, debes crear un ID de OAuth 2.0. Consulta Configurar OAuth 2.0.
  4. En el proyecto, anota la siguiente información que debes introducir en pasos posteriores:
    • El ID de cliente (xxxxxx.apps.googleusercontent.com).
    • El ID del proyecto que quieras usar. Puedes encontrar el ID en la parte superior de la página Información general de la consola Google Cloud . También puedes pedirle al usuario que proporcione el nombre del proyecto que quiera usar en tu aplicación.

Si no has ejecutado la CLI de Google Cloud anteriormente, debes ejecutar el siguiente comando para especificar el nombre del proyecto y autenticarte con la consola: Google Cloud 

gcloud auth login

Si quieres ejecutar un comando gcloud en Google Cloud recursos de otro proyecto, especifica la opción --project para este comando y para los otros comandos gcloud de esta página.

Crear zonas gestionadas

Cada zona gestionada que creas está asociada a un Google Cloud proyecto. En las siguientes secciones se describe cómo crear el tipo de zona gestionada que admite Cloud DNS.

Crear una zona pública

Para crear una zona gestionada, sigue estos pasos:

Consola

  1. En la consola, ve a la página Crear una zona DNS. Google Cloud

    Ir a Crear una zona DNS

  2. En Tipo de zona, selecciona Pública.

  3. Introduce un nombre de zona, como my-new-zone.

  4. Introduce un sufijo de nombre de DNS para la zona con un nombre de dominio que te pertenezca. Todos los registros de la zona comparten este sufijo. Por ejemplo: example.com.

  5. En DNSSEC, selecciona Desactivado, Activado o Transferencia. Para obtener más información, consulta el artículo sobre cómo habilitar DNSSEC en zonas gestionadas.

  6. Haz clic en Crear. Se mostrará la página Detalles de zona.

gcloud

Ejecuta el comando dns managed-zones create:

gcloud dns managed-zones create NAME \
    --description=DESCRIPTION \
    --dns-name=DNS_SUFFIX \
    --labels=LABELS \
    --visibility=public

Haz los cambios siguientes:

  • NAME: un nombre para tu zona
  • DESCRIPTION: una descripción de la zona
  • DNS_SUFFIX: el sufijo DNS de tu zona, como example.com
  • LABELS: una lista opcional de pares clave-valor separados por comas, como dept=marketing o project=project1. Para obtener más información, consulta la documentación del SDK.

Terraform 

resource "google_dns_managed_zone" "example_zone" {
  name        = "example-zone"
  dns_name    = "example-${random_id.rnd.hex}.com."
  description = "Example DNS zone"
  labels = {
    name = "value"
  }
}

resource "random_id" "rnd" {
  byte_length = 4
}

API

Envía una solicitud POST con el método managedZones.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones
{
  "name": "NAME",
  "description": "DESCRIPTION",
  "dnsName": "DNS_NAME",
  "visibility": "public"
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que se crea la zona gestionada
  • NAME: un nombre para tu zona
  • DESCRIPTION: una descripción de la zona
  • DNS_NAME: el sufijo DNS de tu zona, como example.com

Crear una zona privada

Para crear una zona privada gestionada con registros DNS privados gestionados por Cloud DNS, sigue estos pasos. Para obtener más información, consulta las prácticas recomendadas para las zonas privadas de Cloud DNS.

Consola

  1. En la consola, ve a la página Crear una zona DNS. Google Cloud

    Ir a Crear una zona DNS

  2. En Tipo de zona, selecciona Privada.

  3. Introduce un nombre de zona, como my-new-zone.

  4. Introduce un sufijo de nombre de DNS para la zona privada. Todos los registros de la zona comparten este sufijo. Por ejemplo: example.private.

  5. Opcional: Añade una descripción.

  6. En Opciones, selecciona Predeterminado (privado).

  7. Selecciona las redes de nube privada virtual (VPC) en las que debe ser visible la zona privada. Solo las redes VPC que selecciones podrán consultar registros en la zona.

  8. Haz clic en Crear.

gcloud

Ejecuta el comando dns managed-zones create:

gcloud dns managed-zones create NAME \
    --description=DESCRIPTION \
    --dns-name=DNS_SUFFIX \
    --networks=VPC_NETWORK_LIST \
    --labels=LABELS \
    --visibility=private

Haz los cambios siguientes:

  • NAME: un nombre para tu zona
  • DESCRIPTION: una descripción de la zona
  • DNS_SUFFIX: el sufijo DNS de tu zona, como example.private
  • VPC_NETWORK_LIST: lista delimitada por comas de redes de VPC autorizadas para consultar la zona
  • LABELS: una lista opcional de pares clave-valor separados por comas, como dept=marketing o project=project1. Para obtener más información, consulta la documentación del SDK.

Terraform 

resource "google_dns_managed_zone" "private_zone" {
  name        = "private-zone"
  dns_name    = "private.example.com."
  description = "Example private DNS zone"
  labels = {
    foo = "bar"
  }

  visibility = "private"

  private_visibility_config {
    networks {
      network_url = google_compute_network.network_1.id
    }
    networks {
      network_url = google_compute_network.network_2.id
    }
  }
}

resource "google_compute_network" "network_1" {
  name                    = "network-1"
  auto_create_subnetworks = false
}

resource "google_compute_network" "network_2" {
  name                    = "network-2"
  auto_create_subnetworks = false
}