Caché de Docker y secretos: ¿por qué no se repite la instrucción?
Por qué cambiar un secreto no basta para repetir una instrucción. Caché de Docker, CACHEBUST, --no-cache-filter y límites de la comprobación.
Imagina este caso. Una instrucción de compilación de Docker descarga dependencias de un registro privado de paquetes. Cambias el token proporcionado como secreto de compilación. En la siguiente compilación, la misma instrucción muestra CACHED. Las demás entradas relevantes para la caché no han cambiado. ¿Se ha utilizado siquiera el token nuevo?
Es un caso hipotético, no un experimento reproducido. La explicación sigue la documentación de Docker con BuildKit, no el comportamiento de todas las herramientas que construyen imágenes de contenedor. (docs.docker.com)
El valor no es el identificador
Docker indica expresamente que cambiar el valor de un secreto de compilación no invalida la caché. Sin embargo, su identificador y la ruta de montaje participan en la suma de comprobación de la caché. Otros cambios en las entradas también pueden provocar una nueva ejecución. (docs.docker.com)
La conclusión de ingeniería es limitada: CACHED no demuestra que se haya utilizado el token nuevo. Reutilizar un resultado no comprueba los permisos de acceso actuales. Esta conclusión se deriva de excluir el valor del secreto de la suma de comprobación. (docs.docker.com)
Proporcionar un secreto no solicita una nueva ejecución
Con un montaje de secretos, el cliente proporciona el secreto mediante –secret y la instrucción RUN correspondiente lo utiliza a través del montaje. El secreto está disponible temporalmente durante su ejecución. Esto describe cómo se proporcionan los datos, no una solicitud para repetir la instrucción. (docs.docker.com)
No traslades el token a un argumento de compilación ni a una instrucción ENV del Dockerfile para modificar la caché. Docker advierte que estos mecanismos no son apropiados para secretos. Los valores de los argumentos pueden quedar en los metadatos o el historial de la imagen. (docs.docker.com)
Dos formas de solicitar una nueva ejecución
Una opción es un argumento de compilación separado y no confidencial, como CACHEBUST. Decláralo como ARG en la etapa pertinente, antes de la instrucción RUN correspondiente. Al cambiar el token, cambia también la revisión proporcionada mediante –build-arg. Cambiar el valor del argumento provoca un fallo de caché en su primer uso, incluido el uso implícito por una instrucción RUN posterior, no en la propia declaración ARG. (docs.docker.com)
La otra opción es –no-cache-filter. Permite indicar las etapas con nombre cuya caché de compilación debe ignorarse. Si la descarga de dependencias está en la etapa install, selecciona esa etapa. El filtro acepta nombres de etapas, no identificadores de secretos. Es una elección de alcance, no una prueba de autenticación. (docs.docker.com)
El montaje no impide cualquier filtración
La guía de BuildKit reconoce expresamente que una compilación en ejecución puede leer un secreto montado. Por tanto, no consideres el montaje una protección frente a una instrucción que imprima o copie el token. El documento enlazado pertenece a la rama master: es una guía en evolución, no la especificación de una versión fija. (github.com)
Qué comprobar después
Empieza por el objetivo de la comprobación. ¿Solo necesitas repetir la instrucción de dependencias o debes establecer que el registro acepta la credencial nueva? Para lo segundo, busca pruebas de una petición autenticada real, sin revelar el secreto. No sustituyas ese criterio por el estado general de la compilación.
Para el contexto más amplio de Docker y CI, consulta «Una aplicación, diez problemas». Aquí, el siguiente paso de diagnóstico es más concreto. (igergov.com)
¿Qué etapa concreta de la compilación debe ejecutarse de nuevo?
Fuentes
- Docker Docs: Build cache invalidation: https://docs.docker.com/build/cache/invalidation/
- Docker Docs: Build secrets: https://docs.docker.com/build/building/secrets/
- Docker Docs: Dockerfile reference: https://docs.docker.com/reference/dockerfile/
- Docker Docs: docker buildx build: https://docs.docker.com/reference/cli/docker/buildx/build/
- Docker Docs: Build variables: https://docs.docker.com/build/building/variables/
- BuildKit project process guide: Security boundary: https://github.com/moby/buildkit/blob/master/PROJECT.md