Mosquitto: 1. アクセストークンを作成し、CI シークレットとして保存する
このドキュメントはGitHub Actions & GitLab CIガイドの一部です。完全なガイドはこちらからご覧いただけます：GitHub Actions または GitLab CI パイプラインから実際の Mosquitto サービスを起動し、テストを実行して、自動的に削除する方法。
👋 Stackhero ドキュメントへようこそ！
Stackhero では、信頼性と柔軟性を重視したフルマネージドの Mosquitto MQTT クラウド 環境をご提供しています：
- 無制限のメッセージスループットとデータ転送により、ワークフローが人工的な制限に達することはありません。
- 独自の外部 API を利用した 無制限のデバイス認証で、オンボーディングやアクセス管理もシームレスに行えます。
- トピック、ユーザー、アクションごとに細かく制御できる 高度な ACL。
- HTTPS 対応の カスタムドメイン名で、セキュアかつブランド化されたエンドポイントを提供します（例：https://mqtt.your-company.com）。
- ワンクリックで適用できるアップデートにより、改善やセキュリティパッチも手間なく実施可能です。
- すべてのインスタンスが プライベートかつ専用インフラ上で稼働し、安定した パフォーマンスと強固な セキュリティを実現します。
IoT プロジェクトを加速し、運用負荷を大幅に削減しましょう。セキュアで本番運用に対応した Mosquitto MQTT クラウドホスティング インスタンスを、わずか数分で立ち上げることができます。
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 シークレットとして保存することで、暗号化・マスキングされ、トークンの安全性が保たれます。