Gedeelde pijplijnen maken en gebruiken in Code Stream

Als Code Stream-beheerder kunt u pijplijnen delen zodat gebruikers in een organisatie deze in elk ander project kunnen uitvoeren of deze als geneste taken binnen een pijplijn in een ander project kunnen toevoegen.

Waarom is een gedeelde pijplijn nuttig?

Wanneer u een pijplijn deelt, elimineert u de noodzaak om dezelfde pijplijn te maken voor verschillende projecten in een organisatie. Als u een gedeelde pijplijn bijwerkt, beschikken alle pijplijngebruikers over dezelfde update.

Een gedeelde pijplijn kan ook worden gebruikt in Service Broker. Een Service Broker-beheerder kan uw gedeelde pijplijn als catalogusitem toevoegen zodat gebruikers deze voor meerdere projecten kunnen aanvragen en uitvoeren.

Alleen Code Stream-beheerders kunnen pijplijnen delen of het delen ervan stoppen.

Hoe deel ik een pijplijn

Als u een pijplijn wilt delen, klikt u op Pijplijn en selecteert u de pijplijn die u wilt delen.

1. Klik op Acties > Delen tussen projecten
2. Als de pijplijn is gedeactiveerd, klikt u op Acties > Inschakelen.
3. (Optioneel) Als u uw gedeelde pijplijn beschikbaar wilt maken in Service Broker, klikt u op Acties > Vrijgeven.

   Nadat u de pijplijn heeft vrijgegeven, kan een Service Broker-beheerder deze toevoegen aan Service Broker. Zie Code Stream-pijplijnen toevoegen aan de Service Broker-catalogus.

Hoe voer ik een gedeelde pijplijn uit

Om een gedeelde pijplijn uit te voeren, selecteert u de pijplijn en selecteert u een project.

De pijplijn wordt uitgevoerd in de context van het project dat u selecteert en alleen het pijplijnmodel wordt gedeeld. Infrastructuur zoals eindpunten of variabelen die in de pijplijn worden gebruikt, wordt niet gedeeld. Als een gedeelde pijplijn die gebruikmaakt van eindpunten of variabelen, wordt uitgevoerd voor een ander project, moeten die eindpunten en variabelen beschikbaar zijn voor dat project.

Stel dat jenkinsPipeline projectA gebruikt en een taak bevat met een eindpunt met de naam jenkinsEndpoint.

Als u jenkinsPipeline deelt en deze wilt uitvoeren in de context van projectB, moet er een jenkinsEndpoint op projectB bestaan. Als er geen jenkinsEndpoint is, maakt u het eindpunt op projectB voordat u de gedeelde pijplijn uitvoert.

De volgende procedure laat zien hoe u een eindpunt voor een ander project kunt dupliceren. U volgt vergelijkbare stappen voor een variabele.

1. Klik op Eindpunten. Klik op het eindpunt dat u wilt dupliceren, bijvoorbeeld jenkinsEndpoint, op Acties > Exporteren.
2. Klik op de knop Importeren en selecteer het YAML-bestand voor jenkinsEndpoint.
3. Bewerk het bestand om het project te wijzigen, zoals projectB in de volgende YAML-voorbeeldcode.

   ---
   project: projectB
   kind: ENDPOINT
   name: jenkinsEndpoint
   ...

4. Klik op Importeren.

Als u jenkinsPipeline op projectB wilt uitvoeren, klikt u op Uitvoeren op de pijplijnkaart en selecteert u projectB als project.

Opmerking: Als u de gedeelde pijplijn wilt uitvoeren op projectB, moet u de Code Stream-rol van beheerder, ontwikkelaar of uitvoerder hebben. Als u een Code Stream-lezer of -gebruiker bent, kunt u de pijplijn niet uitvoeren tenzij een Code Stream-beheerder u projectbeheerder of projectlid in projectB maakt. Zie Hoe beheer ik gebruikerstoegang en goedkeuringen in Code Stream? voor meer informatie over rollen in Code Stream.

Hoe voeg ik een gedeelde pijplijn toe aan een andere pijplijn?

Door gedeelde pijplijnen als geneste taken in een andere pijplijn te gebruiken, kunt u de pijplijnfunctionaliteit uitbreiden naast de pijplijnen die in één project zijn opgenomen. De gedeelde pijplijnen kunnen zich in verschillende projecten bevinden, los van elkaar en van de pijplijn waar ze zijn opgenomen als geneste taken.

In het volgende voorbeeld ziet u een pijplijn met de naam master-shared-pipeline-demo met twee geneste pijplijntaken.

Als u de pijplijn voor Task0 wilt opgeven, selecteert u deze uit een lijst met gedeelde pijplijnen. Elke pijplijnnaam bevat de projectnaam. Als verschillende gedeelde pijplijnen dezelfde naam hebben, kunt u de projectnaam gebruiken om de gewenste pijplijn te selecteren.

Opmerking: Om een pijplijn uit te voeren die geneste pijplijnen bevat, moet de pijplijn toegang hebben tot eindpunten of variabelen die worden gebruikt in de geneste pijplijnen. Als deze geen toegang heeft, moet u de inhoud voor het project voor de pijplijn maken.

Hoe gebruik ik een gedeelde pijplijn voor terugdraaien?

Als u een gedeelde pijplijn wilt gebruiken voor terugdraaien, selecteert u deze uit een lijst met pijplijnen wanneer u het terugdraaien voor de taak configureert. Code Stream filtert de lijst om alleen pijplijnen in hetzelfde project of gedeelde pijplijnen in verschillende projecten weer te geven.

Hoe gebruik ik een gedeelde VMware-cloudsjabloon in een pijplijn?

U kunt een gedeelde VMware-cloudsjabloon gebruiken als cloudsjabloonbron voor een taak in een pijplijn. Door gedeelde cloudsjablonen te gebruiken, heeft u toegang tot meer cloudsjablonen dan die in één project zijn opgenomen.

Voordat u de taak in Code Stream definieert, controleert u of de cloudsjabloon wordt gedeeld in Cloud Assembly en of u de naam en versie weet. Wanneer een cloudsjabloon wordt gedeeld, wordt een pictogram naast de projectnaam weergegeven in de lijst met cloudsjablonen.

Een VMware-cloudsjabloon in uw gedeelde pijplijn gebruiken:

• Selecteer VMware-cloudsjabloon bij Taaktype.
• Selecteer Implementatie maken of Implementatie bijwerken bij Actie.
• Als u een implementatie bijwerkt, selecteert u de naam van de implementatie.
• Selecteer VMware-cloudsjabloon bij Bron van cloudsjabloon.
• Voor Naam van cloudsjabloon selecteert u uit de lijst met cloudsjablonen of typt u een naam. Als u de vermelde cloudsjabloon niet ziet, is de reden dat de cloudsjabloon zich in een ander project dan de pijplijn bevindt en Code Stream alleen de cloudsjablonen weergeeft die zich in hetzelfde project bevinden.
• Bij Versie van cloudsjabloon typt u de versie van de cloudsjabloon.

In het volgende voorbeeld is shared-bp de gedeelde VMware-cloudsjabloon die u heeft geverifieerd in Cloud Assembly en wilt gebruiken, maar wordt deze niet weergegeven als selectie. Typ daarom de naam.

Opmerking: Als de VMware-cloudsjabloon die u opgeeft niet wordt gedeeld en u deze probeert te gebruiken in een pijplijn voor een ander project, kan de pijplijn niet worden uitgevoerd en wordt in een bericht gemeld dat de geselecteerde cloudsjabloon niet wordt gedeeld.

Hoe kan ik een pijplijn verwijderen of stoppen met het delen ervan

Als u een gedeelde pijplijn toevoegt als geneste taak of om een taak terug te draaien, wordt naar die pijplijn verwezen door de pijplijn waarin deze wordt gebruikt. Als u de pijplijn wilt verwijderen of wilt stoppen met het delen van de pijplijn, moet u deze verwijderen uit elke pijplijn die ernaar verwijst.

Als master-shared-pipeline-demo bijvoorbeeld Shared-Pipeline als geneste taak bevat, wordt er naar Shared-Pipeline verwezen. U kunt Shared-Pipeline pas verwijderen of stoppen met het delen ervan nadat u deze pijplijn uit master-shared-pipeline-demo heeft verwijderd.

Of als TestRollback Shared-Pipeline gebruikt om een taak terug te draaien, wordt naar Shared-Pipeline verwezen. U kunt Shared-Pipeline pas verwijderen of het delen ervan stoppen nadat u deze heeft verwijderd uit het terugdraaien van de taak in TestRollback.

De volgende procedure laat zien hoe u de verwijzingen van een pijplijn kunt controleren en de pijplijn kunt verwijderen uit de pijplijn waarnaar deze verwijst voordat u deze pijplijn verwijdert of stopt met het delen ervan.

1. Controleer op verwijzingen en werk pijplijnverwijzingen bij als deze worden gevonden.
   1. Klik op Pijplijnen. Klik voor de gedeelde pijplijn die u wilt controleren op Acties > Verwijzingen weergeven.
   2. Noteer de namen van Pijplijnen met verwijzing.
   3. Open de pijplijnen die naar de gedeelde pijplijn verwijzen. Verwijder de gedeelde pijplijn die als geneste taak wordt gebruikt of om een taak terug te draaien, en sla de pijplijn op.
2. Verwijder een pijplijn of stop met het delen ervan.
   • Klik voor de pijplijn die u wilt verwijderen op Acties > Verwijderen.
   • Klik voor de pijplijn waarvan u het delen wilt stoppen, op Acties > Delen stoppen.