mcpField
O
oci

oci

github.com/oracle云与 DevOps904513 次安装3 周前更新
代码仓库

关于 oci

面向 Oracle Cloud Infrastructure 运维与开发的技能集合,涵盖 OKE、Functions、IoT 和 Enterprise AI。内容按任务组织,并强调只读发现以及执行资源变更前的审批。

主要功能

  1. 01OKE 设计与故障排查
  2. 02Functions 部署与诊断
  3. 03IoT 资源和数字孪生工作流
  4. 04Enterprise AI 与治理指南
  5. 05运维操作审批要求

适用场景

  1. 01规划或排查 OKE 集群
  2. 02部署或诊断 OCI Function
  3. 03探索 IoT 数字孪生并发布遥测数据
  4. 04规划受治理的 Enterprise AI Agent

MCP 相关

技能包含 OCI Internet of Things Platform 工作流的可选 MCP 辅助操作,以及使用 MCP 的 OCI Responses API Agent 指南。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/oracle/skills --skill oci

安装后在 Claude Code 中输入/oci确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

enterprise-ai/agent-workflows/
agent-tools.md
hosted-applications.md
responses-api-agents.md
enterprise-ai/agents/
openai.yaml
enterprise-ai/cost/
cost-estimation.md
enterprise-ai/data/
rag-and-search.md
enterprise-ai/governance/
private-endpoints-and-governance.md
enterprise-ai/integrations/
oracle-platform-integrations.md
enterprise-ai/models/
custom-and-imported-models.md
enterprise-ai-models.md
functions/oci-functions-deploy/agents/
openai.yaml
functions/oci-functions-deploy/references/
cidr-sizing.md
functions-vcn-requirements.md
oci-functions-quickstart.md
functions/oci-functions-deploy/scripts/
build_and_deploy.sh
common.sh
configure_context.sh
confirm_gate.sh
discover_state.sh
ensure_app.sh
ensure_network.sh
install_fn_linux.sh
install_missing.sh
preflight_check.sh
run_linux_pkg_install.sh
functions/oci-functions-deploy/tests/
test_skill_contract.sh
functions/oci-functions-troubleshoot/agents/
openai.yaml
functions/oci-functions-troubleshoot/references/
create.md
deploy.md
error-patterns.md

详细介绍

Oracle Cloud Infrastructure 技能

此领域用于提供实用的 Oracle Cloud Infrastructure 指南。目前的内容涵盖 OCI Kubernetes Engine(OKE):集群设计、运维故障排查、Generic VNIC Attachment(GVA)以及 Multus 多接口 Pod 验证。内容还涵盖 OCI Internet of Things Platform 资源发现、数字孪生生命周期工作流、设备发布流程,以及可选的 MCP 辅助操作。还涵盖 OCI Functions 本地部署和以诊断为先的故障排查。此外,还涵盖 Enterprise AI,因为相关工作基于 OCI Generative AI、OCI 网络、IAM、成本估算、托管应用和 OCI 平台集成。

如何使用此领域

  1. 从下面的路由表开始。
  2. 只阅读与用户任务匹配的最精简服务文件或嵌套技能。
  3. 在提出设计或修复建议前,优先参考 Oracle 官方文档并执行实时只读发现命令。
  4. 运行会创建、更新、删除、重启、扩缩、排空或以其他方式更改 OCI 或 Kubernetes 资源的命令前,先征求同意。
  5. OCI 自有的设计决策保留在此处;数据库自有的 SQL、向量和 Select AI 实现细节则转至 db/features/。

目录结构

oci/
├── SKILL.md
├── enterprise-ai/
│   ├── SKILL.md
│   ├── models/
│   ├── agent-workflows/
│   ├── governance/
│   ├── data/
│   ├── cost/
│   └── integrations/
├── functions/
│   ├── oci-functions-deploy/
│   │   ├── SKILL.md
│   │   ├── agents/
│   │   ├── references/
│   │   ├── scripts/
│   │   └── tests/
│   └── oci-functions-troubleshoot/
│       ├── SKILL.md
│       ├── agents/
│       └── references/
├── iot-platform/
│   ├── SKILL.md
│   ├── agents/
│   ├── references/
│   ├── scripts/
│   ├── templates/
│   └── tests/
└── oke/
    ├── cluster-design.md
    ├── troubleshooting.md
    ├── gva-node-pools.md
    ├── multus-multihome.md
    ├── skills/
    ├── scripts/
    ├── agents/
    ├── shared/
    ├── examples/
    └── tests/

类别路由

主题从何处开始
设计或搭建 OKE 集群、Terraform 堆栈或 OCI Resource Manager 堆栈从 oci/oke/cluster-design.md 开始,然后加载 oci/oke/skills/oke-cluster-generator/SKILL.md
排查 OKE 工作负载、Pod、服务、DNS、附加组件、入口、负载均衡器、镜像拉取、存储、Workload Identity 或集群访问问题从 oci/oke/troubleshooting.md 开始,然后加载 oci/oke/skills/oke-troubleshooter/SKILL.md
配置使用 Generic VNIC Attachment 次级 VNIC 配置文件和 Application Resources 的 OKE 托管节点池从 oci/oke/gva-node-pools.md 开始,然后加载 oci/oke/skills/oke-gva-deployer/SKILL.md
在 OKE 上部署或验证 Multus NetworkAttachmentDefinitions 和多接口 Pod从 oci/oke/multus-multihome.md 开始,然后加载 oci/oke/skills/oke-multihome-deployer/SKILL.md
从本地 macOS 或 Linux 工作站部署 OCI Functionoci/functions/oci-functions-deploy/SKILL.md
排查 OCI Functions 的设置、部署、调用或可观测性问题oci/functions/oci-functions-troubleshoot/SKILL.md
OCI IoT 域、域组、数字孪生模型、适配器、实例、关系、原始命令、Data API 访问或 HTTPS 发布流程oci/iot-platform/SKILL.md
OCI Generative AI 模型、自定义/导入模型、端点或私有端点oci/enterprise-ai/SKILL.md
OCI Responses API Agent、工具、记忆、File Search、Code Interpreter、MCP 或 SQL Searchoci/enterprise-ai/SKILL.md
OCI Generative AI 和 OCI Generative AI Agents 成本估算oci/enterprise-ai/cost/cost-estimation.md
OCI Enterprise AI 治理、IAM、API 密钥、OAuth、护栏或 ZPRoci/enterprise-ai/governance/private-endpoints-and-governance.md

关键起始位置

  • oci/oke/cluster-design.md
  • oci/oke/troubleshooting.md
  • oci/oke/gva-node-pools.md
  • oci/oke/multus-multihome.md
  • oci/functions/oci-functions-deploy/SKILL.md
  • oci/functions/oci-functions-troubleshoot/SKILL.md
  • oci/functions/oci-functions-deploy/references/oci-functions-quickstart.md
  • oci/functions/oci-functions-troubleshoot/references/error-patterns.md
  • oci/iot-platform/SKILL.md
  • oci/iot-platform/references/cli-workflows.md
  • oci/iot-platform/references/mcp-optional-use.md
  • oci/enterprise-ai/SKILL.md
  • oci/enterprise-ai/models/enterprise-ai-models.md
  • oci/enterprise-ai/agent-workflows/responses-api-agents.md
  • oci/enterprise-ai/cost/cost-estimation.md
  • oci/enterprise-ai/governance/private-endpoints-and-governance.md

运维工具

OKE 运维技能包含 oci/oke/scripts/ 下的确定性辅助工具,以及 oci/oke/skills/*/scripts/ 下的特定技能辅助脚本。

  • 可使用只读发现和证据工具来收集上下文。
  • 仅生成工具可用于生成清单、命令、Terraform 代码片段或报告。
  • 任何会创建、更新、删除、修补、重启、扩缩、排空、调试、分配 IP、应用清单或以其他方式更改 OCI 或 Kubernetes 资源的工具或命令,都需要先获得用户明确批准。
  • 只有在用户批准执行并完成最后的 CREATE 确认后,才允许 oci/oke/scripts/gva-menu.sh 为 GVA 工作流创建 OKE 节点池。
  • oci/oke/scripts/node-doctor-run.sh 需要在执行前获得批准,因为它会创建临时调试 Pod,并可能在清理期间删除该 Pod。

常见多步骤工作流

任务推荐步骤
规划生产级 OKE 集群oke/cluster-design.md
诊断没有负载均衡器 IP 的 OKE 服务oke/troubleshooting.md
使用特定于工作负载的辅助 VNIC 配置构建节点池oke/gva-node-pools.md -> 如果 Pod 需要多个接口,则参阅 oke/multus-multihome.md
验证启用了 GVA 的节点上的 Multus Pod 网络oke/multus-multihome.md -> 如果问题仍然存在,则参阅 oke/troubleshooting.md
调查 OKE 工作负载对 OCI API 的访问oke/troubleshooting.md
部署本地函数functions/oci-functions-deploy/SKILL.md -> 预检 -> Fn 上下文验证 -> OCIR 身份验证检查 -> 选择应用 -> 搭建脚手架 -> 部署
排查函数部署失败functions/oci-functions-troubleshoot/SKILL.md -> functions/oci-functions-troubleshoot/references/error-patterns.md -> functions/oci-functions-troubleshoot/references/deploy.md
排查函数调用失败functions/oci-functions-troubleshoot/SKILL.md -> functions/oci-functions-troubleshoot/references/invoke.md -> 日志、跟踪、指标和限制
探索或更新 OCI IoT 数字孪生资源iot-platform/SKILL.md -> iot-platform/references/cli-workflows.md -> iot-platform/references/resilience-guidance.md
向 OCI IoT 孪生发布测试遥测数据iot-platform/SKILL.md -> iot-platform/references/cli-workflows.md -> iot-platform/templates/publish-curl.template.sh
构建受治理的企业助手enterprise-ai/SKILL.md -> enterprise-ai/agent-workflows/agent-tools.md -> enterprise-ai/data/rag-and-search.md -> enterprise-ai/governance/private-endpoints-and-governance.md

范围边界

  • 在此领域中保留 OCI 服务、网络、IAM、Agent 托管和成本估算方面的指导。
  • 将 OCI IoT 领域、数字孪生、适配器、设备发布、原始命令和 Data API 工作流转至 oci/iot-platform/。
  • 将 Oracle Database 专属的实现细节转至 db/features/。
  • 将 APEX 制品生成转至 apex/apexlang/。
  • 对于 OCI 服务限制、IAM 动词、端点格式、区域和定价输入,优先参考 Oracle 官方文档,因为这些内容经常变化。

Sources

评论

支持 Markdown