Git Product home page Git Product logo

tacoma's Introduction

Tacoma

Simple command-line tool for managing AWS credentials across different projects and tools.

Installation

$ gem install tacoma

Usage

Tacoma needs a special file .tacoma.yml in your home directory. It can create a sample for you with

 tacoma install

The format of the .tacoma.yml file is pretty straighforward

project:
  aws_identity_file: "/path/to/pem/file/my_project.pem"
  aws_secret_access_key: "YOURSECRETACCESSKEY"
  aws_access_key_id: "YOURACCESSKEYID"
  region: "REGION"
  repo: "$HOME/projects/my_project"
another_project:
  aws_identity_file: "/path/to/another_pem.pem"
  aws_secret_access_key: "ANOTHERECRETACCESSKEY"
  aws_access_key_id: "ANOTHERACCESSKEYID"
  region: "REGION"
  repo: "$HOME/projects/another_project"
  s3cfg:
    gpg_passphrase: my_gpg_passphrase

Once setup with a file like this, you can run

 tacoma list

And it will list all the configured entries. Running

 tacoma switch project

Will add the specified identity file into the SSH agent, and will generate configuration files for the supported tools, which at this time are

Running tacoma switch with the --with-exports option will also echo shell export sentences for the most common incarnations of the AWS env vars.

 tacoma version

Will display the current tacoma version and list all available configuration templates (providers).

 tacoma current

Will display the currently active tacoma environment.

If you don't indicate a specific region, tacoma will use the "eu-west-1" region by default.

Bash Completion

There's an user contributed script for bash completion feature. To use it simply get from the /contrib/ path and source it in your bash session (after rbenv gets sourced if it is there)

TODO

  • Check for errors in the tacoma.yml file
  • Add other AWS tool providers (Knife, AWS cli, ...)
  • Honor the different optional environment vars for the different config files (i.e FOG_RC)

THANKS

This tool is shamelessly inspired in Raul Murciano's rack-generator

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.