Documentation ¶
Overview ¶
Copyright 2018 the Velero contributors.
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.
Index ¶
- Constants
- type APIServiceAction
- type AddPVCFromPodAction
- type AddPVFromPVCAction
- type CRDV1PreserveUnknownFieldsAction
- type ChangePVCNodeSelectorAction
- type ChangeStorageClassAction
- type ChosenGroupVersion
- type ClusterRoleBindingAction
- type InitRestoreHookPodAction
- type JobAction
- type PVRestorer
- type PodAction
- type Request
- type ResticRestoreAction
- type Restorer
- type Result
- type RoleBindingAction
- type ServiceAccountAction
- type ServiceAction
- type VolumeSnapshotterGetter
Constants ¶
const KubeAnnBindCompleted = "pv.kubernetes.io/bind-completed"
These annotations are taken from the Kubernetes persistent volume/persistent volume claim controller. They cannot be directly importing because they are part of the kubernetes/kubernetes package, and importing that package is unsupported. Their values are well-known and slow changing. They're duplicated here as constants to provide compile-time checking. Originals can be found in kubernetes/kubernetes/pkg/controller/volume/persistentvolume/util/util.go.
const KubeAnnBoundByController = "pv.kubernetes.io/bound-by-controller"
const KubeAnnDynamicallyProvisioned = "pv.kubernetes.io/provisioned-by"
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type APIServiceAction ¶ added in v1.6.3
type APIServiceAction struct {
// contains filtered or unexported fields
}
func NewAPIServiceAction ¶ added in v1.6.3
func NewAPIServiceAction(logger logrus.FieldLogger) *APIServiceAction
NewAPIServiceAction returns an APIServiceAction which is a RestoreItemAction plugin that will skip the restore of any APIServices which are managed by Kubernetes. This is determined by looking for the "kube-aggregator.kubernetes.io/automanaged" label on the APIService.
func (*APIServiceAction) AppliesTo ¶ added in v1.6.3
func (a *APIServiceAction) AppliesTo() (velero.ResourceSelector, error)
func (*APIServiceAction) Execute ¶ added in v1.6.3
func (a *APIServiceAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type AddPVCFromPodAction ¶ added in v1.0.0
type AddPVCFromPodAction struct {
// contains filtered or unexported fields
}
func NewAddPVCFromPodAction ¶ added in v1.0.0
func NewAddPVCFromPodAction(logger logrus.FieldLogger) *AddPVCFromPodAction
func (*AddPVCFromPodAction) AppliesTo ¶ added in v1.0.0
func (a *AddPVCFromPodAction) AppliesTo() (velero.ResourceSelector, error)
func (*AddPVCFromPodAction) Execute ¶ added in v1.0.0
func (a *AddPVCFromPodAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type AddPVFromPVCAction ¶ added in v1.0.0
type AddPVFromPVCAction struct {
// contains filtered or unexported fields
}
func NewAddPVFromPVCAction ¶ added in v1.0.0
func NewAddPVFromPVCAction(logger logrus.FieldLogger) *AddPVFromPVCAction
func (*AddPVFromPVCAction) AppliesTo ¶ added in v1.0.0
func (a *AddPVFromPVCAction) AppliesTo() (velero.ResourceSelector, error)
func (*AddPVFromPVCAction) Execute ¶ added in v1.0.0
func (a *AddPVFromPVCAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type CRDV1PreserveUnknownFieldsAction ¶ added in v1.3.0
type CRDV1PreserveUnknownFieldsAction struct {
// contains filtered or unexported fields
}
CRDV1PreserveUnknownFieldsAction will take a CRD and inspect it for the API version and the PreserveUnknownFields value. If the API Version is 1 and the PreserveUnknownFields value is True, then the x-preserve-unknown-fields value in the OpenAPIV3 schema will be set to True and PreserveUnknownFields set to False in order to allow Kubernetes 1.16+ servers to accept the object.
func NewCRDV1PreserveUnknownFieldsAction ¶ added in v1.3.0
func NewCRDV1PreserveUnknownFieldsAction(logger logrus.FieldLogger) *CRDV1PreserveUnknownFieldsAction
func (*CRDV1PreserveUnknownFieldsAction) AppliesTo ¶ added in v1.3.0
func (c *CRDV1PreserveUnknownFieldsAction) AppliesTo() (velero.ResourceSelector, error)
func (*CRDV1PreserveUnknownFieldsAction) Execute ¶ added in v1.3.0
func (c *CRDV1PreserveUnknownFieldsAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type ChangePVCNodeSelectorAction ¶ added in v1.4.0
type ChangePVCNodeSelectorAction struct {
// contains filtered or unexported fields
}
ChangePVCNodeSelectorAction updates/reset PVC's node selector if a mapping is found in the plugin's config map.
func NewChangePVCNodeSelectorAction ¶ added in v1.4.0
func NewChangePVCNodeSelectorAction( logger logrus.FieldLogger, configMapClient corev1client.ConfigMapInterface, nodeClient corev1client.NodeInterface, ) *ChangePVCNodeSelectorAction
NewChangePVCNodeSelectorAction is the constructor for ChangePVCNodeSelectorAction.
func (*ChangePVCNodeSelectorAction) AppliesTo ¶ added in v1.4.0
func (p *ChangePVCNodeSelectorAction) AppliesTo() (velero.ResourceSelector, error)
AppliesTo returns the resources that ChangePVCNodeSelectorAction should be run for
func (*ChangePVCNodeSelectorAction) Execute ¶ added in v1.4.0
func (p *ChangePVCNodeSelectorAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
Execute updates the pvc's selected-node annotation:
a) if node mapping found in the config map for the plugin b) if node mentioned in annotation doesn't exist
type ChangeStorageClassAction ¶ added in v1.0.1
type ChangeStorageClassAction struct {
// contains filtered or unexported fields
}
ChangeStorageClassAction updates a PV or PVC's storage class name if a mapping is found in the plugin's config map.
func NewChangeStorageClassAction ¶ added in v1.0.1
func NewChangeStorageClassAction( logger logrus.FieldLogger, configMapClient corev1client.ConfigMapInterface, storageClassClient storagev1client.StorageClassInterface, ) *ChangeStorageClassAction
NewChangeStorageClassAction is the constructor for ChangeStorageClassAction.
func (*ChangeStorageClassAction) AppliesTo ¶ added in v1.0.1
func (a *ChangeStorageClassAction) AppliesTo() (velero.ResourceSelector, error)
AppliesTo returns the resources that ChangeStorageClassAction should be run for.
func (*ChangeStorageClassAction) Execute ¶ added in v1.0.1
func (a *ChangeStorageClassAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
Execute updates the item's spec.storageClassName if a mapping is found in the config map for the plugin.
type ChosenGroupVersion ¶ added in v1.6.0
ChosenGroupVersion is the API Group version that was selected to restore from potentially multiple backed up version enabled by the feature flag APIGroupVersionsFeatureFlag
type ClusterRoleBindingAction ¶ added in v1.2.0
type ClusterRoleBindingAction struct {
// contains filtered or unexported fields
}
ClusterRoleBindingAction handle namespace remappings for role bindings
func NewClusterRoleBindingAction ¶ added in v1.2.0
func NewClusterRoleBindingAction(logger logrus.FieldLogger) *ClusterRoleBindingAction
func (*ClusterRoleBindingAction) AppliesTo ¶ added in v1.2.0
func (a *ClusterRoleBindingAction) AppliesTo() (velero.ResourceSelector, error)
func (*ClusterRoleBindingAction) Execute ¶ added in v1.2.0
func (a *ClusterRoleBindingAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type InitRestoreHookPodAction ¶ added in v1.5.0
type InitRestoreHookPodAction struct {
// contains filtered or unexported fields
}
InitRestoreHookPodAction is a RestoreItemAction plugin applicable to pods that runs restore hooks to add init containers to pods prior to them being restored.
func NewInitRestoreHookPodAction ¶ added in v1.5.0
func NewInitRestoreHookPodAction(logger logrus.FieldLogger) *InitRestoreHookPodAction
NewInitRestoreHookPodAction returns a new InitRestoreHookPodAction.
func (*InitRestoreHookPodAction) AppliesTo ¶ added in v1.5.0
func (a *InitRestoreHookPodAction) AppliesTo() (velero.ResourceSelector, error)
AppliesTo implements the RestoreItemAction plugin interface method.
func (*InitRestoreHookPodAction) Execute ¶ added in v1.5.0
func (a *InitRestoreHookPodAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
Execute implements the RestoreItemAction plugin interface method.
type JobAction ¶ added in v1.0.0
type JobAction struct {
// contains filtered or unexported fields
}
func NewJobAction ¶ added in v0.6.0
func NewJobAction(logger logrus.FieldLogger) *JobAction
func (*JobAction) AppliesTo ¶ added in v1.0.0
func (a *JobAction) AppliesTo() (velero.ResourceSelector, error)
func (*JobAction) Execute ¶ added in v1.0.0
func (a *JobAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type PVRestorer ¶ added in v0.9.0
type PVRestorer interface {
// contains filtered or unexported methods
}
type PodAction ¶ added in v1.0.0
type PodAction struct {
// contains filtered or unexported fields
}
func NewPodAction ¶ added in v0.6.0
func NewPodAction(logger logrus.FieldLogger) *PodAction
func (*PodAction) AppliesTo ¶ added in v1.0.0
func (a *PodAction) AppliesTo() (velero.ResourceSelector, error)
func (*PodAction) Execute ¶ added in v1.0.0
func (a *PodAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type Request ¶ added in v1.0.1
type Request struct { *velerov1api.Restore Log logrus.FieldLogger Backup *velerov1api.Backup PodVolumeBackups []*velerov1api.PodVolumeBackup VolumeSnapshots []*volume.Snapshot BackupReader io.Reader }
type ResticRestoreAction ¶ added in v1.0.0
type ResticRestoreAction struct {
// contains filtered or unexported fields
}
func NewResticRestoreAction ¶ added in v0.9.0
func NewResticRestoreAction(logger logrus.FieldLogger, client corev1client.ConfigMapInterface, podVolumeBackupClient velerov1client.PodVolumeBackupInterface) *ResticRestoreAction
func (*ResticRestoreAction) AppliesTo ¶ added in v1.0.0
func (a *ResticRestoreAction) AppliesTo() (velero.ResourceSelector, error)
func (*ResticRestoreAction) Execute ¶ added in v1.0.0
func (a *ResticRestoreAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type Restorer ¶
type Restorer interface { // Restore restores the backup data from backupReader, returning warnings and errors. Restore(req Request, actions []velero.RestoreItemAction, snapshotLocationLister listers.VolumeSnapshotLocationLister, volumeSnapshotterGetter VolumeSnapshotterGetter, ) (Result, Result) }
Restorer knows how to restore a backup.
func NewKubernetesRestorer ¶
func NewKubernetesRestorer( restoreClient velerov1client.RestoresGetter, discoveryHelper discovery.Helper, dynamicFactory client.DynamicFactory, resourcePriorities []string, namespaceClient corev1.NamespaceInterface, resticRestorerFactory restic.RestorerFactory, resticTimeout time.Duration, resourceTerminatingTimeout time.Duration, logger logrus.FieldLogger, podCommandExecutor podexec.PodCommandExecutor, podGetter cache.Getter, ) (Restorer, error)
NewKubernetesRestorer creates a new kubernetesRestorer.
type Result ¶ added in v1.0.0
type Result struct { // Velero is a slice of messages related to the operation of Velero // itself (for example, messages related to connecting to the // cloud, reading a backup file, etc.) Velero []string `json:"velero,omitempty"` // Cluster is a slice of messages related to restoring cluster- // scoped resources. Cluster []string `json:"cluster,omitempty"` // Namespaces is a map of namespace name to slice of messages // related to restoring namespace-scoped resources. Namespaces map[string][]string `json:"namespaces,omitempty"` }
Result is a collection of messages that were generated during execution of a restore. This will typically store either warning or error messages.
func (*Result) Add ¶ added in v1.3.0
Add appends an error to the provided Result, either within the cluster-scoped list (if ns == "") or within the provided namespace's entry.
func (*Result) AddVeleroError ¶ added in v1.3.0
AddVeleroError appends an error to the provided Result's Velero list.
type RoleBindingAction ¶ added in v1.2.0
type RoleBindingAction struct {
// contains filtered or unexported fields
}
RoleBindingAction handle namespace remappings for role bindings
func NewRoleBindingAction ¶ added in v1.2.0
func NewRoleBindingAction(logger logrus.FieldLogger) *RoleBindingAction
func (*RoleBindingAction) AppliesTo ¶ added in v1.2.0
func (a *RoleBindingAction) AppliesTo() (velero.ResourceSelector, error)
func (*RoleBindingAction) Execute ¶ added in v1.2.0
func (a *RoleBindingAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type ServiceAccountAction ¶ added in v1.0.0
type ServiceAccountAction struct {
// contains filtered or unexported fields
}
func NewServiceAccountAction ¶ added in v0.10.1
func NewServiceAccountAction(logger logrus.FieldLogger) *ServiceAccountAction
func (*ServiceAccountAction) AppliesTo ¶ added in v1.0.0
func (a *ServiceAccountAction) AppliesTo() (velero.ResourceSelector, error)
func (*ServiceAccountAction) Execute ¶ added in v1.0.0
func (a *ServiceAccountAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type ServiceAction ¶ added in v1.0.0
type ServiceAction struct {
// contains filtered or unexported fields
}
func NewServiceAction ¶ added in v0.6.0
func NewServiceAction(logger logrus.FieldLogger) *ServiceAction
func (*ServiceAction) AppliesTo ¶ added in v1.0.0
func (a *ServiceAction) AppliesTo() (velero.ResourceSelector, error)
func (*ServiceAction) Execute ¶ added in v1.0.0
func (a *ServiceAction) Execute(input *velero.RestoreItemActionExecuteInput) (*velero.RestoreItemActionExecuteOutput, error)
type VolumeSnapshotterGetter ¶ added in v1.0.0
type VolumeSnapshotterGetter interface {
GetVolumeSnapshotter(name string) (velero.VolumeSnapshotter, error)
}
Source Files ¶
- add_pv_from_pvc_action.go
- add_pvc_from_pod_action.go
- apiservice_action.go
- change_pvc_node_selector.go
- change_storageclass_action.go
- clusterrolebinding_action.go
- crd_v1_preserve_unknown_fields_action.go
- init_restorehook_pod_action.go
- job_action.go
- merge_service_account.go
- pod_action.go
- prioritize_group_version.go
- pv_restorer.go
- restic_restore_action.go
- restore.go
- result.go
- rolebinding_action.go
- service_account_action.go
- service_action.go