aws-samples / aws-samples/aws-hpc-tutorials

Adding clarification to the networking in the "b. Create a distributed ML cluster" section

Open
#243 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
85
Forks
77
PR merge metrics
No merged PRs in 30d

Description

In the section, ["b. Create a distributed ML cluster"](https://www.hpcworkshops.com/08-ml-on-parallelcluster/01-create-ml-cluster.html), it has the user run these commands.

```
# create the cluster configuration
export IFACE=$(curl --silent http://169.254.169.254/latest/meta-data/network/interfaces/macs/)
export SUBNET_ID=$(curl --silent http://169.254.169.254/latest/meta-data/network/interfaces/macs/${IFACE}/subnet-id)
export VPC_ID=$(curl --silent http://169.254.169.254/latest/meta-data/network/interfaces/macs/${IFACE}/vpc-id)
export AZ=$(curl http://169.254.169.254/latest/meta-data/placement/availability-zone)
export REGION=${AZ::-1}
```

However, it does not provide an explanation regarding what these commands are for and what issues could arise based on these commands. I purposes adding the following information directly before this block.

"The following exports a number of variables that are used to set the VPC and subnet that the Head and Compute nodes will be launched into. These will use the VPC and Subnet of the instance where these commands are being run. Please review the networking requirments [here](https://docs.aws.amazon.com/parallelcluster/latest/ug/network-configuration-v3.html#network-configuration-v3-single-subnet) for setting up Parallel Cluster in a single public subnet to make sure your subnet meets the requirments"

Additionally, there is a typo in the ml-config.yaml where, in the HeadNode.Dcv Enabled is spelled Emabled.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.