Uploading Components
This section details uploading third-party or proprietary components to hosted repositories via the Nexus Repository user interface.
Requirements for Uploading Components in Nexus Repository
Before uploading components to Nexus Repository, ensure you meet the following requirements:
The user account requires these privileges; the privileges may be limited to a specific repository rather than global by replacing the stars with the format type and repository name.
nx-component-uploadnx-repository-admin-*-*-edit
Optionally, you may benefit from having the following privileges as well as they will allow you to view the results of your upload:
nx-repository-admin-*-*-browsenx-repository-admin-*-*-read
You may only upload to a hosted repository.
The files you upload must be a supported type for your intended repository's format.
Steps to Upload a Component in Nexus Repository
The steps below provide a basic outline for uploading a component to a hosted repository in Nexus Repository. However, note that available form fields differ between formats:
From the Browse view in Nexus Repository (available by selecting the cube icon in the top navigation bar), navigate to either the Upload or Browse screen.
Select the hosted repository to which you would like to upload a component.
When performing this action from the Browse table of repositories, you need to select the Upload component button.
When performing this action from the Upload section, you are taken directly to the upload form.
Select the Choose File button; then, select the file you would like to upload.
Provide details in the form for the given repository format. For example, the Maven format requires component coordinates. See Uploading a Pom File to a Maven Repository for more details.
(Pro Only) Optionally, add any desired tags to the component. The tags must already exist in the Nexus Repository to add them during the component upload. See Tagging to learn more.
Select Upload at the bottom of the form.
Upon successful upload, you will be taken to search results for the path to the component that you uploaded.
Uploading a Pom File to a Maven Repository
When uploading a pom file to a Maven repository, Nexus Repository extracts the coordinates from the file. The other artifacts uploaded at the same time are included in the extracted coordinates.
The table below details what each component coordinate indicates:
Field | Description |
|---|---|
Group ID | A group identifier represents the reserved namespace by the stakeholders for their components. Groups often reflect the organization under which the software component is produced. |
Artifact ID | The artifact identifier is the descriptive name for a software component. The combination of a group identifier and artifact identifier must be unique. |
Version | The version of a project in semantic versioning. Versions may include alphanumeric qualifiers to denote the release status such as "1.2.3-BETA". |
Packaging | The packaging describes the binary software format, such as; |
Advanced Usage
The file upload is intended for simple access to uploading through the UI. To batch uploads or automatically extract coordinates from the .jar file, see the REST and Integration API.
Repository format | Valid file types | Multiple file upload |
|---|---|---|
Maven release only | No restrictions, common types include
|
|
Raw | No restrictions |
|
Apt |
|
|
Helm |
|
|
npm |
|
|
NuGet |
|
|
PyPI |
|
|
R |
|
|
RubyGems |
|
|
Yum | None with permissive policy otherwise |
|
