Merge pull request #822 from Alfresco/nginx-walkthrough

More specifications for installing and configuring NginX
This commit is contained in:
Mario Romano 2016-09-27 13:03:42 +02:00 committed by GitHub
commit d39913491f

View File

@ -2,11 +2,11 @@
The [Angular 2](https://angular.io/) based application development framework requires the following: The [Angular 2](https://angular.io/) based application development framework requires the following:
- An Alfresco Platform Repository (version [5.2.a-EA](https://wiki.alfresco.com/wiki/Community_file_list_201606-EA) or newer) to talk to, which has [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) enabled. - An Alfresco Platform Repository (version [5.2.a-EA](https://wiki.alfresco.com/wiki/Community_file_list_201606-EA) or newer) to talk to, which has [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) enabled.
- [Download and install Activiti](https://www.alfresco.com/products/bpm/alfresco-activiti/trial) - [Download and install Activiti](https://www.alfresco.com/products/bpm/alfresco-activiti/trial)
- [Node.js](https://nodejs.org/en/) JavaScript runtime. - [Node.js](https://nodejs.org/en/) JavaScript runtime.
- [npm](https://www.npmjs.com/) package manager for JavaScript. - [npm](https://www.npmjs.com/) package manager for JavaScript.
**Verify that you are running at least node `v5.x.x` and npm `3.x.x`** **Verify that you are running at least node `v5.x.x` and npm `3.x.x`**
by running `node -v` and `npm -v` in a terminal/console window. by running `node -v` and `npm -v` in a terminal/console window.
Older versions produce errors. Older versions produce errors.
@ -27,3 +27,14 @@ v5.12.0
To correctly configure Nginx use the following file [nginx.conf](/nginx.conf). To correctly configure Nginx use the following file [nginx.conf](/nginx.conf).
This will put Activiti, Alfresco and the app dev framework under the same domain. This will put Activiti, Alfresco and the app dev framework under the same domain.
This configuration assumes few things:
* Port mapping:
* NginX entry point: 8888
* Demo Shell: 3000
* Alfresco: 8080
* Activiti: 9999
All those values can be modified at their respective `location` directive on the [nginx.conf](/nginx.conf) file.
It also need to be compiled with the [Headers More](https://www.nginx.com/resources/wiki/modules/headers_more/) module , which add more control over sending headers to the backend.