backend

package
v0.1.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 26, 2019 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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.

Copyright (c) 2016-2019 Uber Technologies, Inc.

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

View Source
const (
	DefaultPartSize    int64             = int64(64 * memsize.MB)
	DefaultBufferGuard datasize.ByteSize = 10 * datasize.MB
	DefaultConcurrency int               = 10
	DefaultListMaxKeys int               = 250
)
View Source
const NoopNamespace = "__noop__"

NoopNamespace is a special namespace which always returns a NoopClient.

Variables

View Source
var (
	ErrNamespaceNotFound = errors.New("no matches for namespace")
)

Manager errors.

Functions

func Register

func Register(name string, factory ClientFactory)

Register registers new Factory with corresponding backend client name.

Types

type Auth

type Auth map[string]AuthConfig

Auth defines auth credentials for corresponding namespaces. It has to be different due to langley secrets overlay structure.

type AuthConfig

type AuthConfig map[string]interface{}

AuthConfig defines the union of authentication credentials for all type of remote backends.

type BandwidthWatcher

type BandwidthWatcher struct {
	// contains filtered or unexported fields
}

BandwidthWatcher is a hashring.Watcher which adjusts bandwidth on throttled backends when hashring membership changes.

func NewBandwidthWatcher

func NewBandwidthWatcher(manager *Manager) *BandwidthWatcher

NewBandwidthWatcher creates a new BandwidthWatcher for manager.

func (*BandwidthWatcher) Notify

func (w *BandwidthWatcher) Notify(latest stringset.Set)

Notify splits bandwidth across the size of latest.

type Client

type Client interface {
	// Stat returns blob info for name. All implementations should return
	// backenderrors.ErrBlobNotFound when the blob was not found.
	//
	// Stat is useful when we need to quickly know if a blob exists (and maybe
	// some basic information about it), without downloading the entire blob,
	// which may be very large.
	Stat(namespace, name string) (*core.BlobInfo, error)

	// Upload uploads src into name.
	Upload(namespace, name string, src io.Reader) error

	// Download downloads name into dst. All implementations should return
	// backenderrors.ErrBlobNotFound when the blob was not found.
	Download(namespace, name string, dst io.Writer) error

	// List lists entries whose names start with prefix.
	List(prefix string, opts ...ListOption) (*ListResult, error)
}

Client defines an interface for accessing blobs on a remote storage backend.

Implementations of Client must be thread-safe, since they are cached and used concurrently by Manager.

type ClientFactory

type ClientFactory interface {
	Create(config interface{}, authConfig interface{}) (Client, error)
}

ClientFactory creates backend client given name.

type Config

type Config struct {
	Namespace string                 `yaml:"namespace"`
	Backend   map[string]interface{} `yaml:"backend"`

	// If enabled, throttles upload / download bandwidth.
	Bandwidth bandwidth.Config `yaml:"bandwidth"`
}

Config defines the union of configuration for all backends. Only one is allowed for each config file.

type ListOption added in v0.1.3

type ListOption func(*ListOptions)

ListOption is used to configure list calls via variadic functional options.

func ListWithContinuationToken added in v0.1.3

func ListWithContinuationToken(token string) ListOption

ListWithContinuationToken configures the list command return results starting at the continuation token if pagination is enabled.

func ListWithMaxKeys added in v0.1.3

func ListWithMaxKeys(max int) ListOption

ListWithMaxKeys configures the list command to return a max number of keys if pagination is enabled.

func ListWithPagination added in v0.1.3

func ListWithPagination() ListOption

ListWithPagination configures the list command to use pagination.

type ListOptions added in v0.1.3

type ListOptions struct {
	Paginated         bool
	MaxKeys           int
	ContinuationToken string
}

ListOptions defines the options which can be specified when listing names. It is used to enable pagination in list requests.

func DefaultListOptions added in v0.1.3

func DefaultListOptions() *ListOptions

DefaultListOptions defines the defaults for list operations.

type ListResult added in v0.1.3

type ListResult struct {
	Names             []string
	ContinuationToken string
}

ListResult defines the response from a client list operation. The names of the entries found will always be populated, and the continuation token will only be populated if pagination was enabled and there are remaining entries to list.

type Manager

type Manager struct {
	// contains filtered or unexported fields
}

Manager manages backend clients for namespace regular expressions.

func ManagerFixture

func ManagerFixture() *Manager

ManagerFixture returns a Manager with no clients for testing purposes.

func NewManager

func NewManager(configs []Config, auth AuthConfig) (*Manager, error)

NewManager creates a new backend Manager.

func (*Manager) AdjustBandwidth

func (m *Manager) AdjustBandwidth(denominator int) error

AdjustBandwidth adjusts bandwidth limits across all throttled clients to the originally configured bandwidth divided by denominator.

func (*Manager) GetClient

func (m *Manager) GetClient(namespace string) (Client, error)

GetClient matches namespace to the configured Client. Returns ErrNamespaceNotFound if no clients match namespace.

func (*Manager) Register

func (m *Manager) Register(namespace string, c Client) error

Register dynamically registers a namespace with a provided client. Register should be primarily used for testing purposes -- normally, namespaces should be statically configured and provided upon construction of the Manager.

type NoopClient

type NoopClient struct{}

NoopClient is a special Client whose uploads always succeeds and whose blob lookups always 404. It is useful for users who want to operate on blobs that will be temporarily stored in the origin cluster and not backed up in remote storage.

func (NoopClient) Download

func (c NoopClient) Download(namespace, name string, dst io.Writer) error

Download always returns ErrBlobNotFound.

func (NoopClient) List

func (c NoopClient) List(prefix string, opts ...ListOption) (*ListResult, error)

List always returns nil.

func (NoopClient) Stat

func (c NoopClient) Stat(namespace, name string) (*core.BlobInfo, error)

Stat always returns ErrBlobNotFound.

func (NoopClient) Upload

func (c NoopClient) Upload(namespace, name string, src io.Reader) error

Upload always returns nil.

type ThrottledClient

type ThrottledClient struct {
	Client
	// contains filtered or unexported fields
}

ThrottledClient is a backend client with speed limit.

func (*ThrottledClient) Download

func (c *ThrottledClient) Download(namespace, name string, dst io.Writer) error

Download downloads name into dst.

func (*ThrottledClient) EgressLimit

func (c *ThrottledClient) EgressLimit() int64

EgressLimit returns egress limit.

func (*ThrottledClient) IngressLimit

func (c *ThrottledClient) IngressLimit() int64

IngressLimit returns ingress limit.

func (*ThrottledClient) Upload

func (c *ThrottledClient) Upload(namespace, name string, src io.Reader) error

Upload uploads src into name.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL