2018-02-24 06:03:34 +03:00
|
|
|
# A01 - The CLI for ADX Automation System
|
|
|
|
|
|
|
|
|
|
## Prerequisite
|
|
|
|
|
|
|
|
|
|
- Install [Python 3.6](https://www.python.org/downloads/)
|
|
|
|
|
- Install [Docker CE](https://www.docker.com/community-edition#/download)
|
|
|
|
|
- Install [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)
|
|
|
|
|
- Run `az aks install-cli` to install Kubectl using Azure CLI
|
|
|
|
|
- Run `az login` to login Azure using Azure CLI. Please use the corp account.
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
2018-02-28 09:07:51 +03:00
|
|
|
- Path to the latest version can be found here: https://a01tools.blob.core.windows.net/client/latest
|
2018-02-24 08:11:05 +03:00
|
|
|
- Note:
|
|
|
|
|
- Through virtual environment is not required, it is nevertheless included in following examples as a good practice.
|
|
|
|
|
- The earlier version can be found at https://a01tools.blob.core.windows.net/client/archive/adx_automation_cli-{VERSION}-py3-none-any.whl
|
2018-02-24 06:03:34 +03:00
|
|
|
|
|
|
|
|
### Bash
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
|
|
|
|
$ virtualenv env --python=python3
|
|
|
|
|
$ . env/bin/activate
|
2018-02-28 09:05:53 +03:00
|
|
|
$ curl -s https://a01tools.blob.core.windows.net/client/latest | xargs pip install
|
2018-02-24 06:03:34 +03:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Windows
|
|
|
|
|
|
2018-02-28 09:05:53 +03:00
|
|
|
- In a browser navigate to https://a01tools.blob.core.windows.net/client/latest
|
|
|
|
|
- Write down the path
|
|
|
|
|
|
2018-02-24 06:03:34 +03:00
|
|
|
```cmd
|
|
|
|
|
|
|
|
|
|
> python -m virtualenv env --python=python3.6
|
|
|
|
|
> env\Scripts\activate
|
2018-02-28 09:05:53 +03:00
|
|
|
> pip install <path>
|
2018-02-24 06:03:34 +03:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Initialize
|
|
|
|
|
|
|
|
|
|
- Run `a01 check` to validate environment.
|
2018-03-13 08:43:53 +03:00
|
|
|
- Run `a01 login --endpoint secondapi.azclitest.com` to login.
|
|
|
|
|
- Run `az aks get-credentials -g adx-automation-a01 -n adx-automation` to get cluster creds.
|
2018-02-23 10:26:12 +03:00
|
|
|
|
2018-02-27 07:18:08 +03:00
|
|
|
## Onboard your own tests
|
|
|
|
|
|
2018-02-28 09:05:53 +03:00
|
|
|
Find onboard documentation [here](/docs/onboard.md).
|
2018-02-27 07:18:08 +03:00
|
|
|
|
2018-02-23 10:26:12 +03:00
|
|
|
# Contributing
|
|
|
|
|
|
|
|
|
|
This project welcomes contributions and suggestions. Most contributions require you to agree to a
|
|
|
|
|
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
|
|
|
|
|
the rights to use your contribution. For details, visit https://cla.microsoft.com.
|
|
|
|
|
|
|
|
|
|
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
|
|
|
|
|
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
|
|
|
|
|
provided by the bot. You will only need to do this once across all repos using our CLA.
|
|
|
|
|
|
|
|
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
|
|
|
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
|
|
|
|
|
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
