Update docs for Java 25 and GKE migration (#3089)

Summarize all documentation updates across the repository to align with modern GKE, Cloud SQL Proxy v2, standard EPP fee v1.0, and Postgres database environments.

Key Updates:
- Prerequisites: Bump Java requirement to Java 25.
- Architecture & Scaling: Document GKE workloads, Cloud Tasks queues, and scheduled tasks. Replace App Engine references with GKE deployment restart commands (kubectl rollout restart).
- Configuration: Update Cloud SQL Proxy instructions to v2, fix keyring verification commands, and document IAP configuration.
- Escrow (RDE/BRDA): Fix manual generation and download procedures to match the Dataflow job ID folder structure, and correct deposit encryption/verification command parameters.
- Monitoring: Correct metric names and expand the documented metrics list with caching, locking, and reserved list metrics.
- Fixes: Standardize lists formatting across markdown files, fix broken webdriver links, and resolve various typos.
- Cleanup: Remove leftover cloud scheduler configurations for the deleted wipeOutContactHistoryPii task, and update ICANN reporting documentation to reflect open-sourced DNS query coordinator.

TAG=agy
CONV=88271e71-e272-40e0-85f8-a075a423b7c2
This commit is contained in:
Ben McIlwain
2026-06-22 18:20:00 +00:00
committed by GitHub
parent ae61922318
commit dcfe939c38
22 changed files with 331 additions and 192 deletions
+12 -7
View File
@@ -6,9 +6,9 @@ This document covers the steps necessary to download, build, and deploy Nomulus.
You will need the following programs installed on your local machine:
* A recent version of the [Java 21 JDK][java-jdk21].
* A recent version of the [Java 25 JDK][java-jdk25].
* The [Google Cloud CLI](https://docs.cloud.google.com/sdk/docs/install-sdk)
(configure an alias to the `gcloud`utility, because you'll use it a lot)
(configure an alias to the `gcloud` utility, because you'll use it a lot)
* [Git](https://git-scm.com/) version control system.
* Docker (confirm with `docker info` no permission issues, use `sudo groupadd
docker` for sudoless docker).
@@ -63,7 +63,7 @@ while.
## Create and configure a GCP project
First,
[create an application](https://cloud.google.com/appengine/docs/java/quickstart)
[create a project][create-project]
on Google Cloud Platform. Make sure to choose a good Project ID, as it will be
used repeatedly in a large number of places. If your company is named Acme, then
a good Project ID for your production environment would be "acme-registry". Keep
@@ -123,10 +123,14 @@ $ gcloud container clusters create proxy-cluster \
--num-nodes=3 \
--enable-ip-alias
```
Then create an artifact repository:
Then create an artifact repository: `shell $ gcloud artifacts repositories
create nomulus-repo \ --repository-format=docker \ --location=$REGION \
--description="Nomulus Docker images"`
```shell
$ gcloud artifacts repositories create nomulus-repo \
--repository-format=docker \
--location=$REGION \
--description="Nomulus Docker images"
```
See the files and documentation in the `release/` folder for more information on
the release process. You will likely need to customize the internal build
@@ -141,7 +145,8 @@ can rebuild and start using the `nomulus` tool to create test entities in your
newly deployed system. See the [first steps tutorial](./first-steps-tutorial.md)
for more information.
[java-jdk21]: https://www.oracle.com/java/technologies/javase-downloads.html
[java-jdk25]: https://www.oracle.com/java/technologies/javase-downloads.html
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
## Deploy the Beam Pipelines