A local (read-only) proxy for Bazel to access Maven resources behind a secure repository or from the local Maven repo
- Provides password-less access to Maven repositories requiring authentication via
https://127.0.0.1:8499/maven/<repository-id>/...
(therepository-id
is used from~/.m2/settings.xml
) - Reads Maven authentication information from
~/.m2/settings.xml
- Delivers artifacts from local Maven repository (
~/.m2/repository
) when available - Secure by default
- Only listens locally on
127.0.0.1
(no external access possible) - Encrypted access with self-signed certificate via
https://localhost:8499/
- Only listens locally on
- Unsecure access must be explicitly enable via command line parameter
- Supports HTTP/2 access and can talk HTTP/2 or HTTP/1.1 to back-end Maven repositories
- Build:
bazel build //:maven_proxy
- Run:
bazel run //:maven_proxy -- --help
(on Linux/macOS)
In case you need to use a different JDK you can create a .bazelrc-local
file.
Please have a look at .bazelrc
for further instructions.
Usage: bazel-maven-proxy [--local-maven-repository=PATH]
[--unsecure-port=<unsecurePort>]
[-c=PROXY-CONFIG-YAML] [-p=<port>]
[-s=MAVEN-SETTINGS-XML]
Starts the Bazel Maven Proxy
--local-maven-repository=PATH
path to Maven's local repositorty (default: ~/.m2/repository/)
--unsecure-port=<unsecurePort>
unsecure port to listen on (default is none, set to >0 to
enable)
-c, --config-file=PROXY-CONFIG-YAML
proxy configuration file with additional repositories to
proxy, i.e. path to proxy-config.yaml
-p, --port=<port> port to listen on (HTTP/2 and HTTP 1.1 with self-sign
'localhost' certificate)
-s, --maven-settings=MAVEN-SETTINGS-XML
path to Maven's settings.xml to read repositories and
authentication informatiom from (default: ~/.m2/settings.xml)
Please ensure that your ~/.m2/settings.xml
has an entry for your repository like this:
...
<servers>
<server>
<id>mynexus</id>
<username>...</username>
<password>...</password>
</server>
<server>
<id>central</id>
<username>...</username>
<password>...</password>
</server>
</servers>
...
<profiles>
<profile>
<id>mynexus</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<repositories>
<repository>
<id>central</id>
<url>https://my-central-mirror.internal.network.com/..</url>
</repository>
<repository>
<id>mynexus</id>
<url>https://my-nexus-repo.internal.network.com/..</url>
</repository>
</repositories>
...
</profile>
</profiles>
Then in Bazel (or anywhere else) you can refer to these as http(s)://localhost:<port>/maven/mynexus/..
and http(s)://localhost:<port>/maven/central/..
.