Fix issue #3

* Update config.json

Add 418 error

* Update CHANGELOG.md

.github/workflows/tests.yml

@@ -51,5 +51,8 @@ jobs: # Docs: <https://git.io/JvxXE>
       - name: Pause
         run: sleep 2
 
-      - name: Send HTTP request
+      - name: Verify 500.html error file exists in root
         run: curl -sS --fail "http://127.0.0.1:8080/500.html"
+
+      - name: Verify root request HTTP code
+        run: test $(curl --write-out %{http_code} --silent --output /dev/null http://127.0.0.1:8080/) -eq 404

CHANGELOG.md

@@ -4,6 +4,45 @@ All notable changes to this package will be documented in this file.
 
 The format is based on [Keep a Changelog][keepachangelog] and this project adheres to [Semantic Versioning][semver].
 
+## v1.3.1
+
+### Fixed
+
+- `can't create directory '/opt/html/nginx-error-pages'` error [#3]
+
+[#3]:https://github.com/tarampampam/error-pages/issues/3
+
+## v1.3.0
+
+### Added
+
+- `418` status code error page
+- Set `server_tokens off;` in `nginx` server configuration
+
+## v1.2.0
+
+### Fixed
+
+- By default `nginx` in docker container returns 404 http code instead 200 when `/` requested
+
+### Changed
+
+- Default value for `TEMPLATE_NAME` is `ghost` now
+
+### Removed
+
+- Environment variable `DEFAULT_ERROR_CODE` support in docker image
+
+### Added
+
+- Templates `l7-light` and `l7-dark`
+
+## v1.1.0
+
+### Added
+
+- Environment variable `DEFAULT_ERROR_CODE` support in docker image
+
 ## v1.0.1
 
 ### Changed

Makefile

@@ -26,7 +26,7 @@ gen: ## Generate error pages
 preview: ## Build docker image and start preview
 	$(DOCKER_BIN) build -f ./Dockerfile -t $(APP_NAME):local .
 	@printf "\n   \e[30;42m %s \033[0m\n\n" 'Now open in your favorite browser <http://127.0.0.1:8081> and press CTRL+C for stopping'
-	$(DOCKER_BIN) run --rm -i -p 8081:8080 $(APP_NAME):local
+	$(DOCKER_BIN) run --rm -i -p 8081:8080 -e "TEMPLATE_NAME=l7-light" $(APP_NAME):local
 
 shell: ## Start shell into container with node
 	$(DC_BIN) run $(DC_RUN_ARGS) app sh

README.md

@@ -6,6 +6,7 @@
 
 [![Build Status][badge_build_status]][link_build_status]
 [![Image size][badge_size_latest]][link_docker_hub]
+[![Docker Pulls][badge_docker_pulls]][link_docker_hub]
 [![License][badge_license]][link_license]
 
 This repository contains:
@@ -13,6 +14,8 @@ This repository contains:
 - A very simple [generator](./bin/generator.js) _(`nodejs`)_ for HTTP error pages _(like `404: Not found`)_ with different templates supports
 - Dockerfile for [docker image][link_docker_hub] with generated pages and `nginx` as web server
 
+Can be used for [Traefik error pages customization](https://docs.traefik.io/middlewares/errorpages/).
+
 ### Demo
 
 Generated pages (from the latest release) always [accessible here][link_branch_gh_pages] _(sources)_ and on GitHub pages [here][link_gh_pages].
@@ -39,30 +42,30 @@ If you want to preview the pages using the Docker image:
 $ make preview
 ```
 
-Can be used for [Traefik error pages customization](https://docs.traefik.io/middlewares/errorpages/).
-
 ## Templates
 
-  Name   | Preview
-:------: | :-----:
-`ghost`  | ![ghost](https://hsto.org/webt/zg/ul/cv/zgulcvxqzhazoebxhg8kpxla8lk.png)
+   Name    | Preview
+:--------: | :-----:
+`ghost`    | ![ghost](https://hsto.org/webt/zg/ul/cv/zgulcvxqzhazoebxhg8kpxla8lk.png)
+`l7-light` | ![ghost](https://hsto.org/webt/xc/iq/vt/xciqvty-aoj-rchfarsjhutpjny.png)
+`l7-dark`  | ![ghost](https://hsto.org/webt/s1/ih/yr/s1ihyrqs_y-sgraoimfhk6ypney.png)
 
 ## Usage
 
-Generated error pages in our [docker image][link_docker_hub] permanently located in directory `/opt/html/%THEME_NAME%`.
+Generated error pages in our [docker image][link_docker_hub] permanently located in directory `/opt/html/%TEMPLATE_NAME%`. `nginx` in a container listen for `8080` (`http`) port.
 
 #### Supported environment variables
 
 Name            | Description
 --------------- | -----------
-`TEMPLATE_NAME` | "default" pages template _(allows to use error pages without passing theme name in URL - `http://127.0.0.1/500.html` instead `http://127.0.0.1/ghost/500.html`)_
+`TEMPLATE_NAME` | (`ghost` by default) "default" pages template _(allows to use error pages without passing theme name in URL - `http://127.0.0.1/500.html` instead `http://127.0.0.1/ghost/500.html`)_
 
 ### HTTP server for error pages serving only
 
 Execute in your shell:
 
 ```bash
-$ docker run --rm -p "8082:8080" tarampampam/error-pages
+$ docker run --rm -p "8082:8080" tarampampam/error-pages:1.3.0
 ```
 
 And open in your browser `http://127.0.0.1:8082/ghost/400.html`.
@@ -103,7 +106,7 @@ FROM nginx:1.18-alpine
 COPY --chown=nginx \
      ./nginx.conf /etc/nginx/conf.d/default.conf
 COPY --chown=nginx \
-     --from=tarampampam/error-pages:1.0.0 \
+     --from=tarampampam/error-pages:1.3.0 \
      /opt/html/ghost /usr/share/nginx/errorpages/_error-pages
 ```
 
@@ -111,10 +114,59 @@ COPY --chown=nginx \
 
 ### Custom error pages for [Traefik][link_traefik]
 
-Simple traefik service configuration for usage in [docker swarm][link_swarm] (**change with your needs**):
+Simple traefik (tested on `v2.2.1`) service configuration for usage in [docker swarm][link_swarm] (**change with your needs**):
 
 ```yaml
-# Work in progress
+version: '3.4'
+
+services:
+  error-pages:
+    image: tarampampam/error-pages:1.3.0
+    environment:
+      TEMPLATE_NAME: l7-dark
+    networks:
+      - traefik-public
+    deploy:
+      placement:
+        constraints:
+          - node.role == worker
+      labels:
+        traefik.enable: 'true'
+        traefik.docker.network: traefik-public
+        # use as "fallback" for any non-registered services (with priority below normal)
+        traefik.http.routers.error-pages-router.rule: HostRegexp(`{host:.+}`)
+        traefik.http.routers.error-pages-router.priority: 10
+        # should say that all of your services work on https
+        traefik.http.routers.error-pages-router.tls: 'true'
+        traefik.http.routers.error-pages-router.entrypoints: https
+        traefik.http.routers.error-pages-router.middlewares: error-pages-middleware@docker
+        traefik.http.services.error-pages-service.loadbalancer.server.port: 8080
+        # "errors" middleware settings
+        traefik.http.middlewares.error-pages-middleware.errors.status: 400-599
+        traefik.http.middlewares.error-pages-middleware.errors.service: error-pages-service@docker
+        traefik.http.middlewares.error-pages-middleware.errors.query: /{status}.html
+
+  any-another-http-service:
+    image: nginx:alpine
+    networks:
+      - traefik-public
+    deploy:
+      placement:
+        constraints:
+          - node.role == worker
+      labels:
+        traefik.enable: 'true'
+        traefik.docker.network: traefik-public
+        traefik.http.routers.another-service.rule: Host(`subdomain.example.com`)
+        traefik.http.routers.another-service.tls: 'true'
+        traefik.http.routers.another-service.entrypoints: https
+        # next line is important
+        traefik.http.routers.another-service.middlewares: error-pages-middleware@docker
+        traefik.http.services.another-service.loadbalancer.server.port: 80
+
+networks:
+  traefik-public:
+    external: true
 ```
 
 ## Changes log
@@ -142,6 +194,7 @@ This is open-sourced software licensed under the [MIT License][link_license].
 [badge_pulls]:https://img.shields.io/github/issues-pr/tarampampam/error-pages.svg?style=flat-square&maxAge=180
 [badge_license]:https://img.shields.io/github/license/tarampampam/error-pages.svg?longCache=true
 [badge_size_latest]:https://img.shields.io/docker/image-size/tarampampam/error-pages/latest?maxAge=30
+[badge_docker_pulls]:https://img.shields.io/docker/pulls/tarampampam/error-pages.svg
 [link_releases]:https://github.com/tarampampam/error-pages/releases
 [link_commits]:https://github.com/tarampampam/error-pages/commits
 [link_changes_log]:https://github.com/tarampampam/error-pages/blob/master/CHANGELOG.md

config.json

@@ -3,6 +3,14 @@
         {
             "name": "ghost",
             "path": "./templates/ghost.html"
+        },
+        {
+            "name": "l7-light",
+            "path": "./templates/l7-light.html"
+        },
+        {
+            "name": "l7-dark",
+            "path": "./templates/l7-dark.html"
         }
     ],
     "output": {
@@ -74,6 +82,11 @@
             "message": "Requested Range Not Satisfiable",
             "description": "The requested byte range is not available and is out of bounds"
         },
+        {
+            "code": 418,
+            "message": "I'm a teapot",
+            "description": "Attempt to brew coffee with a teapot is not supported"
+        },
         {
             "code": 429,
             "message": "Too Many Requests",

docker/docker-entrypoint.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env sh
 set -e
 
-TEMPLATE_NAME=${TEMPLATE_NAME:-} # string|empty
+TEMPLATE_NAME=${TEMPLATE_NAME:-ghost} # string|empty
 
 if [ -n "$TEMPLATE_NAME" ]; then
   echo "$0: set pages for template '$TEMPLATE_NAME' as default (make accessible in root directory)";
@@ -11,6 +11,15 @@ if [ -n "$TEMPLATE_NAME" ]; then
   fi;
 
   ln -f -s "/opt/html/$TEMPLATE_NAME/"* /opt/html;
+
+  # on `docker restart` next directory keep existing: <https://github.com/tarampampam/error-pages/issues/3>
+  if [ -d /opt/html/nginx-error-pages ]; then
+    rm -Rf /opt/html/nginx-error-pages;
+  fi;
+
+  # next directory is required for easy nginx `error_page` usage
+  mkdir /opt/html/nginx-error-pages;
+  ln -f -s "/opt/html/$TEMPLATE_NAME/"* /opt/html/nginx-error-pages;
 fi;
 
 exec "$@"

docker/nginx-server.conf

@@ -2,8 +2,24 @@ server {
   listen      8080;
   server_name _;
 
+  server_tokens off;
+
+  index index.html index.htm;
+  root  /opt/html;
+
+  error_page 400 /nginx-error-pages/400.html;
+  error_page 401 /nginx-error-pages/401.html;
+  error_page 403 /nginx-error-pages/403.html;
+  error_page 404 /nginx-error-pages/404.html;
+  error_page 500 /nginx-error-pages/500.html;
+  error_page 502 /nginx-error-pages/502.html;
+
+  location ^~ /nginx-error-pages/ {
+    internal;
+    root /opt/html;
+  }
+
   location / {
-    root  /opt/html;
-    index index.html index.htm;
+    try_files $uri =404;
   }
 }

static/index.html

@@ -1,22 +0,0 @@
-<!DOCTYPE html>
-<html><head>
-    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <meta name="robots" content="noindex, nofollow" />
-    <title>Error pages</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
-    <link href="https://fonts.googleapis.com/css?family=Montserrat" rel="stylesheet" type="text/css" />
-    <style type="text/css">
-        html,body {background-color:#fff;font-family:'Montserrat',sans-serif;color:#1a1a1a;overflow:hidden}
-        .wrap {top:50%;left:50%;width:350px;height:260px;margin-left:-175px;margin-top:-130px;position:absolute;text-align:center}
-        .wrap h1 {font-size: 3em; margin-top: 0}
-        .wrap p {font-size: 0.85em}
-        .wrap p.small {font-size: 0.6em}
-    </style>
-</head><body>
-<div class="wrap">
-    <h1>Error pages</h1>
-    <p class="small">
-        For online documentation and support please refer to <a href="https://github.com/tarampampam/error-pages">project repository</a>.
-    </p>
-</div>
-</body></html>

templates/l7-dark.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="robots" content="noindex, nofollow" />
+    <title>{{ message }}</title>
+    <link rel="dns-prefetch" href="//fonts.gstatic.com">
+    <link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet">
+    <style>
+        html,body {background-color: #222526;color:#fff;font-family:'Nunito',sans-serif;font-weight:100;height:100vh;margin:0}
+        .full-height {height:100vh}
+        .flex-center {align-items:center;display:flex;justify-content:center}
+        .position-ref {position:relative}
+        .code {border-right:2px solid;font-size:26px;padding:0 10px 0 15px;text-align:center}
+        .message {font-size:18px;text-align:center;padding:10px}
+    </style>
+</head>
+<body>
+<div class="flex-center position-ref full-height">
+    <div class="code">
+        {{ code }}
+    </div>
+    <div class="message">
+        {{ message }}
+    </div>
+</div>
+</body>
+</html>

templates/l7-light.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="robots" content="noindex, nofollow" />
+    <title>{{ message }}</title>
+    <link rel="dns-prefetch" href="//fonts.gstatic.com">
+    <link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet">
+    <style>
+        html,body {background-color:#fff;color:#636b6f;font-family:'Nunito',sans-serif;font-weight:100;height:100vh;margin:0}
+        .full-height {height:100vh}
+        .flex-center {align-items:center;display:flex;justify-content:center}
+        .position-ref {position:relative}
+        .code {border-right:2px solid;font-size:26px;padding:0 10px 0 15px;text-align:center}
+        .message {font-size:18px;text-align:center;padding:10px}
+    </style>
+</head>
+<body>
+<div class="flex-center position-ref full-height">
+    <div class="code">
+        {{ code }}
+    </div>
+    <div class="message">
+        {{ message }}
+    </div>
+</div>
+</body>
+</html>