You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit fc92e6a
Browse filesBrowse the repository at this point in the historyBrowse files
take=flag.Int("take", -1, "Only apply the first N patches. -1 means apply all.")
30
32
origin=flag.String("origin", "", "Use this origin instead of the default defined in '.gitmodules' to fetch the repository.")
33
+
ref=flag.String("ref", "", "Fetch this commit or ref instead of the recorded submodule commit, and stage it in the outer repository so subsequent refreshes use it rather than restoring the original commit, desirable in some CI scenarios.")
31
34
shallow=flag.Bool("shallow", false, "Clone the submodule with depth 1.")
32
35
fetchBearerToken=flag.String("fetch-bearer-token", "", "Use this bearer token to fetch the submodule repository.")
Copy file name to clipboardExpand all lines: eng/doc/DeveloperGuide.md
+17Lines changed: 17 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -117,6 +117,23 @@ go version
117
117
go test -short ./...
118
118
```
119
119
120
+
## Testing an upstream Go change
121
+
122
+
Manually run a [PR or rolling pipeline](../pipeline/README.md) using **Run pipeline**in Azure DevOps.
123
+
Select the outer repository branch (or ref under **Branch/tag**) to test, thenset`submoduleRef` to an upstream commit SHA or Gerrit ref, such as `refs/changes/34/123434/2`.
124
+
It's fine to select someone else's branch and submodule ref.
125
+
Leave it as `nil` to use the recorded submodule commit.
126
+
The override applies to both innerloop and outerloop pipelines.
127
+
128
+
Overrides are fetched anonymously from `https://go.googlesource.com/go`.
129
+
Public PR pipelines also accept `submoduleRepository`, for example an HTTPS GitHub fork URL, to test a commit that has not been uploaded to Gerrit.
130
+
This parameter is only used when `submoduleRef` is set; internal rolling pipelines always fetch overrides from the public Go repository, without the internal mirror credentials.
131
+
132
+
Patches are applied onto the requested commit, and patch conflicts fail the build as usual.
133
+
Fresh-agent test retries use the same resolved commit as the first attempt, even if the ref has advanced e.g. on Gerrit.
134
+
135
+
To use an override locally, see the [`submodule-refresh` options](../README.md#patch-files).
0 commit comments