calico/felix

Project Calico Felix Docker镜像

镜像概述和主要用途

Project Calico是一个开源网络方案，提供纯三层网络连接和分布式防火墙功能。本Docker镜像包含Project Calico的主机守护进程Felix，用于在容器环境中管理工作负载（如VM和容器）的网络连接与安全策略。Felix作为Calico的核心组件，负责在每个主机上执行网络配置和策略 enforcement。

核心功能和特性

• 纯三层网络架构：无需覆盖网络（overlay），直接通过三层路由实现工作负载间通信
• 分布式防火墙：在每个工作负载的入口/出口处强制执行网络策略，支持丰富灵活的策略规则
• 跨平台支持：可与Docker、Kubernetes、Mesos、OpenStack等多种编排平台集成
• 高性能：基于Linux内核路由和iptables，提供接近原生网络性能

使用场景和适用范围

• 容器化应用网络：为Docker、Kubernetes等容器平台提供网络连接和安全隔离
• 混合云环境：统一管理VM和容器的网络策略
• 微服务架构：实现微服务间的细粒度访问控制
• 多租户环境：通过网络策略隔离不同租户的工作负载

使用方法和配置说明

Docker环境运行

Felix可在Docker容器中运行，项目提供docker_build_and_run.sh脚本用于构建和运行镜像：

bash
# 构建并运行Felix Docker容器
./docker_build_and_run.sh

开发与测试环境设置

开发环境准备（Ubuntu）

bash
# 安装依赖
apt-get install git libffi-dev libyajl2 python-dev python-pip
pip install coverage tox virtualenv

# 创建并激活Python虚拟环境
virtualenv env
source env/bin/activate

# 安装Calico开发依赖
pip install -e .

运行单元测试

bash
# 运行特定单元测试
nosetests calico.felix.test.test_selectors

# 从虚拟环境外运行所有单元测试
./run-unit-test.sh --develop

本地运行Felix（需root权限）

bash
# 切换到root用户
sudo -i

# 激活虚拟环境
cd <calico代码目录>
source env/bin/activate

# 以INFO级别日志运行Felix
FELIX_LOGSEVERITYSCREEN=INFO calico-felix

注意：Felix必须以root权限运行，因为需要操作内核路由表和防火墙规则。

其他部署方式

独立bundle包

通过build-pyi-bundle.sh脚本可生成包含Python依赖的独立bundle：

bash
# 构建独立bundle（需Docker环境）
./build-pyi-bundle.sh

生成的bundle位于dist/calico-felix.tgz，部署要求：

• libc 2.12+
• Linux内核2.6.32+（容器支持需3.10+）
• 安装iptables、ipset和conntrack（通常来自conntrack-tools包）

Deb和RPM包

Calico团队为发布版本构建Deb和RPM包，构建过程需通过官方构建服务器，如有自定义打包需求请联系官方支持。

支持与社区

• 社区支持：
  • Slack：calico-users
  • IRC：#calico（freenode.net）
• 商业支持：由Tigera, Inc.提供，详情访问Tigera官网

贡献指南

贡献前请查阅项目根目录下的CONTRIBUTING.md文件，了解贡献流程和规范。社区欢迎个人或组织参与代码贡献。

更多技术文档请访问Project Calico官方文档。