mirror of https://github.com/goharbor/harbor.git
131 lines
3.8 KiB
Go
131 lines
3.8 KiB
Go
// 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 model
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"github.com/goharbor/harbor/src/lib/errors"
|
|
"sync"
|
|
"time"
|
|
)
|
|
|
|
const (
|
|
// RefNone identifies base reference
|
|
RefNone = "base"
|
|
// RefSoft identifies soft reference
|
|
RefSoft = "soft"
|
|
// RefHard identifies hard reference
|
|
RefHard = "hard"
|
|
)
|
|
|
|
type RefProvider interface {
|
|
// Kind returns reference Kind.
|
|
Kind() string
|
|
}
|
|
|
|
/*
|
|
RefIdentifier
|
|
|
|
Soft reference: The accessory is not tied to the subject manifest.
|
|
Hard reference: The accessory is tied to the subject manifest.
|
|
|
|
Deletion
|
|
1. Soft Reference: If the linkage is Soft Reference, when the subject artifact is removed, the linkage will be removed as well, the accessory artifact becomes an individual artifact.
|
|
2. Hard Reference: If the linkage is Hard Reference, the accessory artifact will be removed together with the subject artifact.
|
|
|
|
Garbage Collection
|
|
1. Soft Reference: If the linkage is Soft Reference, Harbor treats the accessory as normal artifact and will not set it as the GC candidate.
|
|
2. Hard Reference: If the linkage is Hard Reference, Harbor treats the accessory as an extra stuff of the subject artifact. It means, it being tied to the subject artifact and will be GCed whenever the subject artifact is marked and deleted.
|
|
*/
|
|
type RefIdentifier interface {
|
|
// IsSoft indicates that the linkage of artifact and its accessory is soft reference.
|
|
IsSoft() bool
|
|
|
|
// IsHard indicates that the linkage of artifact and its accessory is hard reference.
|
|
IsHard() bool
|
|
}
|
|
|
|
const (
|
|
// TypeNone ...
|
|
TypeNone = "base"
|
|
// TypeCosignSignature ...
|
|
TypeCosignSignature = "signature.cosign"
|
|
)
|
|
|
|
// AccessoryData ...
|
|
type AccessoryData struct {
|
|
ID int64 `json:"id"`
|
|
ArtifactID int64 `json:"artifact_id"`
|
|
SubArtifactID int64 `json:"subject_artifact_id"`
|
|
Type string `json:"type"`
|
|
Size int64 `json:"size"`
|
|
Digest string `json:"digest"`
|
|
CreatTime time.Time `json:"creation_time"`
|
|
Icon string `json:"icon"`
|
|
}
|
|
|
|
// Accessory Independent, but linked to an existing subject artifact, which enabling the extensibility of an OCI artifact
|
|
type Accessory interface {
|
|
RefProvider
|
|
RefIdentifier
|
|
// Display Define whether shows in the artifact list response.
|
|
Display() bool
|
|
GetData() AccessoryData
|
|
}
|
|
|
|
// NewAccessoryFunc takes data to return a Accessory.
|
|
type NewAccessoryFunc func(data AccessoryData) Accessory
|
|
|
|
var (
|
|
factories = map[string]NewAccessoryFunc{}
|
|
lock sync.RWMutex
|
|
)
|
|
|
|
// Register accessory factory for type
|
|
func Register(typ string, factory NewAccessoryFunc) {
|
|
lock.Lock()
|
|
defer lock.Unlock()
|
|
|
|
factories[typ] = factory
|
|
}
|
|
|
|
// New returns accessory instance
|
|
func New(typ string, data AccessoryData) (Accessory, error) {
|
|
lock.Lock()
|
|
defer lock.Unlock()
|
|
|
|
factory, ok := factories[typ]
|
|
if !ok {
|
|
return nil, fmt.Errorf("accessory type %s not support", typ)
|
|
}
|
|
|
|
data.Type = typ
|
|
return factory(data), nil
|
|
}
|
|
|
|
// ToAccessory converts json object to Accessory
|
|
func ToAccessory(acc []byte) (Accessory, error) {
|
|
var data AccessoryData
|
|
if err := json.Unmarshal(acc, &data); err != nil {
|
|
return nil, err
|
|
}
|
|
factory, ok := factories[data.Type]
|
|
if !ok {
|
|
return nil, errors.Errorf("accessory type %s not support", data.Type)
|
|
}
|
|
return factory(data), nil
|
|
}
|