go.chromium.org/luci@v0.0.0-20240309015107-7cdc2e660f33/buildbucket/appengine/taskbackendlite/README.md (about)

     1  # Buildbucket TaskbackendLite Service
     2  Buildbucket TaskbackendLite Service is an implementation of
     3  `service TaskbackendLite` in Buildbucket
     4  [backend.proto](https://chromium.googlesource.com/infra/luci/luci-go/+/refs/heads/main/buildbucket/proto/backend.proto#329).
     5  The initial idea is to assist Google3 users of Buildbucket V1 who run builds on
     6  their own backend to be able to migrate to Buildbucket V2 (see go/webrtc-bb-taskbackend).
     7  This service acts as a simple bridge, receiving Buildbucket's RunTask requests
     8  and publishing task notifications to the corresponding Cloud PubSub topic.
     9  
    10  The task notification pubsub message schema is:
    11  ```
    12  {
    13      "build_id": <string>,
    14      "start_build_token": <string>,
    15  }
    16  ```
    17  Attributes:
    18   - "dummy_task_id" (to deduplicate the message on the subscriber side)
    19   - "project"
    20   - "bucket"
    21   - "builder"
    22  
    23  
    24  ## How to onboard
    25  
    26  To begin using this service, please get in touch with the service
    27  [owners](https://chromium.googlesource.com/infra/luci/luci-go/+/refs/heads/main/buildbucket/OWNERS).
    28  This is to ensure that the dedicated PubSub topic ID (in the format"taskbackendlite-${project}")
    29  has been set up for your project, and its corresponding LUCI project account -
    30  (${project}-scoped@luci-project-accounts.iam.gserviceaccount.com) has been
    31  granted the publisher permission.