Integration Guide

This guide explains how to integrate Calico networking and policy on an existing Mesos cluster. These instruction should be followed on each Agent.

Ensure you’ve met the prerequisites before continuing, namely that you have etcd running.

Calico runs as a Docker container on each host. The calicoctl command line tool can be used to launch the calico/node container.

  1. Download the calicoctl binary:

    sudo wget -O /usr/local/bin/calicoctl http://www.projectcalico.org/builds/calicoctl
    sudo chmod +x /usr/local/bin/calicoctl
    
  2. Launch calico/node:

    sudo ETCD_ENDPOINTS=http://$ETCD_IP:$ETCD_PORT calicoctl node run
    

    Note: Ensure you’ve set or replaced $ETCD_IP and $ETCD_PORT to point to your etcd cluster.

    Check that calico/node is now running:

    vagrant@calico-01:~$ docker ps
    CONTAINER ID        IMAGE                        COMMAND             CREATED             STATUS              PORTS               NAMES
    408bd2b9ba53        quay.io/calico/node:master   "start_runit"       3 seconds ago       Up 2 seconds                            calico-node
    

    Furthermore, check that the calico/node container is functioning properly with the following command:

    sudo calicoctl node status
    
  3. Download the Calico CNI plugin to the $NETWORK_CNI_PLUGINS_DIR you configured for Mesos. You may skip this step if you do not plan on using the Unified Containerizer.

    curl -L -o $NETWORK_CNI_PLUGINS_DIR/calico \
        https://github.com/projectcalico/cni-plugin/releases/download/v1.6.0/calico
    curl -L -o $NETWORK_CNI_PLUGINS_DIR/calico \
        https://github.com/projectcalico/cni-plugin/releases/download/v1.6.0/calico-ipam
    chmod +x $NETWORK_CNI_PLUGINS_DIR/calico
    chmod +x $NETWORK_CNI_PLUGINS_DIR/calico-ipam
    
  4. Create a Calico CNI configuration in the $NETWORK_CNI_CONF_DIR you configured for Mesos, replacing http://master.mesos:2379 with etcd’s address:

    cat > $NETWORK_CNI_CONF_DIR/calico.conf <<EOF
    {
       "name": "calico",
       "cniVersion": "0.3.1",
       "type": "calico",
       "ipam": {
           "type": "calico-ipam"
       },
       "etcd_endpoints": "http://master.mesos:2379"
    }
    EOF
    

Next Steps

With Calico Installed, you’re now ready to launch Calico-networked tasks. View the guides on using Calico with Mesos