Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
  • 2 commits
  • 1 file changed
  • 0 comments
  • 2 contributors

Showing 1 changed file with 0 additions and 122 deletions. Show diff stats Hide diff stats

  1. 122  README.markdown
122  README.markdown
Source Rendered
@@ -17,123 +17,6 @@ Please report any problems you have with the Cloud Provisioner module in the pro
17 17
 
18 18
  * [Cloud Provisioner Issues](http://projects.puppetlabs.com/projects/cloud-pack/issues)
19 19
 
20  
-Getting Started with Amazon EC2
21  
-===============================
22  
-
23  
-Before launching instances with the Cloud Provisioner module, you'll need to register
24  
-with Amazon AWS and obtain your access credentials.
25  
-
26  
- * [Amazon Web Services Registration](http://www.amazon.com/gp/aws/registration/registration-form.html)
27  
-
28  
-Once registered, obtain your Access Key ID and Access Key.  Place them into the
29  
-~/.fog file with the following syntax:
30  
-
31  
-    :default:
32  
-      :aws_access_key_id: AKIAIXXXXXXXXXXXXXXX
33  
-      :aws_secret_access_key: jcjnhaXXXXXXXXXXXXXXXXXXXX/XXXXXXXXXXXXX
34  
-
35  
-Once you have your Access key and ID in the ~/.fog file, you'll also need to
36  
-generate your SSH private key in the AWS console.  The filesystem path to this
37  
-private key is what you should provide to the --keyfile option.
38  
-
39  
-Finally, you'll probably want to configure the default EC2 security group to
40  
-allow SSH (Port 22) access.  This can be accomplished through the Amazon EC2
41  
-console.  The install actions will fail if they cannot access the target system
42  
-on port 22 (SSH).
43  
-
44  
-Required Gems
45  
-=============
46  
-
47  
- * guid (>= 0.1.1)
48  
- * fog (0.7.2)
49  
-
50  
-Note, the rspec unit tests currently have problems with Fog 0.9.0, but the
51  
-command line actions themselves appear to work.  If you have problems with
52  
-Cloud Provisioner, please try the specific version of Fog.  You may install 0.7.2
53  
-using the following command:
54  
-
55  
-    gem install fog -v 0.7.2 --no-ri --no-rdoc
56  
-
57  
-AMI Image
58  
----------
59  
-
60  
-Picking an AMI image can be daunting.  There are a lot of them out there.
61  
-
62  
-During development of Cloud Provisioner, I often used the following CentOS image which
63  
-is compatible with [AWS Free Usage Tier][free tier] amazon instances:
64  
-
65  
- * ami-2342a94a (US-East region) CentOS 5 (Login: root)
66  
- * ami-25df8e60 (US-West region) CentOS 5 (Login: root)
67  
-
68  
-NOTE: These CentOS AMI's are from rightscale and are configured to use their
69  
-YUM and GEM mirrors.  As a result, they often contain out of date software
70  
-libraries.
71  
-
72  
-A Ubuntu based AMI in the East region also works well with the [AWS Free Usage Tier][free tier] Amazon instances:
73  
-
74  
- * ami-06ad526f (US-East region) Ubuntu (Login: ubuntu)
75  
-
76  
-Launching EC2 Instances
77  
-=======================
78  
-
79  
-With your EC2 credentials placed in ~/.fog and your SSH private key available
80  
-on your system, you may launch a new instance with this module installed using
81  
-the following single command:
82  
-
83  
-    $ puppet node create --image ami-2342a94a --keypair jeff --type t1.micro
84  
-    notice: Creating new instance ...
85  
-    notice: Creating new instance ... Done
86  
-    notice: Creating tags for instance ...
87  
-    notice: Creating tags for instance ... Done
88  
-    notice: Launching server i-e5c00f84 ...
89  
-    ##############
90  
-    notice: Server i-e5c00f84 is now launched
91  
-    notice: Server i-e5c00f84 public dns name: ec2-107-20-18-142.compute-1.amazonaws.com
92  
-    ec2-107-20-18-142.compute-1.amazonaws.com
93  
-
94  
-Once launched, you should be able to SSH to the new system using the private
95  
-key associated with the keypair specified in the create action:
96  
-
97  
-    $ ssh -i ~/.ssh/jeff.pem root@ec2-107-20-18-142.compute-1.amazonaws.com
98  
-    RSA key fingerprint is a1:88:33:fa:de:d7:7c:a8:84:ae:89:73:01:a2:2b:e8.
99  
-    Are you sure you want to continue connecting (yes/no)? yes
100  
-    Warning: Permanently added 'ec2-107-20-18-142.compute-1.amazonaws.com,107.20.18.142' (RSA) to the list of known hosts.
101  
-    [root@domU-12-31-39-07-8C-79 ~]# quit
102  
-
103  
-Finally, you're able to install Puppet or Puppet Enterprise on the newly
104  
-launched system:
105  
-
106  
-    $ puppet node install --login root --keyfile ~/.ssh/jeff.pem ec2-107-20-18-142.compute-1.amazonaws.com
107  
-    notice: Waiting for SSH response ...
108  
-    notice: Waiting for SSH response ... Done
109  
-    notice: Installing Puppet ...
110  
-    66421292-9dee-7f41-624e-6ad2c50d78c1
111  
-
112  
-If you need more detailed information, please use the --verbose and --debug
113  
-options to get more detailed output from the command.
114  
-
115  
-As we can see, this installs Puppet using ruby gems:
116  
-
117  
-    $ ssh root@ec2-107-20-18-142.compute-1.amazonaws.com puppet --version
118  
-    2.6.4
119  
-
120  
-Puppet Installation
121  
-===================
122  
-
123  
-The following installation scripts are available to install puppet on a target
124  
-system.  These script are appropriate values for the --install-script option to
125  
-the puppet node install action.
126  
-
127  
- * gems (default) - Installs Puppet and Facter from RubyGems.
128  
-
129  
- * puppet-enterprise - Installs Puppet by uploading a copy of the puppet
130  
-enterpise tarball from your workstation to the target node along with an
131  
-automated answers file.
132  
-
133  
- * puppet-enterprise-s3 - Installs Puppet by downloading a copy of Puppet
134  
-Enterprise 1.1 from Puppet Labs.  This may be much faster than the
135  
-puppet-enterprise script if you have limited upload bandwidth.
136  
-
137 20
 Building the Module
138 21
 ===================
139 22
 
@@ -152,8 +35,3 @@ To install the packaged module:
152 35
     $ puppet-module install ~/src/modules/cloud-provisioner/pkg/puppetlabs-cloud-provisioner-0.0.1git-95-g6541187.tar.gz
153 36
     Installed "puppetlabs-cloud-provisioner-0.0.1git-95-g6541187.tar.gz" into directory: cloud-provisioner
154 37
 
155  
-External Documentation
156  
-======================
157  
-
158  
- * [free tier]: http://aws.amazon.com/free/ "AWS Free Usage Tier"
159  
-

No commit comments for this range

Something went wrong with that request. Please try again.