CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

プロジェクト概要

これはEKSリファレンスアーキテクチャリポジトリで、Amazon EKS上でシステムを構築するための包括的なサンプルとリファレンス実装を提供します。様々なEKSデプロイメントパターン、セキュリティ実装、可観測性セットアップ、運用ベストプラクティスのサンプル設定が含まれています。

アーキテクチャと構造

コアコンポーネント

• クラスタ構成: EKS AutomodeとManaged Node Groupsによるクラスタセットアップ
• セキュリティ: Pod Identity、RBAC、ネットワークポリシー、GuardDuty統合
• 可観測性: CloudWatch Observability、ログとメトリクス収集
• 可用性: ALBによるロードバランシング、ヘルスチェック、PDB設定
• DevOps: GitOps用ArgoCD、CI用セルフホステッドランナー
• バックアップ: リソースとボリュームバックアップ用Velero
• サービスアーキテクチャ: ALB Controller、永続ボリューム管理

ディレクトリ構造

• /references/ - 機能領域別に整理されたリファレンス実装:
  • cluster-basic/ - EKSクラスタ設定（Automode、Managed Node Groups）
  • security/ - セキュリティ設定とベストプラクティス
  • observability/ - モニタリングとログ設定
  • availability/ - 高可用性と耐障害性パターン
  • devops/ - CI/CDとGitOps設定
  • backup/ - バックアップとリカバリソリューション
  • service/ - サービスアーキテクチャパターン

リファレンスドキュメント構造

すべてのドキュメントは日本語で記述され、一貫した構造に従っています:

• 各セクションには親READMEへのナビゲーションリンクが含まれる
• セクションは「ベース構成」と「カスタマイズ」に整理される
• 関連コンポーネント間の相互参照が維持される

重要な注意事項

• これはリファレンスアーキテクチャリポジトリです - 本番環境の最適化よりもベストプラクティスの実証に重点を置く
• すべての設定には包括的なセキュリティ考慮事項が含まれる
• リポジトリは可能な限りAWSマネージドサービスとEKSアドオンを重視する
• Automodeクラスタは、AWSマネージドノードとアドオンのライフサイクル管理を提供するため、新しい実装では推奨される