Het binden van een pijplijntaak houdt in dat u een afhankelijkheid voor de taak maakt wanneer de pijplijn wordt uitgevoerd. U kunt op verschillende manieren een binding voor een pijplijntaak maken. U kunt een taak binden aan een andere taak, deze binden aan een variabele en expressie, of deze binden aan een voorwaarde.

Dollarbindingen toepassen op cloudsjabloonvariabelen in een cloudsjabloontaak

U kunt dollarbindingen toepassen op cloudsjabloonvariabelen in een cloudsjabloontaak in een vRealize Automation Code Stream-pijplijn. De manier waarop u de variabelen in vRealize Automation Code Stream wijzigt, is afhankelijk van de manier waarop de eigenschappen van de variabele in de cloudsjabloon zijn gecodeerd.

Als u dollarbindingen in een cloudsjabloontaak moet gebruiken, maar de huidige versie van de cloudsjabloon die u gebruikt in de cloudsjabloontaak dit niet toestaat, kunt u de cloudsjabloon in vRealize Automation Cloud Assembly wijzigen en een nieuwe versie implementeren. Vervolgens gebruikt u de nieuwe cloudsjabloonversie in uw cloudsjabloontaak en voegt u de dollarbindingen waar nodig toe.

Om dollarbindingen toe te passen op de eigenschapstypen die de vRealize Automation Cloud Assembly-cloudsjabloon biedt, moet u over de juiste rechten beschikken.

  • U moet dezelfde rol hebben als de persoon die de cloudsjabloonimplementatie heeft gemaakt in vRealize Automation Cloud Assembly.
  • De persoon die de pijplijn modelleert en de persoon die de pijplijn uitvoert, kunnen twee verschillende gebruikers zijn en kunnen verschillende rollen hebben.
  • Als een ontwikkelaar de vRealize Automation Code Stream-uitvoerderfunctie heeft en de pijplijn modelleert, moet de ontwikkelaar ook dezelfde vRealize Automation Cloud Assembly-rol hebben als de persoon die de cloudsjabloon heeft geïmplementeerd. De vereiste rol kan bijvoorbeeld vRealize Automation Cloud Assembly-beheerder zijn.
  • Alleen de persoon die de pijplijn modelleert, heeft toestemming om de pijplijn en de implementatie te maken.

Zo gebruikt u een API-token in de cloudsjabloontaak:

  • De persoon die de pijplijn modelleert, kan een API-token geven aan een andere gebruiker die de rol van vRealize Automation Code Stream-uitvoerder heeft. Wanneer de uitvoerder de pijplijn uitvoert, zal deze het API-token en de verificatiegegevens gebruiken die het API-token maakt.
  • Wanneer een gebruiker het API-token in de cloudsjabloontaak invoert, worden de verificatiegegevens gemaakt die nodig zijn om de pijplijn uit te voeren.
  • Als u de API-tokenwaarde wilt versleutelen, klikt u op Variabele maken.
  • Als u geen variabele voor het API-token maakt en deze in de cloudsjabloontaak gebruikt, wordt de waarde van het API-token weergegeven als tekst zonder opmaak.

Volg de volgende stappen als u dollarbindingen wilt toepassen op cloudsjabloonvariabelen in een cloudsjabloontaak.

U begint met een cloudsjabloon waarop invoervariabele-eigenschappen zijn gedefinieerd, zoals integerVar, stringVar, flavorVar, BooleanVar, objectVar, en arrayVar. De image-eigenschappen worden gedefinieerd in het gedeelte resources. De eigenschappen in de cloudsjablooncode kunnen er als volgt uitzien:

formatVersion: 1
inputs:
  integerVar:
    type: integer
    encrypted: false
    default: 1
  stringVar:
    type: string
    encrypted: false
    default: bkix
  flavorVar:
    type: string
    encrypted: false
    default: medium
  BooleanVar:
    type: boolean
    encrypted: false
    default: true
  objectVar:
    type: object
    encrypted: false
    default:
      bkix2: bkix2
  arrayVar:
    type: array
    encrypted: false
    default:
      - '1'
      - '2'
resources:
  Cloud_Machine_1:
    type: Cloud.Machine
    properties:
      image: ubuntu
      flavor: micro
      count: '${input.integerVar}'

U kunt dollartekenvariabelen ($) gebruiken voor image en flavor. Bijvoorbeeld:

resources:
  Cloud_Machine_1:
    type: Cloud.Machine
    properties:
      input: '${input.image}'
      flavor: '${input.flavor}'

Als u een cloudsjabloon wilt gebruiken in een vRealize Automation Code Stream-pijplijn en hieraan dollarbindingen wilt toevoegen, kunt u het volgende doen.

  1. Klik in vRealize Automation Code Stream op Pijplijnen > Blanco canvas.
  2. Voeg een taak Cloudsjabloon toe aan de pijplijn.
  3. In de taak Cloudsjabloon selecteert u Cloud Assembly Cloud Templates voor Bron van cloudsjabloon, voert u de naam van de cloudsjabloon in en selecteert u de versie van de cloudsjabloon.
  4. Merk op dat u een API-token kunt invoeren, waarmee u verificatiegegevens kunt opgeven zodat de pijplijn kan worden uitgevoerd, en dat u Variabele maken kunt gebruiken om een variabele te maken die het API-token in de cloudsjabloontaak versleutelt.
  5. In de tabel Parameter en waarde die wordt weergegeven, ziet u de parameterwaarden. De standaardwaarde voor soort is klein en de standaardwaarde voor image is ubuntu.
  6. Stel dat u de cloudsjabloon in vRealize Automation Cloud Assembly moet wijzigen. U kunt bijvoorbeeld het volgende doen:
    1. Stel de soort in om een eigenschap van het type array te gebruiken. vRealize Automation Cloud Assembly staat door komma's gescheiden waarden toe voor Soort wanneer het type array is.
    2. Klik op Implementeren.
    3. Voer op de pagina Implementatietype een implementatienaam in en selecteer de versie van de cloudsjabloon.
    4. Op de pagina Implementatie-invoeren kunt u een of meerdere waarden definiëren voor Soort.
    5. U ziet dat de Implementatie-inputs alle variabelen bevatten die zijn gedefinieerd in uw cloudsjablooncode en die worden weergegeven zoals gedefinieerd in de cloudsjablooncode. Bijvoorbeeld: Integer Var, String Var, Flavor Var, Boolean Var, Object Var en Array Var. String Var en Flavor Var zijn tekenreekswaarden en Boolean Var is een selectievakje.
    6. Klik op Implementeren.
  7. Selecteer in vRealize Automation Code Stream de nieuwe versie van de cloudsjabloon en voer waarden in de tabel Parameter en waarde in. Cloudsjablonen ondersteunen de volgende typen parameters en de mogelijkheid voor vRealize Automation Code Stream om dollarvariabelebindingen toe te staan. Dit resulteert in kleine verschillen in de gebruikersinterface van de vRealize Automation Code Stream-cloudsjabloontaak en de cloudsjablooninterface van vRealize Automation Cloud Assembly. Afhankelijk van de manier waarop een cloudsjabloon is gecodeerd, kan het zijn dat u wel of niet in staat bent om waarden in te voeren in de taak.
    1. Voor flavorVar: als de cloudsjabloon het type als tekenreeks of array heeft gedefinieerd, voert u een tekenreeks of een array met door komma's gescheiden waarden in. Een voorbeeld-array lijkt op test, test.
    2. Voor BooleanVar selecteert u true of false in het vervolgkeuzemenu. Of als u een variabelebinding wilt gebruiken, voert u $ in en selecteert u een variabelebinding in de lijst.
    3. Voer voor objectVar de waarde tussen accolades en aanhalingstekens in deze indeling in: {"bkix":"bkix":}.
    4. De objectVar wordt doorgestuurd naar de cloudsjabloon en kan op verschillende manieren worden gebruikt, afhankelijk van de cloudsjabloon. Hiermee kunt u een tekenreeksindeling voor een JSON-object maken en u kunt sleutelwaardeparen als door komma's gescheiden waarden toevoegen in de tabel met sleutelwaarden. U kunt tekst zonder opmaak invoeren voor een JSON-object of een sleutelwaardepaar als een normale tekenreeksindeling voor JSON.
    5. Voor arrayVar voert u de door komma's gescheiden invoerwaarde in als een array met de volgende indeling: ["1","2"].
  8. In de pijplijn kunt u een invoerparameter binden aan een array.
    1. Klik op het tabblad Invoer.
    2. Voer een naam in voor de invoer. Bijvoorbeeld arrayInput.
    3. In de tabel Parameter en waarde klikt u op arrayVar en voert u ${input.arrayInput} in.
    4. Nadat u de pijplijn heeft opgeslagen en ingeschakeld, moet u een waarde invoeren voor de array-invoer wanneer de pijplijn wordt uitgevoerd. Voer bijvoorbeeld ["1","2"] in en klik op Uitvoeren.

Nu heeft u geleerd hoe u variabelebindingen met het dollarteken ($) kunt gebruiken in een cloudsjabloon in een cloudsjabloontaak van een vRealize Automation Code Stream-pijplijn.

Een parameter doorgeven aan een pijplijn wanneer deze wordt uitgevoerd

U kunt invoerparameters aan uw pijplijn toevoegen zodat vRealize Automation Code Stream deze doorgeeft aan de pijplijn. Wanneer de pijplijn wordt uitgevoerd, moet een gebruiker de waarde invoeren voor de invoerparameter. U kunt uitvoerparameters aan uw pijplijn toevoegen zodat pijplijntaken de uitvoerwaarde van een taak kunnen gebruiken. vRealize Automation Code Stream ondersteunt het gebruik van parameters op veel manieren die uw eigen pijplijnbehoeften ondersteunen.

Als u bijvoorbeeld een gebruiker wilt vragen naar de URL naar zijn Git-server wanneer een pijplijn met een REST-taak wordt uitgevoerd, kunt u de REST-taak binden aan een Git-server-URL.

Als u de variabelebinding wilt maken, voegt u een URL-bindingsvariabele toe aan de REST-taak. Wanneer de pijplijn wordt uitgevoerd en de REST-taak is bereikt, moet een gebruiker de URL voor de Git-server invoeren. U kunt als volgt de binding maken:

  1. Klik op het tabblad Invoer in uw pijplijn.
  2. Om de parameter in te stellen voor Parameters automatisch injecteren klikt u op Git.

    De lijst met Git-parameters wordt weergegeven en bevat GIT_SERVER_URL. Als u een standaardwaarde voor de URL van de Git-server nodig heeft, kunt u deze parameter bewerken.

  3. Klik op Model en klik op uw REST-taak.
  4. Voer op het tabblad Taak in het gebied URL $ in en selecteer vervolgens invoer en GIT_SERVER_URL.

    De vermelding ziet er ongeveer zo uit: ${input.GIT_SERVER_URL}

  5. Om de integriteit van de binding van variabelen voor de taak te controleren, klikt u op Taak valideren.

    vRealize Automation Code Stream geeft aan dat de taak met succes is gevalideerd.

  6. Wanneer de pijplijn de REST-taak uitvoert, moet een gebruiker de URL voor de Git-server invoeren. Anders wordt de taak niet voltooid.

Twee pijplijntaken binden door invoer- en uitvoerparameters te maken

Als u twee taken aan elkaar wilt binden, voegt u een bindingsvariabele toe aan de invoerconfiguratie van de ontvangende taak. Wanneer de pijplijn wordt uitgevoerd, vervangt een gebruiker de bindingsvariabele door de vereiste input.

Als u pijplijntaken samen wilt binden, gebruikt u de dollartekenvariabele ($) in de invoer- en uitvoerparameters. Dit doet u als volgt.

Stel dat u wilt dat uw pijplijn een URL in een REST-taak oproept en een antwoord uitvoert. Hiervoor moet u zowel invoer- als uitvoerparameters in uw REST-taak opnemen. U moet ook een gebruiker hebben om de taak goed te keuren, dus u kunt ook een Gebruikersbewerkingstaak opnemen zodat een andere gebruiker deze kan goedkeuren wanneer de pijplijn wordt uitgevoerd. Dit voorbeeld toont hoe u expressies kunt gebruiken in de invoer- en uitvoerparameters en de pijplijn kunt laten wachten op goedkeuring van de taak.

  1. Klik op het tabblad Invoer in uw pijplijn.

  2. Laat de Automatisch parameters injecteren op Geen.
  3. Klik op Toevoegen en voer de naam, waarde en beschrijving van de parameter in en klik op OK. Bijvoorbeeld:
    1. Voer een URL-naam in.
    2. Voer de waarde in: {Stage0.Task3.input.http://www.docs.vmware.com}
    3. Voer een beschrijving in.
  4. Klik op het tabblad Uitvoer, klik op Toevoegen en voer de naam van de uitvoerparameter en de toewijzing in.

    1. Voer een unieke naam voor de uitvoerparameter in.
    2. Klik in het gebied Referentie en voer $ in.
    3. Voer de toewijzing van de taakuitvoer in door de opties te selecteren wanneer ze verschijnen. Selecteer de fase Stage0, selecteer de taak Task3, select uitvoer en selecteer responseCode. Klik vervolgens op OK.

  5. Sla uw pijplijn op.
  6. Klik in het menu Acties op Uitvoeren.
  7. Klik op Acties > Uitvoeringen bekijken.
  8. Klik op de uitvoering en bekijk de invoer- en uitvoerparameters die u heeft gedefinieerd.

  9. Als u de pijplijn wilt goedkeuren, klikt u op Gebruikersbewerkingen en bekijkt u de lijst met goedkeuringen op het tabblad Actieve items. Of blijf in Uitvoeringen, klik op de taak en klik vervolgens op Goedkeuren.
  10. Als u de knoppen Goedkeuren en Afwijzen wilt inschakelen, klikt u op het selectievakje naast de uitvoering.
  11. Vouw de vervolgkeuzepijl uit om de details weer te geven.
  12. Als u de taak wilt goedkeuren, klikt u op GOEDKEUREN, voert u een reden in en klikt u op OK.

  13. Klik op Uitvoeringen en controleer of de pijplijn verder wordt uitgevoerd.

  14. Als de pijplijn mislukt, corrigeert u eventuele fouten, slaat u de pijplijn op en voert u deze opnieuw uit.

Hoe kan ik meer informatie vinden over variabelen en expressies?

Zie Welke variabelen en expressies kan ik gebruiken bij het binden van pijplijntaken in vRealize Automation Code Stream? voor meer informatie over het gebruik van variabelen en expressies wanneer u pijplijntaken bindt.

Zie Hoe gebruik ik variabelebindingen in een voorwaardetaak om een pijplijn uit te voeren of te stoppen in vRealize Automation Code Stream? voor meer informatie over het gebruik van de pijplijntaakuitvoer met een binding van een voorwaardevariabele.