2017-08-21 17:44:43 +08:00
<!DOCTYPE HTML>
< html lang = "zh-cn" >
< head >
< meta charset = "UTF-8" >
< meta content = "text/html; charset=utf-8" http-equiv = "Content-Type" >
< title > 1. 前言 · Kubernetes Handbook< / title >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" / >
< meta name = "description" content = "" >
< meta name = "generator" content = "GitBook 3.2.2" >
< meta name = "author" content = "Jimmy Song" >
< link rel = "stylesheet" href = "gitbook/style.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-splitter/splitter.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-page-toc-button/plugin.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-image-captions/image-captions.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-page-footer-ex/style/plugin.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-search-plus/search.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-highlight/website.css" >
< link rel = "stylesheet" href = "gitbook/gitbook-plugin-fontsettings/website.css" >
< meta name = "HandheldFriendly" content = "true" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1, user-scalable=no" >
< meta name = "apple-mobile-web-app-capable" content = "yes" >
< meta name = "apple-mobile-web-app-status-bar-style" content = "black" >
< link rel = "apple-touch-icon-precomposed" sizes = "152x152" href = "gitbook/images/apple-touch-icon-precomposed-152.png" >
< link rel = "shortcut icon" href = "gitbook/images/favicon.ico" type = "image/x-icon" >
< link rel = "next" href = "concepts/" / >
< / head >
< body >
< div class = "book" >
< div class = "book-summary" >
< div id = "book-search-input" role = "search" >
< input type = "text" placeholder = "輸入並搜尋" / >
< / div >
< nav role = "navigation" >
< ul class = "summary" >
< li class = "chapter active" data-level = "1.1" data-path = "./" >
< a href = "./" >
1. 前言
< / a >
< / li >
< li class = "chapter " data-level = "1.2" data-path = "concepts/" >
< a href = "concepts/" >
2. 概念原理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.2.1" data-path = "concepts/concepts.html" >
< a href = "concepts/concepts.html" >
2.1 设计理念
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2" data-path = "concepts/objects.html" >
< a href = "concepts/objects.html" >
2.2 主要概念
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.2.2.1" data-path = "concepts/pod-overview.html" >
< a href = "concepts/pod-overview.html" >
2.2.1 Pod
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.2.2.1.1" data-path = "concepts/pod.html" >
< a href = "concepts/pod.html" >
2.2.1.1 Pod解析
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.2.2.2" data-path = "concepts/node.html" >
< a href = "concepts/node.html" >
2.2.2 Node
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.3" data-path = "concepts/namespace.html" >
< a href = "concepts/namespace.html" >
2.2.3 Namespace
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.4" data-path = "concepts/service.html" >
< a href = "concepts/service.html" >
2.2.4 Service
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.5" data-path = "concepts/volume.html" >
< a href = "concepts/volume.html" >
2.2.5 Volume和Persistent Volume
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.6" data-path = "concepts/deployment.html" >
< a href = "concepts/deployment.html" >
2.2.6 Deployment
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.7" data-path = "concepts/secret.html" >
< a href = "concepts/secret.html" >
2.2.7 Secret
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.8" data-path = "concepts/statefulset.html" >
< a href = "concepts/statefulset.html" >
2.2.8 StatefulSet
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.9" data-path = "concepts/daemonset.html" >
< a href = "concepts/daemonset.html" >
2.2.9 DaemonSet
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.10" data-path = "concepts/serviceaccount.html" >
< a href = "concepts/serviceaccount.html" >
2.2.10 ServiceAccount
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.11" data-path = "concepts/replicaset.html" >
< a href = "concepts/replicaset.html" >
2.2.11 ReplicationController和ReplicaSet
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.12" data-path = "concepts/job.html" >
< a href = "concepts/job.html" >
2.2.12 Job
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.13" data-path = "concepts/cronjob.html" >
< a href = "concepts/cronjob.html" >
2.2.13 CronJob
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.14" data-path = "concepts/ingress.html" >
< a href = "concepts/ingress.html" >
2.2.14 Ingress
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.15" data-path = "concepts/configmap.html" >
< a href = "concepts/configmap.html" >
2.2.15 ConfigMap
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.16" data-path = "concepts/horizontal-pod-autoscaling.html" >
< a href = "concepts/horizontal-pod-autoscaling.html" >
2.2.16 Horizontal Pod Autoscaling
< / a >
< / li >
< li class = "chapter " data-level = "1.2.2.17" data-path = "concepts/label.html" >
< a href = "concepts/label.html" >
2.2.17 Label
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3" data-path = "guide/" >
< a href = "guide/" >
3. 用户指南
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.1" data-path = "guide/resource-configuration.html" >
< a href = "guide/resource-configuration.html" >
3.1 资源配置
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.1.1" data-path = "guide/configure-liveness-readiness-probes.html" >
< a href = "guide/configure-liveness-readiness-probes.html" >
3.1.1 配置Pod的liveness和readiness探针
< / a >
< / li >
< li class = "chapter " data-level = "1.3.1.2" data-path = "guide/configure-pod-service-account.html" >
< a href = "guide/configure-pod-service-account.html" >
3.1.2 配置Pod的Service Account
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.2" data-path = "guide/command-usage.html" >
< a href = "guide/command-usage.html" >
3.2 命令使用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.2.1" data-path = "guide/using-kubectl.html" >
< a href = "guide/using-kubectl.html" >
3.2.1 使用kubectl
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.3" data-path = "guide/cluster-management.html" >
< a href = "guide/cluster-management.html" >
3.3 集群管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.3.1" data-path = "guide/managing-tls-in-a-cluster.html" >
< a href = "guide/managing-tls-in-a-cluster.html" >
3.3.1 管理集群中的TLS
< / a >
2017-08-21 18:44:34 +08:00
< / li >
< li class = "chapter " data-level = "1.3.3.2" data-path = "guide/kubelet-authentication-authorization.html" >
< a href = "guide/kubelet-authentication-authorization.html" >
3.3.2 kubelet的认证授权
< / a >
< / li >
< li class = "chapter " data-level = "1.3.3.3" data-path = "guide/tls-bootstrapping.html" >
< a href = "guide/tls-bootstrapping.html" >
3.3.3 TLS bootstrap
< / a >
2017-08-21 17:44:43 +08:00
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.4" data-path = "guide/access-kubernetes-cluster.html" >
< a href = "guide/access-kubernetes-cluster.html" >
3.4 访问 Kubernetes 集群
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.4.1" data-path = "guide/access-cluster.html" >
< a href = "guide/access-cluster.html" >
3.4.1 访问集群
< / a >
< / li >
< li class = "chapter " data-level = "1.3.4.2" data-path = "guide/authenticate-across-clusters-kubeconfig.html" >
< a href = "guide/authenticate-across-clusters-kubeconfig.html" >
3.4.2 使用 kubeconfig 文件配置跨集群认证
< / a >
< / li >
< li class = "chapter " data-level = "1.3.4.3" data-path = "guide/connecting-to-applications-port-forward.html" >
< a href = "guide/connecting-to-applications-port-forward.html" >
3.4.3 通过端口转发访问集群中的应用程序
< / a >
< / li >
< li class = "chapter " data-level = "1.3.4.4" data-path = "guide/service-access-application-cluster.html" >
< a href = "guide/service-access-application-cluster.html" >
3.4.4 使用 service 访问群集中的应用程序
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.5" data-path = "guide/application-development-deployment-flow.html" >
< a href = "guide/application-development-deployment-flow.html" >
3.5 在kubernetes中开发部署应用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.5.1" data-path = "guide/deploy-applications-in-kubernetes.html" >
< a href = "guide/deploy-applications-in-kubernetes.html" >
3.5.1 适用于kubernetes的应用开发部署流程
< / a >
2017-08-21 18:44:34 +08:00
< / li >
< li class = "chapter " data-level = "1.3.5.2" data-path = "guide/migrating-hadoop-yarn-to-kubernetes.html" >
< a href = "guide/migrating-hadoop-yarn-to-kubernetes.html" >
3.5.2 迁移传统应用到kubernetes中——以Hadoop YARN为例
< / a >
2017-08-21 17:44:43 +08:00
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4" data-path = "practice/" >
< a href = "practice/" >
4. 最佳实践
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.1" data-path = "practice/install-kbernetes1.6-on-centos.html" >
< a href = "practice/install-kbernetes1.6-on-centos.html" >
4.1 在CentOS上部署kubernetes1.6集群
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.1.1" data-path = "practice/create-tls-and-secret-key.html" >
< a href = "practice/create-tls-and-secret-key.html" >
4.1.1 创建TLS证书和秘钥
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.2" data-path = "practice/create-kubeconfig.html" >
< a href = "practice/create-kubeconfig.html" >
4.1.2 创建kubeconfig文件
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.3" data-path = "practice/etcd-cluster-installation.html" >
< a href = "practice/etcd-cluster-installation.html" >
4.1.3 创建高可用etcd集群
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.4" data-path = "practice/kubectl-installation.html" >
< a href = "practice/kubectl-installation.html" >
4.1.4 安装kubectl命令行工具
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.5" data-path = "practice/master-installation.html" >
< a href = "practice/master-installation.html" >
4.1.5 部署master节点
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.6" data-path = "practice/node-installation.html" >
< a href = "practice/node-installation.html" >
4.1.6 部署node节点
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.7" data-path = "practice/kubedns-addon-installation.html" >
< a href = "practice/kubedns-addon-installation.html" >
4.1.7 安装kubedns插件
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.8" data-path = "practice/dashboard-addon-installation.html" >
< a href = "practice/dashboard-addon-installation.html" >
4.1.8 安装dashboard插件
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.9" data-path = "practice/heapster-addon-installation.html" >
< a href = "practice/heapster-addon-installation.html" >
4.1.9 安装heapster插件
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.10" data-path = "practice/efk-addon-installation.html" >
< a href = "practice/efk-addon-installation.html" >
4.1.10 安装EFK插件
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.2" data-path = "practice/service-discovery-and-loadbalancing.html" >
< a href = "practice/service-discovery-and-loadbalancing.html" >
4.2 服务发现与负载均衡
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.2.1" data-path = "practice/traefik-ingress-installation.html" >
< a href = "practice/traefik-ingress-installation.html" >
4.2.1 安装Traefik ingress
< / a >
< / li >
< li class = "chapter " data-level = "1.4.2.2" data-path = "practice/distributed-load-test.html" >
< a href = "practice/distributed-load-test.html" >
4.2.2 分布式负载测试
< / a >
< / li >
< li class = "chapter " data-level = "1.4.2.3" data-path = "practice/network-and-cluster-perfermance-test.html" >
< a href = "practice/network-and-cluster-perfermance-test.html" >
4.2.3 网络和集群性能测试
< / a >
< / li >
< li class = "chapter " data-level = "1.4.2.4" data-path = "practice/edge-node-configuration.html" >
< a href = "practice/edge-node-configuration.html" >
4.2.4 边缘节点配置
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.3" data-path = "practice/operation.html" >
< a href = "practice/operation.html" >
4.3 运维管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.3.1" data-path = "practice/service-rolling-update.html" >
< a href = "practice/service-rolling-update.html" >
4.3.1 服务滚动升级
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.2" data-path = "practice/app-log-collection.html" >
< a href = "practice/app-log-collection.html" >
4.3.2 应用日志收集
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.3" data-path = "practice/configuration-best-practice.html" >
< a href = "practice/configuration-best-practice.html" >
4.3.3 配置最佳实践
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.4" data-path = "practice/monitor.html" >
< a href = "practice/monitor.html" >
4.3.4 集群及应用监控
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.5" data-path = "practice/jenkins-ci-cd.html" >
< a href = "practice/jenkins-ci-cd.html" >
4.3.5 使用Jenkins进行持续构建与发布
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.6" data-path = "practice/data-persistence-problem.html" >
< a href = "practice/data-persistence-problem.html" >
4.3.6 数据持久化问题
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.4" data-path = "practice/storage.html" >
< a href = "practice/storage.html" >
4.4 存储管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.4.1" data-path = "practice/glusterfs.html" >
< a href = "practice/glusterfs.html" >
4.4.1 GlusterFS
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.4.1.1" data-path = "practice/using-glusterfs-for-persistent-storage.html" >
< a href = "practice/using-glusterfs-for-persistent-storage.html" >
4.4.1.1 使用GlusterFS做持久化存储
< / a >
< / li >
< li class = "chapter " data-level = "1.4.4.1.2" data-path = "practice/storage-for-containers-using-glusterfs-with-openshift.html" >
< a href = "practice/storage-for-containers-using-glusterfs-with-openshift.html" >
4.4.1.2 在OpenShift中使用GlusterFS做持久化存储
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5" data-path = "usecases/" >
< a href = "usecases/" >
5. 领域应用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1" data-path = "usecases/microservices.html" >
< a href = "usecases/microservices.html" >
5.1 微服务架构
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1.1" data-path = "usecases/istio.html" >
< a href = "usecases/istio.html" >
5.1.1 Istio
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1.1.1" data-path = "usecases/istio-installation.html" >
< a href = "usecases/istio-installation.html" >
5.1.1.1 安装istio
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.1.2" data-path = "usecases/configuring-request-routing.html" >
< a href = "usecases/configuring-request-routing.html" >
5.1.1.2 配置请求的路由规则
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.1.2" data-path = "usecases/linkerd.html" >
< a href = "usecases/linkerd.html" >
5.1.2 Linkerd
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1.2.1" data-path = "usecases/linkerd-user-guide.html" >
< a href = "usecases/linkerd-user-guide.html" >
5.1.2.1 Linkerd 使用指南
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.1.3" data-path = "usecases/service-discovery-in-microservices.html" >
< a href = "usecases/service-discovery-in-microservices.html" >
5.1.3 微服务中的服务发现
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.2" data-path = "usecases/big-data.html" >
< a href = "usecases/big-data.html" >
5.2 大数据
< / a >
< ul class = "articles" >
2017-08-30 14:20:52 +08:00
< li class = "chapter " data-level = "1.5.2.1" data-path = "usecases/spark-standalone-on-kubernetes.html" >
2017-08-21 17:44:43 +08:00
2017-08-30 14:20:52 +08:00
< a href = "usecases/spark-standalone-on-kubernetes.html" >
2017-08-21 17:44:43 +08:00
2017-08-30 14:20:52 +08:00
5.2.1 Spark standalone on Kubernetes
2017-08-21 17:44:43 +08:00
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6" data-path = "develop/" >
< a href = "develop/" >
6. 开发指南
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.1" data-path = "develop/developing-environment.html" >
< a href = "develop/developing-environment.html" >
6.1 开发环境搭建
< / a >
< / li >
< li class = "chapter " data-level = "1.6.2" data-path = "develop/testing.html" >
< a href = "develop/testing.html" >
6.2 单元测试和集成测试
< / a >
< / li >
< li class = "chapter " data-level = "1.6.3" data-path = "develop/client-go-sample.html" >
< a href = "develop/client-go-sample.html" >
6.3 client-go示例
< / a >
< / li >
< li class = "chapter " data-level = "1.6.4" data-path = "develop/contribute.html" >
< a href = "develop/contribute.html" >
6.4 社区贡献
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.7" data-path = "appendix/" >
< a href = "appendix/" >
7. 附录
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.7.1" data-path = "appendix/docker-best-practice.html" >
< a href = "appendix/docker-best-practice.html" >
7.1 Docker最佳实践
< / a >
< / li >
< li class = "chapter " data-level = "1.7.2" data-path = "appendix/issues.html" >
< a href = "appendix/issues.html" >
7.2 问题记录
< / a >
< / li >
< li class = "chapter " data-level = "1.7.3" data-path = "appendix/tricks.html" >
< a href = "appendix/tricks.html" >
7.3 使用技巧
< / a >
< / li >
< / ul >
< / li >
< li class = "divider" > < / li >
< li >
< a href = "https://www.gitbook.com" target = "blank" class = "gitbook-link" >
本書使用 GitBook 釋出
< / a >
< / li >
< / ul >
< / nav >
< / div >
< div class = "book-body" >
< div class = "body-inner" >
< div class = "book-header" role = "navigation" >
<!-- Title -->
< h1 >
< i class = "fa fa-circle-o-notch fa-spin" > < / i >
< a href = "." > 1. 前言< / a >
< / h1 >
< / div >
< div class = "page-wrapper" tabindex = "-1" role = "main" >
< div class = "page-inner" >
< div class = "search-plus" id = "book-search-results" >
< div class = "search-noresults" >
< section class = "normal markdown-section" >
< a href = "https://app.wercker.com/project/byKey/b8b69e593784e17ddcfd1286adfd8f3c" target = "_blank" > < figure id = "fig1.1.1" > < img src = "https://app.wercker.com/status/b8b69e593784e17ddcfd1286adfd8f3c/s/master" alt = "wercker status" title = "wercker status" > < figcaption > Figure: wercker status< / figcaption > < / figure > < / a >
< h1 id = "kubernetes-handbook" > Kubernetes Handbook< / h1 >
< p > < a href = "http://kubernetes.io" target = "_blank" > Kubernetes< / a > 是 Google 基 于 < a href = "https://research.google.com/pubs/pub43438.html" target = "_blank" > Borg< / a > 开 源 的 容 器 编 排 调 度 引 擎 ， 作 为 < a href = "http://cncf.io" target = "_blank" > CNCF< / a > （ Cloud Native Computing Foundation） 最 重 要 的 组 件 之 一 ， 它 的 目 标 不 仅 仅 是 一 个 编 排 系 统 ， 而 是 提 供 一 个 规 范 ， 可 以 让 你 来 描 述 集 群 的 架 构 ， 定 义 服 务 的 最 终 状 态 ， 它 将 自 动 得 将 系 统 达 到 和 维 持 在 这 个 状 态 。 < / p >
< p > 本 书 记 录 了 本 人 从 零 开 始 学 习 和 使 用 Kubernetes 的 心 路 历 程 ， 着 重 于 经 验 分 享 和 总 结 ， 同 时 也 会 有 相 关 的 概 念 解 析 ， 希 望 能 够 帮 助 大 家 少 踩 坑 ， 少 走 弯 路 。 < / p >
< p > 在 写 作 本 书 时 ， 安 装 的 所 有 组 件 、 所 用 示 例 和 操 作 等 皆 基 于 < strong > Kubernetes1.6.0< / strong > 版 本 。 < / p >
< p > < a href = "SUMMARY.md" > 文 章 目 录 < / a > < / p >
< p > GitHub 地 址 ： < a href = "https://github.com/rootsongjc/kubernetes-handbook" target = "_blank" > https://github.com/rootsongjc/kubernetes-handbook< / a > < / p >
2017-08-22 11:43:22 +08:00
< p > Gitbook 在 线 浏 览 ： < a href = "http://jimmysong.io/kubernetes-handbook/" target = "_blank" > http://jimmysong.io/kubernetes-handbook/< / a > < / p >
2017-08-21 17:44:43 +08:00
< h2 id = "如何使用本书" > 如 何 使 用 本 书 < / h2 >
< p > < strong > 在 线 浏 览 < / strong > < / p >
2017-08-22 11:43:22 +08:00
< p > 访 问 < a href = "http://jimmysong.io/kubernetes-handbook/" target = "_blank" > gitbook< / a > < / p >
2017-08-21 17:44:43 +08:00
< p > < strong > 注 意 < / strong > ： < u > 文 中 涉 及 的 配 置 文 件 和 代 码 链 接 在 gitbook 中 会 无 法 打 开 ， 请 下 载 github 源 码 后 ， 在 MarkDown 编 辑 器 中 打 开 ， 点 击 链 接 将 跳 转 到 你 的 本 地 目 录 ， 推 荐 使 用 < a href = "www.typorai.o" > typora< / a > < / u > 。 < / p >
< p > < strong > 本 地 查 看 < / strong > < / p >
< ol >
< li > 将 代 码 克 隆 到 本 地 < / li >
< li > 安 装 gitbook： < a href = "https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md" target = "_blank" > Setup and Installation of GitBook< / a > < / li >
< li > 执 行 gitbook serve< / li >
< li > 在 浏 览 器 中 访 问 < a href = "http://localhost:4000" target = "_blank" > http://localhost:4000< / a > < / li >
< li > 生 成 的 文 档 在 < code > _book< / code > 目 录 下 < / li >
< / ol >
< p > < strong > 生 成 pdf< / strong > < / p >
< p > < a href = "http://calibre-ebook.com/download" target = "_blank" > 下 载 Calibre< / a > < / p >
< ul >
< li > < strong > On Mac< / strong > < / li >
< / ul >
< p > 在 Mac下 安 装 后 ， 使 用 该 命 令 创 建 链 接 < / p >
< pre > < code > ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
< / code > < / pre > < p > 在 该 项 目 目 录 下 执 行 以 下 命 令 生 成 < code > kubernetes-handbook.pdf< / code > 文 档 。 < / p >
< pre > < code > gitbook pdf . ./kubernetes-handbook.pdf
< / code > < / pre > < ul >
< li > < strong > On Windows< / strong > < / li >
< / ul >
< p > 需 要 用 到 的 工 具 ： < a href = "http://calibre-ebook.com/" target = "_blank" > calibre< / a > ， < a href = "http://phantomjs.org/download.html" target = "_blank" > phantomjs< / a > < / p >
< ol >
< li > 将 上 述 2个 安 装 ， calibre 默 认 安 装 的 路 径 < code > C:\Program Files\Calibre2< / code > 为 你 解 压 路 径 ； < / li >
< li > 并 将 其 目 录 均 加 入 到 系 统 变 量 path 中 ,参 考 :目 录 添 加 到 系 统 变 量 path 中 ； < / li >
< li > 在 cmd 打 开 你 需 要 转 pdf 的 文 件 夹 ,输 入 < code > gitbook pdf< / code > 即 可 ； < / li >
< / ol >
< p > < strong > 生 成 单 个 章 节 的 pdf< / strong > < / p >
< p > 使 用 < code > pandoc< / code > 和 < code > latex< / code > 来 生 成 pdf格 式 文 档 。 < / p >
< pre > < code class = "lang-shell" > pandoc --latex-engine=xelatex --template=pm-template input.md -o output.pdf
< / code > < / pre >
< h2 id = "如何贡献" > 如 何 贡 献 < / h2 >
< h3 id = "提-issue" > 提 issue< / h3 >
< p > 如 果 你 发 现 文 档 中 的 错 误 ， 或 者 有 好 的 建 议 ， 不 要 犹 豫 ， 欢 迎 < a href = "https://github.com/rootsongjc/kubernetes-handbook/issues/new" target = "_blank" > 提 交 issue< / a > 。 < / p >
< h3 id = "发起-pull-request" > 发 起 Pull Request< / h3 >
< p > 当 你 发 现 文 章 中 明 确 的 错 误 或 者 逻 辑 问 题 ， 在 你 自 己 的 fork 的 分 支 中 ， 创 建 一 个 新 的 branch， 修 改 错 误 ， push 到 你 的 branch， 然 后 在 < a href = "https://github.com/rootsongjc/kubernetes-handbook/issues/new" target = "_blank" > 提 交 issue< / a > 后 直 接 发 起 Pull Request。 < / p >
< h3 id = "贡献文档" > 贡 献 文 档 < / h3 >
< h4 id = "文档的组织规则" > 文 档 的 组 织 规 则 < / h4 >
< ul >
< li > 如 果 要 创 建 一 个 大 的 主 题 就 在 最 顶 层 创 建 一 个 目 录 ； < / li >
< li > 全 书 五 大 主 题 ， 每 个 主 题 一 个 目 录 ， 其 下 不 再 设 二 级 目 录 ； < / li >
< li > 所 有 的 图 片 都 放 在 最 顶 层 的 < code > images< / code > 目 录 下 ， 原 则 上 文 章 中 用 到 的 图 片 都 保 存 在 本 地 ； < / li >
< li > 所 有 的 文 档 的 文 件 名 使 用 英 文 命 名 ， 可 以 包 含 数 字 和 中 划 线 ； < / li >
< li > < code > etc< / code > 、 < code > manifests< / code > 目 录 专 门 用 来 保 存 配 置 文 件 和 文 档 中 用 到 的 其 他 相 关 文 件 ； < / li >
< / ul >
< h4 id = "添加文档" > 添 加 文 档 < / h4 >
< ol >
< li > 在 该 文 章 相 关 主 题 的 目 录 下 创 建 文 档 ； < / li >
< li > 在 < code > SUMMARY.md< / code > 中 在 相 应 的 章 节 下 添 加 文 章 链 接 ； < / li >
< li > 执 行 < code > gitbook server< / code > 测 试 是 否 报 错 ， 访 问 < a href = "http://localhost:4000" target = "_blank" > http://localhost:4000< / a > 查 看 该 文 档 是 否 出 现 在 相 应 主 题 的 目 录 下 ； < / li >
< li > 提 交 PR< / li >
< / ol >
< h2 id = "关于" > 关 于 < / h2 >
< p > < a href = "https://github.com/rootsongjc/kubernetes-handbook/graphs/contributors" target = "_blank" > 贡 献 者 列 表 < / a > < / p >
2017-08-22 11:43:22 +08:00
< p > < a href = "http://jimmysong.io/about" target = "_blank" > Jimmy Song< / a > < / p >
2017-08-21 17:44:43 +08:00
< footer class = "page-footer-ex" > < span class = "page-footer-ex-copyright" > for GitBook< / span >                       < span class = "page-footer-ex-footer-update" > update
2017-08-22 11:43:22 +08:00
2017-08-22 11:41:15
2017-08-21 17:44:43 +08:00
< / span > < / footer >
< / section >
< / div >
< div class = "search-results" >
< div class = "has-results" >
< h1 class = "search-results-title" > < span class = 'search-results-count' > < / span > results matching "< span class = 'search-query' > < / span > "< / h1 >
< ul class = "search-results-list" > < / ul >
< / div >
< div class = "no-results" >
< h1 class = "search-results-title" > No results matching "< span class = 'search-query' > < / span > "< / h1 >
< / div >
< / div >
< / div >
< / div >
< / div >
< / div >
< a href = "concepts/" class = "navigation navigation-next navigation-unique" aria-label = "Next page: 2. 概念原理" >
< i class = "fa fa-angle-right" > < / i >
< / a >
< / div >
< script >
var gitbook = gitbook || [];
gitbook.push(function() {
2017-08-30 14:20:52 +08:00
gitbook.page.hasChanged({"page":{"title":"1. 前言","level":"1.1","depth":1,"next":{"title":"2. 概念原理","level":"1.2","depth":1,"path":"concepts/index.md","ref":"concepts/index.md","articles":[{"title":"2.1 设计理念","level":"1.2.1","depth":2,"path":"concepts/concepts.md","ref":"concepts/concepts.md","articles":[]},{"title":"2.2 主要概念","level":"1.2.2","depth":2,"path":"concepts/objects.md","ref":"concepts/objects.md","articles":[{"title":"2.2.1 Pod","level":"1.2.2.1","depth":3,"path":"concepts/pod-overview.md","ref":"concepts/pod-overview.md","articles":[{"title":"2.2.1.1 Pod解析","level":"1.2.2.1.1","depth":4,"path":"concepts/pod.md","ref":"concepts/pod.md","articles":[]}]},{"title":"2.2.2 Node","level":"1.2.2.2","depth":3,"path":"concepts/node.md","ref":"concepts/node.md","articles":[]},{"title":"2.2.3 Namespace","level":"1.2.2.3","depth":3,"path":"concepts/namespace.md","ref":"concepts/namespace.md","articles":[]},{"title":"2.2.4 Service","level":"1.2.2.4","depth":3,"path":"concepts/service.md","ref":"concepts/service.md","articles":[]},{"title":"2.2.5 Volume和Persistent Volume","level":"1.2.2.5","depth":3,"path":"concepts/volume.md","ref":"concepts/volume.md","articles":[]},{"title":"2.2.6 Deployment","level":"1.2.2.6","depth":3,"path":"concepts/deployment.md","ref":"concepts/deployment.md","articles":[]},{"title":"2.2.7 Secret","level":"1.2.2.7","depth":3,"path":"concepts/secret.md","ref":"concepts/secret.md","articles":[]},{"title":"2.2.8 StatefulSet","level":"1.2.2.8","depth":3,"path":"concepts/statefulset.md","ref":"concepts/statefulset.md","articles":[]},{"title":"2.2.9 DaemonSet","level":"1.2.2.9","depth":3,"path":"concepts/daemonset.md","ref":"concepts/daemonset.md","articles":[]},{"title":"2.2.10 ServiceAccount","level":"1.2.2.10","depth":3,"path":"concepts/serviceaccount.md","ref":"concepts/serviceaccount.md","articles":[]},{"title":"2.2.11 ReplicationController和ReplicaSet","level":"1.2.2.11","depth":3,"path":"concepts/replicaset.md","ref":"concepts/replicaset.md","articles":[]},{"title":"2.2.12 Job","level":"1.2.2.12","depth":3,"path":"concepts/job.md","ref":"concepts/job.md","articles":[]},{"title":"2.2.13 CronJob","level":"1.2.2.13","depth":3,"path":"concepts/cronjob.md","ref":"concepts/cronjob.md","articles":[]},{"title":"2.2.14 Ingress","level":"1.2.2.14","depth":3,"path":"concepts/ingress.md","ref":"concepts/ingress.md","articles":[]},{"title":"2.2.15 ConfigMap","level":"1.2.2.15","depth":3,"path":"concepts/configmap.md","ref":"concepts/configmap.md","articles":[]},{"title":"2.2.16 Horizontal Pod Autoscaling","level":"1.2.2.16","depth":3,"path":"concepts/horizontal-pod-autoscaling.md","ref":"concepts/horizontal-pod-autoscaling.md","articles":[]},{"title":"2.2.17 Label","level":"1.2.2.17","depth":3,"path":"concepts/label.md","ref":"concepts/label.md","articles":[]}]}]},"dir":"ltr"},"config":{"plugins":["github","codesnippet","splitter","page-toc-button","image-captions","page-footer-ex","editlink","-lunr","-search","search-plus"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"github":{"url":"https://github.com/rootsongjc/kubernetes-handbook"},"editlink":{"label":"编辑本页","multilingual":false,"base":"https://github.com/rootsongjc/kubernetes-handbook/blob/master/"},"page-footer-ex":{"copyright":"for GitBook","update_format":"YYYY-MM-DD HH:mm:ss","update_label":"update"},"splitter":{},"codesnippet":{},"fontsettings":{"theme":"white","family":"sans","size":2},"highlight":{},"page-toc-button":{},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"search-plus":{},"image-captions":{"variable_name":"_pictures"}},"page-foote
2017-08-21 17:44:43 +08:00
});
< / script >
< / div >
< script src = "gitbook/gitbook.js" > < / script >
< script src = "gitbook/theme.js" > < / script >
< script src = "gitbook/gitbook-plugin-github/plugin.js" > < / script >
< script src = "gitbook/gitbook-plugin-splitter/splitter.js" > < / script >
< script src = "gitbook/gitbook-plugin-page-toc-button/plugin.js" > < / script >
< script src = "gitbook/gitbook-plugin-editlink/plugin.js" > < / script >
< script src = "gitbook/gitbook-plugin-search-plus/jquery.mark.min.js" > < / script >
< script src = "gitbook/gitbook-plugin-search-plus/search.js" > < / script >
< script src = "gitbook/gitbook-plugin-sharing/buttons.js" > < / script >
< script src = "gitbook/gitbook-plugin-fontsettings/fontsettings.js" > < / script >
< / body >
< / html >
