[小ネタ] ECS サービスの minimumHealthyPercent(最小ヘルス率)を確認する方法

「デプロイ」タブの「デプロイ設定」セクションを確認します。
2024.04.02

アノテーション・テクニカルサポートチームの hato です。

ECS サービスの最小ヘルス率(minimumHealthyPercent)の確認方法を調べる機会がありましたので、小ネタとしてご紹介します。

Amazon ECS のデプロイを高速化するための Amazon ECS サービスパラメータ - Amazon Elastic Container Service

minimumHealthyPercent: 100% (デフォルト)

デプロイ中に RUNNING 状態に保つ必要のあるサービスのタスク数の下限。

確認してみた

Amazon ECS コンソールの「クラスター」から、確認したいサービスが含まれるクラスターを選択します。

確認したいサービスを選択します。

「デプロイ」タブを選択します。

「デプロイ設定」セクションの右端に「最小ヘルス率(minimumHealthyPercent)が表示されます。
画像の場合はminimumHealthyPercent100%のようです。

AWS CLIから確認する場合

describe-servicesコマンドを実行してdeploymentConfigurationminimumHealthyPercentを確認します。

コマンド例

$ aws ecs describe-services \
     --cluster 【ECS クラスター名】 \
     --services 【ECS サービス名】
{
    "services": [
        {
            "serviceArn": "arn:aws:ecs:ap-northeast-1:123456789012:service/hato-cluster/hato-service",
            "serviceName": "hato-service",
            "clusterArn": "arn:aws:ecs:ap-northeast-1:123456789012:cluster/hato-cluster",
            "loadBalancers": [],
            "serviceRegistries": [],
            "status": "ACTIVE",
            "desiredCount": 0,
            "runningCount": 0,
            "pendingCount": 0,
            "launchType": "FARGATE",
            "platformVersion": "LATEST",
            "platformFamily": "Linux",
            "taskDefinition": "arn:aws:ecs:ap-northeast-1:123456789012:task-definition/hato-taskdefinition:1",
            "deploymentConfiguration": {
                "deploymentCircuitBreaker": {
                    "enable": true,
                    "rollback": true
                },
                "maximumPercent": 200,
                "minimumHealthyPercent": 100,
                "alarms": {
                    "alarmNames": [],
                    "enable": false,
                    "rollback": false
                }
            },
...

参考資料

アノテーション株式会社について

アノテーション株式会社はクラスメソッドグループのオペレーション専門特化企業です。サポート・運用・開発保守・情シス・バックオフィスの専門チームが、最新 IT テクノロジー、高い技術力、蓄積されたノウハウをフル活用し、お客様の課題解決を行っています。当社は様々な職種でメンバーを募集しています。「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、アノテーション株式会社 採用サイトをぜひご覧ください。