Introducció a Azure Artifacts

Azure Artifacts és un servei de gestió de paquets que permet als desenvolupadors crear, allotjar i compartir paquets amb el seu equip. És una part integral d'Azure DevOps i suporta múltiples tipus de paquets, incloent NuGet, npm, Maven, i més. Aquest servei facilita la gestió de dependències i la distribució de paquets en un entorn de desenvolupament col·laboratiu.

Objectius d'aprenentatge

  • Comprendre què és Azure Artifacts i la seva importància.
  • Aprendre a crear i gestionar feeds de paquets.
  • Saber com publicar i consumir paquets.
  • Conèixer les millors pràctiques per a la gestió de paquets amb Azure Artifacts.

Què és Azure Artifacts?

Azure Artifacts és un servei que permet:

  • Crear i allotjar paquets: Permet als desenvolupadors crear paquets personalitzats i allotjar-los en un feed privat.
  • Compartir paquets: Facilita la compartició de paquets amb altres membres de l'equip o amb altres projectes.
  • Consumir paquets: Permet als desenvolupadors consumir paquets des de feeds privats o públics.

Tipus de paquets suportats

  • NuGet: Utilitzat principalment per a projectes .NET.
  • npm: Utilitzat per a projectes JavaScript.
  • Maven: Utilitzat per a projectes Java.
  • Python: Utilitzat per a projectes Python.
  • Universal Packages: Per a qualsevol tipus de fitxer o paquet.

Creació i gestió de feeds de paquets

Crear un feed de paquets

  1. Accedir a Azure DevOps: Inicia sessió al teu compte d'Azure DevOps.
  2. Seleccionar el projecte: Tria el projecte on vols crear el feed.
  3. Navegar a Artifacts: Al menú lateral, selecciona "Artifacts".
  4. Crear un nou feed: Fes clic a "New feed" i omple els detalls necessaris com el nom del feed i la visibilitat (privat o públic).

Exemple pràctic: Crear un feed de paquets

1. Inicia sessió a Azure DevOps.
2. Selecciona el teu projecte.
3. Al menú lateral, selecciona "Artifacts".
4. Fes clic a "New feed".
5. Introdueix el nom del feed, per exemple, "MyProjectFeed".
6. Selecciona la visibilitat del feed (privat o públic).
7. Fes clic a "Create".

Publicar i consumir paquets

Publicar un paquet

Per publicar un paquet, primer has de crear el paquet utilitzant l'eina adequada (per exemple, nuget, npm, maven, etc.) i després utilitzar les instruccions proporcionades per Azure Artifacts per pujar el paquet al feed.

Exemple pràctic: Publicar un paquet NuGet

  1. Crear el paquet: Utilitza nuget pack per crear el paquet.
  2. Configurar el feed: Afegeix el feed a la configuració de NuGet.
  3. Publicar el paquet: Utilitza nuget push per pujar el paquet al feed.
# Crear el paquet
nuget pack MyLibrary.csproj

# Configurar el feed
nuget sources add -name "MyProjectFeed" -source "https://pkgs.dev.azure.com/yourorganization/yourproject/_packaging/MyProjectFeed/nuget/v3/index.json"

# Publicar el paquet
nuget push MyLibrary.1.0.0.nupkg -source "MyProjectFeed"

Consumir un paquet

Per consumir un paquet, has d'afegir el feed a la configuració de l'eina que estàs utilitzant (per exemple, nuget.config, package.json, pom.xml, etc.) i després instal·lar el paquet.

Exemple pràctic: Consumir un paquet NuGet

  1. Configurar el feed: Afegeix el feed a nuget.config.
  2. Instal·lar el paquet: Utilitza nuget install per instal·lar el paquet.
<!-- nuget.config -->
<configuration>
  <packageSources>
    <add key="MyProjectFeed" value="https://pkgs.dev.azure.com/yourorganization/yourproject/_packaging/MyProjectFeed/nuget/v3/index.json" />
  </packageSources>
</configuration>
# Instal·lar el paquet
nuget install MyLibrary -Source "MyProjectFeed"

Millors pràctiques per a la gestió de paquets

  • Utilitzar versions semàntiques: Assegura't d'utilitzar versions semàntiques per als teus paquets per facilitar la gestió de dependències.
  • Automatitzar la publicació: Utilitza pipelines de CI/CD per automatitzar la publicació de paquets.
  • Revisar les dependències: Revisa regularment les dependències per assegurar-te que estàs utilitzant versions segures i actualitzades.
  • Documentar els paquets: Proporciona documentació clara sobre com utilitzar els paquets.

Exercicis pràctics

Exercici 1: Crear i publicar un paquet NuGet

  1. Crea un projecte de biblioteca .NET.
  2. Utilitza nuget pack per crear un paquet.
  3. Crea un feed de paquets a Azure Artifacts.
  4. Publica el paquet al feed.

Exercici 2: Consumir un paquet des d'un feed

  1. Configura el feed a nuget.config.
  2. Crea un projecte de consola .NET.
  3. Instal·la el paquet des del feed.
  4. Utilitza el paquet al projecte de consola.

Solucions als exercicis

Solució a l'exercici 1

# Crear el paquet
nuget pack MyLibrary.csproj

# Configurar el feed
nuget sources add -name "MyProjectFeed" -source "https://pkgs.dev.azure.com/yourorganization/yourproject/_packaging/MyProjectFeed/nuget/v3/index.json"

# Publicar el paquet
nuget push MyLibrary.1.0.0.nupkg -source "MyProjectFeed"

Solució a l'exercici 2

<!-- nuget.config -->
<configuration>
  <packageSources>
    <add key="MyProjectFeed" value="https://pkgs.dev.azure.com/yourorganization/yourproject/_packaging/MyProjectFeed/nuget/v3/index.json" />
  </packageSources>
</configuration>
# Instal·lar el paquet
nuget install MyLibrary -Source "MyProjectFeed"

Resum

En aquest tema, hem après què és Azure Artifacts i com ens pot ajudar a gestionar paquets en un entorn de desenvolupament col·laboratiu. Hem vist com crear i gestionar feeds de paquets, així com publicar i consumir paquets. També hem revisat algunes millors pràctiques per a la gestió de paquets i hem realitzat exercicis pràctics per reforçar els conceptes apresos.

© Copyright 2024. Tots els drets reservats