changeset 386:62468b793748

ec2 howto added
author Sergey Budnevitch <sb@waeme.net>
date Thu, 02 Feb 2012 09:28:47 +0000
parents aef88cb1d75c
children 1179b24b71fc
files xml/en/GNUmakefile xml/en/docs/howto.xml xml/en/docs/howto_setup_development_environment_on_ec2.xml
diffstat 3 files changed, 76 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/GNUmakefile	Wed Feb 01 06:02:05 2012 +0000
+++ b/xml/en/GNUmakefile	Thu Feb 02 09:28:47 2012 +0000
@@ -25,6 +25,7 @@
 		http/converting_rewrite_rules				\
 		howto_build_on_win32					\
 		freebsd_tuning						\
+		howto_setup_development_environment_on_ec2		\
 
 HOWTO_XML =	$(foreach name, $(HOWTO), xml/$(DOC_LANG)/docs/$(name).xml)
 HOWTO_HTML =	$(foreach name, $(HOWTO), $(OUT)/$(DOC_LANG)/docs/$(name).html)
--- a/xml/en/docs/howto.xml	Wed Feb 01 06:02:05 2012 +0000
+++ b/xml/en/docs/howto.xml	Thu Feb 02 09:28:47 2012 +0000
@@ -22,6 +22,10 @@
 <link doc="howto_build_on_win32.xml"/>
 </item>
 
+<item>
+<a href="/en/docs/howto_setup_development_environment_on_ec2.xml"/>
+</item>
+
 </list>
 </para>
 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/docs/howto_setup_development_environment_on_ec2.xml	Thu Feb 02 09:28:47 2012 +0000
@@ -0,0 +1,71 @@
+<?xml version="1.0"?>
+
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Setting up development environment with nginx on Amazon EC2"
+         link="/en/docs/howto_setup_development_environment_on_ec2.html"
+         lang="en">
+
+<section>
+
+<para>
+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.
+</para>
+
+<para>
+To setup a development environment:
+<list>
+<item>
+Follow the 
+<link url="http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/Welcome.html">
+Get Started with EC2</link> 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.
+</item>
+
+<item>
+As soon as the new instance is launched, log in to it and
+download <literal>aws_nginx_setup.sh</literal> script with the
+following command:
+<programlisting>
+wget http://nginx.org/download/aws_nginx_setup.sh
+</programlisting>
+then run the script with root privileges:
+<programlisting>
+sudo sh ./aws_nginx_setup.sh
+</programlisting>
+</item>
+
+<item>
+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,
+and then a sample web application is started to ensure everything
+is working correctly.
+</item>
+
+<item>
+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 configs can be used as a basis for
+futher development.
+</item>
+</list>
+</para>
+
+</section>
+
+</article>