Escaneo de imágenes OCI con Trivy en pipelines CI/CD
Introducción
En la era de la contenedorización, la seguridad de las imágenes se ha vuelto crítica. Trivy, un escáner de vulnerabilidades ligero y de código abierto, se ha consolidado como la herramienta preferida para revisar imágenes OCI (Open Container Initiative). En este artículo veremos cómo configurar Trivy en entornos locales, escanear manualmente imágenes y, lo más importante, integrarlo de forma automática en pipelines CI/CD con GitLab CI y GitHub Actions. Al final obtendrás una solución completa que asegura que cada build de contenedor pase por un análisis exhaustivo antes de ser desplegado.
Instalación y configuración de Trivy
Descarga e instalación
Trivy está disponible como binario, paquete brew, apt y docker container. Para mayor control y aislamiento, instalaremos el binario.
# En Debian/Ubuntu sudo apt-get update sudo apt-get install -y curl curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/master/contrib/install.sh | sudo sh -s -- -b /usr/local/binEn macOS con Homebrew
brew install aquasecurity/trivy/trivy
Actualizar la base de datos de vulnerabilidades
Trivy almacena su catálogo de vulnerabilidades en un repositorio de datos local. Es importante mantenerlo actualizado.
trivy db update
Configuración de credenciales para registries privados
Para acceder a registries privados, Trivy necesita las credenciales. Existen dos formas comunes:
- Archivo de configuración (~/.config/trivy/config.yaml) con
authsytoken. - Variables de entorno (
TRIVY_USERNAME,TRIVY_PASSWORD,TRIVY_TOKEN).
Ejemplo de config.yaml para Docker Hub y GitHub Container Registry:
auths:
docker.io:
username: $DOCKERHUB_USER
password: $DOCKERHUB_PASS
ghcr.io:
token: $GHCR_TOKEN
Escaneo manual de imágenes OCI
Descargar la imagen
Antes de escanear, la imagen debe estar disponible localmente.
docker pull ubuntu:22.04
Escaneo con Trivy
El comando básico es:
trivy image --exit-code 1 --severity HIGH,CRITICAL ubuntu:22.04
Explicación:
--exit-code 1: devuelve código de salida 1 cuando se encuentran vulnerabilidades graves, lo que ayuda a integrar el escaneo en CI.--severity HIGH,CRITICAL: limita la salida a vulnerabilidades de alto riesgo.--format table(opcional): muestra una tabla legible.
Resultado
La salida típica incluye CVE, descripción, impacto y enlaces de referencia. Esta información será la base para las decisiones de autorización de despliegue.
Integración automática en pipelines CI/CD
GitLab CI
Para GitLab, añadimos un job llamado scan en el .gitlab-ci.yml. Este job construirá la imagen, la empujará al registry y la escaneará.
stages: - build - test - scanvariables: DOCKER_DRIVER: overlay2 REGISTRY_URL: registry.gitlab.com PROJECT_PATH: $CI_PROJECT_NAMESPACE/$CI_PROJECT_NAME
before_script:
- echo “$CI_REGISTRY_PASSWORD” | docker login -u “$CI_REGISTRY_USER” —password-stdin $REGISTRY_URL
build_image: stage: build script: - docker build -t $REGISTRY_URL/$PROJECT_PATH:$CI_COMMIT_SHA . - docker push $REGISTRY_URL/$PROJECT_PATH:$CI_COMMIT_SHA tags: - docker
scan: stage: scan image: aquasecurity/trivy:latest script: - trivy image —exit-code 1 —severity HIGH,CRITICAL $REGISTRY_URL/$PROJECT_PATH:$CI_COMMIT_SHA allow_failure: false tags: - docker
Por qué funciona:
- El job
build_imageempuja la imagen al registro GitLab Container Registry. - El job
scanusa elaquasecurity/trivyDocker image, garantizando una versión actualizada y sin dependencias locales. - El
--exit-code 1evita que la pipeline continúe si se detectan vulnerabilidades críticas.
GitHub Actions
En GitHub, creamos un workflow build_and_scan.yml que construye y escanea la imagen.
name: Build and Scanon: push: branches: [ main ]
jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Login to GHCR uses: docker/login-action@v3 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Build and push image uses: docker/build-push-action@v5 with: context: . push: true tags: ghcr.io/${{ github.repository }}:${{ github.sha }} - name: Scan image with Trivy uses: aquasecurity/trivy-action@v0.1.7 with: image-ref: ghcr.io/${{ github.repository }}:${{ github.sha }} severity: HIGH,CRITICAL format: table
La acción aquasecurity/trivy-action simplifica la ejecución y la salida se integra directamente en el log de GitHub.
Troubleshooting y errores comunes
Fallo al autenticar el registry
Errores como 401 Unauthorized suelen indicar credenciales incorrectas.
- Verifica que las variables
DOCKERHUB_USERyDOCKERHUB_PASSestán exportadas. - Para GitHub Container Registry, asegúrate de que
GHCR_TOKENtenga permisowrite:packages. - En GitLab, revisa que
$CI_REGISTRY_USERy$CI_REGISTRY_PASSWORDsean válidos.
Trivy: “Error pulling image …”
Puede ser una red lenta o la imagen no existe.
- Comprueba que el tag sea correcto (
docker image ls). - Prueba
docker pullmanualmente para descartar problemas de red. - Agrega
--retry 3al comando de Trivy para reintentos automáticos.
Tiempo de espera excedido (timeout)
En pipelines muy grandes, Trivy puede tardar excesivamente.
- Aumenta la memoria del runner (GitLab) o selecciona
runs-on: ubuntu-latestconstrategy: matrixpara paralelizar. - Usa la opción
--no-progresspara reducir la salida y acelerar. - Si la imagen es enorme, considera usar
--skip-db-updatecuando la base de datos esté actualizada.
Trivy devuelve vulnerabilidades de “basura” (false positives)
El catálogo de Trivy puede incluir vulnerabilidades que ya están parcheadas en la imagen.
- Ejecuta
trivy image --ignore-unfixedpara omitir aquellas sin patch disponible. - Actualiza la base de datos con
trivy db updateantes del escaneo. - Revisa la versión de Trivy; versiones antiguas pueden tener información obsoleta.
Conclusión
Integrar Trivy en pipelines CI/CD es un paso esencial para un flujo de entrega continua seguro. Con las configuraciones mostradas, cualquier organización puede garantizar que cada imagen OCI sea revisada automáticamente antes de llegar a producción, reduciendo el riesgo de exponer vulnerabilidades
comentarios(0)
$ dejar comentario