RETIRED, Calico provides Layer 3 Virtual Networking for Highly Scalable Data Centers
Go to file
Emma Gordon b7f0b1cfb1 Update link to Calico code on GitHub for Calico repo move
Change-Id: Icd78b96ce794285872f0f2f223a43d59a251e4c4
2015-07-29 15:37:58 +01:00
deployment_scripts Post Fuel deployment, remove default OpenStack network configuration which doesn't work with Calico. 2015-07-29 15:37:49 +01:00
repositories Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
specs Update link to Calico code on GitHub for Calico repo move 2015-07-29 15:37:58 +01:00
.gitreview Added .gitreview 2015-04-27 12:43:44 +00:00
LICENSE Remove copyright line from license file 2015-07-07 18:13:48 +01:00
README.md Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
environment_config.yaml Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
metadata.yaml Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
pre_build_hook Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
tasks.yaml Post Fuel deployment, remove default OpenStack network configuration which doesn't work with Calico. 2015-07-29 15:37:49 +01:00

README.md

Calico plugin for Mirantis Fuel

Calico provides seamless, scalable, secure Layer 3 Virtual Networking for your Mirantis OpenStack Deployment.

By replacing OpenStacks native networking model, Calico targets deployments where the vast majority of workloads only require L3 connectivity, providing efficient, easy to troubleshoot networking, without the complexity and inefficiency of overlay networking models. Calico does not require any additional nodes or Calico specific management it just works, and gets out of your way!

Limitations:

In the current release, Calico requires a deployment with a single OpenStack controller. This limitation will be lifted in future releases.

Compatible versions:

Mirantis Fuel 6.1

To build the plugin:

  • Install the fuel plugin builder, fpb:

      easy_install pip
    
      pip install fuel-plugin-builder
    
  • Clone the calico plugin repository and run the plugin builder:

      git clone https://github.com/stackforge/fuel-plugin-calico
    
      cd fuel-plugin-calico/
    
      fpb --build .
    
  • Check that the file calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm was created.

To install the plugin:

  • Prepare a clean fuel master node.

  • Copy the plugin onto the fuel master node:

      scp calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm root@<Fuel_Master_Node_IP>:/tmp
    
  • Install the plugin on the fuel master node:

      cd /tmp
    
      fuel plugins --install calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm
    
  • Check the plugin was installed:

      fuel plugins --list
    

User Guide

To deploy a cluster with the Calico plugin, use the Fuel web UI to deploy an OpenStack cluster in the usual way, with the following guidelines:

  • Create a new OpenStack environment, selecting:

    Juno on Ubuntu Trusty

    "Neutron with VLAN segmentation" as the networking setup

  • Under the settings tab, make sure the following options are checked:

    "Assign public network to all nodes"

    "Use Calico Virtual Networking"

  • Under the network tab, configure the 'Public' settings (leaving all of the other sections with their default values). For example (exact values will depend on your setup):

    • IP Range: 172.18.203.60 - 172.18.203.69
      • CIDR: 172.18.203.0/24
      • Use VLAN tagging: No
      • Gateway: 172.18.203.1
    • Floating IP range: 172.18.203.70 - 172.18.203.79
  • Add nodes (for meaningful testing, you will need at least two compute nodes in addition to the controller). Note that, in this release of Calico, only a single controller node is supported.

  • Deploy changes