すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:SDK for Ruby のインストール

最終更新日:Nov 30, 2025

SDK for Ruby を使用すると、Object Storage Service (OSS) のリソースをプログラムで管理できます。たとえば、バケットの管理、オブジェクトのアップロード、オブジェクトのダウンロード、オブジェクトのアクセス権限の管理などが可能です。このトピックでは、SDK for Ruby の使用方法について説明します。

操作手順

Linux

次の例では、Ubuntu 22.04 を使用します。

  1. apt-get を使用して Ruby をインストールします。

    apt-get install -y ruby
  2. Alibaba Cloud RubyGems イメージを新しい RubyGems ソースとして指定し、デフォルトの RubyGems ソースを削除します。

    gem sources -a http://mirrors.aliyun.com/rubygems/ -r https://rubygems.org/
  3. 依存関係をインストールします。

    sudo apt-get install ruby ruby-dev zlib1g-dev
    重要
    • 一部の依存ファイルは gem ネイティブ拡張機能です。したがって、ファイルをコンパイルするには Ruby Devkit をインストールする必要があります。

    • SDK for Ruby が XML ファイルの処理に使用する nokogiri gem の依存関係には、zlib ライブラリを含める必要があります。

  4. SDK for Ruby をインストールします。

    方法 1:gem コマンドを実行して SDK for Ruby をインストールする

    gem install aliyun-sdk --clear-sources --source https://gems.ruby-china.com

    方法 2:bundler を使用して SDK for Ruby をインストールする

    1. アプリケーションの Gemfilegem 'aliyun-sdk', '~> 0.6.0' を追加します。

    2. ソースを選択してコミュニティイメージをインストールします。

      bundle config mirror.https://rubygems.org https://gems.ruby-china.com 
      bundle install                        
      説明

      https://gems.ruby-china.com は https://rubygems.org のミラーであり、Ruby China によってメンテナンスされています。ミラーは自動的に同期および更新されます。rubygems.org にアクセスできない場合は、このミラーを使用して SDK for Ruby をインストールできます。

Windows

  1. RubyInstaller サイトにアクセスして、Ruby+Devkit インストールパッケージをダウンロードします。インストールパッケージがダウンロードされたら、パッケージをダブルクリックし、インストールウィザードに従ってインストールします。

  2. コマンド gem install aliyun-sdk を実行します。

    インストールが完了したら、irb を実行して Ruby の対話型コマンドラインを起動します。対話型コマンドラインで require 'aliyun/oss' を実行します。`true` が返された場合、SDK for Ruby は正常にインストールされています。

macOS

  1. ターミナルで xcode-select --install を実行して Xcode Command Line Tools をインストールします。インストールに失敗した場合は、手動でダウンロードしてインストールしてください。

    説明

    Apple ID を使用して Apple Developer にログインし、Xcode Command Line Tools をダウンロードできます。ご利用の macOS のバージョンを選択してください。ツールがダウンロードされたら、dmg ファイルをダブルクリックします。表示されたウィンドウで、インストールプログラムをダブルクリックします。このプロセス中に、Apple のパスワードを入力する必要があります。

  2. ターミナルで次のコマンドを実行して brew をインストールします:

     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"                          
  3. ターミナルで次のコマンドを実行して Ruby をインストールします:

     brew install ruby
     exec $SHELL -l                                
  4. ターミナルで次のコマンドを実行して SDK for Ruby をインストールします:

     gem install aliyun-sdk                                
  5. ターミナルで次のコマンドを実行して、SDK for Ruby がインストールされているかどうかを確認します。true が表示された場合、SDK for Ruby はインストールされています。

     irb
     > require 'aliyun/oss'
     => true                                

関連ドキュメント