This is an automated email from the ASF dual-hosted git repository. benjobs pushed a commit to branch proj in repository https://gitbox.apache.org/repos/asf/incubator-streampark-website.git
commit 02c1c490895eb870937a11be0b061e865eacf0c3 Author: benjobs <[email protected]> AuthorDate: Wed Aug 14 18:37:41 2024 +0800 [Improve] project doc improvement --- docs/platform/6.project.md | 41 +++++++++++++++++++---------------------- 1 file changed, 19 insertions(+), 22 deletions(-) diff --git a/docs/platform/6.project.md b/docs/platform/6.project.md index 78e12a5..9a1f8d9 100644 --- a/docs/platform/6.project.md +++ b/docs/platform/6.project.md @@ -1,41 +1,38 @@ --- id: 'project' -title: '项目管理' +title: 'Project Management' sidebar_position: 6 --- -## 项目管理 +## Project Management -Apache Flink 和 Apache Spark 都提供了基于 Java 代码来开发作业的编程模式，针对这类作业，需要用户编写好程序，构建打包产生目标 Jar ，最后执行命令行(`flink run` 或者 `spark-submit` ) 来提交作业。 -在 StreamPark 中提供了项目管理的能力，用户可以把使用 Java Maven 构建的 Apache Flink/Spark 项目轻松地加入到 StreamPark 中进行管理，这样由 StreamPark 来进行项目的打包构建和管理，编译出目标 Jar，后续可以添加作业，进行作业提交和状态监控等。 +Apache Flink and Apache Spark offer programming models based on Java code for job development. For these types of jobs, users are required to write the program, build and package it to produce the target Jar, and then execute a command line (flink run or spark-submit) to submit the job. StreamPark offers project management capabilities, allowing users to easily add Apache Flink/Spark projects built using Java Maven into StreamPark for management. With StreamPark, the packaging and buildi [...]  -## 如何使用 +## How to use -点击 "项目管理"，新增一个项目，会进入到项目添加页面，操作如下: +Click "Project Management" and add a new project. You will be taken to the project add page. The operation is as follows:  -## 参数说明： +## Parameter Description: -- Project Name: (必填) 项目名称，不能重复 -- Project Type: (必填) 项目类型，目前只支持 Apache Flink -- Repository URL：(必填) 项目仓库的 URL，比如项目的 github 地址，或者 gitLab 地址 -- Password: (可选) 如果该项目需要密码才能访问，则需要输入密码 -- Branches: (必填) 项目的分支，会根据 Repository URL 自动解析出可选的分支，用户选择即可 -- Build Argument: (可选) 项目的构建参数 - 这里的构建参数就是 maven 的标准参数，比如要指定 profile 为 dev，那这里就是 -Pdev，其他参数以此内推。 +- Project Name: (Required) Project name, cannot be repeated +- Project Type: (Required) Project type, currently only supports Apache Flink +- Repository URL：(Required) URL of the project repository, e.g: project's GitHub address or GitLab address +- Password: (Optional) If the project requires a password to access +- Branches: (Required) The project branch: Will be automatically loaded based on the Repository URL to select the optional branch. +- Build Argument: (Optional) Project build parameters + The build parameters here are the standard parameters of Maven. For example, if you want to specify the profile as dev, then here is -Pdev, and other parameters are inferred from this. -- POM: (可选) 需要构建的目标模块的 pom.xml 文件位置，如当前 [StreamPark Quickstart](https://github.com/apache/incubator-streampark-quickstart) 项目目录结构如下： +- POM: (Optional) The location of the pom.xml file of the target module to be built. For example, if the [StreamPark Quickstart](https://github.com/apache/incubator-streampark-quickstart) project directory structure is as follows: -  +  - 现在只需要构建 `apacheflinksql_demo` 模块, 不需要构建其他模块，那么就需要指定 `apacheflinksql_demo` 模块的 pom.xml 文件的相对路径，这里就是: - `quickstart-flink/quickstart-apacheflink/apacheflinksql_demo/pom.xml` + Now, if you only need to build the `apacheflinksql_demo` module, and you don't need to build any other modules. Then, you need to specify the relative path of the pom.xml file of the `apacheflinksql_demo` module, which is: `quickstart-flink/quickstart-apacheflink/apacheflinksql_demo/pom.xml` -:::tip 提醒 -StreamPark 里的项目管理提供了内似 jenkins 的 Maven 构建能力，只支持基于 Maven 构建的项目，已经在参数输入(Build Argument) 上进行了安全验证和危险参数的拦截，如果用户的项目本身存在一些风险或漏洞，则需要用户自行处理，一些有风险的操作如：用户的项目里使用了 exec-maven-plugin 插件， -那么这些插件是否会被执行，会带来什么风险，取决于用户的项目本身。 -::: +:::tip Remind +In StreamPark, the project management system has a built-in Maven build capability, similar to Jenkins, but only supports projects built using Maven. It has performed security verification and interception of dangerous parameters on parameter input (Build Argument). If the user's project itself has some risks or vulnerabilities, the user needs to handle them by himself. Some risky operations, such as using the exec-maven-plugin plug-in in the user's project, whether these plug-ins will b [...] +:::
