Semantic-release-nexus NPM

semantic-release-nexus

Semantic Release Nexus Plugin

Description

This project is a plugin for the Semantic Release framework which will allow you to publish an arbitrary file type to a raw Nexus repository. This is great for pushing binaries, tars, zips, etc. to your Nexus instance for usage throughout your environment.

Install

yarn add semantic-release-nexus --dev

Usage

{
    "branches": ["main"],
    "plugins": [
        "@semantic-release/commit-analyzer",
        "@semantic-release/release-notes-generator",
        [
            "semantic-release-nexus",
            {
                "nexusHost": "https://some-host.yourdomain.com",
                "nexusPath": "your-super-cool-project",
                "assets": [
                    {
                        "path": "dist/your-super-cool-project-*-darwin.tar.gz"
                    },
                    {
                        "path": "dist/your-super-cool-project-*-linux.tar.gz"
                    },
                    {
                        "path": "dist/your-super-cool-project-*-windows.zip"
                    }
                ]
            }
        ]
    ]
}

Configuration

Authentication is not required but basic auth is supported via environment variables. You may set NEXUS_USER and NEXUS_PASSWORD (alternatively replacing NX for NEXUS) environment variables for basic auth.

Environment Variables

Variable	Description
`NEXUS_USER`/`NX_USER`	The Username of the service account used for basic auth.
`NEXUS_PASSWORD`/`NX_PASSWORD`	The Password of the service account used for basic auth.
`NEXUS_HOST`/`NX_HOST`	The hostname or CNAME of the Nexus instance.
`NEXUS_PATH`/`NX_PATH`	The Path/Directory/Group to host your assets.

Options

Option	Description	Default
`nexusHost`	The URL of the Nexus Host.	`NX_URL` or `NEXUS_URL` environment variable.
`nexusPath`	The group or path prefix to host the packages in Nexus.	`NX_PATH` or `NEXUS_PATH` environment variable.
`assets`	An array of files to upload to the release. See assets.	-

assets

Can be a glob or and Array of globs and Objects with the following properties:

Property	Description	Default
`path`	Required. A glob to identify the files to upload.	-
`name`	The name of the downloadable file on the GitHub release.	File name extracted from the `path`.

aggregate-error ajv axios form-data tiny-glob

@infinitebrahmanuniverse/nolb-sema @everything-registry/sub-chunk-2730

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago