Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Instalación del AWS SDK para Ruby
<a name="setup-install"></a>

Esta sección incluye los requisitos previos y las instrucciones de instalación de AWS SDK para Ruby.

## Requisitos previos
<a name="aws-ruby-sdk-prerequisites"></a>

Antes de usar el AWS SDK para Ruby, debes autenticarte con AWS. Para obtener información acerca de la configuración de la autenticación, consulte [Autenticación con AWS AWS SDK for Ruby](credentials.md).

## Instalación del SDK
<a name="installing-the-sdk"></a>

Puedes instalar el AWS SDK para Ruby como lo harías con cualquier gema de Ruby. Las gemas están disponibles en [RubyGems](https://rubygems.org/gems/aws-sdk/). El AWS SDK for Ruby está diseñado para ser modular y está separado por Servicio de AWS. La instalación de toda la gema `aws-sdk` es larga y puede llevar más de una hora. 

Te recomendamos que instales únicamente las gemas Servicios de AWS que utilices. Se denominan como `aws-sdk-service_abbreviation` y la lista completa se encuentra en la tabla de [servicios compatibles](https://github.com/aws/aws-sdk-ruby/#supported-services) del archivo README de AWS SDK for Ruby. Por ejemplo, la gema para interactuar con el servicio Amazon S3 está disponible directamente en [https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3).

### Administrador de versiones de Ruby
<a name="installing-rvm"></a>

En lugar de usar el Ruby del sistema, recomendamos usar un administrador de versiones de Ruby como el siguiente: 
+ [RVM](http://rvm.io/)
+ [chruby](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

Por ejemplo, si utilizas un sistema operativo Amazon Linux 2, puedes usar los siguientes comandos para actualizar RVM, enumerar las versiones de Ruby disponibles y, a continuación, elegir la versión que quieres usar para el desarrollo con el AWS SDK para Ruby. La versión mínima de Ruby requerida es 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 utilizas [Bundler](http://bundler.io/), los siguientes comandos instalan la gema AWS SDK for Ruby para Amazon S3:

1. Instale Bundler y cree el archivo `Gemfile`:

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

1. Abre la gema creada `Gemfile` y añade una `gem` línea para cada gema AWS de servicio que vaya a utilizar tu código. Para seguir con el ejemplo de Amazon S3, agregue la siguiente línea de texto al final del archivo:

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

1. Guarde el archivo Gemfile.

1. Instale las dependencias especificadas en su archivo `Gemfile`:

   ```
   $ bundle install
   ```