背景

在calico中，有多种网络资源。以v1.6.1为例，网络资源包含：node，bgpPeer，hostEndpoint，workloadEndpoint，ipPool，policy，profile等。

下面我将讲解如何使用calicoctl命令行工具来控制这些网络资源。

用法

create

创建一个网络资源。比如说我们要创建一个“profile” 的网络资源，那么先以json或者yaml的文件格式定义这个profile的属性，然后使用-f参数来指定。例如，属性文件名为profile1.json，其内容为：

{

    "kind": "profile",

    "apiVersion": "v1",

    "metadata": {

      "name": "calico-test",

      "tags": [

        "calico-test"

      ]

    },

    "spec": {

      "ingress": [

        {

          "action": "allow",

          "source": {

            "tag": "calico-test"

          },

          "destination": {}

        }

      ],

      "egress": [

        {

          "action": "allow",

          "source": {},

          "destination": {}

        }

      ]

    }

 }

使用calicoctl命令创建profile：

# calicoctl create -f profile1.json

Successfully created 1 'profile' resource(s)

另外，还可以使用-c选项来指定配置文件。

ps：这里需要注意的是，创建了calico网络之后，使用同一个calico网络的容器之间可以实现网络互通。但如果想让一个外部的节点也可以和这个calico网络互通，那么需要进行一些修改，在profile的spec.ingress中添加一个配置。

{

          "action": "allow",

          "source": {

            "nets": [

              "115.105.115.0/24"

            ]

          },

          "destination": {}

        }

然后，再通过下面会讲到的“calicoctl replace”命令替换profile。这样，ip段位于"115.105.115.0/24"的docker host便可以访问该calico网络下的容器。

get

获取一个网络资源的信息。

这里我们也以上面创建的profile为例。

# calicoctl get profile calico-test -o json

[

  {

    "kind": "profile",

    "apiVersion": "v1",

    "metadata": {

      "name": "calico-test",

      "tags": [

        "calico-test"

      ]

    },

    "spec": {

      "ingress": [

        {

          "action": "allow",

          "source": {

            "tag": "calico-test"

          },

          "destination": {}

        }

      ],

      "egress": [

        {

          "action": "allow",

          "source": {},

          "destination": {}

        }

      ]

    }

  }

]

这里是以json的格式来输出，还可以使用yaml、GoFormat等形式。

replace

替换一个网络资源。修改上述的profile1.json文件中的内容后，直接执行下面命令可以替换网络资源的相关属性。

# calicoctl replace -f profile1.json

Successfully replaced 1 'profile' resource(s)

apply

综合了create和replace命令。没有资源时就创建，有资源时就替换。

delete

删除一个网络资源。

创建替换网络资源时，都是通过文件来创建，而配置文件中都指明了网络资源的类型、属性等。但删除网络资源就简单多了，只需要通过网络资源的类型和名称就可以删除对应的资源。

# calicoctl delete profile calico-test

Successfully deleted 1 'profile' resource(s)

config

管理系统级别和节点级别的配置选项。

该命令下又包含三个子命令：set、unset和get。设置、取消和获取。

具体的设置项包含：logLevel(配置值有none,debug,info,warning,error,critical)，nodeToNodeMesh(on,off)，asNumber(0-4294967295)，ipip(on,off)。

ipam

IP地址管理。

该命令下又包含三个子命令：release和show。其中：

release：释放已经被calico分配的IP；
show：显示分配IP的详细详细。

node

calico节点管理。

该命令下又包含四个子命令：run、status、diags和checksystem。其中：

run命令可用于在该服务器上运行一个calico实例；
status命令可检查整个calico网络的状态；
diags用于手机calico节点的诊断信息；
checksystem命令用于检查改服务器是否可以运行一个calico实例。

我们经常使用run命令来创建一个calico实例，比如：

# calicoctl node run --node-image=calico/node:v2.6.2 --ip=192.168.115.73

Running command to load modules: modprobe -a xt_set ip6_tables

Enabling IPv4 forwarding

Enabling IPv6 forwarding

Increasing conntrack limit

Removing old calico-node container (if running).

Running the following command to start calico-node:

docker run --net=host --privileged --name=calico-node -d --restart=always -e NODENAME=dcos-agent1 -e CALICO_NETWORKING_BACKEND=bird -e CALICO_LIBNETWORK_ENABLED=true -e IP=192.168.115.73 -e ETCD_ENDPOINTS=http://192.168.115.111:2379 -v /var/log/calico:/var/log/calico -v /var/run/calico:/var/run/calico -v /lib/modules:/lib/modules -v /run:/run -v /run/docker/plugins:/run/docker/plugins -v /var/run/docker.sock:/var/run/docker.sock calico/node:v2.6.2

Image may take a short time to download if it is not available locally.

Container started, checking progress logs.

Skipping datastore connection test

Using IPv4 address from environment: IP=109.105.115.73

IPv4 address 109.105.115.73 discovered on interface em1

No AS number configured on node resource, using global value

Using node name: dcos-agent1

Starting libnetwork service

Calico node started successfully

这里，使用了的calico镜像版本为calico/node:v2.6.2，通过日志可以看到其启动calico容器时的具体命令。

此外，“calicoctl node run”有相当多的选项可以使用，可以通过“calicoctl node run --help”来查看。但是，这些选项还不足够覆盖所有的calico自身的选项(如etcd的url等)，我们可以配置/etc/calico/calicoctl.cfg文件来实现。当然，也可以配置到其他文件，再通过-f选项来指定该文件。配置文件的示例如下：

apiVersion: v1

kind: calicoApiConfig

metadata:

spec:

  datastoreType: "etcdv2"

  etcdEndpoints: "http://${etcd-ip1}:2379,http://${etcd-ip2}:2379"

version

展示版本。

选项

-h --help

显示帮助。

-l --log-level=

设置日志级别。日志级别包含：panic，fatal，error，warn，info，debug。默认是fatal级别。

巴特西

calicoctl命令简介

背景

用法