All Products
Search
Document Center

Object Storage Service:Instal SDK untuk Ruby

Last Updated:Nov 30, 2025

OSS SDK for Ruby memungkinkan Anda mengelola sumber daya di Object Storage Service (OSS) secara terprogram, seperti mengelola bucket, mengunggah objek, mengunduh objek, dan mengatur izin akses pada objek. Topik ini menjelaskan cara menggunakan OSS SDK for Ruby.

Prosedur

Linux

Contoh berikut menggunakan Ubuntu 22.04.

  1. Instal Ruby menggunakan apt-get.

    apt-get install -y ruby
  2. Tentukan gambar RubyGems Alibaba Cloud sebagai sumber RubyGems baru dan hapus sumber RubyGems default.

    gem sources -a http://mirrors.aliyun.com/rubygems/ -r https://rubygems.org/
  3. Instal dependensi.

    sudo apt-get install ruby ruby-dev zlib1g-dev
    Penting
    • Beberapa file dependensi adalah ekstensi native gem. Oleh karena itu, Anda harus menginstal Ruby Devkit untuk mengompilasi file tersebut.

    • Dependensi gem nokogiri yang digunakan oleh OSS SDK untuk Ruby dalam memproses file XML harus mencakup pustaka zlib.

  4. Instal OSS SDK untuk Ruby.

    Metode 1: Jalankan perintah gem untuk menginstal OSS SDK untuk Ruby

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

    Metode 2: Gunakan bundler untuk menginstal OSS SDK untuk Ruby

    1. Dalam Gemfile aplikasi Anda, tambahkan gem 'aliyun-sdk', '~> 0.6.0'.

    2. Pilih sumber untuk menginstal gambar komunitas.

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

      https://gems.ruby-china.com adalah cermin dari https://rubygems.org dan dikelola oleh Ruby China. Cermin ini disinkronkan dan diperbarui secara otomatis. Jika Anda tidak dapat mengakses rubygems.org, Anda dapat menggunakan cermin untuk menginstal OSS SDK untuk Ruby.

Windows

  1. Buka situs RubyInstaller untuk mengunduh paket instalasi Ruby+Devkit. Setelah diunduh, klik ganda paket tersebut dan ikuti wizard instalasi untuk menyelesaikan proses instalasi.

  2. Jalankan perintah gem install aliyun-sdk.

    Setelah instalasi selesai, jalankan irb untuk memulai command line interaktif Ruby. Di command line tersebut, jalankan require 'aliyun/oss'. Jika responsnya `true`, berarti OSS SDK for Ruby telah berhasil diinstal.

macOS

  1. Jalankan xcode-select --install di terminal untuk menginstal Xcode Command Line Tools. Jika instalasi gagal, unduh dan instal secara manual.

    Catatan

    Anda dapat menggunakan Apple ID Anda untuk masuk ke Apple Developer dan mengunduh Xcode Command Line Tools. Pilih versi macOS Anda. Setelah alat diunduh, klik dua kali file dmg. Di jendela yang muncul, klik dua kali program instalasi. Selama proses ini, Anda harus memasukkan kata sandi Apple Anda.

  2. Jalankan perintah berikut di Terminal untuk menginstal brew:

     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"                          
  3. Jalankan perintah berikut di Terminal untuk menginstal Ruby:

     brew install ruby
     exec $SHELL -l                                
  4. Jalankan perintah berikut di Terminal untuk menginstal OSS SDK untuk Ruby:

     gem install aliyun-sdk                                
  5. Jalankan perintah berikut di Terminal untuk memeriksa apakah OSS SDK untuk Ruby telah diinstal. Jika true ditampilkan, OSS SDK untuk Ruby telah diinstal.

     irb
     > require 'aliyun/oss'
     => true                                

Referensi