Add Sonatype Nexus repository integration module #262

MAVRICK-1 · 2025-07-29T18:17:14Z

Add Sonatype Nexus Repository Integration Module

Summary

Implements a Coder module for Sonatype Nexus Repository Manager integration that automatically configures Maven, npm, PyPI, and Docker registries for development workspaces.

Demo Video & Screenshots

Screencast.from.2025-07-29.23-34-36.mp4

Features

✅ Maven Support: Automatic settings.xml configuration
✅ npm Support: Automatic .npmrc configuration with scoped packages
✅ PyPI Support: Automatic pip.conf configuration
✅ Docker Support: Registry authentication setup
✅ Flexible Configuration: Support for multiple repositories per package manager
✅ Secure Credentials: API token and password support
✅ Username Options: Configurable username field (username or email)

Nexus Repository Manager Requirements

Version Requirements

Yes, this module requires Nexus Repository Manager Pro version for full functionality, though basic features work with the Community Edition (OSS).

Supported Authentication Methods

This module supports 4 authentication methods:

User Token Authentication (Recommended - Pro only)
- Enhanced security with two-part tokens
- Ideal for CI/CD and automated environments
- Requires nx-usertoken-current privilege
API Token Authentication (Pro only)
- Single-use access tokens via REST API
- Programmatic token generation and management
Basic Authentication (OSS & Pro)
- Standard HTTP Basic Auth with username/password
- Works with both OSS and Pro versions
Base64 Encoded Credentials (OSS & Pro)
- Base64 encoded username:password format
- Compatible with npm and other package managers

Testing Instructions

Prerequisites

Nexus Repository Manager instance (OSS or Pro)
Admin access to configure repositories
Test repositories for each package manager you want to test

Setup Test Environment

Create Test Repositories in your Nexus instance:
- Maven: maven-public, maven-releases
- npm: npm-public, @company:npm-private
- PyPI: pypi-public, pypi-private
- Docker: docker-public, docker-private
Configure Authentication:
- For Pro: Generate user tokens via UI (User menu → User Token)
- For OSS: Use username/password or base64 encoded credentials
- Set up appropriate permissions for test repositories

Test the Module:

module "nexus" {
  source         = "registry.coder.com/mavrickrishi/nexus/coder"
  version        = "1.0.0"
  agent_id       = coder_agent.main.id
  nexus_url      = "https://your-nexus-instance.com"
  nexus_password = var.nexus_api_token  # or password
  package_managers = {
    maven  = ["maven-public", "maven-releases"]
    npm    = ["npm-public", "@company:npm-private"]
    pypi   = ["pypi-public", "pypi-private"]
    docker = ["docker-public", "docker-private"]
  }
}

Verify Configuration:
- Check generated config files in workspace
- Test package installation from configured repositories
- Verify authentication works for each package manager

EC2 Deployment Testing

Tested by deploying on EC2 instance with:

Ubuntu 22.04 LTS
Nexus Repository Manager Pro
All package managers (Maven, npm, PyPI, Docker)
Both token and basic authentication methods

Usage Example

module "nexus" {
  source         = "registry.coder.com/mavrickrishi/nexus/coder"
  version        = "1.0.0"
  agent_id       = coder_agent.main.id
  nexus_url      = "https://nexus.company.com"
  nexus_password = var.nexus_api_token
  package_managers = {
    maven  = ["maven-public", "maven-releases"]
    npm    = ["npm-public", "@company:npm-private"]
    pypi   = ["pypi-public", "pypi-private"]
    docker = ["docker-public", "docker-private"]
  }
}

Testing

✅ 11 comprehensive tests covering all functionality
✅ Variable validation tests
✅ Package manager configuration tests
✅ Error handling tests
✅ All tests passing
✅ EC2 deployment tested

Files Added

registry/mavrickrishi/modules/nexus/main.tf - Main module configuration
registry/mavrickrishi/modules/nexus/README.md - Complete documentation
registry/mavrickrishi/modules/nexus/main.test.ts - Test suite

Checklist

Closes #202
/claim #202

- Add nexus module with support for Maven, npm, PyPI, and Docker registries - Includes comprehensive test suite with 11 passing tests - Supports configurable repositories per package manager - Automatic configuration of package manager settings - Secure credential handling with API token support - Flexible username configuration (username or email) - Complete documentation with usage examples Resolves coder#202

Co-authored-by: Copilot <[email protected]>

- Fix Terraform formatting with terraform fmt - Fix README formatting with prettier - All linting checks now pass

MAVRICK-1 · 2025-07-29T18:38:24Z

linting issue fixed

bpmct · 2025-07-30T01:06:03Z

How does the user authenticate their account?

MAVRICK-1 · 2025-07-30T01:19:10Z

@bpmct through url and password

matifali

Left a few suggestions.

registry/mavrickrishi/modules/nexus/README.md

registry/mavrickrishi/modules/nexus/main.tf

matifali · 2025-07-30T07:46:10Z

Does it work with https://help.sonatype.com/en/user-tokens.html?

matifali · 2025-07-30T07:47:43Z

Also, @michaelbrewer, do you use https://help.sonatype.com/en/user-tokens.html based authentication?

MAVRICK-1 · 2025-07-30T09:38:29Z

Does it work with https://help.sonatype.com/en/user-tokens.html?

yeah

matifali

I think we should rename eModule to be valued Nexus repository as Nexus has multiple other products. Please also update all other references.

matifali · 2025-07-30T09:42:00Z

registry/mavrickrishi/modules/nexus/README.md

+---
+display_name: Sonatype Nexus Repository
+description: Configure package managers to use Sonatype Nexus Repository for Maven, npm, PyPI, and Docker registries.
+icon: /.icons/nexus.svg


This is not the correct path. It should be the relative path to .icons/nexus.svg

registry/mavrickrishi/modules/nexus/README.md

Co-authored-by: Atif Ali <[email protected]>

Copilot

Pull Request Overview

This PR adds a comprehensive Sonatype Nexus Repository integration module for Coder that automatically configures Maven, npm, PyPI, and Docker registries for development workspaces with secure credential handling.

Implements a complete Nexus integration module with support for multiple package managers
Provides secure credential handling using API tokens and password authentication
Includes comprehensive test coverage with 11 tests covering all functionality

Reviewed Changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
registry/mavrickrishi/modules/nexus/main.tf	Main Terraform module with variable definitions, validation rules, and script configuration
registry/mavrickrishi/modules/nexus/run.sh	Shell script that configures package managers (Maven, npm, PyPI, Docker) with Nexus repositories
registry/mavrickrishi/modules/nexus/main.test.ts	Comprehensive test suite with 11 tests covering all module functionality
registry/mavrickrishi/modules/nexus/README.md	Complete documentation with usage examples for all supported package managers
registry/mavrickrishi/README.md	Registry metadata and module listing for the mavrickrishi namespace

registry/mavrickrishi/modules/nexus/run.sh

registry/mavrickrishi/modules/nexus/main.tf

Co-authored-by: Copilot <[email protected]>

MAVRICK-1 · 2025-07-30T10:17:14Z

test passed

matifali · 2025-07-30T10:33:22Z

One last thing
to make it in parity with JFrog is the go support. Can you add that too? I am setting up a Nexus Repository instance to test it as soon as I can.

…EADME

MAVRICK-1 · 2025-07-30T10:44:08Z

@matifali ✅ Go support has been added! The module now supports Maven, npm, Go, PyPI, and Docker - achieving full parity with the JFrog module

MAVRICK-1 · 2025-07-30T10:46:38Z

@matifali how to solve this ? my username is mavrick-1

matifali · 2025-07-30T13:01:58Z

@MAVRICK-1, can you also rename the module to nexus-repository at all relevant places? Same for icon. Let us be very explicit that this module only enables integration with the Nexus repository. and not all Nexys Sontaype products.

Regarding that false typo, you need to add an exception in .github/typos.toml

- Updated .github/typos.toml to exclude false positives for mavrickrishi's README.md. - Added nexus-repository.svg icon for the Nexus Repository module. - Updated README.md for mavrickrishi to reflect the new nexus-repository module. - Created README.md for the nexus-repository module with detailed configuration instructions. - Implemented main.tf for the nexus-repository module, defining necessary variables and resources. - Added main.test.ts for testing the nexus-repository module functionalities. - Created run.sh script to configure Nexus repository access for various package managers.

MAVRICK-1 · 2025-07-30T13:43:49Z

@matifali done

matifali

Last few suggestions and good to go from my side. I will test it and then give the final approval. Great work so far.

.github/typos.toml

…e entry

MAVRICK-1 · 2025-07-30T13:58:15Z

updated both for mavrick and mavrickrishi

MAVRICK-1 · 2025-08-04T10:05:05Z

test failed in other module, @matifali any update ?

matifali

Thanks for the Contribution. Can you please linnk the main demo video in the PR body? Also add some intsruction to test it on SonaType Nexus. Does it require a pro version of Nexus Sonatype? What Auth methods are supported?

MAVRICK-1 · 2025-08-04T19:04:54Z

@matifali yes it required pro, added everything in Pr

MAVRICK-1 · 2025-08-04T19:15:37Z

i took a free pro trail by reaching [email protected]

algora-pbc bot added the 🙋 Bounty claim label Jul 29, 2025

algora-pbc bot mentioned this pull request Jul 29, 2025

Add Sonatype Nexus repository integration module #202

Open

matifali requested a review from Copilot July 29, 2025 18:29

This comment was marked as outdated.

Sign in to view

MAVRICK-1 and others added 4 commits July 30, 2025 00:04

Update registry/mavrickrishi/modules/nexus/main.tf

e2d8aad

Co-authored-by: Copilot <[email protected]>

Update registry/mavrickrishi/modules/nexus/main.tf

2a892ad

Co-authored-by: Copilot <[email protected]>

Update registry/mavrickrishi/modules/nexus/main.tf

20e9a32

Co-authored-by: Copilot <[email protected]>

fix: apply code formatting

af94e5b

- Fix Terraform formatting with terraform fmt - Fix README formatting with prettier - All linting checks now pass

matifali reviewed Jul 30, 2025

View reviewed changes

fixed changes

db7afc8

MAVRICK-1 requested a review from matifali July 30, 2025 09:38

matifali reviewed Jul 30, 2025

View reviewed changes

matifali requested review from Copilot and DevelopmentCats July 30, 2025 09:44

Update registry/mavrickrishi/modules/nexus/README.md

09905c3

Co-authored-by: Atif Ali <[email protected]>

Copilot AI reviewed Jul 30, 2025

View reviewed changes

registry/mavrickrishi/modules/nexus/run.sh Outdated Show resolved Hide resolved

registry/mavrickrishi/modules/nexus/main.tf Outdated Show resolved Hide resolved

registry/mavrickrishi/modules/nexus/main.tf Outdated Show resolved Hide resolved

MAVRICK-1 and others added 3 commits July 30, 2025 15:19

Update registry/mavrickrishi/modules/nexus/main.tf

56f5990

Co-authored-by: Copilot <[email protected]>

Update registry/mavrickrishi/modules/nexus/main.tf

3c890d0

Co-authored-by: Copilot <[email protected]>

fix: update Nexus module configurations and README details

88f8284

MAVRICK-1 requested a review from matifali July 30, 2025 10:31

feat: add support for Go package manager in Nexus module and update R…

f375e5f

…EADME

feat: add test for configuring Go module proxy in Nexus module

97d144b

MAVRICK-1 added 2 commits July 30, 2025 19:13

Merge branch 'main' into feat/nexus-repository-module

1b01b37

Delete .icons/nexus.svg

5534564

matifali reviewed Jul 30, 2025

View reviewed changes

.github/typos.toml Outdated Show resolved Hide resolved

MAVRICK-1 added 2 commits July 30, 2025 19:25

fix: remove false positive entries from typos.toml and adjust usernam…

0854c5e

…e entry

fix: correct username entry for mavrickrishi in typos.toml

c520a19

MAVRICK-1 requested a review from matifali July 31, 2025 16:34

MAVRICK-1 added 2 commits August 1, 2025 22:25

Merge branch 'main' into feat/nexus-repository-module

f42da8f

Merge branch 'main' into feat/nexus-repository-module

9f2fe38

Merge branch 'main' into feat/nexus-repository-module

0a10b4d

matifali approved these changes Aug 4, 2025

View reviewed changes

Add Sonatype Nexus repository integration module #262

Are you sure you want to change the base?

Add Sonatype Nexus repository integration module #262

Conversation

MAVRICK-1 commented Jul 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add Sonatype Nexus Repository Integration Module

Summary

Demo Video & Screenshots

Features

Nexus Repository Manager Requirements

Version Requirements

Supported Authentication Methods

Testing Instructions

Prerequisites

Setup Test Environment

EC2 Deployment Testing

Usage Example

Testing

Files Added

Checklist

Uh oh!

This comment was marked as outdated.

Uh oh!

MAVRICK-1 commented Jul 29, 2025

Uh oh!

bpmct commented Jul 30, 2025

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

matifali left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

matifali commented Jul 30, 2025

Uh oh!

matifali commented Jul 30, 2025

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

matifali left a comment

Choose a reason for hiding this comment

Uh oh!

matifali Jul 30, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

matifali commented Jul 30, 2025

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

matifali commented Jul 30, 2025

Uh oh!

MAVRICK-1 commented Jul 30, 2025

Uh oh!

matifali left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

MAVRICK-1 commented Jul 29, 2025 •

edited

Loading

MAVRICK-1 commented Aug 4, 2025 •

edited

Loading