ClearML/clearml-docs
1
0
Fork 0
mirror of https://github.com/clearml/clearml-docs synced 2025-02-07 05:20:07 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Small edits (#185)

Browse Source
This commit is contained in:
pollfly 2022-02-17 14:09:17 +02:00 committed by GitHub
parent 17f447b7a8
commit 4b15c46f23
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 38 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
docs/clearml_agent.md
View File

@ -10,7 +10,7 @@ Its main focus is around:
**ClearML Agent** executes an experiment or other workflow by reproducing the state of the code from the original machine
to a remote machine.
![image](img/clearml_agent_flow_diagram.png)
![ClearML Agent flow diagram](img/clearml_agent_flow_diagram.png)
The diagram above demonstrates a typical flow where an agent executes a task:
@ -62,13 +62,14 @@ Install ClearML Agent as a system Python package and not in a Python virtual env
```
The setup wizard prompts for ClearML credentials (see [here](webapp/webapp_profile.md#clearml-credentials) about obtaining credentials).
```
Please create new clearml credentials through the settings page in your `clearml-server` web app,
or create a free account at https://app.clear.ml/settings/webapp-configuration
CLEARML-AGENT setup process
In the settings > workspace page, press "Create new credentials", then press "Copy to clipboard".
Please create new clearml credentials through the profile page in your clearml web app (e.g., https://demoapp.demo.clear.ml/profile)
In the profile page, press "Create new credentials", then press "Copy to clipboard".
Paste copied configuration here:
Paste copied configuration here:
```
If the setup wizard's response indicates that a configuration file already exists, follow the instructions [here](#adding-clearml-agent-to-a-configuration-file).
The wizard does not edit or overwrite existing configuration files.
@ -76,13 +77,17 @@ Install ClearML Agent as a system Python package and not in a Python virtual env
1. At the command prompt `Paste copied configuration here:`, copy and paste the ClearML credentials and press **Enter**.
The setup wizard confirms the credentials.
Detected credentials key="********************" secret="*******"
```
Detected credentials key="********************" secret="*******"
```
1. **Enter** to accept default server URL, which is detected from the credentials or enter a ClearML web server URL.
A secure protocol, https, must be used. **Do not use http.**
WEB Host configured to: [https://app.community.clear.ml]
```
WEB Host configured to: [https://app.clear.ml]
```
:::note
If you are using a self-hosted ClearML Server, the default URL will use your domain.
@ -91,37 +96,41 @@ Install ClearML Agent as a system Python package and not in a Python virtual env
1. Do as above for API, URL, and file servers.
1. The wizard responds with your configuration:
CLEARML Hosts configuration:
Web App: https://app.community.clear.ml
API: https://demoapi.clearml.allegro.ai
File Store: https://demofiles.clearml.allegro.ai
```
CLEARML Hosts configuration:
Web App: https://app.clear.ml
API: https://api.clear.ml
File Store: https://files.clear.ml
Verifying credentials ...
Credentials verified!
Verifying credentials ...
Credentials verified!
```
1. Enter your Git username and password. Leave blank for SSH key authentication or when only using public repositories.
This is needed for cloning repositories by the agent.
Enter git username for repository cloning (leave blank for SSH key authentication): []
Enter password for user '<username>':
The setup wizard confirms your git credentials.
Git repository cloning will be using user=<username> password=<password>
```
Enter git username for repository cloning (leave blank for SSH key authentication): []
Enter password for user '<username>':
```
The setup wizard confirms your git credentials.
```
Git repository cloning will be using user=<username> password=<password>
```
1. Enter an additional artifact repository, or press **Enter** if not required.
This is needed for installing Python packages not found in pypi.
Enter additional artifact repository (extra-index-url) to use when installing python packages (leave blank if not required):
```
Enter additional artifact repository (extra-index-url) to use when installing python packages (leave blank if not required):
```
The setup wizard completes.
New configuration stored in /home/<username>/clearml.conf
CLEARML-AGENT setup completed successfully.
```
New configuration stored in /home/<username>/clearml.conf
CLEARML-AGENT setup completed successfully.
```
The configuration file location depends upon the operating system:
* Linux - `~/clearml.conf`

1
docs/guides/ui/building_leader_board.md
View File

@ -18,7 +18,6 @@ Bookmark the leaderboard in the browser to reuse and share the leaderboard URL w
For this tutorial, use one of the following as a project:
* Recommended: One of your projects with more than one experiment.
* A project on the demo **ClearML Server** ([https://demoapp.demo.clear.ml/profile](https://demoapp.demo.clear.ml/profile)).
* Clone the [clearml](https://github.com/allegroai/clearml) repository and execute some of the example scripts.
## Step 1: Select a Project