This project contains code to automate some processes in Ravello. While this has been written to address some specific use cases required at AppDynamics, elements of this could be useful elsewhere.
These scripts are dependent on the Ravello Python API. This can be installed locally using PIP (steps below have been tested on OS X):
-
If you do not have PIP installed, get that:
sudo easy_install pip -
Then install the Ravello API:
sudo pip install ravello-sdk
Note prior versions of this script performed user creation using Selenium, this has removed in favour of ephemeral access keys
There are two use cases supported
Make sure RAVELLO_USERNAME and PEM_LOCATION are set in the setEnv.sh. PEM_LOCATION should point to the Bleuprint access key.
To use the script to create a Java 101 Canidate lab and associated user, you can run the script as follows:
createLab.sh -p YourRavelloPassword -f Joe -l Bloggs -e [email protected] -v ThisIsTheVMPassword1
Where the switches are as follows:
- -p: Ravello password
- -f: Candidate first name
- -l: Candidate last name
- -e: Candidate email
This will create the Ravello application and then the ephemeral access key. Final output looks as follows with the App Name, VM Password and Ephemeral Access URL:
Lab Created
Application Name: Candidate_TB_Java 101 20180123
Ravello VM password: Hello1234
Access URL: https://cloud.ravellosystems.com/#/AzqCZddlkgjwefqdqsPewBjXo2DC81GSMJkykJBhL9zv23gjeab2F
IPs:
[u'129.213.54.115']
Note this will also autoupdate these utilities from GitHub
Make sure RAVELLO_USERNAME and PEM_LOCATION are set in setEnv.sh. PEM_LOCATION should point to the Bleuprint access key.
The script requires a CSV file which list out the lab attendees to create Ravello apps for. This is of the format:
FirstName,LastName,Email,OSPassword
An example is in sampleInput.csv
A execution looks like the following
createHOL.sh -p YourRavelloPassword -b 741258963 -a sampleInput.csv -o ubuntu -t timeout
Where the switches are as follows:
- -p: Ravello password
- -b: HOL Blueprint ID
- -a: user CSV file
- -o: VM OS user
- -t: App timeout in hours
This will create a Ravello app for each user in the CSV, and set the timeout. This then presents an output like:
App publish completed
[{'userEmail': '[email protected]', 'appName': u'test-appsphere-42-lab-SRVVisPlus-bp for: Jeff Bridges', 'vmPassword': 'password1', 'vmIPs': [u'104.198.137.221', u'104.198.67.100'], 'userFirstName': 'Jeff', 'userLastName': 'Bridges', 'appID': 75108706}, {'userEmail': '[email protected]', 'appName': u'test-appsphere-42-lab-SRVVisPlus-bp for: Great Scott', 'vmPassword': 'password2', 'vmIPs': [u'104.198.58.104', u'104.197.87.83'], 'userFirstName': 'Great', 'userLastName': 'Scott', 'appID': 75108707}]
Lab Created
userEmail: [email protected]
Application Name: test-appsphere-42-lab-SRVVisPlus-bp for: Jeff Bridges
Ravello VM password: password1
IPs:
[u'104.198.137.221', u'104.198.67.100']
Lab Created
userEmail: [email protected]
Application Name: test-appsphere-42-lab-SRVVisPlus-bp for: Great Scott
Ravello VM password: password2
IPs:
[u'104.198.58.104', u'104.197.87.83']