Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Installation du AWS SDK pour Ruby
<a name="setup-install"></a>

Cette section inclut les prérequis et les instructions d'installation pour le AWS SDK for Ruby.

## Conditions préalables
<a name="aws-ruby-sdk-prerequisites"></a>

Avant d'utiliser le AWS SDK pour Ruby, vous devez vous authentifier auprès AWS de. Pour plus d'informations sur la configuration de l'authentification, consultez[Authentification à AWS l'aide du AWS SDK for Ruby](credentials.md).

## Installation du kit SDK
<a name="installing-the-sdk"></a>

Vous pouvez installer le AWS SDK pour Ruby comme vous le feriez pour n'importe quelle gemme Ruby. Les pierres précieuses sont disponibles sur [RubyGems](https://rubygems.org/gems/aws-sdk/). Le AWS SDK pour Ruby est conçu pour être modulaire et est séparé par Service AWS. L'installation de la `aws-sdk` gemme entière est volumineuse et peut prendre plus d'une heure. 

Nous vous recommandons d'installer uniquement les gemmes pour Services AWS votre usage personnel. Ils portent le même nom `aws-sdk-service_abbreviation` et la liste complète se trouve dans le tableau des [services pris en charge](https://github.com/aws/aws-sdk-ruby/#supported-services) du fichier README du AWS SDK for Ruby. Par exemple, la gemme permettant de s'interfacer avec le service Amazon S3 est directement disponible sur [https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3).

### Gestionnaire de versions Ruby
<a name="installing-rvm"></a>

Au lieu d'utiliser le système Ruby, nous vous recommandons d'utiliser un gestionnaire de version Ruby tel que le suivant : 
+ [RVM](http://rvm.io/)
+ [chruby](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

Par exemple, si vous utilisez un système d'exploitation Amazon Linux 2, les commandes suivantes peuvent être utilisées pour mettre à jour RVM, répertorier les versions Ruby disponibles, puis choisir la version que vous souhaitez utiliser pour le développement avec le AWS SDK for Ruby. La version minimale requise de Ruby est 2.5.

```
$ rvm get head
$ rvm list known
$ rvm install ruby-3.1.3
$ rvm --default use 3.1.3
```

### Bundler
<a name="bundler"></a>

 Si vous utilisez [Bundler](http://bundler.io/), les commandes suivantes installent le AWS SDK for Ruby gem pour Amazon S3 :

1. Installez Bundler et créez : `Gemfile`

   ```
   $ gem install bundler
   $ bundle init
   ```

1. Ouvrez le fichier créé `Gemfile` et ajoutez une `gem` ligne pour chaque gemme de AWS service que votre code utilisera. Pour suivre l'exemple Amazon S3, ajoutez la ligne suivante au bas du fichier :

   ```
   gem "aws-sdk-s3"
   ```

1. Enregistrez le Gemfile.

1. Installez les dépendances spécifiées dans votre `Gemfile` :

   ```
   $ bundle install
   ```