Browse Source

doc: Add hyperlink for pydolphinscheduler doc (#13907)

* doc: Add hyperlink for pydolphinscheduler do
* remove Tianqi-Dotes for docs code owner
3.1.6-release
Jay Chung 2 years ago
parent
commit
f13c2d7a12
  1. 4
      .github/CODEOWNERS
  2. 12
      docs/configs/docsdev.js
  3. 0
      docs/docs/en/guide/api/healthcheck.md
  4. 18
      docs/docs/en/guide/api/open-api.md
  5. 5
      docs/docs/en/guide/api/pydolphinscheduler.md
  6. 0
      docs/docs/zh/guide/api/healthcheck.md
  7. 18
      docs/docs/zh/guide/api/open-api.md
  8. 6
      docs/docs/zh/guide/api/pydolphinscheduler.md

4
.github/CODEOWNERS

@ -39,9 +39,9 @@
/dolphinscheduler-tools/ @caishunfeng @SbloodyS @zhongjiajie @EricGao888 /dolphinscheduler-tools/ @caishunfeng @SbloodyS @zhongjiajie @EricGao888
/script/ @caishunfeng @SbloodyS @zhongjiajie @EricGao888 /script/ @caishunfeng @SbloodyS @zhongjiajie @EricGao888
/dolphinscheduler-ui/ @songjianet @Amy0104 /dolphinscheduler-ui/ @songjianet @Amy0104
/docs/ @zhongjiajie @Tianqi-Dotes @EricGao888 /docs/ @zhongjiajie @EricGao888
/licenses/ @kezhenxu94 @zhongjiajie /licenses/ @kezhenxu94 @zhongjiajie
/images/ @zhongjiajie @Tianqi-Dotes @EricGao888 /images/ @zhongjiajie @EricGao888
/style/ @caishunfeng /style/ @caishunfeng
# All pom files # All pom files

12
docs/configs/docsdev.js

@ -447,15 +447,15 @@ export default {
children: [ children: [
{ {
title: 'Open API', title: 'Open API',
link: '/en-us/docs/3.1.5/user_doc/guide/open-api.html', link: '/en-us/docs/3.1.5/user_doc/guide/api/open-api.html',
}, },
{ {
title: 'PyDolphinScheduler', title: 'PyDolphinScheduler',
link: '/python/main/index.html', link: '/en-us/docs/3.1.5/user_doc/guide/api/pydolphinscheduler.html',
}, },
{ {
title: 'Health Check', title: 'Health Check',
link: '/en-us/docs/3.1.5/user_doc/guide/healthcheck.html', link: '/en-us/docs/3.1.5/user_doc/guide/api/healthcheck.html',
}, },
], ],
}, },
@ -1055,15 +1055,15 @@ export default {
children: [ children: [
{ {
title: 'API调用', title: 'API调用',
link: '/zh-cn/docs/3.1.5/user_doc/guide/open-api.html', link: '/zh-cn/docs/3.1.5/user_doc/guide/api/open-api.html',
}, },
{ {
title: 'PyDolphinScheduler', title: 'PyDolphinScheduler',
link: '/python/main/index.html', link: '/zh-cn/docs/3.1.5/user_doc/guide/api/pydolphinscheduler.html',
}, },
{ {
title: '健康检查', title: '健康检查',
link: '/zh-cn/docs/3.1.5/user_doc/guide/healthcheck.html', link: '/zh-cn/docs/3.1.5/user_doc/guide/api/healthcheck.html',
}, },
], ],
}, },

0
docs/docs/en/guide/healthcheck.md → docs/docs/en/guide/api/healthcheck.md

18
docs/docs/en/guide/open-api.md → docs/docs/en/guide/api/open-api.md

@ -10,11 +10,11 @@ Generally, projects and processes are created through pages, but considering the
1. Log in to the scheduling system, click "Security", then click "Token manage" on the left, and click "Create token" to create a token. 1. Log in to the scheduling system, click "Security", then click "Token manage" on the left, and click "Create token" to create a token.
![create-token](../../../img/new_ui/dev/security/create-token.png) ![create-token](../../../../img/new_ui/dev/security/create-token.png)
2. Select the "Expiration time" (Token validity time), select "User" (choose the specified user to perform the API operation), click "Generate token", copy the `Token` string, and click "Submit". 2. Select the "Expiration time" (Token validity time), select "User" (choose the specified user to perform the API operation), click "Generate token", copy the `Token` string, and click "Submit".
![token-expiration](../../../img/new_ui/dev/open-api/token_expiration.png) ![token-expiration](../../../../img/new_ui/dev/open-api/token_expiration.png)
### Examples ### Examples
@ -24,7 +24,7 @@ Generally, projects and processes are created through pages, but considering the
> Address:http://{API server ip}:12345/dolphinscheduler/swagger-ui/index.html?language=en_US&lang=en > Address:http://{API server ip}:12345/dolphinscheduler/swagger-ui/index.html?language=en_US&lang=en
![api-doc](../../../img/new_ui/dev/open-api/api_doc.png) ![api-doc](../../../../img/new_ui/dev/open-api/api_doc.png)
2. select a test API, the API selected for this test is `queryAllProjectList` 2. select a test API, the API selected for this test is `queryAllProjectList`
@ -36,7 +36,7 @@ Generally, projects and processes are created through pages, but considering the
token: The Token just generated token: The Token just generated
``` ```
![api-test](../../../img/new_ui/dev/open-api/api_test.png) ![api-test](../../../../img/new_ui/dev/open-api/api_test.png)
#### Create a Project #### Create a Project
@ -44,15 +44,15 @@ This demonstrates how to use the calling api to create the corresponding project
By consulting the api documentation, configure the KEY as Accept and VALUE as the parameter of application/json in the headers of Postman. By consulting the api documentation, configure the KEY as Accept and VALUE as the parameter of application/json in the headers of Postman.
![create-project01](../../../img/new_ui/dev/open-api/create_project01.png) ![create-project01](../../../../img/new_ui/dev/open-api/create_project01.png)
And then configure the required projectName and description parameters in Body. And then configure the required projectName and description parameters in Body.
![create-project02](../../../img/new_ui/dev/open-api/create_project02.png) ![create-project02](../../../../img/new_ui/dev/open-api/create_project02.png)
Check the post request result. Check the post request result.
![create-project03](../../../img/new_ui/dev/open-api/create_project03.png) ![create-project03](../../../../img/new_ui/dev/open-api/create_project03.png)
The returned `msg` information is "success", indicating that we have successfully created the project through API. The returned `msg` information is "success", indicating that we have successfully created the project through API.
@ -60,6 +60,6 @@ If you are interested in the source code of creating a project, please continue
### Appendix: The Source Code of Creating a Project ### Appendix: The Source Code of Creating a Project
![api-source01](../../../img/new_ui/dev/open-api/api_source01.png) ![api-source01](../../../../img/new_ui/dev/open-api/api_source01.png)
![api-source02](../../../img/new_ui/dev/open-api/api_source02.png) ![api-source02](../../../../img/new_ui/dev/open-api/api_source02.png)

5
docs/docs/en/guide/api/pydolphinscheduler.md

@ -0,0 +1,5 @@
# PyDolphinScheduler
PyDolphinScheduler is python API for Apache DolphinScheduler, which allow you definition your workflow by python code, aka workflow-as-codes.
For more information, please refer to [PyDolphinScheduler](https://dolphinscheduler.apache.org/python/main/)

0
docs/docs/zh/guide/healthcheck.md → docs/docs/zh/guide/api/healthcheck.md

18
docs/docs/zh/guide/open-api.md → docs/docs/zh/guide/api/open-api.md

@ -10,11 +10,11 @@
1. 登录调度系统,点击 "安全中心",再点击左侧的 "令牌管理",点击 "令牌管理" 创建令牌。 1. 登录调度系统,点击 "安全中心",再点击左侧的 "令牌管理",点击 "令牌管理" 创建令牌。
![create-token](../../../img/new_ui/dev/security/create-token.png) ![create-token](../../../../img/new_ui/dev/security/create-token.png)
2. 选择 "失效时间" (Token 有效期),选择 "用户" (以指定的用户执行接口操作),点击 "生成令牌" ,拷贝 Token 字符串,然后点击 "提交" 。 2. 选择 "失效时间" (Token 有效期),选择 "用户" (以指定的用户执行接口操作),点击 "生成令牌" ,拷贝 Token 字符串,然后点击 "提交" 。
![token-expiration](../../../img/new_ui/dev/open-api/token_expiration.png) ![token-expiration](../../../../img/new_ui/dev/open-api/token_expiration.png)
### 使用案例 ### 使用案例
@ -24,7 +24,7 @@
> 地址:http://{api server ip}:12345/dolphinscheduler/swagger-ui/index.html?language=zh_CN&lang=cn > 地址:http://{api server ip}:12345/dolphinscheduler/swagger-ui/index.html?language=zh_CN&lang=cn
![api-doc](../../../img/new_ui/dev/open-api/api_doc.png) ![api-doc](../../../../img/new_ui/dev/open-api/api_doc.png)
2. 选一个测试的接口,本次测试选取的接口是:查询所有项目 2. 选一个测试的接口,本次测试选取的接口是:查询所有项目
@ -36,7 +36,7 @@
token: 刚刚生成的 Token token: 刚刚生成的 Token
``` ```
![api-test](../../../img/new_ui/dev/open-api/api_test.png) ![api-test](../../../../img/new_ui/dev/open-api/api_test.png)
#### 创建项目 #### 创建项目
@ -44,15 +44,15 @@
通过查阅 api 文档,在 Postman 的 Headers 中配置 KEY 为 Accept,VALUE 为 application/json 的参数。 通过查阅 api 文档,在 Postman 的 Headers 中配置 KEY 为 Accept,VALUE 为 application/json 的参数。
![create-project01](../../../img/new_ui/dev/open-api/create_project01.png) ![create-project01](../../../../img/new_ui/dev/open-api/create_project01.png)
然后再 Body 中配置所需的 projectName 和 description 参数。 然后再 Body 中配置所需的 projectName 和 description 参数。
![create-project02](../../../img/new_ui/dev/open-api/create_project02.png) ![create-project02](../../../../img/new_ui/dev/open-api/create_project02.png)
检查 post 请求结果。 检查 post 请求结果。
![create-project03](../../../img/new_ui/dev/open-api/create_project03.png) ![create-project03](../../../../img/new_ui/dev/open-api/create_project03.png)
返回 msg 信息为 "success",说明我们已经成功通过 API 的方式创建了项目。 返回 msg 信息为 "success",说明我们已经成功通过 API 的方式创建了项目。
@ -60,6 +60,6 @@
### 附:创建项目源码 ### 附:创建项目源码
![api-source01](../../../img/new_ui/dev/open-api/api_source01.png) ![api-source01](../../../../img/new_ui/dev/open-api/api_source01.png)
![api-source02](../../../img/new_ui/dev/open-api/api_source02.png) ![api-source02](../../../../img/new_ui/dev/open-api/api_source02.png)

6
docs/docs/zh/guide/api/pydolphinscheduler.md

@ -0,0 +1,6 @@
# PyDolphinScheduler
PyDolphinScheduler 是 Apache DolphinScheduler 的 Python API,它允许您通过 Python 代码定义您的工作流,也称为 workflow-as-codes。
更多信息请参考[PyDolphinScheduler](https://dolphinscheduler.apache.org/python/main/)
Loading…
Cancel
Save