Skip to main content
ISSUE-408HighPipeline Composition

Missing required component

Control: Pipelines must include componentsยท Config key: pipelineMustIncludeComponent

๐Ÿ“‹ What is this?

A required GitLab catalog component, as defined in your Policy controls, is missing in the project pipeline.

โš ๏ธ Impact

Missing components result in insecure pipeline configurations that don't match your policy. For example, if your pipeline is missing a security scan component, vulnerabilities might go undetected.

๐Ÿ”ง How to fix

Include the missing GitLab catalog component in the CI/CD pipeline configuration of the project.

โœ— BeforeThe SAST component is required but missing from the pipeline.
# .gitlab-ci.yml: โŒ Missing required SAST component
include:
- component: gitlab.com/components/secret-detection/secret-detection@2.4.1
# Missing: gitlab.com/components/sast/sast (required by policy)
# .plumber.yaml: Requires both SAST and secret detection
# pipelineMustIncludeComponent:
# enabled: true
# required: components/sast/sast AND components/secret-detection/secret-detection
โœ“ AfterBoth required components are included.
# .gitlab-ci.yml: โœ… All required components included
include:
- component: gitlab.com/components/sast/sast@1.5.2
- component: gitlab.com/components/secret-detection/secret-detection@2.4.1

๐Ÿ’ก Tips

  • Use expression syntax (AND/OR) in required for complex rules: (sast AND secret-detection) OR full-security.
  • Alternatively, use requiredGroups with arrays for OR-of-ANDs logic.
  • The include must match the component path pattern. Check your .plumber.yaml for the exact paths.

โš™๏ธ Configuration

This control is configured in .plumber.yaml under the gitlab section:

gitlab:
  controls:
    pipelineMustIncludeComponent:
      enabled: true

See the CLI documentation for the full configuration reference. On Plumber Platform, the same key is used in your policy configuration.