将工件上传到 Nexus，无需 Maven

Question

我有一个生成版本化构建工件的非 Java 项目，我想将其上传到 Nexus 存储库。由于该项目不是 Java，因此它不使用 Maven 进行构建。我不想引入 Maven/POM 文件只是为了将文件导入 Nexus。

博客上的 Nexus REST API 链接最终都出现在登录墙上，我看不到“创建用户”链接。

那么，在没有 Maven 的情况下将构建工件上传到 Nexus 存储库的最佳（或任何合理）方法是什么？ “bash +curl”会很棒，甚至是一个 Python 脚本。

Answer 1

您是否考虑过使用 Maven 命令行上传文件？

mvn deploy:deploy-file \
    -Durl=$REPO_URL \
    -DrepositoryId=$REPO_ID \
    -DgroupId=org.myorg \
    -DartifactId=myproj \
    -Dversion=1.2.3  \
    -Dpackaging=zip \
    -Dfile=myproj.zip

这将自动生成工件的 Maven POM。

更新

以下 Sonatype 文章指出“deploy-file”maven 插件是最简单的解决方案，但它还提供了一些使用curl 的示例：

https://support.sonatype.com/entries/22189106-How-can-I-programatically-upload-an-artifact -进入-Nexus-

Answer 2

使用curl：

curl -v \
    -F "r=releases" \
    -F "g=com.acme.widgets" \
    -F "a=widget" \
    -F "v=0.1-1" \
    -F "p=tar.gz" \
    -F "file=@./widget-0.1-1.tar.gz" \
    -u myuser:mypassword \
    http://localhost:8081/nexus/service/local/artifact/maven/content

您可以在此处查看参数的含义： https://support.sonatype.com/entries/22189106-How-can-I-programatically-upload-an-artifact-into-Nexus-

为了使这项工作的权限，我创建了一个新角色管理 GUI 和我为该角色添加了两个权限：Artifact Download 和 Artifact Upload。标准的“Repo：所有 Maven 存储库（完全控制）”角色还不够。
您在 Nexus 服务器附带的 REST API 文档中找不到此内容，因此这些参数将来可能会发生变化。

在 Sonatype JIRA 问题上，有人提到他们“将彻底改革 REST API（及其方式）文档是在即将发布的版本中生成的，很可能是在今年晚些时候”。

Answer 3

您绝对可以在不使用任何与 MAVEN 相关的内容的情况下执行此操作。我个人使用NING HttpClient（v1.8.16，支持java6）。

无论出于何种原因，Sonatype 都让我们很难弄清楚正确的 URL、标头和有效负载应该是什么；我不得不嗅探流量并猜测...那里有一些几乎有用的博客/文档，但是它要么与oss.sonatype.org无关，要么就是基于 XML（我发现它根本不起作用）。恕我直言，他们的文档是垃圾，希望未来的寻求者能发现这个答案有用。非常感谢 https://stackoverflow.com/a/33414423/2101812 他们的帖子，因为它很有帮助。

如果您在 oss.sonatype.org 以外的地方发布，只需将其替换为正确的主机即可。

这是我为完成此任务而编写的（CC0 许可）代码。其中 profile 是您的 sonatype/nexus profileID（例如 4364f3bbaf163）和 repo（例如 comdorkbox-1003）当您上传初始 POM/Jar 时，会从响应中解析。

关闭存储库：

/**
 * Closes the repo and (the server) will verify everything is correct.
 * @throws IOException
 */
private static
String closeRepo(final String authInfo, final String profile, final String repo, final String nameAndVersion) throws IOException {

    String repoInfo = "{'data':{'stagedRepositoryId':'" + repo + "','description':'Closing " + nameAndVersion + "'}}";
    RequestBuilder builder = new RequestBuilder("POST");
    Request request = builder.setUrl("https://oss.sonatype.org/service/local/staging/profiles/" + profile + "/finish")
                             .addHeader("Content-Type", "application/json")
                             .addHeader("Authorization", "Basic " + authInfo)

                             .setBody(repoInfo.getBytes(OS.UTF_8))

                             .build();

    return sendHttpRequest(request);
}

升级存储库：

/**
 * Promotes (ie: release) the repo. Make sure to drop when done
 * @throws IOException
 */
private static
String promoteRepo(final String authInfo, final String profile, final String repo, final String nameAndVersion) throws IOException {

    String repoInfo = "{'data':{'stagedRepositoryId':'" + repo + "','description':'Promoting " + nameAndVersion + "'}}";
    RequestBuilder builder = new RequestBuilder("POST");
    Request request = builder.setUrl("https://oss.sonatype.org/service/local/staging/profiles/" + profile + "/promote")
                     .addHeader("Content-Type", "application/json")
                     .addHeader("Authorization", "Basic " + authInfo)

                     .setBody(repoInfo.getBytes(OS.UTF_8))

                     .build();
    return sendHttpRequest(request);
}

删除存储库：

/**
 * Drops the repo
 * @throws IOException
 */
private static
String dropRepo(final String authInfo, final String profile, final String repo, final String nameAndVersion) throws IOException {

    String repoInfo = "{'data':{'stagedRepositoryId':'" + repo + "','description':'Dropping " + nameAndVersion + "'}}";
    RequestBuilder builder = new RequestBuilder("POST");
    Request request = builder.setUrl("https://oss.sonatype.org/service/local/staging/profiles/" + profile + "/drop")
                     .addHeader("Content-Type", "application/json")
                     .addHeader("Authorization", "Basic " + authInfo)

                     .setBody(repoInfo.getBytes(OS.UTF_8))

                     .build();

    return sendHttpRequest(request);
}

删除签名粪便：

/**
 * Deletes the extra .asc.md5 and .asc.sh1 'turds' that show-up when you upload the signature file. And yes, 'turds' is from sonatype
 * themselves. See: https://issues.sonatype.org/browse/NEXUS-4906
 * @throws IOException
 */
private static
void deleteSignatureTurds(final String authInfo, final String repo, final String groupId_asPath, final String name,
                          final String version, final File signatureFile)
                throws IOException {

    String delURL = "https://oss.sonatype.org/service/local/repositories/" + repo + "/content/" +
                    groupId_asPath + "/" + name + "/" + version + "/" + signatureFile.getName();

    RequestBuilder builder;
    Request request;

    builder = new RequestBuilder("DELETE");
    request = builder.setUrl(delURL + ".sha1")
                     .addHeader("Authorization", "Basic " + authInfo)
                     .build();
    sendHttpRequest(request);

    builder = new RequestBuilder("DELETE");
    request = builder.setUrl(delURL + ".md5")
                     .addHeader("Authorization", "Basic " + authInfo)
                     .build();
    sendHttpRequest(request);
}

文件上传：

    public
    String upload(final File file, final String extension, String classification) throws IOException {

        final RequestBuilder builder = new RequestBuilder("POST");
        final RequestBuilder requestBuilder = builder.setUrl(uploadURL);
        requestBuilder.addHeader("Authorization", "Basic " + authInfo)

                      .addBodyPart(new StringPart("r", repo))
                      .addBodyPart(new StringPart("g", groupId))
                      .addBodyPart(new StringPart("a", name))
                      .addBodyPart(new StringPart("v", version))
                      .addBodyPart(new StringPart("p", "jar"))
                      .addBodyPart(new StringPart("e", extension))
                      .addBodyPart(new StringPart("desc", description));


        if (classification != null) {
            requestBuilder.addBodyPart(new StringPart("c", classification));
        }

        requestBuilder.addBodyPart(new FilePart("file", file));
        final Request request = requestBuilder.build();

        return sendHttpRequest(request);
    }

编辑1：

如何获取存储库的活动/状态

/**
 * Gets the activity information for a repo. If there is a failure during verification/finish -- this will provide what it was.
 * @throws IOException
 */
private static
String activityForRepo(final String authInfo, final String repo) throws IOException {

    RequestBuilder builder = new RequestBuilder("GET");
    Request request = builder.setUrl("https://oss.sonatype.org/service/local/staging/repository/" + repo + "/activity")
                             .addHeader("Content-Type", "application/json")
                             .addHeader("Authorization", "Basic " + authInfo)

                             .build();

    return sendHttpRequest(request);
}

Answer 4

无需使用这些命令..您可以直接使用 Nexus Web 界面，以便使用 GAV 参数上传您的 JAR。

所以非常简单。

Answer 5

您需要对 Nexus 进行的调用是 REST api 调用。

maven-nexus-plugin 是一个 Maven 插件，您可以使用它来进行这些调用。您可以创建一个具有必要属性的虚拟 pom，并通过 Maven 插件进行这些调用。

类似的事情：

mvn -DserverAuthId=sonatype-nexus-staging -Dauto=true nexus:staging-close

假设的事情：

1. 您已经在 ~/.m2/settings.xml 中定义了一个名为 sonatype-nexus-staging 的服务器，并设置了您的 sonatype 用户和密码 - 如果您正在部署快照，您可能已经完成了此操作。但您可以在此处找到更多信息。
2. 您的本地 settings.xml 包含指定的 nexus 插件 在这里。
3. 当前目录中的 pom.xml 在其定义中具有正确的 Maven 坐标。如果没有，您可以在命令行中指定groupId、artifactId和version。
4. -Dauto=true 将关闭交互式提示，以便您可以编写脚本。

最终，这一切都是为了创建对 Nexus 的 REST 调用。有一个完整的 Nexus REST api，但我很难找到不在付费专区后面的文档。您可以打开上面插件的调试模式并使用 -Dnexus.verboseDebug=true -X 来弄清楚。

理论上，您还可以进入 UI，打开 Firebug Net 面板，观察 /service POST 并推断出那里的路径。

Answer 6

您还可以使用curl 来使用直接部署方法。您的文件不需要 pom，但它也不会生成，因此如果您想要一个，则必须单独上传。

这是命令：

version=1.2.3
artifact="myartifact"
repoId=yourrepository
groupId=org.myorg
REPO_URL=http://localhost:8081/nexus

curl -u nexususername:nexuspassword --upload-file filename.tgz $REPO_URL/content/repositories/$repoId/$groupId/$artifact/$version/$artifact-$version.tgz

Answer 7

在 ruby​​ 中 https://github.com/RiotGames/nexus_cli 围绕 Sonatype Nexus REST 调用的 CLI 包装器。

使用示例：

nexus-cli push_artifact com.mycompany.artifacts:myartifact:tgz:1.0.0 ~/path/to/file/to/push/myartifact.tgz

配置是通过.nexus_cli文件完成的。

url:            "http://my-nexus-server/nexus/"
repository:     "my-repository-id"
username:       "username"
password:       "password"

Answer 8

对于那些需要 Java 的人，使用 apache httpcomponents 4.0：

public class PostFile {
    protected HttpPost httppost ;
    protected MultipartEntity mpEntity; 
    protected File filePath;

    public PostFile(final String fullUrl, final String filePath){
        this.httppost = new HttpPost(fullUrl);
        this.filePath = new File(filePath);        
        this.mpEntity = new MultipartEntity();
    }

    public void authenticate(String user, String password){
        String encoding = new String(Base64.encodeBase64((user+":"+password).getBytes()));
        httppost.setHeader("Authorization", "Basic " + encoding);
    }
    private void addParts() throws UnsupportedEncodingException{
        mpEntity.addPart("r", new StringBody("repository id"));
        mpEntity.addPart("g", new StringBody("group id"));
        mpEntity.addPart("a", new StringBody("artifact id"));
        mpEntity.addPart("v", new StringBody("version"));
        mpEntity.addPart("p", new StringBody("packaging"));
        mpEntity.addPart("e", new StringBody("extension"));

        mpEntity.addPart("file", new FileBody(this.filePath));

    }

    public String post() throws ClientProtocolException, IOException {
        HttpClient httpclient = new DefaultHttpClient();
        httpclient.getParams().setParameter(CoreProtocolPNames.PROTOCOL_VERSION, HttpVersion.HTTP_1_1);
        addParts();
        httppost.setEntity(mpEntity);
        HttpResponse response = httpclient.execute(httppost);

        System.out.println("executing request " + httppost.getRequestLine());
        System.out.println(httppost.getEntity().getContentLength());

        HttpEntity resEntity = response.getEntity();

        String statusLine = response.getStatusLine().toString();
        System.out.println(statusLine);
        if (resEntity != null) {
            System.out.println(EntityUtils.toString(resEntity));
        }
        if (resEntity != null) {
            resEntity.consumeContent();
        }
        return statusLine;
    }
}

Answer 9

如果您需要方便的命令行界面或 python API，请查看 repositorytools

使用它，您可以使用命令将工件上传到nexus

artifact upload foo-1.2.3.ext releases com.fooware

要使其工作，您还需要设置一些环境变量

export REPOSITORY_URL=https://repo.example.com
export REPOSITORY_USER=admin
export REPOSITORY_PASSWORD=mysecretpassword

Answer 10

对于最新版本的 Nexus OSS (>= 3.9.0)

https://support.sonatype.com/hc/en-us/articles/115006744008-How-can-I-programmatically-upload-files-into-Nexus -3-

版本 3.9.0 至 3.13.0 的示例：

curl -D - -u user:pass -X POST "https://nexus.domain/nexus/service/rest/beta/components?repository=somerepo" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "raw.directory=/test/" -F "[email protected];type=application/json" -F "raw.asset1.filename=test.txt"

Answer 11

您可以通过单击 Nexus 服务器中的上传工件按钮来手动上传工件，并提供上传所需的 GAV 属性（通常是用于存储工件的文件结构）

Answer 12

如果您想在 2023 年上传到 Nexus 中的存储库，请按照如下所示的步骤操作。 Nexus 更新了他们的 API 端点。
（该示例已使用 Node 项目中的 tar/zip 文件进行了测试，如 OP 请求的那样）

注意确保您的用户名和密码使用 base64 进行编码，否则这将不起作用。

将您的用户名和密码转换为 Base64 字符串。

echo -n '<your username>:<your password>' | base64

在授权标头中添加该回显的输出。
本例中的资产名称是您要上传的文件。

curl -X 'POST' \
  'http://<Nexus>/service/rest/v1/components?repository=<repo name>' \
  -H 'accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -H 'Authorization: Basic <username:pass base64 str>=' \
  -F 'r.asset=@<assetname>'

Answer 13

@Adam Vandenberg 用于将 Java 代码发布到 Nexus。
https://github.com/manbalagan/nexusuploader

public class NexusRepository implements RepoTargetFactory {

    String DIRECTORY_KEY= "raw.directory";
    String ASSET_KEY= "raw.asset1";
    String FILENAME_KEY= "raw.asset1.filename";

    String repoUrl;
    String userName;
    String password;

    @Override
    public void setRepoConfigurations(String repoUrl, String userName, String password) {
        this.repoUrl = repoUrl;
        this.userName = userName;
        this.password = password;
    }

    public String pushToRepository() {
        HttpClient httpclient = HttpClientBuilder.create().build();
        HttpPost postRequest = new HttpPost(repoUrl) ;
        String auth = userName + ":" + password;
        byte[] encodedAuth = Base64.encodeBase64(
                auth.getBytes(StandardCharsets.ISO_8859_1));
        String authHeader = "Basic " + new String(encodedAuth);
        postRequest.setHeader(HttpHeaders.AUTHORIZATION, authHeader);
        try
        {
            byte[] packageBytes = "Hello. This is my file content".getBytes();
            MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
            InputStream packageStream = new ByteArrayInputStream(packageBytes);
            InputStreamBody inputStreamBody = new InputStreamBody(packageStream, ContentType.APPLICATION_OCTET_STREAM);
            multipartEntityBuilder.addPart(DIRECTORY_KEY, new StringBody("DIRECTORY"));
            multipartEntityBuilder.addPart(FILENAME_KEY, new StringBody("MyFile.txt"));
            multipartEntityBuilder.addPart(ASSET_KEY, inputStreamBody);
            HttpEntity entity = multipartEntityBuilder.build();
            postRequest.setEntity(entity); ;

            HttpResponse response = httpclient.execute(postRequest) ;
            if (response != null)
            {
                System.out.println(response.getStatusLine().getStatusCode());
            }
        }
        catch (Exception ex)
        {
            ex.printStackTrace() ;
        }
        return null;
    }

}

Answer 14

您可以使用卷曲代替。

version=1.2.3
artifact="artifact"
repoId=repositoryId
groupId=org/myorg
REPO_URL=http://localhost:8081/nexus

curl -u username:password --upload-file filename.tgz $REPO_URL/content/repositories/$repoId/$groupId/$artifact/$version/$artifact-$version.tgz