Missing documentation of Google DNS fallback 8.8.8.8 and 8.8.4.4

Abierto Apto para principiantes
#22,945 3 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Tranquilo
Stack tecnológico
docker
Área
documentation

Línea de trabajo

Comienza con la sección de servicios DNS del capítulo de redes en la ubicación de documentación enlazada y revisa la cobertura existente del comportamiento de DNS. Añade una nota que explique el fallback a 8.8.8.8 y 8.8.4.4 cuando no haya ningún DNS configurado distinto de localhost y, a continuación, verifica la documentación renderizada y la redacción.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

area/engine area/networking status/confirmed
Is this a docs issue?
  • My issue is about the documentation content or website
Type of issue

I can't find what I'm looking for

Description
Summary

Add a note to the documentation indicating that Docker falls back to Google DNS if no non-localhost DNS is defined.

Details

In one of my projects, I started a Docker container on a device without internet access and with no configured DNS other than localhost.
Inside the container, some DNS requests timed out after a long delay. I expected the DNS requests to fail immediately.

Upon checking the dockerd log, I found the following line during startup:

No non-localhost DNS nameservers are left in resolv.conf. Using default external servers: [nameserver 8.8.8.8 nameserver 8.8.4.4]

I reviewed the DNS section of the networking chapter, but found no mention of this behavior. I only discovered it referenced in another issue: https://github.com/moby/moby/issues/23910

Am I missing something?

Edit: Tested with Docker version 24.0.5, build ced0996

Location

https://docs.docker.com/engine/network/#dns-services

Suggestion

Maybe add a simple sentence to the chapter:

In case no non-localhost DNS is defined in the `/etc/resolve.conf`, a fallback to `8.8.8.8` and `8.8.4.4` will be added.

Exact formulation and placement is of course open for discussion.

Lenguaje dominante
Markdown
Estrellas
4.7k
Forks
8.5k
Merge medio
2 d 12 h
PR fusionados (30 d)
104

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de docker/docs

Todos los issues de docker/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.