Deckhouse Platform устанавливает CRD, но не удаляет их при отключении модуля. Если вам больше не нужны созданные CRD, удалите их.
Стадия жизненного цикла модуля: General Availability
AuthorizationRule
Scope: Namespaced
Version: v1alpha1
Управляет настройками RBAC и авторизацией в пределах конкретного неймспейса.
Ресурс AuthorizationRule относится к упрощённой ролевой модели. Его права суммируются с правами гранулярной модели.
- объектstatus
Наблюдаемое состояние правила, поддерживается user-authz-controller.
- целочисленныйstatus.bindings
Число биндингов, созданных для правила.
- массив объектовstatus.conditions
Условия правила.
Ready=True— все биндинги правила применены;Ready=Falseс причинойInvalidSpec— правило нельзя отрендерить, биндинги не менялись; с причинойApplyError— API-сервер отклонил запись (в сообщении указаны биндинг и ошибка).- строкаstatus.conditions.lastTransitionTime
Время последнего изменения статуса условия.
- строкаstatus.conditions.message
Подробности статуса.
- целочисленныйstatus.conditions.observedGeneration
Поколение правила, к которому относится условие.
- строкаstatus.conditions.reason
Причина статуса —
BindingsApplied,InvalidSpecилиApplyError. - строкаstatus.conditions.status
Обязательный параметр
Статус условия.
Допустимые значения:
True,False,Unknown - строкаstatus.conditions.type
Обязательный параметр
Тип условия. Контроллер устанавливает
Ready.
- целочисленныйstatus.observedGeneration
Поколение правила, к которому относится статус.
- объектspec
Обязательный параметр
- строкаspec.accessLevel
Уровень доступа:
User— позволяет получать информацию обо всех объектах (включая доступ к журналам подов), но не позволяет заходить в контейнеры, читать секреты и выполнять port-forward;PrivilegedUser— то же самое, что иUser, но позволяет заходить в контейнеры, читать секреты, а также удалять поды (что обеспечивает возможность перезагрузки);Editor— то же самое, что иPrivilegedUser, но предоставляет возможность создавать, изменять и удалять все объекты, которые обычно нужны для прикладных задач;Admin— то же самое, что иEditor, но позволяет создавать и изменять поды, выпускать токены ServiceAccount’ов (serviceaccounts/token), управлять объектамиRole,RoleBindingиAuthorizationRuleи удалять служебные объекты (например,ReplicaSet, challenges и orders группыacme.cert-manager.io).
Допустимые значения:
User,PrivilegedUser,Editor,AdminПример:
accessLevel: PrivilegedUser - булевыйspec.allowScale
Разрешить/запретить масштабировать (выполнять scale) объекты Deployment и StatefulSet.
По умолчанию:
false - булевыйspec.portForwarding
Разрешить/запретить выполнять
port-forward.По умолчанию:
false - массив объектовspec.subjects
Обязательный параметр
Пользователи, группы и ServiceAccount’ы, которым выдаётся уровень доступа.
При использовании совместно с модулем user-authn обратите внимание на следующие нюансы:
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его
email. - При указании группы убедитесь, что необходимые группы допускаются к получению от провайдера, то есть указаны в соответствующем кастомном ресурсе DexProvider.
- строкаspec.subjects.kind
Обязательный параметр
Тип ресурса.
Допустимые значения:
User,Group,ServiceAccountПример:
kind: Group - строкаspec.subjects.name
Обязательный параметр
Имя ресурса.
Пример:
name: some-group-name - строкаspec.subjects.namespace
Namespace для ServiceAccount.
Шаблон:
[a-z0-9]([-a-z0-9]*[a-z0-9])?Длина:
1..63
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его
ClusterAuthorizationRule
Scope: Cluster
- v1
- v1alpha1
Управляет настройками RBAC и авторизацией по неймспейсам.
Настройки определяют, какой уровень доступа назначен пользователю и/или группе.
Ресурс ClusterAuthorizationRule относится к упрощённой ролевой модели. Его права суммируются с правами гранулярной модели.
- объектstatus
Наблюдаемое состояние правила, поддерживается user-authz-controller.
- целочисленныйstatus.bindings
Число биндингов, созданных для правила.
- массив объектовstatus.conditions
Условия правила.
Ready=True— все биндинги правила применены;Ready=Falseс причинойInvalidSpec— правило нельзя отрендерить, биндинги не менялись; с причинойApplyError— API-сервер отклонил запись (в сообщении указаны биндинг и ошибка).- строкаstatus.conditions.lastTransitionTime
Время последнего изменения статуса условия.
- строкаstatus.conditions.message
Подробности статуса.
- целочисленныйstatus.conditions.observedGeneration
Поколение правила, к которому относится условие.
- строкаstatus.conditions.reason
Причина статуса —
BindingsApplied,InvalidSpecилиApplyError. - строкаstatus.conditions.status
Обязательный параметр
Статус условия.
Допустимые значения:
True,False,Unknown - строкаstatus.conditions.type
Обязательный параметр
Тип условия. Контроллер устанавливает
Ready.
- целочисленныйstatus.observedGeneration
Поколение правила, к которому относится статус.
- объектspec
Обязательный параметр
- строкаspec.accessLevel
Уровень доступа:
User— позволяет получать информацию обо всех объектах (включая доступ к журналам подов), но не позволяет заходить в контейнеры, читать секреты и выполнять port-forward;PrivilegedUser— то же самое, что иUser, но позволяет заходить в контейнеры, читать секреты, а также удалять поды (что обеспечивает возможность перезагрузки);Editor— то же самое, что иPrivilegedUser, но предоставляет возможность создавать, изменять и удалять все объекты, которые обычно нужны для прикладных задач;Admin— то же самое, что иEditor, но позволяет создавать и изменять поды, выпускать токены ServiceAccount’ов (serviceaccounts/token), управлять объектамиRole,RoleBindingиAuthorizationRuleи удалять служебные объекты (например,ReplicaSet, challenges и orders группыacme.cert-manager.io);ClusterEditor— то же самое, что иEditor, но позволяет управлять ограниченным набором cluster-wide-объектов для прикладных задач (DaemonSet,StorageClass,CustomResourceDefinition,GatewayClassи объекты, которые модули добавляют на этот уровень, напримерKeepalivedInstance). Роль для работы оператора кластера;-
ClusterAdmin— то же самое, что иClusterEditor+Admin, но позволяет управлять служебными cluster-wide-объектами (неймспейсы, квоты,NetworkPolicy, подресурсы узлов для proxy,ClusterAuthorizationRule,ClusterRoleиClusterRoleBinding). Роль для работы администратора кластера.Внимание.
ClusterAdminможет создавать объекты ClusterAuthorizationRule с уровнем не вышеClusterAdminи объекты ClusterRoleBinding только на роли, права которых у него уже есть. SuperAdmin— разрешены любые действия с любыми объектами, при этом ограниченияnamespaceSelectorиlimitNamespaces(см. ниже) продолжат работать.
Допустимые значения:
User,PrivilegedUser,Editor,Admin,ClusterEditor,ClusterAdmin,SuperAdminПример:
accessLevel: PrivilegedUser - массив объектовspec.additionalRoles
Дополнительные роли, которые необходимо выдать для заданных
subjects.Вместо него используйте параметр
accessLevel: этот параметр — для исключительных случаев.Пример:
additionalRoles: - apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: cluster-admin- строкаspec.additionalRoles.apiGroup
Обязательный параметр
API-группа роли. Поддерживается только
rbac.authorization.k8s.io.Пример:
apiGroup: rbac.authorization.k8s.io - строкаspec.additionalRoles.kind
Обязательный параметр
Kind роли.
Допустимые значения:
ClusterRoleПример:
kind: ClusterRole - строкаspec.additionalRoles.name
Обязательный параметр
Название роли.
Пример:
name: cluster-admin
- булевыйspec.allowAccessToSystemNamespacesПараметр устарел
Доступно в редакциях: BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Разрешить пользователю доступ в системные неймспейсы (
kube-*,d8-*,default).Требует параметра enableMultiTenancy. Пока он выключен, правило с этим полем отклоняется, а правило, в котором поле уже задано, применяется без ограничений по неймспейсам — во всех неймспейсах кластера.
Ограничения правила по неймспейсам применяет вебхук авторизации, поэтому они не действуют на субъекты, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-. Для них уровень доступа правила действует во всех неймспейсах.Параметр устарел, используйте вместо него параметр namespaceSelector.
По умолчанию:
false - булевыйspec.allowScale
Разрешить/запретить масштабировать (выполнять scale) объекты Deployment и StatefulSet.
По умолчанию:
false - массив строкspec.limitNamespacesПараметр устарел
Доступно в редакциях: BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Список разрешённых неймспейсов в формате регулярных выражений.
Каждый шаблон должен совпадать с именем неймспейса целиком:
teamне подходит дляteam-2. Шаблон, который не является корректным регулярным выражением RE2, отклоняется при записи правила. Если проверка его не распознала, шаблон игнорируется, правило открывает меньше неймспейсов и срабатывает алертD8UserAuthzWebhookRulesQuarantined.Политика:
- Если список указан, разрешаем доступ только по нему.
- Если список не указан, считаем, что разрешено всё, кроме системных неймспейсов (см. поле
allowAccessToSystemNamespaces).
Требует параметра enableMultiTenancy. Пока он выключен, правило с этим полем отклоняется, а правило, в котором поле уже задано, применяется без ограничений по неймспейсам — во всех неймспейсах кластера.
Ограничения правила по неймспейсам применяет вебхук авторизации, поэтому они не действуют на субъекты, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-. Для них уровень доступа правила действует во всех неймспейсах.Параметр устарел, используйте вместо него параметр namespaceSelector.
Пример:
limitNamespaces: production-.*- строкаЭлемент массива
- объектspec.namespaceSelector
Доступно в редакциях: BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Определяет доступные неймспейсы на основе значений, указанных в параметре
namespaceSelector.labelSelector.Если параметр
namespaceSelectorуказан, значения параметровlimitNamespacesиallowAccessToSystemNamespacesигнорируются. Таким образом, будут доступны либо все неймспейсы с лейблами, подпадающими под указанные в параметреnamespaceSelector.labelSelectorусловия (включая системные неймспейсы), либо все неймспейсы (включая системные), если указан параметрnamespaceSelector.matchAny.Если параметр
namespaceSelectorне указан, набор доступных неймспейсов определяется значением параметровlimitNamespacesиallowAccessToSystemNamespaces. Если не указан ни один из параметровnamespaceSelector,limitNamespacesиallowAccessToSystemNamespaces, будут доступны все неймспейсы, за исключением системных (kube-*,d8-*,default).Требует параметра enableMultiTenancy. Пока он выключен, правило с этим полем отклоняется, а правило, в котором поле уже задано, применяется без ограничений по неймспейсам — во всех неймспейсах кластера.
Ограничения правила по неймспейсам применяет вебхук авторизации, поэтому они не действуют на субъекты, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-. Для них уровень доступа правила действует во всех неймспейсах.- объектspec.namespaceSelector.labelSelector
Фильтр по лейблам неймспейсов.
Не может использоваться совместно с параметром
matchAny.Если указаны одновременно
matchExpressionsиmatchLabels, учитываются оба фильтра (AND). Если указано несколько условийmatchExpressions, должны выполняться все.- массив объектовspec.namespaceSelector.labelSelector.matchExpressions
Список фильтров на основе выражений.
Пример:
matchExpressions: - key: tier operator: In values: - production - staging - key: tier operator: NotIn values: - production- строкаspec.namespaceSelector.labelSelector.matchExpressions.key
Имя лейбла.
- строкаspec.namespaceSelector.labelSelector.matchExpressions.operator
Оператор сравнения.
Допустимые значения:
In,NotIn,Exists,DoesNotExist - массив строкspec.namespaceSelector.labelSelector.matchExpressions.values
Значение лейбла.
- строкаЭлемент массива
Шаблон:
[a-z0-9]([-a-z0-9]*[a-z0-9])?Длина:
1..63
- объектspec.namespaceSelector.labelSelector.matchLabels
Набор лейблов, которые должны быть у неймспейса.
Пример:
matchLabels: foo: bar baz: who
- булевыйspec.namespaceSelector.matchAny
Разрешает доступ ко всем неймспейсам в кластере, включая системные.
Не может использоваться совместно с параметром
labelSelector.Так как с помощью параметра
labelSelectorможно предоставить доступ только к определённому перечню неймспейсов, параметрmatchAnyнеобходим в случаях, когда нужно предоставить доступ ко всем неймспейсам.Допустимые значения:
true
- булевыйspec.portForwarding
Разрешить/запретить выполнять
port-forward.По умолчанию:
false - массив объектовspec.subjects
Обязательный параметр
Пользователи, группы и ServiceAccount’ы, которым выдаётся уровень доступа.
При использовании совместно с модулем user-authn обратите внимание на следующие нюансы:
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его
email. - При указании группы убедитесь, что необходимые группы допускаются к получению от провайдера, то есть указаны в соответствующем кастомном ресурсе DexProvider.
- строкаspec.subjects.kind
Обязательный параметр
Тип ресурса.
Допустимые значения:
User,Group,ServiceAccountПример:
kind: Group - строкаspec.subjects.name
Обязательный параметр
Имя ресурса.
Пример:
name: some-group-name - строкаspec.subjects.namespace
Неймспейс ServiceAccount. Ограничения правила по неймспейсам не действуют на ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-: их вебхук авторизации не проверяет.Шаблон:
[a-z0-9]([-a-z0-9]*[a-z0-9])?Длина:
1..63
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его
Устаревший ресурс. Поддержка ресурса может быть исключена в следующих версиях.
Cluster-wide-ресурс для управления настройками RBAC и авторизацией.
Ресурс ClusterAuthorizationRule относится к упрощённой ролевой модели. Его права суммируются с правами гранулярной модели.
- объектstatus
Наблюдаемое состояние правила, поддерживается user-authz-controller.
- целочисленныйstatus.bindings
Число биндингов, созданных для правила.
- массив объектовstatus.conditions
Условия правила.
Ready=True— все биндинги правила применены;Ready=Falseс причинойInvalidSpec— правило нельзя отрендерить, биндинги не менялись; с причинойApplyError— API-сервер отклонил запись (в сообщении указаны биндинг и ошибка).- строкаstatus.conditions.lastTransitionTime
Время последнего изменения статуса условия.
- строкаstatus.conditions.message
Подробности статуса.
- целочисленныйstatus.conditions.observedGeneration
Поколение правила, к которому относится условие.
- строкаstatus.conditions.reason
Причина статуса —
BindingsApplied,InvalidSpecилиApplyError. - строкаstatus.conditions.status
Обязательный параметр
Статус условия.
Допустимые значения:
True,False,Unknown - строкаstatus.conditions.type
Обязательный параметр
Тип условия. Контроллер устанавливает
Ready.
- целочисленныйstatus.observedGeneration
Поколение правила, к которому относится статус.
- объектspec
Обязательный параметр
- строкаspec.accessLevel
Уровень доступа:
User— позволяет получать информацию обо всех объектах (включая доступ к журналам подов), но не позволяет заходить в контейнеры, читать секреты и выполнять port-forward;PrivilegedUser— то же самое, что иUser, но позволяет заходить в контейнеры, читать секреты, а также удалять поды (что обеспечивает возможность перезагрузки);Editor— то же самое, что иPrivilegedUser, но предоставляет возможность создавать, изменять и удалять все объекты, которые обычно нужны для прикладных задач;Admin— то же самое, что иEditor, но позволяет создавать и изменять поды, выпускать токены ServiceAccount’ов (serviceaccounts/token), управлять объектамиRole,RoleBindingиAuthorizationRuleи удалять служебные объекты (например,ReplicaSet, challenges и orders группыacme.cert-manager.io);ClusterEditor— то же самое, что иEditor, но позволяет управлять ограниченным набором cluster-wide-объектов для прикладных задач (DaemonSet,StorageClass,CustomResourceDefinition,GatewayClassи объекты, которые модули добавляют на этот уровень, напримерKeepalivedInstance). Роль для работы оператора кластера;-
ClusterAdmin— то же самое, что иClusterEditor+Admin, но позволяет управлять служебными cluster-wide-объектами (неймспейсы, квоты,NetworkPolicy, подресурсы узлов для proxy,ClusterAuthorizationRule,ClusterRoleиClusterRoleBinding). Роль для работы администратора кластера.Внимание.
ClusterAdminможет создавать объекты ClusterAuthorizationRule с уровнем не вышеClusterAdminи объекты ClusterRoleBinding только на роли, права которых у него уже есть. SuperAdmin— разрешены любые действия с любыми объектами, при этом ограниченияlimitNamespaces(см. ниже) продолжат работать.
Допустимые значения:
User,PrivilegedUser,Editor,Admin,ClusterEditor,ClusterAdmin,SuperAdminПример:
accessLevel: PrivilegedUser - массив объектовspec.additionalRoles
Дополнительные роли, которые необходимо выдать для заданных
subjects.Вместо него используйте параметр
accessLevel: этот параметр — для исключительных случаев.Пример:
additionalRoles: - apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: cluster-admin- строкаspec.additionalRoles.apiGroup
Обязательный параметр
API-группа роли. Поддерживается только
rbac.authorization.k8s.io.Пример:
apiGroup: rbac.authorization.k8s.io - строкаspec.additionalRoles.kind
Обязательный параметр
Kind роли.
Допустимые значения:
ClusterRoleПример:
kind: ClusterRole - строкаspec.additionalRoles.name
Обязательный параметр
Название роли.
Пример:
name: cluster-admin
- булевыйspec.allowAccessToSystemNamespacesПараметр устарел
Доступно в редакциях: BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Разрешить пользователю доступ в системные неймспейсы (
kube-*,d8-*,default).Требует параметра enableMultiTenancy. Пока он выключен, правило с этим полем отклоняется, а правило, в котором поле уже задано, применяется без ограничений по неймспейсам — во всех неймспейсах кластера.
Ограничения правила по неймспейсам применяет вебхук авторизации, поэтому они не действуют на субъекты, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-. Для них уровень доступа правила действует во всех неймспейсах.Параметр устарел, используйте вместо него параметр namespaceSelector (версия
v1ресурса).По умолчанию:
false - булевыйspec.allowScale
Разрешить/запретить масштабировать (выполнять scale) объекты Deployment и StatefulSet.
По умолчанию:
false - массив строкspec.limitNamespacesПараметр устарел
Доступно в редакциях: BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Список разрешённых неймспейсов в формате регулярных выражений.
Каждый шаблон должен совпадать с именем неймспейса целиком:
teamне подходит дляteam-2. Шаблон, который не является корректным регулярным выражением RE2, отклоняется при записи правила. Если проверка его не распознала, шаблон игнорируется, правило открывает меньше неймспейсов и срабатывает алертD8UserAuthzWebhookRulesQuarantined.Политика:
- Если список указан, разрешаем доступ только по нему.
- Если список не указан, считаем, что разрешено всё, кроме системных неймспейсов (см. поле
allowAccessToSystemNamespaces).
Требует параметра enableMultiTenancy. Пока он выключен, правило с этим полем отклоняется, а правило, в котором поле уже задано, применяется без ограничений по неймспейсам — во всех неймспейсах кластера.
Ограничения правила по неймспейсам применяет вебхук авторизации, поэтому они не действуют на субъекты, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-. Для них уровень доступа правила действует во всех неймспейсах.Параметр устарел, используйте вместо него параметр namespaceSelector (версия
v1ресурса).Пример:
limitNamespaces: production-.*- строкаЭлемент массива
- булевыйspec.portForwarding
Разрешить/запретить выполнять
port-forward.По умолчанию:
false - массив объектовspec.subjects
Обязательный параметр
Пользователи, группы и ServiceAccount’ы, которым выдаётся уровень доступа.
При использовании совместно с модулем user-authn обратите внимание на следующие нюансы:
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его
email. - При указании группы убедитесь, что необходимые группы допускаются к получению от провайдера, то есть указаны в соответствующем кастомном ресурсе DexProvider.
- строкаspec.subjects.kind
Обязательный параметр
Тип ресурса.
Допустимые значения:
User,Group,ServiceAccountПример:
kind: Group - строкаspec.subjects.name
Обязательный параметр
Имя ресурса.
Пример:
name: some-group-name - строкаspec.subjects.namespace
Неймспейс ServiceAccount. Ограничения правила по неймспейсам не действуют на ServiceAccount’ы неймспейса
kube-systemи неймспейсов, имена которых начинаются сd8-: их вебхук авторизации не проверяет.Шаблон:
[a-z0-9]([-a-z0-9]*[a-z0-9])?Длина:
1..63
- Для выдачи прав конкретному пользователю в качестве имени необходимо указывать его