기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS SDK for Ruby 설치
<a name="setup-install"></a>

이 섹션에는 AWS SDK for Ruby의 사전 조건 및 설치 지침이 포함되어 있습니다.

## 사전 조건
<a name="aws-ruby-sdk-prerequisites"></a>

 AWS SDK for Ruby를 사용하기 전에 먼저를 인증해야 합니다 AWS. 인증 설정에 대한 자세한 내용은 [AWS SDK for Ruby를 AWS 사용하여 로 인증](credentials.md)를 참조하세요.

## SDK 설치
<a name="installing-the-sdk"></a>

Ruby Gem과 마찬가지로 AWS SDK for Ruby를 설치할 수 있습니다. gem은 [RubyGems](https://rubygems.org/gems/aws-sdk/)에서 확인할 수 있습니다. AWS SDK for Ruby는 모듈식으로 설계되었으며 로 구분됩니다 AWS 서비스. 전체 `aws-sdk` gem을 설치하는 데는 많은 시간이 소요되며 한 시간 이상 걸릴 수 있습니다.

사용하는에 대해서만 젬을 설치하는 AWS 서비스 것이 좋습니다. 이러한 이름은와 같`aws-sdk-service_abbreviation`으며 전체 목록은 AWS SDK for Ruby README 파일의 [지원되는 서비스](https://github.com/aws/aws-sdk-ruby/#supported-services) 테이블에서 확인할 수 있습니다. 예를 들어 Amazon S3 서비스와 인터페이스하기 위한 gem은 [https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3)에서 직접 사용할 수 있습니다.

### Ruby 버전 관리자
<a name="installing-rvm"></a>

시스템 Ruby를 사용하는 대신 다음과 같은 Ruby 버전 관리자를 사용하는 것이 좋습니다.
+ [RVM](http://rvm.io/)
+ [chruby](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

예를 들어 Amazon Linux 2 운영 체제를 사용하는 경우 다음 명령을 사용하여 RVM을 업데이트하고 사용 가능한 Ruby 버전을 나열한 다음 AWS SDK for Ruby를 사용하여 개발하는 데 사용할 버전을 선택할 수 있습니다. 필요한 최소 Ruby 버전은 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>

 [Bundler](http://bundler.io/)를 사용하는 경우 다음 명령은 AWS SDK for Ruby Gem for Amazon S3를 설치합니다.

1. Bundler를 설치하고 `Gemfile`을 생성합니다.

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

1. 생성된를 열고 코드가 사용할 각 AWS 서비스 젬에 대한 `gem` 줄을 `Gemfile` 추가합니다. Amazon S3 예제를 사용하여 따라하려면 파일 하단에 다음과 같은 줄을 추가합니다.

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

1. Gemfile을 저장합니다.

1. `Gemfile`에 지정된 종속성을 설치합니다.

   ```
   $ bundle install
   ```