2019-01-25 06:22:37 +01:00
|
|
|
// Copyright Project Harbor 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 adapter
|
|
|
|
|
|
|
|
import (
|
|
|
|
"errors"
|
|
|
|
"fmt"
|
2019-07-01 12:33:55 +02:00
|
|
|
"io"
|
2019-01-25 06:22:37 +01:00
|
|
|
|
2019-07-01 12:33:55 +02:00
|
|
|
"github.com/docker/distribution"
|
|
|
|
"github.com/goharbor/harbor/src/replication/filter"
|
2019-04-12 16:38:56 +02:00
|
|
|
"github.com/goharbor/harbor/src/replication/model"
|
2019-01-25 06:22:37 +01:00
|
|
|
)
|
|
|
|
|
2019-07-01 12:33:55 +02:00
|
|
|
// const definition
|
|
|
|
const (
|
|
|
|
UserAgentReplication = "harbor-replication-service"
|
2019-07-31 13:01:44 +02:00
|
|
|
MaxConcurrency = 100
|
2019-07-01 12:33:55 +02:00
|
|
|
)
|
|
|
|
|
2019-03-23 00:26:10 +01:00
|
|
|
var registry = map[model.RegistryType]Factory{}
|
2019-10-22 11:53:53 +02:00
|
|
|
var adapterInfoMap = map[model.RegistryType]*model.AdapterPattern{}
|
2019-01-25 06:22:37 +01:00
|
|
|
|
2019-03-04 11:33:20 +01:00
|
|
|
// Factory creates a specific Adapter according to the params
|
2019-10-22 11:53:53 +02:00
|
|
|
type Factory interface {
|
|
|
|
Create(*model.Registry) (Adapter, error)
|
|
|
|
AdapterPattern() *model.AdapterPattern
|
|
|
|
}
|
2019-03-04 11:33:20 +01:00
|
|
|
|
2019-01-25 06:22:37 +01:00
|
|
|
// Adapter interface defines the capabilities of registry
|
|
|
|
type Adapter interface {
|
2019-03-23 00:26:10 +01:00
|
|
|
// Info return the information of this adapter
|
|
|
|
Info() (*model.RegistryInfo, error)
|
2019-04-16 10:40:31 +02:00
|
|
|
// PrepareForPush does the prepare work that needed for pushing/uploading the resources
|
2019-04-10 13:37:33 +02:00
|
|
|
// eg: create the namespace or repository
|
2019-04-16 10:40:31 +02:00
|
|
|
PrepareForPush([]*model.Resource) error
|
2019-04-06 12:05:38 +02:00
|
|
|
// HealthCheck checks health status of registry
|
|
|
|
HealthCheck() (model.HealthStatus, error)
|
2019-01-25 06:22:37 +01:00
|
|
|
}
|
|
|
|
|
2019-07-01 12:33:55 +02:00
|
|
|
// ImageRegistry defines the capabilities that an image registry should have
|
|
|
|
type ImageRegistry interface {
|
|
|
|
FetchImages(filters []*model.Filter) ([]*model.Resource, error)
|
|
|
|
ManifestExist(repository, reference string) (exist bool, digest string, err error)
|
|
|
|
PullManifest(repository, reference string, accepttedMediaTypes []string) (manifest distribution.Manifest, digest string, err error)
|
|
|
|
PushManifest(repository, reference, mediaType string, payload []byte) error
|
|
|
|
// the "reference" can be "tag" or "digest", the function needs to handle both
|
|
|
|
DeleteManifest(repository, reference string) error
|
|
|
|
BlobExist(repository, digest string) (exist bool, err error)
|
|
|
|
PullBlob(repository, digest string) (size int64, blob io.ReadCloser, err error)
|
|
|
|
PushBlob(repository, digest string, size int64, blob io.Reader) error
|
|
|
|
}
|
|
|
|
|
|
|
|
// ChartRegistry defines the capabilities that a chart registry should have
|
|
|
|
type ChartRegistry interface {
|
|
|
|
FetchCharts(filters []*model.Filter) ([]*model.Resource, error)
|
|
|
|
ChartExist(name, version string) (bool, error)
|
|
|
|
DownloadChart(name, version string) (io.ReadCloser, error)
|
|
|
|
UploadChart(name, version string, chart io.Reader) error
|
|
|
|
DeleteChart(name, version string) error
|
|
|
|
}
|
|
|
|
|
|
|
|
// Repository defines an repository object, it can be image repository, chart repository and etc.
|
|
|
|
type Repository struct {
|
|
|
|
ResourceType string `json:"resource_type"`
|
|
|
|
Name string `json:"name"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetName returns the name
|
|
|
|
func (r *Repository) GetName() string {
|
|
|
|
return r.Name
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetFilterableType returns the filterable type
|
|
|
|
func (r *Repository) GetFilterableType() filter.FilterableType {
|
|
|
|
return filter.FilterableTypeRepository
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetResourceType returns the resource type
|
|
|
|
func (r *Repository) GetResourceType() string {
|
|
|
|
return r.ResourceType
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetLabels returns the labels
|
|
|
|
func (r *Repository) GetLabels() []string {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// VTag defines an vTag object, it can be image tag, chart version and etc.
|
|
|
|
type VTag struct {
|
|
|
|
ResourceType string `json:"resource_type"`
|
|
|
|
Name string `json:"name"`
|
|
|
|
Labels []string `json:"labels"`
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetFilterableType returns the filterable type
|
|
|
|
func (v *VTag) GetFilterableType() filter.FilterableType {
|
|
|
|
return filter.FilterableTypeVTag
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetResourceType returns the resource type
|
|
|
|
func (v *VTag) GetResourceType() string {
|
|
|
|
return v.ResourceType
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetName returns the name
|
|
|
|
func (v *VTag) GetName() string {
|
|
|
|
return v.Name
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetLabels returns the labels
|
|
|
|
func (v *VTag) GetLabels() []string {
|
|
|
|
return v.Labels
|
|
|
|
}
|
|
|
|
|
2019-01-25 06:22:37 +01:00
|
|
|
// RegisterFactory registers one adapter factory to the registry
|
2019-10-22 11:53:53 +02:00
|
|
|
func RegisterFactory(t model.RegistryType, factory Factory) error {
|
2019-03-23 00:26:10 +01:00
|
|
|
if len(t) == 0 {
|
2019-03-04 11:33:20 +01:00
|
|
|
return errors.New("invalid registry type")
|
|
|
|
}
|
2019-01-25 06:22:37 +01:00
|
|
|
if factory == nil {
|
|
|
|
return errors.New("empty adapter factory")
|
|
|
|
}
|
2019-03-23 00:26:10 +01:00
|
|
|
|
|
|
|
if _, exist := registry[t]; exist {
|
|
|
|
return fmt.Errorf("adapter factory for %s already exists", t)
|
2019-01-25 06:22:37 +01:00
|
|
|
}
|
2019-03-23 00:26:10 +01:00
|
|
|
registry[t] = factory
|
2019-10-22 11:53:53 +02:00
|
|
|
adapterInfo := factory.AdapterPattern()
|
2019-07-01 04:46:44 +02:00
|
|
|
if adapterInfo != nil {
|
|
|
|
adapterInfoMap[t] = adapterInfo
|
|
|
|
}
|
2019-01-25 06:22:37 +01:00
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetFactory gets the adapter factory by the specified name
|
2019-03-04 11:33:20 +01:00
|
|
|
func GetFactory(t model.RegistryType) (Factory, error) {
|
2019-03-23 00:26:10 +01:00
|
|
|
factory, exist := registry[t]
|
|
|
|
if !exist {
|
|
|
|
return nil, fmt.Errorf("adapter factory for %s not found", t)
|
2019-01-25 06:22:37 +01:00
|
|
|
}
|
2019-03-23 00:26:10 +01:00
|
|
|
return factory, nil
|
2019-03-04 11:33:20 +01:00
|
|
|
}
|
|
|
|
|
2019-04-06 12:05:38 +02:00
|
|
|
// HasFactory checks whether there is given type adapter factory
|
|
|
|
func HasFactory(t model.RegistryType) bool {
|
|
|
|
_, ok := registry[t]
|
|
|
|
return ok
|
|
|
|
}
|
|
|
|
|
2019-03-23 00:26:10 +01:00
|
|
|
// ListRegisteredAdapterTypes lists the registered Adapter type
|
|
|
|
func ListRegisteredAdapterTypes() []model.RegistryType {
|
|
|
|
types := []model.RegistryType{}
|
|
|
|
for t := range registry {
|
|
|
|
types = append(types, t)
|
2019-03-04 11:33:20 +01:00
|
|
|
}
|
2019-03-23 00:26:10 +01:00
|
|
|
return types
|
2019-01-25 06:22:37 +01:00
|
|
|
}
|
2019-07-01 04:46:44 +02:00
|
|
|
|
|
|
|
// ListAdapterInfos list the adapter infos
|
2019-10-22 11:53:53 +02:00
|
|
|
func ListAdapterInfos() map[model.RegistryType]*model.AdapterPattern {
|
2019-07-01 04:46:44 +02:00
|
|
|
return adapterInfoMap
|
|
|
|
}
|