Skip to content

Configuring a Google Cloud Storage bucket as the Spotfire external library storage

This page provides an overview of the main steps needed to use a Google Storage bucket ⧉ to deploy the Spotfire Platform ⧉ on Google Kubernetes Engine (GKE) ⧉, using the Spotfire CDK ⧉.

This is a quickstart guide. For more information, see the official documentation. Always follow the documentation and recommended best practices from the vendor.

Remember to change the provided example values to adapt them to your own environment and needs.

Prerequisites

Note: The Google Cloud CLI (gcloud) is used in the examples below, but you can use the Google Cloud web interface, REST API, libraries or any other available methods.

Steps

1. Create a Google Storage bucket

  1. If not already set, define the following environment variables (as from the previous quickstarts):

    export RESOURCE_GROUP=spotfire-quickstart
    export LOCATION=europe-north1
    export NAMESPACE=spotfire-quickstart
    

  2. Create a Google Storage bucket:

    export BUCKET_NAME=<my-bucket>
    gcloud storage buckets create gs:/$BUCKET_NAME \
        --location=$LOCATION
    
    For more information, see Create buckets ⧉.

  3. Verify your bucket:

    gcloud storage ls
    

2. Deploy Spotfire

  1. Create a Helm values file using the following google-cloud-storage-bucket.yaml example template:

    configuration:
      configurationScripts:
        - name: config-library-external-google-storage-storage
          # https://docs.tibco.com/pub/spotfire_server/latest/doc/html/TIB_sfire_server_tsas_admin_help/server/topics/config-library-external-google-cloud-storage.html
          script: |
            config-library-external-google-cloud-storage \
              --bucket-name="<GCP bucket name>" \
              --key-prefix="spotfire-library/" \
              --project-id="<GCP project ID>" \
              --credential-file-path=<creds file path> \
              --bootstrap-config="${BOOTSTRAP_FILE}"
        - name: config-library-external-data-storage
          # https://docs.tibco.com/pub/spotfire_server/latest/doc/html/TIB_sfire_server_tsas_admin_help/server/topics/config-library-external-s3-storage.html
          script: |
            config-library-external-data-storage \
              --tool-password="${TOOL_PASSWORD}" \
              --enabled=true \
              --external-storage=GOOGLE_CLOUD_STORAGE \
              --bootstrap-config="${BOOTSTRAP_FILE}"
    

    For more information, see the config-library-external-data-storage ⧉ and config-library-external-google-cloud-storage ⧉ documentation.

  2. Deploy the spotfire-platform Helm chart using the google-cloud-storage-bucket.yaml additional values file. For example:

    export NAMESPACE=spotfire-quickstart
    export MY_SPOTFIRE_RELEASE=vanilla-spotfire
    export REGISTRY_SERVER=oci.spotfire.com
    export REGISTRY_SECRET=spotfire-oci-secret
    
    helm upgrade --install $MY_SPOTFIRE_RELEASE \
        oci://$REGISTRY_SERVER/charts/spotfire-platform \
        --version 2.0.0 \
        --namespace=$NAMESPACE \
        --set global.spotfire.acceptEUA=true \
        --set global.spotfire.image.registry=$REGISTRY_SERVER\
        --set global.spotfire.image.pullSecrets[0]=$REGISTRY_SECRET \
        --set spotfire-server.configuration.site.publicAddress=http://spotfire.example.com \
        -f google-cloud-sql-postgres.yaml \
        -f google-cloud-storage-bucket.yaml \
        ...
    
    For more information, see the spotfire-platform Helm chart.

You have now deployed the Spotfire Platform on Google Cloud, using a Google Cloud Storage bucket as the Spotfire external library storage.

You can learn about reference architectures, diagrams, and best practices in Google Cloud in Cloud Architecture Center ⧉

3. Cleanup

To avoid unneeded resource usage, once you have completed this tutorial, delete any created resources:

gcloud container clusters delete $CLUSTER_NAME --location $LOCATION
gcloud sql instances delete $DB_INSTANCE_NAME
gcloud storage rm --recursive gs://$BUCKET_NAME
...
For more information, see Delete Google Storage buckets ⧉.