- Issues
- ISSUE-102
CI/CD provider
Forbidden container image tag
Control:CTRL-102Container images must not use forbidden reference
📋 What is this?
A container image used to run a CI/CD job is using a tag that is forbidden by your configuration.
⚠️ Impact
Using forbidden tags can result in insecure containers running in your CI/CD pipelines or unexpected breaking changes. For instance, if your pipeline uses the latest tag, it might pull a compromised, untested, or breaking image.
🔧 How to fix
Update the image tag to a tag allowed by your Policy controls.
# .gitlab-ci.yml: ❌ Uses "latest" tag (forbidden)build: image: python:latest script: - pip install -r requirements.txt - python setup.py build
lint: image: golangci/golangci-lint:latest script: - golangci-lint run# .gitlab-ci.yml: ✅ Uses specific version tagsbuild: image: python:3.12.1 script: - pip install -r requirements.txt - python setup.py build
lint: image: golangci/golangci-lint:v1.62.2 script: - golangci-lint run💡 Tips
- Common forbidden tags include:
latest,dev,staging,main,master. - To accept one image on a forbidden tag, for example an internal tool only published as
latest, list it inexemptImagesinstead of turning the control off. It is then skipped by ISSUE-102 and ISSUE-103 while it uses one of the forbidden tags; its other tags are still checked. See Exempting an image.
⚙️ Configure this control
On the Plumber Platform: open the Policies page and set control CTRL-102 on the policy that governs the project.
With the CLI alone: set it in your configuration file. Every field and default is in the controls configuration reference, CTRL-102.
Forbidden container image tag
Control:CTRL-102Container images must not use forbidden reference
📋 What is this?
A job's container: image, or the image of one of its uses: docker://… steps, is referenced by a forbidden tag (e.g. latest, dev, main).
⚠️ Impact
Mutable tags can move between runs. A latest tag that passed today's job might point at a different image tomorrow, including a compromised one, without any change to the workflow file.
🔧 How to fix
Pin the image to an immutable version tag, or better yet to a digest (see ISSUE-103).
# .github/workflows/build.yml: ❌ Uses "latest"jobs: build: runs-on: ubuntu-latest container: image: node:latest steps: - run: npm ci && npm test# .github/workflows/build.yml: ✅ Specific versionjobs: build: runs-on: ubuntu-latest container: image: node:20.18.1 steps: - run: npm ci && npm test💡 Tips
- Forbidden tags default to
latest,dev,staging,main,master. The list is part of the control's configuration. - Docker pulls
latestfor an image written with neither tag nor digest (container: node,uses: docker://alpine), so Plumber reads it aslatestand raises this issue whenlatestis forbidden. - Pair with ISSUE-103 to require digest pinning on top of immutable tags.
- To accept one image on a forbidden tag, for example an internal tool only published as
latest, list it inexemptImagesinstead of turning the control off. It is then skipped by ISSUE-102 and ISSUE-103 while it uses one of the forbidden tags; its other tags are still checked. See Exempting an image.
⚙️ Configure this control
On the Plumber Platform: open the Policies page and set control CTRL-102 on the policy that governs the project.
With the CLI alone: set it in your configuration file. Every field and default is in the controls configuration reference, CTRL-102.