Upload Raw Files to Sonatype Nexus

Goal

Transfer a component version and upload its resources as plain files into a Nexus raw hosted repository, so that consumers download them by URL.

You’ll end up with

  • Each resource stored as a file in the Nexus raw repository raw-hosted
  • Transferred resources with a Wget/v1 access on the stored files

Estimated time: ~10 minutes

Prerequisites

Steps

Configure the uploader

Add the credentials and one uploader rule for all LocalBlob resources to your .ocmconfig in the working directory (merged with $HOME/.ocmconfig):

type: generic.config.ocm.software/v1
configurations:
  - type: credentials.config.ocm.software
    consumers:
      - identity:
          type: Wget
          hostname: nexus.example.com
          scheme: https
        credentials:
          - type: WgetCredentials/v1
            username: <USERNAME>
            password: <PASSWORD_OR_USER_TOKEN>
  - type: nexus.uploader.transfer.config.ocm.software/v1alpha1
    match: resource.access.isType("LocalBlob")
    url: https://nexus.example.com
    repository: raw-hosted
    # optional, defaults to <component>/<component version>/<resource>-<resource version>
    path: '${"files/" + resource.name + ".txt"}'

Run the transfer

ocm transfer cv ctf::./src//ocm.software/demo:1.0.0 ctf::./target

Verify

ocm get cv ctf::./target//ocm.software/demo:1.0.0 -o yaml

The notes resource has this access:

access:
  type: Wget/v1
  url: https://nexus.example.com/repository/raw-hosted/files/notes.txt
  mediaType: text/plain

Download the file:

curl -fsSL -u <USERNAME>:<PASSWORD_OR_USER_TOKEN> https://nexus.example.com/repository/raw-hosted/files/notes.txt

How the repository behaves

  • Any access type is accepted and the content is stored as is.

  • OCI images are uploaded as one gzipped OCI layout tar (application/vnd.ocm.software.oci.layout.v1+tar+gzip).

  • A stored file is never overwritten, see Existing files at the upload path. A file with different content fails the transfer:

    nexus repository "raw-hosted" already stores a different file at …; the uploader never overwrites files in raw repositories, configure a different path

Troubleshooting

For credential and overwrite errors, see Troubleshooting.

Prev
Upload Generic Files to JFrog Artifactory
Next
Configure Credentials for Signing