Merge lp:~adam-stokes/landscape-charm/add-conjure-up into lp:~landscape/landscape-charm/trunk

[Adam Stokes]

This adds the proper metadata to make this bundle conjure-up enabled. Additionally, I've added tags to the bundle to add more context to what this bundle provides.

[lp:~adam-stokes/landscape-charm/add-conjure-up]

25. By Adam Stokes on 2016-05-19

add make render output

26. By Adam Stokes on 2016-05-19

merge r24

27. By Adam Stokes on 2016-05-20

Add description to bundle metadata

28. By Adam Stokes on 2016-05-27

Update processing script

Die properly if the services are in error state.

Unmerged revisions

28. By Adam Stokes on 2016-05-27

Update processing script

Die properly if the services are in error state.

27. By Adam Stokes on 2016-05-20

Add description to bundle metadata

26. By Adam Stokes on 2016-05-19

merge r24

25. By Adam Stokes on 2016-05-19

add make render output

24. By Adam Stokes on 2016-05-19

Add conjure-up enablement

23. By Andreas Hasenack on 2016-05-18

Updated charm revisions

22. By Adam Collard on 2016-04-08

Bump us (again) to 16.03 from 15.11 in the bundle [trivial] [r=ack]

21. By David Britton on 2016-04-07

don't use machines in 'scalable' case.

20. By David Britton on 2016-04-07

check in rendered changes to bundles.

19. By David Britton on 2016-04-07

to: needs to be an array in v4 bundles.

=== added file 'Makefile'
--- Makefile	1970-01-01 00:00:00 +0000
+++ Makefile	2016-05-19 19:34:40 +0000
@@ -0,0 +1,18 @@
+compare-charm-store:
+	./charm-store
+
+commit-charm-store:
+	CHARM_STORE_COMMIT=1 ./charm-store
+
+clean:
+	@rm -rf build
+
+render:
+	@./render-bundles
+	
+update-charm-revisions:
+	@./update-charm-revisions \
+		$(EXTRA_UPDATE_ARGUMENTS) \
+		apache2 postgresql juju-gui haproxy rabbitmq-server nfs
+
+.PHONY: clean render commit-charm-store update-charm-revisions compare-charm-store

=== renamed file 'Makefile' => 'Makefile.moved'
=== added file 'README.md'
--- README.md	1970-01-01 00:00:00 +0000
+++ README.md	2016-05-19 19:34:40 +0000
@@ -0,0 +1,28 @@
+Overview
+========
+
+This branch contains the necessary config and instructions for using
+juju-deployer/juju-quickstart to deploy the landscape charm.
+
+Deployment should be straightforward.
+
+Dense Deployment - MAAS
+=======================
+For MAAS where LXCs can be addressed externally, you can deploy to a single
+machine while at the same time making the service scalable in the future:
+
+  juju quickstart u/landscape/landscape-dense-maas/
+
+Dense Deployment - Other
+========================
+For other substrates, use the plain dense deployment which allows your
+landscape server to be fully reachable, but will not allow easy scaling
+should load increase.
+
+  juju quickstart u/landscape/landscape-dense/
+
+Scalable Deployment
+===================
+For a truly scalable deployment, the following stanza should be used.
+
+  juju quickstart u/landscape/landscape-scalable

=== renamed file 'README.md' => 'README.md.moved'
=== added file 'charm-store'
--- charm-store	1970-01-01 00:00:00 +0000
+++ charm-store	2016-05-19 19:34:40 +0000
@@ -0,0 +1,23 @@
+#!/bin/bash -e
+
+COMMIT=${CHARM_STORE_COMMIT:-}
+
+for i in *.yaml; do
+    revno=$(bzr revno)
+    target=$(basename $i .yaml)
+    if [ -e build/$target ]; then
+        echo "build/$target exists, please remove before continuing (make clean)"
+        exit 1
+    fi
+    mkdir -p build
+    bzr co lp:~landscape/charms/bundles/$target/bundle build/$target
+    cp $target.yaml build/$target/bundle.yaml
+    cp README.md build/$target/README.md
+    if [ "$COMMIT" == "" ]; then
+        echo "Diff from Charm Store: $target"
+        (cd build/$target && bzr diff) || /bin/true
+    else
+        echo "Committing to Charm Store: $target"
+        (cd build/$target && bzr commit -m "$COMMIT (stable: r$revno)")
+    fi
+done

=== added directory 'conjure'
=== added file 'conjure/metadata.json'
--- conjure/metadata.json	1970-01-01 00:00:00 +0000
+++ conjure/metadata.json	2016-05-19 19:34:40 +0000
@@ -0,0 +1,5 @@
+{
+    "friendly-name": "OpenStack Autopilot",
+    "description": "The Canonical Distribution - Enterprise OpenStack Install and Management.",
+    "cloud_whitelist": ["maas", "localhost"]
+}

=== added directory 'conjure/steps'
=== added file 'conjure/steps/01_register-autopilot.sh'
--- conjure/steps/01_register-autopilot.sh	1970-01-01 00:00:00 +0000
+++ conjure/steps/01_register-autopilot.sh	2016-05-19 19:34:40 +0000
@@ -0,0 +1,13 @@
+#!/bin/bash
+#
+# Title: Registering against Landscape
+# Description: registers an admin user to login with
+
+. /usr/share/conjure-up/hooklib/common.sh
+
+landscape_exec=$SCRIPTPATH/configure-landscape
+while ! `$landscape_exec --admin-email "[e-mail]" --admin-name "administrator" --system-email "[e-mail]" --maas-host "$MAAS_SERVER" --maas-apikey "$MAAS_OAUTH"`; do sleep 5; done
+
+result_message="Access Autopilot: http://$hostname/account/standalone/openstack l: [e-mail] p: ubuntu123"
+
+exposeResult "$result_message" 0 "true"

=== added file 'conjure/steps/configure-landscape'
--- conjure/steps/configure-landscape	1970-01-01 00:00:00 +0000
+++ conjure/steps/configure-landscape	2016-05-19 19:34:40 +0000
@@ -0,0 +1,210 @@
+#!/usr/bin/env python3
+# -*- mode: python; -*-
+#
+# Copyright 2014 Canonical, Ltd.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This package is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+import sys
+import argparse  # noqa
+import requests  # noqa
+from requests.exceptions import ConnectionError  # noqa
+from requests.packages.urllib3.exceptions import InsecureRequestWarning  # noqa
+import time  # noqa
+import yaml  # noqa
+from urllib.parse import quote, urlparse, urlunparse  # noqa
+import hmac  # noqa
+from hashlib import sha256  # noqa
+from base64 import b64encode  # noqa
+import logging  # noqa
+from subprocess import check_output  # noqa
+
+MAGIC_OK_STRING = 'New user - Landscape'
+LATEST_VERSION = "2011-08-01"
+
+log = logging.getLogger('openstack')
+
+# Disable the insecure request warning
+requests.packages.urllib3.disable_warnings(InsecureRequestWarning)
+
+
+def parse(url):
+    """
+    Split the given URL into the host, port, and path.
+
+    @type url: C{str}
+    @param url: An URL to parse.
+    """
+    lowurl = url.lower()
+    if not lowurl.startswith(("http://", "https://")):
+        raise SyntaxError(
+            "URL must start with 'http://' or 'https://': %s" % (url,))
+    url = url.strip()
+    parsed = urlparse(url)
+    path = urlunparse(("", "") + parsed[2:])
+    host = parsed[1]
+
+    if ":" in host:
+        host, port = host.split(":")
+        try:
+            port = int(port)
+        except ValueError:
+            port = None
+    else:
+        port = None
+
+    return str(host), port, str(path)
+
+
+def run_query(access_key, secret_key, action, params, uri,
+              version=LATEST_VERSION):
+    """Make a low-level query against the Landscape API.
+
+    @param access_key: The user access key.
+    @param secret_key: The user secret key.
+    @param action: The type of methods to call. For example, "GetComputers".
+    @param params: A dictionary of the parameters to pass to the action.
+    @param uri: The root URI of the API service. For example,
+        "https://landscape.canonical.com/".
+    """
+    timestamp = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+    params.update({"access_key_id": access_key,
+                   "action": action,
+                   "signature_version": "2",
+                   "signature_method": "HmacSHA256",
+                   "timestamp": timestamp,
+                   "version": version})
+
+    for key, value in params.items():
+        if isinstance(key, str):
+            params.pop(key)
+            key = key.encode('utf-8')
+        if isinstance(value, str):
+            value = value.encode("utf-8")
+        params[key] = value
+
+    method = "POST"
+    host, port, path = parse(uri)
+    if port is not None:
+        signed_host = "%s:%d" % (host, port)
+    else:
+        signed_host = host
+    if not path:
+        path = "/"
+        uri = "%s/" % uri
+    signed_params = "&".join(
+        "%s=%s" % (quote(key, safe="~"), quote(value, safe="~"))
+        for key, value in sorted(params.items()))
+    to_sign = "%s\n%s\n%s\n%s" % (method, signed_host, path, signed_params)
+    to_sign = to_sign.encode('utf-8')
+    secret_key = secret_key.encode('utf-8')
+    digest = hmac.new(secret_key, to_sign, sha256).digest()
+    signature = b64encode(digest)
+    signed_params += "&signature=%s" % quote(signature)
+    params['signature'] = signature
+    r = requests.post(uri, data=params, verify=False)
+
+    # if we can't talk to landscape correctly, the install should fail.
+    assert r.status_code == 200
+
+    return r
+
+
+def get_landscape_host():
+    """ Assuming landscape has been deployed in landscape-dense-maas form,
+    find the "dns-name" of the landscape web server. """
+    out = check_output('juju status --format yaml', shell=True)
+    juju = yaml.load(out.decode('utf8'))
+
+    try:
+        services = juju['services']
+        haproxy = services['haproxy']['units']['haproxy/0']
+        public_address = haproxy['public-address']
+        return public_address
+    except KeyError:
+        sys.exit(1)
+        # raise Exception("Landscape not found!")
+
+
+# Landscape isn't actually up when juju-deployer exits; the relations take a
+# while to set up and deployer doesn't wait until they're finished (it has
+# no way to, viz. LP #1254766), so we wait until everything is ok.
+def wait_for_landscape(host):
+    while True:
+        try:
+            # Landscape generates a self signed cert for each install.
+            r = requests.get('http://%s/' % host, verify=False)
+            if MAGIC_OK_STRING in r.text:
+                # now do an API call to make sure the API is up (it gives 503
+                # for a while)
+                r = requests.get('http://%s/api/' % host, verify=False)
+                if r.status_code == 200:
+                    log.debug("got status code {} for landscape "
+                              " api".format(r))
+                    break
+        except ConnectionError:
+            log.debug("connection error waiting for landscape")
+            pass
+        time.sleep(10)
+
+
+def register_new_user(host, **kwargs):
+    """ Register a new user. Takes kwargs admin_email admin_name, and
+    system_email. """
+    kwargs['root_url'] = 'https://%s/' % host
+    kwargs['admin_password'] = "ubuntu123"
+
+    res = run_query('anonymous',
+                    'anonymous',
+                    'BootstrapLDS',
+                    kwargs,
+                    'https://{}/api/'.format(host))
+    return res.json()
+
+
+def register_maas(host, key, secret, maas_host, maas_apikey):
+    data = {
+        'endpoint': 'http://{}/MAAS'.format(maas_host),
+        'credentials': maas_apikey
+    }
+
+    run_query(key, secret, 'RegisterMAASRegionController', data,
+              'https://{}/api/'.format(host))
+
+
+def main():
+    parser = argparse.ArgumentParser()
+
+    parser.add_argument("--admin-email", help="the admin (login) e-mail")
+    parser.add_argument("--admin-name", help="administrator's full name")
+    parser.add_argument("--system-email", help="landscape's email address")
+    parser.add_argument("--maas-host", help="the host of the MAAS instance")
+    parser.add_argument("--maas-apikey",
+                        help="the apikey of the MAAS instance")
+
+    args = parser.parse_args()
+    log.debug(args)
+    host = get_landscape_host()
+    wait_for_landscape(host)
+    auth = register_new_user(host, admin_email=args.admin_email,
+                             admin_name=args.admin_name,
+                             system_email=args.system_email)
+
+    register_maas(host, auth['LANDSCAPE_API_KEY'],
+                  auth['LANDSCAPE_API_SECRET'], args.maas_host,
+                  args.maas_apikey)
+    print(host)
+
+if __name__ == '__main__':
+    main()

=== added file 'landscape-dense-maas.yaml'
--- landscape-dense-maas.yaml	1970-01-01 00:00:00 +0000
+++ landscape-dense-maas.yaml	2016-05-19 19:34:40 +0000
@@ -0,0 +1,63 @@
+series: trusty
+services:
+    rabbitmq-server:
+        charm: cs:trusty/rabbitmq-server-43
+        to:
+            - lxc:0
+        num_units: 1
+        annotations:
+            "gui-x": "600"
+            "gui-y": "370"
+    postgresql:
+        charm: cs:trusty/postgresql-40
+        constraints: mem=2048
+        to:
+            - lxc:0
+        num_units: 1
+        options:
+            extra_packages: python-apt postgresql-contrib postgresql-.*-debversion postgresql-plpython-.*
+            max_connections: 500
+            max_prepared_transactions: 500
+        annotations:
+            "gui-x": "600"
+            "gui-y": "120"
+    haproxy:
+        charm: cs:trusty/haproxy-16
+        to:
+            - lxc:0
+        expose: True
+        num_units: 1
+        options:
+            enable_monitoring: True
+            monitoring_allowed_cidr: "0.0.0.0/0"
+            monitoring_password: "haproxy"
+            default_timeouts: "queue 60000, connect 5000, client 120000, server 120000"
+            # Don't deploy default haproxy service on port 80
+            services: ""
+            source: backports
+            ssl_cert: SELFSIGNED
+        annotations:
+            "gui-x": "1200"
+            "gui-y": "120"
+    landscape-server:
+        charm: cs:trusty/landscape-server
+        constraints: mem=2048
+        to:
+            - lxc:0
+        num_units: 1
+        options:
+            source: deb http://ppa.launchpad.net/landscape/16.03/ubuntu trusty main
+            key: 4652B4E6
+        annotations:
+            "gui-x": "950"
+            "gui-y": "120"
+machines:
+    "0": {}
+relations:
+    - [landscape-server, rabbitmq-server]
+    - [landscape-server, haproxy]
+    - ["landscape-server:db", "postgresql:db-admin"]
+tags:
+  - conjure-openstack
+  - autopilot
+  - landscape

=== added file 'landscape-dense.yaml'
--- landscape-dense.yaml	1970-01-01 00:00:00 +0000
+++ landscape-dense.yaml	2016-05-19 19:34:40 +0000
@@ -0,0 +1,59 @@
+series: trusty
+services:
+    rabbitmq-server:
+        charm: cs:trusty/rabbitmq-server-43
+        to:
+            - lxc:0
+        num_units: 1
+        annotations:
+            "gui-x": "600"
+            "gui-y": "370"
+    postgresql:
+        charm: cs:trusty/postgresql-40
+        constraints: mem=2048
+        to:
+            - lxc:0
+        num_units: 1
+        options:
+            extra_packages: python-apt postgresql-contrib postgresql-.*-debversion postgresql-plpython-.*
+            max_connections: 500
+            max_prepared_transactions: 500
+        annotations:
+            "gui-x": "600"
+            "gui-y": "120"
+    haproxy:
+        charm: cs:trusty/haproxy-16
+        to:
+            - 0
+        expose: True
+        num_units: 1
+        options:
+            enable_monitoring: True
+            monitoring_allowed_cidr: "0.0.0.0/0"
+            monitoring_password: "haproxy"
+            default_timeouts: "queue 60000, connect 5000, client 120000, server 120000"
+            # Don't deploy default haproxy service on port 80
+            services: ""
+            source: backports
+            ssl_cert: SELFSIGNED
+        annotations:
+            "gui-x": "1200"
+            "gui-y": "120"
+    landscape-server:
+        charm: cs:trusty/landscape-server
+        constraints: mem=2048
+        to:
+            - lxc:0
+        num_units: 1
+        options:
+            source: deb http://ppa.launchpad.net/landscape/16.03/ubuntu trusty main
+            key: 4652B4E6
+        annotations:
+            "gui-x": "950"
+            "gui-y": "120"
+machines:
+    "0": {}
+relations:
+    - [landscape-server, rabbitmq-server]
+    - [landscape-server, haproxy]
+    - ["landscape-server:db", "postgresql:db-admin"]

=== added file 'landscape-scalable.yaml'
--- landscape-scalable.yaml	1970-01-01 00:00:00 +0000
+++ landscape-scalable.yaml	2016-05-19 19:34:40 +0000
@@ -0,0 +1,49 @@
+series: trusty
+services:
+    rabbitmq-server:
+        charm: cs:trusty/rabbitmq-server-43
+        num_units: 1
+        annotations:
+            "gui-x": "600"
+            "gui-y": "370"
+    postgresql:
+        charm: cs:trusty/postgresql-40
+        constraints: mem=2048
+        num_units: 1
+        options:
+            extra_packages: python-apt postgresql-contrib postgresql-.*-debversion postgresql-plpython-.*
+            max_connections: 500
+            max_prepared_transactions: 500
+        annotations:
+            "gui-x": "600"
+            "gui-y": "120"
+    haproxy:
+        charm: cs:trusty/haproxy-16
+        expose: True
+        num_units: 1
+        options:
+            enable_monitoring: True
+            monitoring_allowed_cidr: "0.0.0.0/0"
+            monitoring_password: "haproxy"
+            default_timeouts: "queue 60000, connect 5000, client 120000, server 120000"
+            # Don't deploy default haproxy service on port 80
+            services: ""
+            source: backports
+            ssl_cert: SELFSIGNED
+        annotations:
+            "gui-x": "1200"
+            "gui-y": "120"
+    landscape-server:
+        charm: cs:trusty/landscape-server
+        constraints: mem=2048
+        num_units: 1
+        options:
+            source: deb http://ppa.launchpad.net/landscape/16.03/ubuntu trusty main
+            key: 4652B4E6
+        annotations:
+            "gui-x": "950"
+            "gui-y": "120"
+relations:
+    - [landscape-server, rabbitmq-server]
+    - [landscape-server, haproxy]
+    - ["landscape-server:db", "postgresql:db-admin"]

=== added file 'landscape-template.jinja2'
--- landscape-template.jinja2	1970-01-01 00:00:00 +0000
+++ landscape-template.jinja2	2016-05-19 19:34:40 +0000
@@ -0,0 +1,99 @@
+series: trusty
+services:
+    rabbitmq-server:
+        charm: cs:trusty/rabbitmq-server-44
+        {% if rabbitmq["to"] %}
+        to:
+            - {{ rabbitmq["to"] }}
+        {% endif %}
+        num_units: 1
+        annotations:
+            "gui-x": "600"
+            "gui-y": "370"
+    postgresql:
+        charm: cs:trusty/postgresql-41
+        {% if postgresql["memory"] %}
+        constraints: mem={{ postgresql["memory"] }}
+        {% endif %}
+        {% if postgresql["to"] %}
+        to:
+            - {{ postgresql["to"] }}
+        {% endif %}
+        num_units: 1
+        options:
+            extra_packages: python-apt postgresql-contrib postgresql-.*-debversion postgresql-plpython-.*
+            max_connections: {{ postgresql.max_connections }}
+            max_prepared_transactions: {{ postgresql.max_connections }}
+            {% if postgresql.manual_tuning %}
+            performance_tuning: manual
+            {% endif %}
+            {% if postgresql.shared_buffers %}
+            shared_buffers: {{ postgresql.shared_buffers }}
+            {% endif %}
+            {% if postgresql.checkpoint_segments %}
+            checkpoint_segments: {{ postgresql.checkpoint_segments }}
+            {% endif %}
+            {% if postgresql.maintenance_work_mem %}
+            maintenance_work_mem: {{ postgresql.maintenance_work_mem }}
+            {% endif %}
+            {% if postgresql.work_mem %}
+            work_mem: {{ postgresql.work_mem }}
+            {% endif %}
+            {% if postgresql.effective_cache_size %}
+            effective_cache_size: {{ postgresql.effective_cache_size }}
+            {% endif %}
+        annotations:
+            "gui-x": "600"
+            "gui-y": "120"
+    haproxy:
+        charm: cs:trusty/haproxy-19
+        {% if haproxy["to"] %}
+        to:
+            - {{ haproxy["to"] }}
+        {% endif %}
+        expose: True
+        num_units: 1
+        options:
+            enable_monitoring: True
+            monitoring_allowed_cidr: "0.0.0.0/0"
+            monitoring_password: "haproxy"
+            default_timeouts: "queue 60000, connect 5000, client 120000, server 120000"
+            # Don't deploy default haproxy service on port 80
+            services: ""
+            source: backports
+            ssl_cert: SELFSIGNED
+        annotations:
+            "gui-x": "1200"
+            "gui-y": "120"
+    landscape-server:
+        {% if landscape["branch"] %}
+        branch: {{ landscape["branch"] }}
+        {% else %}
+        charm: cs:trusty/landscape-server
+        {% endif %}
+        {% if landscape["memory"] %}
+        constraints: mem={{ landscape["memory"] }}
+        {% endif %}
+        {% if landscape["to"] %}
+        to:
+            - {{ landscape["to"] }}
+        {% endif %}
+        num_units: 1
+        options:
+            source: {{ landscape["source"] }}
+            key: {{ landscape["key"] }}
+            {% if landscape["ssl-cert"] %}
+            ssl-cert: {{ landscape["ssl-cert"] }}
+            ssl-key: {{ landscape["ssl-key"] }}
+            {% endif %}
+        annotations:
+            "gui-x": "950"
+            "gui-y": "120"
+{% if landscape["to"] %}
+machines:
+    "0": {}
+{% endif %}
+relations:
+    - [landscape-server, rabbitmq-server]
+    - [landscape-server, haproxy]
+    - ["landscape-server:db", "postgresql:db-admin"]

=== added file 'render-bundles'
--- render-bundles	1970-01-01 00:00:00 +0000
+++ render-bundles	2016-05-19 19:34:40 +0000
@@ -0,0 +1,58 @@
+#!/usr/bin/python3
+
+import os
+
+from jinja2 import FileSystemLoader, Environment
+
+DEFAULTS = {
+    "rabbitmq": {},
+    "postgresql": {
+        "max_connections": 500,
+        "max_prepared_transactions": 500,
+        "memory": 2048},
+    "haproxy": {},
+    "landscape": {
+        "memory": 2048,
+        "source": "deb http://ppa.launchpad.net/landscape/16.03/ubuntu trusty main",
+        "key": "4652B4E6"}
+}
+
+FLAVORS = [
+    # scalable
+    {"name": "scalable"},
+
+    # dense
+    {"name": "dense",
+     "rabbitmq": {
+         "to": "lxc:0"},
+     "postgresql": {
+         "to": "lxc:0"},
+     "haproxy": {
+         "to": "0"},
+     "landscape": {
+         "to": "lxc:0"}},
+
+    # dense-maas
+    {"name": "dense-maas",
+     "rabbitmq": {
+         "to": "lxc:0"},
+     "postgresql": {
+         "to": "lxc:0"},
+     "haproxy": {
+         "to": "lxc:0"},
+     "landscape": {
+         "to": "lxc:0"}},
+]
+
+if __name__ == "__main__":
+    environment = Environment(
+        loader=FileSystemLoader("."), trim_blocks=True, lstrip_blocks=True,
+        keep_trailing_newline=True)
+    template = environment.get_template("landscape-template.jinja2")
+    for flavor in FLAVORS:
+        with open("landscape-%s.yaml" % flavor["name"], "w") as fd:
+            context = DEFAULTS.copy()
+            context["name"] = flavor["name"]
+            for key in DEFAULTS.keys():
+                context[key].update(flavor.get(key, {}))
+            fd.write(template.render(context))

=== added file 'update-charm-revisions'
--- update-charm-revisions	1970-01-01 00:00:00 +0000
+++ update-charm-revisions	2016-05-19 19:34:40 +0000
@@ -0,0 +1,98 @@
+#!/usr/bin/python3
+
+import argparse
+import fileinput
+import re
+import sys
+from urllib.request import urlopen
+from yaml import load
+from glob import glob
+
+
+class Charm(object):
+
+    def __init__(self, charm_name, series):
+        """Create a charm object.
+        @param charm_name: name of charm
+        """
+        reference = "cs:{}/{}".format(series, charm_name)
+        base_url = "https://store.juju.ubuntu.com/charm-info?charms="
+        url = "{}{}".format(base_url, reference)
+        response = urlopen(url)
+        self.charm_data = load(response)[reference]
+        self.name = charm_name
+        if "errors" in self.charm_data:
+            raise IOError("{}: {}".format(
+                charm_name, self.charm_data["errors"]))
+        self.revision = self.charm_data["revision"]
+        self.store_url = "cs:{}/{}-{}".format(series, self.name, self.revision)
+
+
+def _get_charm(charm_name, series):
+    """
+    Small wrapper to try to get the series charm you specify.  Falls back
+    to precise if you specified something else
+    """
+    try:
+        return Charm(charm_name, series)
+    except IOError as e:
+        if series != "precise":
+            try:
+                return Charm(charm_name, series="precise")
+            except IOError as precise_e:
+                raise IOError(
+                    "%s: not found? (even tried precise): {}, {}".format(
+                        charm_name, e, precise_e))
+        raise
+
+
+def replace_in_config(filename, charms, series):
+    """
+    Iterate over each charm, replacing all occurences of old charm store
+    urls with new versions.  Intent is to leave file in a state that can
+    be tested and checked in if successful.
+
+    Look for lines like:
+      charm: cs:trusty/juju-gui-83
+
+    Or:
+      series: trusty
+    """
+    for line in fileinput.input(filename, inplace=1):
+        pattern = "^(\s*)series:\s.*$"
+        line = re.sub(pattern, r"\1series: %s" % series, line)
+        for charm in charms:
+            pattern = "cs:[^/]+/{}-[0-9]+".format(charm.name)
+            line = re.sub(pattern, charm.store_url, line)
+        sys.stdout.write(line)
+
+    print("# Config written, use `bzr diff %s` to see any changes" % filename)
+
+
+def get_options():
+    """Parse and return command line options."""
+    description = "Put new charmstore descriptors into a deployer file."
+    parser = argparse.ArgumentParser(description=description)
+    parser.add_argument("charms", help="List charms to update", nargs='*')
+    parser.add_argument("--series", help="Charm series", default="trusty")
+    return parser.parse_args()
+
+
+def main():
+    options = get_options()
+    charms = []
+    if len(options.charms):
+        print("# Latest upstream versions of charms ({}):".format(
+            options.series))
+    for charm_name in options.charms:
+        charm = _get_charm(charm_name, series=options.series)
+        print("#   {}: {}".format(charm_name, charm.revision))
+        charms.append(charm)
+
+    for filename in glob("*.jinja2"):
+        replace_in_config(filename, charms, series=options.series)
+
+    sys.exit(0)
+
+if __name__ == "__main__":
+    main()