完成 Spring Boot 生产就绪功能章节

DocsHome · Aug 9, 2019 · 1fc0903 · 1fc0903
1 parent 285fa12
commit 1fc0903
Show file tree

Hide file tree

Showing 7 changed files with 570 additions and 82 deletions.
diff --git a/README.md b/README.md
@@ -1,12 +1,13 @@
-# Spring Boot 中文文档
-
-![Spring Boot](https://spring.io/img/homepage/icon-spring-boot.svg)
+<div align="center">
+    <img src="https://spring.io/img/homepage/icon-spring-boot.svg" alt="Spring Boot">
+    <h1>Spring Boot 中文文档</h1>
+</div> 
 
 使用 Spring Boot，您只需极少的配置就能轻松构建出一个独立、基于 Spring 的生产级应用程序。
 
-该项目为 Spring Boot 文档翻译项目，由本人个人发起，基于 [Spring Boot 2.x](https://spring.io/projects/spring-boot) 的官方文档进行翻译。
+该项目为 Spring Boot 文档翻译项目，由本人个人发起，利用业余时间基于 [Spring Boot 2.1.5](https://docs.spring.io/spring-boot/docs/2.1.5.RELEASE/reference/htmlsingle) 的官方文档进行翻译。
 
-> 由于翻译工作启动时是参照 1.5.x 文档进行翻译，现在转向 2.x 文档，前期的内容可能比较旧，之后会慢慢更新内容。翻译顺序不会按照官网文档目录顺序，优先翻译常用的技术内容。
+> 由于翻译工作启动时是参照 1.5.x 文档进行翻译，现在转向 2.1.5 文档，前期的内容可能比较旧，之后会慢慢更新内容。翻译顺序不会按照官网文档目录顺序，优先翻译常用的技术内容。
 
 ## 阅读方式
 
@@ -28,17 +29,39 @@ npm install gitbook-cli -g
 gitbook install
 ```
 
-启动本地服务器
+启动本地服务器在线浏览
 
 ```bash
 gitbook serve
 ```
 
+生成 HTML，生成的文件位于 `_book` 目录下。
+
+```
+gitbook build
+```
+
+更多文档操作，请参照 GitBook 命令。
+
 ## 项目状态
 
-翻译中……
+> 由于是个人翻译，因此文档翻译的时限不定，根据个人业余时间调整。
+
+| 章节 | 进度 |
+| --- | --- |
+| [一、Spring Boot 文档](pages/boot-documentation.md#boot-documentation) | 100% |
+| [二、入门](pages/getting-started.md) | 100% |
+| [三、使用 Spring Boot](pages/using-spring-boot.md) | 100% |
+| [四、Spring Boot 特性](pages/spring-boot-features.md#boot-features) | 98% (缺少章节： **45、测试**)|
+| [五、Spring Boot Actuator: 生产就绪功能](pages/production-ready.md#production-ready) | 100% |
+| [六、部署 Spring Boot 应用程序](deployment.md) | 1% |
+| 七、Spring Boot CLI | 0% |
+| 八、构建工具插件 | 0% |
+| 九、How-to 指南 | 0% |
+| 十、附录 | 0% |
+
+## License
 
-## 许可
 ![](https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png)
 
 本作品采用[知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-sa/4.0/)进行许可。
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -79,7 +79,7 @@
             - [20.5.2、远程更新](pages/using-spring-boot.md#using-boot-devtools-remote-update)
     - [21、打包生产应用](pages/using-spring-boot.md#using-boot-packaging-for-production)
     - [22、下一步](pages/using-spring-boot.md#using-boot-whats-next)
-- [四、Spring Boot 功能](pages/spring-boot-features.md#boot-features)
+- [四、Spring Boot 特性](pages/spring-boot-features.md#boot-features)
     - [23、SpringApplication](pages/spring-boot-features.md#boot-features-spring-application)
         - [23.1、启动失败](pages/spring-boot-features.md#boot-features-startup-failure)
         - [23.2、自定义 banner](pages/spring-boot-features.md#boot-features-banner)
@@ -370,12 +370,32 @@
             - [57.2.15、Simple](pages/production-ready.md#production-ready-metrics-export-simple)
             - [57.2.16、StatsD](pages/production-ready.md#production-ready-metrics-export-statsd)
             - [57.2.17、Wavefront](pages/production-ready.md#production-ready-metrics-export-wavefront)
-    - 58、审计
-    - 59、HTTP 追踪
-    - 60、处理监控
-    - 61、Cloud Foundry 支持
-    - 62、下一步
-- 六、部署 Spring Boot 应用程序
+        - [57.3、支持的指标](pages/production-ready.md#production-ready-metrics-meter)
+            - [57.3.1、Spring MVC 指标](pages/production-ready.md#production-ready-metrics-spring-mvc)
+            - [57.3.2、Spring WebFlux 指标](pages/production-ready.md#production-ready-metrics-web-flux)
+            - [57.3.3、Jersey Server 指标](pages/production-ready.md#production-ready-metrics-jersey-server)
+            - [57.3.4、HTTP Client 指标](pages/production-ready.md#production-ready-metrics-http-clients)
+            - [57.3.5、Cache 指标](pages/production-ready.md#production-ready-metrics-cache)
+            - [57.3.6、数据源指标](pages/production-ready.md#production-ready-metrics-jdbc)
+            - [57.3.7、Hibernate 指标](pages/production-ready.md#production-ready-metrics-hibernate)
+            - [57.3.8、RabbitMQ 指标](pages/production-ready.md#production-ready-metrics-rabbitmq)
+        - [57.4、注册自定义指标](pages/production-ready.md#production-ready-metrics-custom)
+        - [57.5、自定义单独指标](pages/production-ready.md#production-ready-metrics-per-meter-properties)
+            - [57.5.1、自定义标签](pages/production-ready.md#production-ready-metrics-common-tags)
+            - [57.5.2、Per-meter 属性](pages/production-ready.md#_per_meter_properties)
+        - [57.6、指标端点](pages/production-ready.md#production-ready-metrics-endpoint)
+    - [58、审计](pages/production-ready.md#production-ready-auditing)
+    - [59、HTTP 追踪](pages/production-ready.md#production-ready-http-tracing)
+        - [59.1、自定义 HTTP 追踪](pages/production-ready.md#production-ready-http-tracing-custom)
+    - [60、进程监控](pages/production-ready.md#production-ready-process-monitoring)
+        - [60.1、扩展配置](pages/production-ready.md#production-ready-process-monitoring-configuration)
+        - [60.2、编程方式](pages/production-ready.md#production-ready-process-monitoring-configuration)
+    - [61、Cloud Foundry 支持](pages/production-ready.md#production-ready-cloudfoundry)
+        - [61.1、禁用 Cloud Foundry Actuator 扩展支持](pages/production-ready.md#production-ready-cloudfoundry-disable)
+        - [61.2、Cloud Foundry 自签名证书](pages/production-ready.md#production-ready-cloudfoundry-ssl)
+        - [61.3、自定义上下文路径](pages/production-ready.md#_custom_context_path)
+    - [62、下一步](pages/production-ready.md#production-ready-auditing)
+- [六、部署 Spring Boot 应用程序](pages/deployment.md)
     - 63、部署到云端
     - 64、安装 Spring Boot 应用程序
     - 65、下一步

diff --git a/pages/boot-documentation.md b/pages/boot-documentation.md
@@ -20,13 +20,13 @@
 
 ---
 
-**2.1.1.RELEASE**（前半部分为 1.5.9.RELEASE 的内容，之后会更新）
+**2.1.5.RELEASE**（前半部分为 1.5.9.RELEASE 的内容，之后会更新）
 
 Copyright © 2012-2018
 
 ---
 
-在不收取副本的任何费用且每个副本都包含此版权声明的情况下，无论是印刷形式或是电子发行形式，您可以使用本文档的副本或分发给他人。
+在不对副本收取任何费用且每个副本都包含版权声明的情况下，您可以将本文档的副本分发给他人，无论是印刷形式还是电子发行形式。
 
 <a id="boot-documentation"></a>
 # I、Spring Boot 文档
@@ -38,7 +38,7 @@ Copyright © 2012-2018
 
 Spring Boot 参考指南提供了 [html](https://docs.spring.io/spring-boot/docs/2.1.1.RELEASE/reference/html)、[pdf](https://docs.spring.io/spring-boot/docs/2.1.1.RELEASE/reference/pdf/spring-boot-reference.pdf) 和 [epub](https://docs.spring.io/spring-boot/docs/2.1.1.RELEASE/reference/epub/spring-boot-reference.epub) 格式的文档。最新的副本可在[docs.spring.io/spring-boot/docs/current/reference](https://docs.spring.io/spring-boot/docs/current/reference) 获取。
 
-在不收取副本的任何费用且每个副本都包含此版权声明的情况下，无论是印刷形式还是电子发行形式，您可以使用本文档的副本或分发给他人。
+在不对副本收取任何费用且每个副本都包含版权声明的情况下，您可以将本文档的副本分发给他人，无论是印刷形式还是电子发行形式。
 
 <a id="boot-documentation-getting-help"></a>
 

diff --git a/pages/deployment.md b/pages/deployment.md
@@ -0,0 +1,16 @@
+<a id="deployment"></a>
+
+# 六、部署 Spring Boot 应用程序
+
+Spring Boot 的可执行 jar 是现成的，适用于大多数流行的云 PaaS（Platform-as-a-Service，平台即服务）提供商。这些提供商往往要求你「自带容器」。它们负责管理应用程序进程（而不是 Java 应用程序），因此它们需要一个中间层，使你的应用程序适应云概念中的运行进程。
+
+有两个流行的云提供商 Heroku 和 Cloud Foundry 采用了 buildpack 方式。buildpack 将你部署的代码包装在启动应用程序所需的环境中。它可能是一个用于调用 `java` 的 JDK、一个内嵌 Web 服务器或一个完整的应用程序服务器。buildpack 是可插拔的，但理想情况下，你应尽可能少地进行自定义。其减少了不受控制的功能数，最大限度地减少了开发和生产环境之间的差异。
+
+理想情况下，你的应用程序（比如一个 Spring Boot 可执行 jar）打包了运行所需的所有内容。
+
+在本节中，我们将使用「[起步](getting-started.md)」章节中开发的一个[简单应用程序](getting-started.md#getting-started-first-application)作为范例，并将其运行在云中。
+
+**待续**
+
+
+
diff --git a/pages/getting-started.md b/pages/getting-started.md
@@ -1,4 +1,5 @@
 <a id="getting-started"></a>
+
 # 二、入门
 
 如果您是刚开始使用 Spring Boot，或者对 Spring 有点印象，那么这部分内容是为您准备的！在这里我们将给出基本的“是什么？”、“怎么做？”、“为什么？”这类问题的答案。这是一份友好的 Spring Boot 简介和安装说明。当我们在讨论一些核心原理之后，我们将构建第一个 Spring Boot 应用。