CLI AWS の使用

ライフサイクル設定スクリプトを準備し、s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/ などの S3 バケットにアップロードします。次のステップ 2 では、指定された S3 バケットに on_create.sh という名前のエントリポイントスクリプトがあることを前提としています。

CreateCluster API リクエストファイルを JSON 形式で準備します。一連のライフサイクルスクリプトの実行の一環としてクラスターの作成時に使用される provisioning_params.json ファイルで設計する Slurm クラスターと一致するようにインスタンスグループを設定する必要があります。詳細については、「ライフサイクルスクリプトを使用して SageMaker HyperPod クラスターをカスタマイズする」を参照してください。次のテンプレートには、Slurm クラスターの最小要件を満たすための 2 つのインスタンスグループがあります。つまり、1 つのコントローラー (ヘッド) ノードと 1 つのコンピューティング (ワーカー) ノードです。ExecutionRole には、セクション SageMaker HyperPod の IAM ロール から マネージド AmazonSageMakerClusterInstanceRolePolicy で作成した IAM ロールの ARN を指定します。

// create_cluster.json
{
    "ClusterName": "your-hyperpod-cluster",
    "InstanceGroups": [
        {
            "InstanceGroupName": "controller-group",
            "InstanceType": "ml.m5.xlarge",
            "InstanceCount": 1,
            "LifeCycleConfig": {
                "SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
                "OnCreate": "on_create.sh"
            },
            "ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster",
            // Optional: Configure an additional storage per instance group.
            "InstanceStorageConfigs": [
                {
                   // Attach an additional EBS volume to each instance within the instance group.
                   // The default mount path for the additional EBS volume is /opt/sagemaker.
                   "EbsVolumeConfig":{
                      // Specify an integer between 1 and 16384 in gigabytes (GB).
                      "VolumeSizeInGB": integer,
                   }
                }
            ]
        }, 
        {
            "InstanceGroupName": "worker-group-1",
            "InstanceType": "ml.p4d.xlarge",
            "InstanceCount": 1,
            "LifeCycleConfig": {
                "SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
                "OnCreate": "on_create.sh"
            },
            "ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster"
        }
    ],
    // Optional
    "Tags": [ 
        { 
           "Key": "string",
           "Value": "string"
        }
    ],
    // Optional
    "VpcConfig": { 
        "SecurityGroupIds": [ "string" ],
        "Subnets": [ "string" ]
    }
}

ライフサイクルスクリプトを使用してクラスター構造を設計する方法に応じて、InstanceGroups パラメータで最大 20 個のインスタンスグループを設定できます。

Tags リクエストパラメータには、SageMaker HyperPod クラスターを AWS リソースとして管理するためのカスタムタグを追加できます。タグ付けをサポートする他の AWS サービスでタグを追加するのと同じ方法で、クラスターにタグを追加できます。 AWS リソースのタグ付け全般の詳細については、AWS 「 リソースのタグ付けユーザーガイド」を参照してください。

VpcConfig リクエストパラメータでは、使用する VPC の情報を指定します。詳細については、「Amazon VPC で SageMaker HyperPod をセットアップする」を参照してください。

次のように create-cluster コマンドを実行します。

aws sagemaker create-cluster \
    --cli-input-json file://complete/path/to/create_cluster.json

これにより、新しいクラスターの ARN が返されます。