Tous les produits
Search
Centre de documentation

Object Storage Service:Install the SDK for Ruby

Dernière mise à jour :Aug 18, 2026

Le SDK OSS pour Ruby vous permet de gérer par programmation les ressources dans Object Storage Service (OSS). Par exemple, vous pouvez gérer des buckets, télécharger et uploader des objets, ainsi que gérer les autorisations d'accès aux objets. Cette rubrique explique comment utiliser le SDK OSS pour Ruby.

Procédure

Linux

L'exemple suivant utilise Ubuntu 22.04.

  1. Installez Ruby à l'aide d'apt-get.

    apt-get install -y ruby
  2. Spécifiez le miroir Alibaba Cloud RubyGems comme nouvelle source RubyGems et supprimez la source RubyGems par défaut.

    gem sources -a http://mirrors.aliyun.com/rubygems/ -r https://rubygems.org/
  3. Installez les dépendances.

    sudo apt-get install ruby ruby-dev zlib1g-dev
    Important
    • Certains fichiers de dépendance sont des extensions natives gem. Vous devez donc installer Ruby Devkit pour compiler les fichiers.

    • La dépendance gem nokogiri, utilisée par le SDK OSS pour Ruby pour traiter les fichiers XML, doit inclure la bibliothèque zlib.

  4. Installez le SDK OSS pour Ruby.

    Méthode 1 : Exécutez la commande gem pour installer le SDK OSS pour Ruby

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

    Méthode 2 : Utilisez bundler pour installer le SDK OSS pour Ruby

    1. Dans le Gemfile de votre application, ajoutez gem 'aliyun-sdk', '~> 0.6.0'.

    2. Sélectionnez une source pour installer un miroir communautaire.

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

      https://gems.ruby-china.com est un miroir de https://rubygems.org maintenu par Ruby China. Le miroir est synchronisé et mis à jour automatiquement. Si vous ne pouvez pas accéder à rubygems.org, utilisez ce miroir pour installer le SDK OSS pour Ruby.

Windows

  1. Accédez au site RubyInstaller pour télécharger le package d'installation Ruby+Devkit. Une fois le package téléchargé, double-cliquez dessus pour lancer l'installation via l'assistant d'installation.

  2. Exécutez la commande gem install aliyun-sdk.

    Une fois l'installation terminée, exécutez irb pour démarrer la ligne de commande interactive Ruby. Dans la ligne de commande interactive, exécutez require 'aliyun/oss'. Si true est renvoyé, le SDK OSS pour Ruby est installé avec succès.

macOS

  1. Exécutez xcode-select --install dans le terminal pour installer les outils de ligne de commande Xcode. En cas d'échec de l'installation, téléchargez et installez-les manuellement.

    Remarque

    Vous pouvez utiliser votre Apple ID pour vous connecter à Apple Developer et télécharger les outils de ligne de commande Xcode. Sélectionnez votre version macOS. Une fois les outils téléchargés, double-cliquez sur le fichier dmg. Dans la fenêtre qui s'affiche, double-cliquez sur le programme d'installation. Vous devrez saisir votre mot de passe Apple durant ce processus.

  2. Exécutez la commande suivante dans Terminal pour installer brew :

     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"                          
  3. Exécutez la commande suivante dans Terminal pour installer Ruby :

     brew install ruby
     exec $SHELL -l                                
  4. Exécutez la commande suivante dans Terminal pour installer le SDK OSS pour Ruby :

     gem install aliyun-sdk                                
  5. Exécutez la commande suivante dans Terminal pour vérifier si le SDK OSS pour Ruby est installé. Si true s'affiche, le SDK OSS pour Ruby est installé.

     irb
     > require 'aliyun/oss'
     => true                                

Références