Getting The Code

git clone https://github.com/houglum/maven-multimodule-google-cloud-java
cd maven-multimodule-google-cloud-java
git submodule update --init --recursive

Building/Running

These instructions use Maven to build and run the project.

NOTE: All mvn commands should be run from the root of the repository.

Setting Up Credentials

The main module uses Google Application Default Credentials.

• If you have a JSON keyfile, run this command so that the program knows where to find your keyfile:

  export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"

• If you're running on a GCE instance and would like to use GCE service account auth instead of a keyfile, make sure that the instance's default service account has been granted an IAM role that grants the iam.serviceAccounts.signBlob permission.

Building The Project

To build all the modules and avoid running google-cloud-java tests, run:

mvn install -DskipTests

If you'd like to rebuild the project after altering the main module, it is much faster to only recompile that module. This can be accomplished using maven's --projects flag, as shown below:

mvn install -DskipTests --projects main-module

Similarly, if you edit both the google-cloud-storage and main-module projects, you can supply both, delimited by a comma:

mvn install \
    -DskipTests \
    --projects main-module,google-cloud-java/google-cloud-clients/google-cloud-storage

Running The Project

You'll need to supply your resource names used for generating signed URLs:

BKT_NAME="your-bucket-name-here"
GET_OBJ_NAME="name-of-an-object-in-your-bucket-that-already-exists"

# This is the name of the object you want to allow callers to upload bytes for.
# Thus, this object doesn't need to already exist.
PUT_OBJ_NAME="name-of-an-object-you-want-to-create"

After you've built the project, you can invoke this command to run it:

mvn exec:java --projects main-module \
    -Dexec.args="${BKT_NAME:?must be set} ${GET_OBJ_NAME:?must be set} ${PUT_OBJ_NAME:?must be set}"