前提条件
アクティブなAlibaba Cloud OSSアカウントが必要です。アクセスキー ID とアクセスキーシークレットを作成する必要があります。
OSSサービスに関する詳細情報、またはOSSサービスをアクティブにする場合は、OSS プロダクトページ で情報を確認できます。
アクセスキー ID とアクセスキーシークレットを作成してない場合、Access Key 管理 で作成できます。
インストール
gem
を使用して SDK を直接インストールします。
gem install aliyun-sdk
サイト https:// rubygems.org
にアクセスできない場合は、Taobao が提供するソースを使用することができます。
gem install aliyun-sdk --clear-sources --source https://ruby.taobao.org
Bundler を使用して SDK をインストールすることもできます。まず、Gemfile
に以下の内容を追加します。
gem 'aliyun-sdk', '~> 0.3.0'
次は、下記コマンドを実行します。
# (Optional). Use the image source provided by Taobao
bundle config mirror.https://rubygems.org https://ruby.taobao.org
bundle install
注意:
https://ruby.taobao.org
は rubygems.org のイメージで、自動的に同期します。rubygems.org にアクセスできない場合は、https://ruby.taobao.org
にアクセスできます。
依存関係
- Ruby 1.9.3 以降
- Ruby をサポートする Windows、Linux、または OS X システム
注意:
- SDK が依存するいくつかの gem はローカル拡張です。ローカル拡張 gem をコンパイルするには ruby-dev をインストールする必要があります。
- XML を処理するための SDK 依存の gem(nokogiri)を実行する環境には、zlib ライブラリが必要です。
Linux
Linux の Ubuntu を使って上記の依存関係をインストールするには、次の方法があります。
sudo apt-get install ruby ruby-dev zlib1g-dev
Linux シリーズ(それぞれパッケージ管理ツールを使用)のインストール方法は似ています。
Windows
RubyInstaller にアクセスして、RubyInstaller をダウンロードします。インストーラをダブルクリックして、ツールをインストールします。インストール処理中に “Ruby実行ファイルを PATH に追加” を選択します。
注意: RubyInstaller 2.1 以前のバージョンをダウンロードしてください。Issue のため、RubyInstaller 2.2 をインストールすることはできません。
- RubyInstaller にアクセスして、開発キットをダウンロードします。正しいバージョンを選択し、ダウンロードしたキットは圧縮パッケージです。
RubyDev
という名前のフォルダを C:¥ ルートディレクトリに作成し、パッケージをそのフォルダに解凍します。 ショートカットキー Windows + R を押し、
cmd
を入力し、 Enter を押して CLI を開きます。以下のコマンドを実行します。cd C:\RubyDev
ruby dk.rb init
ruby dk.rb install
“install” 中に “config.yml configuration error” が表示された場合は、テキストエディタを使用して
C:\RubyDev\config.yml
ファイルを開き、次のようにファイルの内容を変更します:---
- C:/Ruby21
config.yml ファイルを保存し、
ruby dk.rb install
を続けます。 “Ruby21” はRubyのインストールディレクトリで、実際の名前で指定する必要があります。操作が完了したら、CLI を閉じます。ショートカットキー Windows + R を押し、
cmd
を入力し、 Enter を押して CLI を開きます。以下のコマンドを実行します。gem install aliyun-sdk
インストールが完了したら、irb を入力して Rudy の対話型 CLI を開き、
require 'aliyun/oss'
と入力します。”true” が表示されている場合、SDK は正常にインストールされます。
OS X
OS X にはデフォルトで Ruby がインストールされています。使用と管理を容易にするために、開発バージョンをインストールすることをお勧めします。
ターミナルで
xcode-select --install
を実行して、”Xcode command line tools” をインストールします。インストールが失敗した場合、ツールを手動でダウンロードしてインストールできます(ダウンロード手順を参照)。Apple ID を使用して Appleの開発者センター から “Xcode command line tools” をダウンロードします。選択したバージョンがシステムのバージョンと一致していることを確認する必要があります。ダウンロード後、dmg ファイルをダブルクリックしてファイルをロードします。ポップアップウィンドウでインストールプログラムをダブルクリックして、ツールをインストールします。インストール処理中にシステムパスワードを入力する必要があります。
ターミナルで次のコマンドを実行して Brew をインストールします。
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
ターミナルで次のコマンドを実行して Ruby をインストールします。
brew install ruby
exec $SHELL -l
ターミナルで次のコマンドを実行して SDK をインストールします。
gem install aliyun-sdk
ターミナルで次のコマンドを実行して、SDK が正常にインストールされているかどうかを確認します。
irb
> require 'aliyun/oss'
=> true