Memcached: 2. ライフサイクルスクリプト

このドキュメントはGitHub Actions & GitLab CIガイドの一部です。完全なガイドはこちらからご覧いただけます:GitHub Actions または GitLab CI パイプラインから実際の Memcached サービスを起動し、テストを実行して、自動的に削除する方法

Stackheroドキュメントへようこそ

Stackheroは、アプリケーションキャッシュをシンプルかつセキュア、そして高パフォーマンスで実現する、フルマネージドのMemcachedクラウドを提供しています。

  • アップデートをワンクリック、数秒で適用可能。
  • プライベートかつ専用インフラ上で、安定したパフォーマンスと強固なセキュリティを実現。

時間を有効活用し、開発に集中してください。StackheroのMemcachedクラウドホスティングは、約5分でご利用を開始できます。

以下はサービスのライフサイクル全体を管理する完全なサンプルスクリプトです。必要なセットアップはごくわずかで、数コマンドのみです。各プラットフォーム向けの完成済み YAML はこの後のセクションからコピーできます。

#!/bin/bash
set -euo pipefail

# STACKHERO_TOKEN は CI シークレットから供給され、CLI が自動的に取得します。

stackName="ci-memcached-$$"          # 各実行ごとに一意のスタック名
serviceStore="memcached"             # Memcached サービスストア
instance="1G"        # 必要に応じて変更(ステップ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 libmemcached-tools

# 3. この実行用の専用スタックを作成
stackId=$(stackhero --format=script stack-create --name="$stackName")
echo "Stack created: $stackId"

# 4. Memcached を追加し、サービス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.credentials.login')
password=$(echo "$config" | jq -r '.configuration.credentials.password')

# 8. スモークテスト: Authenticate with SASL and read a key (a miss still proves auth works).
memccat --servers="$host:11211" --binary --username="$user" --password="$password" stackhero-ci-probe 2>&1 | grep -vq "AUTHENTICATION"

echo "✅ Memcached は CI から到達可能です。"

サービスの削除、削除完了待機、スタックの削除といったクリーンアップ手順は、下記のプラットフォーム別セクションで説明しています。この方法により、スモークテストが失敗した場合でも必ずクリーンアップが実行されます。

スタックは空でなければ削除できません。必ず先にサービスを削除し、その削除完了を待ってからスタックを削除してください。service-wait-for コマンドは、サービスが稼働中または削除済みであることを保証するため、削除待機にも最適です。