JenkinsFile Choice Parameter

In Jenkins ist der „Auswahlparameter“ ein Parameter, mit dem Sie einen einzelnen Wert aus einer vordefinierten Liste von Werten auswählen können. Dies kann nützlich sein, wenn Benutzer beim Erstellen eines Jenkins -Jobs aus einer Liste von Optionen ausgewählt werden sollen: Auswahl einer bestimmten Version einer Softwarekomponente zum Erstellen oder Test.

In diesem Beitrag werden Sie vermitteln, wie Sie einen Auswahlparameter innerhalb eines Jenkins -Jobs erstellen können.

Jenkins erstellen Auswahlparameter

Befolgen Sie die folgenden Schritte, um einen Auswahlparameter in Jenkins zu erstellen:

Anmelden Sie sich am Jenkins Dashboard an.

Klicken Sie auf die Option "Neue Element", um einen neuen Jenkins -Job zu erstellen.

Geben Sie als nächstes einen Namen für Ihren Job an und wählen Sie den Jobtyp als „Pipeline.”

Scrollen Sie nach unten zum Abschnitt "Pipeline" und wählen Sie die Definition "Pipeline -Syntax" aus der Dropdown.

Um einen Auswahlparameter hinzuzufügen, wählen Sie die Link „Pipeline Syntax“ aus, um den Pipeline -Generator zu öffnen.

Wählen Sie im linken Menü den "deklarativen Anweisungsgenerator" aus.

Wählen Sie aus den bereitgestellten Optionen in der Option Beispielanweisung „Parameter: Parameter“ aus.

Klicken Sie auf die Option "Hinzufügen", um einen neuen Parametertyp zu erstellen. Wählen Sie den Parametertyp als Wahl.

Geben Sie dem Parameter einen Namen und geben Sie verschiedene Möglichkeiten an, um die Werte auszuwählen. Sobald Sie mit der Option zufrieden sind, wählen Sie Syntax generieren, um die Zielpipeline -Syntax zu generieren.

Dies sollte Ihnen ein gültiges Pipeline -Beispiel geben, das Sie Ihrem Code hinzufügen können. Zum Beispiel:

Parameter
Auswahlauswahl: ['debian_amd64', 'ubuntu_amd64', 'centos_amd64'], Beschreibung: 'Wählen Sie Ihre Lieblingsverteilung, Name:' Dist '

Sobald wir zufrieden sind, können wir den Code kopieren und in den Pipeline -Abschnitt unserer Pipeline einfügen. Ein Beispiel für ein umfassendes Skript ist wie gezeigt:

Pipeline
Agent jeder
Parameter
Auswahlauswahl: ['debian_amd64', 'ubuntu_amd64', 'centos_amd64'], Beschreibung: 'Wählen Sie Ihre Lieblingsverteilung, Name:' Dist '

Stufen
Stage ('Build')
Schritte
Echo "Gebäude für Verteilung: $ Params.dist "

Diese Pipeline definiert eine einzelne Stufe namens „Build“, die einen einzelnen Schritt enthält, der eine Nachricht an die Konsole druckt, die den Wert des DIST -Parameters angibt.

Wenn wir diese Pipeline ausführen, werden wir mit einer Dropdown -Liste mit den Werten debian_amd64, ubuntu_amd64 und CentOS_AMD64 präsentiert. Wir wählen dann einen dieser Werte aus und führen dann die Pipeline aus.

Abschluss

Darin haben Sie gelernt, wie man den Jenkins -deklarativen Generator und den Jenkins -Parameterblock verwendet, um einen Parameter aus einer Liste von Werten zu erstellen.

Scrollen Sie in den Abschnitt "Nachbaueraktionen" und klicken. Wählen Sie aus den Optionen "andere Projekte erstellen".

1. Geben Sie im Feld „Projekte zum Erstellen“ den Namen des Jobs ein, den Sie auslösen möchten.
2. Scrollen Sie nach unten zum Abschnitt "Parameter" und klicken Sie auf den Dropdown "Parameter hinzufügen". Wählen Sie aus den Optionen "Auswahlparameter" aus.
3. Geben Sie einen Namen für Ihren Parameter ein (e.G. "My_choice") und eine Beschreibung (optional).
4. Geben Sie im Feld „Auswahl“ die Liste der Werte ein, die Sie für die Auswahl zur Verfügung stehen möchten. Jeder Wert sollte auf einer neuen Zeile liegen.
5. Klicken Sie auf die Schaltfläche "Speichern", um Ihren Job zu speichern.

Wenn Sie den Job erstellen, erhalten Sie eine Dropdown -Liste mit den von Ihnen angegebenen Werten. Sie können einen der Werte auswählen und dann den Job erstellen. Der von Ihnen ausgewählte Wert wird an den Befehl übergeben, den Sie in das Feld „Befehl“ eingegeben haben, und kann in Ihrem Build -Skript verwendet werden.