Skip to content

Commit a000f9c

Browse files
authored
docs: publish v1.2.0 Go archive pins (#159)
1 parent 6995353 commit a000f9c

5 files changed

Lines changed: 53 additions & 3 deletions

File tree

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,26 @@ prints `RTO_COMMIT`, `RTO_ARCHIVE_URL`, `RTO_ARCHIVE_SHA256`,
168168
and the default Orchestrion version. Published GitHub pins use `tar.gz`; other
169169
archive types must be mirrored and documented outside this helper.
170170

171+
Current `v1.2.0` GitHub pins:
172+
173+
```bash
174+
RTO_COMMIT="69953536d4ef1252c8181c267d16c61263f0aa4c"
175+
RTO_REMOTE="https://github.com/DataDog/rules_test_optimization.git"
176+
RTO_ARCHIVE_URL="https://codeload.github.com/DataDog/rules_test_optimization/tar.gz/69953536d4ef1252c8181c267d16c61263f0aa4c"
177+
RTO_ARCHIVE_SHA256="fd54d1871fc01ff0bb3db190dfaadaa8256edd68a4f3bb85ecc08b315fbf5bd4"
178+
RTO_ARCHIVE_PREFIX="rules_test_optimization-69953536d4ef1252c8181c267d16c61263f0aa4c"
179+
RTO_ARCHIVE_TYPE="tar.gz"
180+
RULES_GO_VARIANT="complete"
181+
RULES_GO_STRIP_PREFIX="third_party/rules_go_orchestrion_complete"
182+
DD_TRACE_GO_VERSION="v2.9.0-rc.2"
183+
ORCHESTRION_VERSION="v1.9.0"
184+
```
185+
186+
The archive URL, SHA256, and prefix are tied to the repository commit. Use the
187+
same values with `RULES_GO_VARIANT="base"` and
188+
`RULES_GO_STRIP_PREFIX="third_party/rules_go_orchestrion_base"` when a
189+
consumer should use the base variant instead of the complete variant.
190+
171191
Consumers using the Go bootstrap can print the same tuple or write a
172192
repository-local summary:
173193

docs/Installation_Reference.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,9 @@ For mirrored/archive installs, also pin and verify archive `sha256` values (see
8989
"Archive mirror installation" below) so the fetched source is integrity-checked
9090
in CI and local builds.
9191

92+
For `v1.2.0`, use commit
93+
`69953536d4ef1252c8181c267d16c61263f0aa4c`.
94+
9295
### Generate published Go pins
9396

9497
Before copying Go/Orchestrion pins into a consumer repository, generate them
@@ -110,6 +113,26 @@ The command prints the full tuple used by WORKSPACE archive mode:
110113
`ORCHESTRION_VERSION`. Published GitHub codeload pins are `tar.gz`; use a
111114
separate repository-owned mirror process for any other archive format.
112115

116+
#### Current `v1.2.0` published tuple
117+
118+
```bash
119+
RTO_COMMIT="69953536d4ef1252c8181c267d16c61263f0aa4c"
120+
RTO_REMOTE="https://github.com/DataDog/rules_test_optimization.git"
121+
RTO_ARCHIVE_URL="https://codeload.github.com/DataDog/rules_test_optimization/tar.gz/69953536d4ef1252c8181c267d16c61263f0aa4c"
122+
RTO_ARCHIVE_SHA256="fd54d1871fc01ff0bb3db190dfaadaa8256edd68a4f3bb85ecc08b315fbf5bd4"
123+
RTO_ARCHIVE_PREFIX="rules_test_optimization-69953536d4ef1252c8181c267d16c61263f0aa4c"
124+
RTO_ARCHIVE_TYPE="tar.gz"
125+
RULES_GO_VARIANT="complete"
126+
RULES_GO_STRIP_PREFIX="third_party/rules_go_orchestrion_complete"
127+
DD_TRACE_GO_VERSION="v2.9.0-rc.2"
128+
ORCHESTRION_VERSION="v1.9.0"
129+
```
130+
131+
The archive URL, SHA256, and prefix are tied to the repository commit. Use the
132+
same values with `RULES_GO_VARIANT="base"` and
133+
`RULES_GO_STRIP_PREFIX="third_party/rules_go_orchestrion_base"` when a
134+
consumer should use the base variant instead of the complete variant.
135+
113136
From a consumer that already has the Go companion available, the bootstrap can
114137
print the same tuple or write a checked-in Markdown summary:
115138

docs/Language_Onboarding.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -233,7 +233,10 @@ Start by identifying the existing Go shape:
233233
Wire the public WORKSPACE helper instead of copying patch directories or
234234
declaring `patches = [...]`. Use `rules_go_variant = "base"` for normal
235235
repositories. Use `rules_go_variant = "complete"` only when the repository
236-
needs the declared extended monorepo compatibility variant.
236+
needs the declared extended monorepo compatibility variant. Use the current
237+
published tuple from
238+
[`docs/Installation_Reference.md`](Installation_Reference.md#current-v120-published-tuple)
239+
for the commit, archive URL, archive SHA256, and archive prefix values.
237240

238241
```bzl
239242
load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")

docs/Troubleshooting.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,9 @@ or a tuple that was not generated from the real GitHub codeload archive.
116116

117117
3. **Keep the generated tuple together**. If `RTO_COMMIT`,
118118
`RTO_ARCHIVE_URL`, `RTO_ARCHIVE_SHA256`, and `RTO_ARCHIVE_PREFIX` come from
119-
different commits, archive mode will fail or fetch the wrong source.
119+
different commits, archive mode will fail or fetch the wrong source. The
120+
current published tuple is tracked in
121+
[`docs/Installation_Reference.md`](Installation_Reference.md#current-v120-published-tuple).
120122

121123
4. **Authenticate private archive downloads**. The helper uses `GITHUB_TOKEN`,
122124
`GH_TOKEN`, or `gh auth token` when available. If codeload returns `404` for

tools/agent-skills/go-test-optimization-onboarding/references/workspace-onboarding.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,9 @@ From this repository, generate published pins with:
5050
```
5151

5252
Use `--variant base` for normal repositories and `--variant complete` for large
53-
monorepos that need the compatibility layer.
53+
monorepos that need the compatibility layer. The current published release
54+
tuple is tracked in
55+
[`docs/Installation_Reference.md`](../../../../docs/Installation_Reference.md#current-v120-published-tuple).
5456

5557
```bzl
5658
load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")

0 commit comments

Comments
 (0)