docs: Update for Buildkite vCurrent (#1307)

docs/deep-dives/arm64.md

@@ -28,17 +28,14 @@ On AWS' cloud platform, this means [Graviton-based] instances rather than Intel-
 
 If you'd like to build and run your projects on ARM64 hardware,
 specify a Buildkite cluster with a Graviton-based instance type.
-Your strategy file may look something like this:
+This is now the default for `vCurrent` strategies:
 
 ```yaml
+schemaVersion: vCurrent
 clusters:
-  - agentTags:
-      os: linux
-    # ...
-    instance:
-      agentsPerInstance: 2
-      # ...
-      instanceType: t4g.xlarge # g is for Graviton
+  - # Take care to right-size instances and disk size
+    instanceType: t4g.large # Optional; g is for Graviton
+    rootVolumeSize: 8 # Optional
 ```
 
 See [Builds at SEEK] and the [Gantry ARM reference] for more information.
@@ -86,7 +83,7 @@ provider:
 ```
 
 [aws cdk]: https://docs.aws.amazon.com/cdk/latest/guide/work-with-cdk-typescript.html
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [ci/cd]: ./buildkite.md
 [gantry]: https://backstage.myseek.xyz/docs/default/component/gantry/
 [gantry arm reference]: https://backstage.myseek.xyz/docs/default/component/gantry/v1/reference/using-arm/

docs/deep-dives/buildkite.md

@@ -110,7 +110,7 @@ The agent may be tied up running a particularly compute- or memory-intensive ste
 [`skuba test`]: ../cli/test.md#skuba-test
 [buildkite.annotate]: ../development-api/buildkite.md#annotate
 [buildkite annotations]: https://buildkite.com/docs/agent/v3/cli-annotate
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz/
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [ci/cd]: https://en.wikipedia.org/wiki/CI/CD
 [compose file]: https://docs.docker.com/compose/compose-file
 [docker buildkite plugin]: https://github.com/buildkite-plugins/docker-buildkite-plugin

template/express-rest-api/README.md

@@ -19,7 +19,7 @@ Next steps:
 6. [ ] Configure [GitHub repository settings].
 7. [ ] Delete this checklist 😌.
 
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [github repository settings]: https://github.com/<%-orgName%>/<%-repoName%>/settings
 
 ## Design

template/greeter/README.md

@@ -17,7 +17,7 @@ Next steps:
 5. [ ] Configure [GitHub repository settings].
 6. [ ] Delete this checklist 😌.
 
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [github repository settings]: https://github.com/<%-orgName%>/<%-repoName%>/settings
 
 ## Design

template/koa-rest-api/README.md

@@ -19,7 +19,7 @@ Next steps:
 6. [ ] Configure [GitHub repository settings].
 7. [ ] Delete this checklist 😌.
 
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [github repository settings]: https://github.com/<%-orgName%>/<%-repoName%>/settings
 
 ## Design

template/lambda-sqs-worker/README.md

@@ -18,7 +18,7 @@ Next steps:
 6. [ ] Configure [GitHub repository settings].
 7. [ ] Delete this checklist 😌.
 
-[builds at seek]: https://builds-at-seek.ssod.skinfra.xyz
+[builds at seek]: https://backstage.myseek.xyz/docs/default/component/builds-cicd-seek/
 [github repository settings]: https://github.com/<%-orgName%>/<%-repoName%>/settings
 
 ## Design