Skip to content

Commit

Permalink
Add new troubleshooting entry for GCP 403 (#463)
Browse files Browse the repository at this point in the history
* integrate custom docs with new UI

* more edits

* use website wording for intro

* fix numbering in table

* rename and some edits

* rename manage_repo file, per Bo

* Merge.

* formatting edits

* updates per Keyur's feedback

* Fix typos

* fix nav order

* fix link to API key request form

* update form link

* update key request form and output dir env var

* Revert to gerund

Though the style guide says to just use imperatives, "get started" just sounds weird. Also this is more consistent with "troubleshooting"

* new troubleshooting entry

* fix typo
  • Loading branch information
kmoscoe authored Jul 31, 2024
1 parent e6eb525 commit 341004a
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 2 deletions.
4 changes: 2 additions & 2 deletions custom_dc/quickstart.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
layout: default
title: Get started
title: Getting started
nav_order: 2
parent: Build your own Data Commons
---

{:.no_toc}
# Get started
# Getting started

This page shows you how to run a local custom Data Commons instance inside a Docker container and load sample custom data from a local SQLite database. A custom Data Commons instance uses code from the public open-source repo, available at [https://github.com/datacommonsorg/](https://github.com/datacommonsorg/).

Expand Down
9 changes: 9 additions & 0 deletions custom_dc/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,15 @@ This is because you are missing a valid API key or the necessary APIs are not en

In general, whenever you encounter problems with any Google Cloud Run service, check the **Logs** page for your Cloud Run service, to get detailed output from the services.

### "403 Forbidden: Your client does not have permission to get URL / from this server"

This error indicates that your application requires authenticated requests but you have not provided an authentication token. If your site is intended to be public, first check to see that the Cloud Run service is not set up to require authentication:
1. Go to the [Google Cloud Console Cloud Run](https://console.cloud.google.com?run) page for your project.
1. From the list of services, select the relevant service and select the **Security** tab.
1. Ensure that you have enabled **Allow unauthenticated invocations** and restart the Cloud Run service.

If you are unable to select this option, this indicates that there is an IAM permissions setup issue with your project or account. See the [Cloud Run Troubleshooting](https://cloud.google.com/run/docs/troubleshooting#unauthorized-client) for details on how to fix this.

### "502 Bad Gateway"

If you see no errors in the logs, except `connect() failed (111: Connection refused) while connecting to upstream`, try the following:
Expand Down

0 comments on commit 341004a

Please sign in to comment.