UseRubyVersion@0 – Ruby-Version v0-Aufgabe verwenden

Verwenden Sie diese Aufgabe, um eine Version von Ruby auszuwählen, die auf einem Agent ausgeführt werden soll. Optional kann die Aufgabe die Ruby-Version zu PATH hinzufügen.

Syntax

# Use Ruby version v0
# Use the specified version of Ruby from the tool cache, optionally adding it to the PATH.
- task: UseRubyVersion@0
  inputs:
    versionSpec: '>= 2.4' # string. Required. Version spec. Default: >= 2.4.
    #addToPath: true # boolean. Add to PATH. Default: true.

Eingänge

versionSpec - Versionsspezifikation
string. Erforderlich. Standardwert: >= 2.4.

Gibt den Versionsbereich oder eine Version einer Ruby-Version an, die verwendet werden soll.

addToPath - Zu PATH- hinzufügen
boolean. Standardwert: true.

Wahlfrei. Stellt die abgerufene Ruby-Version der PATH-Umgebungsvariablen voran, um sie in nachfolgenden Aufgaben oder Skripts verfügbar zu machen, ohne die Ausgabevariable zu verwenden.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

rubyLocation
Der aufgelöste Ordner der Ruby-Verteilung.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Version von Ruby auszuwählen, die auf einem Agent ausgeführt werden soll, und fügen Sie sie optional zu PATH hinzu.

Voraussetzungen

• Ein von Microsoft gehosteter Agent mit parallel installierten Versionen von Ruby oder ein selbst gehosteter Agent mit Agent.ToolsDirectory konfiguriert (siehe HÄUFIG gestellte Fragen).

Diese Aufgabe schlägt fehl, wenn keine Ruby-Versionen in Agent.ToolsDirectorygefunden werden. Weitere verfügbare Ruby-Versionen finden Sie unter von Microsoft gehosteten Agents.

Wo erhalte ich weitere Informationen zu Toolinstallationsprogrammen?

Eine Erläuterung von Toolinstallationsprogrammen und Beispielen finden Sie unter Tool installers.

Wie kann ich einen selbst gehosteten Agent für die Verwendung dieser Aufgabe konfigurieren?

Sie können diese Aufgabe auf einem selbst gehosteten Agent mit Ihren eigenen Ruby-Versionen ausführen. Um diese Aufgabe auf einem selbst gehosteten Agent auszuführen, richten Sie Agent.ToolsDirectory ein, indem Sie die anweisungen für den Toolcachebefolgen. Der zu verwendende Toolname ist Ruby.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung, die folgenden Variablenfestzulegen: rubyLocation, PATH
Agentversion	2.182.1 oder höher
Vorgangskategorie	Werkzeug

Siehe auch

• -Toolinstallationsprogramme