Chapter 2. Policy deployment strategy


The Kubernetes API is used to define and interact with policies. You are responsible for ensuring that the environment meets internal enterprise security standards for software engineering, secure engineering, resiliency, security, and regulatory compliance for workloads hosted on Kubernetes clusters.

  • Deployment options

    The CertificatePolicy, ConfigurationPolicy, and OperatorPolicy policies and Gatekeeper constraints can be deployed to your managed clusters in two ways. You can deploy policies to your managed clusters by using the Hub cluster policy framework or Deploying policies with external tools. View the following descriptions of each option:

    Hub cluster policy framework
    The first approach is to leverage the policy framework on the hub cluster. This involves defining the policies and Gatekeeper constraints within a Policy object on the hub cluster and leveraging a Placement and PlacementBinding to select which clusters the policies get deployed to. The policy framework handles the delivery to the managed cluster and the status aggregation back to the hub cluster. The Policy objects are represented in the Policies table in the Red Hat Advanced Cluster Management for Kubernetes console.
    Deploying policies with external tools
    Alternatively, you can use an external tool, such as Red Hat OpenShift GitOps, to deliver the policies and Gatekeeper constraints directly to the managed cluster. Your policies are shown in the Discovered policies table in the Red Hat Advanced Cluster Management console and can be a helpful option if a configuration management strategy is already in place, but there is a desire to supplement the strategy with Red Hat Advanced Cluster Management policies.

See the following comparison table to learn which option supports specific features, which helps you make a decision on which deployment strategy is more suitable for your use case:

Table 2.1. Policy deployment comparison table
FeaturePolicy frameworkDeployed with external tools

Hub cluster templating

Yes

Yes, but requires additional setup.

Managed cluster templating

Yes

Yes

Red Hat Advanced Cluster Management console support

Yes

Yes, you can view policies that are deployed by external tools from the Discover policies table. Policies that are deployed with external tools are not displayed from the Governance Overview dashboard. You must enable the search service on your managed cluster.

Policy grouping

Yes, you can have a combination of statuses and deployments through Policy and PolicySet resources.

You can use Kubernetes labels on your policy resources to logically group related policies and view the Discovered policies table. You can also use Argo CD Application objects for grouping and to get a high-level status.

Policy event history

You can view the last 10 events per cluster per policy stored on your hub cluster.

You can view the last 10 events in the status of the policy on your managed cluster.

Policy dependencies

Yes

No. Alternatively, you can use the Argo CD sync waves feature to define dependencies.

Policy Generator

Yes

No

OpenShift GitOps health checks

You must complete extra configuration for Argo CD versions earlier than 2.13.

Yes

Yes

OpenShift GitOps applying native Kubernetes manifests and Red Hat Advanced Cluster Management policy on the managed cluster

No, you must deploy a policy on your Red Hat Advanced Cluster Management hub cluster.

Yes

Policy status metric on the hub cluster for alerts

Yes

Yes, cluster_policy_governance_info.

Running Ansible jobs on violated policies

Yes, use the PolicyAutomation resource.

No

2.1. Policy deployment with external tools

To deploy CertificatePolicy, ConfigurationPolicy, OperatorPolicy resources, and Gatekeeper constraints directly to your managed cluster, you can use an external tool such as Red Hat OpenShift GitOps.

  • Deployment workflow

    Your CertificatePolicy, ConfigurationPolicy, OperatorPolicy policies must be in the open-cluster-management-policies namespace or the managed cluster namespace. Policies in other namespaces are ignored and do not receive a status. If you are using a Red Hat OpenShift GitOps version with an Argo CD version earlier than 2.13, you must configure Red Hat Advanced Cluster Management for Kubernetes policy health checks.

The OpenShift GitOps service account must have permission to manage Red Hat Advanced Cluster Management for Kubernetes policies. Deploy policies with OpenShift GitOps and view the policies from the Discovered policies table of the Governance dashboard. The policies are grouped by the policy name and kind fields.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top