| Sean M. Collins | 09e550c | 2014-10-21 11:40:08 -0400 | [diff] [blame^] | 1 | `DevStack </>`__ |
| 2 | |
| 3 | - `Overview <overview.html>`__ |
| 4 | - `Changes <changes.html>`__ |
| 5 | - `FAQ <faq.html>`__ |
| 6 | - `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__ |
| 7 | - `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__ |
| 8 | |
| 9 | stackrc DevStack settings |
| 10 | ------------------------- |
| 11 | |
| 12 | ``stackrc`` is the primary configuration file for DevStack. It contains |
| 13 | all of the settings that control the services started and the |
| 14 | repositories used to download the source for those services. ``stackrc`` |
| 15 | sources the ``localrc`` section of ``local.conf`` to perform the default |
| 16 | overrides. |
| 17 | |
| 18 | DATABASE\_TYPE |
| 19 | Select the database backend to use. The default is ``mysql``, |
| 20 | ``postgresql`` is also available. |
| 21 | ENABLED\_SERVICES |
| 22 | Specify which services to launch. These generally correspond to |
| 23 | screen tabs. The default includes: Glance (API and Registry), |
| 24 | Keystone, Nova (API, Certificate, Object Store, Compute, Network, |
| 25 | Scheduler, VNC proxies, Certificate Authentication), Cinder |
| 26 | (Scheduler, API, Volume), Horizon, MySQL, RabbitMQ, Tempest. |
| 27 | |
| 28 | :: |
| 29 | |
| 30 | ENABLED_SERVICES=g-api,g-reg,key,n-api,n-crt,n-obj,n-cpu,n-net,n-cond,cinder,c-sch,c-api,c-vol,n-sch,n-novnc,n-xvnc,n-cauth,horizon,rabbit,tempest,$DATABASE_TYPE |
| 31 | |
| 32 | Other services that are not enabled by default can be enabled in |
| 33 | ``localrc``. For example, to add Swift, use the following service |
| 34 | names: |
| 35 | |
| 36 | :: |
| 37 | |
| 38 | enable_service s-proxy s-object s-container s-account |
| 39 | |
| 40 | A service can similarly be disabled: |
| 41 | |
| 42 | :: |
| 43 | |
| 44 | disable_service horizon |
| 45 | |
| 46 | Service Repos |
| 47 | The Git repositories used to check out the source for each service |
| 48 | are controlled by a pair of variables set for each service. |
| 49 | ``*_REPO`` points to the repository and ``*_BRANCH`` selects which |
| 50 | branch to check out. These may be overridden in ``local.conf`` to |
| 51 | pull source from a different repo for testing, such as a Gerrit |
| 52 | branch proposal. ``GIT_BASE`` points to the primary repository |
| 53 | server. |
| 54 | |
| 55 | :: |
| 56 | |
| 57 | NOVA_REPO=$GIT_BASE/openstack/nova.git |
| 58 | NOVA_BRANCH=master |
| 59 | |
| 60 | To pull a branch directly from Gerrit, get the repo and branch from |
| 61 | the Gerrit review page: |
| 62 | |
| 63 | :: |
| 64 | |
| 65 | git fetch https://review.openstack.org/p/openstack/nova refs/changes/50/5050/1 && git checkout FETCH_HEAD |
| 66 | |
| 67 | The repo is the stanza following ``fetch`` and the branch is the |
| 68 | stanza following that: |
| 69 | |
| 70 | :: |
| 71 | |
| 72 | NOVA_REPO=https://review.openstack.org/p/openstack/nova |
| 73 | NOVA_BRANCH=refs/changes/50/5050/1 |
| 74 | |
| 75 | © Openstack Foundation 2011-2014 — An |
| 76 | `OpenStack <https://www.openstack.org/>`__ |
| 77 | `program <https://wiki.openstack.org/wiki/Programs>`__ |