clearml-docs/docs/deploying_clearml/clearml_server.md

63 lines
2.7 KiB
Markdown
Raw Normal View History

2021-05-13 23:48:51 +00:00
---
title: ClearML Server
---
## What is ClearML Server?
2022-05-19 06:59:10 +00:00
The ClearML Server is the backend service infrastructure for ClearML. It allows multiple users to collaborate and
2022-01-19 12:26:14 +00:00
manage their experiments by working seamlessly with the ClearML Python package and [ClearML Agent](../clearml_agent.md).
2021-05-13 23:48:51 +00:00
2022-01-19 12:26:14 +00:00
ClearML Server is composed of the following:
* Web server including the [ClearML Web UI](../webapp/webapp_overview.md), which is the user interface for tracking, comparing, and managing experiments.
* API server which is a RESTful API for:
2021-05-13 23:48:51 +00:00
* Documenting and logging experiments, including information, statistics, and results.
* Querying experiments history, logs, and results.
2022-01-19 12:26:14 +00:00
* File server which stores media and models making them easily accessible using the ClearML Web UI.
2021-05-13 23:48:51 +00:00
2022-01-19 12:37:16 +00:00
The [**ClearML Hosted Service**](https://app.clear.ml) is essentially the ClearML Server maintained for you.
2021-05-13 23:48:51 +00:00
![image](../img/ClearML_Server_Diagram.png)
2022-01-19 12:26:14 +00:00
The ClearML Web UI is the ClearML user interface and is part of ClearML Server.
2021-05-13 23:48:51 +00:00
2022-01-19 12:26:14 +00:00
Use the ClearML Web UI to:
2021-05-13 23:48:51 +00:00
* Track experiments
* Compare experiments
* Manage experiments
2022-01-19 12:26:14 +00:00
For detailed information about the ClearML Web UI, see [User Interface](../webapp/webapp_overview.md).
2021-05-13 23:48:51 +00:00
2024-07-15 12:53:41 +00:00
ClearML Server also comes with a [services agent](../clearml_agent/clearml_agent_services_mode.md) preinstalled.
2021-05-13 23:48:51 +00:00
## Deployment
2022-01-19 12:26:14 +00:00
The ClearML Server can be deployed in any of the formats listed below. Once deployed, configure the server for web login
2022-09-04 07:17:44 +00:00
authentication, subdomains, and load balancers, and use any of its many configuration settings.
2021-05-13 23:48:51 +00:00
**To deploy your own ClearML Server:**
1. Deploy ``clearml-server`` using any of the available formats, which include:
* Pre-built [AWS EC2 AMIs](clearml_server_aws_ec2_ami.md)
* Pre-built [Google Cloud Platform custom images](clearml_server_gcp.md)
* Pre-built Docker images for [Linux](clearml_server_linux_mac.md), [macOS](clearml_server_linux_mac.md), and
[Windows 10](clearml_server_win.md)
* [Kubernetes using Helm](clearml_server_kubernetes_helm.md)
2021-05-13 23:48:51 +00:00
2022-09-04 07:17:44 +00:00
1. Optionally, [configure ClearML Server](clearml_server_config.md) for additional features, including subdomains and load balancers,
2021-05-13 23:48:51 +00:00
web login authentication, and the non-responsive task watchdog.
2024-04-30 12:31:05 +00:00
1. [Connect the ClearML SDK to the ClearML Server](../getting_started/ds/ds_first_steps.md)
2021-05-13 23:48:51 +00:00
## Updating
When necessary, upgrade your ClearML Server on any of the available formats:
* [AWS EC2 AMIs](upgrade_server_aws_ec2_ami.md)
* [Google Cloud Platform](upgrade_server_gcp.md)
* [Linux or MacOS](upgrade_server_linux_mac.md)
* [Windows 10](upgrade_server_win.md)
* [Kubernetes](upgrade_server_kubernetes_helm.md)
2021-05-13 23:48:51 +00:00
If you are using v0.15 or Older, [upgrade to ClearML Server](clearml_server_es7_migration.md).