86 lines
3.9 KiB
Markdown
86 lines
3.9 KiB
Markdown
# Supported tags and respective `Dockerfile` links
|
|
|
|
- [`0.10.32`, `0.10`, `0`, `latest` (*0.10/Dockerfile*)](https://github.com/docker-library/node/blob/913a225f2fda34d6a811fac1466e4f09f075fcf6/0.10/Dockerfile)
|
|
- [`0.10.32-onbuild`, `0.10-onbuild`, `0-onbuild`, `onbuild` (*0.10/onbuild/Dockerfile*)](https://github.com/docker-library/node/blob/913a225f2fda34d6a811fac1466e4f09f075fcf6/0.10/onbuild/Dockerfile)
|
|
- [`0.11.13`, `0.11` (*0.11/Dockerfile*)](https://github.com/docker-library/node/blob/d017d679e92e84a810c580cdb29fcdbba23c2bb9/0.11/Dockerfile)
|
|
- [`0.11.13-onbuild`, `0.11-onbuild` (*0.11/onbuild/Dockerfile*)](https://github.com/docker-library/node/blob/d017d679e92e84a810c580cdb29fcdbba23c2bb9/0.11/onbuild/Dockerfile)
|
|
- [`0.8.28`, `0.8` (*0.8/Dockerfile*)](https://github.com/docker-library/node/blob/d017d679e92e84a810c580cdb29fcdbba23c2bb9/0.8/Dockerfile)
|
|
- [`0.8.28-onbuild`, `0.8-onbuild` (*0.8/onbuild/Dockerfile*)](https://github.com/docker-library/node/blob/d017d679e92e84a810c580cdb29fcdbba23c2bb9/0.8/onbuild/Dockerfile)
|
|
|
|
# What is Node.js?
|
|
|
|
Node.js is a software platform for scalable server-side and networking
|
|
applications. Node.js applications are written in JavaScript and can be run
|
|
within the Node.js runtime on Mac OS X, Windows, and Linux without changes.
|
|
|
|
Node.js applications are designed to maximize throughput and efficiency, using
|
|
non-blocking I/O and asynchronous events. Node.js applications run
|
|
single-threaded, although Node.js uses multiple threads for file and network
|
|
events. Node.js is commonly used for real-time applications due to its
|
|
asynchronous nature.
|
|
|
|
Node.js internally uses the Google V8 JavaScript engine to execute code; a large
|
|
percentage of the basic modules are written in JavaScript. Node.js contains a
|
|
built-in, asynchronous I/O library for file, socket, and HTTP communication. The
|
|
HTTP and socket support allows Node.js to act as a web server without additional
|
|
software such as Apache.
|
|
|
|
> [wikipedia.org/wiki/Node.js](https://en.wikipedia.org/wiki/Node.js)
|
|
|
|
|
|
|
|
# How to use this image
|
|
|
|
## Create a `Dockerfile` in your Node.js app project
|
|
|
|
FROM node:0.10-onbuild
|
|
# replace this with your application's default port
|
|
EXPOSE 8888
|
|
|
|
You can then build and run the Docker image:
|
|
|
|
docker build -t my-nodejs-app
|
|
docker run -it --rm --name my-running-app my-nodejs-app
|
|
|
|
### Notes
|
|
|
|
The image assumes that your application has a file named
|
|
[`package.json`](https://www.npmjs.org/doc/json.html) listing its dependencies
|
|
and defining its [start
|
|
script](https://www.npmjs.org/doc/misc/npm-scripts.html#default-values).
|
|
|
|
## Run a single Node.js script
|
|
|
|
For many simple, single file projects, you may find it inconvenient to write a
|
|
complete `Dockerfile`. In such cases, you can run a Node.js script by using the
|
|
Node.js Docker image directly:
|
|
|
|
docker run -it --rm --name my-running-script -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp node:0.10 node your-daemon-or-script.js
|
|
|
|
# License
|
|
|
|
View [license information](https://github.com/joyent/node/blob/master/LICENSE)
|
|
for the software contained in this image.
|
|
|
|
# User Feedback
|
|
|
|
## Issues
|
|
|
|
If you have any problems with or questions about this image, please contact us
|
|
through a [GitHub issue](https://github.com/docker-library/node/issues).
|
|
|
|
You can also reach many of the official image maintainers via the
|
|
`#docker-library` IRC channel on [Freenode](https://freenode.net).
|
|
|
|
## Contributing
|
|
|
|
You are invited to contribute new features, fixes, or updates, large or small;
|
|
we are always thrilled to receive pull requests, and do our best to process them
|
|
as fast as we can.
|
|
|
|
Before you start to code, we recommend discussing your plans
|
|
through a [GitHub issue](https://github.com/docker-library/node/issues), especially for more ambitious
|
|
contributions. This gives other contributors a chance to point you in the right
|
|
direction, give you feedback on your design, and help you find out if someone
|
|
else is working on the same thing.
|