designate/doc/source/devstack.rst

4.6 KiB

DevStack

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

Instructions

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

  2. Clone Designate and DevStack inside the VM:

    $ git clone https://git.openstack.org/openstack/designate.git
    $ git clone https://git.openstack.org/openstack-dev/devstack.git
  3. Install the Designate extension for DevStack:

    $ cd devstack
    $ ../designate/contrib/devstack/install.sh
  4. Create a localrc config file:

    ../../contrib/vagrant/localrc

  5. Run DevStack:

    $ ./stack.sh
  6. Enter the screen sessions "shell" window:

    $ ./rejoin-stack.sh

    Then press Ctrl+A followed by 0

  7. 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
  8. 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 |
    +------------+--------------------------------------+