d3fb639823
Fixes #356. Instead of downloading a node binary with our closure serialization code linked-in, this PR instead publishes the `nativeruntime.node` produced by the NodeJS SDK build as part of the SDK. This has a number of advantages. First, it is vastly more easy to develop closure.cc in this configuration. Second, we have the ability to ship different `nativeruntime.node`s side-by-side, paving the way for enabling future versions of Node. Third, we don't have to stay in the business of shipping custom builds of Node, although we do still need to ship a version of Node with minor modifications in order for Windows to still work. |
||
|---|---|---|
| .. | ||
| asset | ||
| cmd | ||
| dynamic | ||
| log | ||
| runtime | ||
| scripts | ||
| tests | ||
| .gitignore | ||
| config.ts | ||
| errors.ts | ||
| index.ts | ||
| Makefile | ||
| metadata.ts | ||
| package.json | ||
| pulumi-langhost-nodejs-exec | ||
| pulumi-langhost-nodejs-exec-test | ||
| pulumi-langhost-nodejs-exec.cmd | ||
| pulumi-provider-pulumi-nodejs | ||
| pulumi-provider-pulumi-nodejs.cmd | ||
| README.md | ||
| resource.ts | ||
| tsconfig.json | ||
| tslint.json | ||
| version.ts | ||
| yarn.lock | ||
Pulumi Fabric Node.js SDK
The Pulumi Fabric Node.js SDK lets you write cloud programs in JavaScript.
Installing
For now, we only support developers building from source. Eventually we will have a nice installer.
Prerequisites
To build and install the SDK, you will first need a few things.
First, install Node.js 6.10.2. We recommend nvm, since it makes it easier
to switch between versions of Node.js. Afterwards, run nvm install 6.10.2. As part of the build, a custom build
of Node.js 6.10.2 will be downloaded and installed alongside the SDK. This Node binary is identical to Node.js 6.10.2,
except that it has one extra builtin module containing code that is used by the SDK to serialize JavaScript closures.
The custom binary is built from this repo.
Next, we suggest using Yarn for package management. NPM works too, but Yarn is faster and therefore preferred. Please follow the directions on Yarn's website.
Building and Testing
The first time you build, you must make configure to install and prepare native plugins for V8:
$ make configure
Make sure to run this after installing the right version of Node.js above, otherwise it may bind to the wrong version.
To build the SDK, simply run make from the root directory (sdk/nodejs/). This will build the code, run tests, and
then "install" the package (by yarn linking the resulting bin/ directory).
We recommend putting bin/ on your $PATH, since the pulumi-langhost-nodejs executable will be loaded dynamically
by the pulumi tool whenever it encounters a Node.js program.
The tests will verify that everything works, but feel free to try running pulumi preview and/or pulumi update from
the examples/minimal/ directory. Remember to run tsc first, since pulumi expects JavaScript, not TypeScript.