Skip to content

Commit cc7ddb3

Browse files
jermthjermth
authored
Merge branch 'master' into patch-1
2 parents 3838970 + ea25ad1 commit cc7ddb3

File tree

4 files changed

+413
-377
lines changed

4 files changed

+413
-377
lines changed

‎Lab1/Tutorial.md

+56-44
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,17 @@ for orchestrating HPC clusters in Azure.
66
Please send questions or comments to [the Azure CycleCloud PM team](mailto:[email protected]).
77

88
## Goals
9+
10+
In this lab you will learn how to:
11+
912
* Create a fully functional, configured Azure CycleCloud instance that can be
10-
used for further labs, pilot deployments, etc.
11-
* Learn how to configure and deploy a LAMMPS HPC cluster, one of the standard
13+
used for further labs, pilot deployments, etc.
14+
* Configure and deploy a LAMMPS HPC cluster, one of the standard
1215
cluster types included with Azure CycleCloud.
1316

1417
## Pre-requisites
15-
* Standard lab
16-
[prerequisites](https://github.com/CycleCloud/cyclecloud_tutorials/blob/master/README.md#prerequisites)
17-
18+
19+
* Standard lab [prerequisites](/README.md#prerequisites)
1820

1921
## 1. Starting An Azure CycleCloud Server
2022

@@ -30,8 +32,9 @@ As you follow the steps below, *please keep track of the following*:
3032
CycleCloud web UI for your user.
3133

3234

33-
### 1.1 Log into (Azure Cloud Shell)[https://shell.azure.com]
34-
```
35+
### 1.1 Log into [Azure Cloud Shell](https://shell.azure.com)
36+
37+
```sh
3538
Requesting a Cloud Shell.Succeeded.
3639
Connecting terminal...
3740

@@ -43,44 +46,52 @@ ellen@Azure:~$
4346
```
4447

4548
### 1.2 Figure out your username
46-
```
49+
50+
```sh
4751
ellen@Azure:~$ whoami
4852
ellen
4953
ellen@Azure:~$
5054
```
5155

5256
### 1.3 Generate an SSH keypair (if you do not already have one)
57+
5358
* In Cloud Shell, run:
54-
```
55-
ellen@Azure:~$ ssh-keygen -f ~/.ssh/id_rsa -N "" -b 4096
56-
Generating public/private rsa key pair.
57-
Your identification has been saved in /home/ellen/.ssh/id_rsa.
58-
Your public key has been saved in /home/ellen/.ssh/id_rsa.pub.
59-
The key fingerprint is:
60-
SHA256:L8DFLyfXbKQT5PZZFwTGFnAY4ODCtYFyhGhoHFTpbKM ellen@cc-c6733553-7b96c85fb8-hbmlw
61-
The key's randomart image is:
62-
+---[RSA 4096]----+
63-
|+o+.+..+ .oo==+o |
64-
|.= +.oo.=o .oo .|
65-
|o o oo oo.+ o . .|
66-
| = ... o B o . |
67-
| o . o S * * |
68-
| E . * o |
69-
| . . |
70-
| . |
71-
| |
72-
+----[SHA256]-----+
73-
ellen@Azure:~$
74-
```
59+
60+
```sh
61+
ellen@Azure:~$ ssh-keygen -f ~/.ssh/id_rsa -N "" -b 4096
62+
Generating public/private rsa key pair.
63+
Your identification has been saved in /home/ellen/.ssh/id_rsa.
64+
Your public key has been saved in /home/ellen/.ssh/id_rsa.pub.
65+
The key fingerprint is:
66+
SHA256:L8DFLyfXbKQT5PZZFwTGFnAY4ODCtYFyhGhoHFTpbKM ellen@cc-c6733553-7b96c85fb8-hbmlw
67+
The key's randomart image is:
68+
+---[RSA 4096]----+
69+
|+o+.+..+ .oo==+o |
70+
|.= +.oo.=o .oo .|
71+
|o o oo oo.+ o . .|
72+
| = ... o B o . |
73+
| o . o S * * |
74+
| E . * o |
75+
| . . |
76+
| . |
77+
| |
78+
+----[SHA256]-----+
79+
ellen@Azure:~$
80+
```
81+
7582
### 1.4 Retrieve the SSH-pubkey
76-
```
77-
ellen@Azure:~$ cat ~/.ssh/id_rsa.pub
78-
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCwIvmC4K/0BUwOBqCsPxw5Ht8qWyDkorrU+gc6cJbohREoMFZkMlGEe2XqIyYTpHAu0ISicZEJ4MoWExPFrrZRqoYAHPrHyNnie9tVR5UMkqzNhs31qEWLtfEBOrcJIsPNdFuvnAqiQnhMQut3Jtamjc3XnMU8kJ3yL/+xIU4vKkQ8XIey+GGowR69oJI37mYKr9jT9dejB4gP2l6JyrVehnOG6QXRtg/gzFgyX08u8wKhuohNIPLlf2VzIXQml69P9PcD3muePIxi/JsJ6hb6czMCqhyHSFA42XpUpeWTml41HuBO9R5Bcsb3Q3j4MTKQOjtssz9Dx3pwtZ+tn9mg8TLMsk9d3Ip8FVXbe9ABleutJLIYGIUcZ3GlMdnRP62Wdyzrh0VEsoCfkHjUq2qFo8Hd1j0bkR1coSr2vFZXz6my+92a8nX7dJMPH5y+DG+ZuZchBXrwy8xVSNccnqRRn1A5xKdxY5SusbUQEirYPS7oR64CH4QeH6d5iQ2p2Z2cVWYbz/DjJNoCF0Cbzp9w1KprpErlrtd1epIGQTUDgx4YhChyrdXQiYCJBJ1jvhJcWfKj6rHz94eTEr6S5W4etP/IuACqKTpmAxQqSdU7NdHZVPH8c6w89JX3DAYRjg0PKVm56Ib6C+kct8M6/NQQeyhi5DM0SGW+T7tBjDxsUQ== ellen@cc-c6733553-7b96c85fb8-hbmlw
79-
ellen@Azure:~$
80-
```
81-
### 1.5 Create a service principal
83+
84+
```sh
85+
ellen@Azure:~$ cat ~/.ssh/id_rsa.pub
86+
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCwIvmC4K/0BUwOBqCsPxw5Ht8qWyDkorrU+gc6cJbohREoMFZkMlGEe2XqIyYTpHAu0ISicZEJ4MoWExPFrrZRqoYAHPrHyNnie9tVR5UMkqzNhs31qEWLtfEBOrcJIsPNdFuvnAqiQnhMQut3Jtamjc3XnMU8kJ3yL/+xIU4vKkQ8XIey+GGowR69oJI37mYKr9jT9dejB4gP2l6JyrVehnOG6QXRtg/gzFgyX08u8wKhuohNIPLlf2VzIXQml69P9PcD3muePIxi/JsJ6hb6czMCqhyHSFA42XpUpeWTml41HuBO9R5Bcsb3Q3j4MTKQOjtssz9Dx3pwtZ+tn9mg8TLMsk9d3Ip8FVXbe9ABleutJLIYGIUcZ3GlMdnRP62Wdyzrh0VEsoCfkHjUq2qFo8Hd1j0bkR1coSr2vFZXz6my+92a8nX7dJMPH5y+DG+ZuZchBXrwy8xVSNccnqRRn1A5xKdxY5SusbUQEirYPS7oR64CH4QeH6d5iQ2p2Z2cVWYbz/DjJNoCF0Cbzp9w1KprpErlrtd1epIGQTUDgx4YhChyrdXQiYCJBJ1jvhJcWfKj6rHz94eTEr6S5W4etP/IuACqKTpmAxQqSdU7NdHZVPH8c6w89JX3DAYRjg0PKVm56Ib6C+kct8M6/NQQeyhi5DM0SGW+T7tBjDxsUQ== ellen@cc-c6733553-7b96c85fb8-hbmlw
87+
ellen@Azure:~$
88+
```
89+
90+
### <a name="1.5"></a>1.5 Create a service principal
91+
8292
Substitute a custom value for `cyclecloudlabs` as the name of your service principal. The name must be unique across all of Azure.
83-
```
93+
94+
```sh
8495
ellen@Azure:~$ az ad sp create-for-rbac --name cyclecloudlabs
8596
{
8697
"appId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
@@ -90,7 +101,8 @@ ellen@Azure:~$ az ad sp create-for-rbac --name cyclecloudlabs
90101
"tenant": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
91102
}
92103
```
93-
_Save this output somewhere. You will need it in the section below as well as in future tutorials in this lab._
104+
105+
_Save this output somewhere. You will need it in the section below as well as later in this lab and in other labs._
94106
95107
### 1.6 Deploy Azure CycleCloud
96108
[![Deploy to
@@ -133,10 +145,10 @@ ellen@Azure:~$
133145
like and then click "Next".![First Login](images/cc-first-login.png)
134146
* Accept the End-User License Agreement and click "Next".
135147
* Create an admin user:
136-
- For the User ID, use the same `username` used above in step 1.5. Remember
137-
that this is also the username of your Cloud Shell session.
138-
- Enter a name for the user.
139-
- Enter and confirm a new password that meets the minimum requirements.
148+
* For the User ID, use the same `username` used above in step 1.5. Remember
149+
that this is also the username of your Cloud Shell session.
150+
* Enter a name for the user.
151+
* Enter and confirm a new password that meets the minimum requirements.
140152
141153
![Create Account](images/cc-create-account.png)
142154
@@ -165,7 +177,7 @@ LAMMPS as a solver.
165177
* Click the "Save" button on the bottom to create this cluster.
166178
* Click the "Start" button to provision the cluster resources in Azure.
167179
![CC Cluster Prepared](images/cc-cluster-prepared.png)
168-
- Starting up the cluster for the first time takes about 10 minutess. By
180+
* Starting up the cluster for the first time takes about 10 minutess. By
169181
default, only the master (or "head") node of the cluster is started. Azure
170182
CycleCloud provisions all the necessary network and storage resources needed
171183
by the master node, and also sets up the scheduling environment in the
@@ -174,7 +186,7 @@ LAMMPS as a solver.
174186
for the green status bar before proceeding to the next step.
175187
![CC Cluster Ready](images/cc-cluster-ready.png)
176188
177-
### 2.2 Connecting to the master node and submitting a LAMMPS job
189+
### <a name="2.2"></a> 2.2 Connecting to the master node and submitting a LAMMPS job
178190
179191
The SSH public key you specified as part of the deployment is stored in the Azure CycleCloud application server and pushed into each cluster that you create. As a result, you can use your SSH private key to log into the
180192
master node.
@@ -272,4 +284,4 @@ master node.
272284
* Continue to [Lab 2 - Customizing an HPC cluster template](/Lab2/Tutorial.md),
273285
or
274286
* Click on the "Terminate" button to terminate the cluster until you need it
275-
again.
287+
again.

0 commit comments

Comments
 (0)