xsystems/postgres-gsutil repository overview

⁠xSystems PostgreSQL gsutil

⁠Usage

⁠Run

Create a GCP service account⁠ and create a key for that service account⁠. Next, assign the service account the role⁠ Storage Admin w.r.t. the Google Cloud Storage bucket.

When running a container of this image you MUST mount the before mentioned credential file under /run/secrets/ inside the container. That is, the following file MUST be available inside the container:

• /run/secrets/gcp-credentials.json

This can either be achieved using Docker Volumes or Docker Secrets.

Also, when running a container of this image you MUST specify the environment variable GCP_PROJECT.

All available environment variables are:

⁠Example

This image can be used as follows:

docker run  --tty \
            --interactive \
            --rm \
            --env GCP_PROJECT=<REPLACE_WITH_PROJECT_NAME> \
            --volume `pwd`/gcp-credentials.json:/run/secrets/gcp-credentials.json \
            xsystems/postgres-gsutil ls -al gs://<REPLACE_WITH_BUCKET_NAME>

⁠Build the Image

Run build.sh⁠ to build an image of the current codebase state with tag latest.

⁠Release the Image

1. Set the VERSION environment variable to the version that needs to be released.
2. Optionally, set the COMMIT environment variable to the hash of the Git commit that needs to be released. It defaults to the latest commit.
3. Run release.sh⁠.

Example release statement:

VERSION=1.3.42 ./release.sh