diff --git a/docs/platform/6.project.md b/docs/platform/6.project.md new file mode 100644 index 000000000..78e12a508 --- /dev/null +++ b/docs/platform/6.project.md @@ -0,0 +1,41 @@ +--- +id: 'project' +title: '项目管理' +sidebar_position: 6 +--- + +## 项目管理 + +Apache Flink 和 Apache Spark 都提供了基于 Java 代码来开发作业的编程模式，针对这类作业，需要用户编写好程序，构建打包产生目标 Jar ，最后执行命令行(`flink run` 或者 `spark-submit` ) 来提交作业。 +在 StreamPark 中提供了项目管理的能力，用户可以把使用 Java Maven 构建的 Apache Flink/Spark 项目轻松地加入到 StreamPark 中进行管理，这样由 StreamPark 来进行项目的打包构建和管理，编译出目标 Jar，后续可以添加作业，进行作业提交和状态监控等。 + +![Project](/doc/image/project/project.png) + +## 如何使用 + +点击 "项目管理"，新增一个项目，会进入到项目添加页面，操作如下: + +![Hot to use](/doc/image/project/project.gif) + +## 参数说明： + +- Project Name: (必填) 项目名称，不能重复 +- Project Type: (必填) 项目类型，目前只支持 Apache Flink +- Repository URL：(必填) 项目仓库的 URL，比如项目的 github 地址，或者 gitLab 地址 +- Password: (可选) 如果该项目需要密码才能访问，则需要输入密码 +- Branches: (必填) 项目的分支，会根据 Repository URL 自动解析出可选的分支，用户选择即可 +- Build Argument: (可选) 项目的构建参数 + 这里的构建参数就是 maven 的标准参数，比如要指定 profile 为 dev，那这里就是 -Pdev，其他参数以此内推。 + +- POM: (可选) 需要构建的目标模块的 pom.xml 文件位置，如当前 [StreamPark Quickstart](https://github.com/apache/incubator-streampark-quickstart) 项目目录结构如下： + + ![Pom 位置](/doc/image/project/pom-position.png) + + 现在只需要构建 `apacheflinksql_demo` 模块, 不需要构建其他模块，那么就需要指定 `apacheflinksql_demo` 模块的 pom.xml 文件的相对路径，这里就是: + `quickstart-flink/quickstart-apacheflink/apacheflinksql_demo/pom.xml` + +:::tip 提醒 +StreamPark 里的项目管理提供了内似 jenkins 的 Maven 构建能力，只支持基于 Maven 构建的项目，已经在参数输入(Build Argument) 上进行了安全验证和危险参数的拦截，如果用户的项目本身存在一些风险或漏洞，则需要用户自行处理，一些有风险的操作如：用户的项目里使用了 exec-maven-plugin 插件， +那么这些插件是否会被执行，会带来什么风险，取决于用户的项目本身。 +::: + diff --git a/docs/platform/6.SSO.md b/docs/platform/9.SSO.md similarity index 99% rename from docs/platform/6.SSO.md rename to docs/platform/9.SSO.md index 176f09ca3..23605fb01 100644 --- a/docs/platform/6.SSO.md +++ b/docs/platform/9.SSO.md @@ -1,7 +1,7 @@ --- id: 'sso' title: 'SSO Integration' -sidebar_position: 6 +sidebar_position: 9 --- ## Background diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.project.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.project.md new file mode 100644 index 000000000..78e12a508 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.project.md @@ -0,0 +1,41 @@ +--- +id: 'project' +title: '项目管理' +sidebar_position: 6 +--- + +## 项目管理 + +Apache Flink 和 Apache Spark 都提供了基于 Java 代码来开发作业的编程模式，针对这类作业，需要用户编写好程序，构建打包产生目标 Jar ，最后执行命令行(`flink run` 或者 `spark-submit` ) 来提交作业。 +在 StreamPark 中提供了项目管理的能力，用户可以把使用 Java Maven 构建的 Apache Flink/Spark 项目轻松地加入到 StreamPark 中进行管理，这样由 StreamPark 来进行项目的打包构建和管理，编译出目标 Jar，后续可以添加作业，进行作业提交和状态监控等。 + +![Project](/doc/image/project/project.png) + +## 如何使用 + +点击 "项目管理"，新增一个项目，会进入到项目添加页面，操作如下: + +![Hot to use](/doc/image/project/project.gif) + +## 参数说明： + +- Project Name: (必填) 项目名称，不能重复 +- Project Type: (必填) 项目类型，目前只支持 Apache Flink +- Repository URL：(必填) 项目仓库的 URL，比如项目的 github 地址，或者 gitLab 地址 +- Password: (可选) 如果该项目需要密码才能访问，则需要输入密码 +- Branches: (必填) 项目的分支，会根据 Repository URL 自动解析出可选的分支，用户选择即可 +- Build Argument: (可选) 项目的构建参数 + 这里的构建参数就是 maven 的标准参数，比如要指定 profile 为 dev，那这里就是 -Pdev，其他参数以此内推。 + +- POM: (可选) 需要构建的目标模块的 pom.xml 文件位置，如当前 [StreamPark Quickstart](https://github.com/apache/incubator-streampark-quickstart) 项目目录结构如下： + + ![Pom 位置](/doc/image/project/pom-position.png) + + 现在只需要构建 `apacheflinksql_demo` 模块, 不需要构建其他模块，那么就需要指定 `apacheflinksql_demo` 模块的 pom.xml 文件的相对路径，这里就是: + `quickstart-flink/quickstart-apacheflink/apacheflinksql_demo/pom.xml` + +:::tip 提醒 +StreamPark 里的项目管理提供了内似 jenkins 的 Maven 构建能力，只支持基于 Maven 构建的项目，已经在参数输入(Build Argument) 上进行了安全验证和危险参数的拦截，如果用户的项目本身存在一些风险或漏洞，则需要用户自行处理，一些有风险的操作如：用户的项目里使用了 exec-maven-plugin 插件， +那么这些插件是否会被执行，会带来什么风险，取决于用户的项目本身。 +::: + diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.SSO.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/9.SSO.md similarity index 99% rename from i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.SSO.md rename to i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/9.SSO.md index 101159527..e9afd9fcc 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/6.SSO.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/platform/9.SSO.md @@ -1,7 +1,7 @@ --- id: 'sso' title: 'SSO 集成' -sidebar_position: 6 +sidebar_position: 9 --- ## 背景介绍 diff --git a/static/doc/image/project/pom-position.png b/static/doc/image/project/pom-position.png new file mode 100644 index 000000000..c08063c70 Binary files /dev/null and b/static/doc/image/project/pom-position.png differ diff --git a/static/doc/image/project/project.gif b/static/doc/image/project/project.gif new file mode 100644 index 000000000..0ecbd9cd1 Binary files /dev/null and b/static/doc/image/project/project.gif differ diff --git a/static/doc/image/project/project.png b/static/doc/image/project/project.png new file mode 100644 index 000000000..a7ea4aaab Binary files /dev/null and b/static/doc/image/project/project.png differ