Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


codecov Ubuntu build

Support for Spine-based Java apps running at Google Cloud.

Java Version

Starting version 2.0.0-SNAPSHOT.63, the artifacts of this library are being built with Java 11 compilation target. Therefore, the consumer applications have to use Java 11 or higher.

Previous versions were build with Java 8.



// Compatible with Java 8:

dependencies {
    // Datastore Storage support library.

    // Pub/Sub messaging support library.

    // Stackdriver Trace support library.

    // Datastore-related test utilities (if needed).

These artifacts should be used as a part of the Spine server application.

For the details on setting up the server environment please refer to Spine Bootstrap Gradle plugin and Spine core modules documentation.

Configuring Datastore

Datastore indexes

In order to run the application built on top of gcloud-java, Datastore instance requires some preliminary configuration. In particular, the indexes for the Spine internal record types should be set. Please notice a special index configuration for your custom Aggregate types.

The configuration file is located at ./datastore/config/index.yaml.

Please see the Google Cloud Platform documentation for the details.

Custom indexes

It is possible to store some of the Spine Entity fields in separate Datastore kind fields. Such an approach is useful to optimize read-side querying. In this case more Datastore indexes may be created.

Example: Assuming you have a Projection type called CustomerProjection. Its state is declared in the Protobuf type It has Entity Columns country and companySize. Once you try to make a query in those Columns, the Datastore will fail with an internal Exception. To prevent this, you should create an index for your CustomerProjection:

- kind:
    ancestor: no
    - name: country
    - name: companySize


This section describes testing the gcloud-java library itself.


To run the task successfully, you must have gcloud tool properly installed and configured:

  • install gcloud of the last version;
  • login under a Google account when initializing the gcloud;
  • to run tests you should select spine-dev Google Cloud Console project;
  • skip Google App Engine setup if not required.
Running the tests


To start a local emulator and run test against it, run ./gradlew check.

To start an emulator without running tests ./gradlew startDatastore.

To stop the Datastore emulator, just terminate the emulator process (e.g. kill -9 $(lsof -i:8080) or just close the terminal window on Windows).

The launched emulator will run at localhost:8080 and will not have any persistence. To change the configuration see ./scripts/start-datastore.* scripts.

The datastore is cleaned up after each test. See test classes under ./datastore/src/test/java/... and


The test are launched in a scope of Gradle test phase. However, they rely on a Google Cloud credentials file located at <project root>/stackdriver-trace/src/test/resources/spine-dev.json.

To run the tests, obtain the service account file for your environment and make it available to the test code in the specified location.