You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by be...@apache.org on 2011/06/05 10:34:13 UTC
svn commit: r1132067 [9/9] - in /incubator/mesos/trunk: ec2/
third_party/boto-1.8d/ third_party/boto-1.8d/bin/
third_party/boto-1.8d/boto.egg-info/ third_party/boto-1.8d/boto/
third_party/boto-1.8d/boto/cloudfront/ third_party/boto-1.8d/boto/contrib/
t...
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/_templates/layout.html
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/_templates/layout.html?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/_templates/layout.html (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/_templates/layout.html Sun Jun 5 08:34:02 2011
@@ -0,0 +1,3 @@
+{% extends '!layout.html' %}
+
+{% block sidebarsearch %}{{ super() }}<div><a href="boto.pdf">PDF Version</a></div>{% endblock %}
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/autoscale_tut.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/autoscale_tut.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/autoscale_tut.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/autoscale_tut.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,140 @@
+.. _autoscale_tut:
+
+=============================================
+An Introduction to boto's Autoscale interface
+=============================================
+
+This tutorial focuses on the boto interface to the Autoscale service. This
+assumes you are familiar with boto's EC2 interface and concepts.
+
+Autoscale Concepts
+------------------
+
+The AWS Autoscale service is comprised of three core concepts:
+
+ #. *Autoscale Group (AG):* An AG can be viewed as a collection of criteria for
+ maintaining or scaling a set of EC2 instances over one or more availability
+ zones. An AG is limited to a single region.
+ #. *Launch Configuration (LC):* An LC is the set of information needed by the
+ AG to launch new instances - this can encompass image ids, startup data,
+ security groups and keys. Only one LC is attached to an AG.
+ #. *Triggers*: A trigger is essentially a set of rules for determining when to
+ scale an AG up or down. These rules can encompass a set of metrics such as
+ average CPU usage across instances, or incoming requests, a threshold for
+ when an action will take place, as well as parameters to control how long
+ to wait after a threshold is crossed.
+
+Creating a Connection
+---------------------
+The first step in accessing autoscaling is to create a connection to the service.
+There are two ways to do this in boto. The first is:
+
+>>> from boto.ec2.autoscale import AutoScaleConnection
+>>> conn = AutoScaleConnection('<aws access key>', '<aws secret key>')
+
+Alternatively, you can use the shortcut:
+
+>>> conn = boto.connect_autoscale()
+
+A Note About Regions and Endpoints
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Like EC2 the Autoscale service has a different endpoint for each region. By
+default the US endpoint is used. To choose a specific region, instantiate the
+AutoScaleConnection object with that region's endpoint.
+
+>>> ec2 = boto.connect_autoscale(host='eu-west-1.autoscaling.amazonaws.com')
+
+Alternatively, edit your boto.cfg with the default Autoscale endpoint to use::
+
+ [Boto]
+ autoscale_endpoint = eu-west-1.autoscaling.amazonaws.com
+
+Getting Existing AutoScale Groups
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To retrieve existing autoscale groups:
+
+>>> conn.get_all_groups()
+
+You will get back a list of AutoScale group objects, one for each AG you have.
+
+Creating Autoscaling Groups
+---------------------------
+An Autoscaling group has a number of parameters associated with it.
+
+ #. *Name*: The name of the AG.
+ #. *Availability Zones*: The list of availability zones it is defined over.
+ #. *Minimum Size*: Minimum number of instances running at one time.
+ #. *Maximum Size*: Maximum number of instances running at one time.
+ #. *Launch Configuration (LC)*: A set of instructions on how to launch an instance.
+ #. *Load Balancer*: An optional ELB load balancer to use. See the ELB tutorial
+ for information on how to create a load balancer.
+
+For the purposes of this tutorial, let's assume we want to create one autoscale
+group over the us-east-1a and us-east-1b availability zones. We want to have
+two instances in each availability zone, thus a minimum size of 4. For now we
+won't worry about scaling up or down - we'll introduce that later when we talk
+about triggers. Thus we'll set a maximum size of 4 as well. We'll also associate
+the AG with a load balancer which we assume we've already created, called 'my_lb'.
+
+Our LC tells us how to start an instance. This will at least include the image
+id to use, security_group, and key information. We assume the image id, key
+name and security groups have already been defined elsewhere - see the EC2
+tutorial for information on how to create these.
+
+>>> from boto.ec2.autoscale import LaunchConfiguration
+>>> from boto.ec2.autoscale import AutoScalingGroup
+>>> lc = LaunchConfiguration(name='my-launch_config', image_id='my-ami',
+ key_name='my_key_name',
+ security_groups=['my_security_groups'])
+>>> conn.create_launch_configuration(lc)
+
+We now have created a launch configuration called 'my-launch-config'. We are now
+ready to associate it with our new autoscale group.
+
+>>> ag = AutoScalingGroup(group_name='my_group', load_balancers=['my-lb'],
+ availability_zones=['us-east-1a', 'us-east-1b'],
+ launch_config=lc, min_size=4, max_size=4)
+>>> conn.create_auto_scaling_group(ag)
+
+We now have a new autoscaling group defined! At this point instances should be
+starting to launch. To view activity on an autoscale group:
+
+>>> ag.get_activities()
+ [Activity:Launching a new EC2 instance status:Successful progress:100,
+ ...]
+
+or alternatively:
+
+>>> conn.get_all_activities(ag)
+
+This autoscale group is fairly useful in that it will maintain the minimum size without
+breaching the maximum size defined. That means if one instance crashes, the autoscale
+group will use the launch configuration to start a new one in an attempt to maintain
+its minimum defined size. It knows instance health using the health check defined on
+its associated load balancer.
+
+Scaling a Group Up or Down
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+It might be more useful to also define means to scale a group up or down
+depending on certain criteria. For example, if the average CPU utilization of
+all your instances goes above 60%, you may want to scale up a number of
+instances to deal with demand - likewise you might want to scale down if usage
+drops. These criteria are defined in *triggers*.
+
+For example, let's modify our above group to have a maxsize of 8 and define means
+of scaling up based on CPU utilization. We'll say we should scale up if the average
+CPU usage goes above 80% and scale down if it goes below 40%.
+
+>>> from boto.ec2.autoscale import Trigger
+>>> tr = Trigger(name='my_trigger', autoscale_group=ag,
+ measure_name='CPUUtilization', statistic='Average',
+ unit='Percent',
+ dimensions=[('AutoScalingGroupName', ag.name)],
+ period=60, lower_threshold=40,
+ lower_breach_scale_increment='-5',
+ upper_threshold=80,
+ upper_breach_scale_increment='10',
+ breach_duration=360)
+>> conn.create_trigger(tr)
+
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/conf-orig.py
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/conf-orig.py?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/conf-orig.py (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/conf-orig.py Sun Jun 5 08:34:02 2011
@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+#
+# boto documentation build configuration file, created by
+# sphinx-quickstart on Tue Sep 15 13:34:43 2009.
+#
+# This file is execfile()d with the current directory set to its containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys, os
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#sys.path.append(os.path.abspath('.'))
+
+# -- General configuration -----------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be extensions
+# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.todo']
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The encoding of source files.
+#source_encoding = 'utf-8'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'boto'
+copyright = u'2009, Mitch Garnaat'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '1.8'
+# The full version, including alpha/beta/rc tags.
+release = "HEAD" #'1.8d'
+try:
+ import subprocess
+ p = subprocess.Popen(["svn info ../../boto | grep Revision | awk '{print $2}'"], stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True)
+ release = p.stdout.read().strip()
+ print p.stderr.read()
+except:
+ pass
+
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of documents that shouldn't be included in the build.
+#unused_docs = []
+
+# List of directories, relative to source directory, that shouldn't be searched
+# for source files.
+exclude_trees = []
+
+# The reST default role (used for this markup: `text`) to use for all documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+
+# -- Options for HTML output ---------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages. Major themes that come with
+# Sphinx are currently 'default' and 'sphinxdoc'.
+html_theme = 'sphinxdoc'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further. For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+#html_theme_path = []
+
+# The name for this set of Sphinx documents. If None, it defaults to
+# "<project> v<release> documentation".
+html_title = "boto v%s (r%s)" % (version, release)
+
+# A shorter title for the navigation bar. Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_use_modindex = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it. The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = ''
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'botodoc'
+
+
+# -- Options for LaTeX output --------------------------------------------------
+
+# The paper size ('letter' or 'a4').
+#latex_paper_size = 'letter'
+
+# The font size ('10pt', '11pt' or '12pt').
+#latex_font_size = '10pt'
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title, author, documentclass [howto/manual]).
+latex_documents = [
+ ('index', 'boto.tex', u'boto Documentation',
+ u'Mitch Garnaat', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# Additional stuff for the LaTeX preamble.
+#latex_preamble = ''
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_use_modindex = True
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {'http://docs.python.org/': None}
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/documentation.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/documentation.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/documentation.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/documentation.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,59 @@
+.. _documentation:
+
+=======================
+About the Documentation
+=======================
+
+boto's documentation uses the Sphinx__ documentation system, which in turn is
+based on docutils__. The basic idea is that lightly-formatted plain-text
+documentation is transformed into HTML, PDF, and any other output format.
+
+__ http://sphinx.pocoo.org/
+__ http://docutils.sf.net/
+
+To actually build the documentation locally, you'll currently need to install
+Sphinx -- ``easy_install Sphinx`` should do the trick.
+
+Then, building the html is easy; just ``make html`` from the ``docs`` directory.
+
+To get started contributing, you'll want to read the `ReStructuredText
+Primer`__. After that, you'll want to read about the `Sphinx-specific markup`__
+that's used to manage metadata, indexing, and cross-references.
+
+__ http://sphinx.pocoo.org/rest.html
+__ http://sphinx.pocoo.org/markup/
+
+The main thing to keep in mind as you write and edit docs is that the more
+semantic markup you can add the better. So::
+
+ Import ``boto`` to your script...
+
+Isn't nearly as helpful as::
+
+ Add :mod:`boto` to your script...
+
+This is because Sphinx will generate a proper link for the latter, which greatly
+helps readers. There's basically no limit to the amount of useful markup you can
+add.
+
+
+The fabfile
+-----------
+
+There is a Fabric__ file that can be used to build and deploy the documentation
+to a webserver that you ssh access to.
+
+__ http://fabfile.org
+
+To build and deploy::
+
+ cd docs/
+ fab deploy:remote_path='/var/www/folder/whatever' --hosts=user@host
+
+This will get the latest code from subversion, add the revision number to the
+docs conf.py file, call ``make html`` to build the documentation, then it will
+tarball it up and scp up to the host you specified and untarball it in the
+folder you specified creating a symbolic link from the untarballed versioned
+folder to ``{remote_path}/boto-docs``.
+
+
Copied: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ec2_tut.rst (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/doc/ec2_tut.txt)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ec2_tut.rst?p2=incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ec2_tut.rst&p1=incubator/mesos/trunk/third_party/boto-1.8d/doc/ec2_tut.txt&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.8d/doc/ec2_tut.txt (original)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ec2_tut.rst Sun Jun 5 08:34:02 2011
@@ -1,5 +1,8 @@
+.. _ec2_tut:
+
+=======================================
An Introduction to boto's EC2 interface
----------------------------------------
+=======================================
This tutorial focuses on the boto interface to the Elastic Compute Cloud
from Amazon Web Services. This tutorial assumes that you have already
@@ -232,14 +235,9 @@ to the run method are:
min_count - The minimum number of instances to launch.
max_count - The maximum number of instances to launch.
-keypair - Keypair to launch instances with (either a KeyPair object or
- a string with the name of the desired keypair.
-security_groups - A list of security groups to associate with the
- instance. This can either be a list of SecurityGroup
- objects or a list of strings with the names of the
- desired security groups.
-user_data - Data to be made available to the launched instances. This
- should be base64 encoded according to the EC2 documentation.
+keypair - Keypair to launch instances with (either a KeyPair object or a string with the name of the desired keypair.
+security_groups - A list of security groups to associate with the instance. This can either be a list of SecurityGroup objects or a list of strings with the names of the desired security groups.
+user_data - Data to be made available to the launched instances. This should be base64 encoded according to the EC2 documentation.
So, if I wanted to create two instances of the base image and launch them
with my keypair, called gsg-keypair, I would to this:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/elb_tut.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/elb_tut.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/elb_tut.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/elb_tut.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,202 @@
+.. _elb_tut:
+
+==========================================================
+An Introduction to boto's Elastic Load Balancing interface
+==========================================================
+
+This tutorial focuses on the boto interface for Elastic Load Balancing
+from Amazon Web Services. This tutorial assumes that you have already
+downloaded and installed boto, and are familiar with the boto ec2 interface.
+
+Elastic Load Balancing Concepts
+-------------------------------
+Elastic Load Balancing (ELB) is intimately connected with Amazon's Elastic
+Compute Cloud (EC2) service. Using the ELB service allows you to create a load
+balancer - a DNS endpoint and set of ports that distributes incoming requests
+to a set of ec2 instances. The advantages of using a load balancer is that it
+allows you to truly scale up or down a set of backend instances without
+disrupting service. Before the ELB service you had to do this manually by
+launching an EC2 instance and installing load balancer software on it (nginx,
+haproxy, perlbal, etc.) to distribute traffic to other EC2 instances.
+
+Recall that the ec2 service is split into Regions and Availability Zones (AZ).
+At the time of writing, there are two Regions - US and Europe, and each region
+is divided into a number of AZs (for example, us-east-1a, us-east-1b, etc.).
+You can think of AZs as data centers - each runs off a different set of ISP
+backbones and power providers. ELB load balancers can span multiple AZs but
+cannot span multiple regions. That means that if you'd like to create a set of
+instances spanning both the US and Europe Regions you'd have to create two load
+balancers and have some sort of other means of distributing requests between
+the two loadbalancers. An example of this could be using GeoIP techniques to
+choose the correct load balancer, or perhaps DNS round robin. Keep in mind also
+that traffic is distributed equally over all AZs the ELB balancer spans. This
+means you should have an equal number of instances in each AZ if you want to
+equally distribute load amongst all your instances.
+
+Creating a Connection
+---------------------
+The first step in accessing ELB is to create a connection to the service.
+There are two ways to do this in boto. The first is:
+
+>>> from boto.ec2.elb import ELBConnection
+>>> conn = ELBConnection('<aws access key>', '<aws secret key>')
+
+There is also a shortcut function in the boto package, called connect_elb
+that may provide a slightly easier means of creating a connection:
+
+>>> import boto
+>>> conn = boto.connect_elb()
+
+In either case, conn will point to an ELBConnection object which we will
+use throughout the remainder of this tutorial.
+
+A Note About Regions and Endpoints
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Like EC2 the ELB service has a different endpoint for each region. By default
+the US endpoint is used. To choose a specific region, instantiate the
+ELBConnection object with that region's endpoint.
+
+>>> ec2 = boto.connect_elb(host='eu-west-1.elasticloadbalancing.amazonaws.com')
+
+Alternatively, edit your boto.cfg with the default ELB endpoint to use::
+
+ [Boto]
+ elb_endpoint = eu-west-1.elasticloadbalancing.amazonaws.com
+
+Getting Existing Load Balancers
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To retrieve any exiting load balancers:
+
+>>> conn.get_all_load_balancers()
+
+You will get back a list of LoadBalancer objects.
+
+Creating a Load Balancer
+------------------------
+To create a load balancer you need the following:
+ #. The specific **ports and protocols** you want to load balancer over, and what port
+ you want to connect to all instances.
+ #. A **health check** - the ELB concept of a *heart beat* or *ping*. ELB will use this health
+ check to see whether your instances are up or down. If they go down, the load balancer
+ will no longer send requests to them.
+ #. A **list of Availability Zones** you'd like to create your load balancer over.
+
+Ports and Protocols
+^^^^^^^^^^^^^^^^^^^
+An incoming connection to your load balancer will come on one or more ports -
+for example 80 (HTTP) and 443 (HTTPS). Each can be using a protocol -
+currently, the supported protocols are TCP and HTTP. We also need to tell the
+load balancer which port to route connects *to* on each instance. For example,
+to create a load balancer for a website that accepts connections on 80 and 443,
+and that routes connections to port 8080 and 8443 on each instance, you would
+specify that the load balancer ports and protocols are:
+
+ * 80, 8080, HTTP
+ * 443, 8443, TCP
+
+This says that the load balancer will listen on two ports - 80 and 443.
+Connections on 80 will use an HTTP load balancer to forward connections to port
+8080 on instances. Likewise, the load balancer will listen on 443 to forward
+connections to 8443 on each instance using the TCP balancer. We need to
+use TCP for the HTTPS port because it is encrypted at the application
+layer. Of course, we could specify the load balancer use TCP for port 80,
+however specifying HTTP allows you to let ELB handle some work for you -
+for example HTTP header parsing.
+
+
+Configuring a Health Check
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+A health check allows ELB to determine which instances are alive and able to
+respond to requests. A health check is essentially a tuple consisting of:
+
+ * *target*: What to check on an instance. For a TCP check this is comprised of::
+
+ TCP:PORT_TO_CHECK
+
+ Which attempts to open a connection on PORT_TO_CHECK. If the connection opens
+ successfully, that specific instance is deemed healthy, otherwise it is marked
+ temporarily as unhealthy. For HTTP, the situation is slightly different::
+
+ HTTP:PORT_TO_CHECK/RESOURCE
+
+ This means that the health check will connect to the resource /RESOURCE on
+ PORT_TO_CHECK. If an HTTP 200 status is returned the instance is deemed healthy.
+ * *interval*: How often the check is made. This is given in seconds and defaults to 30.
+ The valid range of intervals goes from 5 seconds to 600 seconds.
+ * *timeout*: The number of seconds the load balancer will wait for a check to return a
+ result.
+ * *UnhealthyThreshold*: The number of consecutive failed checks to deem the instance
+ as being dead. The default is 5, and the range of valid values lies from 2 to 10.
+
+The following example creates a health check called *instance_health* that simply checks
+instances every 20 seconds on port 80 over HTTP at the resource /health for 200 successes.
+
+>>> import boto
+>>> from boto.ec2.elb import HealthCheck
+>>> conn = boto.connect_elb()
+>>> hc = HealthCheck('instance_health', interval=20, target='HTTP:8080/health')
+
+Putting It All Together
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Finally, let's create a load balancer in the US region that listens on ports 80 and 443
+and distributes requests to instances on 8080 and 8443 over HTTP and TCP. We want the
+load balancer to span the availability zones *us-east-1a* and *us-east-1b*:
+
+>>> lb = conn.create_load_balancer('my_lb', ['us-east-1a', 'us-east-1b'],
+ [(80, 8080, 'http'), (443, 8443, 'tcp')])
+>>> lb.configure_health_check(hc)
+
+The load balancer has been created. To see where you can actually connect to it, do:
+
+>>> print lb.dns_name
+my_elb-123456789.us-east-1.elb.amazonaws.com
+
+You can then CNAME map a better name, i.e. www.MYWEBSITE.com to the above address.
+
+Adding Instances To a Load Balancer
+-----------------------------------
+
+Now that the load balancer has been created, there are two ways to add instances to it:
+
+ #. Manually, adding each instance in turn.
+ #. Mapping an autoscale group to the load balancer. Please see the Autoscale
+ tutorial for information on how to do this.
+
+Manually Adding and Removing Instances
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Assuming you have a list of instance ids, you can add them to the load balancer
+
+>>> instance_ids = ['i-4f8cf126', 'i-0bb7ca62']
+>>> lb.register_instances(instance_ids)
+
+Keep in mind that these instances should be in Security Groups that match the
+internal ports of the load balancer you just created (for this example, they
+should allow incoming connections on 8080 and 8443).
+
+To remove instances:
+
+>>> lb.degregister_instances(instance_ids)
+
+Modifying Availability Zones for a Load Balancer
+------------------------------------------------
+
+If you wanted to disable one or more zones from an existing load balancer:
+
+>>> lb.disable_zones(['us-east-1a'])
+
+You can then terminate each instance in the disabled zone and then deregister then from your load
+balancer.
+
+To enable zones:
+
+>>> lb.enable_zones(['us-east-1c'])
+
+Deleting a Load Balancer
+------------------------
+
+>>> lb.delete()
+
+
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/index.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/index.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/index.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/index.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,28 @@
+.. _index:
+
+==================
+boto Documentation
+==================
+
+Contents:
+
+.. toctree::
+ :maxdepth: 2
+
+ sqs_tut
+ s3_tut
+ ec2_tut
+ elb_tut
+ autoscale_tut
+ vpc_tut
+ ref/index
+ documentation
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/boto.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/boto.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/boto.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/boto.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,47 @@
+.. _ref-boto:
+
+====
+boto
+====
+
+boto
+----
+
+.. automodule:: boto
+ :members:
+ :undoc-members:
+
+boto.connection
+---------------
+
+.. automodule:: boto.connection
+ :members:
+ :undoc-members:
+
+boto.exception
+--------------
+
+.. automodule:: boto.exception
+ :members:
+ :undoc-members:
+
+boto.handler
+------------
+
+.. automodule:: boto.handler
+ :members:
+ :undoc-members:
+
+boto.resultset
+--------------
+
+.. automodule:: boto.resultset
+ :members:
+ :undoc-members:
+
+boto.utils
+----------
+
+.. automodule:: boto.utils
+ :members:
+ :undoc-members:
Copied: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/cloudfront.rst (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/boto/cloudfront/README.txt)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/cloudfront.rst?p2=incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/cloudfront.rst&p1=incubator/mesos/trunk/third_party/boto-1.8d/boto/cloudfront/README.txt&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.8d/boto/cloudfront/README.txt (original)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/cloudfront.rst Sun Jun 5 08:34:02 2011
@@ -1,5 +1,11 @@
+.. ref-cloudfront
+
+==========
+cloudfront
+==========
+
A Crash Course in CloudFront in Boto
---------------------------------
+------------------------------------
This new boto module provides an interface to Amazon's new Content Service, CloudFront.
@@ -16,7 +22,7 @@ Create an cloudfront connection:
>>> from boto.cloudfront import CloudFrontConnection
>>> c = CloudFrontConnection()
-Create a new Distribution:
+Create a new :class:`boto.cloudfront.distribution.Distribution`:
>>> distro = c.create_distribution(origin='mybucket.s3.amazonaws.com', enabled=False, comment='My new Distribution')
>>> d.domain_name
@@ -35,8 +41,8 @@ u'31b8d9cf-a623-4a28-b062-a91856fac6d0'
False
Note that a new caller reference is created automatically, using
-uuid.uuid4(). The Distribution, DistributionConfig and
-DistributionSummary objects are defined in the aws100.distribution
+uuid.uuid4(). The :class:`boto.cloudfront.distribution.Distribution`, :class:`boto.cloudfront.distribution.DistributionConfig` and
+:class:`boto.cloudfront.distribution.DistributionSummary` objects are defined in the :mod:`boto.cloudfront.distribution`
module.
To get a listing of all current distributions:
@@ -46,9 +52,9 @@ To get a listing of all current distribu
[<boto.cloudfront.distribution.DistributionSummary instance at 0xe8d4e0>,
<boto.cloudfront.distribution.DistributionSummary instance at 0xe8d788>]
-This returns a list of DistributionSummary objects. Note that paging
-is not yet supported! To get a DistributionObject from a
-DistributionSummary object:
+This returns a list of :class:`boto.cloudfront.distribution.DistributionSummary` objects. Note that paging
+is not yet supported! To get a :class:`boto.cloudfront.distribution.DistributionObject` from a
+:class:`boto.cloudfront.distribution.DistributionSummary` object:
>>> ds = rs[1]
>>> distro = ds.get_distribution()
@@ -75,7 +81,28 @@ or
The only attributes that can be updated for a Distribution are
comment, enabled and cnames.
-To delete a Distribution:
+To delete a :class:`boto.cloudfront.distribution.Distribution`:
>>> distro.delete()
+
+boto.cloudfront
+---------------
+
+.. automodule:: boto.cloudfront
+ :members:
+ :undoc-members:
+
+boto.cloudfront.distribution
+----------------------------
+
+.. automodule:: boto.cloudfront.distribution
+ :members:
+ :undoc-members:
+
+boto.cloudfront.exception
+-------------------------
+
+.. automodule:: boto.cloudfront.exception
+ :members:
+ :undoc-members:
\ No newline at end of file
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/contrib.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/contrib.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/contrib.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/contrib.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,32 @@
+.. ref-contrib
+
+=======
+contrib
+=======
+
+boto.contrib
+------------
+
+.. automodule:: boto.contrib
+ :members:
+ :undoc-members:
+
+boto.contrib.m2helpers
+----------------------
+
+.. note::
+
+ This module requires installation of M2Crypto__ in your Python path.
+
+ __ http://sandbox.rulemaker.net/ngps/m2/
+
+.. automodule:: boto.contrib.m2helpers
+ :members:
+ :undoc-members:
+
+boto.contrib.ymlmessage
+-----------------------
+
+.. automodule:: boto.contrib.ymlmessage
+ :members:
+ :undoc-members:
\ No newline at end of file
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/ec2.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/ec2.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/ec2.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/ec2.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,223 @@
+.. ref-ec2
+
+===
+EC2
+===
+
+boto.ec2
+--------
+
+.. automodule:: boto.ec2
+ :members:
+ :undoc-members:
+
+boto.ec2.address
+----------------
+
+.. automodule:: boto.ec2.address
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale
+------------------
+
+.. automodule:: boto.ec2.autoscale
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale.activity
+---------------------------
+
+.. automodule:: boto.ec2.autoscale.activity
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale.group
+------------------------
+
+.. automodule:: boto.ec2.autoscale.group
+ :members:
+ :undoc-members:
+
+
+boto.ec2.autoscale.instance
+---------------------------
+
+.. automodule:: boto.ec2.autoscale.instance
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale.launchconfig
+-------------------------------
+
+.. automodule:: boto.ec2.autoscale.launchconfig
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale.request
+--------------------------
+
+.. automodule:: boto.ec2.autoscale.request
+ :members:
+ :undoc-members:
+
+boto.ec2.autoscale.trigger
+--------------------------
+
+.. automodule:: boto.ec2.autoscale.trigger
+ :members:
+ :undoc-members:
+
+boto.ec2.buyreservation
+-----------------------
+
+.. automodule:: boto.ec2.buyreservation
+ :members:
+ :undoc-members:
+
+boto.ec2.cloudwatch
+-------------------
+
+.. automodule:: boto.ec2.cloudwatch
+ :members:
+ :undoc-members:
+
+boto.ec2.cloudwatch.datapoint
+-----------------------------
+
+.. automodule:: boto.ec2.cloudwatch.datapoint
+ :members:
+ :undoc-members:
+
+boto.ec2.cloudwatch.metric
+--------------------------
+
+.. automodule:: boto.ec2.cloudwatch.metric
+ :members:
+ :undoc-members:
+
+boto.ec2.connection
+-------------------
+
+.. automodule:: boto.ec2.connection
+ :members:
+ :undoc-members:
+
+boto.ec2.ec2object
+------------------
+
+.. automodule:: boto.ec2.ec2object
+ :members:
+ :undoc-members:
+
+boto.ec2.elb
+------------
+
+.. automodule:: boto.ec2.elb
+ :members:
+ :undoc-members:
+
+boto.ec2.elb.healthcheck
+------------------------
+
+.. automodule:: boto.ec2.elb.healthcheck
+ :members:
+ :undoc-members:
+
+boto.ec2.elb.instancestate
+--------------------------
+
+.. automodule:: boto.ec2.elb.instancestate
+ :members:
+ :undoc-members:
+
+boto.ec2.elb.listelement
+------------------------
+
+.. automodule:: boto.ec2.elb.listelement
+ :members:
+ :undoc-members:
+
+boto.ec2.elb.listener
+---------------------
+
+.. automodule:: boto.ec2.elb.listener
+ :members:
+ :undoc-members:
+
+boto.ec2.elb.loadbalancer
+-------------------------
+
+.. automodule:: boto.ec2.elb.loadbalancer
+ :members:
+ :undoc-members:
+
+boto.ec2.image
+--------------
+
+.. automodule:: boto.ec2.image
+ :members:
+ :undoc-members:
+
+boto.ec2.instance
+-----------------
+
+.. automodule:: boto.ec2.instance
+ :members:
+ :undoc-members:
+
+boto.ec2.instanceinfo
+---------------------
+
+.. automodule:: boto.ec2.instanceinfo
+ :members:
+ :undoc-members:
+
+boto.ec2.keypair
+----------------
+
+.. automodule:: boto.ec2.keypair
+ :members:
+ :undoc-members:
+
+boto.ec2.regioninfo
+-------------------
+
+.. automodule:: boto.ec2.regioninfo
+ :members:
+ :undoc-members:
+
+boto.ec2.reservedinstance
+-------------------------
+
+.. automodule:: boto.ec2.reservedinstance
+ :members:
+ :undoc-members:
+
+boto.ec2.securitygroup
+----------------------
+
+.. automodule:: boto.ec2.securitygroup
+ :members:
+ :undoc-members:
+
+boto.ec2.snapshot
+-----------------
+
+.. automodule:: boto.ec2.snapshot
+ :members:
+ :undoc-members:
+
+boto.ec2.volume
+---------------
+
+.. automodule:: boto.ec2.volume
+ :members:
+ :undoc-members:
+
+boto.ec2.zone
+-------------
+
+.. automodule:: boto.ec2.zone
+ :members:
+ :undoc-members:
\ No newline at end of file
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/fps.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/fps.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/fps.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/fps.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,19 @@
+.. ref-fps
+
+===
+fps
+===
+
+boto.fps
+--------
+
+.. automodule:: boto.fps
+ :members:
+ :undoc-members:
+
+boto.fps.connection
+-------------------
+
+.. automodule:: boto.fps.connection
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/index.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/index.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/index.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/index.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,24 @@
+.. _ref-index:
+
+=============
+API Reference
+=============
+
+.. toctree::
+ :maxdepth: 4
+
+ boto
+ cloudfront
+ contrib
+ ec2
+ fps
+ manage
+ mapreduce
+ mashups
+ mturk
+ pyami
+ s3
+ sdb
+ services
+ sqs
+ vpc
\ No newline at end of file
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/manage.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/manage.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/manage.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/manage.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,47 @@
+.. ref-manage
+
+======
+manage
+======
+
+boto.manage
+-----------
+
+.. automodule:: boto.manage
+ :members:
+ :undoc-members:
+
+boto.manage.cmdshell
+--------------------
+
+.. automodule:: boto.manage.cmdshell
+ :members:
+ :undoc-members:
+
+boto.manage.propget
+-------------------
+
+.. automodule:: boto.manage.propget
+ :members:
+ :undoc-members:
+
+boto.manage.server
+------------------
+
+.. automodule:: boto.manage.server
+ :members:
+ :undoc-members:
+
+boto.manage.task
+----------------
+
+.. automodule:: boto.manage.task
+ :members:
+ :undoc-members:
+
+boto.manage.volume
+------------------
+
+.. automodule:: boto.manage.volume
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mapreduce.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mapreduce.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mapreduce.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mapreduce.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,38 @@
+.. ref-mapreduce
+
+=========
+mapreduce
+=========
+
+.. note::
+
+ I am not sure why pdb_delete, pdb_revert, pdb_describe, and pdb_upload are not available for import.
+
+
+boto.mapreduce
+--------------
+
+.. automodule:: boto.mapreduce
+ :members:
+ :undoc-members:
+
+boto.mapreduce.lqs
+------------------
+
+.. automodule:: boto.mapreduce.lqs
+ :members:
+ :undoc-members:
+
+boto.mapreduce.partitiondb
+--------------------------
+
+.. automodule:: boto.mapreduce.partitiondb
+ :members:
+ :undoc-members:
+
+boto.mapreduce.queuetools
+-------------------------
+
+.. automodule:: boto.mapreduce.queuetools
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mashups.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mashups.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mashups.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mashups.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,40 @@
+.. ref-mashups
+
+=======
+mashups
+=======
+
+boto.mashups
+------------
+
+.. automodule:: boto.mashups
+ :members:
+ :undoc-members:
+
+boto.mashups.interactive
+------------------------
+
+.. automodule:: boto.mashups.interactive
+ :members:
+ :undoc-members:
+
+boto.mashups.iobject
+--------------------
+
+.. automodule:: boto.mashups.iobject
+ :members:
+ :undoc-members:
+
+boto.mashups.order
+------------------
+
+.. automodule:: boto.mashups.order
+ :members:
+ :undoc-members:
+
+boto.mashups.server
+-------------------
+
+.. automodule:: boto.mashups.server
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mturk.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mturk.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mturk.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/mturk.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,47 @@
+.. ref-mturk
+
+=====
+mturk
+=====
+
+boto.mturk
+------------
+
+.. automodule:: boto.mturk
+ :members:
+ :undoc-members:
+
+boto.mturk.connection
+---------------------
+
+.. automodule:: boto.mturk.connection
+ :members:
+ :undoc-members:
+
+boto.mturk.notification
+-----------------------
+
+.. automodule:: boto.mturk.notification
+ :members:
+ :undoc-members:
+
+boto.mturk.price
+----------------
+
+.. automodule:: boto.mturk.price
+ :members:
+ :undoc-members:
+
+boto.mturk.qualification
+------------------------
+
+.. automodule:: boto.mturk.qualification
+ :members:
+ :undoc-members:
+
+boto.mturk.question
+-------------------
+
+.. automodule:: boto.mturk.question
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/pyami.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/pyami.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/pyami.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/pyami.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,103 @@
+.. ref-pyami
+
+=====
+pyami
+=====
+
+boto.pyami
+--------------
+
+.. automodule:: boto.pyami
+ :members:
+ :undoc-members:
+
+boto.pyami.bootstrap
+--------------------
+
+.. automodule:: boto.pyami.bootstrap
+ :members:
+ :undoc-members:
+
+boto.pyami.config
+-----------------
+
+.. automodule:: boto.pyami.config
+ :members:
+ :undoc-members:
+
+boto.pyami.copybot
+------------------
+
+.. automodule:: boto.pyami.copybot
+ :members:
+ :undoc-members:
+
+boto.pyami.installers
+---------------------
+
+.. automodule:: boto.pyami.installers
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu
+----------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu.apache
+-----------------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu.apache
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu.ebs
+--------------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu.ebs
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu.installer
+--------------------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu.installer
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu.mysql
+----------------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu.mysql
+ :members:
+ :undoc-members:
+
+boto.pyami.installers.ubuntu.trac
+---------------------------------
+
+.. automodule:: boto.pyami.installers.ubuntu.trac
+ :members:
+ :undoc-members:
+
+boto.pyami.launch_ami
+---------------------
+
+.. automodule:: boto.pyami.launch_ami
+ :members:
+ :undoc-members:
+
+boto.pyami.scriptbase
+---------------------
+
+.. automodule:: boto.pyami.scriptbase
+ :members:
+ :undoc-members:
+
+boto.pyami.startup
+------------------
+
+.. automodule:: boto.pyami.startup
+ :members:
+ :undoc-members:
\ No newline at end of file
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/s3.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/s3.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/s3.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/s3.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,54 @@
+.. ref-s3:
+
+===
+S3
+===
+
+boto.s3.acl
+-----------
+
+.. automodule:: boto.s3.acl
+ :members:
+ :undoc-members:
+
+boto.s3.bucket
+--------------
+
+.. automodule:: boto.s3.bucket
+ :members:
+ :undoc-members:
+
+boto.s3.bucketlistresultset
+---------------------------
+
+.. automodule:: boto.s3.bucketlistresultset
+ :members:
+ :undoc-members:
+
+boto.s3.connection
+------------------
+
+.. automodule:: boto.s3.connection
+ :members:
+ :undoc-members:
+
+boto.s3.key
+-----------
+
+.. automodule:: boto.s3.key
+ :members:
+ :undoc-members:
+
+boto.s3.prefix
+--------------
+
+.. automodule:: boto.s3.prefix
+ :members:
+ :undoc-members:
+
+boto.s3.user
+------------
+
+.. automodule:: boto.s3.user
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sdb.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sdb.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sdb.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sdb.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,144 @@
+.. ref-sdb
+
+===
+sdb
+===
+
+boto.sdb
+--------
+
+.. automodule:: boto.sdb
+ :members:
+ :undoc-members:
+
+boto.sdb.connection
+-------------------
+
+.. automodule:: boto.sdb.connection
+ :members:
+ :undoc-members:
+
+boto.sdb.db
+-----------
+
+.. automodule:: boto.sdb.db
+ :members:
+ :undoc-members:
+
+boto.sdb.db.blob
+----------------
+
+.. automodule:: boto.sdb.db.blob
+ :members:
+ :undoc-members:
+
+boto.sdb.db.key
+---------------
+
+.. automodule:: boto.sdb.db.key
+ :members:
+ :undoc-members:
+
+boto.sdb.db.manager
+-------------------
+
+.. automodule:: boto.sdb.db.manager
+ :members:
+ :undoc-members:
+
+boto.sdb.db.manager.pgmanager
+-----------------------------
+
+.. note::
+
+ This module requires psycopg2__ to be installed in the Python path.
+
+ __ http://initd.org/
+
+.. automodule:: boto.sdb.db.manager.pgmanager
+ :members:
+ :undoc-members:
+
+boto.sdb.db.manager.sdbmanager
+------------------------------
+
+.. automodule:: boto.sdb.db.manager.sdbmanager
+ :members:
+ :undoc-members:
+
+boto.sdb.db.manager.xmlmanager
+------------------------------
+
+.. automodule:: boto.sdb.db.manager.xmlmanager
+ :members:
+ :undoc-members:
+
+boto.sdb.db.model
+-----------------
+
+.. automodule:: boto.sdb.db.model
+ :members:
+ :undoc-members:
+
+boto.sdb.db.property
+--------------------
+
+.. automodule:: boto.sdb.db.property
+ :members:
+ :undoc-members:
+
+boto.sdb.db.query
+-----------------
+
+.. automodule:: boto.sdb.db.query
+ :members:
+ :undoc-members:
+
+boto.sdb.domain
+---------------
+
+.. automodule:: boto.sdb.domain
+ :members:
+ :undoc-members:
+
+boto.sdb.item
+-------------
+
+.. automodule:: boto.sdb.item
+ :members:
+ :undoc-members:
+
+boto.sdb.persist
+----------------
+
+.. automodule:: boto.sdb.persist
+ :members:
+ :undoc-members:
+
+boto.sdb.persist.checker
+------------------------
+
+.. automodule:: boto.sdb.persist.checker
+ :members:
+ :undoc-members:
+
+boto.sdb.persist.object
+-----------------------
+
+.. automodule:: boto.sdb.persist.object
+ :members:
+ :undoc-members:
+
+boto.sdb.persist.property
+-------------------------
+
+.. automodule:: boto.sdb.persist.property
+ :members:
+ :undoc-members:
+
+boto.sdb.queryresultset
+-----------------------
+
+.. automodule:: boto.sdb.queryresultset
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/services.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/services.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/services.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/services.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,61 @@
+.. ref-services
+
+========
+services
+========
+
+boto.services
+-------------
+
+.. automodule:: boto.services
+ :members:
+ :undoc-members:
+
+boto.services.bs
+----------------
+
+.. automodule:: boto.services.bs
+ :members:
+ :undoc-members:
+
+boto.services.message
+---------------------
+
+.. automodule:: boto.services.message
+ :members:
+ :undoc-members:
+
+boto.services.result
+--------------------
+
+.. automodule:: boto.services.result
+ :members:
+ :undoc-members:
+
+boto.services.service
+---------------------
+
+.. automodule:: boto.services.service
+ :members:
+ :undoc-members:
+
+boto.services.servicedef
+------------------------
+
+.. automodule:: boto.services.servicedef
+ :members:
+ :undoc-members:
+
+boto.services.sonofmmm
+----------------------
+
+.. automodule:: boto.services.sonofmmm
+ :members:
+ :undoc-members:
+
+boto.services.submit
+--------------------
+
+.. automodule:: boto.services.submit
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sqs.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sqs.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sqs.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/sqs.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,54 @@
+.. _ref-sqs:
+
+====
+SQS
+====
+
+boto.sqs
+--------
+
+.. automodule:: boto.sqs
+ :members:
+ :undoc-members:
+
+boto.sqs.attributes
+-------------------
+
+.. automodule:: boto.sqs.attributes
+ :members:
+ :undoc-members:
+
+boto.sqs.connection
+-------------------
+
+.. automodule:: boto.sqs.connection
+ :members:
+ :undoc-members:
+
+boto.sqs.jsonmessage
+--------------------
+
+.. automodule:: boto.sqs.jsonmessage
+ :members:
+ :undoc-members:
+
+boto.sqs.message
+----------------
+
+.. automodule:: boto.sqs.message
+ :members:
+ :undoc-members:
+
+boto.sqs.queue
+--------------
+
+.. automodule:: boto.sqs.queue
+ :members:
+ :undoc-members:
+
+boto.sqs.regioninfo
+-------------------
+
+.. automodule:: boto.sqs.regioninfo
+ :members:
+ :undoc-members:
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/vpc.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/vpc.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/vpc.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/ref/vpc.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,54 @@
+.. _ref-vpc:
+
+====
+VPC
+====
+
+boto.vpc
+--------
+
+.. automodule:: boto.vpc
+ :members:
+ :undoc-members:
+
+boto.vpc.customergateway
+------------------------
+
+.. automodule:: boto.vpc.customergateway
+ :members:
+ :undoc-members:
+
+boto.vpc.dhcpoptions
+--------------------
+
+.. automodule:: boto.vpc.dhcpoptions
+ :members:
+ :undoc-members:
+
+boto.vpc.subnet
+---------------
+
+.. automodule:: boto.vpc.subnet
+ :members:
+ :undoc-members:
+
+boto.vpc.vpc
+------------
+
+.. automodule:: boto.vpc.vpc
+ :members:
+ :undoc-members:
+
+boto.vpc.vpnconnection
+----------------------
+
+.. automodule:: boto.vpc.vpnconnection
+ :members:
+ :undoc-members:
+
+boto.vpc.vpngateway
+-------------------
+
+.. automodule:: boto.vpc.vpngateway
+ :members:
+ :undoc-members:
Copied: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/s3_tut.rst (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/doc/s3_tut.txt)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/s3_tut.rst?p2=incubator/mesos/trunk/third_party/boto-1.9b/docs/source/s3_tut.rst&p1=incubator/mesos/trunk/third_party/boto-1.8d/doc/s3_tut.txt&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.8d/doc/s3_tut.txt (original)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/s3_tut.rst Sun Jun 5 08:34:02 2011
@@ -1,5 +1,8 @@
+.. _s3_tut:
+
+======================================
An Introduction to boto's S3 interface
----------------------------------------
+======================================
This tutorial focuses on the boto interface to the Simple Storage Service
from Amazon Web Services. This tutorial assumes that you have already
@@ -34,7 +37,7 @@ In either case, conn will point to an S3
use throughout the remainder of this tutorial.
Creating a Bucket
-----------------
+-----------------
Once you have a connection established with S3, you will probably want to
create a bucket. A bucket is a container used to store key/value pairs
@@ -110,7 +113,7 @@ to and from S3 so you should be able to
any problem.
Listing All Available Buckets
-----------------------------
+-----------------------------
In addition to accessing specific buckets via the create_bucket method
you can also get a list of all available buckets that you have created.
@@ -141,13 +144,10 @@ S3. There are two ways to set the ACL f
2. Use a "canned" access control policy. There are four canned policies
defined:
- a. private: Owner gets FULL_CONTROL. No one else has any access rights.
- b. public-read: Owners gets FULL_CONTROL and the anonymous principal
- is granted READ access.
- c. public-read-write: Owner gets FULL_CONTROL and the anonymous
- principal is granted READ and WRITE access.
- d. authenticated-read: Owner gets FULL_CONTROL and any principal
- authenticated as a registered Amazon S3 user is granted READ access.
+ a. private: Owner gets FULL_CONTROL. No one else has any access rights.
+ b. public-read: Owners gets FULL_CONTROL and the anonymous principal is granted READ access.
+ c. public-read-write: Owner gets FULL_CONTROL and the anonymous principal is granted READ and WRITE access.
+ d. authenticated-read: Owner gets FULL_CONTROL and any principal authenticated as a registered Amazon S3 user is granted READ access.
Currently, boto only supports the second method using canned access control
policies. A future version may allow setting of arbitrary ACL's if there
@@ -205,7 +205,7 @@ with an S3 object. For example:
This code associates two metadata key/value pairs with the Key k. To retrieve
those values later:
->>> k = b.lookup('has_metadata)
+>>> k = b.get_key('has_metadata)
>>> k.get_metadata('meta1')
'This is the first metadata value'
>>> k.get_metadata('meta2')
Copied: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/sqs_tut.rst (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/doc/sqs_tut.txt)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/sqs_tut.rst?p2=incubator/mesos/trunk/third_party/boto-1.9b/docs/source/sqs_tut.rst&p1=incubator/mesos/trunk/third_party/boto-1.8d/doc/sqs_tut.txt&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.8d/doc/sqs_tut.txt (original)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/sqs_tut.rst Sun Jun 5 08:34:02 2011
@@ -1,5 +1,8 @@
+.. _sqs_tut:
+
+=======================================
An Introduction to boto's SQS interface
----------------------------------------
+=======================================
This tutorial focuses on the boto interface to the Simple Queue Service
from Amazon Web Services. This tutorial assumes that you have already
Added: incubator/mesos/trunk/third_party/boto-1.9b/docs/source/vpc_tut.rst
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/docs/source/vpc_tut.rst?rev=1132067&view=auto
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.9b/docs/source/vpc_tut.rst (added)
+++ incubator/mesos/trunk/third_party/boto-1.9b/docs/source/vpc_tut.rst Sun Jun 5 08:34:02 2011
@@ -0,0 +1,88 @@
+.. _ec2_tut:
+
+=======================================
+An Introduction to boto's VPC interface
+=======================================
+
+This tutorial is based on the examples in the Amazon Virtual Private
+Cloud Getting Started Guide (http://docs.amazonwebservices.com/AmazonVPC/latest/GettingStartedGuide/).
+In each example, it tries to show the boto request that correspond to
+the AWS command line tools.
+
+Creating a VPC connection
+-------------------------
+First, we need to create a new VPC connection:
+
+>>> from boto.vpc import VPCConnection
+>>> c = VPCConnection()
+
+To create a VPC
+---------------
+Now that we have a VPC connection, we can create our first VPC.
+
+>>> vpc = c.create_vpc('10.0.0.0/24')
+>>> vpc
+VPC:vpc-6b1fe402
+>>> vpc.id
+u'vpc-6b1fe402'
+>>> vpc.state
+u'pending'
+>>> vpc.cidr_block
+u'10.0.0.0/24'
+>>> vpc.dhcp_options_id
+u'default'
+>>>
+
+To create a subnet
+------------------
+The next step is to create a subnet to associate with your VPC.
+
+>>> subnet = c.create_subnet(vpc.id, '10.0.0.0/25')
+>>> subnet.id
+u'subnet-6a1fe403'
+>>> subnet.state
+u'pending'
+>>> subnet.cidr_block
+u'10.0.0.0/25'
+>>> subnet.available_ip_address_count
+123
+>>> subnet.availability_zone
+u'us-east-1b'
+>>>
+
+To create a customer gateway
+----------------------------
+Next, we create a customer gateway.
+
+>>> cg = c.create_customer_gateway('ipsec.1', '12.1.2.3', 65534)
+>>> cg.id
+u'cgw-b6a247df'
+>>> cg.type
+u'ipsec.1'
+>>> cg.state
+u'available'
+>>> cg.ip_address
+u'12.1.2.3'
+>>> cg.bgp_asn
+u'65534'
+>>>
+
+To create a VPN gateway
+-----------------------
+
+>>> vg = c.create_vpn_gateway('ipsec.1')
+>>> vg.id
+u'vgw-44ad482d'
+>>> vg.type
+u'ipsec.1'
+>>> vg.state
+u'pending'
+>>> vg.availability_zone
+u'us-east-1b'
+>>>
+
+Attaching a VPN Gateway to a VPC
+--------------------------------
+
+>>> vg.attach(vpc.id)
+>>>
Copied: incubator/mesos/trunk/third_party/boto-1.9b/setup.cfg (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/setup.cfg)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/setup.cfg?p2=incubator/mesos/trunk/third_party/boto-1.9b/setup.cfg&p1=incubator/mesos/trunk/third_party/boto-1.8d/setup.cfg&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
(empty)
Copied: incubator/mesos/trunk/third_party/boto-1.9b/setup.py (from r1132066, incubator/mesos/trunk/third_party/boto-1.8d/setup.py)
URL: http://svn.apache.org/viewvc/incubator/mesos/trunk/third_party/boto-1.9b/setup.py?p2=incubator/mesos/trunk/third_party/boto-1.9b/setup.py&p1=incubator/mesos/trunk/third_party/boto-1.8d/setup.py&r1=1132066&r2=1132067&rev=1132067&view=diff
==============================================================================
--- incubator/mesos/trunk/third_party/boto-1.8d/setup.py (original)
+++ incubator/mesos/trunk/third_party/boto-1.9b/setup.py Sun Jun 5 08:34:02 2011
@@ -34,13 +34,14 @@ setup(name = "boto",
long_description="Python interface to Amazon's Web Services.",
author = "Mitch Garnaat",
author_email = "mitch@garnaat.com",
- scripts = ["bin/sdbadmin", "bin/s3put"],
+ scripts = ["bin/sdbadmin", "bin/elbadmin", "bin/s3put", "bin/fetch_file", "bin/launch_instance", 'bin/list_instances', "bin/taskadmin"],
url = "http://code.google.com/p/boto/",
packages = [ 'boto', 'boto.sqs', 'boto.s3',
'boto.ec2', 'boto.ec2.cloudwatch', 'boto.ec2.autoscale', 'boto.ec2.elb',
'boto.sdb', 'boto.sdb.persist', 'boto.sdb.db', 'boto.sdb.db.manager',
- 'boto.mturk', 'boto.pyami', 'boto.mashups', 'boto.contrib',
- 'boto.services', 'boto.tests', 'boto.cloudfront'],
+ 'boto.mturk', 'boto.pyami', 'boto.mashups', 'boto.contrib', 'boto.manage',
+ 'boto.services', 'boto.tests', 'boto.cloudfront', 'boto.rds', 'boto.vpc',
+ 'boto.fps'],
license = 'MIT',
platforms = 'Posix; MacOS X; Windows',
classifiers = [ 'Development Status :: 3 - Alpha',