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.

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 au chemin d’accès
boolean. Valeur par défaut : true.

Optionnel. 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 tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. 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 en aval, les travaux et les étapes.

rubyLocation
Dossier résolu de la distribution Ruby.

Remarques

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

Conditions préalables

  • 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 d’autres versions de Ruby disponibles sur 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 et des exemples d’outils, consultez programmes d’installation de l’outil.

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 de Ruby. Pour exécuter cette tâche sur un agent auto-hébergé, configurez Agent.ToolsDirectory en suivant les instructions du cache de l’outil . Le nom de l’outil à utiliser est Ruby.

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande Cette tâche s’exécute à l’aide des restrictions de commande suivantes: restreint
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 tâche Outil
Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.115.0 ou version ultérieure
Catégorie de tâche Outil

Voir aussi