init

2026-04-08 20:22:14 +07:00
commit 34fbdd1412
96 changed files with 5321 additions and 0 deletions
--- a/01-introduction/03-policy-structure/annotated-policy.yaml
+++ b/01-introduction/03-policy-structure/annotated-policy.yaml
@@ -0,0 +1,68 @@
+apiVersion: kyverno.io/v1
+kind: ClusterPolicy              # ClusterPolicy = все namespace, Policy = один namespace
+metadata:
+  name: annotated-example-policy
+  annotations:
+    # Мета-информация для Kyverno UI и PolicyReport
+    policies.kyverno.io/title: "Пример структуры политики"
+    policies.kyverno.io/category: "Best Practices"
+    policies.kyverno.io/severity: medium          # critical | high | medium | low
+    policies.kyverno.io/subject: "Pod"
+    policies.kyverno.io/description: >-
+      Пример политики с подробными комментариями.
+      Требует наличия лейбла app у всех Podов.
+    policies.kyverno.io/version: "1.0.0"
+spec:
+  # Enforce = отклонять запросы при нарушении
+  # Audit   = пропускать, но фиксировать в PolicyReport
+  validationFailureAction: Audit
+
+  # true = проверять также уже существующие ресурсы (через background controller)
+  background: true
+
+  rules:
+  - name: require-app-label          # уникальное имя правила внутри политики
+
+    # match: к каким ресурсам применяется правило
+    match:
+      any:                           # ИЛИ: ресурс попадает хотя бы под одно условие
+      - resources:
+          kinds:
+          - Pod
+          namespaces:
+          - default
+          - production
+          - staging
+
+    # exclude: ресурсы-исключения (не будут проверяться)
+    exclude:
+      resources:
+        namespaces:
+        - kube-system
+        - kyverno
+        selector:
+          matchLabels:
+            kyverno.io/skip-validation: "true"
+
+    # preconditions: дополнительные условия применения правила
+    # (match фильтрует по типу, preconditions — по содержимому)
+    preconditions:
+      any:
+      - key: "{{ request.operation }}"
+        operator: In
+        value: ["CREATE", "UPDATE"]  # не проверять DELETE
+
+    # validate: правило проверки
+    validate:
+      # Сообщение об ошибке (поддерживает переменные)
+      message: >-
+        Pod '{{ request.object.metadata.name }}'
+        в namespace '{{ request.object.metadata.namespace }}'
+        должен иметь лейбл 'app'.
+        Добавьте: metadata.labels.app: <имя-приложения>
+
+      # pattern: описание того, как должен выглядеть ресурс
+      pattern:
+        metadata:
+          labels:
+            app: "?*"    # поле должно существовать и быть не пустым