hpess/devenv-nodejs repository overview

⁠hpess/devenv-nodejs

This container is a development environment for nodejs, expanding on the framework of hpess/devenv⁠ by installing the tools required to develop in node:

• nvm (default install node v0.12)
• grunt-cli, jake, forever, npm-check-updates, depcheck, js-beautify, nsp

⁠Use

The easiest way is probably with a fig file, as you need to pass in some environment variables to configure things.

fig.yml:

devenv:
  image: hpess/devenv-nodejs
  hostname: 'nodejs'
  ports:
    - "2022:2022"
  environment:
    devenv_password: "password"
    devenv_wemux_password: "password"
    git_name: "Mr Example"
    git_email: "[email protected]"
    git_ssl_verify: "false"
    npm_registry: "http://registry.npmjs.org"
    npm_ssl_verify: "false"

A breakdown here:

• The passwords are used to control SSH and Wemux access to the environment. Not required, will just default if they need to.
• Git details, again if you're not using git, they're not required. git_ssl_verify will allow connections to https sources with invalid certificates
• Npm details, again, not required.
• Volumes: Mount your source code to /storage as that's the working directory.

Then type sudo fig up -d devenv and ssh in with ssh -T [email protected] -p 2022

⁠No SSH

You can run a single command in the container, instead of sshd etc if you so chose, for example - if you just want to enter an interactive node shell sudo fig run --rm devenv node results in:

****************************************************
*  Welcome to the HP ESS Development Environment!  *
****************************************************
 => Primary logon username: devenv, password: password
 => Wemux logon username: wemux, password: password
 => Executing: node
> 

⁠NodeJS application profiling

I have made it easy for you to profile your nodejs applications and generate a flamegraph.svg. Basically just be in the root of your application and type "node-profile". CTRL+C when you're done and voilla, a flamegraph for that application will be copied to the /storage mount.

⁠SSH Agent Forwarding

If you want to pass through your SSH identity, so that you can use git in the docker container with your credentials, use SSH Agent Forwarding:

ssh -T [email protected] -p 2022

⁠Even easier use

If, like me, you work behind a corporate firewall etc sometimes - you might want to take a look at hpess/dockerproxy⁠