redhat-developer / redhat-developer/gitops-operator

Harden OpenShift manual-install SCC troubleshooting guidance

Open
#1,295 0 comments 0 reactions 1 assignee View on GitHub

@olivergondza is already working on this.

Since Sep 15, 2026.

Dominant language
Go
Stars
188
Forks
359
Avg merge
3d 14h
Merged PRs (30d)
18

Description

Summary

The OpenShift manual-install documentation recommends granting the privileged SCC to the default ServiceAccount in openshift-gitops-operator when the operator image fails the non-root policy.

Rationale

Granting privileged to default makes it available to every workload that uses that ServiceAccount in the namespace. The guidance should not broaden SCC permissions for unrelated workloads.

Affected area

  • argocd-operator/docs/install/openshift.md
  • The runAsUser breaks non-root policy troubleshooting note in the manual-install section.

Required changes

Replace the default ServiceAccount workaround with guidance that uses a dedicated ServiceAccount for the affected deployment. Identify or recommend the least-privileged SCC that resolves the image policy error. State how to bind that SCC only to the dedicated ServiceAccount.

Acceptance criteria

  • The documentation does not instruct users to grant privileged SCC to default.
  • The affected operator deployment uses a dedicated ServiceAccount when an SCC exception is required.
  • The documentation recommends the least-privileged suitable SCC before privileged.
  • The guidance explains the scope of the SCC binding.

Backlinks

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.