Node-pre-gyp makes it easy to publish and install nodejs c addons from binaries
It should generate a policy like:. You can use any of the methods described at http: Or pass options in any way supported by RC. You may also need to specify the region if it is not explicit in the host value you use. The bucket can also be specified but it is optional because node-pre-gyp will detect it from the host value. Appveyor can build binaries and publish the results per commit and supports:. For an example of doing this see node-sqlite3's appveyor.
Once you have committed an appveyor. Encrypt your S3 AWS keys by going to https: Just put node-pre-gyp package publish in your appveyor.
You might wish to publish binaries only on a specific commit. To do this you could borrow from the Travis CI idea of commit keywords and add special handling for commit messages with [publish binary]:. If your commit message contains special characters e. An alternative is to use PowerShell, which gives you additional possibilities, like ignoring case by using ToLower:.
Remember this publishing is not the same as npm publish. We're just talking about the binary module here and not your entire npm package. Travis can push to S3 after a successful build and supports both:. For an example of doing this see node-add-example's. See the node-sqlite3 scripts for an example of doing this.
More details on Travis encryption at http: Just put node-pre-gyp package publish in your. If you want binaries for OS X in addition to linux you can enable multi-os for Travis. Also create platform specific sections for any deps that need install. For example if you need libpng:. For detailed multi-OS examples see node-mapnik and node-sqlite3. To do so you will need to:. Second, the OS X machines do not support using a matrix for installing different Node. So you need to bootstrap the installation of Node.
You only want to run the publish on the push commit. To automate the publishing of your entire package to npm on Travis see http: The strings are evaluated by node-pre-gyp depending on your system and any custom build flags you passed.
If you installed node-pre-gyp globally, you can use it by typing node-pre-gyp at the command line. The npm install builds the package, the node-pre-gyp command packages makes the zip file and publishes it to S3 - you should see a message at the end giving you the URL where the package was published.
Running this on a Mac gave me the following URL - https: Now, in the example directory, do a fresh npm install. The next step is to re-run the npm install and. It also means you likely need to do this with various versions of Node.
You may even go as far as different CPU architectures. This is outside the scope of this article, but is the next logical step. You can find the full source code for this in the nodecpp-demo repository, this example is found in the prebuilt directory. Check out some of my eariler posts and my book for more help on that part. Sign up to for Node Addons newsletter so you find out when new articles are published right away.
Cross-platform addons with node-pre-gyp 07 Feb Node. It just makes doing the following easier: During build development Automatically names built addon executables based on the current platform OS , architecture i. Packages the executable into zipped payloads. Optionally automatically publishes the payload to an Amazon S3 bucket. You can also manually upload them elsewhere. Addon setup Create a package. Setting up node-pre-gyp As described above, node-pre-gyp is a tool that makes it easy to deploy platform-specific binaries to a host i.
They go as follows: This is where the binary build output will be placed locally, when we do an npm install on the addon before deployment. The name of the binary build output - both locally and remote. The variables being used are as follows: This no longer holds though, now the binary addon will hopefully be found, pre-built, on a remote host. This bit of code loads node-pre-gyp , shows it where the package. Code require ing this addon still works the same way - but now node-pre-gyp is locating the binary.
The binary entry in package. Check out the binding. Your final file structure should look like this, with the only change being the new index.
Do an npm install again, and you should see some new messages printing to the screen…. In the printout, you should see the node-pre-gyp install --fallback-to-build command being executed.
Tried to download and node-pre-gyp ERR! Pre-built binaries not found. If all goes well, you can again run the addon with node index. Your first decision is what sort of host you want to use. You have two basic choices - an Amazon S3 bucket, or anything else.
Github is a popular choice, but really any web host is fine etc. There is a module to automate a lot of the process when using github. The advantage of using S3 buckets is that node-pre-gyp can handle the deployment publishing process for you, entirely. The basic steps are as follows:. You can keep all the default properties set. Login to IAM, and create a new policy. Ensure all the necessary permissions are set, and be sure to set the resource to contain your new S3 bucket.
Now attach the policy to either an existing or new user account. I named this file node-pre-gyp. I added it to my. In order to do the publishing, we need to add aws-sdk to our dependencies. Now, we can publish by using node-pre-gyp directly. If you installed node-pre-gyp globally, you can use it by typing node-pre-gyp at the command line. The npm install builds the package, the node-pre-gyp command packages makes the zip file and publishes it to S3 - you should see a message at the end giving you the URL where the package was published.