Cómo trabajar con artefactos en TeamCity

Una vez terminada su compilación, ¿cómo extrae los datos que contiene?

En TeamCity, puede hacerlo fácilmente con la ayuda de artefactos. En este tutorial, veremos más de cerca cómo trabajar con artefactos en TeamCity.

¿Qué es un artefacto?

Cualquier archivo que produzca su compilación es un artefacto potencial, como una aplicación empaquetada en un archivo .jar o .zip. Una vez que la compilación haya terminado de ejecutarse en el agente de compilación, TeamCity tomará esos archivos y los subirá a la interfaz de usuario del servidor de TeamCity, donde podrá acceder a ellos y revisarlos.

Obtenga más información sobre los artefactos de compilación en nuestra documentación.

Cómo configurar artefactos en TeamCity

Para obtener los datos producidos por su compilación, diríjase a Edit Configuration.

tutorials-img

En la pestaña General Settings, encontrará un campo de entrada llamado Artifact Paths.

¿Qué es una ruta de artefactos?

En TeamCity, la ruta de artefactos se refiere a la ubicación donde se almacenan los artefactos de compilación después de un proceso de compilación exitoso. Los artefactos son los archivos de salida, binarios u otros resultados importantes generados durante la compilación. La ruta de artefactos especifica el directorio o la estructura de carpetas dentro del servidor de TeamCity donde se publican estos artefactos y se puede acceder a ellos.

tutorials-img

En este ejemplo, sabemos que nuestra compilación crea un subdirectorio de artefactos, y queremos que todos los archivos de ese subdirectorio estén disponibles. Especifique la ruta del artefacto en el campo y haga clic en Save.

tutorials-img

¿Dónde se almacenan los artefactos?

TeamCity tiene un almacenamiento de artefactos integrado. También puede conectar un almacenamiento de artefactos externo que trabaje con TeamCity. Actualmente, TeamCity es compatible con Amazon S3, Azure Artifact Storage y Google Cloud Artifact Storage.

Ahora, una vez que ejecutemos la compilación, podremos ver algunos cambios. Anteriormente, el icono de artefacto estaba en gris, lo que significa que no había artefactos identificados por el usuario en esta compilación.

El icono azul claro indica que TeamCity ha descubierto y almacenado satisfactoriamente artefactos para esta compilación. Cuando hacemos clic en el icono azul, podemos ver que hay dos archivos almacenados como artefactos: un registro de la aplicación y una grabación de Selenium.

También puede hacer clic en cada archivo por separado y revisarlo.

tutorials-img

¿Por qué son útiles los artefactos?

Los datos de los agentes de compilación se transfieren al servidor TeamCity o, más concretamente, a un almacenamiento específico. El almacenamiento puede ser en la nube, localmente o en cualquier lugar que usted especifique.

Estos datos no solo están disponibles en el servidor TeamCity, sino que también están disponibles y listos para ser pasados a través de una cadena de compilación o de varias configuraciones de compilación. Por ejemplo, si un trabajo de despliegue necesita un archivo .jar de un trabajo de compilación anterior, este archivo puede pasarse con la ayuda de artefactos.

¿Cómo copio los artefactos?

En TeamCity, puede copiar los artefactos de una compilación a otra con la función «Artifact Dependency». Para ello, debe configurar las rutas de los artefactos en la compilación de origen, configurar la dependencia de los artefactos en la compilación de destino, ejecutar las compilaciones y verificar la copia de los artefactos. Al configurar las dependencias de los artefactos, se crea un vínculo entre las compilaciones en TeamCity, lo que permite la transferencia fluida de artefactos de una compilación a otra.

¿A punto para empezar a configurar artefactos? Consulte nuestra documentación, y no dude en ponerse en contacto con nosotros si tiene alguna pregunta.