Developer Document
=====================================

This page describes how to setup a working development environment that can be used in developing stackube on Ubuntu or CentOS. These instructions assume you're already installed git, golang and python on your host.

=================
Stackube controller
=================

--------
Build
--------

::

  make build

The binary will be placed at:

::

  _output/stackube-controller

--------
Start
--------

::

   ./_output/stackube-controller -v=5 -alsologtostderr=true -logtostderr=true



--------
Test
--------

1. Prepare Tenant and Network

::

  $ cat test-tenant.yaml

  apiVersion: "stackube.kubernetes.io/v1"
  kind: Tenant
  metadata:
    name: test
  spec:
    username: "test"
    password: "password"


  $ cat test-network.yaml

  apiVersion: "stackube.kubernetes.io/v1"
  kind: Network
  metadata:
    name: test-net
    namespace: test
  spec:
    cidr: "192.168.0.0/24"
    gateway: "192.168.0.1"

2. Create new Tenant and its Network in Kubernetes

::

  $ export KUBECONFIG=/etc/kubernetes/admin.conf
  $ kubectl create -f ~/test-tenant.yaml
  $ kubectl create -f ~/test-network.yaml

3. Check the Network and Tenant is created in Neutron by Stackube controller

::

  $ source ~/keystonerc_admin
  $ neutron net-list
  +--------------------------------------+----------------------+----------------------------------+----------------------------------------------------------+
  | id                                   | name                 | tenant_id                        | subnets                                                  |
  +--------------------------------------+----------------------+----------------------------------+----------------------------------------------------------+
  | 421d913a-a269-408a-9765-2360e202ad5b | kube_test_test-net | 915b36add7e34018b7241ab63a193530 | bb446a53-de4d-4546-81fc-8736a9a88e3a 192.168.0.0/24      |

4. Check Network object is created in Kubernetes

::

 $ kubectl get network test-net --namespace=test
  NAME        KIND
  test-net   Network.v1.stackube.kubernetes.io

5. Delete the Network from Kubernetes

::

  $ kubectl delete -f test-network.yaml

6. Check Network in Neutron is also deleted by Stackube controller

::

  $ neutron net-list
  +--------------------------------------+---------+----------------------------------+----------------------------------------------------------+
  | id                                   | name    | tenant_id                        | subnets                                                  |
  +--------------------------------------+---------+----------------------------------+----------------------------------------------------------+