chef-shell est un outil de débogage de recettes qui permet d'utiliser des points d'arrêt dans les recettes. chef-shell s'exécute en tant que session interactive Ruby (IRb). chef-shell prend en charge la syntaxe des fichiers de recettes et d'attributs, ainsi que les fonctionnalités de débogage interactif.

L'exécutable chef-shell est exécuté en tant qu'outil de ligne de commande

chef-shell est un outil exécuté à l'aide d'une session Interactive Ruby (IRb). chef-shell prend actuellement en charge la syntaxe des fichiers de recettes et d'attributs, ainsi que les fonctionnalités de débogage interactif. chef-shell a trois modes d'exécution:

Cette commande a la syntaxe suivante:

chef-shell OPTION VALEUR OPTION VALEUR ...

Cette commande a les options suivantes:

chef-shell détermine le fichier de configuration à charger en fonction des éléments suivants:

• Si un fichier de configuration est spécifié à l'aide de l'option -c , chef-shell utilisera le fichier de configuration spécifié.
• Lorsque chef-shell est démarré avec une configuration nommée en tant qu'argument, chef-shell recherchera un fichier chef-shell.rb dans ce répertoire sous ~/.chef . Par exemple, si chef-shell est démarré en utilisant production comme configuration nommée, il chargera un fichier de configuration à partir de ~/.chef/production/chef_shell.rb
• Si une configuration nommée n'est pas fournie, chef-shell tentera de charger le fichier chef-shell.rb à partir du répertoire .chef . Par exemple: ~/.chef/chef_shell.rb
• Si aucun fichier chef-shell.rb n’est trouvé, chef-shell tentera de charger le fichier client.rb.
• Si aucun fichier chef-shell.rb n'est trouvé, chef-shell tentera de charger le fichier solo.rb.

Le fichier chef-shell.rb peut être utilisé pour configurer chef-shell de la même manière que le fichier client.rb est utilisé pour configurer le chef-client. Par exemple, pour configurer chef-shell afin qu'il s'authentifie auprès du serveur Chef, copier les paramètres node_name , client_key et chef_server_urlf du fichier config.rb:

node_name                'your-knife-clientname'
client_key               File.expand_path('~/.chef/my-client.pem')
chef_server_url          'https://api.opscode.com/organizations/myorg'

puis les ajouter au fichier chef-shell.rb. D'autres possibilités de configuration incluent la désactivation des plug-ins Ohai (ce qui accélérera le processus de démarrage chef-shell) ou l'inclusion de code Ruby arbitraire dans le fichier chef-shell.rb.

Par défaut, chef-shell se charge en mode autonome et ne se connecte pas au serveur. On peut écrire un chef_shell.rb , utiliser un fichier knife.rb ou, sur un noeud réel, utiliser client.rb. L'utilisation de client.rb sur un nœud réel ne charge pas tout et ne se connecte pas au serveur Chef. Pour ce faire, on doit exécuter Chef Shell en tant que Chef Client (voir ci-dessous).

/opt/chef/bin/chef-shell

/opt/chef/bin/chef-shell -c /etc/chef/client.rb

/opt/chef/bin/chef-shell -c ~/.chef/knife.rb

/opt/chef/bin/chef-shell -c ~/.chef/chef_shell.rb

Chef-shell peut être exécuté en tant que chef-client pour vérifier une fonctionnalité disponible uniquement lorsque le chef-client se connecte au serveur, telle qu'une fonctionnalité de recherche ou l'accès à des données stockées dans des sacs de données.

/opt/chef/bin/chef-shell -z

Pour déboguer une recette, passer d’abord en mode recipe_mode .

mode recipe_mode

Ensuite, on peut appeler une recette

include_recipe "mise en route"

Pour déboguer des attributs, passer d’abord en mode attributs_mode .

mode_attribut

Ensuite, copier le code d'attributs à tester dans le shell .

run_state['detected_environment'] =
if /dev|qa|stg|prd/ =~ node['chef_environment']
  /dev|qa|stg|prd/.match(node['chef_environment']).to_s.downcase
else
  # Consider _default as 'Dev'
 'dev'
end