Utilisation du SDK pour Ruby sur une instance Vagrant

Cette rubrique décrit comment une recette exécutée sur une instance Vagrant peut utiliser le AWS SDK pour Rubypour télécharger un fichier depuis Amazon S3. Avant de commencer, vous devez disposer d'un ensemble d' AWS informations d'identification (une clé d'accès et une clé d'accès secrète) qui permettent à la recette d'accéder à Amazon S3.

Si vous n'avez pas encore d'utilisateur approprié, vous pouvez en créer un comme suit. Pour plus d'informations, consultez Qu'est-ce qu'IAM ?

Vous devez ensuite fournir un fichier à télécharger. Cet exemple suppose que vous placiez un fichier nommé myfile.txt dans un compartiment S3 nouvellement créé nommé cookbook_bucket.

Configurez le livre de recettes comme suit.

Vous pouvez saisir vos informations d'identification de plusieurs façons pour une recette exécutée sur une instance. Le plus important est de limiter les risques d'exposition accidentelle des clés et de compromission de la sécurité de votre compte. C'est pourquoi il n'est pas recommandé d'utiliser des valeurs de clé explicites dans votre code. Dans le cas présent, nous mettons les valeurs de clé dans l'objet de nœud, ce qui permet à la recette de les référencer en utilisant la syntaxe du nœud au lieu d'exposer les valeurs littérales. Vous devez disposer de privilèges racine pour accéder à l'objet de nœud, ce qui limite les risques d'exposition des clés. Pour plus d'informations, consultez Bonnes pratiques en matière de gestion des clés d'accès AWS.

La recette suivante télécharge myfile.text à partir du compartiment cookbook_bucket.

gem_package "aws-sdk ~> 3" do
  action :install
end

ruby_block "download-object" do
  block do
    require 'aws-sdk'

    s3 = Aws::S3::Client.new(
          :access_key_id => "#{node['cookbooks_101']['access_key']}",
          :secret_access_key => "#{node['cookbooks_101']['secret_key']}")

    myfile = s3.bucket['cookbook_bucket'].objects['myfile.txt']
    Dir.chdir("/tmp")
    File.open("myfile.txt", "w") do |f|
      f.write(myfile.read)
      f.close
    end
  end
  action :run
end

La première partie de la recette installe le SDK pour Ruby, qui est un package gem. La ressource gem_package installe des gems qui seront utilisées par les recettes ou par d'autres applications.

Le reste de la recette est une ressource ruby_block qui contient le code Ruby destiné à télécharger le fichier. Vous pourriez penser que dans la mesure où une recette est une application Ruby, vous pouvez placer le code dans la recette directement. Toutefois, une exécution de Chef compile tout ce code avant l'exécution de n'importe quelle ressource. Si vous mettez l'exemple de code directement dans la recette, Ruby tente de résoudre l'instruction require 'aws-sdk' avant d'exécuter la ressource gem_package. Le SDK pour Ruby n'étant pas encore installé, la compilation échouera.

Le code d'une ressource ruby_block n'est pas compilé tant que cette ressource n'a pas été exécutée. Dans cet exemple, la ruby_block ressource est exécutée une fois qu'elle a fini d'installer le SDK pour Ruby, de sorte que le code s'exécute correctement. gem_package

Le code du ruby_block fonctionne comme suit.

Une fois que vous avez terminé, exécutez kitchen destroy pour résilier l'instance.