From 1e5c075d93a77132567db5eb608845945e8ad0be Mon Sep 17 00:00:00 2001
From: Yash <nevoodoo@users.noreply.github.com>
Date: Mon, 26 May 2025 13:16:05 +1000
Subject: [PATCH] Update infra README.md to add debugging docs

---
 infra/gcp/README.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/infra/gcp/README.md b/infra/gcp/README.md
index 1dd8ccfd25e..724d6d5d773 100644
--- a/infra/gcp/README.md
+++ b/infra/gcp/README.md
@@ -140,6 +140,21 @@ export GCP_PROJECT=<gcp project name>
   }
   ```
 
+  Issues with this file may cause errors when launching dev deploys, in particular due to malformed/expired OAuth tokens. Errors like these likely point to a malformed token:
+  
+  ```
+  dev deploy failed: error finding {"repo": {"owner": "populationgenomics", "name": "hail"}, "name": "<branch-name>"} at GitHub
+  ```
+
+  Inspection of the pods can reveal what token is being used and help with further debugging of the deploy:
+  ```
+  $ kubectl exec -it ci-7fb45cb8cb-sgvwn -- bash
+   root@ci-7fb45cb8cb-sgvwn:/# cat /secrets/oauth-token/oauth-token; echo
+   github_pat_<snip>_<snip>
+   root@ci-7fb45cb8cb-sgvwn:/# exit
+   $
+  ```
+
 ## Check Service Accounts into Repository
 
 - Install [sops](https://github.com/mozilla/sops).
@@ -409,4 +424,4 @@ gcloud compute ssh --zone "us-central1-a" "<VM-NAME>" --project "<PROJECT>"
 
 ## Remove the cloud VM
 
-- Once the deployment is complete, you can remove the cloud VM in the Google cloud console.
\ No newline at end of file
+- Once the deployment is complete, you can remove the cloud VM in the Google cloud console.