Skip to content

docs(tailscale): Phase 1.5 apply ops verification#7267

Open
boxp wants to merge 3 commits intomainfrom
docs/tailscale-ops-verification
Open

docs(tailscale): Phase 1.5 apply ops verification#7267
boxp wants to merge 3 commits intomainfrom
docs/tailscale-ops-verification

Conversation

@boxp
Copy link
Owner

@boxp boxp commented Feb 27, 2026

Summary

  • Tailscale Terraform apply 成功後の運用確認ドキュメントを追加
  • CLAUDE.md の Tailscale 管理方針を「導入予定」→「Phase 1.5 完了・運用中」に更新
  • WIF 経路の検証手順 (argocd-diff 想定) を文書化
  • ロールバック手順を 3 段階 (通常/緊急/最終手段) で最終化

変更内容

新規: docs/project_docs/T-20260227-014/plan.md

  • Apply 成功の証跡整理 (workflow run #22478747958 失敗 → #22479672276 成功)
  • リソース作成タイムライン (ACL → WIF + auth key + SSM)
  • WIF 検証手順 (GitHub Actions OIDC → Tailscale WIF → tailnet 接続)
  • ロールバック手順 (通常 revert / 緊急 destroy / 最終手段 manual)
  • Phase 2 への移行タスク一覧
  • Board 用完了条件チェック

更新: CLAUDE.md

  • tailscale/ ディレクトリ説明を「導入予定」→「Phase 1.5 完了・運用中」
  • Tailscale 管理方針セクションを実績に基づいて更新

関連

Test plan

  • ドキュメントの内容が apply ログと一致していることを確認
  • ロールバック手順の git revert コマンドが正しいことを確認
  • CLAUDE.md の記述が現在の実装状態と一致していることを確認

Generated with Claude Code

boxp and others added 3 commits February 27, 2026 09:17
Document apply success evidence (workflow runs, resources created), WIF verification procedure (argocd-diff flow), and finalize rollback procedures. Update CLAUDE.md to reflect Phase 1.5 completion status.

Ref: PR #7263, PR #7266, T-20260227-014

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Use explicit commit SHAs instead of range notation to ensure both

PR #7263 and #7266 commits are reverted correctly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ACL was already created in the failed run #22478747958 and persisted

in state. The successful run #22479672276 only added the remaining 3

resources. Corrected to avoid misleading incident/rollback analysis.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 566e40e6dc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +152 to +155
1. **Tailscale 管理コンソール** で以下を手動削除:
- Trust Credential (WIF)
- ACL policy のカスタムルール
2. **AWS SSM Parameter Store** で `/lolice/tailscale/subnet-router-auth-key` を手動削除

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Delete tailnet auth key before removing it from Terraform state

In section 3.3, the manual cleanup list removes the WIF credential and ACL but does not remove the Tailscale auth key, even though the next step runs terraform state rm tailscale_tailnet_key.subnet_router. In a state-repair rollback, this leaves a reusable preauthorized key orphaned in the tailnet while Terraform no longer tracks it, which weakens rollback completeness and can leave active credentials behind.

Useful? React with 👍 / 👎.

Comment on lines +157 to +161
```bash
terraform state rm tailscale_acl.this
terraform state rm tailscale_federated_identity.github_actions_argocd_diff
terraform state rm tailscale_tailnet_key.subnet_router
terraform state rm aws_ssm_parameter.subnet_router_auth_key

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Enter tailscale workspace before running state rm commands

The state-repair procedure starts with terraform state rm commands but does not establish the Terraform working directory/backend context in this section. If an operator follows 3.3 from a fresh shell (not from 3.2), these commands can target the wrong state or fail unexpectedly, which is risky during rollback. Add an explicit cd terraform/tailscale/lolice/ (or terraform -chdir=...) before the state operations.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant