Obtención de dependencias de CodeCatalyst Obtención de paquetes desde repositorios de paquetes externos a través de CodeCatalyst Publicación de paquetes en CodeCatalyst Publicación de paquetes externos

Configuración y uso de mvn

Para ejecutar las compilaciones de Maven, se utiliza el comando mvn. Debe configurar mvn para usar el repositorio de paquetes y proporcionar un token de acceso personal (PAT) para la autenticación.

Contenido

Obtención de dependencias de CodeCatalyst

A fin de configurar mvn para obtener dependencias de un repositorio de CodeCatalyst, debe editar el archivo de configuración de Maven, settings.xml y, si lo desea, el archivo objeto de modelo de proyecto (POM) de su proyecto. El archivo POM contiene información sobre el proyecto, así como datos de configuración para que Maven compile el proyecto, como las dependencias, el directorio de compilación, el directorio del código fuente, el directorio del código fuente de pruebas, el complemento y los objetivos.

Uso de `mvn` para obtener dependencias del repositorio de paquetes de CodeCatalyst

Abra la consola de CodeCatalyst en https://codecatalyst.aws/.
En la página de información general del proyecto, seleccione Paquetes.
Elija su repositorio de paquetes de la lista de repositorios de paquetes.
Seleccione Establecer conexión con el repositorio.
En el cuadro de diálogo Establecer conexión con el repositorio, elija mvn en la lista de clientes de administrador de paquetes.
Necesitará un token de acceso personal (PAT) para autenticar mvn con CodeCatalyst. Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.
1. Seleccione Crear token.
2. Seleccione Copiar para copiar el PAT.
  
  aviso
  Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.
Añada al archivo settings.xml un perfil que contenga su repositorio. Reemplace los siguientes valores.

nota
Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.
- Sustituya space_name por el nombre de su espacio de CodeCatalyst.
- Sustituya proj_name por el nombre de su proyecto de CodeCatalyst.
- Sustituya repo_name por el nombre de su repositorio de paquetes de CodeCatalyst.
```
<profiles>
  <profile>
    <id>repo_name</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <repositories>
        <repository>
          <id>repo_name</id>
          <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
        </repository>
    </repositories>
  </profile>
</profiles>
```
Añada su servidor a la lista de servidores en el archivo settings.xml. Reemplace los siguientes valores.

nota
Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.
- Sustituya repo_name por el nombre de su repositorio de paquetes de CodeCatalyst.
- Sustituya username por su nombre de usuario en CodeCatalyst.
- Sustituya PAT por su PAT en CodeCatalyst.
```
<servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>
```
(Opcional) Configure un espejo en el archivo settings.xml que capture todas las conexiones y las dirija a su repositorio, en lugar de dirigirlas a un repositorio de puerta de enlace.

nota
Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.
- Sustituya space_name por el nombre de su espacio de CodeCatalyst.
- Sustituya proj_name por el nombre de su proyecto de CodeCatalyst.
- Sustituya repo_name por el nombre de su repositorio de paquetes de CodeCatalyst.
```
<mirrors>
  <mirror>
    <id>repo_name</id>
    <name>repo_name</name>
    <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
    <mirrorOf>*</mirrorOf>
  </mirror>
</mirrors>
```

importante

Puede usar cualquier valor en el elemento <id>, pero debe ser el mismo en los elementos <server> y <repository>. Esto permite incluir las credenciales especificadas en las solicitudes a CodeCatalyst.

Después de realizar estos cambios de configuración, puede crear el proyecto.


mvn compile

Obtención de paquetes desde repositorios de paquetes externos a través de CodeCatalyst

Puede instalar paquetes de Maven desde repositorios públicos a través de un repositorio de CodeCatalyst; para ello, configúrelo con una conexión ascendente a la puerta de enlace que representa el repositorio de puerta de enlace. Los paquetes instalados desde el repositorio de puerta de enlace se ingieren y almacenan en el repositorio de CodeCatalyst.

Actualmente, CodeCatalyst admite los siguientes repositorios públicos de paquetes de Maven.

maven-central-gateway
google-android-gateway
gradle-plugins-gateway
commonsware-gateway

Instalación de paquetes desde repositorios públicos de paquetes de Maven

Si aún no lo ha hecho, configure mvn con el repositorio de paquetes de CodeCatalyst siguiendo los pasos indicados en Obtención de dependencias de CodeCatalyst.
Compruebe que el repositorio haya añadido el repositorio de puerta de enlace desde el que desea hacer la instalación como conexión ascendente. Para comprobar qué orígenes ascendentes se han añadido, o para añadir un repositorio de puerta de enlace como origen ascendente, siga las instrucciones indicadas en Adición de un repositorio ascendente.

Para obtener más información sobre cómo solicitar paquetes desde repositorios ascendentes, consulte Solicitar una versión de paquete con repositorios ascendentes.

Publicación de paquetes en CodeCatalyst

Para publicar un paquete de Maven con mvn en un repositorio de CodeCatalyst, también debe editar ~/.m2/settings.xml y el POM del proyecto.

Uso de `mvn` para publicar paquetes en un repositorio de paquetes de CodeCatalyst

Abra la consola de CodeCatalyst en https://codecatalyst.aws/.
En la página de información general del proyecto, seleccione Paquetes.
Elija su repositorio de paquetes de la lista de repositorios de paquetes.
Seleccione Establecer conexión con el repositorio.
En el cuadro de diálogo Establecer conexión con el repositorio, elija mvn en la lista de clientes de administrador de paquetes.
Necesitará un token de acceso personal (PAT) para autenticar mvn con CodeCatalyst. Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.
1. Seleccione Crear token.
2. Seleccione Copiar para copiar el PAT.
  
  aviso
  Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.
Configure una variable de entorno en el equipo local con su PAT. Utilizará esta variable de entorno en el archivo setting.xml.
```
export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
```

Agregue una sección <servers> a settings.xml con una referencia a la variable de entorno CodeCatalyst_ARTIFACTS_TOKEN para que Maven pase el token en las solicitudes HTTP.


<settings>
...
    <servers>
        <server>
            <id>repo-name</id>
            <username>username</username>
            <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password>
        </server>
    </servers>
...
</settings>

Agregue una sección <distributionManagement> al pom.xml de su proyecto.


<project>
...
     <distributionManagement>
         <repository>
             <id>repo_name</id>
             <name>repo_name</name>
             <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
         </repository>
     </distributionManagement>
...
</project>

Tras realizar estos cambios de configuración, puede crear el proyecto y publicarlo en el repositorio especificado.


mvn deploy

Puede ir al repositorio de paquetes en la consola de CodeCatalyst para comprobar que el paquete se haya publicado correctamente.

Publicación de paquetes externos

Puede publicar paquetes de Maven externos en un repositorio de CodeCatalyst con mvn deploy:deploy-file. Esto puede resultar útil para los usuarios que desean publicar paquetes, solo tienen archivos JAR y no tienen acceso al código fuente del paquete o a los archivos POM.

El comando mvn deploy:deploy-file generará un archivo POM en función de la información pasada en la línea de comandos.

En primer lugar, cree un PAT si no tiene uno.

Creación de un token de acceso personal (PAT)

En la barra de menú superior, elija su insignia de perfil y, a continuación, elija Mi configuración.

sugerencia
También puede encontrar su perfil de usuario en la página de miembros de un proyecto o espacio, seleccionando el nombre en la lista de miembros.
En Nombre de PAT, introduzca un nombre descriptivo para el PAT.
En Fecha de vencimiento, mantenga la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de vencimiento predeterminada es de 1 año a partir de la fecha actual.
Seleccione Crear.

También puede crear este token si elige Clonar repositorio para un repositorio de código fuente.
Guarde el secreto del PAT en un lugar seguro.

importante
El secreto del PAT solo se muestra una vez. No podrá recuperarlo después de cerrar la ventana.

Publicación de paquetes de Maven externos

Cree un archivo ~/.m2/settings.xml con los siguientes contenidos:



<settings>
    <servers>
        <server>
            <id>repo_name</id>
            <username>username</username>
            <password>PAT}</password>
        </server>
    </servers>
</settings>

Ejecute el comando mvn deploy:deploy-file:


mvn deploy:deploy-file -DgroupId=commons-cli          \
-DartifactId=commons-cli       \
-Dversion=1.4                  \
-Dfile=./commons-cli-1.4.jar   \
-Dpackaging=jar                \
-DrepositoryId=repo-name      \
-Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/

nota

El ejemplo anterior publica commons-cli 1.4. Modifique los argumentos GroupID, ArtifactID, version y file para publicar un JAR diferente.

Estas instrucciones se basan en los ejemplos de la Guía para implementar archivos JAR de terceros en un repositorio remoto de la documentación de Apache Maven.

Para obtener más información sobre estos temas, consulte el sitio web del Proyecto Apache Maven:

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Configuración y uso de Gradle Groovy

Publicación de paquetes con curl

Configuración y uso de mvn

Contenido

Obtención de dependencias de CodeCatalyst

Uso de mvn para obtener dependencias del repositorio de paquetes de CodeCatalyst

aviso

nota

nota

nota

importante

Obtención de paquetes desde repositorios de paquetes externos a través de CodeCatalyst

Instalación de paquetes desde repositorios públicos de paquetes de Maven

Publicación de paquetes en CodeCatalyst

Uso de mvn para publicar paquetes en un repositorio de paquetes de CodeCatalyst

aviso

Publicación de paquetes externos

Creación de un token de acceso personal (PAT)

sugerencia

importante

Publicación de paquetes de Maven externos

nota

Uso de `mvn` para obtener dependencias del repositorio de paquetes de CodeCatalyst

Uso de `mvn` para publicar paquetes en un repositorio de paquetes de CodeCatalyst