Nephoria is an attempt to leverage existing test code to make navigating clouds, the systems they run on, and the services they provide easier for the purpose of testing and validating cloud related operations.
Nephoria attempts to provide the following utlities through a set of simple interfaces:
- Linux System Administrative Utilities
- Eucalyptus Cloud Administrative Utilities
- User Interfaces For Common AWS and Eucalyptus Cloud Services
- CLI Driven Testcases, Frameworks, Harness, etc..
If easy_install is not available in your environment use your package manager to install python-setuptools
yum install python-setuptools gcc python-devel git libffi-devel openssl-devel
apt-get install python-setuptools gcc python-dev git libffi-devel openssl-devel
Installing nephoria and its dependencies is as easy as:
easy_install nephoria
For development purposes you can then clone the code from github and then reinstall with your changes
git clone https://github.com/eucalyptus/nephoria.git
cd nephoria
[CHANGE CODE]
python setup.py install
The primary interface for creating tests is the TestController:
"nephoria/testcontroller" This interface provides the following:
- Some ulitiy methods for gaining access/credentials to a specific Eucalyptus Cloud
- sysadmin interface:
- interacting with the Eucalyptus Empyrean interface(cloud services and properties administration)
- interacting with the systems hosting the cloud services (linux, and/or specific backend storage, network, etc).
- admin: The eucalyptus/admin (account/user).
- user: a default test user (this may be removed shortly)
"nephoria/usercontext". Objects of this class represent a cloud user. A collection of account/user credentials and related attributes, and cloud service endpoints. A user context will has cloud interfaces such as user.ec2, user.s3, which contain boto or boto3 based methods wrapped to provide test-check utilities often beyond the cloud api itself.
Example test cases written with this library can be found in the testcases/unstable directory of the source tree
nephoria is designed to allow a user to quickly generate automated tests for testing a Eucalyptus or Amazon cloud. In the case of testing a private cloud, root(like) access to a 'cloud controller' is required to validate artifacts both in the cloud as well as in the underlying system itself. For non-system related tests cloud credentials can be provided.
from nephoria.testcontroller import TestController
clc_ip = '1.2.3.4'
# Create the test controller
tc = TestController(hostname=clc_ip, log_level='DEBUG')
# Test controller has some baked in utilities and
# two primary types of user interfaces; sysadmin and admin...
# sysadmin is for cloud host and cloud system administrative operations.
# sysadmin is systemconnection interface which combines the eucalyptus admin only rest interface
# with a set of connections and utlities to interact with the underlying linux hosts and backends
# which make up a Eucalyptus cloud.
tc.sysadmin.show_hosts()
tc.sysadmin.show_services()
# admin is a UserContext interface representing the 'eucalyptus/admin' account/user.
A UserContext obj is basically a key value store of credentials + cloud service
# endpoint information, combined with cloud service interfaces/connections such as user.ec2,
# user.s3, user.iam, etc. for interacting with the cloud service APIs.
tc.admin.iam.show_all_accounts()
tc.admin.ec2.show_images()
tc.admin.s3.get_bucket()
# Create a UserContext object from either a existing user on the cloud...
user = tc.get_user_by_name('testrunner', 'admin')
user.ec2.show_images()
<<<<<<< HEAD
=======
user = tc.create_user_using_cloudadmin('newaccount', 'admin') user.iam.show_user_summary() instance = user.ec2.run_image()
Creating and Running TestCases
------
The primary test case class is CliTestRunner(). This class intends to provide consistent cli
driven testcases, testcase arguements, and results.
The tests typically require 1 or more of the following:
- CLC IP
- Calyptos Cloud Topology yml
- Cloud user access key and secret key
- Specific Cloud service endpoints
See the README under the testcase_utils as well
as the existing testcases in the testcases\ directory for more info.
Example TestCase run:
python load_hvm_image.py --clc 192.168.0.199 --image-url http://images.qa1/disk.img --test-list test1_check_args ... ... ...
| RESULT: | PASSED | | TEST NAME | test1_check_args | | TIME: | 0 | | TEST ARGS: | test1_check_args() | | OUTPUT: | None |
| RESULT: | NOT_RUN | | TEST NAME | test2_create_emi | | TIME: | 1 | | TEST ARGS: | test2_create_emi() | | OUTPUT: | NOT_RUN (test2_create_emi:) |
| RESULT: | NOT_RUN | | TEST NAME | test3_make_image_public | | TIME: | 0 | | TEST ARGS: | test3_make_image_public() | | OUTPUT: | NOT_RUN (test3_make_image_public:) |
| RESULT: | NOT_RUN | | TEST NAME | test4_tag_image | | TIME: | 0 | | TEST ARGS: | test4_tag_image() | | OUTPUT: | NOT_RUN (test4_tag_image:) |
| RESULT: | PASSED | | TEST NAME | clean_method | | TIME: | 0 | | TEST ARGS: | clean_method() | | OUTPUT: | None |
TOTAL FAILED PASSED NOT_RUN ELAPSED
5 0 2 3 1
>>>>>>> upstream/master