diff --git a/roles/nginx/README.md b/roles/nginx/README.md index 42b1ec3c7..c4a3c3cef 100644 --- a/roles/nginx/README.md +++ b/roles/nginx/README.md @@ -1,34 +1,41 @@ ### Transition to NGINX -1. Initial testing strategy is to move NGINX to port 80, and proxy everything to Apache on port 8090 -- creating a shim. +1. Initial testing strategy is to move NGINX to port 80, and proxy everything to Apache on port 8090 — creating "Shims" for each IIAB app/service/playbook in *Section iii.* below. + + Until "Native" NGINX is later implemented for that IIAB app/service/playbook — allowing it to move up to *Section ii.* below. + + And potentially later moving it up to *Section i.* if its Apache support is dropped! 2. Without PHP available via FastCGI, any function at all for PHP-based applications validates NGINX. -3. Current state (2020-01-12). +3. Current state as of 2020-01-23... - 1. Principal functions migrated to NGINX + 1. Supports "Native" NGINX but ***NOT*** Apache * Admin Console - * kalite -- goes directly to ports 8006-8008 - * mediawiki + * captiveportal * osm-vector-maps + * RACHEL-like modules * usb-lib - * wordpress - 2. Dual support, see [roles/nginx/tasks/only_nginx.yml](tasks/only_nginx.yml) - * awstats ([#2124](https://github.com/iiab/iiab/issues/2124)) + 2. Supports "Native" NGINX ***AND*** Apache, a.k.a. "dual support" for legacy testing, which can be attempted by setting 'nginx_enabled: False' in /etc/iiab/local_vars.yml (if "Shims" from *Section iii.* below are preserved!) + * awstats * calibre-web * gitea - * kiwix -- goes directly to port 3000 + * kiwix * kolibri + * mediawiki + * munin * sugarizer + * wordpress - 3. Still proxied to Apache, see [roles/0-init/tasks/main.yml#L108-L112](../0-init/tasks/main.yml#L108-L112) & [roles/nginx/tasks/uses_apache.yml](tasks/uses_apache.yml) + 3. Supports Apache but ***NOT*** NGINX, proxied by an NGINX "Shim" (see [roles/0-init/tasks/main.yml#L39-L49](../0-init/tasks/main.yml#L39-L49) for a list of those IIAB apps/services that auto-enable Apache) * dokuwiki ([#2056](https://github.com/iiab/iiab/issues/2056)) * elgg * lokole * moodle - * nodered * nextcloud ([PR #2119](https://github.com/iiab/iiab/pull/2119)) + * nodered - 4. Not yet dealt with - * internetarchive ([PR #2120](https://github.com/iiab/iiab/pull/2120)) + 4. Not Yet Dealt With! + * internetarchive (menu goes directly to port 4244, [PR #2120](https://github.com/iiab/iiab/pull/2120)) + * kalite (menu goes directly to ports 8006-8008)