glab dependency-firewall ci-summary

Summarize Dependency Firewall activity from the CI log. (BETA)

Synopsis

Read .gitlab/df/ci-log.json and print blocked and flagged packages recorded during a glab dependency-firewall run.

The log is read from the current working directory and, when set, from the directory in GLAB_DF_CI_LOG_DIR. Run this command from the same directory as the glab dependency-firewall run that wrote the log, otherwise no activity is reported. The job-level proxy sets GLAB_DF_CI_LOG_DIR, so jobs that use it can run this command from any directory.

To fail a CI/CD job when any package was blocked, run this command as the last command in script. This catches a block even when a package manager continues after a refused download. In after_script, the command prints the report but can’t fail the job, because GitLab ignores after_script exit codes.

yaml
install:
  variables:
    GLAB_ENABLE_CI_AUTOLOGIN: "true"
  script:
    - glab dependency-firewall npm ci
    - glab dependency-firewall pip install -r requirements.txt
    - glab dependency-firewall ci-summary

Entries accumulate across runs, and the command never clears them. A block from an earlier run keeps the command exiting with 3 until you delete .gitlab/df/ci-log.json.

Exit code Meaning
0 No blocked entries in the log (allow-only or warnings).
1 The log could not be read.
3 At least one entry in the log is blocked.

This feature is in beta and might not be ready for production use. It might be unstable and breaking changes can occur outside of major releases. For more information, see https://docs.gitlab.com/policy/development_stages_support/.

glab dependency-firewall ci-summary [flags]

Examples

console
# Show blocked and flagged packages from the last firewall run
glab dependency-firewall ci-summary

Environment variables

GLAB_DF_CI_LOG_DIR: a directory whose .gitlab/df/ci-log.json is read in addition to the working directory's. The job-level proxy sets it.

Options inherited from parent commands

  -h, --help   Show help for this command.