← volver

Escaneo de imágenes OCI con Trivy en pipelines CI/CD

Por · · [Ciberseguridad] · lectura estimada: ~4 min

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/bin

En 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 auths y token.
  • 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
  - scan

variables: 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_image empuja la imagen al registro GitLab Container Registry.
  • El job scan usa el aquasecurity/trivy Docker image, garantizando una versión actualizada y sin dependencias locales.
  • El --exit-code 1 evita 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 Scan

on: 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_USER y DOCKERHUB_PASS están exportadas.
  • Para GitHub Container Registry, asegúrate de que GHCR_TOKEN tenga permiso write:packages.
  • En GitLab, revisa que $CI_REGISTRY_USER y $CI_REGISTRY_PASSWORD sean 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 pull manualmente para descartar problemas de red.
  • Agrega --retry 3 al 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-latest con strategy: matrix para paralelizar.
  • Usa la opción --no-progress para reducir la salida y acelerar.
  • Si la imagen es enorme, considera usar --skip-db-update cuando 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-unfixed para omitir aquellas sin patch disponible.
  • Actualiza la base de datos con trivy db update antes 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

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal