1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/*
Copyright The ORAS 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 cache
import (
"context"
"io"
"sync"
ocispec "github.com/opencontainers/image-spec/specs-go/v1"
"oras.land/oras-go/v2"
"oras.land/oras-go/v2/content"
"oras.land/oras-go/v2/registry"
)
type closer func() error
func (fn closer) Close() error {
return fn()
}
// Cache target struct.
type target struct {
oras.ReadOnlyTarget
cache content.Storage
}
// New generates a new target storage with caching.
func New(source oras.ReadOnlyTarget, cache content.Storage) oras.ReadOnlyTarget {
t := &target{
ReadOnlyTarget: source,
cache: cache,
}
if refFetcher, ok := source.(registry.ReferenceFetcher); ok {
return &referenceTarget{
target: t,
ReferenceFetcher: refFetcher,
}
}
return t
}
// Fetch fetches the content identified by the descriptor.
func (t *target) Fetch(ctx context.Context, target ocispec.Descriptor) (io.ReadCloser, error) {
rc, err := t.cache.Fetch(ctx, target)
if err == nil {
// Fetch from cache
return rc, nil
}
if rc, err = t.ReadOnlyTarget.Fetch(ctx, target); err != nil {
return nil, err
}
// Fetch from origin with caching
return t.cacheReadCloser(ctx, rc, target), nil
}
func (t *target) cacheReadCloser(ctx context.Context, rc io.ReadCloser, target ocispec.Descriptor) io.ReadCloser {
pr, pw := io.Pipe()
var wg sync.WaitGroup
wg.Add(1)
var pushErr error
go func() {
defer wg.Done()
pushErr = t.cache.Push(ctx, target, pr)
if pushErr != nil {
pr.CloseWithError(pushErr)
}
}()
return struct {
io.Reader
io.Closer
}{
Reader: io.TeeReader(rc, pw),
Closer: closer(func() error {
rcErr := rc.Close()
if err := pw.Close(); err != nil {
return err
}
wg.Wait()
if pushErr != nil {
return pushErr
}
return rcErr
}),
}
}
// Exists returns true if the described content exists.
func (t *target) Exists(ctx context.Context, desc ocispec.Descriptor) (bool, error) {
exists, err := t.cache.Exists(ctx, desc)
if err == nil && exists {
return true, nil
}
return t.ReadOnlyTarget.Exists(ctx, desc)
}
// Cache referenceTarget struct.
type referenceTarget struct {
*target
registry.ReferenceFetcher
}
// FetchReference fetches the content identified by the reference from the
// remote and cache the fetched content.
// Cached content will only be read via Fetch, FetchReference will always fetch
// From origin.
func (t *referenceTarget) FetchReference(ctx context.Context, reference string) (ocispec.Descriptor, io.ReadCloser, error) {
target, rc, err := t.ReferenceFetcher.FetchReference(ctx, reference)
if err != nil {
return ocispec.Descriptor{}, nil, err
}
// skip caching if the content already exists in cache
exists, err := t.cache.Exists(ctx, target)
if err != nil {
return ocispec.Descriptor{}, nil, err
}
if exists {
err = rc.Close()
if err != nil {
return ocispec.Descriptor{}, nil, err
}
// get rc from the cache
rc, err = t.cache.Fetch(ctx, target)
if err != nil {
return ocispec.Descriptor{}, nil, err
}
// no need to do tee'd push
return target, rc, nil
}
// Fetch from origin with caching
return target, t.cacheReadCloser(ctx, rc, target), nil
}
|
