aboutsummaryrefslogtreecommitdiff
path: root/compose/README.md
diff options
context:
space:
mode:
authorIan Main <imain@redhat.com>2015-03-12 13:22:47 -0700
committerIan Main <imain@redhat.com>2015-03-16 12:26:20 -0700
commitdcb607d3690f78209afdf5868dc3158f2a5f4722 (patch)
tree3c7e24e38b33861f746f3feff5fd9ea418a65b2a /compose/README.md
parent4f622797aee1ebc2b09e8fbc67ccc4454c568d16 (diff)
downloadkolla-dcb607d3690f78209afdf5868dc3158f2a5f4722.tar.gz
kolla-dcb607d3690f78209afdf5868dc3158f2a5f4722.zip
Complete docker compose setup.
This change proposes a minimal openstack deployment stood up using docker-compose. Included is a script to generate the necessary environment variables for use by the containers as well as an 'openrc'. There is also a script which demonstrates starting the included services. We have this working locally using patched containers and can start instances with networking etc. However, there are several changes required to various containers that will need to be made to get this working. We are also using Steven Dake's patches to docker-compose to allow the use of pid=host. I propose we either merge this change or build changes on top of this to get a functioning installation. Co-authored-by: Ryan Hallisey <rhallise@redhat.com> Change-Id: I5e6051054d31edf9840c3a22502d4a7963893f29
Diffstat (limited to 'compose/README.md')
-rw-r--r--compose/README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/compose/README.md b/compose/README.md
new file mode 100644
index 000000000..ba0ce74e5
--- /dev/null
+++ b/compose/README.md
@@ -0,0 +1,25 @@
+Docker compose
+==============
+
+These scripts and docker compose files can be used to stand up a simple
+installation of openstack. Running the 'genenv.sh' script creates an
+'openstack.env' suitable for running on a single host system as well as an
+'openrc' to allow access to the installation.
+
+Once you have run that you can either manually start the containers using the
+'docker-compose' command or try the 'start.sh' script which tries to start them
+all in a reasonable order, waiting at key points for services to become
+available. Once stood up you can issue the typical openstack commands to use
+the installation:
+
+```
+# source openrc
+# nova network-create vmnet --fixed-range-v4=10.0.0.0/24 --bridge=br100 --multi-host=T
+# nova secgroup-add-rule default tcp 22 22 0.0.0.0/0
+# nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0
+#
+# nova keypair-add mykey > mykey.pem
+# chmod 600 mykey.pem
+# nova boot --flavor m1.medium --key_name mykey --image puffy_clouds instance_name
+# ssh -i mykey.pem cirros@<ip>
+```