Roles Rôle « Ruby vhosts »

22 octobre 2025 à 16:34

Ce rôle est chargé de mettre en place la configuration Virtual Host pour une application Ruby avec Passenger

Tags internes

  • ruby-vhosts : Mise en place des éléments Ruby du Virtual Host ;
  • packages : Installation et configuration des packages ;
  • vhost-configuration : Création des fichiers de configuration ;
  • ruby-vhost-configuration : Création des fichiers de configuration (limité Passenger) ;
  • vhost-state : Application de l’activation des fonctionalités ;
  • ruby-vhost-state : Application de l’activation des fonctionalités (limité Passenger) ;
  • ruby-vhost-server : Application de la configuration globale du service Web ;

Traitements spécifiques du jeu de tâches

Le rôle est inclus par dépendance par les autres rôles. Principalement par le rôle CustomVhosts.

Variables à fournir

Variable Type Requis Défaut Description
vhosts Liste d’objets rubyvhost Non Liste vide Configuration Virtual Host Ruby (Passenger)
vhosts_base_dir Chemin Non /var/www/vhosts Dossier sur la cible, racine des Virtual Host

Type vhost_base

Extrait du role BaseVhosts.

Propriété Type Requis Défaut Description
vhost_name Segment de chemin/FQDN Non default Nom du Virtual Host, utilisé comme ServerName, nom de configuration et nom du dossier
vhost_root_name Segment de chemin/FQDN Non vhost_name Nom du dossier racine du Virtual Host au lieu de vhost_name
vhost_root_override Chemin Non Chaîne vide Surcharge du chemin du vhost, il n’est plus sous vhosts_base_dir/vhost_root_name mais sous ce dossier
vhost_user Identifiant Non www-data Utilisateur ayant le droit d’accès aux fichiers du Virtual Host, avec les permissions d’écriture où nécessaire
vhost_group Identifiant Non www-data Groupe ayant le droit d’accès aux fichiers du Virtual Host

Type rubyvhost_base

Propriété Type Requis Défaut Description
passenger_environment Texte Non production Nom de l’environnement de l’application
passenger_disable_http Booléen Non Faux Désactiver Passenger pour le protocole HTTP
passenger_disable_https Booléen Non Faux Désactiver Passenger pour le protocole HTTPS

Type rubyvhost

Hérite de vhost_base et rubyvhost_base.

Variables fixées

Variable Type Description
passenger_state Liste d’objets Défini les inclusions de configuration à mettre en place de manière conditionnelle
passenger_state_resolve Listes nommées Défini les éléments de résolution des conditions des configurations à mettre en place