Jellyfish Fog
Adds infrastructure, database, and storage product types to Project Jellyfish API, and enables their provisioning on cloud service providers (AWS, Azure, DigitalOcean and VMWare) via the Fog gem.
Installation
Setup Gemfile
Include jellyfish-fog
from GitHub in parent Gemfile:
gem 'jellyfish-fog', git: 'git://github.com/projectjellyfish/jellyfish-fog.git
Or include it locally:
gem 'jellyfish-fog', path: '../jellyfish-fog'
And run bundle install
.
Setup Env Vars
Add the following keys which can be set using the .env
file or explicitly by the hosted environment (e.g. Heroku):
# GENERAL
JELLYFISH_MOCK_FOG = true
# AWS SPECIFIC
JELLYFISH_AWS_ACCESS_KEY_ID = key
JELLYFISH_AWS_SECRET_ACCESS_KEY = secret
# AZURE SPECIFIC
JELLYFISH_AZURE_SUB_ID = azure_subscription_id
JELLYFISH_AZURE_PEM_PATH = azure_certificate.pem
JELLYFISH_AZURE_API_URL = https://management.core.windows.net
# VMWARE SPECIFIC
JELLYFISH_VMWARE_USERNAME = vmware_user
JELLYFISH_VMWARE_PASSWORD = vmware_password
JELLYFISH_VMWARE_SERVER = vmware_server
JELLYFISH_VMWARE_EXPECTED_PUBKEY_HASH = vmware_pubkey_hash
Key Descriptions:
-
If
JELLYFISH_MOCK_FOG
is not set tofalse
, Fog will simulate provisioning and retirement rather than actually interacting with the cloud service providers. All keys are required in mock mode, but they can specify dummy data. -
JELLYFISH_AWS_ACCESS_KEY_ID
andJELLYFISH_AWS_SECRET_ACCESS_KEY_ID
are the public and private keys used by Fog to authenticate to AWS when provisioning and retiring assets. -
JELLYFISH_AZURE_SUB_ID
is the Azure subscription id used for provisioning -
JELLYFISH_AZURE_PEM_PATH
is location of the client certificate pem file usd to authenticate with Azure. See here for how to generate. -
JELLYFISH_AZURE_API_URL
is the API endpoint used for Azure provisioning -
JELLYFISH_VMWARE_USERNAME
is the vSphere user -
JELLYFISH_VMWARE_PASSWORD
is the vSphere password -
JELLYFISH_VMWARE_SERVER
is the vSphere server -
JELLYFISH_VMWARE_EXPECTED_PUBKEY_HASH
is the public key hash of the vSphere environment. Can be obtained by passing a dummy value and checking error logs. See here for details.
License
See LICENSE
Copyright 2015 Booz Allen Hamilton