docs: update air-gapped deployment document

Signed-off-by: Daniel Hu <tao.hu@merico.dev>

Author: daniel-hutao

docs/best-practices/air-gapped-deployment.zh.md

@@ -10,9 +10,6 @@ DevStream使用YAML文件来描述你的DevOps工具链配置。
 
 主配置包含三个部分：
 
-- `varFile`: 指向定义变量的文件路径
-- `toolFile`: 指向定义插件的文件路径
-- `pluginDir`: 指向插件目录的路径，默认为 `~/.devstream/plugins`, 或使用 `-d` 参数指定一个目录
 - `state`: 指定DevStream状态存储位置
 
 ### 主配置文件示例

docs/best-practices/air-gapped-jenkins-pipeline.zh.md

@@ -7,15 +7,11 @@
 只需要一个最小化配置，你就可以快速使用默认配置部署一个 Helm Chart。你可以将如下配置内容保存到本地 config.yaml 文件中：
 
 ```yaml
----
-varFile: ""
-toolFile: ""
-state:
-  backend: local
-  options:
-    stateFile: devstream.state
-
----
+config:
+  state:
+    backend: local
+    options:
+      stateFile: devstream.state
 tools:
 - name: helm-installer
   instanceID: argocd-001

docs/core-concepts/config.zh.md

@@ -1,5 +1,5 @@
 ##jenkins-images
-devstreamdev/jenkins:2.361.1-jdk11-dtm-0.1
+devstreamdev/jenkins:2.361.1-jdk11-dtm-0.2
 kiwigrid/k8s-sidecar:1.15.0
 jenkins/inbound-agent:4.11.2-4
 maorfr/kube-tasks:0.2.0

docs/plugins/helm-installer/helm-installer.zh.md

@@ -45,7 +45,7 @@ export GITLAB_SSHKEY=YOUR_REPO_PRIVATE_KEY
 !!! tip "提示"
 
     如果是 GitHub，则这里的环境变量改成：
-
+    
     ```shell
     export IMAGE_REPO_PASSWORD=YOUR_IMAGE_REPO_PASSWORD
     export GITHUB_TOKEN=YOUR_GITHUB_TOKEN
@@ -196,3 +196,82 @@ tools:
 ``` yaml
 --8<-- "jenkins-pipeline.yaml"
 ```
+
+
+## 离线配置 （下文待进一步整理）
+
+目前的 `jenkins-pipeline` 插件配置过程中会连接外部网络来安装插件和配置 `pipeline` 的共享库，为了支持在离线环境中使用 `jenkins-pipeline` 来创建和管理 `jenkins` 流水线，我们在 `jenkins-pipeline` 插件中提供了一个选项 `offline` 用于表示需要在离线环境下配置 `jenkins-pipeline`。
+
+### Jenkins 插件
+
+流水线正常运行需要依赖 `jenkins` 的几个插件。在离线环境中因为无法下载外部环境的插件，需要在 `jenkins` 预先安装好插件或者使用已经有插件的 `jenkins` 镜像，devstream 官方也提供了已预先安装好所有依赖的镜像 `devstreamdev/jenkins:2.361.1-jdk11-dtm-0.2`。
+
+依赖的插件如下：
+| 插件名       | 作用           | 备注                       |
+|--------------|----------------|----------------------------|
+| dingding-notifications    | 用于发送钉钉通知          | 如果需要使用钉钉通知，则需要安装此插件                 |
+| github-branch-source      | jenkins github 插件       | 如果代码仓库使用的是 github，则必须安装此插件          |
+| gitlab-plugin             | jenkins gitlab 插件       | 如果代码仓库使用的是 gitlab，则必须安装此插件          |
+| sonar                     | sonar sanner 代码扫描插件 | 如果需要使用 sonarqube，则需要安装此插件               |
+| kubernetes                | jenkins kubernetes 插件   | 用于 jenkins runner， 必须安装此插件                   |
+| git                       | jenkins git 插件          | 用于代码的克隆和权限认证， 必须安装此插件              |
+| configuration-as-code     | jenkins 配置即代码插件    | 用于 devstream 配置 jenkins 的全局配置， 必须安装此插件|
+
+### 共享库
+
+在 `jenkins` 中 devstream 默认使用共享库来管理 jenkins 流水线的共用代码，在离线环境中因为无法连接共享库，所以 devstream 提供了单独的 `Jenkinfile` 配置。
+
+
+### app 示例配置
+
+```yaml
+apps:
+- name: test
+  spec:
+    language: java
+    framework: springboot
+  repo:
+    url: gitlab.com/root/test.git
+    branch: main
+  repoTemplate:
+    url: https://github.com/devstream-io/dtm-repo-scaffolding-java-springboot.git
+  ci:
+  - type: template
+    templateName: ci-pipeline
+
+pipelineTemplates:
+- name: ci-pipeline
+  type: jenkins-pipeline
+  options:
+    branch: main
+    jenkins:
+      url: jenkins.com
+      user: admin
+      offline: true # 在此处设置 offline 为 true， 即开启该 jenkins-pipeline 的离线模式
+    imageRepo:
+      user: repoUser
+```
+
+使用该配置可得到以下输出：
+
+```text
+2022-12-02 19:51:52 ℹ [INFO]  Apply started.
+2022-12-02 19:51:52 ℹ [INFO]  Using local backend. State file: devstream-app.state.
+2022-12-02 19:51:52 ℹ [INFO]  Tool (repo-scaffolding/test) found in config but doesn't exist in the state, will be created.
+2022-12-02 19:51:52 ℹ [INFO]  Tool (jenkins-pipeline/test) found in config but doesn't exist in the state, will be created.
+2022-12-02 19:51:52 ℹ [INFO]  Start executing the plan.
+2022-12-02 19:51:52 ℹ [INFO]  Changes count: 2.
+2022-12-02 19:51:52 ℹ [INFO]  -------------------- [  Processing progress: 1/2.  ] --------------------
+2022-12-02 19:51:52 ℹ [INFO]  Processing: (repo-scaffolding/test) -> Create ...
+2022-12-02 19:51:52 ℹ [INFO]  github start to download repoTemplate...
+2022-12-02 19:51:57 ✔ [SUCCESS]  Tool (repo-scaffolding/test) Create done.
+2022-12-02 19:51:57 ℹ [INFO]  -------------------- [  Processing progress: 2/2.  ] --------------------
+2022-12-02 19:51:57 ℹ [INFO]  Processing: (jenkins-pipeline/test) -> Create ...
+2022-12-02 19:51:58 ℹ [INFO]  jenkins plugin imageRepo start config...
+2022-12-02 19:51:58 ⚠ [WARN]  jenkins gitlab ssh key not config, private repo can't be clone
+2022-12-02 19:52:00 ℹ [INFO]  jenkins start config casc...
+2022-12-02 19:52:07 ✔ [SUCCESS]  Tool (jenkins-pipeline/test) Create done.
+2022-12-02 19:52:07 ℹ [INFO]  -------------------- [  Processing done.  ] --------------------
+2022-12-02 19:52:07 ✔ [SUCCESS]  All plugins applied successfully.
+2022-12-02 19:52:07 ✔ [SUCCESS]  Apply finished.
+```

docs/plugins/helm-installer/jenkins/jenkins-images.txt

@@ -16,17 +16,12 @@ The following content is an example of the "tool file".
 For more information on the main config, the tool file and the var file of DevStream, see [Core Concepts Overview](../core-concepts/overview.md) and [DevStream Configuration](../core-concepts/config.md).
 
 ```yaml
----
-# core config
-varFile: ""
-toolFile: ""
-state: # state config, backend can be local or s3
-  backend: local
-  options:
-    stateFile: devstream.state
-
----
-# plugins config
+config:
+  state:
+    backend: local
+    options:
+      stateFile: devstream.state
+
 tools:
   # name of the tool
   - name: zentao

docs/plugins/jenkins-pipeline.zh.md

@@ -15,17 +15,12 @@
 关于更多关于DevStream的主配置、tool file、var file的信息，请阅读[核心概念概览](../core-concepts/overview.zh.md)和[DevStream配置](../core-concepts/config.zh.md).
 
 ```yaml
----
-# core config
-varFile: ""
-toolFile: ""
-state: # state config, backend can be local or s3
-  backend: local
-  options:
-    stateFile: devstream.state
-
----
-# plugins config
+config:
+  state:
+    backend: local
+    options:
+      stateFile: devstream.state
+
 tools:
   # name of the tool
   - name: zentao

docs/plugins/zentao.md

@@ -12,7 +12,7 @@ In this quickstart, we will do the following automatically with DevStream:
 In your working directory, run:
 
 ```shell
-sh -c "$(curl -fsSL https://raw.githubusercontent.com/devstream-io/devstream/main/hack/install/download.sh)"
+sh -c "$(curl -fsSL https://download.devstream.io/download.sh)
 ```
 
 !!! note "Note"

docs/plugins/zentao.zh.md

@@ -12,7 +12,7 @@
 进入你的工作目录，运行：
 
 ```shell
-sh -c "$(curl -fsSL https://raw.githubusercontent.com/devstream-io/devstream/main/hack/install/download.sh)"
+sh -c "$(curl -fsSL https://download.devstream.io/download.sh)
 ```
 
 !!! note "提示"