プロジェクト概要
gcp-free-vps-skillは、GCP Always Free VPS向けのデプロイスキルドキュメントです。無料枠の準備、インスタンス作成、料金対策、システム設定、ネットワーク送信、最終検証までを一連の手順にまとめており、主にMuseによるデプロイ作業を支援するために使用します。
対象となる手順には、300ドルのトライアルクレジットと毎月10ドルのクレジットの取得、e2-micro無料インスタンスの作成、予算アラートの設定、CDN送信のブロック、トラフィックがしきい値を超えた場合の速度制限、Debianのソフトウェアソース変更、dae送信の設定、テストページによる検証が含まれます。
このチュートリアルは、リポジトリのREADMEをもとに使用方法をまとめたものです。実際のデプロイの詳細は、リポジトリ内のSKILL.mdを基準にしてください。
主な特徴
- 完全なデプロイ手順:GCPのクレジット準備からテストページによる検証までをカバーします。
- 無料枠の範囲を限定:e2-micro、30GB pd-standardディスク、標準ネットワーク階層を使用します。
- 料金リスクへの注意:予算アラートで支出を監視しますが、アラートによってインスタンスが自動停止することはありません。
- トラフィック保護:CDN送信のブロックを行い、トラフィックが180GBを超えた場合はシャットダウンではなく速度制限を実施します。
- 認証情報の安全管理:ノードリンク、サブスクリプションリンク、UUID、WebSocketパスなどの機密情報はサーバー上だけに保存します。
- Museとの統合:ドキュメントのリンクを送信する、全文を貼り付ける、またはスキルファイルをcustom-skillsディレクトリに追加する方法を利用できます。
開始前の準備
GCPを利用でき、ウェブページまたはカスタムスキルを読み込めるMuse環境を用意する必要があります。GCPを初めて使用する場合は、スキルに記載された手順に従って300ドルのトライアルクレジットと毎月10ドルのクレジットを処理できます。
デプロイ時は、リポジトリで定められた無料リソースの範囲を厳守してください。
- インスタンスタイプに
e2-microを選択する。 - ディスクに
30GB pd-standardを使用する。 - 標準ネットワーク階層を使用する。
- 静的IPを有効にしない。
- スナップショットを作成しない。
- GPUを追加しない。
これらの制限は、この構成で料金を抑えるための重要な前提です。無料利用資格、クレジット、課金ルールはアカウントやGCPの現在のポリシーによって異なる可能性があるため、各作成操作の前にコンソールに表示される料金情報を確認してください。
Skillのインストールまたはインポート
方法1:リンクをそのままMuseに送る
最も簡単な方法です。次のリンクをMuseに送信します。
https://github.com/pierpont-morgan/gcp-free-vps-skill/blob/main/SKILL.md続いて、Museにドキュメントを読み込み、その手順に厳密に従ってGoogle VPSの設定を支援するよう依頼します。
方法2:SKILL.mdの全文を送る
MuseがGitHubに直接アクセスできない場合は、SKILL.mdを開き、ファイル全体をコピーしてMuseに送信します。これにより、Museは完全なスキルの内容にもとづいて操作方法を案内できます。
方法3:custom-skillsディレクトリに追加する
Muse環境がカスタムスキルに対応している場合は、リポジトリのSKILL.mdをダウンロードし、Museのcustom-skillsディレクトリに配置します。具体的なディレクトリの場所や読み込み方法はMuse環境によって異なり、リポジトリのREADMEでは追加のインストールコマンドは定められていません。
基本的な使用方法
Museにデプロイを依頼する
スキルをインポートするかリンクを提供した後、明確で制約を含むプロンプトを使ってデプロイを開始できます。例えば、次のように入力します。
このSKILL.mdを読み込み、ドキュメントの順序に従ってGoogle VPSのデプロイを手伝ってください。
無料枠の範囲に厳密に制限し、e2-micro、30GB pd-standard、標準ネットワーク階層を使用してください。静的IP、スナップショット、GPUは有効にしないでください。
各手順を実行する前に、作成するリソースと料金が発生する可能性があるかどうかを説明し、私の確認を待ってください。重要な操作の前にMuseが確認を待つようにすると、料金の発生するリソースを誤って選択することを防ぎやすくなります。「無料」という表示だけを根拠に作成操作を実行せず、GCPコンソールでインスタンス、ディスク、ネットワークの設定を再確認してください。
手順を順番に完了する
- 無料クレジットを処理する:スキルドキュメントに従い、300ドルのトライアルクレジットと毎月10ドルのクレジットに関する準備を完了します。
- インスタンスを作成する:
e2-microを選択し、30GB pd-standardディスクと標準ネットワーク階層を使用します。 - 追加リソースを避ける:静的IP、スナップショット、GPUが有効になっていないことを確認します。
- 予算アラートを設定する:料金通知を設定し、発生する可能性のある異常な支出を早期に把握します。
- ネットワークを保護する:スキルドキュメントに従ってCDN送信のブロックとトラフィック制限を設定します。
- システムを設定する:Debianのソフトウェアソースを変更します。
- dae送信を設定する:必要な送信情報をサーバー上のdae設定ファイルに記述します。
- 検証を完了する:スキルで指定されたテストページを使ってデプロイ結果を確認します。
認証情報と設定の安全管理
ノードリンク、サブスクリプションリンク、UUID、WebSocketパスなどはすべて機密認証情報です。これらをGitHubリポジトリ、README、SKILL.md、公開Issue、コミット履歴に記載しないでください。
これらの認証情報はサーバー上のdae設定ファイルに直接記述し、ファイル権限を0600に設定してください。この権限では、ファイル所有者だけが設定ファイルを読み書きできます。
0600Museに質問するときも、実際の認証情報を直接貼り付けないようにしてください。まずはプレースホルダーで項目を説明し、サーバー側で最終設定を書き込むときだけ実際の値を使用します。
予算アラートとトラフィック戦略
予算アラートで自動停止はできない
予算アラートの役割は通知を送ることであり、VPSを自動的に停止することではありません。アラートを受け取ったら、GCPにログインしてリソース使用量と料金を自分で確認する必要があります。予算アラートを自動的な課金防止機能と考えないでください。
180GBを超えた後は速度だけを制限する
このスキルで採用されているトラフィック保護の仕組みは、トラフィックが180GBを超えた後に速度を制限し、インスタンスを停止しないというものです。そのため、しきい値に達してもサーバーは稼働を続けますが、ネットワーク速度は制限されます。
検証時には、サービスにアクセスできることだけでなく、トラフィック制限の方針が想定どおりであることも確認してください。しきい値に達するとインスタンスが自動停止すると誤解しないよう注意が必要です。
高度な使用方法
- 実行段階を分ける:Museにアカウントとクレジット、インスタンス、予算、ネットワーク、システム、dae、検証をそれぞれ処理させ、1回の操作が多くなりすぎないようにします。
- 無料枠の範囲を都度確認する:インスタンスやネットワーク設定を変更するたびに、タイプ、ディスク、ネットワーク階層がリポジトリの要件から外れていないことを再確認します。
- 説明を受けてから操作する:各手順で目的、リソースの変化、発生する可能性のある料金をMuseに説明させ、その後で続行するか判断します。
- 実際の認証情報を送信しない:リポジトリが非公開であっても、READMEの要件に従い、機密情報はサーバーのdae設定ファイルだけに保存します。
- 通知と保護動作を区別する:予算アラートは通知のみ、180GB超過時の処理は速度制限のみです。どちらもインスタンスを自動停止しません。
- テストページで締めくくる:設定完了後も検証を省略せず、SKILL.mdのテスト手順に従って最終結果を確認します。
よくある誤解
- 誤解1:予算アラートが料金の発生するリソースを自動停止すると考える。実際には通知を行うだけです。
- 誤解2:トラフィックが180GBを超えるとサーバーが停止すると考える。このプロジェクトの方針は停止ではなく速度制限です。
- 誤解3:固定アドレスのために静的IPを有効にする。リポジトリでは静的IPを有効にしないよう明確に指定されています。
- 誤解4:UUID、サブスクリプションリンク、WSパスをリポジトリにコミットする。正しくは、サーバー側のdae設定ファイルにのみ記述し、権限を
0600に設定します。 - 誤解5:設定を確認せず完全自動で実行する。各重要手順で無料枠の範囲とコンソールの料金表示を確認してください。
まとめ
gcp-free-vps-skillの主な価値は、GCP Always Free VPSのデプロイ手順をMuseに実行させられるスキルとして整理している点にあります。使用時は、SKILL.mdのリンクを直接送る、全文を貼り付ける、またはファイルをcustom-skillsディレクトリに追加する方法を利用できます。
デプロイ中は、e2-micro、30GB pd-standard、標準ネットワーク階層などの無料枠の範囲を常に守り、静的IP、スナップショット、GPUを有効にしないでください。また、予算アラートでは自動停止されず、180GBのしきい値では速度制限だけが実行され、すべての機密認証情報は権限0600のサーバー設定ファイルだけに保存する必要があることを忘れないでください。
