Todos os produtos
Search

Este produto

    Object Storage Service:Instalar o SDK para Ruby

    Central de documentação

    Object Storage Service:Instalar o SDK para Ruby

    Última atualização: Jun 23, 2026

    O OSS SDK for Ruby permite gerenciar recursos do Object Storage Service (OSS) de forma programática. Por exemplo, você pode gerenciar buckets, fazer upload de objetos, baixar objetos e gerenciar permissões de acesso a objetos. Este tópico descreve como usar o OSS SDK for Ruby.

    Procedimento

    Linux

    O exemplo a seguir utiliza o Ubuntu 22.04.

    1. Instale o Ruby usando apt-get.

      apt-get install -y ruby

    2. Especifique a imagem RubyGems da Alibaba Cloud como nova source RubyGems e exclua a source RubyGems padrão.

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

    3. Instale as dependências.

      sudo apt-get install ruby ruby-dev zlib1g-dev
      null

      • Alguns arquivos de dependência são extensões nativas de gem. Portanto, instale o Ruby Devkit para compilar esses arquivos.

      • A dependência nokogiri gem, utilizada pelo OSS SDK for Ruby para processar arquivos XML, exige a biblioteca zlib.

    4. Instale o OSS SDK for Ruby.

      Método 1: Execute o comando gem para instalar o OSS SDK for Ruby

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

      Método 2: Use o bundler para instalar o OSS SDK for Ruby

      1. No Gemfile da sua aplicação, adicione gem 'aliyun-sdk', '~> 0.6.0'.

      2. Selecione uma source para instalar uma imagem da comunidade.

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

        https://gems.ruby-china.com é um espelho de https://rubygems.org mantido pela Ruby China, com sincronização e atualização automáticas. Caso não consiga acessar rubygems.org, use esse espelho para instalar o OSS SDK for Ruby.

    Windows

    1. Acesse o site RubyInstaller e baixe o pacote de instalação Ruby+Devkit. Após o download, clique duas vezes no pacote e instale-o usando o assistente de instalação.

    2. Execute o comando gem install aliyun-sdk.

      Após a conclusão da instalação, execute irb para iniciar a linha de comando interativa do Ruby. Na linha de comando interativa, execute require 'aliyun/oss'. Se `true` for retornado, o OSS SDK for Ruby foi instalado com sucesso.

    macOS

    1. Execute xcode-select --install no terminal para instalar o Xcode Command Line Tools. Se a instalação falhar, baixe-os e instale-os manualmente.

      null

      Use seu Apple ID para entrar no Apple Developer e baixar o Xcode Command Line Tools. Selecione a versão do macOS correspondente. Após o download, clique duas vezes no arquivo dmg e, na janela exibida, clique duas vezes no programa de instalação. Durante esse processo, será necessário inserir sua senha Apple.

    2. Execute o seguinte comando no Terminal para instalar o brew:

       ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

    3. Execute o seguinte comando no Terminal para instalar o Ruby:

       brew install ruby
 exec $SHELL -l

    4. Execute o seguinte comando no Terminal para instalar o OSS SDK for Ruby:

       gem install aliyun-sdk

    5. Execute o seguinte comando no Terminal para verificar se o OSS SDK for Ruby foi instalado. Se `true` for exibido, a instalação foi concluída com sucesso.

       irb
 > require 'aliyun/oss'
 => true

    Referências