环境变量
本页面列出了用于配置ClearML的可用环境变量。
除了下面列出的环境变量外，ClearML 还支持动态环境变量来覆盖配置文件中出现的任何配置选项。有关更多信息，请参阅动态环境变量。
info
ClearML的环境变量会覆盖clearml.conf文件、SDK以及配置库，但可以被命令行参数覆盖。
ClearML SDK 变量
通用
| Name | Description |
|---|---|
| CLEARML_LOG_ENVIRONMENT | List of Environment variable names. These environment variables will be logged in the ClearML task's configuration hyperparameters Environment section. When executed by a ClearML agent, these values will be set in the task's execution environment. The list should be specified in the following format: CLEARML_LOG_ENVIRONMENT=VAR_1,VAR_2. |
| CLEARML_TASK_NO_REUSE | Boolean. When set to 1, a new task is created for every execution (see Task reuse). |
| CLEARML_CACHE_DIR | Set the path for the ClearML cache directory, where ClearML stores all downloaded content. |
| CLEARML_DOCKER_IMAGE | Sets the default docker image to use when running an agent in Docker mode. |
| CLEARML_LOG_LEVEL | Sets the ClearML package's log verbosity. Log levels adhere to Python log levels: CRITICAL, ERROR, WARNING, INFO, DEBUG, NOTSET |
| CLEARML_SUPPRESS_UPDATE_MESSAGE | Boolean. When set to 1, suppresses new ClearML package version availability message. |
| CLEARML_DEFAULT_OUTPUT_URI | The default output destination for model checkpoints (snapshots) and artifacts. |
| CLEARML_SET_ITERATION_OFFSET | Set initial iteration value for the executed task. The task will report its iterations starting with the specified value +1. Specify 0 to force resetting the iteration count. |
版本控制系统
覆盖仓库自动日志记录
| Name | Description |
|---|---|
| CLEARML_VCS_REPO_URL | Repository's URL |
| CLEARML_VCS_COMMIT_ID | Repository's Commit ID |
| CLEARML_VCS_BRANCH | Repository's Branch |
| CLEARML_VCS_ROOT | Repository's Root directory |
| CLEARML_VCS_WORK_DIR | Repository's working directory |
| CLEARML_VCS_STATUS | Repository status |
| CLEARML_VCS_DIFF | Base64 encoded string. Holds repo diff logged to a task. If set to an empty string, uncommitted changes are not logged. Note: Overriding CLEARML_VCS_DIFF may change the results of a task when executed remotely |
| CLEARML_VCS_ENTRY_POINT | Entry point script |
服务器连接
| Name | Description |
|---|---|
| CLEARML_API_HOST | Sets the API Server URL |
| CLEARML_CONFIG_FILE | Sets the ClearML configuration file. Overrides the default configuration file location |
| CLEARML_WEB_HOST | Sets the Web UI Server URL |
| CLEARML_FILES_HOST | Sets the File Server URL |
| CLEARML_API_ACCESS_KEY | Sets the Server's Public Access Key |
| CLEARML_API_SECRET_KEY | Sets the Server's Private Access Key |
| CLEARML_API_HOST_VERIFY_CERT | Enables / Disables server certificate verification (if behind a firewall) |
| CLEARML_API_DEFAULT_REQ_METHOD | Experimental - this option has not been vigorously tested. Set the request method for all API requests and auth login. This can be useful when GET requests with payloads are blocked by a server, so POST/PUT requests can be used instead. |
| CLEARML_OFFLINE_MODE | Sets Offline mode |
| CLEARML_NO_DEFAULT_SERVER | Disables sending information to demo server when no HOST server is set |
代理特定变量
请参阅这里了解如何配置ClearML Agent与SDK一起工作的环境变量。