La integració contínua (CI) és una pràctica de desenvolupament de programari que implica la fusió freqüent de canvis de codi en un repositori central, seguit de la realització automàtica de proves. En aquest tema, aprendrem com integrar Postman en un procés de CI per assegurar-nos que les nostres proves d'API es realitzen de manera automàtica cada vegada que es produeixen canvis en el codi.

Conceptes Clau

  1. Integració Contínua (CI):

    • Procés de combinar canvis de codi de diversos desenvolupadors en un projecte de programari de manera freqüent.
    • Inclou l'execució automàtica de proves per detectar errors ràpidament.
  2. Newman:

    • Una eina de línia de comandes per executar col·leccions de Postman.
    • Permet integrar les proves d'API en sistemes de CI com Jenkins, Travis CI, etc.
  3. Sistemes de CI Populars:

    • Jenkins
    • Travis CI
    • CircleCI
    • GitLab CI/CD

Passos per Integrar Postman en un Procés de CI

  1. Exportar la Col·lecció de Postman

  • Pas 1: Obre Postman i selecciona la col·lecció que vols exportar.
  • Pas 2: Fes clic a "Exportar" i guarda el fitxer JSON de la col·lecció al teu sistema.

  1. Instal·lar Newman

  • Pas 1: Assegura't de tenir Node.js instal·lat al teu sistema.
  • Pas 2: Instal·la Newman utilitzant el següent comandament:
    npm install -g newman
    

  1. Executar la Col·lecció amb Newman

  • Pas 1: Utilitza el següent comandament per executar la col·lecció exportada:
    newman run /path/to/your/collection.json
    
  • Pas 2: Revisa els resultats de les proves a la consola.

  1. Configurar el Sistema de CI

  • Pas 1: Tria un sistema de CI (per exemple, Jenkins).
  • Pas 2: Crea un nou treball o pipeline.
  • Pas 3: Afegeix un pas per executar el comandament de Newman:
    newman run /path/to/your/collection.json
    
  • Pas 4: Configura el treball perquè s'executi automàticament en cada canvi de codi.

Exemple de Configuració amb Jenkins

  1. Instal·lar Jenkins:

    • Descarrega i instal·la Jenkins al teu servidor o utilitza un servei d'allotjament de Jenkins.
  2. Crear un Nou Treball:

    • A la interfície de Jenkins, crea un nou treball de tipus "Freestyle project".
  3. Configurar el Treball:

    • Afegeix un pas de construcció per executar un script de shell.
    • Inclou el comandament de Newman per executar la col·lecció.
  4. Configurar Triggers:

    • Configura el treball perquè s'executi automàticament en cada commit al repositori de codi.

Exercici Pràctic

Objectiu: Configurar un pipeline de CI que executi proves d'API amb Postman utilitzant Jenkins.

Passos:

  1. Exporta una col·lecció de Postman que contingui almenys tres sol·licituds d'API.
  2. Instal·la Newman i executa la col·lecció localment per assegurar-te que funciona correctament.
  3. Configura un servidor Jenkins i crea un nou treball per executar la col·lecció amb Newman.
  4. Configura el treball perquè s'executi automàticament en cada canvi de codi al teu repositori.

Solució:

  • Assegura't que el treball de Jenkins està configurat correctament i que les proves s'executen sense errors.
  • Revisa els logs de Jenkins per verificar que les proves s'han executat i han passat correctament.

Conclusió

Integrar Postman en un procés de CI permet assegurar que les proves d'API es realitzen de manera automàtica i consistent, millorant la qualitat del programari i reduint el temps de detecció d'errors. Amb l'ús de Newman i un sistema de CI com Jenkins, pots automatitzar completament les proves d'API i integrar-les en el teu flux de treball de desenvolupament.

© Copyright 2024. Tots els drets reservats