annotate xml/en/docs/howto_setup_development_environment_on_ec2.xml @ 589:764fbac1b8b4

Added document revision.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 17 Jul 2012 05:02:15 +0000
parents be54c443235a
children d26a60eab2b5
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
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
4 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
5 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
6
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
7 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
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 <article name="Setting up development environment with nginx on Amazon EC2"
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
10 link="/en/docs/howto_setup_development_environment_on_ec2.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
11 lang="en"
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 rev="1">
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
13
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
14 <section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
15
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
16 <para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
17 As an ISV participating in AWS Solution Providers Program, nginx is
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
18 offering an automated install script for use with AWS EC2 instances.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
19 This helper script is targeted at the developers who have just
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
20 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
21 and efficiently. Please check the action list below in order to
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
22 prepare your virtual machine and nginx configuration.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
23 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
24
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
25 <para>
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
26 To set up a development environment:
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
27 <list type="bullet">
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
28 <listitem>
509
0e55c9a48da9 Trimmed space at EOL.
Ruslan Ermilov <ru@nginx.com>
parents: 461
diff changeset
29 Follow the
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
30 <link url="http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/Welcome.html">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
31 Get Started with EC2</link> guide to sign up to AWS and
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
32 launch your EC2 instance. Only Amazon Linux is supported, so please
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
33 choose either “Basic 32-bit Amazon Linux AMI” or
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
34 “Basic 64-bit Amazon Linux AMI” for an AMI. When configuring
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
35 the firewall rules, it is necessary to add a rule to accept web
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
36 traffic on port 80.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
37 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
38
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
39 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
40 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
41 download <literal>aws_nginx_setup.sh</literal> script with the
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
42 following command:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
43 <programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
44 wget http://nginx.org/download/aws_nginx_setup.sh
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
45 </programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
46 then run the script with root privileges:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
47 <programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
48 sudo sh ./aws_nginx_setup.sh
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
49 </programlisting>
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
50 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
51
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
52 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
53 You will be asked to select what components to install. Currently
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
54 it is possible to choose Django, Pyramid, Ruby on Rails or PHP
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
55 development environment. After you have selected the necessary
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
56 component, the script will automatically prepare its configuration
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
57 for use with nginx. There will be a separate user created too,
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
58 and then a sample web application is started to ensure everything
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
59 is working correctly.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
60 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
61
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
62 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
63 After the installation completes and the web application is installed
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
64 in a subdirectory inside <path>/var/www</path>, the script will print how to
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
65 start/stop sample application. For example, the Rails application will
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
66 reside in <path>/var/www/rails</path>, and Rails specific part of nginx
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
67 configuration will be in <path>/etc/nginx/conf.d/rails.conf</path>.
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
68 Installed application and configuration files can be used as a basis for
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
69 further development.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
70 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
71 </list>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
72 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
73
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
74 </section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
75
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
76 </article>