关于 oci
面向 Oracle Cloud Infrastructure 运维与开发的技能集合,涵盖 OKE、Functions、IoT 和 Enterprise AI。内容按任务组织,并强调只读发现以及执行资源变更前的审批。
主要功能
- 01OKE 设计与故障排查
- 02Functions 部署与诊断
- 03IoT 资源和数字孪生工作流
- 04Enterprise AI 与治理指南
- 05运维操作审批要求
适用场景
- 01规划或排查 OKE 集群
- 02部署或诊断 OCI Function
- 03探索 IoT 数字孪生并发布遥测数据
- 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.mdhosted-applications.mdresponses-api-agents.mdenterprise-ai/agents/openai.yamlenterprise-ai/cost/cost-estimation.mdenterprise-ai/data/rag-and-search.mdenterprise-ai/governance/private-endpoints-and-governance.mdenterprise-ai/integrations/oracle-platform-integrations.mdenterprise-ai/models/custom-and-imported-models.mdenterprise-ai-models.mdfunctions/oci-functions-deploy/agents/openai.yamlfunctions/oci-functions-deploy/references/cidr-sizing.mdfunctions-vcn-requirements.mdoci-functions-quickstart.mdfunctions/oci-functions-deploy/scripts/build_and_deploy.shcommon.shconfigure_context.shconfirm_gate.shdiscover_state.shensure_app.shensure_network.shinstall_fn_linux.shinstall_missing.shpreflight_check.shrun_linux_pkg_install.shfunctions/oci-functions-deploy/tests/test_skill_contract.shfunctions/oci-functions-troubleshoot/agents/openai.yamlfunctions/oci-functions-troubleshoot/references/create.mddeploy.mderror-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 平台集成。
如何使用此领域
- 从下面的路由表开始。
- 只阅读与用户任务匹配的最精简服务文件或嵌套技能。
- 在提出设计或修复建议前,优先参考 Oracle 官方文档并执行实时只读发现命令。
- 运行会创建、更新、删除、重启、扩缩、排空或以其他方式更改 OCI 或 Kubernetes 资源的命令前,先征求同意。
- 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 Function | oci/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 Search | oci/enterprise-ai/SKILL.md |
| OCI Generative AI 和 OCI Generative AI Agents 成本估算 | oci/enterprise-ai/cost/cost-estimation.md |
| OCI Enterprise AI 治理、IAM、API 密钥、OAuth、护栏或 ZPR | oci/enterprise-ai/governance/private-endpoints-and-governance.md |
关键起始位置
oci/oke/cluster-design.mdoci/oke/troubleshooting.mdoci/oke/gva-node-pools.mdoci/oke/multus-multihome.mdoci/functions/oci-functions-deploy/SKILL.mdoci/functions/oci-functions-troubleshoot/SKILL.mdoci/functions/oci-functions-deploy/references/oci-functions-quickstart.mdoci/functions/oci-functions-troubleshoot/references/error-patterns.mdoci/iot-platform/SKILL.mdoci/iot-platform/references/cli-workflows.mdoci/iot-platform/references/mcp-optional-use.mdoci/enterprise-ai/SKILL.mdoci/enterprise-ai/models/enterprise-ai-models.mdoci/enterprise-ai/agent-workflows/responses-api-agents.mdoci/enterprise-ai/cost/cost-estimation.mdoci/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
- https://docs.oracle.com/en-us/iaas/Content/ContEng/home.htm
- https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengAttaching_Multiple_VNICs.htm
- https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contenggrantingworkloadaccesstoresources.htm
- https://github.com/oracle-terraform-modules/terraform-oci-oke
- https://docs.oracle.com/en-us/iaas/Content/internet-of-things/home.htm
- https://github.com/oracle-samples/oci-iot-samples
- https://docs.oracle.com/en-us/iaas/Content/generative-ai/overview.htm
- https://docs.oracle.com/en-us/iaas/Content/generative-ai/home.htm
- https://docs.oracle.com/en-us/iaas/Content/Functions/home.htm
- https://docs.oracle.com/en-us/iaas/Content/Functions/Tasks/functionsquickstartlocalhost.htm
- https://docs.oracle.com/en-us/iaas/Content/Functions/Tasks/functionscreatingapps.htm
- https://docs.oracle.com/en-us/iaas/Content/Functions/Tasks/functionstroubleshooting.htm
评论
支持 Markdown