Mosquitto: 2. ライフサイクルスクリプト
このドキュメントはGitHub Actions & GitLab CIガイドの一部です。完全なガイドはこちらからご覧いただけます：GitHub Actions または GitLab CI パイプラインから実際の Mosquitto サービスを起動し、テストを実行して、自動的に削除する方法。
👋 Stackhero ドキュメントへようこそ！
Stackhero では、信頼性と柔軟性を重視したフルマネージドの Mosquitto MQTT クラウド 環境をご提供しています：
- 無制限のメッセージスループットとデータ転送により、ワークフローが人工的な制限に達することはありません。
- 独自の外部 API を利用した 無制限のデバイス認証で、オンボーディングやアクセス管理もシームレスに行えます。
- トピック、ユーザー、アクションごとに細かく制御できる 高度な ACL。
- HTTPS 対応の カスタムドメイン名で、セキュアかつブランド化されたエンドポイントを提供します（例：https://mqtt.your-company.com）。
- ワンクリックで適用できるアップデートにより、改善やセキュリティパッチも手間なく実施可能です。
- すべてのインスタンスが プライベートかつ専用インフラ上で稼働し、安定した パフォーマンスと強固な セキュリティを実現します。
IoT プロジェクトを加速し、運用負荷を大幅に削減しましょう。セキュアで本番運用に対応した Mosquitto MQTT クラウドホスティング インスタンスを、わずか数分で立ち上げることができます。
以下はサービスのライフサイクル全体を管理する完全なサンプルスクリプトです。必要なセットアップはごくわずかで、数コマンドのみです。各プラットフォーム向けの完成済み YAML はこの後のセクションからコピーできます。
#!/bin/bash
set -euo pipefail
# STACKHERO_TOKEN は CI シークレットから供給され、CLI が自動的に取得します。
stackName="ci-mosquitto-$$" # 各実行ごとに一意のスタック名
serviceStore="mosquitto" # Mosquitto サービスストア
instance="200" # 必要に応じて変更（ステップ3参照）
region="europe" # リージョン名（stackhero regions-list 参照）
# 1. ランナーに CLI をインストール
curl -fsSL https://www.stackhero.io/install.sh | sh
# 2. スモークテスト用クライアントをインストール（jq + curl がベース）
apt-get update && apt-get install -y --no-install-recommends jq curl mosquitto-clients
# 3. この実行用の専用スタックを作成
stackId=$(stackhero --format=script stack-create --name="$stackName")
echo "Stack created: $stackId"
# 4. Mosquitto を追加し、サービスIDを取得
serviceId=$(stackhero --format=script service-add \
--stack="$stackId" \
--service-store="$serviceStore" \
--instance="$instance" \
--region="$region")
echo "Service added: $serviceId"
# 5. サービスが稼働するまで待機（数分かかる場合があります）
stackhero service-wait-for --service="$serviceId"
# 6. 設定情報を取得（生成された認証情報を含む）
config=$(stackhero service-configuration-get --service="$serviceId" --format=json)
# 7. 必要な認証情報を抽出
host=$(echo "$config" | jq -r '.configuration.domain')
user=$(echo "$config" | jq -r '.configuration.authenticationUsers[0].login')
password=$(echo "$config" | jq -r '.configuration.authenticationUsers[0].password')
# 8. スモークテスト: Publish a test message to a topic.
mosquitto_pub -h "$host" -p 8883 -u "$user" -P "$password" --capath /etc/ssl/certs -t "stackhero/ci" -m "hello"
echo "✅ Mosquitto は CI から到達可能です。"
サービスの削除、削除完了待機、スタックの削除といったクリーンアップ手順は、下記のプラットフォーム別セクションで説明しています。この方法により、スモークテストが失敗した場合でも必ずクリーンアップが実行されます。
スタックは空でなければ削除できません。必ず先にサービスを削除し、その削除完了を待ってからスタックを削除してください。
service-wait-forコマンドは、サービスが稼働中または削除済みであることを保証するため、削除待機にも最適です。