Pull changes from upstream repository.
This commit is contained in:
Marek Skalický
parent
1df5c02ff5
commit
145f340731
25 changed files with 2230 additions and 410 deletions
242
root/help.1
242
root/help.1
|
|
@ -1,121 +1,154 @@
|
|||
.TH "nodejs" "1" "" "Rado Pitonak \<rpitonak@redhat.com\>" "DATE 07.04.2017" ""
|
||||
|
||||
|
||||
.SH NAME
|
||||
.TH NodeJS 8 container image
|
||||
.PP
|
||||
nodejs \- source to image builder of node.js applications.
|
||||
This container image includes Node.JS 8 as a S2I
|
||||
\[la]https://github.com/openshift/source-to-image\[ra] base image for your Node.JS 8 applications.
|
||||
Users can choose between RHEL and CentOS based builder images.
|
||||
The RHEL image is available in the Red Hat Container Catalog
|
||||
\[la]https://access.redhat.com/containers/#/registry.access.redhat.com/rhscl/nodejs-8-rhel7\[ra]
|
||||
as registry.access.redhat.com/rhscl/nodejs\-8\-rhel7.
|
||||
The CentOS image is then available on Docker Hub
|
||||
\[la]https://hub.docker.com/r/centos/nodejs-8-centos7/\[ra]
|
||||
as centos/nodejs\-8\-centos7.
|
||||
The resulting image can be run using Docker
|
||||
\[la]http://docker.io\[ra]\&.
|
||||
|
||||
|
||||
.SH DESCRIPTION
|
||||
.SH Description
|
||||
.PP
|
||||
Image for building node.js application as reproducible Docker image using source to image.Image is based on fedora.
|
||||
Node.js 8 available as container is a base platform for
|
||||
building and running various Node.js 8 applications and frameworks.
|
||||
Node.js is a platform built on Chrome's JavaScript runtime for easily building
|
||||
fast, scalable network applications. Node.js uses an event\-driven, non\-blocking I/O model
|
||||
that makes it lightweight and efficient, perfect for data\-intensive real\-time applications
|
||||
that run across distributed devices.
|
||||
|
||||
|
||||
.SH USAGE
|
||||
.SH Usage
|
||||
.PP
|
||||
To pull the nodejs container run:
|
||||
To build a simple nodejs\-sample\-app
|
||||
\[la]https://github.com/sclorg/s2i-nodejs-container/tree/master/8/test/test-app\[ra] application
|
||||
using standalone S2I
|
||||
\[la]https://github.com/openshift/source-to-image\[ra] and then run the
|
||||
resulting image with Docker
|
||||
\[la]http://docker.io\[ra] execute:
|
||||
.IP \(bu 2
|
||||
|
||||
.PP
|
||||
\fBFor RHEL based image\fP
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker pull modularitycontainers/nodejs
|
||||
$ s2i build https://github.com/sclorg/s2i\-nodejs\-container.git \-\-context\-dir=8/test/test\-app/ rhscl/nodejs\-8\-rhel7 nodejs\-sample\-app
|
||||
$ docker run \-p 8080:8080 nodejs\-sample\-app
|
||||
|
||||
.fi
|
||||
.RE
|
||||
.IP \(bu 2
|
||||
|
||||
.PP
|
||||
\fBFor CentOS based image\fP
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
$ s2i build https://github.com/sclorg/s2i\-nodejs\-container.git \-\-context\-dir=8/test/test\-app/ centos/nodejs\-8\-centos7 nodejs\-sample\-app
|
||||
$ docker run \-p 8080:8080 nodejs\-sample\-app
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To build your node.js application use run:
|
||||
\fBAccessing the application:\fP
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# s2i build <SOURCE\-REPOSITORY> nodejs:6 <NAME\-OF\-APP>
|
||||
$ curl 127.0.0.1:8080
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.SH Environment variables
|
||||
.PP
|
||||
To run your application in docker container:
|
||||
Application developers can use the following environment variables to configure the runtime behavior of this image:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker run \-d \-p 8080:8080 <NAME\-OF\-APP>
|
||||
|
||||
.fi
|
||||
.RE
|
||||
\fB\fB\fCNODE\_ENV\fR\fP
|
||||
.br
|
||||
NodeJS runtime mode (default: "production")
|
||||
|
||||
.PP
|
||||
By default container is running in production mode with exposed port 8080.To change behavior see Enviroment variables section below.
|
||||
|
||||
|
||||
.SH ENVIRONMENT VARIABLES
|
||||
.PP
|
||||
NODE\_ENV=runtime\_mode
|
||||
Node.js runtime mode (default: "production")
|
||||
\fB\fB\fCDEV\_MODE\fR\fP
|
||||
.br
|
||||
When set to "true", \fB\fCnodemon\fR will be used to automatically reload the server while you work (default: "false"). Setting \fB\fCDEV\_MODE\fR to "true" will change the \fB\fCNODE\_ENV\fR default to "development" (if not explicitly set).
|
||||
|
||||
.PP
|
||||
DEV\_MODE=mode
|
||||
When set to "true", \fB\fCnodemon\fR will be used to automatically reload the server while you work (default: "false"). Setting \fB\fCDEV\_MODE\fR to "true" will change the \fB\fCNODE\_ENV\fR default to "development" (if not explicitly set).
|
||||
|
||||
.PP
|
||||
NPM\_RUN=value
|
||||
Select an alternate / custom runtime mode, defined in your \fB\fCpackage.json\fR file's
|
||||
\fB\fB\fCNPM\_RUN\fR\fP
|
||||
.br
|
||||
Select an alternate / custom runtime mode, defined in your \fB\fCpackage.json\fR file's \fB\fCscripts\fR
|
||||
\[la]https://docs.npmjs.com/misc/scripts\[ra] section (default: npm run "start"). These user\-defined run\-scripts are unavailable while \fB\fCDEV\_MODE\fR is in use.
|
||||
|
||||
.PP
|
||||
HTTP\_PROXY=url
|
||||
Use an npm proxy during assembly
|
||||
\fB\fB\fCHTTP\_PROXY\fR\fP
|
||||
.br
|
||||
Use an npm proxy during assembly
|
||||
|
||||
.PP
|
||||
HTTPS\_PROXY=url
|
||||
Use an npm proxy during assembly
|
||||
\fB\fB\fCHTTPS\_PROXY\fR\fP
|
||||
.br
|
||||
Use an npm proxy during assembly
|
||||
|
||||
.PP
|
||||
NPM\_MIRROR=registry
|
||||
Use a custom NPM registry mirror to download packages during the build process
|
||||
|
||||
|
||||
.SH DEVELOPMENT
|
||||
.PP
|
||||
This image supports development mode. This mode can be switched on and off with the environment variable \fB\fCDEV\_MODE\fR. \fB\fCDEV\_MODE\fR can either be set to \fB\fCtrue\fR or \fB\fCfalse\fR.
|
||||
The debug port can be specified with the environment variable \fB\fCDEBUG\_PORT\fR. \fB\fCDEBUG\_PORT\fR is only valid if \fB\fCDEV\_MODE=true\fR.
|
||||
By default, \fB\fCDEV\_MODE\fR is set to \fB\fCfalse\fR, and \fB\fCDEBUG\_PORT\fR is set to \fB\fC5858\fR, however the \fB\fCDEBUG\_PORT\fR is only relevant if \fB\fCDEV\_MODE=true\fR.
|
||||
|
||||
|
||||
.SH HOT DEPLOY
|
||||
.PP
|
||||
As part of development mode, this image supports hot deploy. If development mode is enabled, any souce code that is changed in the running container will be immediately reflected in the running nodejs application
|
||||
\fB\fB\fCNPM\_MIRROR\fR\fP
|
||||
.br
|
||||
Use a custom NPM registry mirror to download packages during the build process
|
||||
|
||||
.PP
|
||||
To change your source code in a running container, use Docker's exec (
|
||||
\[la]https://docs.docker.com/engine/reference/commandline/exec/\[ra]) command:
|
||||
One way to define a set of environment variables is to include them as key value pairs in your repo's \fB\fC\&.s2i/environment\fR file.
|
||||
|
||||
.PP
|
||||
Example: DATABASE\_USER=sampleUser
|
||||
|
||||
.SS NOTE: Define your own "\fB\fCDEV\_MODE\fR":
|
||||
.PP
|
||||
The following \fB\fCpackage.json\fR example includes a \fB\fCscripts.dev\fR entry. You can define your own custom \fB\fCNPM\_RUN\fR
|
||||
\[la]https://docs.npmjs.com/cli/run-script\[ra] scripts in your application's \fB\fCpackage.json\fR file.
|
||||
|
||||
.SS Note: Setting logging output verbosity
|
||||
.PP
|
||||
To alter the level of logs output during an \fB\fCnpm install\fR the npm\_config\_loglevel environment variable can be set. See npm\-config
|
||||
\[la]https://docs.npmjs.com/misc/config\[ra]\&.
|
||||
|
||||
.SH Development Mode
|
||||
.PP
|
||||
This image supports development mode. This mode can be switched on and off with the environment variable \fB\fCDEV\_MODE\fR\&. \fB\fCDEV\_MODE\fR can either be set to \fB\fCtrue\fR or \fB\fCfalse\fR\&.
|
||||
Development mode supports two features:
|
||||
* Hot Deploy
|
||||
* Debugging
|
||||
|
||||
.PP
|
||||
The debug port can be specified with the environment variable \fB\fCDEBUG\_PORT\fR\&. \fB\fCDEBUG\_PORT\fR is only valid if \fB\fCDEV\_MODE=true\fR\&.
|
||||
|
||||
.PP
|
||||
A simple example command for running the container in development mode is:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker exec \-it <CONTAINER\_ID> /bin/bash
|
||||
docker run \-\-env DEV\_MODE=true my\-image\-id
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
After you enter into the running container, your current directory is set to /opt/app\-root/, where the source code is located.
|
||||
|
||||
|
||||
.SH EXAMPLE
|
||||
.PP
|
||||
To run your application in development mode run:
|
||||
To run the container in development mode with a debug port of 5454, run:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker run \-\-env DEV\_MODE=true \-p 8080:8080 <NAME\-OF\-APP>
|
||||
$ docker run \-\-env DEV\_MODE=true DEBUG\_PORT=5454 my\-image\-id
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
|
@ -127,57 +160,86 @@ To run the container in production mode, run:
|
|||
.RS
|
||||
|
||||
.nf
|
||||
# docker run \-\-env DEV\_MODE=false <NAME\-OF\-APP>
|
||||
$ docker run \-\-env DEV\_MODE=false my\-image\-id
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To run the container in development mode with a debug port of 5454, run
|
||||
By default, \fB\fCDEV\_MODE\fR is set to \fB\fCfalse\fR, and \fB\fCDEBUG\_PORT\fR is set to \fB\fC5858\fR, however the \fB\fCDEBUG\_PORT\fR is only relevant if \fB\fCDEV\_MODE=true\fR\&.
|
||||
|
||||
.SH Hot deploy
|
||||
.PP
|
||||
As part of development mode, this image supports hot deploy. If development mode is enabled, any souce code that is changed in the running container will be immediately reflected in the running nodejs application.
|
||||
|
||||
.SS Using Docker's exec
|
||||
.PP
|
||||
To change your source code in a running container, use Docker's exec
|
||||
\[la]http://docker.io\[ra] command:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# docker run \-\-env DEV\_MODE=true DEBUG\_PORT=5454 <NAME\-OF\-APP>
|
||||
$ docker exec \-it <CONTAINER\_ID> /bin/bash
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To build your application with using of npm proxy.
|
||||
After you Docker exec
|
||||
\[la]http://docker.io\[ra] into the running container, your current directory is set to \fB\fC/opt/app\-root/src\fR, where the source code for your application is located.
|
||||
|
||||
.SS Using OpenShift's rsync
|
||||
.PP
|
||||
If you have deployed the container to OpenShift, you can use oc rsync
|
||||
\[la]https://docs.okd.io/latest/dev_guide/copy_files_to_container.html\[ra] to copy local files to a remote container running in an OpenShift pod.
|
||||
|
||||
.SS Warning:
|
||||
.PP
|
||||
The default behaviour of the s2i\-nodejs container image is to run the Node.js application using the command \fB\fCnpm start\fR\&. This runs the \fIstart\fP script in the \fIpackage.json\fP file. In developer mode, the application is run using the command \fB\fCnodemon\fR\&. The default behaviour of nodemon is to look for the \fImain\fP attribute in the \fIpackage.json\fP file, and execute that script. If the \fImain\fP attribute doesn't appear in the \fIpackage.json\fP file, it executes the \fIstart\fP script. So, in order to achieve some sort of uniform functionality between production and development modes, the user should remove the \fImain\fP attribute.
|
||||
|
||||
.PP
|
||||
Below is an example \fIpackage.json\fP file with the \fImain\fP attribute and \fIstart\fP script marked appropriately:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
# s2i build ./test/test\-app nodejs:6 my\-app \-\-env HTTP\_PROXY=url
|
||||
{
|
||||
"name": "node\-echo",
|
||||
"version": "0.0.1",
|
||||
"description": "node\-echo",
|
||||
"main": "example.js", <\-\-\- main attribute
|
||||
"dependencies": {
|
||||
},
|
||||
"devDependencies": {
|
||||
"nodemon": "*"
|
||||
},
|
||||
"engine": {
|
||||
"node": "*",
|
||||
"npm": "*"
|
||||
},
|
||||
"scripts": {
|
||||
"dev": "nodemon \-\-ignore node\_modules/ server.js",
|
||||
"start": "node server.js" <\-\- start script
|
||||
},
|
||||
"keywords": [
|
||||
"Echo"
|
||||
],
|
||||
"license": "",
|
||||
}
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
|
||||
.SH SECURITY IMPLICATIONS
|
||||
.SS Note:
|
||||
.PP
|
||||
\-d
|
||||
\fB\fCoc rsync\fR is only available in versions 3.1+ of OpenShift.
|
||||
|
||||
.SH See also
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
Runs continuously as a daemon process in the background
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\-p 8080:8080
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
Opens container port 8080 and maps it to the same port on the Host.
|
||||
|
||||
.fi
|
||||
.RE
|
||||
Dockerfile and other sources are available on
|
||||
\[la]https://github.com/sclorg/s2i-nodejs-container\[ra]\&.
|
||||
In that repository you also can find another versions of Python environment Dockerfiles.
|
||||
Dockerfile for CentOS is called Dockerfile, Dockerfile for RHEL is called Dockerfile.rhel7.
|
||||
|
|
|
|||
17
root/opt/app-root/etc/generate_container_user
Normal file
17
root/opt/app-root/etc/generate_container_user
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
# Set current user in nss_wrapper
|
||||
USER_ID=$(id -u)
|
||||
GROUP_ID=$(id -g)
|
||||
|
||||
if [ x"$USER_ID" != x"0" -a x"$USER_ID" != x"1001" ]; then
|
||||
|
||||
NSS_WRAPPER_PASSWD=/opt/app-root/etc/passwd
|
||||
NSS_WRAPPER_GROUP=/etc/group
|
||||
|
||||
cat /etc/passwd | sed -e 's/^default:/builder:/' > $NSS_WRAPPER_PASSWD
|
||||
|
||||
echo "default:x:${USER_ID}:${GROUP_ID}:Default Application User:${HOME}:/sbin/nologin" >> $NSS_WRAPPER_PASSWD
|
||||
|
||||
export NSS_WRAPPER_PASSWD
|
||||
export NSS_WRAPPER_GROUP
|
||||
export LD_PRELOAD=libnss_wrapper.so
|
||||
fi
|
||||
5
root/opt/app-root/etc/npm_global_module_list
Normal file
5
root/opt/app-root/etc/npm_global_module_list
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
async
|
||||
mime
|
||||
mkdirp
|
||||
qs
|
||||
minimatch
|
||||
3
root/opt/app-root/etc/scl_enable
Normal file
3
root/opt/app-root/etc/scl_enable
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
# This will make scl collection binaries work out of box.
|
||||
unset BASH_ENV PROMPT_COMMAND ENV
|
||||
source scl_source enable rh-nodejs8
|
||||
Loading…
Add table
Add a link
Reference in a new issue