designate/doc/source/devstack.rst

DevStack

The Designate team maintain a fork of devstack with Designate integration.

Note

This is a WIP. Expect issues!

Instructions

1. Get a clean Ubuntu 12.04 VM. DevStack "takes over". Don't use your desktop!

2. Clone the Designate DevStack fork inside the VM:

   $ git clone https://github.com/moniker-dns/devstack.git
   $ cd devstack

3. Create a localrc config file:

   ADMIN_PASSWORD=password
   MYSQL_PASSWORD=password
   RABBIT_PASSWORD=password
   SERVICE_PASSWORD=password
   SERVICE_TOKEN=tokentoken
   
   # Just the basics to start with!
   ENABLED_SERVICES=rabbit,mysql,key
   
   # Enable core Designate services
   ENABLED_SERVICES+=,designate,designate-api,designate-central
   
   # Optional Designate services
   #ENABLED_SERVICES+=,designate-sink
   #ENABLED_SERVICES+=,designate-agent
   
   # ** Everything below is optional ***
   
   # Enable Horizon with Designate integration (needs nova)
   #ENABLED_SERVICES+=,horizon
   #HORIZON_REPO=git://github.com/moniker-dns/horizon.git
   #HORIZON_BRANCH=designate
   
   # Enable Nova (needs glance)
   #ENABLED_SERVICES+=,n-api,n-crt,n-obj,n-cpu,n-net,n-cond,n-sch
   #IMAGE_URLS+=",https://launchpad.net/cirros/trunk/0.3.0/+download/cirros-0.3.0-x86_64-disk.img"
   
   # Enable Glance
   #ENABLED_SERVICES+=,g-api,g-reg

4. Run DevStack:

   $ ./unstack.sh
   $ ./stack.sh

5. Enter the screen sessions "shell" window:

   $ ./rejoin-stack.sh

   Then press Ctrl+A followed by 0

6. Load credentials into the shell:

   $ source openrc admin admin # For the admin user, admin tenant
   $ source openrc admin demo  # For the admin user, demo tenant
   $ source openrc demo demo   # For the demo user, demo tenant

7. Try out the designate client:

   $ designate domain-create --name example.net. --email kiall@hp.com
   +------------+--------------------------------------+
   | Field      | Value                                |
   +------------+--------------------------------------+
   | name       | example.net.                         |
   | created_at | 2013-07-12T13:36:03.110727           |
   | updated_at | None                                 |
   | id         | 1fb5d17c-efaf-4e3c-aac0-482875d24b3e |
   | ttl        | 3600                                 |
   | serial     | 1373636163                           |
   | email      | kiall@hp.com                         |
   +------------+--------------------------------------+
   
   $ designate record-create 1fb5d17c-efaf-4e3c-aac0-482875d24b3e --type A --name www.example.net. --data 127.0.0.1
   +------------+--------------------------------------+
   | Field      | Value                                |
   +------------+--------------------------------------+
   | name       | www.example.net.                     |
   | data       | 127.0.0.1                            |
   | created_at | 2013-07-12T13:39:51.236025           |
   | updated_at | None                                 |
   | id         | d50c21d0-a13c-48e2-889e-0b9852a05acb |
   | priority   | None                                 |
   | ttl        | None                                 |
   | type       | A                                    |
   | domain_id  | 1fb5d17c-efaf-4e3c-aac0-482875d24b3e |
   +------------+--------------------------------------+
   
   $ designate record-list 1fb5d17c-efaf-4e3c-aac0-482875d24b3e
   +--------------------------------------+------+------------------+
   | id                                   | type | name             |
   +--------------------------------------+------+------------------+
   | d50c21d0-a13c-48e2-889e-0b9852a05acb | A    | www.example.net. |
   +--------------------------------------+------+------------------+
   
   $ designate record-get 1fb5d17c-efaf-4e3c-aac0-482875d24b3e d50c21d0-a13c-48e2-889e-0b9852a05acb
   +------------+--------------------------------------+
   | Field      | Value                                |
   +------------+--------------------------------------+
   | name       | www.example.net.                     |
   | data       | 127.0.0.1                            |
   | created_at | 2013-07-12T13:39:51.000000           |
   | updated_at | None                                 |
   | id         | d50c21d0-a13c-48e2-889e-0b9852a05acb |
   | priority   | None                                 |
   | ttl        | None                                 |
   | type       | A                                    |
   | domain_id  | 1fb5d17c-efaf-4e3c-aac0-482875d24b3e |
   +------------+--------------------------------------+