mcpField
H
hetzner-cloud

hetzner-cloud

github.com/laguaguクラウド・DevOps70113 回インストール2 日前に更新
リポジトリ

hetzner-cloud について

導入済みの hcloud CLI で Hetzner Cloud リソースを操作するスキルです。開発者や運用担当者向けに、リソースの調査、慎重な変更、検証を案内し、アカウントのコンテキストやネットワーク、破壊的操作に注意を促します。

主な機能

  1. 01最新のリソース候補と価格の確認
  2. 02認証とプロジェクトコンテキストの管理
  3. 03リソース作成前の依存関係確認
  4. 04ファイアウォールと DNS の置換動作の確認
  5. 05リソース状態と接続性の検証
  6. 06削除と復旧に関する注意点

活用シーン

  1. 01利用可能なサーバータイプとロケーションの確認
  2. 02クラウドリソースの安全な作成や変更
  3. 03ファイアウォール変更後の接続診断
  4. 04サーバー削除前の復旧計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/laguagu/claude-code-nextjs-skills --skill hetzner-cloud

インストール後、Claude Code で/hetzner-cloudを入力して読み込まれたか確認します。

詳細

Hetzner Cloud

現在のリソースタイプ、ロケーション、フラグ、料金を確認するには、インストール済みの hcloud CLI とその --help／JSON 出力を使用してください。この CLI が対応する Cloud／DNS／Storage Box API が対象です。専用サーバー／オークションには Hetzner Robot を使用してください。

認証と検出

認証済みプロジェクトの既存コンテキストまたは HCLOUD_TOKEN を使用してください。環境ファイル内のトークンは自動的にエクスポートされません。コンテキストの作成時には通常プロンプトが表示されますが、hcloud context create --token-from-env <name> はプロンプトを表示せず、プロセスのトークンを使用します。トークンをコマンド引数やログに含めないでください。

書き込みを行う前に、プロジェクト／コンテキストを確認してください。現在の CLI／API データを使って、サーバータイプ、システムイメージ、アーキテクチャ、ロケーション／ネットワークゾーン、料金を確認してください（プロジェクト全体を確認するには hcloud server-type list、hcloud location list、hcloud image list --type system --architecture arm、hcloud all list を使用します）。記憶に頼ってサーバーの仕様や料金を記載しないでください。

依存関係と検証

サーバーを作成する前に、参照する SSH キー／ファイアウォール／ネットワークが存在することを確認してください。ファイアウォールの変更案は現在のルールと照らし合わせ、管理用の接続経路を維持してください。firewall replace-rules --rules-file はルール一式を置き換えるため、記載のないルールは削除されます。同様に、zone import-zonefile --zonefile はすべての Zone RRSet を置き換えるため、記載のないレコードは削除されます。

Cloud ファイアウォールは、現時点ではプライベートネットワークのトラフィックやロードバランサーを保護しません。必要に応じてホスト／アプリケーション側の制御を使用してください。ルール変更後は新しい接続で確認してください。確立済みの接続は更新後も維持されます。

サーバーの状態、ネットワーク到達性、アプリケーションの健全性は、個別に確認してください。変更後は API アクションの結果を読み取り、リソースの状態も再取得してください。実際の呼び出し元から対象のサービスを検証してください。

留意しておくべき注意点

  • IP アドレスが再割り当てされると、SSH でホストキーが変更されたという警告が表示される場合があります。known_hosts を更新する前に、信頼できるコンソール／チャネルを通じて新しいフィンガープリントを認証してください。ssh-keyscan だけでは本人性を確認できません。
  • 2026-07-01 以降、サーバーと Primary IP のリクエスト／レスポンスプロパティから datacenter が削除されました。CLI の server create --datacenter は削除されています。--location を使用し、hcloud server-type describe <type> -o json でサーバータイプのロケーションごとの提供状況と料金を確認してください。
  • ボリュームはロケーションに固定されます。別のロケーションにあるサーバーには接続できません。プライベートネットワークは同じネットワークゾーン内のロケーション間には展開できますが、ゾーンをまたいで展開することはできません。
  • DNS ゾーンは、レジストラで正しいネームサーバーに委任されるまで有効になりません。レコードのトラブルシューティングを行う前に、委任を確認してください。
  • 削除は即時に実行されます。リソース ID と、依頼された削除範囲を確認してください。まず復旧可能なデータを確保してください。自動バックアップはサーバーとともに削除されますが、スナップショットは残ります。復旧が必要な場合は、削除前にスナップショットを作成するか、バックアップをスナップショットに変換してください。サーバーのスナップショット／バックアップには、接続されたボリュームは含まれません。ボリュームには別途バックアップが必要です。スナップショットの対象範囲を参照してください。割り当て済みの Primary IP／Floating IP は削除できません。先に割り当てを解除してください。
  • status: running だけでは到達可能であることを証明できません。いくつものポート（0.0.0.0/0 に SSH を開放しているポートも含む）でタイムアウトが発生する場合や、アカウント内のすべてのサーバーが同時にアクセス不能になった場合は、プロバイダーによるブロック（不正利用の報告または未払い請求書）がないか、hcloud server describe <srv> -o json | jq '.public_net | {v4:.ipv4.blocked, v6:.ipv6.blocked}' を調べてください。こうした症状だけでブロックと断定はできません。プロバイダーレベルのブロックには Hetzner サポートへの問い合わせが必要であり、アプリのファイアウォールを修正しても解決しません。
  • ファイアウォールの JSON は API スキーマに一致している必要があります。source_ips は文字列の配列です。PowerShell でシリアライズする場合は、十分な JSON 深度を指定してください。形式エラーがあるとファイル全体が拒否され、以前のルールが維持されます。返されたルール／現在のルールを確認してください。

参照元

コメント

Markdown 対応