You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by dw...@apache.org on 2022/11/18 17:58:13 UTC
[lucene] branch main updated: Add self-contained artifact upload script for apache nexus (#11329) (#11947)
This is an automated email from the ASF dual-hosted git repository.
dweiss pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/lucene.git
The following commit(s) were added to refs/heads/main by this push:
new e78210b7f0b Add self-contained artifact upload script for apache nexus (#11329) (#11947)
e78210b7f0b is described below
commit e78210b7f0b702582ed58c350d24a99f5ef9418e
Author: Dawid Weiss <da...@carrotsearch.com>
AuthorDate: Fri Nov 18 18:58:06 2022 +0100
Add self-contained artifact upload script for apache nexus (#11329) (#11947)
---
dev-tools/scripts/StageArtifacts.java | 406 ++++++++++++++++++++++++++++++++++
dev-tools/scripts/releaseWizard.yaml | 19 +-
2 files changed, 416 insertions(+), 9 deletions(-)
diff --git a/dev-tools/scripts/StageArtifacts.java b/dev-tools/scripts/StageArtifacts.java
new file mode 100644
index 00000000000..270c41d05ce
--- /dev/null
+++ b/dev-tools/scripts/StageArtifacts.java
@@ -0,0 +1,406 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import org.w3c.dom.Document;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.xml.sax.InputSource;
+import org.xml.sax.SAXException;
+
+import javax.xml.parsers.DocumentBuilderFactory;
+import javax.xml.parsers.ParserConfigurationException;
+import java.io.Console;
+import java.io.IOException;
+import java.io.StringReader;
+import java.net.Authenticator;
+import java.net.HttpURLConnection;
+import java.net.PasswordAuthentication;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.net.URLEncoder;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+/**
+ * Sonatype nexus artifact staging/deployment script. This could be made
+ * nicer, but this keeps it to JDK classes only.
+ *
+ * <p>The implementation is based on the REST API documentation of
+ * <a href="https://oss.sonatype.org/nexus-staging-plugin/default/docs/index.html">nexus-staging-plugin</a>
+ * and on anecdotal evidence and reverse-engineered information from around
+ * the web... Weird that such a crucial piece of infrastructure has such obscure
+ * documentation.
+ */
+public class StageArtifacts {
+ private static final String DEFAULT_NEXUS_URI = "https://repository.apache.org";
+
+ private static class Params {
+ URI nexusUri = URI.create(DEFAULT_NEXUS_URI);
+ String userName;
+ char[] userPass;
+ Path mavenDir;
+ String description;
+
+ private static char[] envVar(String envVar) {
+ var value = System.getenv(envVar);
+ return value == null ? null : value.toCharArray();
+ }
+
+ static void requiresArgument(String[] args, int at) {
+ if (at + 1 >= args.length) {
+ throw new RuntimeException("Option '" + args[at]
+ + "' requires an argument, pass --help for help.");
+ }
+ }
+
+ static Params parse(String[] args) {
+ try {
+ var params = new Params();
+ for (int i = 0; i < args.length; i++) {
+ switch (args[i]) {
+ case "-n":
+ case "--nexus":
+ requiresArgument(args, i);
+ params.nexusUri = URI.create(args[++i]);
+ break;
+ case "-u":
+ case "--user":
+ requiresArgument(args, i);
+ params.userName = args[++i];
+ break;
+ case "-p":
+ case "--password":
+ requiresArgument(args, i);
+ params.userPass = args[++i].toCharArray();
+ break;
+ case "--description":
+ requiresArgument(args, i);
+ params.description = args[++i];
+ break;
+
+ case "-h":
+ case "--help":
+ System.out.println("java " + StageArtifacts.class.getName() + " [options] path-to-maven-artifacts");
+ System.out.println(" -u, --user User name for authentication.");
+ System.out.println(" better: ASF_USERNAME env. var.");
+ System.out.println(" -p, --password Password for authentication.");
+ System.out.println(" better: ASF_PASSWORD env. var.");
+ System.out.println(" -n, --nexus URL to Apache Nexus (optional).");
+ System.out.println(" --description Staging repo description (optional).");
+ System.out.println("");
+ System.out.println(" path Path to maven artifact directory.");
+ System.out.println("");
+ System.out.println(" Password can be omitted for console prompt-input.");
+ System.exit(0);
+
+ default:
+ if (params.mavenDir != null) {
+ throw new RuntimeException("Exactly one maven artifact directory should be provided.");
+ }
+ params.mavenDir = Paths.get(args[i]);
+ break;
+ }
+ }
+
+ if (params.userName == null) {
+ var v = envVar("ASF_USERNAME");
+ if (v != null) {
+ params.userName = new String(v);
+ }
+ }
+ Objects.requireNonNull(params.userName, "User name is required for authentication.");
+
+ if (params.userPass == null) {
+ params.userPass = envVar("ASF_PASSWORD");
+ if (params.userPass == null) {
+ Console console = System.console();
+ if (console != null) {
+ System.out.println("Enter password for " + params.userName + ":");
+ params.userPass = console.readPassword();
+ } else {
+ throw new RuntimeException("No console, can't prompt for password.");
+ }
+ }
+ }
+ Objects.requireNonNull(params.userPass, "User password is required for authentication.");
+
+ if (params.mavenDir == null || !Files.isDirectory(params.mavenDir)) {
+ throw new RuntimeException("Maven artifact directory is required and must exist.");
+ }
+ return params;
+ } catch (IndexOutOfBoundsException e) {
+ throw new RuntimeException("Required argument missing (pass --help for help)?");
+ }
+ }
+ }
+
+ private static class NexusApi {
+ private final HttpClient client;
+ private final URI nexusUri;
+
+ public NexusApi(Params params) {
+ Authenticator authenticator = new Authenticator() {
+ @Override
+ protected PasswordAuthentication getPasswordAuthentication() {
+ return new PasswordAuthentication(params.userName, params.userPass);
+ }
+ };
+
+ this.client = HttpClient.newBuilder()
+ .authenticator(authenticator)
+ .build();
+
+ this.nexusUri = params.nexusUri;
+ }
+
+ public String requestProfileId(PomInfo pomInfo) throws IOException {
+ String result = sendGet("/service/local/staging/profile_evaluate", Map.of(
+ "g", pomInfo.groupId,
+ "a", pomInfo.artifactId,
+ "v", pomInfo.version,
+ "t", "maven2"
+ ));
+
+ return XmlElement.parse(result)
+ .onlychild("stagingProfiles")
+ .onlychild("data")
+ .onlychild("stagingProfile")
+ .onlychild("id")
+ .text();
+ }
+
+ public String createStagingRepository(String profileId, String description) throws IOException {
+ String result = sendPost("/service/local/staging/profiles/" + URLEncoder.encode(profileId, StandardCharsets.UTF_8) + "/start",
+ "application/xml",
+ HttpURLConnection.HTTP_CREATED,
+ ("<promoteRequest>\n" +
+ " <data>\n" +
+ " <description><![CDATA[" + description + "]]></description>\n" +
+ " </data>\n" +
+ "</promoteRequest>").getBytes(StandardCharsets.UTF_8));
+
+ return XmlElement.parse(result)
+ .onlychild("promoteResponse")
+ .onlychild("data")
+ .onlychild("stagedRepositoryId")
+ .text();
+ }
+
+ public void uploadArtifact(String stagingRepoId, Path path) throws IOException {
+ sendPost("/service/local/staging/deployByRepositoryId/"
+ + URLEncoder.encode(stagingRepoId, StandardCharsets.UTF_8)
+ + "/"
+ + URLEncoder.encode(path.getFileName().toString(), StandardCharsets.UTF_8),
+ "application/octet-stream",
+ HttpURLConnection.HTTP_CREATED,
+ Files.readAllBytes(path));
+ }
+
+ public void closeStagingRepository(String profileId, String stagingRepoId) throws IOException {
+ sendPost("/service/local/staging/profiles/" + URLEncoder.encode(profileId, StandardCharsets.UTF_8) + "/finish",
+ "application/xml",
+ HttpURLConnection.HTTP_CREATED,
+ ("<promoteRequest>\n" +
+ " <data>\n" +
+ " <stagedRepositoryId><![CDATA[" + stagingRepoId + "]]></stagedRepositoryId>\n" +
+ " </data>\n" +
+ "</promoteRequest>").getBytes(StandardCharsets.UTF_8));
+ }
+
+ private String sendPost(String serviceEndpoint, String contentType, int expectedStatus, byte[] bytes) throws IOException {
+ URI target = nexusUri.resolve(serviceEndpoint);
+
+ try {
+ HttpResponse.BodyHandler<String> bodyHandler = HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8);
+ HttpRequest req = HttpRequest.newBuilder()
+ .POST(HttpRequest.BodyPublishers.ofByteArray(bytes))
+ .header("Content-Type", contentType)
+ .uri(target)
+ // we could use json if XML is too difficult to work with.
+ // .header("Accept", "application/json")
+ .build();
+ HttpResponse<String> response = client.send(req, bodyHandler);
+ if (response.statusCode() != expectedStatus) {
+ throw new IOException("Unexpected HTTP error returned: " + response.statusCode() + ", response body: "
+ + response.body());
+ }
+ return response.body();
+ } catch (InterruptedException e) {
+ throw new IOException("HTTP timeout", e);
+ }
+ }
+
+ private String sendGet(String serviceEndpoint, Map<String, String> getArgs) throws IOException {
+ // JDK: jeez... why make a http client and not provide uri-manipulation utilities?
+ URI target;
+ try {
+ target = nexusUri.resolve(serviceEndpoint);
+ target = new URI(
+ target.getScheme(), target.getUserInfo(), target.getHost(), target.getPort(),
+ target.getPath(),
+ getArgs.entrySet().stream()
+ .map(e -> entityEncode(e.getKey()) + "=" + entityEncode(e.getValue()))
+ .collect(Collectors.joining("&")),
+ null);
+
+ HttpResponse.BodyHandler<String> bodyHandler = HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8);
+ HttpRequest req = HttpRequest.newBuilder()
+ .GET()
+ .uri(target)
+ // we could use json if XML is too difficult to work with.
+ // .header("Accept", "application/json")
+ .build();
+ HttpResponse<String> response = client.send(req, bodyHandler);
+ if (response.statusCode() != HttpURLConnection.HTTP_OK) {
+ throw new IOException("Unexpected HTTP error returned: " + response.statusCode());
+ }
+ return response.body();
+ } catch (URISyntaxException e) {
+ throw new RuntimeException(e);
+ } catch (InterruptedException e) {
+ throw new IOException("HTTP timeout", e);
+ }
+ }
+
+ private String entityEncode(String value) {
+ return URLEncoder.encode(value, StandardCharsets.UTF_8);
+ }
+ }
+
+ private static class XmlElement {
+ private final Node element;
+
+ static XmlElement parse(String xml) throws IOException {
+ DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
+ try (var is = new StringReader(xml)) {
+ Document parse = dbf.newDocumentBuilder().parse(new InputSource(is));
+ return new XmlElement(parse);
+ } catch (ParserConfigurationException | SAXException e) {
+ throw new RuntimeException(e);
+ }
+ }
+
+ public XmlElement(Node child) {
+ this.element = child;
+ }
+
+ public XmlElement onlychild(String tagName) throws IOException {
+ ArrayList<XmlElement> children = new ArrayList<>();
+ NodeList childNodes = element.getChildNodes();
+ for (int i = 0, max = childNodes.getLength(); i < max; i++) {
+ var child = childNodes.item(i);
+ if (child.getNodeType() == Node.ELEMENT_NODE &&
+ Objects.equals(child.getNodeName(), tagName)
+ ) {
+ children.add(new XmlElement(child));
+ }
+ }
+ if (children.isEmpty()) {
+ throw new IOException("No child node found for: " + tagName);
+ }
+ return children.get(0);
+ }
+
+ public String text() {
+ return element.getTextContent();
+ }
+ }
+
+ private static class PomInfo {
+ String groupId;
+ String artifactId;
+ String version;
+
+ public static PomInfo extractPomInfo(Path path) throws IOException {
+ PomInfo pomInfo = new PomInfo();
+ XmlElement project =
+ XmlElement.parse(Files.readString(path, StandardCharsets.UTF_8))
+ .onlychild("project");
+ pomInfo.groupId = project.onlychild("groupId").text();
+ pomInfo.artifactId = project.onlychild("artifactId").text();
+ pomInfo.version = project.onlychild("version").text();
+ return pomInfo;
+ }
+ }
+
+ public static void main(String[] args) throws Exception {
+ try {
+ var params = Params.parse(args);
+ var nexus = new NexusApi(params);
+
+ // Collect all files to be uploaded.
+ List<Path> artifacts;
+ try (Stream<Path> pathStream = Files.walk(params.mavenDir)) {
+ artifacts = pathStream
+ .filter(Files::isRegularFile)
+ // Ignore locally generated maven metadata files.
+ .filter(path -> !path.getFileName().toString().startsWith("maven-metadata."))
+ .sorted(Comparator.comparing(Path::toString))
+ .collect(Collectors.toList());
+ }
+
+ // Figure out nexus profile ID based on POMs. It is assumed that all artifacts
+ // fall under the same profile.
+ PomInfo pomInfo = PomInfo.extractPomInfo(
+ artifacts.stream()
+ .filter(path -> path.getFileName().toString().endsWith(".pom"))
+ .findFirst()
+ .orElseThrow());
+
+ System.out.println("Requesting profile ID for artifact: "
+ + pomInfo.groupId + ":" + pomInfo.artifactId + ":" + pomInfo.version);
+ String profileId = nexus.requestProfileId(pomInfo);
+ System.out.println(" => Profile ID: " + profileId);
+
+ System.out.println("Creating staging repository.");
+ String description = Objects.requireNonNullElse(params.description,
+ "Staging repository: " + pomInfo.groupId + "."
+ + pomInfo.artifactId + ":" + pomInfo.version);
+ String stagingRepoId = nexus.createStagingRepository(profileId, description);
+ System.out.println(" => Staging repository ID: " + stagingRepoId);
+
+ System.out.printf("Uploading %s artifact(s).%n", artifacts.size());
+ for (Path path : artifacts) {
+ System.out.println(" => " + params.mavenDir.relativize(path));
+ nexus.uploadArtifact(stagingRepoId, path);
+ }
+
+ System.out.println("Closing the staging repository.");
+ nexus.closeStagingRepository(profileId, stagingRepoId);
+ System.out.println(" => Staging repository is available at: ");
+ System.out.println(" https://repository.apache.org/content/repositories/" + stagingRepoId);
+
+ System.out.println();
+ System.out.println("You must review and release the staging repository manually from Nexus GUI!");
+ } catch (Exception e) {
+ System.err.println("Something went wrong: " + e.getMessage());
+ System.exit(1);
+ }
+ }
+}
diff --git a/dev-tools/scripts/releaseWizard.yaml b/dev-tools/scripts/releaseWizard.yaml
index 516cbe9f946..51ee82d0085 100644
--- a/dev-tools/scripts/releaseWizard.yaml
+++ b/dev-tools/scripts/releaseWizard.yaml
@@ -649,9 +649,11 @@ groups:
vars:
logfile: '{{ [rc_folder, ''logs'', ''buildAndPushRelease.log''] | path_join }}'
git_rev: '{{ current_git_rev }}' # Note, git_rev will be recorded in todo state AFTER completion of commands
+ git_rev_short: '{{ git_rev | truncate(7,true,"") }}' # Note, git_rev_short will be recorded in todo state AFTER completion of commands
local_keys: '{% if keys_downloaded %} --local-keys "{{ [config_path, ''KEYS''] | path_join }}"{% endif %}'
persist_vars:
- git_rev
+ - git_rev_short
commands: !Commands
root_folder: '{{ git_checkout_folder }}'
commands_text: |-
@@ -923,6 +925,7 @@ groups:
id: stage_maven
title: Stage the maven artifacts for publishing
vars:
+ git_sha: '{{ build_rc.git_rev_short | default("<git_sha>", True) }}'
dist_folder: lucene-{{ release_version }}-RC{{ rc_number }}-rev-{{ build_rc.git_rev | default("<git_rev>", True) }}
commands: !Commands
root_folder: '{{ git_checkout_folder }}'
@@ -930,30 +933,28 @@ groups:
commands_text: In the source checkout do the following (note that this step will prompt you for your Apache LDAP credentials)
commands:
- !Command
- cmd: ant clean stage-maven-artifacts -Dmaven.dist.dir={{ [dist_file_path, dist_folder, 'lucene', 'maven'] | path_join }} -Dm2.repository.id=apache.releases.https -Dm2.repository.url={{ m2_repository_url }}
+ cmd: java dev-tools/scripts/StageArtifacts.java --user {{ gpg.apache_id }} --description "{{ 'Apache Lucene ', release_version, ' (commit ', git_sha, ')' }}" "{{ [dist_file_path, dist_folder, 'solr', 'maven'] | path_join }}"
+ tee: true
logfile: publish_lucene_maven.log
post_description: The artifacts are not published yet, please proceed with the next step to actually publish!
- !Todo
id: publish_maven
depends: stage_maven
title: Publish the staged maven artifacts
+ vars:
+ git_sha: '{{ build_rc.git_rev_short | default("<git_sha>", True) }}'
description: |
Once you have transferred all maven artifacts to repository.apache.org,
you will need to do some manual steps to actually release them to Maven Central:
- * Close the staging repository
+ * Release the staging repository
. Log in to https://repository.apache.org/ with your ASF credentials
. Select "Staging Repositories" under "Build Promotion" from the navigation bar on the left
- . Select the staging repository containing the Lucene artifacts
- . Click on the "Close" button above the repository list, then enter a description when prompted, e.g. "Lucene {{ release_version }} RC{{ rc_number }}"
- * The system will now spend some time validating the artifacts. Grab a coke and come back.
- * Release the Lucene artifacts
- . Wait and keep clicking refresh until the "Release" button becomes available
+ . Select the staging repository named, "Apache Lucene {{ release_version }} (commit {{ git_sha }})"
. Click on the "Release" button above the repository list, then enter a description when prompted, e.g. "Lucene {{ release_version }}".
Maven central should show the release after a short while
links:
- - https://wiki.apache.org/lucene-java/PublishMavenArtifacts
- https://repository.apache.org/index.html
- !Todo
id: check_distribution_directory
@@ -1029,7 +1030,7 @@ groups:
Fortunately the only thing you need to change is a few variables in `pelicanconf.py`.
If you release a current latest release, change the `LUCENE_LATEST_RELEASE` and `LUCENE_LATEST_RELEASE_DATE`
variables.
- If you relese a bugfix release for previos version, then change the `LUCENE_PREVIOUS_MAJOR_RELEASE` variable.
+ If you relese a bugfix release for previous version, then change the `LUCENE_PREVIOUS_MAJOR_RELEASE` variable.
commands: !Commands
root_folder: '{{ git_website_folder }}'
commands_text: Edit pelicanconf.py to update version numbers