Partager via


UseRubyVersion@0 - Utiliser la tâche Ruby version v0

Utilisez cette tâche pour sélectionner une version de Ruby à exécuter sur un agent. Si vous le souhaitez, la tâche peut ajouter la version Ruby à PATH.

Syntaxe

# 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.
# Use Ruby Version v0
# Retrieves the specified version of Ruby from the tool cache. Optionally add it to PATH.
- task: UseRubyVersion@0
  inputs:
    versionSpec: '>= 2.4' # string. Required. Version spec. Default: >= 2.4.
    #addToPath: true # boolean. Add to PATH. Default: true.

Entrées

versionSpec - Spécification de version
string. Obligatoire. Valeur par défaut : >= 2.4.

Spécifie la plage de versions ou une version d’une version Ruby à utiliser.


addToPath - Ajouter à PATH
boolean. Valeur par défaut : true.

facultatif. Ajoute la version de Ruby récupérée à la variable d’environnement PATH pour la rendre disponible dans les tâches ou scripts suivants sans utiliser la variable de sortie.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser dans les étapes, les travaux et les étapes en aval.

rubyLocation
Dossier résolu de la distribution Ruby.

Notes

Utilisez cette tâche pour sélectionner une version de Ruby à exécuter sur un agent et l’ajouter éventuellement à PATH.

Prérequis

  • Un agent hébergé par Microsoft avec des versions côte à côte de Ruby installées, ou un agent auto-hébergé avec Agent.ToolsDirectory configuré (voir FAQ).

Cette tâche échoue si aucune version de Ruby n’est trouvée dans Agent.ToolsDirectory. Consultez les autres versions de Ruby disponibles sur les agents hébergés par Microsoft.

Où puis-je en savoir plus sur les programmes d’installation d’outils ?

Pour obtenir une explication des programmes d’installation d’outils et des exemples, consultez Programmes d’installation d’outils.

Comment configurer un agent auto-hébergé pour utiliser cette tâche ?

Vous pouvez exécuter cette tâche sur un agent auto-hébergé avec vos propres versions Ruby. Pour exécuter cette tâche sur un agent auto-hébergé, configurez Agent.ToolsDirectory en suivant les instructions du cache d’outils. Le nom de l’outil à utiliser est Ruby.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Cette tâche s’exécute à l’aide des restrictions de commande suivantes : restricted
Variables settables Cette tâche est autorisée à définir les variables suivantes : rubyLocation, PATH
Version de l’agent 2.182.1 ou version ultérieure
Catégorie de la tâche Outil
Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 2.115.0 ou version ultérieure
Catégorie de la tâche Outil

Voir aussi