mirror of
https://github.com/clearml/clearml-docs
synced 2025-06-26 18:17:44 +00:00
25 KiB
25 KiB
| title |
|---|
| Version 1.1 |
ClearML Serving 1.1.0
:::warning Backwards Compatibility This release is not backwards compatible - see notes below on upgrading :::
Breaking Changes
- Triton engine size supports variable request size (-1)
Features & Bug Fixes
- Add version number of serving session task
- Triton engine support for variable request (matrix) sizes
- Triton support, fix
--aux-configto support more configurations elements - Huggingface Transformer support
Preprocessclass as module
ClearML Agent 1.1.2
Bug Fixes
- Fix the
sixconflict with the newpathlib2version 2.3.7 and up.
ClearML SDK 1.1.6
Features
- Add
Task.force_store_standalone_script()to force storing standalone script instead of a Git repository reference ClearML GitHub issue #340 - Add
Logger.set_default_debug_sample_history()andLogger.get_default_debug_sample_history()to allow controlling maximum debug samples programmatically - Add populate now stores function arg types as part of the hyperparemeters
- Add
status_messageargument toTask.mark_stopped() - Change
HTTPdriver timeout and retry codes (connection timeout will now trigger a retry)
Bug Fixes
- Fix and upgrade the SlackMonitor ClearML GitHub issue #533
- Fix network issues causing Task to stop on status change when no status change has occurred ClearML GitHub issue #535
- Fix Pipeline controller function support for dict as input argument
- Fix uploading the same metric/variant from multiple processes in threading mode should create a unique file per process (since global counter is not passed between the subprocesses)
- Fix resource monitoring should only run in the main process when using threaded logging mode
- Fix fork patching so that the signal handler (
at_exit) will be called on time - Fix fork (process pool) hangs or drops reports when reports are at the end of the forked function in both threaded and subprocess mode reporting
- Fix multi-pipeline support
- Fix delete artifacts after upload
- Fix artifact preview has no truth value
- Fix storage cache cleanup does not remove all entries on a silent fail
- Fix always store session cache in
~/.clearml(regardless of the cache folder) - Fix
StorageManager.download_folder()fails on Windows path
ClearML SDK 1.1.5
Features
- Add support for
jsonargpraserClearML GitHub issue #403 - Add
HyperParameterOptimizer.get_top_experiments_details()returns the hparams and metrics of the top performing experiments of an HPO ClearML GitHub issue #473 - Allow overriding initial iteration offset using environment variable (
CLEARML_SET_ITERATION_OFFSET) orTask.init(continue_last_task==<offset>)ClearML GitHub issue #496 - Add better input handling for
clearml-initin colab ClearML GitHub issue #515 - Add environment variable for default request method ClearML GitHub issue #521
- Add
LocalClearmlJobas possible option for HPO ClearML GitHub issue #525 - Add convenience functionality to
clearml-dataClearML GitHub issue #526 - Add support for
vscode-jupytermicrosoft/vscode-jupyter#8531 - Improve detection of running reporting subprocess (including zombie state)
- Support controlling S3/Google Cloud Storage
_stream_download_pool_connectionsusing thestream_connectionsconfiguration setting inclearml.conf(default 128) - Add warning when losing reporting subprocess
- Add
Model.remove()to allow removing a model from the model repository - Add HTTP download timeout control (change default connection timeout to 30 seconds)
- Add initial setup callback to monitoring class
- Add
Task.get_reported_plots() - Allow
Monitor.get_query_parametersto override defaults - Add support for Google Cloud Storage
pool_connectionsandpool_maxsizeoverrides - Add last worker time to
AutoScaler - Add warning when opening an aborted Dataset
- Store multi-pipeline execution plots on the master pipeline Task
- Support pipeline return value stored on pipeline Task
- Add
PipelineDecorator.multi_instance_support - Add
PipelineDecoratortoclearmlandclearml.automationnamespaces - Documentation and examples
- Update docstrings ClearML GitHub issue #501
- Add Markdown in pipeline jupyter notebooks ClearML GitHub issue #502
- Update pipeline example ClearML GitHub issue #494
- Add abseil example ClearML GitHub issue #509
- Change README to dark theme ClearML GitHub issue #513
- Update XGBoost example ClearML GitHub issue #524
- Change example name ClearML GitHub issue #528
Bug Fixes
- Fix
TriggerScheduleron Dataset change ClearML GitHub issue #491 - Fix links in Jupyter Notebooks ClearML GitHub issue #505
- Fix
pandasdelta datetime conversion ClearML GitHub issue #510 - Fix
matplotlibauto-magic detect bar graph series name ClearML GitHub issue #518 - Fix path limitation on storage services (posix, object storage) when storing target artifacts by limiting length of project name (full path) and task name used for object path ClearML GitHub issue #516
- Fix multi-processing context block catching exception
- Fix Google Cloud Storage with no default project causes a crash
- Fix main process's reporting subprocess lost, switch back to thread mode
- Fix forked
StorageHelpershould use its ownThreadExecuter - Fix local
StorageHelper.delete()raising exception on non-existent file instead of returning false - Fix
StorageHelperrename partial file throwing errors on multiple access - Fix resource monitor fails on permission issues (skip over parts)
- Fix reusing Task does not reset it
- Fix support
clearmlPyCharm Plugin 1.0.2 (support partial pycharm git repo sync) - Fix
Task.reset()force argument ineffective - Fix PY3.5 compatibility
- Fix validation error causes infinite loop
- Fix tasks schema prevents sending null container parts
- Fix missing
CLEARML_SET_ITERATION_OFFSETdefinition - Fix
Model.get_weights_package()returns None on error - Fix download progress bar based on
sdk.storage.log.report_download_chunk_size_mbconfiguration - Fix Conda lists the
CudaToolkitversion installed (for the agent to reproduce) - Fix Jupyter kernel shutdown causing nested atexit callbacks leaving Task in running state
- Fix multi-subprocess can cause Task to hand at close
- Fix TF 2.7 support (get
logdiron with multiple TB writers)
ClearML SDK 1.1.4
Bug Fixes
- Fix duplicate keyword argument (affects
clearml-data,Dataset.get()) ClearML GitHub issue #490 - Fix session raises missing host error when in offline mode ClearML GitHub issue #489
- Fix
Task.get_task()does not loadoutput_urifrom stored Task - Fix
Task.get_models()['input']returns string instead ofclearml.Model - Fix
tf.saved_model.load()binding forTensorFlow>=2.0 - Fix hyperparams with
Nonevalue converted to empty string causes inferred type to change tostrin consecutiveTask.connect()calls
ClearML Agent 1.1.1
Features and Bug Fixes
- Add support for truncating task log file after reporting to server using
agent.truncate_task_output_filesconfiguration setting - Fix PyJWT resiliency support
- Fix
--stopchecking default queue tag ClearML Agent GitHub issue #80 - Fix queue tag
defaultdoes not exist and--queuenot specified (try queue named"default") - Fix Python 3.5 compatibility
- Fix PY2.7 support for PyTorch
ClearML SDK 1.1.3
Features
- Add support for MegEngine with examples ClearML GitHub issue #455
- Add
TaskTypesto main namespace ClearML GitHub issue #453 - Add
LogUnifomParameterRangefor hyperparameter optimization with Optuna ClearML GitHub issue #462 - Add joblib (equivalent to scikit) to
Task.init(auto_connect_frameworks)argument - Log environment variables starting with
*inenviron_bind.pyClearML GitHub issue #459 - Pipeline
- Add eager decorated pipeline execution
- Support pipeline monitoring for scalars/models/artifacts
- Add
PipelineController.upload_model() - Add
PipelineController.add_step(configuration_overrides)argument allowing to override Task configuration objects - Change
PipelineController.start_locally()defaultrun_pipeline_steps_locally=False - Add
PipelineController.stop(mark_failed, mark_aborted)arguments - Add
PipelineController.run_locallydecorator - Add
PipelineController.continue_on_failproperty - Add
PipelineController.__init__(abort_on_failure)argument - Add nested pipeline components missing pipeline tags
- Add ClearmlJob state cache (refresh every second)
- Datasets
- Add
clearml-datamulti-chunk support - Change
clearml-datadefault chunk size to 512 MB - Change
Dataset.create()now automatically reverts to using current Task if no project/name provided
- Add
- Add
Optimizer.get_top_experiments_id_metrics_pair()for top performing experiments - Add support for setting default value to auto connected argparse arguments
- Add
Task.get_script()andTask.set_script()for getting and setting task's script properties for execution - Add
Task.mark_completed()forceandstatus_messagearguments - Add
Task.stopped()reasonargument - Add
Task.query_tasks(),Task.get_task()andTask.get_tasks()tagsargument
Bug Fixes
- Fix PyJWT resiliency support
- Fix xgb train overload ClearML GitHub issue #456
- Fix
http://throwsOSErrorin Windows by usingpathlib2instead ofosClearML GitHub issue #463 - Fix local diff should include staged commits, otherwise applying git diff fails ClearML GitHub issue #457
- Fix
task.upload_artifactnon-standard dictionary will now revert topickleClearML GitHub issue #452 - Fix
S3BucketConfig.is_valid()for EC2 environments withuse_credentials_chainClearML GitHub issue #478 - Fix audio classifier example when training with a custom dataset ClearML GitHub issue #484
- Fix
clearml-taskdiff was corrupted by Windows drive letter and separator ClearML GitHub issue #483 - Fix TQDM "line cleanup" not using
CRbut rather arrow-up escape sequence - Fix
task.connect(dict)value casting - ifNoneis the default value, use backend stored type - Fix Jupyter notebook should always set Task as completed/stopped, never failed (exceptions are caught in interactive session)
- Fix Pipeline support
- Fix
LocalClearmlJobsetting failed status - Fix pipeline stopping all running steps
- Fix nested pipeline component parent point to pipeline Task
- Fix
PipelineController.start()should not kill the process when done - Fix pipeline failing to create Step Task should cause the pipeline to be marked failed
- Fix nested pipeline components missing pipeline tags
- Fix
- Fix images reported over history size were not sent if frequency was too high
- Fix git detectors missing git repository without origin
- Fix support for upload
LazyEvalWrapperartifacts - Fix duplicate task dataset tags
- Fix FileLock create target folder
- Fix crash inside forked subprocess might leave SafeQueue in a locked state, causing
task.close()to hang - Fix PyTorch distributed example
TimeoutSocketissue in Windows - Fix broken
Dataset.finalize() - Fix Python 3.5 compatibility
ClearML SDK 1.1.2
Bug Fix
- Fix PyJWT issue (limit dependency to
<2.2.0)
ClearML SDK 1.1.1
Bug Fixes
- Fix
Logger.report_image()throws warning - Fix TensorBoard
add_image()not being reported
ClearML SDK 1.1.0
:::info Breaking Changes
- New PipelineController v2 was introduced. New constructor is not backwards compatible!
- ClearML will no longer try to use the demo server by default (change this by setting the
CLEARML_NO_DEFAULT_SERVER=0environment variable) Task.completed()was deprecated, useTask.mark_completed()instead :::
Features
- Add Task Trigger Scheduler
- Add Task Cron Scheduler
- Add PipelineController from function
- Add PipelineDecorator (
PipelineDecorator.pipelineandPipelineDecorator.componentdecorators for full custom pipeline logic) - Add xgboost auto metric logging ClearML GitHub issue #381
- Add
sdk.storage.log.report_upload_chunk_size_mbandsdk.storage.log.report_download_chunk_size_mbconfiguration options to control upload/download log reporting ClearML GitHub issue #424 - Add new optional
auto_connect_frameworksargument value toTask.init()(e.g.auto_connect_frameworks={'tfdefines':False}) to allow disabling TF defines ClearML GitHub issue #408 - Add support for
CLEARNL_CONFIG_VERBOSEenvironment variable to allow external control over verbosity of the configuration loading process - Add support for uploading artifacts with a list of files using
Task.upload_artifcats(name, [Path(), Path()]) - Add missing clearml-task parameters
--docker_args,--docker_bash_setup_scriptand--output-uri - Change
CreateAndPopulatewill auto list packages imported but not installed locally - Add
clearml.task.populate.create_task_from_function()to create a Task from a function, wrapping function input arguments into hyper-parameter section as kwargs and storing function results as named artifacts - Add support for Task serialization (e.g. for pickle)
- Add
Task.get_configuration_object_as_dict() - Add
docker_imageargument toTask.set_base_docker()(deprecatedocker_cmd) - Add
auto_version_bumpargument toPipelineController - Add
sdk.development.detailed_import_reportconfiguration option to provide a detailed report of all python package imports - Set current Task as Dataset parent when creating dataset
- Add support for deferred configuration
- Examples
- Add Pipeline v2 examples
- Add
TaskSchedulerandTriggerSchedulerexamples - Add pipeline controller callback example
- Improve existing examples and docstrings
Bug Fixes
- Fix plotly plots converting
NaNtonaninstead ofnullClearML GitHub issue #373 - Fix deprecation warning ClearML GitHub issue #376
- Fix plotly multi-index without index names ClearML GitHub issue #399
- Fix click support ClearML GitHub issue #437
- Fix docstring ClearML GitHub issue #438
- Fix passing
task-typeto clearml-task ClearML GitHub issue #422 - Fix
clearml-task --versionthrows an error ClearML GitHub issue #422 - Fix clearml-task ssh repository links are not detected as remote repositories ClearML GitHub issue #423
- Fix
getattrthrows an exception ClearML GitHub issue #426 - Fix encoding while saving notebook preview ClearML GitHub issue #443
- Fix poetry toml file without requirements.txt ClearML GitHub issue #444
- Fix
PY3.xfails callingSemLock._after_forkwith forkserver context, forking while lock is acquired ClearML Agent GitHub issue #73 - Fix wrong download path in
StorageManager.download_folder() - Fix jupyter notebook
display(...)convert toprint(...) - Fix TensorFlow
add_image()withdescription='text' - Fix
Task.close()should removecurrent_task()reference - Fix
TaskSchedulerweekdays, change defaultexecute_immediatelytoFalse - Fix Python2 compatibility
- Fix clearml-task exit with error when failing to verify
output_uri(output warning instead) - Fix unsafe Google Storage delete object
- Fix multi-process spawning wait-for-uploads can create a deadlock in very rare cases
- Fix
task.set_parent()fails when passing Task object - Fix
PipelineControllerskipping queued Tasks - Remove
humanfriendlydependency (unused)
ClearML Agent 1.1.0
:::info Breaking Changes
ClearML Agent will no longer try to use the demo server by default (change this by setting the CLEARML_NO_DEFAULT_SERVER=0 environment variable)
ClearML k8s glue default pod label was changed to CLEARML=agent (instead of TRAINS=agent)
:::
Features
- Add poetry cache into docker mapping ClearML Agent GitHub issue #74
- Allow rewriting SSH URLs (see here), refers to ClearML Agent GitHub PR #72, ClearML Agent GitHub issue #42
- Add docker environment arguments log masking support, customizable using the
agent.hide_docker_command_env_varsconfiguration value (see here) ClearML Agent GitHub issue #67 - Add support for naming docker containers using the
agent.docker_container_name_formatconfiguration option to set a name format (disabled by default) ClearML issue #412 - k8s glue
- Remove queue name from pod name, add queue name and ID to pod labels ClearML Agent GitHub issue #64
- Update task
status_messagefor non-responsive or hanging pods - Support the
agent.docker_force_pullconfiguration option for scheduled pods - Add docker example for running the k8s glue as a pod in a k8s cluster
- Add
agent.ignore_requested_python_versionconfiguration option to ignore any requested python version (default false, see here) - Add
agent.docker_internal_mountsconfiguration option to control containers internal mounts (non-root containers, see here) - Add support for
-r requirements.txtin the Installed Packages section - Add support for
CLEARML_AGENT_INITIAL_CONNECT_RETRY_OVERRIDEenvironment variable to override initial server connection behavior (defaults to true, allows boolean value or an explicit number specifying the number of connect retries) - Add support for
CLEARML_AGENT_DISABLE_SSH_MOUNTenvironment variable allowing to disable the auto.sshmount into the docker - Add support for
CLEARML_AGENT_SKIP_PIP_VENV_INSTALLenvironment variable to skip Python virtual env installation on execute and allow providing a custom venv binary - Add support for
CLEARML_AGENT_VENV_CACHE_PATHenvironment variable to allow overriding venv cache folder configuration - Add support for
CLEARML_AGENT_EXTRA_DOCKER_ARGSenvironment variable to allow overriding extra docker args configuration - Add support for environment variables containing bash-style string lists using shlex
- Add printout when using ClearML key/secret from environment variables
- Increase worker keep-alive timeout to 10 minutes instead of 1 minute
- Update documentation
Bug Fixes
- Fix auto mount
SSH_AUTH_SOCKinto docker ClearML Agent GitHub issue #45 - Fix package manager configuration documentation ClearML Agent GitHub issue #78
- Fix support for spaces in docker arguments ClearML GitHub issue #358
- Fix standalone script with pre-exiting conda venv
- Fix PyYAML v5.4, v5.4.1 versions not supported
- Fix parsing VCS links starting with
git+git@(noticegit+git://was already supported) - Fix Python package with
git+git://links orgit+ssh://conversion - Fix
--services-modeif the execute agent fails when starting to run with error code 0 - Fix
--stopwith dynamic gpus - Fix support for unicode standalone scripts, changing default
asciiencoding toUTF-8 - Fix venv cache cannot reinstall package from git with http credentials
- Fix
PYTHONIOENCODINGenvironment variable is overwritten when already defined - k8s glue
- Fix support for multiple k8s glue instances with pod limits
- Fix task container handling fails parsing docker image
- Fix task container is not set when using default image/arguments
- Fix task container image arguments are used when no image is specified
- Fix task container arguments not supported in when template is not provided
- Fix
agent.extra_docker_bash_scriptnot applied correctly - Fix task runtime properties are removed when re-enqueuing task
- Fix error is not thrown when failing to push task to queue
ClearML Server 1.1.1
Bug Fixes
- Fix experiment plots override reported color-scale ClearML GitHub issue #373, Slack Channel
- Fix file server
GETresponse for gzipped data-files containsContent-Encoding: gzheader, causing clients to automatically decompress the file ClearML GitHub issue #411 - Fix server error when running with non-migrated v0.16 ElasticSearch data Slack Channel/CTK20V944/p1627911579075600
ClearML Server 1.1.0
New Features and Improvements
- Add metric snapshot plot to project overview UI - Show an aggregated view of all project experiments value for a leading metric
- Add logical
ANDoption to UI experiment table tag filter - Add Task runtime properties to experiment INFO UI tab
- Add full screen view for any experiment result plot
- Add extended version information to UI profile page
- Stop using special characters in secrets
- Allow setting status_message in
tasks.update - Improve UI table view configuration persistence - User table-view configuration is saved per project:
- Visible columns
- Column order
- Column width
- Active sort
- Active filters
Bug Fixes
- Fix experiment details UI failure opening hyperparameter sections beginning with
#ClearML Server GitHub issue #79 - Fix performance issues with UI comparison of large experiments Slack Channel
- Fix filtering on hyperparameters ClearML GitHub issue #385 Slack Channel
- Fix profile page user options toggle control area of effect
- Fix browser resizing affecting plot zoom
- Fix UI dataview filter resetting version on filter addition
- Fix UI project overview:
- Fix links in project overview not working
- Allow editing empty overview for legacy projects
- Fix Table plots using fraction of available space
- Fix scalars color assignment broken by
.in scalar name - Fix tasks cannot be moved between queues
- Fix UI Docker argument input - Force arguments in designated field
- Fix extraneous "tag" string prefixing Commit ID in Task execution information UI
- Fix missing 'no value' option in hyperparameters table filters
- Fix queued task is not dequeued on
tasks.stop - General aesthetic fixes:
- Fix input title alignment in UI clone experiment window
- Fix UI empty experiment table message alignment
- Fix UI table filter menu proportions
- Fix debug sample dropdown menu coloring
- Fix dashboard card alignment
- Fix redundant separator in plot control when maximized