tag | 2c5de72d3b229d87be6a496951aef03face4c902 | |
---|---|---|
tagger | David Grove <groved@us.ibm.com> | Tue Jul 06 21:04:57 2021 -0400 |
object | 1e107825154db9c73b386d0999eb68c5d3df7161 |
nodejs14Action@1.18.0
commit | 1e107825154db9c73b386d0999eb68c5d3df7161 | [log] [tgz] |
---|---|---|
author | David Grove <groved@us.ibm.com> | Fri Jul 02 10:02:33 2021 -0400 |
committer | rodric rabbah <rodric@gmail.com> | Fri Jul 02 20:27:01 2021 -0400 |
tree | 2645cae3ed06e2ba02bfa5678f10f903ec309d2d | |
parent | 798b21317d08d40ca3a283785ad14d686019cde2 [diff] |
update README and CHANGELOG for 1.18 release
This repository contains sources files needed to build the Node.js runtimes for Apache OpenWhisk. The build system will produce a series of docker images for each runtime version. These images are used in the platform to execute Node.js actions.
The following Node.js runtime versions (with kind & image labels) are generated by the build system:
nodejs:10
& openwhisk/action-nodejs-v10
)nodejs:12
& openwhisk/action-nodejs-v12
)nodejs:14
& openwhisk/action-nodejs-v14
)This README documents the build, customisation and testing of these runtime images.
Do you want to learn more about using Node.js actions to build serverless applications? Please see the main project documentation here for that information.
If the deployment of Apache OpenWhisk includes these images in the runtime manifest, use the --kind
parameter to select the Node.js runtime version.
wsk action update myAction myAction.js --kind nodejs:10
wsk action update myAction myAction.js --kind nodejs:12
wsk action update myAction myAction.js --kind nodejs:14
All the runtime images are published by the project to Docker Hub @ https://hub.docker.com/u/openwhisk
These images can be used to execute Node.js actions on any deployment of Apache OpenWhisk, even those without those images defined the in runtime manifest, using the --docker
action parameter.
wsk action update myAction myAction.js --docker openwhisk/action-nodejs-v12
If you build a custom version of the images, pushing those an external Docker Hub repository will allow you to use those on the Apache OpenWhisk deployment.
Available runtimes in Apache OpenWhisk are defined using the runtimes manifest in this file: runtimes.json
Modify the manifest and re-deploy the platform to pick up local images changes.
Dockerfiles for runtime images are defined in the core
directory. Each runtime version folder has a custom Dockerfile
and package.json
. If you need to add extra dependencies to a runtime version - modify these files.
The core/nodejsActionBase
folder contains the Node.js app server used to implement the action interface, used by the platform to inject action code into the runtime and fire invocation requests. This common code is used in all runtime versions.
distDocker
command to generate local Docker images for the different runtime versions../gradlew core:nodejs10Action:distDocker ./gradlew core:nodejs12Action:distDocker ./gradlew core:nodejs14Action:distDocker
This will return the following runtime images with the following names: action-nodejs-v10
, action-nodejs-v12
and action-nodejs-v14
.
./gradlew install
This command MUST BE run from the directory containing the main Apache OpenWhisk repository, not this repository's directory.
./gradlew tests:dat:docker:nodejs10docker:distDocker ./gradlew tests:dat:docker:nodejs12docker:distDocker ./gradlew tests:dat:docker:nodejs14docker:distDocker
./gradlew :tests:test