annotate xml/en/docs/howto_setup_development_environment_on_ec2.xml @ 580:be54c443235a

Added copyright markers to documentation sources.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 10 Jul 2012 12:59:42 +0000
parents 0e55c9a48da9
children 764fbac1b8b4
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"
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
11 lang="en">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
12
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
13 <section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
14
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
15 <para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
16 As an ISV participating in AWS Solution Providers Program, nginx is
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
17 offering an automated install script for use with AWS EC2 instances.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
18 This helper script is targeted at the developers who have just
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
19 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
20 and efficiently. Please check the action list below in order to
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
21 prepare your virtual machine and nginx configuration.
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
22 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
23
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
24 <para>
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
25 To set up a development environment:
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
26 <list type="bullet">
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
27 <listitem>
509
0e55c9a48da9 Trimmed space at EOL.
Ruslan Ermilov <ru@nginx.com>
parents: 461
diff changeset
28 Follow the
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
29 <link url="http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/Welcome.html">
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
30 Get Started with EC2</link> guide to sign up to AWS and
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
31 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
32 choose either “Basic 32-bit Amazon Linux AMI” or
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
33 “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
34 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
35 traffic on port 80.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
36 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
37
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
38 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
39 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
40 download <literal>aws_nginx_setup.sh</literal> script with the
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
41 following command:
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 wget http://nginx.org/download/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 then run the script with root privileges:
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
46 <programlisting>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
47 sudo sh ./aws_nginx_setup.sh
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
48 </programlisting>
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
49 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
50
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
51 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
52 You will be asked to select what components to install. Currently
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
53 it is possible to choose Django, Pyramid, Ruby on Rails or PHP
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
54 development environment. After you have selected the necessary
394
245167685006 Fixed grammar, punctuation, and markup.
Ruslan Ermilov <ru@nginx.com>
parents: 386
diff changeset
55 component, the script will automatically prepare its configuration
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
56 for use with nginx. There will be a separate user created too,
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
57 and then a sample web application is started to ensure everything
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
58 is working correctly.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
59 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
60
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
61 <listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
62 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
63 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
64 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
65 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
66 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
67 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
68 further development.
461
6135f3c95bf6 Unified markup for lists.
Ruslan Ermilov <ru@nginx.com>
parents: 394
diff changeset
69 </listitem>
386
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
70 </list>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
71 </para>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
72
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
73 </section>
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
74
62468b793748 ec2 howto added
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
75 </article>