CAS server

It is possible to configure BuildGrid with just a Content Addressable Storage service.


This service can be equivalent to BuildStream’s Artifact Server if the Reference Storage Service is included.


Here is an example project configuration. It also implements an optional API called the Reference Storage Service, which if used, allows the user to store a Digest behind a user defined key.

  - !channel
    port: 50051
    insecure_mode: true

  - name: main

      - !disk-storage &main-storage
        path: !expand-path $HOME/cas

      - !cas
        storage: *main-storage

      - !bytestream
        storage: *main-storage

      - !reference-cache
        storage: *main-storage
        max-cached-refs: 512


Use - name: "" if using with BuildStream, as instance names are not supported for that tool yet.

This defines a single main instance of the CAS, Bytestream and Reference Storage service on port 55051. It is backed onto disk storage and will populate the folder $HOME/cas. To start the server, simply type into your terminal:

bgd server start data/config/artifacts.conf

The server should now be available to use.