К основному содержанию
скилл CX Codex

networking-management — скилл для Claude Code: OCI-сети

Скилл networking-management помогает проектировать и разбирать проблемы сетей OCI: VCN, маршрутизация, шлюзы, NSG и подсети балансировщиков.

MIT 130 установок ★ 22 обновлён 2026-04-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add acedergren/oci-agent-skills --skill networking-management -a claude-code
Открыть на GitHub

Что делает networking-management

Скилл даёт агенту правила для проектирования сетей OCI, поиска причин проблем с подключением и настройки безопасности VCN. Он разбирает маршруты через Service Gateway и Internet Gateway, ограничения VCN peering, различия Security Lists и Network Security Groups, а также требования к подсетям Load Balancer.

Для архитектуры советует использовать модули OCI Landing Zone Terraform: hub-spoke с DRG, Security Zones, Network Firewall, Service Gateway, NAT Gateway и таблицы маршрутизации. Примеры CLI-команд относятся к OCI, поэтому их нельзя заменять аналогами AWS.

VCN CIDR нельзя изменить после создания, значит размер адресного пространства нужно выбрать до развёртывания. Для Load Balancer нужен CIDR не меньше /24, а у каждой VCN есть неудаляемая таблица маршрутов по умолчанию.

Какие задачи решает

  • спроектировать сеть OCI через модули Terraform
  • найти причину сбоя маршрутизации между VCN
  • настроить доступ к Oracle-сервисам через Service Gateway
  • разнести правила подсети и ресурсов между Security Lists и NSG
  • подобрать CIDR для VCN и подсетей Load Balancer

Примеры запросов агенту

  • Спроектируй сеть OCI через модули OCI Landing Zone Terraform.
  • Проверь, почему VCN-A не может подключиться к VCN-C через VCN-B.
  • Разбери настройки подсети Load Balancer и проверь, хватает ли ей адресов.

Как установить networking-management

1Через Skills CLI (Vercel)

npx skills add acedergren/oci-agent-skills --skill networking-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/networking-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/networking-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о networking-management

Как установить networking-management в Claude Code?

Выполните npx skills add acedergren/oci-agent-skills --skill networking-management -a claude-code, затем проверьте файл ~/.claude/skills/networking-management/SKILL.md.

Что делает networking-management?

Скилл помогает с архитектурой OCI-сетей, маршрутизацией, стоимостью исходящего трафика и безопасностью VCN. Он также объясняет ограничения peering, Security Lists, NSG и подсетей Load Balancer.

Какие платформы поддерживает networking-management?

Скилл рассчитан на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

Исходный текст

SKILL.md · MIT
---
name: networking-management
description: Use when designing OCI networks, troubleshooting connectivity, optimizing egress costs, or configuring VCN security. Covers Service Gateway cost savings, VCN CIDR immutability, Security List vs NSG tradeoffs, VCN peering limitations, and Load Balancer subnet requirements.
license: MIT
metadata:
  author: alexander-cedergren
  version: "2.0.0"
---

# OCI Networking - Expert Knowledge

## 🏗️ IMPORTANT: Use OCI Landing Zone Terraform Modules

### Do NOT Reinvent the Wheel

**✅ Use Official OCI Landing Zone Modules for Network Architecture**

The OCI Landing Zone includes pre-built, battle-tested network topologies:
- Hub-spoke VCN architecture with DRG
- Security Zones and Network Firewall integration
- Service Gateway and NAT Gateway configuration
- VCN peering and routing tables
- Network Security Groups and Security Lists

```hcl
module "landing_zone" {
  source  = "oracle-terraform-modules/landing-zone/oci"
  network_configuration = {
    default_enable_cis_checks = true
    network_configuration_categories = {
      hub = { ... }
      spokes = { ... }
    }
  }
}
```

**Official Resources:**
- [OCI Landing Zone Network Modules](https://github.com/oracle-terraform-modules/terraform-oci-landing-zones)
- [Hub-Spoke Reference Architecture](https://docs.oracle.com/en/solutions/oci-hub-spoke-network/)

---

## ⚠️ OCI CLI/API Knowledge Gap

**You don't know OCI CLI commands or OCI API structure.**

Your training data has limited and outdated knowledge of:
- OCI CLI syntax and parameters (updates monthly)
- OCI API endpoints and request/response formats
- Networking service CLI operations (`oci network vcn`, `oci network subnet`)
- VCN limits, peering constraints, and routing rules
- Latest networking features (DRGv2, Network Firewall)

**When OCI operations are needed:**
1. Use exact CLI commands from this skill's references
2. Do NOT guess OCI networking CLI syntax
3. Do NOT assume AWS VPC patterns work in OCI
4. Load reference files for detailed networking CLI documentation

**What you DO know:**
- General networking concepts (CIDR, routing, subnets)
- Security group and firewall principles
- Load balancing and connectivity patterns

This skill bridges the gap by providing current OCI-specific networking patterns and gotchas.

---

You are an OCI networking expert. This skill provides knowledge Claude lacks: Service Gateway egress savings, VCN CIDR immutability, Security List limits, VCN peering gotchas, and OCI-specific networking anti-patterns.

## NEVER Do This

❌ **NEVER route Oracle service traffic via Internet Gateway (expensive)**
```
Service Gateway routing saves egress costs:

# WRONG - route Object Storage via Internet Gateway
Route: 0.0.0.0/0 → Internet Gateway
Cost: 10 TB to Object Storage = $85/month egress

# RIGHT - route Oracle services via Service Gateway
Route: <oci-services-cidr> → Service Gateway
Cost: 10 TB to Object Storage = $0 (FREE!)

Savings example (database backups to Object Storage):
- Without Service Gateway: 20 TB/month × $0.0085/GB = $170/month
- With Service Gateway: $0/month
- Annual savings: $2,040

Service Gateway supports:
✓ Object Storage (all tiers)
✓ Autonomous Database (for private endpoint ADB)
✓ Oracle Services Network (OSN)
```

**Critical**: Service Gateway egress is FREE, Internet Gateway egress is CHARGED

❌ **NEVER forget VCN CIDR cannot be changed (immutable)**
```
# WRONG - create VCN with /24, plan to expand later
oci network vcn create --cidr-block "10.0.0.0/24"
# Cannot expand to /16 later (OCI limitation!)

# If you run out of IPs:
1. Create new VCN with larger CIDR
2. Migrate all resources (hours of downtime)
3. Update DNS, security rules, route tables
4. Delete old VCN

Migration cost: Hours of downtime, IP address changes, extensive reconfiguration

# RIGHT - plan for growth from day 1
oci network vcn create --cidr-block "10.0.0.0/16"
# Room for 256 /24 subnets, 65,536 IPs total

Best practice: Use /16 for VCNs, /24 for subnets
```

❌ **NEVER exceed 5 Security Lists per subnet (hard limit)**
```
OCI limit: Maximum 5 security lists per subnet

# Problem: Complex app with many tiers
Subnet needs rules for:
- Web traffic (80, 443)
- SSH access
- Monitoring agents
- Database clients
- Logging services
... 10+ security lists needed? IMPOSSIBLE!

# WRONG - try to add 6th security list
oci network subnet update \
  --subnet-id <ocid> \
  --security-list-ids '["<sl1>","<sl2>","<sl3>","<sl4>","<sl5>","<sl6>"]'
# FAILS: "Maximum security lists (5) exceeded"

# RIGHT - use Network Security Groups (NSGs) instead
NSG limits:
- 5 NSGs per resource (same as security lists)
- 120 rules per NSG (vs unlimited in security lists)
- Unlimited NSGs per VCN

Migration strategy:
1. Security Lists: Baseline rules (internet, DNS, ICMP)
2. NSGs: Application-specific rules (app tier → DB tier)
```

**Best practice**: Security Lists for subnet-wide rules, NSGs for resource-specific rules

❌ **NEVER assume VCN peering supports transitive routing**
```
Scenario: VCN-A ↔ VCN-B ↔ VCN-C (peered)

# WRONG assumption: A can reach C via B
VCN-A instance: ping <VCN-C-instance>
# FAILS! Transitive routing NOT supported

# OCI VCN peering is NON-TRANSITIVE:
VCN-A can reach: VCN-B only
VCN-C can reach: VCN-B only
VCN-A CANNOT reach VCN-C

# RIGHT - explicit peering required
Create peering: VCN-A ↔ VCN-C
Now A can reach C directly

Peering types:
1. Local peering: Same region, FREE
2. Remote peering: Cross-region, requires DRG ($0.01/hr)

Cost impact (3-VCN mesh):
- Without transitive: 3 peerings (A-B, B-C, A-C)
- Remote peering: 3 × $7.30/month = $21.90/month
```

❌ **NEVER use /27 or smaller for Load Balancer subnets**
```
Load Balancer subnet requirements:
- Minimum /24 CIDR (256 IPs)
- 2 subnets in different ADs (for HA)
- Each subnet needs space for:
  * LB frontends (1-5 IPs)
  * LB backends (dynamic scaling)
  * Reserved IPs (5-10 per subnet)

# WRONG - /27 subnet for LB
oci network subnet create --cidr-block "10.0.1.0/27"
# Only 32 IPs total (27 usable after OCI reserves 5)
# LB creation FAILS: "Insufficient IP space"

# RIGHT - /24 minimum
oci network subnet create --cidr-block "10.0.1.0/24"
# 256 IPs, room for scaling

Gotcha: LB reserves IPs even when not scaling (future capacity)
```

❌ **NEVER delete default route table (breaks subnets)**
```
Every VCN has a default route table (auto-created):
- Cannot be deleted (while VCN exists)
- Can be modified

# WRONG - try to delete default route table
oci network route-table delete --rt-id <default-rt-ocid>
# FAILS: "Cannot delete default route table"

# Workaround: Create custom route tables for subnets
1. Create new route table
2. Associate subnet with new route table
3. Leave default route table unused (orphaned but exists)
```

❌ **NEVER assume Security Lists are stateless (they're stateful!)**
```
Common confusion: OCI Security Lists vs AWS Security Groups

OCI Security Lists: STATEFUL
- Ingress rule allows TCP 443 → auto-allows response traffic
- No need for explicit egress rule for responses

AWS Security Groups: Also STATEFUL (same behavior)
AWS Network ACLs: STATELESS (different, requires both directions)

# WRONG (from AWS NACL habit): Add both ingress and egress
Security List ingress: Allow TCP 443 from 0.0.0.0/0
Security List egress: Allow TCP 1024-65535 to 0.0.0.0/0  # Unnecessary!

# RIGHT - ingress rule only
Security List ingress: Allow TCP 443 from 0.0.0.0/0
# Response traffic auto-allowed (stateful)
```

## Networking Cost Optimization

### Service Gateway Savings

**Scenario: Database backups to Object Storage**

```
Monthly backup: 30 TB uploaded to Object Storage

Without Service Gateway (via Internet Gateway):
- Route: 0.0.0.0/0 → Internet Gateway
- Egress cost: 30,000 GB × $0.0085/GB = $255/month
- Ingress: FREE (always free in OCI)

With Service Gateway:
- Route: <oci-services-cidr> → Service Gateway
- Egress cost: $0 (FREE!)
- Ingress: FREE

Annual savings: $255 × 12 = $3,060/year
```

**Service Gateway routing example**:
```bash
# Get OCI Services CIDR for your region
oci network service list --all

# Create Service Gateway
oci network service-gateway create \
  --compartment-id <ocid> \
  --vcn-id <vcn-ocid> \
  --services '[{"serviceId":"<all-services-ocid>"}]' \
  --display-name "ServiceGateway"

# Add route in private subnet route table
# Destination: <oci-services-cidr> (e.g., all-phx-services-in-oracle-services-network)
# Target: Service Gateway OCID
```

### FastConnect vs VPN Cost Comparison

```
Scenario: Hybrid cloud connectivity, 500 GB/month data transfer

VPN (Site-to-Site):
- VPN tunnel: $0.05/hr × 730 hrs = $36.50/month
- Data processed: FREE (no per-GB charge)
- Egress: 500 GB × $0.0085/GB = $4.25/month
Total: $40.75/month

FastConnect (1 Gbps):
- Port: $1,100/month (flat rate)
- Data transfer: FREE (unlimited)
Total: $1,100/month

Breakeven: When egress > 126 GB/month, consider FastConnect
Or: When predictable latency required (FastConnect = 5-20ms, VPN = 30-50ms)

VPN use case: Dev/test, <100 GB/month
FastConnect use case: Production, >500 GB/month, low latency
```

## VCN Design Anti-Patterns

**Anti-pattern: Single subnet for all tiers**

```
# WRONG - web, app, DB in one subnet
Subnet: 10.0.1.0/24 (all resources)
Security: Broad security list (many open ports)
Risk: Lateral movement, no segmentation

# RIGHT - subnet per tier
Subnet 1: 10.0.1.0/24 (web tier, public)
Subnet 2: 10.0.2.0/24 (app tier, private)
Subnet 3: 10.0.3.0/24 (DB tier, private)

NSGs:
- Web NSG: Allow 80/443 from internet
- App NSG: Allow 8080 from Web NSG only
- DB NSG: Allow 1521 from App NSG only

Benefits:
✓ Blast radius containment
✓ Granular security
✓ Clear network segmentation
✓ Compliance (PCI-DSS, HIPAA)
```

**Anti-pattern: /28 subnets (too small)**

```
# WRONG - tiny subnets
VCN: 10.0.0.0/16
Subnets: /28 (16 IPs each, 11 usable after OCI reserves 5)

Problem: No room for scaling
- 10 instances = 10 IPs
- Add 2 more instances? No space!
- Must create new subnet, migrate resources

# RIGHT - adequate sizing
VCN: 10.0.0.0/16
Subnets: /24 (256 IPs each, 251 usable)

Sizing guide:
- Small app: /26 (64 IPs, 59 usable)
- Medium app: /24 (256 IPs, 251 usable)
- Large app: /23 (512 IPs, 507 usable)
- Load Balancer: /24 minimum (hard requirement)
```

## VCN Peering Gotchas

**Local Peering** (same region):
```
Cost: FREE
Latency: <1ms (same as within VCN)
Use case: Multi-VCN design (security boundaries)

Setup:
1. Create Local Peering Gateway (LPG) in each VCN
2. Connect LPGs (bidirectional)
3. Add routes in each VCN:
   VCN-A route: <VCN-B-CIDR> → LPG
   VCN-B route: <VCN-A-CIDR> → LPG

Limitation: Same region only (cannot peer Phoenix ↔ Ashburn)
```

**Remote Peering** (cross-region):
```
Cost: $0.01/hr per DRG connection = $7.30/month
Latency: Geography-dependent (Phoenix ↔ Ashburn = ~70ms)
Use case: Multi-region DR, global applications

Setup:
1. Create DRG in each region
2. Attach DRG to VCN (each region)
3. Create Remote Peering Connection (RPC) on each DRG
4. Connect RPCs (cross-region)
5. Add routes in each VCN

Cost example (3 regions interconnected):
- 3 DRG attachments: 3 × $7.30/month = $21.90/month
```

**Transitive routing NOT supported**:
```
VCN-A ↔ VCN-B ↔ On-Premises (via VPN)

# WRONG assumption: A can reach on-premises via B
VCN-A → VCN-B → On-Prem (FAILS!)

# RIGHT - hub-and-spoke with DRG
VCN-A → DRG ← On-Premises
VCN-B → DRG ← On-Premises

DRG acts as router (supports transitive)
All VCNs can reach on-premises
All VCNs can reach each other
```

## Security List vs NSG Decision Matrix

| Use Case | Use Security Lists | Use NSGs |
|----------|-------------------|----------|
| **Subnet-wide baseline** (DNS, NTP, ICMP) | ✓ | |
| **Internet egress** (all resources) | ✓ | |
| **Application tier isolation** (app → DB) | | ✓ |
| **Resource-specific rules** (this DB only) | | ✓ |
| **Complex app** (>5 security lists needed) | | ✓ |
| **Instance-level security** (per-instance rules) | | ✓ |

**Recommended pattern**:
```
1 Security List per subnet (baseline):
- Allow all egress
- Allow ICMP (ping)
- Allow DNS (UDP 53)
- Allow NTP (if needed)

Multiple NSGs per VCN (application):
- Web NSG: Allow 80/443 from internet
- App NSG: Allow 8080 from Web NSG
- DB NSG: Allow 1521 from App NSG
- Monitor NSG: Allow 9090 from management subnet

Assign:
- All instances: Security List (via subnet)
- Web instances: Web NSG
- App instances: App NSG
- DB instances: DB NSG + Monitor NSG
```

## Progressive Loading References

### OCI Networking Reference (Official Oracle Documentation)

**WHEN TO LOAD** [`oci-networking-reference.md`](references/oci-networking-reference.md):
- Need comprehensive VCN and subnet configuration details
- Understanding Security Lists vs NSGs in depth
- Implementing DRG, FastConnect, or VPN configurations
- Troubleshooting complex routing issues
- Need official Oracle networking best practices

**Do NOT load** for:
- Quick CIDR allocation (tables in this skill)
- Basic NSG vs Security List choice (decision tree above)
- Service Gateway cost savings (covered in this skill)

---

## When to Use This Skill

- Network design: VCN planning, subnet sizing, CIDR allocation
- Cost optimization: Service Gateway setup, FastConnect vs VPN
- Security: NSG vs Security List selection, network segmentation
- Troubleshooting: Connectivity issues, routing problems, peering
- High availability: Multi-AD subnet design, Load Balancer requirements
- Hybrid connectivity: VPN, FastConnect, DRG configuration

© alexander-cedergren · MIT · acedergren/oci-agent-skills

Похожие скиллы

Каталог скиллов SKILL.md →
google-cloud-networking-observability официальный google Скилл google-cloud-networking-observability для Claude Code разбирает сетевые логи, метрики и диагностику Google Cloud. Находит причины потерь пакетов и проверяет сетевой путь. CX Codex +1 11 856установок hybrid-cloud-networking Seth Hobson Скилл hybrid-cloud-networking помогает спроектировать связь между локальной инфраструктурой и AWS, Azure, GCP или OCI через VPN и выделенные подключения. CX Codex +1 10 600установок roblox-networking gamedev-skills Скилл roblox-networking для Claude Code, Codex, Cursor и других платформ управляет сетевым взаимодействием клиент-сервер в Roblox и защитой от эксплойтов. CX Codex +1 9 300установок aws-networking aws Скилл aws-networking маршрутизирует сетевые задачи по семи сервисам AWS к нужным специализированным скиллам. Помогает выбрать архитектуру связи или защиты от атак. CX Codex +1 7 000установок gke-networking официальный google Скилл gke-networking планирует и настраивает сетевую часть кластеров GKE: приватные узлы, VPC-native, DNS, egress и Dataplane V2. CX Codex +1 6 551установок ios-networking dpearson2699 Скилл ios-networking для сетевого слоя iOS/macOS на Swift: запросы через URLSession с async/await, разбор ошибок, повторы и пагинация. CX Codex +1 4 700установок

Из того же набора9

monitoring-operations Скилл monitoring-operations для Claude Code и Codex настраивает метрики и алерты OCI Monitoring, разбирает молчащие алерты и пропавшие метрики. CX Codex +1 1 400установок oracle-dba Скилл oracle-dba помогает администрировать Oracle Autonomous Database в OCI: находить проблемные запросы по SQL_ID, предотвращать переплаты за ECPU и настраивать CLI-команды. CX Codex +1 145установок best-practices Скилл best-practices по Oracle Cloud: подсказывает, какой CIDR брать для VCN, почему субнеты должны быть региональными и где Cloud Guard ломает прод. CX Codex +1 121установок compute-management Скилл compute-management по OCI Compute для агента: подбор shape, лимиты, стоимость инстансов и разбор неудачных запусков. CX Codex +1 118установок database-management Скилл database-management по OCI Autonomous Database: какой service name брать в подключении, почему пароль не проходит валидацию и что стоит остановленная база. CX Codex +1 108установок infrastructure-as-code Скилл infrastructure-as-code для Claude Code помогает писать Terraform для OCI и разбирать ошибки провайдера. Он включается при работе с состоянием, стеком Resource Manager или OCI Landing Zones. CX Codex +1 106установок finops-cost-optimization Скилл finops-cost-optimization для Claude Code разбирает расходы на OCI и ищет способы сократить их. Включается при расследовании неожиданных счетов, планировании бюджета и поиске лишних затрат. CX Codex +1 104установок iam-identity-management Скилл iam-identity-management для Claude Code помогает писать политики OCI IAM и разбирать ошибки доступа. Подключается при настройке dynamic groups и интеграции IDCS. CX Codex +1 104установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой