DEPLOY.md

Back to Datashare

Installing Datashare

1. Complete the Datashare marketplace prerequisites

2. Open the Datashare solution

3. Click 'LAUNCH' to start the installation.

   

4. If prompted, select a project to deploy to.

   

5. Populate the following fields:

• GCP Service Account: Populate this with the service account created in step 1. IE: datashare-deployment-mgr@[YOUR_PROJECT_ID].iam.gserviceaccount.com

• OAuth Client Id: Populate this with the OAuth Client Id created during the credential setup step.

• Data Producers: Populate this with a comma delimited list of domains or accounts that should be Datashare admins.

  

6. Click 'Deploy' to start the deployment.

7. Await the completion of the deployment, once completed, you'll see a green checkmark at the top.

   

Set up domain mappings

See Domain Mappings for further information.

Using the gcloud CLI (Recommended)

After executing the command to map the domains, take note of the A, AAAA, and/or CNAME records that you will need to configure for your domain in your DNS management.

Map the UI domain

FQDN=datashare-demo-2e.fsi.joonix.net
gcloud beta run domain-mappings create --service ds-frontend-ui \
  --domain $FQDN \
  --platform managed

To check the status, run the following:

REGION=us-central1
gcloud beta run domain-mappings describe \
  --domain=$FQDN \
  --platform=managed \
  --region=$REGION

Map the API domain

FQDN=api.datashare-demo-2e.fsi.joonix.net
CLUSTER=datashare
ZONE=us-central1-a
gcloud config set compute/zone $ZONE
NAMESPACE=datashare-apis

gcloud beta run domain-mappings create --service ds-api \
  --domain $FQDN \
  --cluster $CLUSTER \
  --cluster-location $ZONE \
  --namespace $NAMESPACE \
  --platform gke

To check the status, run the following:

gcloud beta run domain-mappings describe \
  --domain $FQDN \
  --cluster $CLUSTER \
  --cluster-location $ZONE \
  --namespace $NAMESPACE \
  --platform gke

Using the GCP Console

1. Go to the Cloud Run console.
2. Click 'MANAGE CUSTOM DOMAINS'.
3. Click '+ ADD MAPPING'.
4. Click 'Add Service domain mapping'.
5. Select the UI service, and map it to the UI domain.
6. Click 'CONTINUE' and you'll be prompted with the A and AAAA record information to configure within your DNS setup.
7. If using GCP Cloud DNS, go to your zone record for the domain, and enter the corresponding values for the A and AAAA records.
8. Select the API service, and map it to the API domain.
9. Click 'CONTINUE' and you'll be prompted with the A record information to configure within your DNS setup.
10. If using GCP Cloud DNS, go to your zone record for the domain, and enter the corresponding values for the A and AAAA records.

Next

Initialize Schema