翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

FIS aws:eks:pod AWS アクションを使用する

aws:eks:pod アクションを使用して、EKS クラスターで実行されている Kubernetes Pod に障害を挿入できます。

アクションが開始されると、FIS は FIS ポッドコンテナイメージを取得します。このイメージは、ターゲット EKS クラスターに Pod を作成するために使用されます。新しく作成された Pod は、障害の挿入、制御、モニタリングを担当します。aws:eks:pod-delete を除くすべての FIS EKS アクションでは、障害挿入は、既存の Pod 内に一時コンテナを作成できる Kubernetes 機能であるエフェメラルコンテナを使用して実現されます。エフェメラルコンテナは、ターゲットコンテナと同じ名前空間で起動され、目的の障害挿入タスクを実行します。ターゲットコンテナが指定されていない場合、Pod 仕様の最初のコンテナがターゲットとして選択されます。

実験の完了時、またはエラーが発生した場合、エフェメラルコンテナと FIS ポッドは削除されます。

アクション

制限事項

要件

実験ロールの作成

実験を実行するには、実験の IAM ロールを設定する必要があります。詳細については、「FIS 実験の IAM AWS ロール」を参照してください。このロールに必要なアクセス許可は、使用しているアクションによって異なります。aws:eks:pod をターゲットとするAWS FIS アクションを参照して、アクションに必要なアクセス許可を見つけます。

Kubernetes サービスアカウントを設定する

指定した Kubernetes 名前空間のターゲットで実験を実行するように Kubernetes サービスアカウントを設定します。次の例では、サービスアカウントは myserviceaccount で、名前空間はデフォルトです。default は標準の Kubernetes 名前空間の1つであることに注意してください。

IAM ユーザーおよびロールに Kubernetes API へのアクセスを付与する

「EKS ドキュメント」の「IAM アイデンティティと Kubernetes のアクセス許可を関連付ける」で説明されているステップに従います。

オプション 1: アクセスエントリを作成する

Access Entries を使用することをお勧めします。次のコマンドを使用して、IAM ロールを Kubernetes ユーザー fis-experiment に関連付けるアクセスエントリを作成できます。詳細については、「EKS アクセスエントリを使用して Kubernetes へのアクセス権を IAM ユーザーに付与する」を参照してください。

aws eks create-access-entry \
                 --principal-arn arn:aws:iam::123456789012:role/fis-experiment-role \
                 --username fis-experiment \
                 --cluster-name my-cluster

オプション 2: aws-auth ConfigMap にエントリを追加する

次のコマンドを使用してアイデンティティマッピングを作成することもできます。詳細については、eksctlドキュメントの「IAM ユーザーとロールの管理」を参照してください。

eksctl create iamidentitymapping \
                 --arn arn:aws:iam::123456789012:role/fis-experiment-role \
                 --username fis-experiment \
                 --cluster my-cluster

ポッドコンテナイメージ

FIS が提供する Pod AWS コンテナイメージは Amazon ECR でホストされます。Amazon ECR からイメージを参照する場合は、イメージに完全なイメージの URI を使用する必要があります

ポッドコンテナイメージは、AWS ECR Public Gallery でも使用できます。

実験テンプレートの例

以下は、aws:eks:pod-network-latency アクションに対する実験テンプレートの例です。

{
    "description": "Add latency and jitter to the network interface for the target EKS Pods",
    "targets": {
        "myPods": {
            "resourceType": "aws:eks:pod",
            "parameters": {
                "clusterIdentifier": "mycluster",
                "namespace": "default",
                "selectorType": "labelSelector",
                "selectorValue": "mylabel=mytarget"
            },
            "selectionMode": "COUNT(3)"
        }
    },
    "actions": {
        "EksPod-latency": {
            "actionId": "aws:eks:pod-network-latency",
            "description": "Add latency",
            "parameters": {
                "kubernetesServiceAccount": "myserviceaccount",
                "duration": "PT5M",
                "delayMilliseconds": "200",
                "jitterMilliseconds": "10",
                "sources": "0.0.0.0/0"
            },
            "targets": {
                "Pods": "myPods"
            }
        }
    },
    "stopConditions": [
        {
            "source": "none",
        }
    ],
    "roleArn": "arn:aws:iam::111122223333:role/fis-experiment-role",
    "tags": {
        "Name": "EksPodNetworkLatency"
    }
}