I want to embed some version metadata into a .pex in such a way that it can be accessed from within code packaged by the pex. Is there a recommended way to do that?

Resources are probably the way to do that: https://www.pantsbuild.org/docs/assets#resources

And here is some info on generating such metadata from git state: https://www.pantsbuild.org/docs/generating-version-tags