Image runner-NodeJS

Startx nodejs is a base container used for web services and applications published in Dockerhub registry. This container contain :

• fedora system envelope
• core OS rpm (kernel, libs) updated every week
• fundamentals tools (ex: pwgen, tar, zip) updated every week
• Nodejs + npm + express webserver and fundamentals modules (nodejs release depend on the flavour you use, read down for more information)
• usefull tools (psmisc, procps, coreutils, findutils, wget, curl, vi, bash-completion) only for the :latest and :devel flavour.

You can use Startx Nodejs image in many ways :

• Image runner-NodeJS
• Container flavours
• Running this image
  • Running using docker
  • Running using docker-compose
  • Using this image as base container
• Environment variable
• For advanced users
  • Build & run a container using docker
  • Build & run a container using docker-compose

See more applications builders and sample on startx docker images repository

Container flavours

Docker Hub repository	Content	NodeJS	NPM	Make
startx/runner-nodejs:latest	Fedora core rawhide	14.17.0	6.14.13	4.3
startx/runner-nodejs:35	Fedora core 35	14.17.0	6.14.13	4.3
startx/runner-nodejs:34	Fedora core 34	14.17.0	6.14.13	4.3
startx/runner-nodejs:33	Fedora core 33	14.16.1	6.14.12	4.3
startx/runner-nodejs:32	Fedora core 32	12.4.0
startx/runner-nodejs:31	Fedora core 31	12.19.0	6.14.8	4.2.1
startx/runner-nodejs:30	Fedora core 30	10.15.0
startx/runner-nodejs:29	Fedora core 29	10.16.0
startx/runner-nodejs:28	Fedora core 28	0.10.36
startx/runner-nodejs:27	Fedora core 27	0.10.36
startx/runner-nodejs:26	Fedora core 26
startx/runner-nodejs:centos8	Centos 8	10.24.0	6.14.11	4.2.1
startx/runner-nodejs:centos7	Centos 7	3.10.10	6.17.1	3.82
startx/runner-nodejs:ubi8	RedHat UBI 8
startx/runner-nodejs:alpine3	Alpine 3.12	12.22.1	6.14.12	4.3

Running this image

If you want to be guided on setting-up and installing various containers engines (docker, podman, s2i, dockerEE, kubernetes, openshift) you can read ours containers engines guidelines.

Running using docker

docker run -it -p 9221:8080 --name="example-nodejs" startx/runner-nodejs

• Connect to your local application

firefox http://localhost:9221

Running using docker-compose

• Create a docker-compose.yml file with the following content

nodejs:
  image: startx/runner-nodejs:latest
  container_name: "example-nodejs"
  ports:
    - "9221:8080"

• Execute the following command

docker-compose up -d
docker-compose logs

• Connect to your local application

firefox http://localhost:9221

Using this image as base container

You can use this Dockerfile template to start a new personalized container based on this container. Create a file named Dockerfile in your project directory and copy this content inside. See docker guide for instructions on how to use this file.

FROM quay.io/startx/runner-nodejs:latest
#... your container specifications

Environment variable

Variable	Type	Default	Description
SX_VERSION	string	latest	container version
SX_TYPE	string	service	Container family (os, service, application). could be enhanced
SX_SERVICE	string	nodejs	Define the type of service or application provided
SX_ID	auto	startx/runner-nodejs	Container ID coresponding to the image repository
SX_NAME	auto	yes	Container name
SX_SUMMARY	auto	yes	Container purpose description
SX_VERBOSE	bool	no	Display information about the execution
SX_DEBUG	bool	no	Display debug informations during execution
APP_PATH	string	/app	Path to the application
LOG_PATH	string	/var/log/httpd	Destination path to the log produced by the webserver
DATA_PATH	string	/data	Destination path to the data manipulated by the application
APP_MAIN	string	/app/app.js	Main application entrypoint
SX_S2IDIR	string	/tmp	Destination path to the application pushed via s2i process

For advanced users

You can contribute or start this container initiative locally. Follow theses instructions to setup a working environment.

This section will help you if you want to :

• Get latest version of this container Service source code
• Enhance and share your container improvement by adding instruction in Dockefile

Build & run a container using docker

1. Jump into the container directory with cd GitlabRunner/nodejs
2. Build the container using docker build -t startx-nodejs .
3. Run this container
4. Interactively with docker run -it startx-nodejs. If you add a second parameter (like /bin/bash) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: /bin/bash, /bin/ps -a, /bin/df -h,...)
5. As a daemon with docker run -d -p 9221:8080 startx-nodejs

Build & run a container using docker-compose

1. Jump into the container directory with cd GitlabRunner/nodejs
2. Run this container
3. Interactively with docker-compose up Startup logs appears and escaping this command stop the container
4. As a daemon with docker-compose up -d. Container startup logs can be read using docker-compose logs