jieguangzhou commented on code in PR #10407: URL: https://github.com/apache/dolphinscheduler/pull/10407#discussion_r896437140
########## docs/docs/en/guide/task/dvc.md: ########## @@ -0,0 +1,125 @@ +# DVC Node + +## Overview + +[DVC (Data Version Control)](https://dvc.org) is an excellent open-source version control system for machine learning projects. + +The DVC plugin is used to use the data version management function of DVC on DolphinScheduler, helping users to carry out data version management easily. + +The plugin provides the following three functions: + +- Init DVC: Initialize the Git repository as a DVC repository and bind the address where the data is stored to store the actual data. +- Upload: Add or update specific data to the repository and record the version tag. +- Download: Download a specific version of data from the repository. + +## Create Task + +- Click `Project -> Management-Project -> Name-Workflow Definition`, and click the "Create Workflow" button to enter the + DAG editing page. +- Drag from the toolbar <img src="../../../../img/tasks/icons/dvc.png" width="15"/> task node to canvas. + +## Task Example + +First, introduce some general parameters of DolphinScheduler: + +- **Node name**: The node name in a workflow definition is unique. +- **Run flag**: Identifies whether this node schedules normally, if it does not need to execute, select + the `prohibition execution`. +- **Descriptive information**: Describe the function of the node. +- **Task priority**: When the number of worker threads is insufficient, execute in the order of priority from high + to low, and tasks with the same priority will execute in a first-in first-out order. +- **Worker grouping**: Assign tasks to the machines of the worker group to execute. If `Default` is selected, + randomly select a worker machine for execution. +- **Environment Name**: Configure the environment name in which run the script. +- **Times of failed retry attempts**: The number of times the task failed to resubmit. +- **Failed retry interval**: The time interval (unit minute) for resubmitting the task after a failed task. +- **Delayed execution time**: The time (unit minute) that a task delays in execution. +- **Timeout alarm**: Check the timeout alarm and timeout failure. When the task runs exceed the "timeout", an alarm + email will send and the task execution will fail. +- **Predecessor task**: Selecting a predecessor task for the current task, will set the selected predecessor task as + upstream of the current task. + +Here are some specific parameters for the DVC plugin: + +- **DVC Task Type** ：Upload, Download or Init DVC。 +- **DVC Repository** ：The DVC repository address associated with the task execution. + +### Init DVC + +Initialize the Git repository as a DVC repository and add a new data remote to save data. + +After the project is initialized, it is still a Git repository, but with DVC features added. + +The data is not actually stored in a Git repository, but somewhere else, and DVC keeps track of the version and address of the data and handles this relationship. + + + +**Task Parameter** + +- **Remote Store Url** ：The actual data is stored at the address. You can learn about the supported storage types from the [DVC supported storage types](https://dvc.org/doc/command-reference/remote/add#supported-storage-types) . + +The example above shows that: +Initialize repository `[email protected]:xxxx/dvc-data-repository-example.git` as a DVC project and bind the remote storage address to `~/dvc` + +### Upload + +Used to upload and update data and record version numbers. + + + +**Task Parameter** + +- **Data Path in DVC Repository** ：The data will be uploaded to this path in the repository. +- **Data Path In Worker** ：Data path to be uploaded. +- **Version** ：After the data is uploaded, the version tag for the data will be saved in `git tag`. +- **Version Message** ：Version Message. + +The example above shows that: + +Upload data `/home/lucky/xxxx/MLflow-AutoML/data/iris` to the root directory of repository `[email protected]:xxxx/dvc-data-repository-example.git`. The file or folder of data is named `iris`. Review Comment: I've fixed all nits like the above. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
