Update Grpc
Developmentupdate-grpcUpdate Grpc is an Agent Skill for development published in the glowroot/glowroot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Procedure to update gRPC, Netty, and BoringSSL versions in this Java/Maven project while maintaining compatibility
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/glowroot/glowroot/blob/HEAD/.claude/skills/update-grpc/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/update-grpc, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
gRPC, Netty, and BoringSSL are tightly coupled together. Incompatible version combinations will cause runtime failures. When updating gRPC, you must follow this procedure:
-
Browse the compatibility matrix at https://github.com/grpc/grpc-java/blob/master/SECURITY.md#netty to determine the correct Netty and BoringSSL (netty-tcnative-boringssl-static) versions for the target gRPC version.
-
Update the version properties in all of the following POM files:
pom.xml(root)central/pom.xmlagent/shaded/core/pom.xmlagent/shaded/central-https-linux/pom.xmlagent/shaded/central-https-windows/pom.xmlagent/shaded/central-https-osx/pom.xml
-
All three versions (gRPC, Netty, BoringSSL) must be updated together — never update one without checking the others.
-
After modifying the POM files, grep the project for any other references to the old versions to ensure nothing was missed:
grep -r "OLD_GRPC_VERSION" --include="pom.xml"
grep -r "OLD_NETTY_VERSION" --include="pom.xml"
grep -r "OLD_BORINGSSL_VERSION" --include="pom.xml"