| المنصة/الطريقة | أمر |
|---|
| Operator (Recommended) | kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.27.0/manifests/tigera-operator.yaml |
| Manifest-Based | kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.27.0/manifests/calico.yaml |
| Helm | helm install calico projectcalico/tigera-operator --namespace tigera-operator --create-namespace |
| calicoctl (Linux) | curl -L https://github.com/projectcalico/calico/releases/download/v3.27.0/calicoctl-linux-amd64 -o calicoctl && chmod +x calicoctl && sudo mv calicoctl /usr/local/bin/ |
| calicoctl (macOS) | brew install calicoctl |
| calicoctl (Windows) | Invoke-WebRequest -Uri "https://github.com/projectcalico/calico/releases/download/v3.27.0/calicoctl-windows-amd64.exe" -OutFile "calicoctl.exe" |
| calicoctl as Pod | kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.27.0/manifests/calicoctl.yaml |
| Amazon EKS | kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.27.0/manifests/calico-vxlan.yaml |
| Azure AKS | az aks create --network-plugin azure --network-policy calico |
| أمر | وصف |
|---|
calicoctl version | عرض معلومات إصدار Calico |
calicoctl node status | عرض حالة التوافق BGP والمسارات |
calicoctl get nodes | قائمة جميع العقد التي تعمل بـ Calico |
calicoctl get nodes -o wide | قائمة العقد مع تفاصيل إضافية |
calicoctl get ippools | عرض جميع مجمعات عناوين IP |
calicoctl get ippool default-ipv4-ippool -o yaml | إظهار تكوين مجمع IP المفصّل |
calicoctl get workloadendpoints | قائمة جميع نقاط النهاية للحمولة (pods) |
calicoctl get wep --all-namespaces | قائمة نقاط النهاية للعبء التشغيلي عبر جميع مساحات الأسماء |
calicoctl get networkpolicy | عرض جميع سياسات الشبكة |
calicoctl get networkpolicy -n NAMESPACE | سرد السياسات في مساحة اسم محددة |
calicoctl get globalnetworkpolicy | إظهار سياسات الشبكة العالمية |
calicoctl get profiles | قائمة جميع ملفات Calico |
calicoctl get hostendpoints | عرض تكوينات نقطة نهاية المضيف |
kubectl get pods -n calico-system | تحقق من حالة أنظمة pods الخاصة بـ Calico |
kubectl get installation default -o yaml | عرض تكوين تثبيت Calico |
| أمر | وصف |
|---|
calicoctl apply -f network-policy.yaml | قم بتطبيق سياسة الشبكة من الملف |
calicoctl delete networkpolicy POLICY_NAME -n NAMESPACE | حذف سياسة شبكة محددة |
calicoctl get bgpconfig default -o yaml | عرض تكوين BGP |
calicoctl get bgppeers | قم بسرد جميع تكوينات BGP النظيرة |
calicoctl apply -f bgppeer.yaml | قم بتكوين BGP peering |
calicoctl get felixconfiguration default -o yaml | عرض تكوين Felix (agent) |
calicoctl patch felixconfiguration default --patch='{"spec":{"bpfEnabled":true}}' | تمكين مستوى البيانات eBPF |
calicoctl ipam show | عرض معلومات تخصيص عنوان IP |
calicoctl ipam show --show-blocks | إظهار كتل تخصيص IP التفصيلية |
calicoctl ipam release --ip=IP_ADDRESS | إصدار عنوان IP محدد |
calicoctl datastore migrate export > calico-data.yaml | تصدير مستودع بيانات Calico |
calicoctl datastore migrate import < calico-data.yaml | استيراد مستودع بيانات Calico |
calicoctl get node NODE_NAME -o yaml | احصل على تكوين العقدة التفصيلي |
calicoctl patch ippool default-ipv4-ippool -p '{"spec":{"natOutgoing":true}}' | تمكين NAT لمجموعة IP |
calicoctl convert -f old-policy.yaml -o new-policy.yaml | قم بتحويل السياسة إلى إصدار API الأحدث |
# ~/.calico/calicoctl.cfg
apiVersion: projectcalico.org/v3
kind: CalicoAPIConfig
metadata:
spec:
datastoreType: "kubernetes"
kubeconfig: "/home/user/.kube/config"
```## الاستخدام المتقدم
```bash
export CALICO_DATASTORE_TYPE=kubernetes
export CALICO_KUBECONFIG=~/.kube/config
export CALICO_APICONFIG=/path/to/calicoctl.cfg
```## الإعدادات
```yaml
apiVersion: projectcalico.org/v3
kind: IPPool
metadata:
name: default-ipv4-ippool
spec:
cidr: 192.168.0.0/16
ipipMode: CrossSubnet
natOutgoing: true
disabled: false
blockSize: 26
```### ملف تكوين calicoctl
```yaml
apiVersion: projectcalico.org/v3
kind: BGPConfiguration
metadata:
name: default
spec:
logSeverityScreen: Info
nodeToNodeMeshEnabled: true
asNumber: 64512
serviceClusterIPs:
- cidr: 10.96.0.0/12
```### المتغيرات البيئية
```yaml
apiVersion: projectcalico.org/v3
kind: FelixConfiguration
metadata:
name: default
spec:
logSeverityScreen: Info
reportingInterval: 60s
ipipEnabled: true
ipipMTU: 1440
bpfEnabled: false
wireguardEnabled: false
```### تكوين مجمع IP
```bash
# Create deny-all default policy
cat <<EOF | calicoctl apply -f -
apiVersion: projectcalico.org/v3
kind: NetworkPolicy
metadata:
name: default-deny
namespace: production
spec:
selector: all()
types:
- Ingress
- Egress
EOF
# Verify policy
calicoctl get networkpolicy -n production
```### تكوين BGP
```bash
# Allow frontend to backend communication
cat <<EOF | calicoctl apply -f -
apiVersion: projectcalico.org/v3
kind: NetworkPolicy
metadata:
name: frontend-to-backend
namespace: production
spec:
selector: app == 'frontend'
types:
- Egress
egress:
- action: Allow
destination:
selector: app == 'backend'
ports:
- 8080
EOF
```### تكوين Felix
```bash
# Add BGP peer for Top-of-Rack switch
cat <<EOF | calicoctl apply -f -
apiVersion: projectcalico.org/v3
kind: BGPPeer
metadata:
name: rack1-tor
spec:
node: k8s-node-01
peerIP: 192.168.1.1
asNumber: 64512
EOF
# Verify BGP peering
calicoctl node status
```## حالات الاستخدام الشائعة
```bash
# Enable WireGuard on Felix
calicoctl patch felixconfiguration default --type=merge --patch='{"spec":{"wireguardEnabled":true}}'
# Verify WireGuard status
kubectl get nodes -o yaml | grep wireguard
# Check encryption on specific node
calicoctl get node NODE_NAME -o yaml | grep wireguard
```### حالة الاستخدام 1: رفض جميع حركة المرور للمساحة الاسمية
```bash
# Create global policy to protect Kubernetes nodes
cat <<EOF | calicoctl apply -f -
apiVersion: projectcalico.org/v3
kind: GlobalNetworkPolicy
metadata:
name: host-protection
spec:
selector: has(host-endpoint)
order: 0
ingress:
- action: Allow
protocol: TCP
destination:
ports: [22, 179, 443, 6443]
- action: Deny
egress:
- action: Allow
EOF
```### حالة الاستخدام 2: السماح بحركة المرور بين أغراد محددة
`bpfEnabled: true`### حالة الاستخدام 3: تكوين BGP Peering مع مبدل ToR
`calicoctl node status`### حالة الاستخدام 4: تمكين تشفير WireGuard
`blockSize`### حالة الاستخدام 5: إنشاء سياسة شبكة عامة لحماية المضيف
`order`## أفضل الممارسات
`calicoctl datastore migrate export`- **استخدم سياسات الشبكة مبكرًا**: نفذ سياسات الرفض الافتراضية على مستوى المساحة الاسمية قبل نشر التطبيقات لفرض أمان عديم الثقة من البداية
| مشكلة | حل |
|-------|----------|
| **Pods can't communicate across nodes** | Check BGP peering: `calicoctl node status`. Verify IP pool CIDR doesn't conflict: `calicoctl get ippools` |
| **Network policy not taking effect** | Verify policy selector matches pod labels: `kubectl get pods --show-labels`. Check policy order and types (Ingress/Egress) |
| **High CPU usage on nodes** | Enable eBPF dataplane: `calicoctl patch felixconfiguration default --patch='{"spec":{"bpfEnabled":true}}'` |
| **IP address exhaustion** | Check IP allocation: `calicoctl ipam show --show-blocks`. Increase IP pool size or adjust blockSize |
| **calicoctl commands fail** | Verify datastore config: `echo $CALICO_DATASTORE_TYPE`. Check kubeconfig: `kubectl get nodes` |
| **Calico pods in CrashLoopBackOff** | Check logs: `kubectl logs -n calico-system -l k8s-app=calico-node`. Verify kernel modules: `lsmod | grep ip_tables` |
| **BGP routes not propagating** | Disable node-to-node mesh if using ToR: `calicoctl patch bgpconfig default -p '{"spec":{"nodeToNodeMeshEnabled":false}}'` |
| **MTU issues causing packet loss** | Adjust IPIP MTU: `calicoctl patch felixconfig default -p '{"spec":{"ipipMTU":1440}}'` or disable IPIP |
| **WireGuard encryption not working** | Verify kernel support: `modprobe wireguard && lsmod | grep wireguard`. Check Felix config: `calicoctl get felixconfig default -o yaml` |
| **Workload endpoints not appearing** | Restart calico-node pod: `kubectl delete pod -n calico-system -l k8s-app=calico-node`. Verify CNI config: `cat /etc/cni/net.d/10-calico.conflist` |
## مرجع سريع: أمثلة السياسات
### السماح بحركة مرور DNS
```yaml
apiVersion: projectcalico.org/v3
kind: NetworkPolicy
metadata:
name: allow-dns
namespace: default
spec:
selector: all()
types:
- Egress
egress:
- action: Allow
protocol: UDP
destination:
selector: k8s-app == 'kube-dns'
ports: [53]
السماح بالدخول من مساحة اسم محددة
apiVersion: projectcalico.org/v3
kind: NetworkPolicy
metadata:
name: allow-from-frontend
namespace: backend
spec:
selector: app == 'api'
types:
- Ingress
ingress:
- action: Allow
source:
namespaceSelector: name == 'frontend'
تحديد معدل الطلبات (سياسة عامة)```yaml
apiVersion: projectcalico.org/v3
kind: GlobalNetworkPolicy
metadata:
name: rate-limit-external
spec:
selector: role == ‘public-api’
types:
- Ingress
ingress:
- action: Allow
source:
notNets: [10.0.0.0/8]
metadata:
annotations:
rate-limit: “100”