Class: Aws::SageMaker::Types::ClusterInstanceGroupSpecification

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-sagemaker/types.rb

Overview

The specifications of an instance group that you need to define.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#execution_roleString

Specifies an IAM execution role to be assumed by the instance group.

Returns:

  • (String)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#instance_countInteger

Specifies the number of instances to add to the instance group of a SageMaker HyperPod cluster.

Returns:

  • (Integer)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#instance_group_nameString

Specifies the name of the instance group.

Returns:

  • (String)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#instance_storage_configsArray<Types::ClusterInstanceStorageConfig>

Specifies the additional storage configurations for the instances in the SageMaker HyperPod cluster instance group.



4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#instance_typeString

Specifies the instance type of the instance group.

Returns:

  • (String)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#life_cycle_configTypes::ClusterLifeCycleConfig

Specifies the LifeCycle configuration for the instance group.



4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#on_start_deep_health_checksArray<String>

A flag indicating whether deep health checks should be performed when the cluster instance group is created or updated.

Returns:

  • (Array<String>)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#override_vpc_configTypes::VpcConfig

To configure multi-AZ deployments, customize the Amazon VPC configuration at the instance group level. You can specify different subnets and security groups across different AZs in the instance group specification to override a SageMaker HyperPod cluster’s default Amazon VPC configuration. For more information about deploying a cluster in multiple AZs, see [Setting up SageMaker HyperPod clusters across multiple AZs].

<note markdown=“1”> When your Amazon VPC and subnets support IPv6, network communications differ based on the cluster orchestration platform:

* Slurm-orchestrated clusters automatically configure nodes with
 dual IPv6 and IPv4 addresses, allowing immediate IPv6 network
 communications.
  • In Amazon EKS-orchestrated clusters, nodes receive dual-stack addressing, but pods can only use IPv6 when the Amazon EKS cluster is explicitly IPv6-enabled. For information about deploying an IPv6 Amazon EKS cluster, see [Amazon EKS IPv6 Cluster Deployment].

Additional resources for IPv6 configuration:

* For information about adding IPv6 support to your VPC, see to
 [IPv6 Support for VPC][3].
  • For information about creating a new IPv6-compatible VPC, see [Amazon VPC Creation Guide].

  • To configure SageMaker HyperPod with a custom Amazon VPC, see [Custom Amazon VPC Setup for SageMaker HyperPod].

</note>

[1]: docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-hyperpod-prerequisites.html#sagemaker-hyperpod-prerequisites-multiple-availability-zones [2]: docs.aws.amazon.com/eks/latest/userguide/deploy-ipv6-cluster.html#_deploy_an_ipv6_cluster_with_eksctl [3]: docs.aws.amazon.com/vpc/latest/userguide/vpc-migrate-ipv6.html [4]: docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html [5]: docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-hyperpod-prerequisites.html#sagemaker-hyperpod-prerequisites-optional-vpc

Returns:



4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#threads_per_coreInteger

Specifies the value for **Threads per core**. For instance types that support multithreading, you can specify ‘1` for disabling multithreading and `2` for enabling multithreading. For instance types that doesn’t support multithreading, specify ‘1`. For more information, see the reference table of [CPU cores and threads per CPU core per instance type] in the *Amazon Elastic Compute Cloud User Guide*.

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/cpu-options-supported-instances-values.html

Returns:

  • (Integer)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#training_plan_arnString

The Amazon Resource Name (ARN); of the training plan to use for this cluster instance group.

For more information about how to reserve GPU capacity for your SageMaker HyperPod clusters using Amazon SageMaker Training Plan, see ‘ CreateTrainingPlan `.

Returns:

  • (String)


4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
# File 'lib/aws-sdk-sagemaker/types.rb', line 4419

class ClusterInstanceGroupSpecification < Struct.new(
  :instance_count,
  :instance_group_name,
  :instance_type,
  :life_cycle_config,
  :execution_role,
  :threads_per_core,
  :instance_storage_configs,
  :on_start_deep_health_checks,
  :training_plan_arn,
  :override_vpc_config)
  SENSITIVE = []
  include Aws::Structure
end