Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/salesforce/bazel-maven-proxy
A local (read-only) proxy for Bazel to access Maven resources behind a secure repository or from the local Maven repository
https://github.com/salesforce/bazel-maven-proxy
bazel bazel-deps bazel-rules maven
Last synced: about 1 month ago
JSON representation
A local (read-only) proxy for Bazel to access Maven resources behind a secure repository or from the local Maven repository
- Host: GitHub
- URL: https://github.com/salesforce/bazel-maven-proxy
- Owner: salesforce
- License: epl-2.0
- Created: 2019-05-06T12:01:54.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-04-18T22:23:26.000Z (over 1 year ago)
- Last Synced: 2024-05-15T14:31:22.879Z (7 months ago)
- Topics: bazel, bazel-deps, bazel-rules, maven
- Language: Java
- Size: 105 KB
- Stars: 23
- Watchers: 6
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-bazel - salesforce/bazel-maven-proxy - A local proxy to access Maven resources behind secure repositories or from the local repo (Tooling / <a name="misc-tooling"></a>Misc)
README
# Bazel Maven Proxy
A local (read-only) proxy for Bazel to access Maven resources behind a secure repository or from the local Maven repo
## Features
* Provides password-less access to Maven repositories requiring authentication via `https://127.0.0.1:8499/maven//...` (the `repository-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/`
* 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
## Getting Started
* Build: `bazel build //:maven_proxy`
* Run: `bazel run //:maven_proxy -- --help` (on Linux/macOS)
### Different JDK
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.
## Command Line Arguments
```
Usage: bazel-maven-proxy [--local-maven-repository=PATH]
[--unsecure-port=]
[-c=PROXY-CONFIG-YAML] [-p=]
[-s=MAVEN-SETTINGS-XML]
Starts the Bazel Maven Proxy
-c, --config-file=PROXY-CONFIG-YAML
proxy configuration file with (additional) repositories to
proxy, i.e. path to proxy-config.yaml
-h, --help Show this help message and exit.
--host= host name to listen on (default is 127.0.0.1, i.e. only
local connections allowed; use 0.0.0.0 to listen on all
interfaces)
--local-maven-repository=PATH
path to Maven's local repository (default: ~/.
m2/repository/)
-p, --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 information (default is ~/.
m2/settings.xml)
--unsecure-port=
non-secure (plain HTTP) port to listen on (default is none, set to >0 to
enable)
-V, --version Print version information and exit.
```
## How to Use
Please ensure that your `~/.m2/settings.xml` has an entry for your repository like this:
```
...
mynexus
...
...
central
...
...
...
mynexus
true
central
https://my-central-mirror.internal.network.com/..
mynexus
https://my-nexus-repo.internal.network.com/..
...
```
Then in Bazel (or anywhere else) you can refer to these as `http(s)://localhost:/maven/mynexus/..` and `http(s)://localhost:/maven/central/..`.
Alternatively to (or in addition to) `~/.m2/settings.xml` one can also provide a YAML configuration file.
See an example [here](server/src/test/resources/sample-proxy-config.yaml) for syntax.