github.com/Heebron/moby@v0.0.0-20221111184709-6eab4f55faf7/distribution/xfer/upload.go (about) 1 package xfer // import "github.com/docker/docker/distribution/xfer" 2 3 import ( 4 "context" 5 "errors" 6 "time" 7 8 "github.com/docker/distribution" 9 "github.com/docker/docker/layer" 10 "github.com/docker/docker/pkg/progress" 11 "github.com/sirupsen/logrus" 12 ) 13 14 const maxUploadAttempts = 5 15 16 // LayerUploadManager provides task management and progress reporting for 17 // uploads. 18 type LayerUploadManager struct { 19 tm *transferManager 20 waitDuration time.Duration 21 } 22 23 // SetConcurrency sets the max concurrent uploads for each push 24 func (lum *LayerUploadManager) SetConcurrency(concurrency int) { 25 lum.tm.setConcurrency(concurrency) 26 } 27 28 // NewLayerUploadManager returns a new LayerUploadManager. 29 func NewLayerUploadManager(concurrencyLimit int, options ...func(*LayerUploadManager)) *LayerUploadManager { 30 manager := LayerUploadManager{ 31 tm: newTransferManager(concurrencyLimit), 32 waitDuration: time.Second, 33 } 34 for _, option := range options { 35 option(&manager) 36 } 37 return &manager 38 } 39 40 type uploadTransfer struct { 41 transfer 42 43 remoteDescriptor distribution.Descriptor 44 err error 45 } 46 47 // An UploadDescriptor references a layer that may need to be uploaded. 48 type UploadDescriptor interface { 49 // Key returns the key used to deduplicate uploads. 50 Key() string 51 // ID returns the ID for display purposes. 52 ID() string 53 // DiffID should return the DiffID for this layer. 54 DiffID() layer.DiffID 55 // Upload is called to perform the Upload. 56 Upload(ctx context.Context, progressOutput progress.Output) (distribution.Descriptor, error) 57 // SetRemoteDescriptor provides the distribution.Descriptor that was 58 // returned by Upload. This descriptor is not to be confused with 59 // the UploadDescriptor interface, which is used for internally 60 // identifying layers that are being uploaded. 61 SetRemoteDescriptor(descriptor distribution.Descriptor) 62 } 63 64 // Upload is a blocking function which ensures the listed layers are present on 65 // the remote registry. It uses the string returned by the Key method to 66 // deduplicate uploads. 67 func (lum *LayerUploadManager) Upload(ctx context.Context, layers []UploadDescriptor, progressOutput progress.Output) error { 68 var ( 69 uploads []*uploadTransfer 70 dedupDescriptors = make(map[string]*uploadTransfer) 71 ) 72 73 for _, descriptor := range layers { 74 progress.Update(progressOutput, descriptor.ID(), "Preparing") 75 76 key := descriptor.Key() 77 if _, present := dedupDescriptors[key]; present { 78 continue 79 } 80 81 xferFunc := lum.makeUploadFunc(descriptor) 82 upload, watcher := lum.tm.transfer(descriptor.Key(), xferFunc, progressOutput) 83 defer upload.release(watcher) 84 uploads = append(uploads, upload.(*uploadTransfer)) 85 dedupDescriptors[key] = upload.(*uploadTransfer) 86 } 87 88 for _, upload := range uploads { 89 select { 90 case <-ctx.Done(): 91 return ctx.Err() 92 case <-upload.transfer.done(): 93 if upload.err != nil { 94 return upload.err 95 } 96 } 97 } 98 for _, l := range layers { 99 l.SetRemoteDescriptor(dedupDescriptors[l.Key()].remoteDescriptor) 100 } 101 102 return nil 103 } 104 105 func (lum *LayerUploadManager) makeUploadFunc(descriptor UploadDescriptor) doFunc { 106 return func(progressChan chan<- progress.Progress, start <-chan struct{}, inactive chan<- struct{}) transfer { 107 u := &uploadTransfer{ 108 transfer: newTransfer(), 109 } 110 111 go func() { 112 defer func() { 113 close(progressChan) 114 }() 115 116 progressOutput := progress.ChanOutput(progressChan) 117 118 select { 119 case <-start: 120 default: 121 progress.Update(progressOutput, descriptor.ID(), "Waiting") 122 <-start 123 } 124 125 retries := 0 126 for { 127 remoteDescriptor, err := descriptor.Upload(u.transfer.context(), progressOutput) 128 if err == nil { 129 u.remoteDescriptor = remoteDescriptor 130 break 131 } 132 133 // If an error was returned because the context 134 // was cancelled, we shouldn't retry. 135 select { 136 case <-u.transfer.context().Done(): 137 u.err = err 138 return 139 default: 140 } 141 142 retries++ 143 if _, isDNR := err.(DoNotRetry); isDNR || retries == maxUploadAttempts { 144 logrus.Errorf("Upload failed: %v", err) 145 u.err = err 146 return 147 } 148 149 logrus.Errorf("Upload failed, retrying: %v", err) 150 delay := retries * 5 151 ticker := time.NewTicker(lum.waitDuration) 152 153 selectLoop: 154 for { 155 progress.Updatef(progressOutput, descriptor.ID(), "Retrying in %d second%s", delay, (map[bool]string{true: "s"})[delay != 1]) 156 select { 157 case <-ticker.C: 158 delay-- 159 if delay == 0 { 160 ticker.Stop() 161 break selectLoop 162 } 163 case <-u.transfer.context().Done(): 164 ticker.Stop() 165 u.err = errors.New("upload cancelled during retry delay") 166 return 167 } 168 } 169 } 170 }() 171 172 return u 173 } 174 }