👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Publicar paquetes Java con Maven

Puedes usar Maven para publicar paquetes Java en un registro como parte de tu flujo de trabajo de integración continua (CI).

GitHub Actions se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, y GitHub One. GitHub Actions no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Para obtener más información, consulta la sección "Productos de GitHub".

En este artículo

¿Pudiste encontrar lo que estabas buscando?

Introducción

Esta guía te muestra cómo crear un flujo de trabajo que publique paquetes de Java en GitHub Packages y en el Repositorio Central de Maven. Con un solo flujo de trabajo, puedes publicar los paquetes en un solo repositorio o en varios repositorios.

Prerrequisitos

Te recomendamos que tengas una comprensión básica de los archivos de flujo de trabajo y las opciones de configuración. Para obtener más información, consulta "Configurar un flujo de trabajo".

Para obtener más información acerca de la creación de un flujo de trabajo de CI para tu proyecto Java con Maven, consulta "Construir y probar Java con Maven".

También puede ser útil tener un conocimiento básico de lo siguiente:

Acerca de la configuración del paquete

Los campos groupld y artifactId del archivo pom.xml crea un identificador único para tu paquete que los registros usan para vincular tu paquete a un registro. Para obtener más información, consulta Guía para cargar artefactos en el repositorio central en la documentación de Apache Maven.

El archivo pom.xml también contiene la configuración de los repositorios de administración de distribución en los que Maven implementará los paquetes. Cada repositorio debe tener un nombre y una URL de implementación. La autenticación para estos repositorios se puede configurar en el archivo .m2/settings.xml del directorio de inicio del usuario que ejecuta Maven.

Puedes usar la acción setup-java para configurar el repositorio de implementación, así como la autenticación para ese repositorio. Para obtener más información, consulta setup-java.

Publicar paquetes en el repositorio central de Maven

Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo del siguiente ejemplo se ejecuta cuando el evento release se desencadena con tipo created. El flujo de trabajo publica el paquete en el repositorio central de Maven si se superan las pruebas de CI. Para obtener más información sobre el evento release, consulta "Eventos que desencadenan flujos de trabajo".

En este flujo de trabajo, puedes usar la acicón setup-java. Esta acción instala la versión dada del JDK en el PATH, pero también configura un Maven settings.xml para publicar paquetes. Por defecto, el archivo de configuraciones se configurará para GitHub Packages, pero se puede configurar para que se implemente en otro registro de paquetes, como el repositorio central de Maven. Si ya tienes un repositorio de administración de distribución configurado en pom.xml, puedes especificar que id durante la acción de invocación setup-java.

Por ejemplo, si estás desplegando en el repositorio central de Maven a través del proyecto de alojamiento OSSRH, tu pom.xml podría especificar un repositorio de administración de distribución con el id de ossrh.

<project ...>
  ...
  <distributionManagement>
    <repository>
      <id>ossrh</id>
      <name>Central Repository OSSRH</name>
      <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
    </repository>
  </distributionManagement>
</project>

Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en el repositorio central de Maven especificando la administración del repositorio id para la acción setup-java. También deberás proporcionar variables de entorno que contengan el nombre de usuario y la contraseña para autenticarse en el repositorio.

En el paso de implementación, necesitarás establecer las variables de entorno para el nombre de usuario con el que te autenticaste en el repositorio y para el secreto que hayas configurado con la contraseña o el token con que autenticarse. Para obtener más información, consulta "Crear y usar secretos cifrados".

name: Publish package to the Maven Central Repository
on:
  release:
    types: [created]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Set up Maven Central Repository
        uses: actions/setup-java@v1
        with:
          java-version: 1.8
          server-id: ossrh
          server-username: MAVEN_USERNAME
          server-password: MAVEN_PASSWORD
      - name: Publish package
        run: mvn -B deploy
        env:
          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}

Este flujo de trabajo realiza los siguientes pasos:

  1. Revisa una copia del repositorio del proyecto.

  2. Configura el JDK de Java y también el archivo settings. xml de Maven para agregarle autenticación al repositorio de ossrh utilizando las variables de entorno MAVEN_USERNAME y MAVEN_PASSWORD.

  3. Ejecuta el comando mvn -B deploy para publicar el repositorio ossrh. La variable de ambiente MAVEN_USERNAME se configurará con el contenido de tu secreto OSSRH_USERNAME, y la variable de ambiente MAVEN_PASSWORD se configurará con el contenido de tu secreto OSSRH_TOKEN.

    Para obtener más información sobre el uso de secretos en tu flujo de trabajo, consulta "Crear y usar secretos cifrados".

Sube paquetes al GitHub Packages

Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el siguiente ejemplo se ejecuta cuando el evento release se desencadena con el tipo created. El flujo de trabajo publica el paquete en el GitHub Packages si se pasan las pruebas de CI. Para obtener más información sobre el evento release, consulta "Eventos que desencadenan flujos de trabajo".

En este flujo de trabajo, puedes usar la acción setup-java. Esta acción instala la versión determinada del JDK en el PATH y configura un settings.xml de Maven para publicar el paquete en el GitHub Packages. El settings.sml generado define la autenticación para un servidor con una id de github, utilizando la variable de entorno GITHUB_ACTOR como nombre de usuario y la variable de entorno GITHUB_TOKEN como contraseña.

El GITHUB_TOKEN existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para obtener más información, consulta "Autenticar con el GITHUB_TOKEN".

Para un proyecto basado en Maven, puedes hacer uso de estas configuraciones creando un repositorio de distribución en tu archivo pom.xml con una id de github que apunta a tu extremo GitHub Packages.

Por ejemplo, si tu organización se llama "octocat", y tu repositorio se llama "hello-world", la configuración de GitHub Packages en pom.xml sería parecida al siguiente ejemplo.

<project ...>
  ...
  <distributionManagement>
    <repository>
      <id>github</id>
      <name>GitHub Packages</name>
      <url>https://maven.pkg.github.com/octocat/hello-world</url>
    </repository>
  </distributionManagement>
</project>

Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en GitHub Packages haciendo uso del settings.xml generado automáticamente.

name: Publish package to GitHub Packages
on:
  release:
    types: [created]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-java@v1
        with:
          java-version: 1.8
      - name: Publish package
        run: mvn -B deploy
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Este flujo de trabajo realiza los siguientes pasos:

  1. Revisa una copia del repositorio del proyecto.

  2. Configura el JDK de Java y configura automáticamente el archivo settings.xml de Maven para agregar autenticación para que el repositorio github de Maven utilice la variable de entorno GITHUB_TOKEN.

  3. Ejecuta el comando mvn -B deploy para publicar en GitHub Packages. La variable de ambiente GITHUB_TOKEN se configurará con el contenido del secreto GITHUB_TOKEN.

    Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "Crear y usar secretos cifrados".

Publicar paquetes en el repositorio central de Maven y GitHub Packages

Puedes publicar tus paquetes en el repositorio central de Maven y en el GitHub Packages usando la acción setup-java para cada registro.

Asegúrate de que tu archivo pom.xml incluya un repositorio de administración de distribución para tu repositorio de GitHub y para tu proveedor de repositorios centrales de Maven. Por ejemplo, si implementas el repositorio central a través del proyecto de alojamiento de OSSRH, es posible que desees especificarlo en un repositorio de administración de distribución con la id establecida en ossrh, y que desees especificar el GitHub Packages en un repositorio de administración de distribución con la id establecida en github.

name: Publish package to the Maven Central Repository and GitHub Packages
on:
  release:
    types: [created]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Set up Java for publishing to Maven Central Repository
        uses: actions/setup-java@v1
        with:
          java-version: 1.8
          server-id: ossrh
          server-username: MAVEN_USERNAME
          server-password: MAVEN_PASSWORD
      - name: Publish to the Maven Central Repository
        run: mvn -B deploy
        env:
          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
      - name: Set up Java for publishing to GitHub Packages
        uses: actions/setup-java@v1
        with:
          java-version: 1.8
      - name: Publish to GitHub Packages
        run: mvn -B deploy
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Este flujo de trabajo llama a la acción setup-java dos veces. Cada vez que la acción setup-java se ejecuta, sobrescribe el archivo settings.xml de Maven para publicar paquetes. Para la autenticación en el repositorio, el archivo settings.xml hace referencia a la id del repositorio de administración de distribución y al nombre de usuario y contraseña.

Este flujo de trabajo realiza los siguientes pasos:

  1. Revisa una copia del repositorio del proyecto.

  2. Llama al setup-java la primera vez. Esto configura el archivo settings.xml de Maven para el repositorio ossrh y establece las opciones de autenticación en las variables de entorno que se definen en el siguiente paso.

  3. Ejecuta el comando mvn -B deploy para publicar el repositorio ossrh. La variable de ambiente MAVEN_USERNAME se configurará con el contenido de tu secreto OSSRH_USERNAME, y la variable de ambiente MAVEN_PASSWORD se configurará con el contenido de tu secreto OSSRH_TOKEN.

  4. Llama al setup-java la segunda vez. Esto configura automáticamente el archivo settings.xml de Maven para el GitHub Packages.

  5. Ejecuta el comando mvn -B deploy para publicar en GitHub Packages. La variable de ambiente GITHUB_TOKEN se configurará con el contenido del secreto GITHUB_TOKEN.

    Para obtener más información sobre el uso de secretos en tu flujo de trabajo, consulta "Crear y usar secretos cifrados".

¿Pudiste encontrar lo que estabas buscando?

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos