1. Regístrate https://issues.sonatype.org/account
Lo siguiente significa que el registro está completo y la orden de trabajo enviada al mismo tiempo también ha pasado
2. Lo principal aquí es que goupId debe autenticarse y debe ir al registrador de nombres de dominio para analizar un archivo txt y asegurarse de que sea suyo.
Verifique la información de su nombre de dominio a través de lo siguiente, aquí se incluye principalmente el número de orden de trabajo anterior, aquí hay una dirección de enlace como retorno de texto
3. Firma GPG
Si no ha configurado la firma GPG, debe configurarla.
Primero descargue la herramienta GPG
www.gnupg.org/download/
La descarga requiere dinero, si no tiene dinero, puede pagar 0 yuanes para descargar, simplemente descargue el archivo ganador
Aparece después de descargar y ejecutar
En este caso, utilice la línea de comando.
Seleccione uno de ellos para
ejecutar el script.
gpg --generate-key
Después de que se genere, se completará cierta información personal
y se completará una frase de contraseña en el medio, que debe recordarse.
A través de la siguiente línea de comando, puede verificar si la cadena de la clave pública se envía con éxito hacia y desde el servidor receptor.
enviar
gpg --keyserver keyserver.ubuntu.com --send-claves FF490DBFEC050B856BB998716292A0B996ACB000
tomar el control
gpg --keyserver keyserver.ubuntu.com --recv-claves FF490DBFEC050B856BB998716292A0B996ACB000
4. Modifique los archivos settings.xml y pom.xml de acuerdo con la información anterior, consulte el archivo adjunto para obtener más información.
5. Cargar y liberar
mvn clean install deploy -P release 
Se produce el siguiente error
Resultó que olvidé sobrescribir setting.xml en el directorio mvn, y luego la siguiente versión parecía ser normal.
6. Use la contraseña de la cuenta anterior para iniciar sesión en la siguiente dirección para ver el estado de la versión
Administrador de repositorios de Nexus
Pero no parece ser encontrado
7. ¡Puedes ir al almacén central para buscar los componentes que liberaste!
Sitio web de búsqueda del almacén central: http://search.maven.org/ , puede recibir el paquete jar enviado.
En China, puede buscar en el almacén de Ali a continuación
Adjunto: archivo settings.xml
<servers>
<server>
<id>ossrh</id>
<username>sonatype账号</username>
<password>sonatype密码</password>
</server>
</servers>
<profiles>
<profile>
<id>ossrh</id>
<properties>
<gpg.executable>gpg</gpg.executable>
<gpg.passphrase>自己passphrase密码</gpg.passphrase>
</properties>
</profile>
</profiles> archivo pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.nbcio</groupId>
<artifactId>autopoi-parent</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging>
<name>autopoi-parent</name>
<url>http://www.nbcio.com</url>
<modules>
<module>autopoi</module>
<module>autopoi-web</module>
</modules>
<description> office 工具类 基于 poi</description>
<licenses>
<license>
<name>The Apache License, Version 2.0</name>
<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
</license>
</licenses>
<scm>
<connection>scm:git:https://gitee.com/nbacheng/autopoi.git</connection>
<developerConnection>scm:git:https://gitee.com/nbacheng/autopoi.git</developerConnection>
<url>https://gitee.com/nbacheng/autopoi</url>
</scm>
<developers>
<developer>
<name>nbacheng</name>
<email>[email protected]</email>
</developer>
</developers>
<properties>
<autopoi.version>1.0.0</autopoi.version>
<poi.version>5.0.0</poi.version>
<xerces.version>2.9.1</xerces.version>
<guava.version>29.0-jre</guava.version>
<commons-lang.version>3.10</commons-lang.version>
<slf4j.version>1.7.30</slf4j.version>
<spring.version>5.1.0.RELEASE</spring.version>
</properties>
<dependencyManagement>
<dependencies>
<!-- poi -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>${poi.version}</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>${poi.version}</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml-full</artifactId>
<version>${poi.version}</version>
</dependency>
<!-- sax 读取时候用到的 -->
<dependency>
<groupId>xerces</groupId>
<artifactId>xercesImpl</artifactId>
<version>${xerces.version}</version>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-scratchpad</artifactId>
<version>${poi.version}</version>
</dependency>
<!-- excel背景
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>ooxml-schemas</artifactId>
<version>1.4</version>
</dependency>-->
<!-- google 工具类 -->
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>${guava.version}</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>${commons-lang.version}</version>
</dependency>
<!--日志 -->
<!-- slf4j -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j.version}</version>
<scope>provided</scope>
</dependency>
<!--spring-web -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
<optional>true</optional>
</dependency>
<!--servlet -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
<optional>true</optional>
</dependency>
<!-- 模块版本 -->
<dependency>
<groupId>org.jeecgframework</groupId>
<artifactId>autopoi</artifactId>
<version>${autopoi.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
<profiles>
<profile>
<id>release</id>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!-- Source -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.2.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- Javadoc -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>jar</goal>
</goals>
<configuration>
<encoding>UTF-8</encoding>
<additionalparam>-Xdoclint:none</additionalparam>
</configuration>
</execution>
</executions>
</plugin>
<!--Maven GPG插件用于使用以下配置对组件进行签名-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
<version>1.6</version>
<executions>
<execution>
<id>sign-artifacts</id>
<phase>verify</phase>
<goals>
<goal>sign</goal>
</goals>
</execution>
</executions>
</plugin>
<!--Nexus Staging Maven插件是将组件部署到OSS并将其发布到Central Repository的推荐方法-->
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.7</version>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin>
</plugins>
</build>
</profile>
</profiles>
<distributionManagement>
<snapshotRepository>
<id>ossrh</id>
<url>
https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
</snapshotRepository>
<repository>
<id>ossrh</id>
<url>
https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
</repository>
</distributionManagement>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.0.0-M5</version>
<configuration>
<skipTests>true</skipTests>
</configuration>
</plugin>
</plugins>
</build>
</project>La siguiente es la información de ayuda oficial
Gestión de Distribución y Autenticación ⚓︎
Para configurar Maven para que se implemente en OSSRH Nexus Repository Manager con el complemento Nexus Staging Maven, debe configurarlo de esta manera
Nota: a partir de febrero de 2021, todos los proyectos nuevos comenzaron a aprovisionarse en Nexus Repository Manager . Si su proyecto no está aprovisionado en Nexus Repository Manager , querrá iniciar sesión en el host heredado Nexus Repository Manager .
<distributionManagement>
<snapshotRepository>
<id>ossrh</id>
<url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
</snapshotRepository>
</distributionManagement>
<build>
<plugins>
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.7</version>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin>
...
</plugins>
</build>
Dado que OSSRH siempre ejecuta la última versión disponible de Sonatype Nexus Repository Manager, es mejor usar la última versión del complemento Nexus Staging Maven.
Alternativamente, si está utilizando el complemento de implementación de Maven, que es el comportamiento predeterminado, debe agregar una distributionManagement sección completa.
<distributionManagement>
<snapshotRepository>
<id>ossrh</id>
<url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
</snapshotRepository>
<repository>
<id>ossrh</id>
<url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
</repository>
</distributionManagement>
Las configuraciones anteriores obtendrán los detalles de la cuenta de usuario para implementar en OSSRH desde su settings.xml archivo Maven, generalmente ubicado en formato ~/.m2. Una configuración mínima con la autenticación es:
<settings>
<servers>
<server>
<id>ossrh</id>
<username>your-jira-id</username>
<password>your-jira-pwd</password>
</server>
</servers>
</settings>
Tenga en cuenta cómo el id elemento en el elemento del servidor settings.xml es idéntico a los id elementos en el elemento snapshotRepository y repository , así como la serverId configuración del complemento Nexus Staging Maven
Javadoc y archivos adjuntos de fuentes ⚓︎
Para generar archivos Javadoc y Source jar, debe configurar los complementos Javadoc y Source Maven.
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.2.1</version>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
Componentes firmados GPG ⚓︎
El complemento Maven GPG se utiliza para firmar los componentes con la siguiente configuración.
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
<version>1.5</version>
<executions>
<execution>
<id>sign-artifacts</id>
<phase>verify</phase>
<goals>
<goal>sign</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
Se basa en la instalación del comando gpg y la disponibilidad de las credenciales GPG, por ejemplo, desde settings.xml. Además puedes configurar el comando gpg en caso de que sea diferente a gpg. Este es un escenario común en algunos sistemas operativos.
<settings>
<profiles>
<profile>
<id>ossrh</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<gpg.executable>gpg2</gpg.executable>
<gpg.passphrase>the_pass_phrase</gpg.passphrase>
</properties>
</profile>
</profiles>
</settings>
En caso de que tenga varias claves, gpg local usará la primera clave de firma enumerada ( gpg --list-signatures); si necesita usar una clave específica, puede agregar los detalles de la clave gpg dentro de una <configuration> sección y usar local settings.xml para descubrir la frase de contraseña a través de la firma Nombre clave.
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
<version>1.5</version>
<executions>
<execution>
<id>sign-artifacts</id>
<phase>verify</phase>
<goals>
<goal>sign</goal>
</goals>
<configuration>
<keyname>${gpg.keyname}</keyname>
<passphraseServerId>${gpg.keyname}</passphraseServerId>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
¿Se le solicita una frase de contraseña o recibe un gpg: signing failed: No such file or directory error?
Esto puede estar ocurriendo porque está utilizando gpg la versión 2.1 o posterior. Si la ejecución gpg --version muestra que está ejecutando la versión 2.1 o posterior, debe modificar la configuración del complemento Maven GPG para agregar archivos gpgArguments. Basándose en el ejemplo anterior:
<configuration>
<keyname>${gpg.keyname}</keyname>
<passphraseServerId>${gpg.keyname}</passphraseServerId>
<gpgArguments>
<arg>--pinentry-mode</arg>
<arg>loopback</arg>
</gpgArguments>
</configuration>
Pista
En el siguiente ejemplo, es posible que deba usar los últimos 8 caracteres del keyid de firma en formato hexadecimal, puede encontrarlos usando este comando gpg --list-signatures --keyid-format 0xshort:
$ gpg --list-signatures --keyid-format 0xshort
/home/mylocaluser/.gnupg/pubring.kbx
---------------------------------
pub rsa3072/0x3ABDEC12 2021-01-27 [SC] [expires: 2023-01-27]
74524542545300A398653AB5242798823ABDEC12
uid [ultimate] Other Name <[email protected]>
sig 3 0x3ABDEC12 2021-01-27 Other Name <[email protected]>
sub rsa3072 2021-01-27 [E] [expires: 2023-01-27]
sig 0x3ABDEC12 2021-01-27 Julian Alarcon <[email protected]>
pub rsa3072/0x0ABA0F98 2021-06-23 [SC] [expires: 2022-03-21]
CA925CD6C9E8D064FF05B4728190C4130ABA0F98
uid [ultimate] Central Repo Test <[email protected]>
sig 3 0x0ABA0F98 2021-06-24 Central Repo Test <[email protected]>
sub rsa3072/0x7C17C93B 2021-06-23 [E] [expires: 2023-06-23]
sig 0x0ABA0F98 2021-06-23 Central Repo Test <[email protected]>
Encontrará en la línea que comienza con sig 3 que 0x3ABDEC12 es el keyid corto de la firma en formato hexadecimal que deberá pasar como ${gpg.keyname}.
Si necesita más ayuda para instalar y configurar GPG, lea nuestras instrucciones detalladas .
Complemento Nexus Staging Maven para implementación y lanzamiento ⚓︎
El complemento Nexus Staging Maven es la forma recomendada de implementar sus componentes en OSSRH y liberarlos en el repositorio central. Para configurarlo, simplemente agregue el complemento a su Maven pom.xml.
<build>
<plugins>
...
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.7</version>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin>
Si su versión es una versión de lanzamiento (no termina en -SNAPSHOT) y con esta configuración en su lugar, puede ejecutar una implementación en OSSRH y una versión automatizada en el Repositorio central con lo habitual:
mvn clean deploy
Con la propiedad autoReleaseAfterClose configurada en falso, puede inspeccionar manualmente el repositorio de ensayo en Nexus Repository Manager y desencadenar una versión del repositorio de ensayo más adelante con
mvn nexus-staging:release
Si encuentra que algo salió mal, puede eliminar el repositorio de ensayo con
mvn nexus-staging:drop
Lea las versiones provisionales en la documentación de Repository Manager 2 para obtener más información sobre el complemento Nexus Staging Maven.
Padre oss en desuso ⚓︎
En el pasado, toda la configuración de los complementos y otras configuraciones las administraba un POM principal de Maven con las últimas coordenadas de org.sonatype.oss:oss-parent:9. Este proyecto filtró SCM, URL y otros detalles y se desaconseja su uso. El mantenimiento del proyecto se detuvo y ya no funciona con las herramientas más recientes, como las versiones de Maven o las versiones de Java. Si lo desea, administre su propio POM a nivel de organización de manera similar.
Usando un perfil ⚓︎
Dado que la generación de javadoc y archivos jar de origen, así como la firma de componentes con GPG, es un proceso que consume bastante tiempo, estas ejecuciones generalmente se aíslan de la configuración de compilación normal y se trasladan a un perfil. Este perfil se utiliza a su vez cuando se realiza una implementación mediante la activación del perfil.
<profiles>
<profile>
<id>release</id>
<build>
...
javadoc, source and gpg plugin from above
...
</build>
</profile>
</profiles>
Realización de una implementación de instantáneas ⚓︎
La implementación de instantáneas se realiza cuando su versión termina en -SNAPSHOT . No necesita cumplir con los requisitos al realizar implementaciones de instantáneas y simplemente puede ejecutar
mvn clean deploy
en tu proyecto
Las versiones de SNAPSHOT no están sincronizadas con el repositorio central. Si desea que sus usuarios consuman sus versiones SNAPSHOT, deberán agregar el repositorio de instantáneas a su Nexus Repository Manager, settings.xml o pom.xml. Las versiones de SNAPSHOT implementadas con éxito se encontrarán en el Índice de /repositorios/instantáneas
Realización de una implementación de lanzamiento ⚓︎
Para realizar una implementación de lanzamiento, debe editar version todos sus archivos POM para usar versiones de lanzamiento. Esto significa que no pueden terminar en -SNAPSHOT Además, las declaraciones de complemento y dependencia tampoco pueden usar versiones instantáneas. Esto garantiza que solo dependa de otros componentes publicados. Idealmente, todos están disponibles en el Repositorio Central. Esto asegura que sus usuarios puedan recuperar sus componentes así como también sus dependencias transitivas del Repositorio Central.
El cambio de las versiones para su proyecto y las referencias principales en una configuración de varios módulos se puede realizar manualmente o con la ayuda del complemento de versiones de Maven.
mvn versions:set -DnewVersion=1.2.3
Una vez que haya actualizado todas las versiones y se haya asegurado de que su compilación pase sin implementación, puede realizar la implementación con el uso del release perfil con
mvn clean deploy -P release
Este proceso es completamente independiente de su flujo de trabajo con su sistema SCM. Si desea asegurarse de que una versión específica en el Repositorio central corresponda a revisiones específicas en su sistema SCM, lo cual es una buena práctica, puede realizar las confirmaciones manualmente en un flujo similar a
- Desarrollar, desarrollar, desarrollar
- Confirmar cualquier cambio pendiente
- Verificar pases de compilación
- Actualizar versiones a la versión de lanzamiento
- Confirmar versión de lanzamiento
- Ejecutar implementación
- Actualizar versiones a la siguiente versión de instantánea
- Confirmar nueva versión de instantánea
- Revelar, revelar, revelar y enjuagar y repetir
o puede automatizarlo con un script de su elección, incluida una configuración que se ejecuta en un servidor de CI, o puede usar el complemento de lanzamiento de Maven, documentado a continuación.
Realización de una implementación de lanzamiento con el complemento de lanzamiento de Maven ⚓︎
El complemento de lanzamiento de Maven se puede usar para automatizar los cambios en los archivos POM de Maven, las comprobaciones de cordura, las operaciones de SCM requeridas y la ejecución real de la implementación.
La configuración del complemento de lanzamiento de Maven debe incluir la desactivación del perfil de lanzamiento que forma parte de Maven Super POM, ya que estamos usando nuestro propio perfil, y especificar el objetivo de implementación junto con la activación de nuestro perfil release .
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-release-plugin</artifactId>
<version>2.5.3</version>
<configuration>
<autoVersionSubmodules>true</autoVersionSubmodules>
<useReleaseProfile>false</useReleaseProfile>
<releaseProfiles>release</releaseProfiles>
<goals>deploy</goals>
</configuration>
</plugin>
Con la conexión SCM configurada correctamente, puede realizar una implementación de lanzamiento a OSSRH con
mvn release:clean release:prepare
respondiendo a las solicitudes de versiones y etiquetas, seguidas de
mvn release:perform
Esta ejecución se implementará en OSSRH y se liberará en el Repositorio central de una sola vez, gracias al uso del complemento Nexus Staging Maven con autoReleaseAfterClose establecido en verdadero.
Liberación manual de la implementación en el repositorio central ⚓︎
Si está utilizando autoReleaseAfterClose configurado en falso o está utilizando el complemento de implementación predeterminado de Maven, puede inspeccionar y potencialmente liberar los artefactos implementados manualmente
Alternativamente, si implementó con Nexus Staging Maven Plugin y la implementación tuvo éxito, puede liberar el repositorio directamente en la línea de comando. Inmediatamente después de la implementación, un archivo de propiedades en el directorio de destino contiene toda la información requerida y simplemente puede liberar el repositorio de ensayo con
mvn nexus-staging:release
Si ha estado ejecutando la implementación como parte de un lanzamiento realizado con el complemento de lanzamiento de Maven, la implementación se realizó desde la etiqueta en su sistema de control de versiones desprotegido en destino/pago, por lo que debe ejecutar el complemento Nexus Staging desde allí:
mvn release:perform
...
cd target/checkout
mvn nexus-staging:release
Puede configurar este objetivo para que se ejecute automáticamente como parte de su implementación de lanzamiento con el complemento de lanzamiento agregándolo como una ejecución de objetivo después del despliegue.
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-release-plugin</artifactId>
<configuration>
<goals>deploy nexus-staging:release</goals>
...