Mercure-Hub: 1. アクセストークンを作成し、CI シークレットとして保存する
このドキュメントはGitHub Actions & GitLab CIガイドの一部です。完全なガイドはこちらからご覧いただけます：GitHub Actions または GitLab CI パイプラインから実際の Mercure Hub サービスを起動し、テストを実行して、自動的に削除する方法。
👋 Stackhero ドキュメントへようこそ！
Stackhero では、リアルタイムデータ配信をシンプルかつ信頼性高く実現する、フルマネージドの Mercure-Hub cloud サービスをご提供しています。主な特長は以下の通りです：
- リクエスト数・メッセージサイズ無制限で、柔軟な運用が可能です。
- HTTPS 対応の カスタムドメイン（例：https://real-time.your-company.com）を標準搭載。
- ワンクリックアップデートで、常に最新の状態を簡単に維持できます。
- プライベートかつ専用インフラ上での高いパフォーマンスと強固なセキュリティ。
- 複数リージョン対応：🇪🇺 ヨーロッパおよび🇺🇸 USAで低遅延配信を実現。
すぐに利用開始可能：わずか5分で Mercure-Hub cloud hosting 環境を立ち上げ、アプリケーションへのリアルタイム更新配信をスタートできます。
CLI を非対話的に動作させるには、アクセストークン（形式: usr-xxxxxx:tokenId）が必要です。このトークンは一度作成すれば十分で、その後は CI パイプラインの安全な暗号化シークレットとして追加します。
- トークンの作成: Stackhero ダッシュボードで、右上のプロフィール画像をクリックし、Your account → Access tokens → Create token の順に進みます。
- GitHub Actions の場合: リポジトリの Settings > Secrets and variables > Actions > New repository secret で、トークンを
STACKHERO_TOKENとして登録します。 - GitLab CI の場合: プロジェクトの Settings > CI/CD > Variables > Add variable で、キーを
STACKHERO_TOKENに設定し、Masked（CI が保護ブランチのみで動作する場合は Protected も）にチェックを入れます。
アクセストークンをパイプラインの YAML ファイルに直接記載しないでください。YAML 内に記載すると、リポジトリにアクセスできる誰もが閲覧でき、ビルドログにも表示される可能性があります。CI シークレットとして保存することで、暗号化・マスキングされ、トークンの安全性が保たれます。