RETIRED, Calico provides Layer 3 Virtual Networking for Highly Scalable Data Centers
Go to file
Emma Gordon fb7b7a9f10 Remove copyright line from license file
Change-Id: I9f52b82898ecd56f6a9ebb762df00fc5ec43da13
2015-07-07 18:13:48 +01:00
deployment_scripts Add copyright 2015-07-03 20:04:56 +01:00
repositories Create Calico plugin for Fuel 6.1 2015-05-20 14:42:38 +01:00
specs Add copyright 2015-07-03 20:04:56 +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 Add copyright 2015-07-03 20:04:56 +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