Browse Source

[Document]: Add new quick start doc with more details and gifs (#13607)

* doc: new quick start doc with more detail and gif

copy paste from https://github.com/bitsondatadev/trino-getting-started/pull/22

and the chinese translate by Google Translate

---------

Co-authored-by: Eric Gao <ericgao.apache@gmail.com>
3.2.0-release
Jay Chung 2 years ago committed by GitHub
parent
commit
c1fd1cba1b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 115
      docs/docs/en/guide/start/quick-start.md
  2. 88
      docs/docs/zh/guide/start/quick-start.md
  3. BIN
      docs/img/new_ui/dev/quick-start/create-alarmGroup.png
  4. BIN
      docs/img/new_ui/dev/quick-start/create-alarmInstance.png
  5. BIN
      docs/img/new_ui/dev/quick-start/create-environment.png
  6. BIN
      docs/img/new_ui/dev/quick-start/create-queue.png
  7. BIN
      docs/img/new_ui/dev/quick-start/create-tenant.png
  8. BIN
      docs/img/new_ui/dev/quick-start/create-token.png
  9. BIN
      docs/img/new_ui/dev/quick-start/create-user.png
  10. BIN
      docs/img/new_ui/dev/quick-start/create-workerGroup.png
  11. BIN
      docs/img/new_ui/dev/quick-start/log.png
  12. BIN
      docs/img/new_ui/dev/quick-start/project.png
  13. BIN
      docs/img/new_ui/dev/quick-start/workflow-definition.png
  14. BIN
      docs/img/start/assign-tenant.gif
  15. BIN
      docs/img/start/create-project.gif
  16. BIN
      docs/img/start/create-task.gif
  17. BIN
      docs/img/start/create-tenant.gif
  18. BIN
      docs/img/start/create-workflow.gif
  19. BIN
      docs/img/start/login.gif
  20. BIN
      docs/img/start/run-workflow.gif
  21. BIN
      docs/img/start/set-dep.gif
  22. BIN
      docs/img/start/view-log.gif
  23. 6
      docs/img_utils.py

115
docs/docs/en/guide/start/quick-start.md

@ -1,61 +1,118 @@
# Quick Start # Quick Start
This is a Quick Start guide to help you get a basic idea of working with Apache DolphinScheduler. Once you've gone through the tutorial video, we encourage you to find out more about Apache DolphinScheduler functions and examples in . In this section, we will use DolphinScheduler to create and run a simple workflow step by step. During this journey,
you will learn the basic concepts of DolphinScheduler and know the most basic configuration to run the workflow. We
provide both video and text in this tutorial, you can choose the way you prefer
## Video Tutorial
<figure class="video_container"> <figure class="video_container">
<iframe src="https://www.youtube.com/embed/nrF20hpCkug" frameborder="0" allowfullscreen="true"></iframe> <iframe src="https://www.youtube.com/embed/nrF20hpCkug" frameborder="0" allowfullscreen="true"></iframe>
</figure> </figure>
## Administrator User Login ## Text Tutorial
### Setup Dolphinscheduler
You have to install and start dolphinscheduler first before go ahead. For beginners, we recommend setting up
DolphinScheduler with the official Docker image or with the standalone server.
* [standalone server](https://dolphinscheduler.apache.org/en-us/docs/3.1.3/guide/installation/standalone)
* [docker](https://dolphinscheduler.apache.org/en-us/docs/3.1.3/guide/start/docker)
### Build Your First Workflow
You can log in DolphinScheduler through http://localhost:12345/dolphinscheduler/ui and the default username/password
is `admin/dolphinscheduler123`.
![login](../../../../img/start/login.gif)
#### Create Tenant
Tenant is an important concept while using DolphinScheduler, so
let's briefly introduce the concept of tenant first.
DolphinScheduler maps the `admin` account you use to log into DolphinScheduler to `user`.
To better control system resources, DolphinScheduler introduces the concept of
tenants, which are used to execute tasks.
The brief is as follows:
* User: login web UI, do all operations in the web UI, including workflow management and tenant creation.
* Tenant: the actual executor of the task, A Linux user for DolphinScheduler worker.
We can create a tenant in DolphinScheduler `Security -> Tenant Manage` page.
![create-tenant](../../../../img/start/create-tenant.gif)
#### Assign Tenant to User
* Address: http://localhost:12345/dolphinscheduler As we have shown above in `Create Tenant` section, the`user` can not run tasks until we assign it with a `tenant`.
* Username and password: admin/dolphinscheduler123
![login](../../../../img/new_ui/dev/quick-start/login.png) We can assign a tenant to a specific user in DolphinScheduler `Security -> User Manage` page.
## Create a queue ![assign-tenant](../../../../img/start/assign-tenant.gif)
![create-queue](../../../../img/new_ui/dev/quick-start/create-queue.png) After we create a tenant and assign it to a user, we can start creating a
simple workflow in DolphinScheduler.
## Create a tenant #### Create Project
![create-tenant](../../../../img/new_ui/dev/quick-start/create-tenant.png) But in DolphinScheduler, all workflows must belong to a project, so we need
to create a project first.
## Create Ordinary Users We can create a project in DolphinScheduler `Project` page by clicking
`Create Project` button.
![create-user](../../../../img/new_ui/dev/quick-start/create-user.png) ![create-project](../../../../img/start/create-project.gif)
## Create an alarm instance #### Create Workflow
![create-alarmInstance](../../../../img/new_ui/dev/quick-start/create-alarmInstance.png) Now we can create a workflow for the project `tutorial`. Click the project we just created,
go to `Workflow Definition` page, click `Create Workflow` button, and we will redirect
to the workflow detail page.
## Create an alarm group ![create-workflow](../../../../img/start/create-workflow.gif)
![create-alarmGroup](../../../../img/new_ui/dev/quick-start/create-alarmGroup.png) #### Create Tasks
## Create a worker group We can use the mouse to drag the task you want to create from the toolbar in the workflow canvas.
In this case, we create a `Shell` task. Entering the necessary information for the task,
we just fill the attribute `Node Name` with `Script` to the task for this simple workflow.
After that, we can click the `Save` button to save the task into the workflow. We create another task
using the same way.
![create-workerGroup](../../../../img/new_ui/dev/quick-start/create-workerGroup.png) ![create-task](../../../../img/start/create-task.gif)
## Create environment #### Set Task Dependency
![create-environment](../../../../img/new_ui/dev/quick-start/create-environment.png) So we have two different tasks with different names and commands to run in the workflow. The
only thing missing from the current workflow is task dependency. We can add dependency using
the mouse to drag the arrow from the upstream task to the downstream and then release the mouse.
And you can see the link with the arrow between the two tasks is created, from the upstream
task to the downstream one. Finally, we can click the `Save` button from the top right corner
to save the workflow, do not forget to enter the name of the workflow.
## Create a token ![set-dependence](../../../../img/start/set-dep.gif)
![create-token](../../../../img/new_ui/dev/quick-start/create-token.png) #### Run Workflow
## Login with regular users After all done, we can run the workflow by clicking the `Online` and then the `Run` button from
the workflows list. If you want to see the workflow instance, just go to `Workflow Instance`
page, you can see the workflow instance is running and the status is `Executing`.
Click on the user name in the upper right corner to "exit" and re-use the normal user login. ![run-workflow](../../../../img/start/run-workflow.gif)
* `Project Management -> Create Project -> Project Name` #### View Log
![project](../../../../img/new_ui/dev/quick-start/project.png) If you want to view the task log, please click the workflow instance from the workflow instance
list, then find the task you want to view the log, right-click the mouse and select `View Log`
from the context dialog, and you can see the detailed log of the task.
* `Click Workflow Definition -> Create Workflow Definition-> Online Workflow Definition` You can see the task printing `Hello DolphinScheduler` and `Ending...` which is the same as we
defined when creating the tasks.
![workflow-definition](../../../../img/new_ui/dev/quick-start/workflow-definition.png) ![view-log](../../../../img/start/view-log.gif)
* `Running Workflow Definition -> Click Workflow Instance -> Click Workflow Instance Name -> Double-click Task Node -> View Task Execution Log`
![log](../../../../img/new_ui/dev/quick-start/log.png) You just finished the first tutorial of DolphinScheduler, you can now run some simple workflows
in DolphinScheduler, congratulations!

88
docs/docs/zh/guide/start/quick-start.md

@ -1,58 +1,90 @@
# 快速上手 # 快速上手
* 喜欢看视频的伙伴可以参见手把手教你如何《快速上手 Apache DolphinScheduler 教程》 在本节中,我们将使用 DolphinScheduler 逐步创建和运行一个简单的工作流。 在这段旅程中,您将学习 DolphinScheduler 的基本概念,
并了解运行工作流的最基本配置。 我们在本教程中提供了视频和文字两种方式,您可以选择您喜欢的方式
## 视频教程
[![image](https://user-images.githubusercontent.com/15833811/126286960-dfb3bfee-c8fb-4bdf-a717-d3be221c9711.png)](https://www.bilibili.com/video/BV1d64y1s7eZ) [![image](https://user-images.githubusercontent.com/15833811/126286960-dfb3bfee-c8fb-4bdf-a717-d3be221c9711.png)](https://www.bilibili.com/video/BV1d64y1s7eZ)
* 管理员用户登录 ## 图文教程
### 设置 Dolphinscheduler
在继续之前,您必须先安装并启动 dolphinscheduler。 对于初学者,我们建议设置 dolphionscheduler 与官方 Docker image 或 standalone server。
* [standalone server](https://dolphinscheduler.apache.org/en-us/docs/3.1.3/guide/installation/standalone)
* [docker](https://dolphinscheduler.apache.org/en-us/docs/3.1.3/guide/start/docker)
### 构建您的第一个工作流程
您可以使用默认用户名/密码 http://localhost:12345/dolphinscheduler/ui 登录 dolphinscheduler 是“admin/dolphinscheduler123”。
#### 创建租户
Tenant是使用DolphinScheduler时绕不开的一个概念,所以先简单介绍一下tenant的概念。
登录 DolphinScheduler 名为 admin 的帐户在 dolphinscheduler 中称为 user。 为了更好的控制系统资源,DolphinScheduler引入了概念租户,用于执行任务。
简述如下:
* 用户:登录web UI,在web UI中进行所有操作,包括工作流管理和租户创建。
* Tenant:任务的实际执行者,A Linux user for DolphinScheduler worker。
我们可以在 DolphinScheduler `Security -> Tenant Manage` 页面创建租户。
![create-tenant](../../../../img/start/create-tenant.gif)
> 地址:http://localhost:12345/dolphinscheduler/ui 用户名/密码:admin/dolphinscheduler123 #### 将租户分配给用户
![login](../../../../img/new_ui/dev/quick-start/login.png) 正如我们上面在创建租户中谈到的,用户只能运行任务除非用户被分配给租户。
* 创建队列 我们可以在 DolphinScheduler 的“安全 -> 用户管理”页面中将租户分配给特定用户。
![create-queue](../../../../img/new_ui/dev/quick-start/create-queue.png) ![assign-tenant](../../../../img/start/assign-tenant.gif)
* 创建租户 在我们创建一个租户并将其分配给一个用户之后,我们可以开始创建一个 DolphinScheduler 中的简单工作流程。
![create-tenant](../../../../img/new_ui/dev/quick-start/create-tenant.png) #### 创建项目
* 创建普通用户 但是在 DolphinScheduler 中,所有的工作流都必须属于一个项目,所以我们需要首先创建一个项目。
![create-user](../../../../img/new_ui/dev/quick-start/create-user.png) 我们可以通过单击在 DolphinScheduler `Project` 页面中创建一个项目 “创建项目” 按钮。
* 创建告警组实例 ![create-project](../../../../img/start/create-project.gif)
![create-alarmInstance](../../../../img/new_ui/dev/quick-start/create-alarmInstance.png) #### 创建工作流
* 创建告警组 现在我们可以为项目“tutorial”创建一个工作流程。 点击我们刚刚创建的项目,转到“工作流定义”页面,单击“创建工作流”按钮,我们将重定向到工作流详细信息页面。
![create-alarmGroup](../../../../img/new_ui/dev/quick-start/create-alarmGroup.png) ![create-workflow](../../../../img/start/create-workflow.gif)
* 创建 Worker 分组 #### 创建任务
![create-workerGroup](../../../../img/new_ui/dev/quick-start/create-workerGroup.png) 我们可以使用鼠标从工作流画布的工具栏中拖动要创建的任务。 在这种情况下,我们创建一个 `Shell` 任务。 输入任务的必要信息,对于这个简单的工作流程
我们只需将属性“节点名称”填充为“脚本”即可。之后,我们可以单击“保存”按钮将任务保存到工作流中。 我们创建另一个任务使用相同的方式。
* 创建环境 ![create-task](../../../../img/start/create-task.gif)
![create-environment](../../../../img/new_ui/dev/quick-start/create-environment.png)
* 创建 Token 令牌 #### 设置任务依赖
![create-token](../../../../img/new_ui/dev/quick-start/create-token.png) 因此,我们有两个具有不同名称和命令的不同任务在工作流中运行。 这当前工作流中唯一缺少的是任务依赖性。 我们可以使用添加依赖,鼠标将箭头从上游任务拖到下游
然后松开鼠标。您可以看到从上游创建了两个任务之间带有箭头的链接任务交给下游一个。 最后,我们可以点击右上角的“保存”按钮保存工作流,不要忘记填写工作流名称。
* 使用普通用户登录 ![set-dependence](../../../../img/start/set-dep.gif)
> 点击右上角用户名“退出”,重新使用普通用户登录。 #### 运行工作流
* 项目管理->创建项目->点击项目名称 全部完成后,我们可以通过单击“在线”然后单击“运行”按钮来运行工作流工作流列表。 如果您想查看工作流实例,只需转到 “工作流实例” 页面,可以看到工作流实例正在运行,状态为`Executing`。
![project](../../../../img/new_ui/dev/quick-start/project.png) ![run-workflow](../../../../img/start/run-workflow.gif)
* 点击工作流定义->创建工作流定义->上线工作流定义 #### 查看日志
![workflow-definition](../../../../img/new_ui/dev/quick-start/workflow-definition.png) 如需查看任务日志,请从工作流实例中点击工作流实例列表,然后找到要查看日志的任务,右击鼠标选择`View Log` 从上下文对话框中,您可以看到任务的详细日志。
* 运行工作流定义->点击工作流实例->点击工作流实例名称->双击任务节点->查看任务执行日志 您可以在任务中打印 `Hello DolphinScheduler``Ending...` 这和我们一样定义 在创建任务中。
![log](../../../../img/new_ui/dev/quick-start/log.png) ![view-log](../../../../img/start/view-log.gif)
你刚刚完成了 DolphinScheduler 的第一个教程,你现在可以运行一些简单的工作流在 DolphinScheduler 中,恭喜!

BIN
docs/img/new_ui/dev/quick-start/create-alarmGroup.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 102 KiB

BIN
docs/img/new_ui/dev/quick-start/create-alarmInstance.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 120 KiB

BIN
docs/img/new_ui/dev/quick-start/create-environment.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 96 KiB

BIN
docs/img/new_ui/dev/quick-start/create-queue.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 82 KiB

BIN
docs/img/new_ui/dev/quick-start/create-tenant.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 138 KiB

BIN
docs/img/new_ui/dev/quick-start/create-token.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 102 KiB

BIN
docs/img/new_ui/dev/quick-start/create-user.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 139 KiB

BIN
docs/img/new_ui/dev/quick-start/create-workerGroup.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

BIN
docs/img/new_ui/dev/quick-start/log.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 282 KiB

BIN
docs/img/new_ui/dev/quick-start/project.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 163 KiB

BIN
docs/img/new_ui/dev/quick-start/workflow-definition.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 143 KiB

BIN
docs/img/start/assign-tenant.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 905 KiB

BIN
docs/img/start/create-project.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 378 KiB

BIN
docs/img/start/create-task.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 1022 KiB

BIN
docs/img/start/create-tenant.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 478 KiB

BIN
docs/img/start/create-workflow.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 549 KiB

BIN
docs/img/start/login.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 437 KiB

BIN
docs/img/start/run-workflow.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

BIN
docs/img/start/set-dep.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 1009 KiB

BIN
docs/img/start/view-log.gif

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 MiB

6
docs/img_utils.py

@ -112,8 +112,10 @@ def check() -> None:
img_docs, img_img = check_diff_img() img_docs, img_img = check_diff_img()
assert not img_docs and not img_img, ( assert not img_docs and not img_img, (
f"Images assert failed: \n" f"Images assert failed: \n"
f"* difference `docs` imgs to `img` is: {img_docs if img_docs else 'None'}\n" f"* Some images use in documents but do not exists in `img` directory, please add them: "
f"* difference `img` imgs to `docs` is: {img_img if img_img else 'None'}\n" f"{img_docs if img_docs else 'None'}\n"
f"* Some images not use in documents but exists in `img` directory, please delete them: "
f"{img_img if img_img else 'None'}\n"
) )

Loading…
Cancel
Save