JEG ポッドのノードグループへのデプロイ

JEG (Jupyter Enterprise Gateway) ポッド配置は、特定のノードグループにインタラクティブエンドポイントをデプロイできるようにする機能です。この機能により、インタラクティブエンドポイントの instance type などの設定を行うことができます。

マネージドノードグループに JEG ポッドを関連付ける

次の設定プロパティでは、JEG ポッドをデプロイする Amazon EKS クラスター上のマネージドノードグループの名前を指定できます。

//payload 
--configuration-overrides '{
      "applicationConfiguration": [
            {
                "classification": "endpoint-configuration",
                "properties": {
                    "managed-nodegroup-name": NodeGroupName
                }        
            }
        ] 
    }'

ノードグループには、ノードグループに含まれるすべてのノードに Kubernetes ラベル for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName がアタッチされている必要があります。このタグを持つノードグループのすべてのノードをリストするには、次のコマンドを使用します。

kubectl get nodes --show-labels | grep for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName

上記のコマンドの出力でマネージドノードグループの一部であるノードが返されない場合は、for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName Kubernetes ラベルがアタッチされたノードがノードグループにありません。この場合、以下の手順に従って、そのラベルをノードグループ内のノードにアタッチします。

マネージドノードグループは Amazon EKS クラスターのセキュリティグループに関連付ける必要があります。通常、eksctl を使用してクラスターとマネージドノードグループを作成した場合にこれが当てはまります。次の手順を使用して、AWS コンソールでこれを確認できます。

マネージドノードグループが Amazon EKS クラスターセキュリティグループにアタッチされていない場合は、for-use-with-emr-containers-managed-endpoint-sg=ClusterName/NodeGroupName タグをノードグループのセキュリティグループにアタッチする必要があります。このタグをアタッチするには、次の手順を使用します。

セルフマネージドノードグループに JEG ポッドを関連付ける

次の設定プロパティでは、JEG ポッドがデプロイされる Amazon EKS クラスター上のセルフマネージドノードグループまたはアンマネージドノードグループの名前を指定できます。

//payload 
--configuration-overrides '{
      "applicationConfiguration": [
            {
                "classification": "endpoint-configuration",
                "properties": {
                    "self-managed-nodegroup-name": NodeGroupName
                }        
            }
        ] 
    }'

ノードグループには、ノードグループに含まれるすべてのノードに for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName Kubernetes ラベルがアタッチされている必要があります。このタグを持つノードグループのすべてのノードをリストするには、次のコマンドを使用します。

kubectl get nodes --show-labels | grep for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName

上記のコマンドの出力でセルフマネージドノードグループの一部であるノードが返されない場合は、for-use-with-emr-containers-managed-endpoint-ng=NodeGroupName Kubernetes ラベルがアタッチされたノードがノードグループにありません。この場合、以下の手順に従って、そのラベルをノードグループ内のノードにアタッチします。

セルフマネージドノードグループのセキュリティグループには for-use-with-emr-containers-managed-endpoint-sg=ClusterName/NodeGroupName タグがアタッチされている必要があります。次の手順に従って、AWS Management Consoleからセキュリティグループにタグをアタッチします。

オンデマンドインスタンスがあるマネージドノードグループに JEG ポッドを関連付ける

Kubernetes ラベルセレクターと呼ばれる追加のラベルを定義して、特定のノードまたはノードグループでインタラクティブエンドポイントを実行するための追加の制約や制限を指定することもできます。次の例は、JEG ポッドにオンデマンド Amazon EC2 インスタンスを使用する方法を示しています。

--configuration-overrides '{
      "applicationConfiguration": [
            {
                "classification": "endpoint-configuration",
                "properties": {
                    "managed-nodegroup-name": NodeGroupName,
                    "node-labels": "eks.amazonaws.com/capacityType:ON_DEMAND"
                }        
            }
        ] 
    }'