运维测试

Name: 运维测试
Author: youxuanxue

其他社区

作者仓库星标 0
作者更新于实时读取
作者仓库 sub2api

流狐档案事实层信息：领域、Agent、信任分、运行环境、权限与网络

领域: 通用
兼容 Agent: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
信任分: 88 / 100 · 社区维护
作者 / 版本 / 许可: @youxuanxue · 未声明 license
Token 消耗评级: 低消耗
接入复杂程度: 即装即用
是否需要外部 API Key: 不需要
兼容的系统: 未声明（默认跨平台）
底层运行要求: 无特殊要求
文件与系统权限: 只读
允许写入 / 修改
网络行为: 允许外网请求
安装命令数: 26 条

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 tokenkey-stage0-edge-lightsail-ip-rotation.preview

---
name: tokenkey-stage0-edge-lightsail-ip-rotation
description: >- 适用于通过 deploy-edge-lightsail-stage0.yml 部署的 Lightsail Edge（与 EC2 EIP 路径不通用）。 EC2 路径见 tokenkey-…
category: 通用
runtime: 无特殊运行时
---

# tokenkey-stage0-edge-lightsail-ip-rotation 输出预览

## PART A: 任务判断
- 适用问题：通用任务拆解、检查和交付。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“确定性基线 / 调用参数 / 0) 前置”读取原文规则，不把推断写成作者承诺。

## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于通用任务拆解、检查和交付，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“确定性基线 / 调用参数 / 0) 前置”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、会按任务需要访问外部网络、通常不需要额外 API Key 给出执行前确认项。

## Running Rules
- 读取文件、写入/修改文件；会按任务需要访问外部网络；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。

SKILL.md SKILL.md

---
name: tokenkey-stage0-edge-lightsail-ip-rotation
description: >- 适用于通过 deploy-edge-lightsail-stage0.yml 部署的 Lightsail Edge（与 EC2 EIP 路径不通用）。 EC2 路径见 tokenkey-…
category: 通用
source: youxuanxue/sub2api
---

# tokenkey-stage0-edge-lightsail-ip-rotation

## 什么时候使用
- 把通用方向的常用动作沉淀成 Agent 可调用的技能 适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要额外…
- 面向通用任务拆解、检查和交付，优先处理能明确输入、步骤和验收标准的工作。

## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。

## 执行规则
- 围绕「确定性基线 / 调用参数 / 0) 前置」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件；会按任务需要访问外部网络；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。

## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。

证据边界与执行链路

作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。

skill "tokenkey-stage0-edge-lightsail-ip-rotation" {
  输入层     -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
  上下文层   -> 确定性基线 / 调用参数 / 0) 前置
  规则层     -> SKILL.md 触发条件 / 执行顺序 / 输出格式
  运行层     -> 无特殊运行时 | 读取文件、写入/修改文件 | 会按任务需要访问外部网络
  安全层     -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
  输出层     -> 可复制结果 + 检查清单 + 下一步迭代
}

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

先判断是否适合

核心用途：把通用方向的常用动作沉淀成 Agent 可调用的技能适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要额外 API Key，适…
适用任务：更适合通用任务拆解、检查、交付和复盘，尤其是输入、步骤、验收口径可以反复复用的场景。
不宜硬套：如果任务只有一次性问答、来源材料很少，或需要作者没有说明的命令和外部服务，应先降级为普通对话。

作者设计意图

触发依据：使用时机、上下文收集、输出格式和失败处理共同决定它是否适合当前任务。
来源边界：作者原文负责事实，仓库文件负责命令和文件证据；Fluxly 只补充用途、限制和使用判断。

作者的方法与取舍

执行主线：任务围绕「确定性基线 / 调用参数 / 0) 前置」组织，把触发条件、必要上下文、执行规则和交付标准连成一条可复核的链路。
设计重点：重点不在重复教程，而在解释作者为什么规定这些步骤、哪些条件不可省略，以及结果偏离时应回到哪一层检查。
使用判断：先确认任务与原文边界一致，再决定是否启用；来源没有说明的命令、平台和依赖保持未知，不由 Fluxly 补写。

边界和复核

依赖条件：通常不需要额外 API Key，适合先用小任务验证触发是否稳定。
权限提醒：会涉及 read / write 权限，执行前要说明可读写范围、命令边界和回退方式。
质量标准：结果应包含明确产物、必要证据和下一步动作；如果只是泛泛解释，需要补充输入和验收条件后重跑。

TokenKey：Lightsail Edge 静态 IP 轮换（污染快速恢复）

适用于通过 deploy-edge-lightsail-stage0.yml 部署的 Lightsail Edge（与 EC2 EIP 路径不通用）。 EC2 路径见 tokenkey-stage0-edge-ip-rotation。Lightsail 路径没有 CloudFormation，所以没有 drift IMPORT 这一节。

确定性基线

步骤	类型	承载
解析 edge → region / instance / static IP name / domain	机械	`ops/lightsail/rotate-static-ip.sh`（jq 读 `edge-targets-lightsail.json`）
计划输出（dry run）	机械	同上脚本默认行为（无 `--apply`）
三步 swap（allocate → detach → attach → release）	机械	同上脚本 `--apply`
候选 IP 撞 exclusion registry 时重试	机械	同上脚本（默认最多 5 次）
释放旧 IP 后写入 exclusion registry	机械	`deploy/aws/stage0/record-polluted-ip.py`（由 rotate 脚本调用）
把 ssm_prefix/public_ip 改成新 IP	机械	同上脚本
Porkbun DNS A 记录更新	真判断	prompt（人工操作 Porkbun）
外部干净出口验证	真判断	prompt（选择哪个 observation host 取决于运营当时态势）

调用参数

/tokenkey-stage0-edge-lightsail-ip-rotation edge_id=<id> [step=plan|swap|verify|all]

step=plan（默认）— ops/lightsail/rotate-static-ip.sh <edge_id> 打印计划，无 AWS 变更。
step=swap — ops/lightsail/rotate-static-ip.sh <edge_id> --apply，销毁旧 IP。
step=verify — 用上一步产生的 new_ip 做 SNI 验证 + smoke。
step=all — 串起 plan → 等用户确认 → swap → 提示 DNS → verify。

0) 前置

git fetch origin main && git checkout main && git pull --ff-only
bash scripts/preflight.sh
aws sts get-caller-identity   # 确认目标账户

确认 edge 已经在 deploy/aws/lightsail/edge-targets-lightsail.json 里 deployable=true，且 ssm_prefix/public_ip 与 aws lightsail get-static-ip 报告的 ipAddress 一致；不一致先用 aws ssm put-parameter 把 SSM 修对，再开始轮换。

Adopt 命名：instance_name / static_ip_name 以 matrix 为准（如 us2 → tokenkey-edge-us-va1-ls / StaticIp-2），不要假设 tokenkey-edge-<edge_id>-ls-ip。

1) Plan

bash ops/lightsail/rotate-static-ip.sh <edge_id>

输出形如：

=== Lightsail Edge IP rotation plan ===
edge_id           : uk1
lightsail_region  : eu-west-2
instance_name     : tokenkey-edge-uk1-ls
domain            : api-uk1.tokenkey.dev
old_static_ip_name: tokenkey-edge-uk1-ls-ip
old_ip            : 18.x.x.x
new_static_ip_name: tokenkey-edge-uk1-ls-ip-rot-<ts>
ssm_prefix        : /tokenkey/lightsail/uk1

用户确认 old_ip 确实被污染，再进入 swap。

2) Swap

bash ops/lightsail/rotate-static-ip.sh <edge_id> --apply --reason 'upstream-api-risk-block-YYYY-MM-DD'

脚本顺序：

aws lightsail allocate-static-ip 新名字（若候选 IP 已在 edge-polluted-ips.json 则 release 并重试）
aws lightsail detach-static-ip 旧名字
aws lightsail attach-static-ip 新名字到 instance
aws lightsail get-static-ip 读出 NEW ip
aws ssm put-parameter 写 ${ssm_prefix}/public_ip = <new_ip>
aws lightsail release-static-ip 旧名字（该 IP 进入 AWS pool）
record-polluted-ip.py append 把旧 IP 写入 exclusion registry（记得 commit JSON + 跑 scripts/edge-ip-status.sh --check）

输出最后会打印 NEW ip 和 DNS / smoke 提示。

同账户 IP 池注意：Lightsail 在同账户同 region 复用 IP 池。rotate 脚本会查 edge-polluted-ips.json 并在候选 IP 已登记时自动重试；释放的旧 IP 也会自动 append 进 registry，避免再次撞回。

3) DNS 与 Caddy

去 Porkbun 把 api-<edge_id>.tokenkey.dev 的 A 记录改成 NEW ip。等 dig +short @1.1.1.1 指向 NEW ip（常见约 1 分钟）。

IP 变更后重启 Caddy 以刷新 ACME / 绑定：

bash ops/stage0/verify-edge-lightsail-network.sh <edge_id> --renew-cert

4) Verify（独立观察点）

不要用刚改 DNS 的本地，去 tk_post_deploy_smoke.sh 或者任意干净出口：

curl -sS --resolve api-<edge_id>.tokenkey.dev:443:<new_ip> \
  https://api-<edge_id>.tokenkey.dev/health

应当 200。然后跑一次 workflow smoke：

CONFIRM=$(python3 deploy/aws/lightsail/resolve-edge-lightsail-target.py \
  --edge-id <edge_id> | awk -F= '/^instance_name=/{print $2}')
gh workflow run deploy-edge-lightsail-stage0.yml \
  -f edge_id=<edge_id> -f operation=smoke \
  -f confirm_instance="$CONFIRM"
gh run watch --exit-status $(gh run list -w deploy-edge-lightsail-stage0.yml -L 1 --json databaseId -q '.[0].databaseId')

最后用 tokenkey-online-traffic-profile 或 tokenkey-online-log-troubleshooting 看 5 分钟内 Anthropic upstream 是否回到正常 2xx 比例。

5) Acceptance（机械化输出）

edge_id : <id>
old_ip  : <old_ip>
new_ip  : <new_ip>
domain  : api-<id>.tokenkey.dev
verify  : curl <new_ip>:443 → 200; smoke run → green

6) 失败模式

现象	解读	应对
`allocate-static-ip` 报 `ServiceQuotaExceededException`	该 region 还有未释放的 Static IP（默认 quota=5）	`aws lightsail get-static-ips` 看清单，释放无主的
`attach-static-ip` 报 `OperationFailureException`	instance 处于非 `running` 状态	`aws lightsail get-instance` 查 state，等到 `running` 再重试
切完 NEW ip 仍被污染	撞回同 region 老 IP，或同 ASN 被整段封	立刻重跑一次 swap；如再次撞回考虑跨 region 增设新 edge
DNS 没改但 smoke 通过	漏掉 verify 的 `--resolve`	必须显式 `--resolve` 强制 SNI 到新 IP

安装命令

一键复制安装选择包管理器,点击右侧复制,粘贴到终端回车即可

npx skills add youxuanxue/sub2api/.cursor/skills/tokenkey-stage0-edge-lightsail-ip-rotation -y

查看通用安装教程

查看 Skill 原文

兼容工具

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

安全审计

88 / 100

社区

未声明 license/许可。
未声明 version。
未限定 allowed-tools，默认拥有全部工具权限。

元信息

来源: github
youxuanxue/sub2api
English

@youxuanxue 的其他技能

分类与标签

分类其他