Obteniendo dependencias de CodeCatalyst Obtener paquetes de repositorios de paquetes externos mediante CodeCatalyst Publicar paquetes en CodeCatalyst Publicar paquetes de terceros

Configuración y uso de mvn

El mvn comando se usa para ejecutar compilaciones de Maven. Debe configurarlo mvn para usar su repositorio de paquetes y proporcionar un token de acceso personal (PAT) para la autenticación.

Contenido

Obteniendo dependencias de CodeCatalyst

mvnPara configurar la búsqueda de dependencias de un CodeCatalyst repositorio, debe editar el archivo de configuración de Maven settings.xml y, si lo desea, el archivo Project Model Object () de su proyecto. POM El POM archivo contiene información sobre el proyecto e información de configuración para que Maven pueda compilarlo, como las dependencias, el directorio de compilación, el directorio fuente, el directorio fuente de prueba, el complemento y los objetivos.

Para usar `mvn` para recuperar las dependencias del repositorio de paquetes CodeCatalyst

Abre la CodeCatalyst consola en https://codecatalyst.aws/.
En la página de información general de su proyecto, elija Paquetes.
Elija su repositorio de paquetes de la lista de repositorios de paquetes.
Selecciona Conectar al repositorio.
En el cuadro de diálogo Conectar al repositorio, elija mvn de la lista de clientes del administrador de paquetes.
Necesitará un token de acceso personal (PAT) para autenticarse. mvn CodeCatalyst Si ya tienes uno, puedes usarlo. Si no, puedes crear uno aquí.
1. Elige Crear token.
2. Selecciona Copiar para copiar tuPAT.
  
  aviso
  No podrá PAT volver a verlo ni copiarlo después de cerrar el cuadro de diálogo.
Añada al settings.xml archivo un perfil que contenga su repositorio. Sustituya los valores siguientes.

nota
Si copia las instrucciones de la consola, debe actualizar los siguientes valores y no cambiarlos.
- Reemplazar space_name con el nombre de su CodeCatalyst espacio.
- Reemplazar proj_name con el nombre de tu CodeCatalyst proyecto.
- Reemplazar repo_name con el nombre CodeCatalyst del repositorio de paquetes.
```
<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 de su settings.xml archivo. Sustituya los valores siguientes.

nota
Si copia las instrucciones de la consola, debe actualizar los siguientes valores y no cambiarlos.
- Reemplazar repo_name con el nombre CodeCatalyst del repositorio de paquetes.
- Reemplazar username con su nombre CodeCatalyst de usuario.
- Reemplazar PAT con tu CodeCatalystPAT.
```
<servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>
```
(Opcional) Configura un espejo en el settings.xml archivo que capture todas las conexiones y las dirija a tu repositorio en lugar de a un repositorio de puerta de enlace.

nota
Si está copiando las instrucciones de la consola, los siguientes valores deberían actualizarse automáticamente y no cambiarse.
- Reemplazar space_name con el nombre de su CodeCatalyst espacio.
- Reemplazar proj_name con el nombre de tu CodeCatalyst proyecto.
- Reemplazar repo_name con el nombre CodeCatalyst del repositorio de paquetes.
```
<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 para CodeCatalyst.

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


mvn compile

Obtener paquetes de repositorios de paquetes externos mediante CodeCatalyst

Puede instalar paquetes Maven desde repositorios públicos a través de un CodeCatalyst repositorio configurándolo con una conexión ascendente a la puerta de enlace que representa el repositorio de la puerta de enlace. Los paquetes instalados desde el repositorio de la puerta de enlace se ingieren y almacenan en su repositorio. CodeCatalyst

Actualmente, CodeCatalyst es compatible con los siguientes repositorios públicos de paquetes de Maven.

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

Para instalar paquetes desde repositorios de paquetes públicos de Maven

Si aún no lo ha hecho, configúrelo mvn con su repositorio de CodeCatalyst paquetes siguiendo los pasos que se indican en. Obteniendo dependencias de CodeCatalyst
Asegúrese de que su repositorio haya agregado el repositorio de puerta de enlace desde el que desea realizar la instalación como conexión ascendente. Para comprobar qué fuentes ascendentes se han añadido o para añadir un repositorio de puerta de enlace como fuente ascendente, siga las instrucciones que se indican en. Añadir un repositorio ascendente

Para obtener más información sobre la solicitud de paquetes desde los repositorios ascendentes, consulte. Solicitar una versión de paquete con repositorios ascendentes

Publicar paquetes en CodeCatalyst

Para publicar un paquete de Maven en un CodeCatalyst repositorio, también debe editar ~/.m2/settings.xml el proyectoPOM. mvn

Para usar `mvn` para publicar paquetes en su repositorio de CodeCatalyst paquetes

Abra la CodeCatalyst consola en https://codecatalyst.aws/.
En la página de información general de su proyecto, elija Paquetes.
Elija su repositorio de paquetes de la lista de repositorios de paquetes.
Selecciona Conectar al repositorio.
En el cuadro de diálogo Conectar al repositorio, elija mvn de la lista de clientes del administrador de paquetes.
Necesitará un token de acceso personal (PAT) para autenticarse. mvn CodeCatalyst Si ya tienes uno, puedes usarlo. Si no, puedes crear uno aquí.
1. Elige Crear token.
2. Selecciona Copiar para copiar tuPAT.
  
  aviso
  No podrá PAT volver a verlo ni copiarlo después de cerrar el cuadro de diálogo.
Configure una variable de entorno en su máquina local con suPAT. Utilizará esta variable de entorno en su setting.xml archivo.
```
export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
```

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


<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

Puedes navegar hasta el repositorio de paquetes en la CodeCatalyst consola para comprobar que el paquete se publicó correctamente.

Publicar paquetes de terceros

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

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

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

Para crear 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 puedes encontrar tu perfil de usuario si vas a la página de miembros de un proyecto o espacio y eliges tu nombre en la lista de miembros.
En PATnombre, introduce un nombre descriptivo para tuPAT.
En Fecha de caducidad, deje la fecha predeterminada o elija el icono del calendario para seleccionar una fecha personalizada. La fecha de caducidad se establece de forma predeterminada en un año a partir de la fecha actual.
Seleccione Crear.

También puede crear este token si elige Clonar repositorio para un repositorio de origen.
Guarda el PAT secreto en un lugar seguro.

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

Para publicar paquetes Maven de terceros

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

Se publica commons-cli 1.4 el ejemplo anterior. Modifique groupId los argumentos ArtifactID, version y file para publicar uno diferente. JAR

Estas instrucciones se basan en los ejemplos de la guía para implementar un repositorio externo JARs en un repositorio remoto de la documentación de Apache Maven.

Para obtener más información, consulte estos temas en 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

Publicar paquetes con curl

Configuración y uso de mvn

Contenido

Obteniendo dependencias de CodeCatalyst

Para usar mvn para recuperar las dependencias del repositorio de paquetes CodeCatalyst

aviso

nota

nota

nota

importante

Obtener paquetes de repositorios de paquetes externos mediante CodeCatalyst

Para instalar paquetes desde repositorios de paquetes públicos de Maven

Publicar paquetes en CodeCatalyst

Para usar mvn para publicar paquetes en su repositorio de CodeCatalyst paquetes

aviso

Publicar paquetes de terceros

Para crear un token de acceso personal (PAT)

sugerencia

importante

Para publicar paquetes Maven de terceros

nota

Para usar `mvn` para recuperar las dependencias del repositorio de paquetes CodeCatalyst

Para usar `mvn` para publicar paquetes en su repositorio de CodeCatalyst paquetes