Gospel Quick Deployment on Google Cloud Platform (GCP)

You can now get a demonstration version of a Gospel deployment up and running with a few clicks on the Google Cloud Platform!

This guide explains how to configure and deploy Gospel from a Kubernetes cluster on the Google Cloud Platform (GCP). Once completed, this deployment lets you quickly evaluate the features and functionality of Gospel.

The demo configuration profile is designed to showcase the functionalities provided by the Gospel platform. It is not suitable for performance evaluation or live customer data. 

Before you begin

You must have the following:

  • A GCP user account
  • A Kubernetes Engine Admin role for the Google Kubernetes Engine cluster that you are using

  • A Kubernetes cluster instance of at least size n1-standard-2

There is no usage fee for the Gospel demo on GCP. However, charges may apply for the use of Google Kubernetes Engine. Please refer to GCP pricing details for latest pricing.


Quick Start Steps

Step 1: Locate Gospel Technology in the MarketPlace

  1. Sign In to the Google Cloud Platform Console

  2. In the Navigation menu, select Marketplace  and then select the Kubernetes Apps category




  3. Type "Gospel Technology" in the Search for solutions box



Alternatively, you can scroll through the list to locate "Gospel Technology"

Select Gospel Technology from the results page. You are redirected to a page where you can view information about Gospel Technology and continue with the configuration and deployment. 

Step 2: Configure the deployment

  1. Click Configure to start the configuration



  2. You are prompted to select a project. Select an existing project or create a new project to continue.
  3. Enter the following information:
    • Cluster zoneYou can install Gospel on an existing GKE cluster or you can create a cluster. If you choose to create a new cluster, you are prompted to choose the geographic zone in which to create it. 
    • Namespace: Select a namespace from the drop-down or create a namespace. Enter a name for your namespace in the New namespace name field.
    • App instance name: Enter a name for the instance or continue with the default option
    • Gospel Installer Service Account: Leave this in the default setting
    • Select the checkbox to accept the terms and conditions for the GCP Marketplace and Gospel Technology


  4. Click Deploy

Step 3: View the status of your deployment

  1. Click on Services and Ingress to view the progress of the deployment

  2. Click Refresh to view/update the status of the deployment. When the deployment is complete the icon is updated.

Step 4: Start the Installation

  1. Click on the link for the IP address on port displayed for your deployment to launch the Gospel Installation Wizard



  2. A “Your Connection is Not Private” message may be displayed when you access the Gospel UI link. This occurs because your browser runs security checks in the background and cannot verify the certificate generated for this session. To proceed, firstly click on the “Advanced” option, and then click the “Proceed to <URL>”  (unsafe) option.

  3. In the Installation Wizard, click the Quickstart demo environment option to quickly start exploring the Gospel using the demonstration environment profile

    •  
  4. Read this End User License Agreement (“EULA”) carefully because by deploying the software or accessing the service you are agreeing to be compy with the Gospel Technology terms of service. Check the box and click Continue. 
  5. Click Let's go! to start the deployment. This may take a few minutes depending on the size of the cluster and configuration.

    •  
  6. Click Yes in the message that is displayed to confirm and launch the demo environment

    •  
  7. The deployment begins and the progress is displayed on the screen. You can also view the status from the Applications option available on the left menu. 
  8. When your installation is complete, the screen displays the users configured in this demonstration with varying levels of access
  9. To access the Gospel UI, navigate to the URL displayed on the screen

Step 5: Connect and Login to Gospel

  1. A “Your Connection is Not Private” message may be displayed when you access the Gospel UI link. This occurs because your browser runs security checks in the background and cannot verify the certificate generated for this session. To proceed, firstly click on the “Advanced ” link, and then click the “Proceed to https://<ip address>(unsafe)" option.

  2. Enter the Client Identifier (provided on the final screen of the Installation Wizard page)


  3. Enter the login details (provided on the final screen of the Installation Wizard page), and click Login
  4. Gospel provides an additional level of security by providing multiple sources of identity. You do not require this for the demonstration environment. Click Skip signup for now to continue.
    •  

On successful authentication, you are redirected to the Dashboard. For more information on using the Gospel user interface, refer to the user guide

Troubleshooting

Deployment failed error message

This may occur if you do not have the required permissions on the cluster. Ensure that the user is a part of the Kubernetes Engine Admin role which provides them access to full management of container clusters and their Kubernetes API objects.

Installation has failed

Namespaces can not be nested inside one another and each Kubernetes resource can only be in one namespace. Ensure that there is only one deployment on a namespace. You may need to perform the deployment steps listed in this document by creating a new namespace.