stackube/install

Setting Up A Multi-nodes Stackube

This page describes how to setup a multi-nodes cluster of Stackube.

Prerequisites

Roles

A stackube deployment is comprised by four kinds of nodes: control, network, compute, storage.

• Control

  • The control node is where openstack/kubernetes/ceph's control-plane will run.
  • At least one and only one node (for now).
  • Minimum hardware requirements:
    • Two network interfaces
      • One is for public network connection, with a public IP.
      • The other one is for private network connection, with a private IP and MTU >= 1600.
    • 8GB main memory
    • 50GB disk space

• Network

  • The network nodes are where neutron l3/lbaas/dhcp agents will run.
  • At least one node.
  • Minimum hardware requirements:
    • Two network interfaces
      • One is as neutron-external-interface. Public IP is not needed.
      • The other one is for private network connection, with a private IP and MTU >= 1600.
    • 8GB main memory
    • 50GB disk space

• Compute

  • The compute nodes are where your workloads will run.
  • At least one node.
  • Minimum hardware requirements:
    • One network interface
      • For private network connection, with a private IP and MTU >= 1600.
    • 8GB main memory
    • 50GB disk space

• Storage

  • The storage nodes are where ceph-osd(s) will run.
  • At least one node.
  • Minimum hardware requirements:
    • One network interface
      • For private network connection, with a private IP and MTU >= 1600.
    • 8GB main memory
    • 50GB disk space

There is no conflict between any two roles. That means, all of the roles could be deployed on the same node(s).

Host OS

For now only CentOS 7.x is supported.

Public IP Pool

A number of public IPs are needed.

Deploy

All instructions below must be done on the control node.

1. SSH To The Control Node, And Become Root

sudo su -

2. Enable Password-Less SSH

The control node needs to ssh to all nodes when deploying.

• Generate SSH keys on the control node. Leave the passphrase empty:

ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.

• Copy the key to each node (including the control node itself):

ssh-copy-id root@NODE_IP

3. Clone Stackube Repo

git clone https://git.openstack.org/openstack/stackube

4. Edit The Config File

cd stackube/install
vim config_example

5. Do The Deploy

bash deploy.sh config_example

If failed, please do remove (as shown below) before deploy again.

Remove

bash remove.sh config_example