https://github.com/dangernoodle-io/codeartifact-maven-extension
Maven extension that provides AWS CodeArtifact authentication
https://github.com/dangernoodle-io/codeartifact-maven-extension
codeartifact maven-resolver maven-wagon
Last synced: 4 months ago
JSON representation
Maven extension that provides AWS CodeArtifact authentication
- Host: GitHub
- URL: https://github.com/dangernoodle-io/codeartifact-maven-extension
- Owner: dangernoodle-io
- Created: 2023-03-04T18:47:08.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-17T20:08:00.000Z (10 months ago)
- Last Synced: 2025-06-17T20:38:01.001Z (10 months ago)
- Topics: codeartifact, maven-resolver, maven-wagon
- Language: Java
- Homepage:
- Size: 52.7 KB
- Stars: 5
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# codeartifact-maven-extension

[](https://github.com/dangernoodle-io/codeartifact-maven-extension/actions/workflows/maven-build.yml)
[](https://github.com/dangernoodle-io/codeartifact-maven-extension/actions/workflows/maven-release.yml)
[](https://coveralls.io/github/dangernoodle-io/codeartifact-maven-extension?branch=main)
Maven `build` extension that provides a [resolver](https://maven.apache.org/resolver/index.html) and
[wagon](https://maven.apache.org/wagon/index.html) implementation capable of authenticating against
[AWS CodeArtifact](https://aws.amazon.com/codeartifact/) before uploading/downloading artifacts.
Java 8 or greater is required. The appropriate implementation will automatically be selected based upon your maven
version. See [here](https://maven.apache.org/guides/mini/guide-resolver-transport.html) for additional details.
## Usage
The easiest way to configure the plugin is to add an entry to the `.mvn/extensions.xml` file (see [here](https://maven.apache.org/configure.html)
for more details) like so:
```xml
io.dangernoodle
codeartifact-maven-extension
${codeartifact-maven-extension.version}
```
This is the recommended approach if you use a parent pom that is also stored within `codeartifact`. If you have a
standalone project and don't wish to use the `.mvn` directory, you can add the following to the build section of
your project's pom:
```xml
io.dangernoodle
codeartifact-maven-extension
${codeartifact-maven-extension.version}
...
```
### Credentials
The extension automatically uses the [DefaultCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/DefaultCredentialsProvider.html) to find AWS credentials. Be sure you have
configured your environment accordingly.
Separately, static credentials can be provided in an a `server` entry in `maven-settings.xml`
```xml
codeartifact
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
```
Make sure you are using appropriate security precautions if you are using static credentials.