Integration Guide
This guide explains the components necessary to install Calico on Mesos for integrating with custom configuration management. To install Calico in Mesos, no changes are needed on any Mesos Master. Adding Calico to a Mesos cluster only requires modifications to 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.
-
Download the calicoctl binary:
sudo wget -O /usr/local/bin/calicoctl https://github.com/projectcalico/calicoctl/releases/download/v1.0.2/calicoctl sudo chmod +x /usr/local/bin/calicoctl
-
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 calico/node:v1.0.2 "start_runit" About an hour ago Up About an hour calico-node
Furthermore, check that the
calico/node
container is functioning properly with the following command:sudo calicoctl node status
-
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/calico-cni/releases/download/v1.5.6/calico curl -L -o $NETWORK_CNI_PLUGINS_DIR/calico-ipam \ https://github.com/projectcalico/calico-cni/releases/download/v1.5.6/calico-ipam chmod +x $NETWORK_CNI_PLUGINS_DIR/calico chmod +x $NETWORK_CNI_PLUGINS_DIR/calico-ipam
Next Steps
With Calico Installed, you’re now ready to launch Calico-networked tasks. View the guide relevant to your workloads: