stackube/doc/source/developer.rst

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

# Please replace 10.123.0.x with your own external network
# and remember the id of your created external network
neutron net-create br-ex --router:external=True --shared
neutron subnet-create --ip_version 4 --gateway 10.123.0.1 br-ex 10.123.0.0/16 --allocation-pool start=10.123.0.2,end=10.123.0.200 --name public-subnet

# Create configure file for Stackube
cat >/etc/stackube.conf <<EOF
[Global]
auth-url = https://<your-keystone-ip:port>/identity_admin/v2.0 
username = admin
password = password
tenant-name = admin
region = RegionOne
ext-net-id = <id-of-your-external-network>
EOF

# Start stackube controller
./_output/stackube-controller --v=5

Test

1. Initialize Neutron
2. Prepare Tenant and Network

$ cat test-tenant.yaml

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


# for now network should have the same name as namespace (to enforce 1:1 mapping)
$ cat test-network.yaml

apiVersion: "stackube.kubernetes.io/v1"
kind: Network
metadata:
  name: test
  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                                                  |
+--------------------------------------+---------+----------------------------------+----------------------------------------------------------+