reglas_distroless

Reglas de Bazel para recuperar paquetes de Debian

Este conjunto de reglas está diseñado para reemplazar comandos como apt-get install , passwd , groupadd , useradd , update-ca-certificates .

Nota

reglas_distroless es un software beta y aún no tiene una API pública estable; sin embargo, muchos ya lo están usando en producción.

Consulte la sección Adoptantes para ver quién ya lo está usando.

Uso

Nuestros ejemplos demuestran cómo realizar tareas típicas como crear un nuevo grupo de usuarios o crear un nuevo directorio de inicio .

• agregar grupo
• contraseña
• agregar usuario --home
• actualizar-certificados-ca
• herramienta clave
• apt-get install desde los repositorios de Debian.
• apt-get install desde los repositorios de Ubuntu.

También tenemos reglas específicas para distribuciones que podrían ser útiles.

• aplanar: aplana varios archivos tar .
• os_release: crea un archivo /etc/os-release
• configuración regional: elimine /usr/lib/locale para que sea más pequeño.
• dpkg_statusd: crea una base de datos de paquetes en /var/lib/dpkg/status.d para que los escáneres descubran los paquetes instalados.

Documentos API públicos

• regla de repositorio apt para buscar/instalar paquetes de Debian/Ubuntu.
• linux Varias reglas para crear archivos específicos de Linux.

Instalación

Consulte las instrucciones de instalación en las notas de la versión: https://github.com/GoogleContainerTools/rules_distroless/releases

Para utilizar una confirmación en lugar de una liberación, puede apuntar a cualquier SHA del repositorio.

Con bzlmod, puedes usar archive_override o git_override . Para WORKSPACE , modifica la llamada http_archive ; por ejemplo, para usar la confirmación abc123 con un archivo WORKSPACE :

1. Reemplace url = "https://github.com/GoogleContainerTools/rules_distroless/releases/download/v0.1.0/rules_distroless-v0.1.0.tar.gz" con un archivo fuente proporcionado por GitHub como url = "https://github.com/GoogleContainerTools/rules_distroless/archive/abc123.tar.gz"
2. Reemplace strip_prefix = "rules_distroless-0.1.0" con strip_prefix = "rules_distroless-abc123"
3. Actualice el sha256 . La forma más sencilla de hacerlo es comentar la línea y luego Bazel imprimirá un mensaje con el valor correcto.

Tenga en cuenta que los archivos fuente de GitHub no tienen una garantía sólida sobre la estabilidad de sha256, consulte https://github.blog/2023-02-21-update-on-the-future-stability-of-source-code-archives- y-hashes

Contribuyendo

Este conjunto de reglas está financiado principalmente para soportar distroless. Es posible que no trabajemos en solicitudes de funciones que no respalden esta misión. Sin embargo, aceptaremos contribuciones completamente probadas a través de solicitudes de extracción si se alinean con los objetivos del proyecto (por ejemplo, un formato de compresión diferente) y podemos rechazar solicitudes que no lo hagan (por ejemplo, que admitan un formato de empaquetado no basado en deb ).

Adoptantes

• sin distribución: https://github.com/GoogleContainerTools/distroless
• Arize IA: https://www.arize.com

¿Un adoptante? Agregue su empresa aquí enviándonos una solicitud de extracción.