mirror of https://github.com/k3s-io/k3s
173 lines
8.0 KiB
Go
173 lines
8.0 KiB
Go
/*
|
|
Copyright 2014 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package admission
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
|
|
"k8s.io/apimachinery/pkg/runtime"
|
|
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
auditinternal "k8s.io/apiserver/pkg/apis/audit"
|
|
"k8s.io/apiserver/pkg/authentication/user"
|
|
)
|
|
|
|
// Attributes is an interface used by AdmissionController to get information about a request
|
|
// that is used to make an admission decision.
|
|
type Attributes interface {
|
|
// GetName returns the name of the object as presented in the request. On a CREATE operation, the client
|
|
// may omit name and rely on the server to generate the name. If that is the case, this method will return
|
|
// the empty string
|
|
GetName() string
|
|
// GetNamespace is the namespace associated with the request (if any)
|
|
GetNamespace() string
|
|
// GetResource is the name of the resource being requested. This is not the kind. For example: pods
|
|
GetResource() schema.GroupVersionResource
|
|
// GetSubresource is the name of the subresource being requested. This is a different resource, scoped to the parent resource, but it may have a different kind.
|
|
// For instance, /pods has the resource "pods" and the kind "Pod", while /pods/foo/status has the resource "pods", the sub resource "status", and the kind "Pod"
|
|
// (because status operates on pods). The binding resource for a pod though may be /pods/foo/binding, which has resource "pods", subresource "binding", and kind "Binding".
|
|
GetSubresource() string
|
|
// GetOperation is the operation being performed
|
|
GetOperation() Operation
|
|
// GetOperationOptions is the options for the operation being performed
|
|
GetOperationOptions() runtime.Object
|
|
// IsDryRun indicates that modifications will definitely not be persisted for this request. This is to prevent
|
|
// admission controllers with side effects and a method of reconciliation from being overwhelmed.
|
|
// However, a value of false for this does not mean that the modification will be persisted, because it
|
|
// could still be rejected by a subsequent validation step.
|
|
IsDryRun() bool
|
|
// GetObject is the object from the incoming request prior to default values being applied
|
|
GetObject() runtime.Object
|
|
// GetOldObject is the existing object. Only populated for UPDATE requests.
|
|
GetOldObject() runtime.Object
|
|
// GetKind is the type of object being manipulated. For example: Pod
|
|
GetKind() schema.GroupVersionKind
|
|
// GetUserInfo is information about the requesting user
|
|
GetUserInfo() user.Info
|
|
|
|
// AddAnnotation sets annotation according to key-value pair. The key should be qualified, e.g., podsecuritypolicy.admission.k8s.io/admit-policy, where
|
|
// "podsecuritypolicy" is the name of the plugin, "admission.k8s.io" is the name of the organization, "admit-policy" is the key name.
|
|
// An error is returned if the format of key is invalid. When trying to overwrite annotation with a new value, an error is returned.
|
|
// Both ValidationInterface and MutationInterface are allowed to add Annotations.
|
|
// By default, an annotation gets logged into audit event if the request's audit level is greater or
|
|
// equal to Metadata.
|
|
AddAnnotation(key, value string) error
|
|
|
|
// AddAnnotationWithLevel sets annotation according to key-value pair with additional intended audit level.
|
|
// An Annotation gets logged into audit event if the request's audit level is greater or equal to the
|
|
// intended audit level.
|
|
AddAnnotationWithLevel(key, value string, level auditinternal.Level) error
|
|
|
|
// GetReinvocationContext tracks the admission request information relevant to the re-invocation policy.
|
|
GetReinvocationContext() ReinvocationContext
|
|
}
|
|
|
|
// ObjectInterfaces is an interface used by AdmissionController to get object interfaces
|
|
// such as Converter or Defaulter. These interfaces are normally coming from Request Scope
|
|
// to handle special cases like CRDs.
|
|
type ObjectInterfaces interface {
|
|
// GetObjectCreater is the ObjectCreator appropriate for the requested object.
|
|
GetObjectCreater() runtime.ObjectCreater
|
|
// GetObjectTyper is the ObjectTyper appropriate for the requested object.
|
|
GetObjectTyper() runtime.ObjectTyper
|
|
// GetObjectDefaulter is the ObjectDefaulter appropriate for the requested object.
|
|
GetObjectDefaulter() runtime.ObjectDefaulter
|
|
// GetObjectConvertor is the ObjectConvertor appropriate for the requested object.
|
|
GetObjectConvertor() runtime.ObjectConvertor
|
|
// GetEquivalentResourceMapper is the EquivalentResourceMapper appropriate for finding equivalent resources and expected kind for the requested object.
|
|
GetEquivalentResourceMapper() runtime.EquivalentResourceMapper
|
|
}
|
|
|
|
// privateAnnotationsGetter is a private interface which allows users to get annotations from Attributes.
|
|
type privateAnnotationsGetter interface {
|
|
getAnnotations(maxLevel auditinternal.Level) map[string]string
|
|
}
|
|
|
|
// AnnotationsGetter allows users to get annotations from Attributes. An alternate Attribute should implement
|
|
// this interface.
|
|
type AnnotationsGetter interface {
|
|
GetAnnotations(maxLevel auditinternal.Level) map[string]string
|
|
}
|
|
|
|
// ReinvocationContext provides access to the admission related state required to implement the re-invocation policy.
|
|
type ReinvocationContext interface {
|
|
// IsReinvoke returns true if the current admission check is a re-invocation.
|
|
IsReinvoke() bool
|
|
// SetIsReinvoke sets the current admission check as a re-invocation.
|
|
SetIsReinvoke()
|
|
// ShouldReinvoke returns true if any plugin has requested a re-invocation.
|
|
ShouldReinvoke() bool
|
|
// SetShouldReinvoke signals that a re-invocation is desired.
|
|
SetShouldReinvoke()
|
|
// AddValue set a value for a plugin name, possibly overriding a previous value.
|
|
SetValue(plugin string, v interface{})
|
|
// Value reads a value for a webhook.
|
|
Value(plugin string) interface{}
|
|
}
|
|
|
|
// Interface is an abstract, pluggable interface for Admission Control decisions.
|
|
type Interface interface {
|
|
// Handles returns true if this admission controller can handle the given operation
|
|
// where operation can be one of CREATE, UPDATE, DELETE, or CONNECT
|
|
Handles(operation Operation) bool
|
|
}
|
|
|
|
type MutationInterface interface {
|
|
Interface
|
|
|
|
// Admit makes an admission decision based on the request attributes.
|
|
// Context is used only for timeout/deadline/cancellation and tracing information.
|
|
Admit(ctx context.Context, a Attributes, o ObjectInterfaces) (err error)
|
|
}
|
|
|
|
// ValidationInterface is an abstract, pluggable interface for Admission Control decisions.
|
|
type ValidationInterface interface {
|
|
Interface
|
|
|
|
// Validate makes an admission decision based on the request attributes. It is NOT allowed to mutate
|
|
// Context is used only for timeout/deadline/cancellation and tracing information.
|
|
Validate(ctx context.Context, a Attributes, o ObjectInterfaces) (err error)
|
|
}
|
|
|
|
// Operation is the type of resource operation being checked for admission control
|
|
type Operation string
|
|
|
|
// Operation constants
|
|
const (
|
|
Create Operation = "CREATE"
|
|
Update Operation = "UPDATE"
|
|
Delete Operation = "DELETE"
|
|
Connect Operation = "CONNECT"
|
|
)
|
|
|
|
// PluginInitializer is used for initialization of shareable resources between admission plugins.
|
|
// After initialization the resources have to be set separately
|
|
type PluginInitializer interface {
|
|
Initialize(plugin Interface)
|
|
}
|
|
|
|
// InitializationValidator holds ValidateInitialization functions, which are responsible for validation of initialized
|
|
// shared resources and should be implemented on admission plugins
|
|
type InitializationValidator interface {
|
|
ValidateInitialization() error
|
|
}
|
|
|
|
// ConfigProvider provides a way to get configuration for an admission plugin based on its name
|
|
type ConfigProvider interface {
|
|
ConfigFor(pluginName string) (io.Reader, error)
|
|
}
|