artin/sourcegraph
1
0
Fork 0
mirror of https://github.com/sourcegraph/sourcegraph.git synced 2026-02-06 14:51:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add advisement on hanging bartch (#50120)

Browse Source 
This change adds a common occurrence and fix for batch changes that hang
for users using src to apply changes. This change provides a background
introduction on what workspace type is all about and how to fix a
scenario where a change hangs.



## Test plan

<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
Doc update. No test plan required.
This commit is contained in:
Stompy 2023-04-04 17:43:57 +03:00 committed by GitHub
parent cf278ddb37
commit 5de9993d88
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/batch_changes/references/faq.md
View File

@ -130,3 +130,7 @@ So, if you have a search query that returns 10 results in a single repo, the bat
### Why do I get fewer changes in my changeset diff when I run a batch spec than there are results when I run the same search query?
Sourcegraph search shows you results on any repositories that you have read access to. However, Sourcegraph and Batch Changes do not know which repositories you have _write_ access to. This disparity most often stems from not having write access to one or more of the repositories where your search query returns results. Consider asking an admin to set up a [global service account token](../how-tos/configuring_credentials.md#global-service-account-tokens) if it's important that your batch change updates all matching repositories.
### Why is my batch change preview hanging?
When working with `src`, there are occurences where applying your batch spec might get stuck on a particular step. More so in the `Determining workspace type` step. The `Determining workspace type` is a simple step that decides if bind or volume modes should be used based on the command line flags, and the OS and architecture. If volume mode is used (which is default on Mac OS), then `src` will attempt to pull the `sourcegraph/src-batch-change-colume-workspace` Docker image from docker hub since that's required for the batch spec to be executed. The "hanging" is typically is caused by the local machine's CLI state. Restarting your computer and applying the batch spec again should fix this.