Skip to content

Latest commit

 

History

History
 
 

common

README.md

Microsoft Azure Storage Common Client Library for Ruby

Gem Version

  • Master: Master Build Status Coverage Status
  • Dev: Dev Build Status Coverage Status

This project provides a Ruby package that supports service client libraries.

Supported Ruby Versions

  • Ruby 2.3 to 2.7

Note:

  • x64 Ruby for Windows is known to have some compatibility issues.
  • azure-storage-common depends on gem nokogiri.

Getting Started

Install the rubygem package

You can install the azure storage common rubygem package directly.

gem install azure-storage-common

Create client

You can use this module to create client that can be later shared by service modules, to avoid repeating code of creating storage client.

There are two ways you can create the client:

  1. via code
  2. via environment variables

Via Code

  • Against Microsoft Azure Services in the cloud
  require 'azure/storage/common'

  # Setup a specific instance of an Azure::Storage::Common::Client
  client = Azure::Storage::Common::Client.create(storage_account_name: <your account name>, storage_access_key: <your access key>)

  # Configure a ca_cert.pem file if you are having issues with ssl peer verification
  client.ca_file = './ca_file.pem'
  • Against local Emulator (Windows Only)
  require 'azure/storage/common'
  client = Azure::Storage::Common::Client.create_development

  # Or create by options and provide your own proxy_uri
  client = Azure::Storage::Common::Client.create(use_development_storage: true, development_storage_proxy_uri: <your proxy uri>)

Via Environment Variables

  • Against Microsoft Azure Storage Services in the cloud

    export AZURE_STORAGE_ACCOUNT = <your azure storage account name>
export AZURE_STORAGE_ACCESS_KEY = <your azure storage access key>

  • Against local Emulator (Windows Only)

    export EMULATED = true

  • SSL Certificate File if having issues with ssl peer verification

    SSL_CERT_FILE=<path to *.pem>

Usage

Shared Access Signature generation

require "azure/storage/common"

# Creating an instance of `Azure::Storage::Common::Core::Auth::SharedAccessSignature`
generator = Azure::Storage::Common::Core::Auth::SharedAccessSignature.new(your_account_name, your_access_key)

# The generator now can be used to create service SAS or account SAS.
generator.generate_service_sas_token(my_path_or_table_name, my_sas_options)
generator.generate_account_sas_token(my_account_sas_options)
# For details about the possible options, please reference the document of the class `Azure::Storage::Common::Core::Auth::SharedAccessSignature`

Access Token

Please refer to the below links for obtaining an access token:

require "azure/storage/common"

access_token = <your initial access token>

# Creating an instance of `Azure::Storage::Common::Core::TokenCredential`
token_credential = Azure::Storage::Common::Core::TokenCredential.new access_token
token_signer = Azure::Storage::Common::Core::Auth::TokenSigner.new token_credential
common_token_client = Azure::Storage::Common::Client.create.new(storage_account_name: <your_account_name>, signer: token_signer)

# Refresh internal is 50 minutes
refresh_interval = 50 * 60
# The user-defined thread that renews the access token
cancelled = false
renew_token = Thread.new do
  Thread.stop
  while !cancelled
    sleep(refresh_interval)

    # Renew the access token here

    # Update the access token to the credential
    token_credential.renew_token <new_access_token>
  end
end
sleep 0.1 while renew_token.status != 'sleep'
renew_token.run

# Call client functions as usaual

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.