+ rev="2"> -

-As an ISV participating in AWS Solution Providers Program, nginx is -offering an automated install script for use with AWS EC2 instances. -This helper script is targeted at the developers who have just -started using nginx and EC2, and who would like to get things up quickly -and efficiently. Please check the action list below in order to -prepare your virtual machine and nginx configuration. - +As a Standard Technology Partner participating in AWS Partner Network, +Nginx is offering the following products: + + - -To set up a development environment: - -Follow the - -Get Started with EC2 guide to sign up to AWS and -launch your EC2 instance. Only Amazon Linux is supported, so please -choose either “Basic 32-bit Amazon Linux AMI” or -“Basic 64-bit Amazon Linux AMI” for an AMI. When configuring -the firewall rules, it is necessary to add a rule to accept web -traffic on port 80. + +NGINX AMI based on Amazon Linux AMI + + + +Latest version of nginx optimized for use with AWS -As soon as the new instance is launched, log in to it and -download aws_nginx_setup.sh script with the -following command: +Install script for typical nginx configurations with AWS + + + + + + +

+ +

+ + +To quickly set up nginx environment on AWS: + + +Follow + +Getting Started with EC2 guide to sign up to AWS and +get more information about EC2 itself. +Then you can proceed to + +NGINX AMI product page on AWS Marketplace and launch NGINX AMI. +When configuring the firewall rules, it is necessary to add a rule +to accept web traffic on TCP ports 80 and 443 (“1-click launch” +will do that automatically). + + + +As soon as the new instance is launched, nginx will be automatically +started and configured to serve default index.html page. +You can check it by pointing your web browser to the public DNS +name of your newborn EC2 instance. +Also, you can log in to your instance and use -wget http://nginx.org/download/aws_nginx_setup.sh +/etc/init.d/nginx status -then run the script with root privileges: +to check the status of your nginx server. + + + +To configure nginx for use with different web frameworks +quickly and efficiently, you can use a special helper script +included in NGINX AMI. +Log in to your EC2 instance and start: + -sudo sh ./aws_nginx_setup.sh +nginx-setup -You will be asked to select what components to install. Currently -it is possible to choose Django, Pyramid, Ruby on Rails or PHP -development environment. After you have selected the necessary -component, the script will automatically prepare its configuration -for use with nginx. There will be a separate user created too, +You will be asked to select what components to install. +Please check the next section in this document for +list of available software components. +After you have selected the necessary component, the script +will automatically install all prerequisite packages +and prepare the necessary configuration. +There will be a separate user created too, and then a sample web application is started to ensure everything is working correctly. After the installation completes and the web application is installed -in a subdirectory inside /var/www, the script will print how to -start/stop sample application. For example, the Rails application will -reside in /var/www/rails, and Rails specific part of nginx -configuration will be in /etc/nginx/conf.d/rails.conf. -Installed application and configuration files can be used as a basis for -further development. +in a subdirectory inside /var/www, +additional instructions will be provided on how to start/stop sample +application. +For example, the Rails/Unicorn application will reside in +/var/www/rails/sample-unicorn, and specific part of nginx +configuration will be in /etc/nginx/conf.d/rails-unicorn.conf. +Installed application and configuration files can be used as a basis +for further development.

+ + +The following software is available for automatic installation +and configuration using nginx-setup helper script: + + + + +Generic +PHP-FPM +configuration. +FPM (FastCGI Process Manager) is an alternative PHP FastCGI implementation +with some additional features useful for heavy-loaded sites, such as +dynamic/static child spawning, advanced process management, +ability to start workers with different uid/gid/chroot environment. + + + +Ruby on Rails, +an open-source Ruby web framework that's optimized for programmer happiness +and sustainable productivity. +You can choose the application server to work with, currently +Unicorn and Thin are available to configure. +Also, during the installation process you can either enter the version of +Rails manually, or use the default one. + + + +Django, +a high-level Python web framework that encourages rapid development +and clean, pragmatic design. +It lets you build high-performing, elegant Web applications quickly. +Django focuses on automating as much as possible and adhering to the DRY +(Don't Repeat Yourself) principle. + + + +Pyramid, +a small, fast, down-to-earth, open source Python web development framework. +It makes real-world web application development and deployment more fun, +more predictable, and more productive. +Pyramid is a Pylons Project, and is the successor to the Pylons web framework. +There is an ability to enter desired version of Pyramid during the +installation process. + + + + + + +

+ +

+ + +In case you encounter any problems with nginx configuration, +the documentation is available on +http://nginx.org/en/docs/. + + + +Customers purchased NGINX AMI at AWS Marketplace are eligible for assistance +under AWS support plan by Nginx described here: +http://nginx.com/support.html. +Please note that you will need your AWS Account Number in order to activate +your support plan. +In some cases we may also ask you to provide EC2 instance ID(s). + + +