annotate xml/en/docs/howto_setup_development_environment_on_ec2.xml @ 386:62468b793748

ec2 howto added
author Sergey Budnevitch <sb@waeme.net>
date Thu, 02 Feb 2012 09:28:47 +0000
parents
children 245167685006
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
1 <?xml version="1.0"?>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
2
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
3 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
4
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
5 <article name="Setting up development environment with nginx on Amazon EC2"
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
6 link="/en/docs/howto_setup_development_environment_on_ec2.html"
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
7 lang="en">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
8
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
9 <section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
10
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
11 <para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
12 As an ISV participating in AWS Solution Providers Program, nginx is
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
13 offering an automated install script for use with AWS EC2 instances.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
14 This helper script is targeted at the developers who have just
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
15 started using nginx and EC2, and who would like to get things up quickly
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
16 and efficiently. Please check the action list below in order to
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
17 prepare your virtual machine and nginx configuration.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
18 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
19
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
20 <para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
21 To setup a development environment:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
22 <list>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
23 <item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
24 Follow the
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
25 <link url="http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/Welcome.html">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
26 Get Started with EC2</link> guide to sign up to AWS and
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
27 launch your EC2 instance. Only Amazon Linux is supported, so please
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
28 choose either "Basic 32-bit Amazon Linux AMI" or
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
29 "Basic 64-bit Amazon Linux AMI" for an AMI. When configuring
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
30 the firewall rules it is necessary to add a rule to accept web
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
31 traffic on port 80.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
32 </item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
33
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
34 <item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
35 As soon as the new instance is launched, log in to it and
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
36 download <literal>aws_nginx_setup.sh</literal> script with the
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
37 following command:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
38 <programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
39 wget http://nginx.org/download/aws_nginx_setup.sh
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
40 </programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
41 then run the script with root privileges:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
42 <programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
43 sudo sh ./aws_nginx_setup.sh
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
44 </programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
45 </item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
46
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
47 <item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
48 You will be asked to select what components to install. Currently
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
49 it is possible to choose Django, Pyramid, Ruby on Rails or PHP
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
50 development environment. After you have selected the necessary
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
51 component the script will automatically prepare its configuration
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
52 for use with nginx. There will be a separate user created too,
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
53 and then a sample web application is started to ensure everything
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
54 is working correctly.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
55 </item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
56
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
57 <item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
58 After the installation completes and the web application is installed
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
59 in a subdirectory inside /var/www, the script will print how to
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
60 start/stop sample application. For example, the Rails application will
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
61 reside in /var/www/rails, and Rails specific part of nginx configuration
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
62 will be in /etc/nginx/conf.d/rails.conf.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
63 Installed application and configs can be used as a basis for
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
64 futher development.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
65 </item>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
66 </list>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
67 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
68
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
69 </section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
70
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
71 </article>