~juju-qa/ubuntu/trusty/juju/juju-1.25.8

« back to all changes in this revision

Viewing changes to src/github.com/juju/juju/testcharms/charm-repo/bundle/openstack/README.md

  • Committer: Nicholas Skaggs
  • Date: 2016-12-02 18:01:10 UTC
  • Revision ID: nicholas.skaggs@canonical.com-20161202180110-dl1helep8qfebmhx
ImportĀ upstreamĀ 1.25.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
OpenStack Bundle for Juju
 
2
=========================
 
3
 
 
4
Overview
 
5
--------
 
6
 
 
7
This bundle deploys a reference OpenStack architecture including all core projects:
 
8
 
 
9
  - OpenStack Compute
 
10
  - OpenStack Networking (using Open vSwitch plugin)
 
11
  - OpenStack Block Storage (backed with Ceph storage)
 
12
  - OpenStack Image
 
13
  - OpenStack Object Storage
 
14
  - OpenStack Identity
 
15
  - OpenStack Dashboard
 
16
  - OpenStack Telemetry
 
17
  - OpenStack Orchestration
 
18
 
 
19
The charm configuration is an opinioned set for deploying OpenStack for testing on Cloud environments which support nested KVM.  Instance types also need to have ephemeral storage (these block devices are used for Ceph and Swift storage).
 
20
 
 
21
The Ubuntu Server Team use this bundle for testing OpenStack-on-OpenStack.
 
22
 
 
23
Usage
 
24
-----
 
25
 
 
26
Once deployed, the cloud can be accessed either using the OpenStack command line tools or using the OpenStack Dashboard:
 
27
 
 
28
    http://<IP of openstack-dashboard server>/horizon
 
29
 
 
30
The charms configure the 'admin' user with a password of 'openstack' by default.
 
31
 
 
32
The OpenStack cloud deployed is completely clean; the charms don't attempt to configure networking or upload images.  Read the OpenStack User Guide on how to configure your cloud for use:
 
33
 
 
34
    http://docs.openstack.org/user-guide/content/
 
35
 
 
36
Niggles
 
37
-------
 
38
 
 
39
The neutron-gateway service requires a service unit with two network interfaces to provide full functionality; this part of OpenStack provides L3 routing between tenant networks and the rest of the world.  Its possible todo this when testing on OpenStack by adding a second network interface to the neutron-gateway service:
 
40
 
 
41
    nova interface-attach --net-id <UUID for network>  <UUID of instance>
 
42
    juju set neutron-gateway ext-port=eth1
 
43
 
 
44
Note that you will need to be running this bundle on an OpenStack cloud that supports MAC address learning of some description; this includes using OpenStack Havana with the Neutron Open vSwitch plugin.
 
45
 
 
46
For actual OpenStack deployments, this service would reside of a physical server with network ports attached to both the internal network (for communication with nova-compute service units) and the external network (for inbound/outbound network access to/from instances within the cloud).