IBM Cloud Functions runtime for python

WARNING: Work in Progress (WIP) not ready for production

The runtime provides python v3 with a set of python packages

The runtime provides the following npm packages for IBM Cloud:

• IBM DB2/DashDB and IBM Informix - Python SDKibm_db@2.0.7
• IBM Cloudant - Python SDK cloudant@2.7.0
• IBM Watson Developer Cloud - Python SDK watson-developer-cloud@1.0.1
• IBM Cloud Object Storage - Python SDK ibm-cos-sdk@2.0.0

How to use as a docker Action

To use as a docker action

bx wsk action update myAction myAction.py --docker ibmfunctions/action-python-v3

This works on any deployment of Apache OpenWhisk or IBM Cloud Functions

Future: IBM Cloud Functions (based on Apache OpenWhisk)

To use as a python kind action

bx wsk action update myAction myAction --kind python:3

Tip: Not available yet in the IBM Cloud

Working with the local git repo

Prerequisite: Export OPENWHISK_HOME to point to your incubator/openwhisk cloned directory.

./gradlew python3:distDocker

This will produce the image whisk/action-python-v3

Build and Push image

docker login
./gradlew python3:distDocker -PdockerImagePrefix=$prefix-user -PdockerRegistry=docker.io

Deploy OpenWhisk using ansible environment that adds the new king python:3 Assuming you have OpenWhisk already deploy localy and OPENWHISK_HOME pointing to root directory of OpenWhisk core repository.

Set ROOTDIR to the root directory of this repository.

Redeploy OpenWhisk

cd $OPENWHISK_HOME/ansible
ANSIBLE_CMD="ansible-playbook -i ${ROOTDIR}/ansible/environments/local"
$ANSIBLE_CMD setup.yml
$ANSIBLE_CMD couchdb.yml
$ANSIBLE_CMD initdb.yml
$ANSIBLE_CMD wipe.yml
$ANSIBLE_CMD openwhisk.yml

To use as docker action push to your own dockerhub account

docker tag whisk/action-python-v3 $user_prefix/action-python-v3
docker push $user_prefix/action-python-v3

Then create the action using your the image from dockerhub

wsk action update myAction myAction.py --docker $user_prefix/action-python-v3

The $user_prefix is usually your dockerhub user id.

Testing

To run all tests: ./gradlew tests:test this include tests depending on credentials

To run all tests except those which do not rely on credentials ./gradlew tests:testWithoutCredentials

To run a single test-class: ./gradlew tests:test --tests <SomeGradleTestFilter>

License

Apache 2.0