Installing Gatekeeper

Gatekeeper is a customizable policy controller and auditor for Kubernetes. Gatekeeper accepts incoming requests to clusters and validates them in real time to make sure they comply with predefined policies.

Getting startedGetting started

Make sure that the security groups for the Managed Service for Kubernetes cluster and its node groups are configured correctly. If any rule is missing, add it.

Installation using Yandex Cloud MarketplaceInstallation using Yandex Cloud Marketplace

1. Go to the folder page and select Managed Service for Kubernetes.

2. Click the name of the cluster you need and select the Marketplace tab.

3. Under Application available for installation, select Gatekeeper and click Go to install.

4. Configure the application:

   • Namespace: Select a namespace or create a new one.

   • Application name: Specify the app name.

   • Audit interval: Set the interval between audits in seconds. 0 disables audits.

   • Constraint violations limit: Set the maximum number of violations to be logged for each constraint.

   • Only matching resource types: Select this option if you need to validate only those Kubernetes resource types for each constraint that are explicitly specified in the constraint. If no resource types are specified or the option is disabled, all resources will be validated.

   • Create events at audit: Select this option to create a Kubernetes event for each constraint violation detected during the audit, with detailed information about the violation.

   • Events in affected namespace: Select this option if events with violation details should be created in the namespace in which a constraint violation was logged. Only applies if the Create events at audit option is enabled.

     If the Events in affected namespace option is disabled, events will be created in the namespace in which Gatekeeper is installed.

   • Allow external data: Select this option to enable experimental support of external data sources.

5. Click Install.

6. Wait for the application to change its status to Deployed.

Installation using a Helm chartInstallation using a Helm chart

1. Install kubectl and configure it to work with the created cluster.

2. Install Helm v3.8.0 or higher.

3. To install a Helm chart with Gatekeeper, run the following command:

   helm pull oci://cr.yandex/yc-marketplace/gatekeeper \
     --version 3.12.0 \
     --untar && \
   helm install \
     --namespace <namespace> \
     --create-namespace \
     gatekeeper ./gatekeeper/
   

You can redefine optional parameters in the install command using the following key: --set <parameter_name>=<new_value>.

The list of parameters available for redefining and their default values are shown in the table below:

See alsoSee also

• Gatekeeper documentation

• Library of Gatekeeper policies