Documentatie / Pipelines

GitLab CI

Voeg een herbruikbare SBOM-stage en optionele release gate toe.

Wat je nodig hebt

  • Masked CI variable WATCHTOWER_TOKEN
  • CI variables WATCHTOWER_URL en WATCHTOWER_ENVIRONMENT
  • Een runner met Syft en curl in PATH
  1. 1

    Voeg een security-inventory stage toe

    Dit is een jobfragment voor een bestaande runner met Syft en curl. Plaats hem na een geslaagde build en zet WATCHTOWER_ENVIRONMENT expliciet, bijvoorbeeld op staging of production; CI_ENVIRONMENT_NAME is zonder deployment-job niet altijd beschikbaar. De commit-SHA geeft reproduceerbare context.

    watchtower:sbom:
      stage: test
      script:
        - syft dir:. -o cyclonedx-json=sbom.cdx.json
        - >-
          curl --fail-with-body "$WATCHTOWER_URL/api/inventory/sbom"
          -H "X-Inventory-Token: $WATCHTOWER_TOKEN"
          -H "Content-Type: application/vnd.cyclonedx+json"
          -H "X-Asset-Name: $CI_PROJECT_NAME" -H "X-Environment: $WATCHTOWER_ENVIRONMENT"
          -H "X-Hostname: gitlab-ci" -H "X-Build-Number: $CI_PIPELINE_IID"
          -H "X-Commit-Sha: $CI_COMMIT_SHA" --data-binary @sbom.cdx.json
  2. 2

    Bescherm secrets

    Markeer het token masked en protected wanneer alleen protected branches naar productie mogen rapporteren.

  3. 3

    Maak een herbruikbare include

    Centraliseer de job in een CI-template en laat projecten alleen assetnaam, omgeving en scantarget configureren.

Klaar wanneer het bewijs zichtbaar is

Controleer in Watchtower of de bron recent is, het componentaantal logisch is en de releasecontext bij de juiste asset staat. Een geslaagde HTTP-call alleen is niet genoeg.

Open Watchtower