bridge.go 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214
  1. package notifications
  2. import (
  3. "net/http"
  4. "time"
  5. "github.com/docker/distribution"
  6. "github.com/docker/distribution/context"
  7. "github.com/docker/distribution/digest"
  8. "github.com/docker/distribution/reference"
  9. "github.com/docker/distribution/uuid"
  10. )
  11. type bridge struct {
  12. ub URLBuilder
  13. actor ActorRecord
  14. source SourceRecord
  15. request RequestRecord
  16. sink Sink
  17. }
  18. var _ Listener = &bridge{}
  19. // URLBuilder defines a subset of url builder to be used by the event listener.
  20. type URLBuilder interface {
  21. BuildManifestURL(name reference.Named) (string, error)
  22. BuildBlobURL(ref reference.Canonical) (string, error)
  23. }
  24. // NewBridge returns a notification listener that writes records to sink,
  25. // using the actor and source. Any urls populated in the events created by
  26. // this bridge will be created using the URLBuilder.
  27. // TODO(stevvooe): Update this to simply take a context.Context object.
  28. func NewBridge(ub URLBuilder, source SourceRecord, actor ActorRecord, request RequestRecord, sink Sink) Listener {
  29. return &bridge{
  30. ub: ub,
  31. actor: actor,
  32. source: source,
  33. request: request,
  34. sink: sink,
  35. }
  36. }
  37. // NewRequestRecord builds a RequestRecord for use in NewBridge from an
  38. // http.Request, associating it with a request id.
  39. func NewRequestRecord(id string, r *http.Request) RequestRecord {
  40. return RequestRecord{
  41. ID: id,
  42. Addr: context.RemoteAddr(r),
  43. Host: r.Host,
  44. Method: r.Method,
  45. UserAgent: r.UserAgent(),
  46. }
  47. }
  48. func (b *bridge) ManifestPushed(repo reference.Named, sm distribution.Manifest, options ...distribution.ManifestServiceOption) error {
  49. manifestEvent, err := b.createManifestEvent(EventActionPush, repo, sm)
  50. if err != nil {
  51. return err
  52. }
  53. for _, option := range options {
  54. if opt, ok := option.(distribution.WithTagOption); ok {
  55. manifestEvent.Target.Tag = opt.Tag
  56. break
  57. }
  58. }
  59. return b.sink.Write(*manifestEvent)
  60. }
  61. func (b *bridge) ManifestPulled(repo reference.Named, sm distribution.Manifest, options ...distribution.ManifestServiceOption) error {
  62. manifestEvent, err := b.createManifestEvent(EventActionPull, repo, sm)
  63. if err != nil {
  64. return err
  65. }
  66. for _, option := range options {
  67. if opt, ok := option.(distribution.WithTagOption); ok {
  68. manifestEvent.Target.Tag = opt.Tag
  69. break
  70. }
  71. }
  72. return b.sink.Write(*manifestEvent)
  73. }
  74. func (b *bridge) ManifestDeleted(repo reference.Named, dgst digest.Digest) error {
  75. return b.createManifestDeleteEventAndWrite(EventActionDelete, repo, dgst)
  76. }
  77. func (b *bridge) BlobPushed(repo reference.Named, desc distribution.Descriptor) error {
  78. return b.createBlobEventAndWrite(EventActionPush, repo, desc)
  79. }
  80. func (b *bridge) BlobPulled(repo reference.Named, desc distribution.Descriptor) error {
  81. return b.createBlobEventAndWrite(EventActionPull, repo, desc)
  82. }
  83. func (b *bridge) BlobMounted(repo reference.Named, desc distribution.Descriptor, fromRepo reference.Named) error {
  84. event, err := b.createBlobEvent(EventActionMount, repo, desc)
  85. if err != nil {
  86. return err
  87. }
  88. event.Target.FromRepository = fromRepo.Name()
  89. return b.sink.Write(*event)
  90. }
  91. func (b *bridge) BlobDeleted(repo reference.Named, dgst digest.Digest) error {
  92. return b.createBlobDeleteEventAndWrite(EventActionDelete, repo, dgst)
  93. }
  94. func (b *bridge) createManifestEventAndWrite(action string, repo reference.Named, sm distribution.Manifest) error {
  95. manifestEvent, err := b.createManifestEvent(action, repo, sm)
  96. if err != nil {
  97. return err
  98. }
  99. return b.sink.Write(*manifestEvent)
  100. }
  101. func (b *bridge) createManifestDeleteEventAndWrite(action string, repo reference.Named, dgst digest.Digest) error {
  102. event := b.createEvent(action)
  103. event.Target.Repository = repo.Name()
  104. event.Target.Digest = dgst
  105. return b.sink.Write(*event)
  106. }
  107. func (b *bridge) createManifestEvent(action string, repo reference.Named, sm distribution.Manifest) (*Event, error) {
  108. event := b.createEvent(action)
  109. event.Target.Repository = repo.Name()
  110. mt, p, err := sm.Payload()
  111. if err != nil {
  112. return nil, err
  113. }
  114. // Ensure we have the canonical manifest descriptor here
  115. _, desc, err := distribution.UnmarshalManifest(mt, p)
  116. if err != nil {
  117. return nil, err
  118. }
  119. event.Target.MediaType = mt
  120. event.Target.Length = desc.Size
  121. event.Target.Size = desc.Size
  122. event.Target.Digest = desc.Digest
  123. ref, err := reference.WithDigest(repo, event.Target.Digest)
  124. if err != nil {
  125. return nil, err
  126. }
  127. event.Target.URL, err = b.ub.BuildManifestURL(ref)
  128. if err != nil {
  129. return nil, err
  130. }
  131. return event, nil
  132. }
  133. func (b *bridge) createBlobDeleteEventAndWrite(action string, repo reference.Named, dgst digest.Digest) error {
  134. event := b.createEvent(action)
  135. event.Target.Digest = dgst
  136. event.Target.Repository = repo.Name()
  137. return b.sink.Write(*event)
  138. }
  139. func (b *bridge) createBlobEventAndWrite(action string, repo reference.Named, desc distribution.Descriptor) error {
  140. event, err := b.createBlobEvent(action, repo, desc)
  141. if err != nil {
  142. return err
  143. }
  144. return b.sink.Write(*event)
  145. }
  146. func (b *bridge) createBlobEvent(action string, repo reference.Named, desc distribution.Descriptor) (*Event, error) {
  147. event := b.createEvent(action)
  148. event.Target.Descriptor = desc
  149. event.Target.Length = desc.Size
  150. event.Target.Repository = repo.Name()
  151. ref, err := reference.WithDigest(repo, desc.Digest)
  152. if err != nil {
  153. return nil, err
  154. }
  155. event.Target.URL, err = b.ub.BuildBlobURL(ref)
  156. if err != nil {
  157. return nil, err
  158. }
  159. return event, nil
  160. }
  161. // createEvent creates an event with actor and source populated.
  162. func (b *bridge) createEvent(action string) *Event {
  163. event := createEvent(action)
  164. event.Source = b.source
  165. event.Actor = b.actor
  166. event.Request = b.request
  167. return event
  168. }
  169. // createEvent returns a new event, timestamped, with the specified action.
  170. func createEvent(action string) *Event {
  171. return &Event{
  172. ID: uuid.Generate().String(),
  173. Timestamp: time.Now(),
  174. Action: action,
  175. }
  176. }