Skip to content
This repository was archived by the owner on Feb 3, 2021. It is now read-only.

Commit 7ef721f

Browse files
authored
Feature: getting started script (#475)
* initial changes for getting started scripts * add temp error handling * rename file - fix typo * add debug strings * add handling for existing user * WIP: wait for subprocess to complete to get exit code * WIP: handle existing user and refactor code * WIP: add missing return statements * WIP: fix typo * start sdk refactor * mostly working create * working happy create path * handle errors for vnet, aad application * make account setup interactive * add prompt * add docs * rename account_setup_refac to account_setup * add some logging * pip install msrest, azure-cli-core, import issues * remove in script pip, add shell wrapper program * ellipsis to period * update branch name for account_setup.sh * docstring * retry resource group creation * fix typo, update retry * explicitly set output location * wget overwrite flag, docs update * add prompt for multi tenants * fix bug with batch account creation * add spinner, print statements, fix formatting bug * fix param bug
1 parent 44a0765 commit 7ef721f

File tree

6 files changed

+494
-50
lines changed

6 files changed

+494
-50
lines changed

README.md

Lines changed: 12 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -16,28 +16,24 @@ This toolkit is built on top of Azure Batch but does not require any Azure Batch
1616
- Ability to run _spark submit_ directly from your local machine's CLI
1717

1818
## Setup
19-
1. Clone the repo
20-
```bash
21-
git clone -b stable https://www.github.com/azure/aztk
2219

23-
# You can also clone directly from master to get the latest bits
24-
git clone https://www.github.com/azure/aztk
25-
```
26-
2. Use pip to install required packages (requires python 3.5+ and pip 9.0.1+)
27-
```bash
28-
pip install -r requirements.txt
29-
```
30-
3. Use setuptools:
20+
1. Install `aztk` with pip:
3121
```bash
32-
pip install -e .
22+
pip install aztk
3323
```
34-
4. Initialize the project in a directory [This will automatically create a *.aztk* folder with config files in your working directory]:
24+
2. Initialize the project in a directory. This will automatically create a *.aztk* folder with config files in your working directory:
3525
```bash
3626
aztk spark init
3727
```
38-
5. Fill in the fields for your Batch account and Storage account in your *.aztk/secrets.yaml* file. (We'd also recommend that you enter SSH key info in this file)
28+
3. Login or register for an [Azure Account](https://azure.microsoft.com), navigate to [Azure Cloud Shell](https://shell.azure.com), and run:
29+
```sh
30+
wget -q https://raw.githubusercontent.com/Azure/aztk/master/account_setup.sh -O account_setup.sh &&
31+
chmod 755 account_setup.sh &&
32+
/bin/bash account_setup.sh
33+
```
34+
35+
4. Follow the on screen prompts to create the necessary Azure resources and copy the output into your `.aztk/secrets.yaml` file. For more infomration see [Getting Started Scripts](./01-Getting-Started-Script).
3936

40-
This package is built on top of two core Azure services, [Azure Batch](https://azure.microsoft.com/en-us/services/batch/) and [Azure Storage](https://azure.microsoft.com/en-us/services/storage/). Create those resources via the portal (see [Getting Started](./docs/00-getting-started.md)).
4137

4238
## Quickstart Guide
4339

@@ -55,7 +51,7 @@ aztk spark cluster list
5551
aztk spark cluster delete
5652
```
5753
```sh
58-
# login and submit jobs to your cluster
54+
# login and submit applications to your cluster
5955
aztk spark cluster ssh
6056
aztk spark cluster submit
6157
```

0 commit comments

Comments
 (0)