CAS server

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

Note

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

Configuration

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.

server:
  - !channel
    port: 50051
    insecure_mode: true

instances:
  - name: main

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

    services:
      - !cas
        storage: *main-storage

      - !bytestream
        storage: *main-storage

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

Hint

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.