Gaargh

gaargh is a GCP Alternative Authentication Ruby Gem Helper and it's also the noise I make when working with GCP and ruby.

This gem was created as a work around for the lack of support for account impersonation using Ruby with GCP.

Ruby isn't one of the 4 language that support account impersonation on GCP as documented here.

The is a github feature request https://github.com/googleapis/google-auth-library-ruby/issues/353 but there has been no update since Nov 16, 2021.

This gem uses the work around discussed in https://github.com/googleapis/google-cloud-ruby/issues/17915 as a work around for dealing with account impersonation.

Installation

Add this line to your application's Gemfile:

bundler:

gem 'gaargh'

gem install 'gaargh'

Usage

EXample usage with Google::Cloud::Storage client.

require 'gaargh'
require 'google/cloud/storage'
impersonated_credentials_client = Gaargh.impersonate_service_account(service_account_email: '[email protected]')
storage = Google::Cloud::Storage.new(credentials: impersonated_credentials_client, project_id: 'my-project-id')
puts storage.buckets.map { |b| b.name}
token_info = Gaargh.token_expiration_time(access_token: impersonated_credentials_client.access_token)
pp token_info

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/gaargh.

License

The gem is available as open source under the terms of the MIT License.

Creating a Gem

Create a Gem Skeleton

bundle gem json_ruby_logger \
--mit \
--linter=rubocop \
--test=rspec \
--ci=github \
--no-coc

Build and publish the gem

#!/usr/bin/env bash

set -e

export GEM_HOST_API_KEY="xxyyzz"

# mkdir -p "${HOME}/.gem"
# touch "${HOME}/.gem/credentials"
# chmod 0600 "${HOME}/.gem/credentials"

# echo -e "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > "${HOME}/.gem/credentials"

# gem install gem-release
gem bump patch --skip-ci --push
gem tag --push

# gem yank -v "0.1.4" gaargh

rm *.gem || echo "No gem to remove"
gem build *.gemspec
gem push *.gem