add chinese content

Signed-off-by: liuboaibc <[email protected]>

config.toml

@@ -58,6 +58,14 @@ description = "Bare-Metal Load-balancer for Kubernetes"
 languageName ="English"
 # Weight used for sorting.
 weight = 1
+[languages.zh]
+title = "PorterLB"
+description = "Bare-Metal Load-balancer for Kubernetes"
+languageName ="简体中文"
+contentDir = "content/zh"
+# Weight used for sorting.
+weight = 2
+
 # [languages.no]
 # title = "PorterLB"
 # description = "Docsy er operativsystem for skyen"

content/zh/_index.html

@@ -0,0 +1,49 @@
++++
+title = "Goldydocs"
+linkTitle = "Goldydocs"
+
++++
+
+{{< blocks/cover title="PorterLB: Load Balancer Implementation for Bare-Metal Kubernetes Clusters" image_anchor="top" height="full" color="orange" >}}
+<div class="mx-auto">
+	<a class="btn btn-lg btn-primary mr-3 mb-4" href="{{< relref "/docs" >}}">
+		Learn More <i class="fas fa-arrow-alt-circle-right ml-2"></i>
+	</a>
+	<a class="btn btn-lg btn-secondary mr-3 mb-4" href="https://github.com/kubesphere/porter">
+		Download <i class="fab fa-github ml-2 "></i>
+	</a>
+	<p class="lead mt-5">Expose your LoadBalancer Services in bare-metal Kubernetes clusters</p>
+	<div class="mx-auto mt-5">
+		{{< blocks/link-down color="info" >}}
+</div>
+{{< /blocks/cover >}}
+
+
+{{% blocks/lead color="primary" %}}
+## Why PorterLB?
+<br>
+<br>
+In cloud-based Kubernetes clusters, Services are usually exposed by using load balancers provided by cloud vendors. However, cloud-based load balancers are unavailable in bare-metal environments.
+<br>
+<br>
+PorterLB allows users to create LoadBalancer Services in bare-metal environments for external access, and provides the same user experience as cloud-based load balancers.
+
+{{% /blocks/lead %}}
+
+{{< blocks/section color="dark" >}}
+{{% blocks/feature icon="fa-lightbulb" title="New Feature Request" %}}
+If you have any new ideas or suggestions, please submit a [proposal](https://github.com/kubesphere/community/blob/master/contribution/design-proposal-template.md).
+{{% /blocks/feature %}}
+
+
+{{% blocks/feature icon="fab fa-github" title="Contributions Welcome!" url="https://github.com/kubesphere/community" %}}
+Find something to work on from [GitHub Issues](https://github.com/kubesphere/porter/issues). New contributors are always welcome!
+{{% /blocks/feature %}}
+
+
+{{% blocks/feature icon="fab fa-twitter" title="Follow Us on Twitter!" url="https://twitter.com/kubesphere" %}}
+Obtain up-to-date information about PorterLB.
+{{% /blocks/feature %}}
+
+
+{{< /blocks/section >}}

content/zh/about/_index.html

@@ -0,0 +1,38 @@
+---
+title: 为什么选择 PorterLB
+linkTitle: 选择 PorterLB
+menu:
+  main:
+    weight: 10
+---
+
+
+{{< blocks/cover title="Who Uses PorterLB" image_anchor="bottom" height="min" >}}
+
+<p class="lead mt-5">PorterLB is being used in production and testing.
+</p>
+
+{{< /blocks/cover >}}
+
+{{% blocks/lead %}}
+<h1 class="text-center"><a href="https://www.benlai.com/">BENLAI.COM</a>: Use PorterLB to expose Services in bare-metal Kubernetes clusters.</h1>
+Architect Mr. Chen from BENLAI.COM: "We have been using PorterLB to establish BGP connections with the cluster's border routers in production for several months. PorterLB is also very easy to integrate with <a href="https://github.com/kubesphere/kubesphere">KubeSphere</a> seamlessly."
+{{% /blocks/lead %}}
+
+
+{{< blocks/section >}}
+<div class="col-12">
+<h1 class="text-center">QingCloud: Integrate PorterLB to provide LoadBalancer Services for customers.</h1>
+</div>
+
+{{< /blocks/section >}}
+
+
+
+<!-- {{< blocks/section >}}
+
+<div class="col-12">
+<h1 class="text-center">This is another section</h1>
+</div>
+
+{{< /blocks/section >}} -->

content/zh/blog/_index.md

@@ -0,0 +1,7 @@
+---
+title: "博客"
+linkTitle: "博客"
+menu:
+  main:
+    weight: 30
+---

content/zh/blog/kubecon-porter.md

@@ -0,0 +1,14 @@
+---
+title: "An Open-Source Load Balancer for Bare-Metal Kubernetes"
+linkTitle: "KubeCon Sharing"
+date: 2019-06-24
+description: >
+  The video to introduce the PorterLB project in KubeCon.
+weight: 100001
+---
+
+As we know, the backend workload can be exposed externally using service of type "LoadBalancer" in Kubernetes cluster. Cloud vendors often provide cloud LB plugins for Kubernetes which requires the cluster to be deployed on a specific IaaS platform. However, many enterprise users usually deploy Kubernetes clusters on bare meta especially for production use. For the on-premise bare meta clusters, Kubernetes does not provide Load-Balancer implementation. PorterLB, an open-source project, is the right solution for such issue.  
+
+This video will focus on the network technologies to help expose service and EIP management for bare meta Kubernetes cluster.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/EjU1yAVxXYQ" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

content/zh/blog/porterlb-boosts-kubernetes-on-bare-metal.md

@@ -0,0 +1,64 @@
+---
+title: "PorterLB for Bare-Metal Kubernetes: Cloud Native, Elegant, and Flexible"
+linkTitle: "PorterLB for Bare-Metal Kubernetes: Cloud Native, Elegant, and Flexible"
+description: Use PorterLB to expose applications in bare-metal Kubernetes clusters.
+keywords: PorterLB, Bare Metal, Kubernetes, KubeSphere, Load Balancer, Cloud Native
+author: Patrick
+date: 2021-02-25
+weight: 100000
+---
+
+Applications deployed on Kubernetes are usually exposed by using LoadBalancer Services, which rely heavily on load balancer implementations provided by cloud vendors. For applications deployed in bare-metal Kubernetes clusters, where cloud-based load balancer implementations are unavailable, Kubernetes has yet to provide a viable LoadBalancer solution.
+
+PorterLB well addresses this problem. As a sub-project of [KubeSphere](https://kubesphere.io/), PorterLB boosts application containerization in bare-metal Kubernetes environments, and complements the KubeSphere ecosystem in the bare-metal field.
+
+In this article, I am going to introduce how PorterLB functions in Layer 2 mode and BGP mode, which are provided for users to expose applications in different scenarios, and the advantages of PorterLB compared with other bare-metal load balancer implementations such as MetalLB.
+
+## BGP Mode
+
+In BGP mode, PorterLB publishes routes to a BGP router deployed outside the Kubernetes cluster, and the BGP router forwards Service traffic from external clients to the Kubernetes cluster nodes based on the routes obtained from PorterLB. In this process, PorterLB uses Equal-Cost Multi-Path (ECMP) routing to ensure that all Kubernetes nodes or nodes that contain Pods, depending on the user configuration, are used as next hops by the BGP router.
+
+![porter-bgp-topology](/images/blog/porterlb-boosts-kubernetes-on-bare-metal/porter-bgp-topology.jpg)
+
+The process of using PorterLB in BGP mode in a Kubernetes cluster is simple:
+
+1. Install PorterLB.
+2. Configure an IP address pool by using Eip.
+3. Configure BGP properties by using BgpConf and BgpPeer.
+4. Create a Service and set the Service to use PorterLB, which is similar to what you do to use a load balancer plugin in a cloud-based Kubernetes cluster.
+
+PorterLB can be configured by using the Eip, BgpConf, and BgpPeer CRDs, no other configuration files are required. In addition, as BGP is decentralized, you can use the BGP mode to easily establish a high availability network free of failover interruptions and bandwidth bottlenecks.
+
+![high-availability-network](/images/blog/porterlb-boosts-kubernetes-on-bare-metal/high-availability-network.jpg)
+
+## Layer 2 Mode
+
+Generally, you are advised to use the BGP mode to expose your Services in a high availability network. However, BGP may be unavailable in certain systems because of security requirements or because the router does not support BGP. In this case, you can use PorterLB in Layer 2 mode to achieve similar functionality.
+
+In Layer 2 mode, PorterLB uses ARP packets (for IPv4) or NDP packets (for IPv6) to map the Service IP address to the MAC address of a Kubernetes node. The mechanism of the Layer 2 mode is similar to that of the BGP mode, except that BGP is replaced with ARP/NDP and the router obtains only one route destined for the Service. 
+
+![porter-layer-2-topology](/images/blog/porterlb-boosts-kubernetes-on-bare-metal/porter-layer-2-topology.jpg)
+
+Though the Layer 2 mode does not provide the same high availability as the BGP mode does, it is easier to use (you don't even need to configure BGP properties):
+
+1. Install PorterLB.
+2. Configure an IP address pool by using Eip.
+3. Create a Service and set the Service to use PorterLB.
+
+You can obtain detailed guidance on how to install, configure, and use PorterLB from the [PorterLB documentation](https://porterlb.io/docs/).
+
+## Advantages of PorterLB
+
+There are other load balancer implementations such as MetalLB designed for bare-metal Kubernetes clusters. Compared with others, PorterLB has the following advantages.
+
+### Cloud native
+
+To manage IP address pools and BGP properties for PorterLB, you only need to use the `kubectl apply` command provided by Kubernetes to create CRD objects. To obtain the status information about IP address pools and BGP peers, you can simply run `kubectl get` to view the status of the CRD objects. No other configuration files are required. In addition, a PorterLB GUI will be available soon, which will further simplify the usage of PorterLB.
+
+### Elegant
+
+After PorterLB is installed in a Kubernetes cluster, a porter-manager Deployment that contains a porter-manager Pod is created. The porter-manager Pod implements the functionality of PorterLB for the entire Kubernetes cluster. For high availability, you can scale the porter-manager Deployment and assign multiple PorterLB replicas (porter-manager Pods) to multiple cluster nodes. This simple architecture ensures that PorterLB can be easily managed and integrated with other systems.
+
+### Flexible
+
+PorterLB can be used in conventional Kubernetes clusters. As a sub-project of KubeSphere, PorterLB also fits well into the KubeSphere ecosystem. You can seamlessly integrate PorterLB as a plugin with KubeSphere to utilize the abundant features of the KubeSphere ecosystem, such as observability and troubleshooting, unified monitoring and logging, centralized storage and networking management, and easy-to-use CI/CD pipelines.

content/zh/blog/the-new-stack-interview-porter.md

@@ -0,0 +1,16 @@
+---
+title: "The Interview to PorterLB from The New Stack"
+linkTitle: "Media Interview"
+date: 2019-06-24
+description: >
+  The Interview to PorterLB from Alex Williams The New Stack, Founder & EiC.
+weight: 100002
+---
+
+On this livestream from KubeCon + CloudNativeCon China, Alex Williams was sitting down with Xuetao Song, Senior Software Engineer at Beijing Yunify Technology Co., Ltd. and Fang (Flora) Du, QingCloud Solution Architect at Beijing Yunify Technology Co., Ltd. to discuss open source load balancing on bare metal. PorterLB exists as an OSS solution to the issue of load balancing on bare metal in production on Kubernetes, which Song and Du are giving a presentation on at KCCNC + OSS Summit China 2019.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/zSWypFKaYcY" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+## Related Post
+
+Please reference [How a China-Based Bare Metal Service Provider Tackled Kubernetes Load Balancing](https://thenewstack.io/how-a-china-based-bare-metal-service-provider-tackled-kubernetes-load-balancing/) for details.

content/zh/community/_index.md

@@ -0,0 +1,8 @@
+---
+title: 社区
+menu:
+  main:
+    weight: 40
+---
+
+<!--add blocks of content here to add more sections to the community page -->

content/zh/docs/Concepts/_index.md

@@ -0,0 +1,18 @@
+---
+title: "Concepts"
+linkTitle: "Concepts"
+weight: 2
+no_list: true
+---
+
+This section describes the basic concepts of PorterLB.
+
+---
+
+##### **[BGP Mode](/docs/concepts/bgp-mode/)**
+
+Describes how PorterLB functions in BGP mode.         
+
+##### **[Layer 2 Mode](/docs/concepts/layer-2-mode/)**
+
+Describes how PorterLB functions in Layer 2 mode.      

content/zh/docs/Concepts/bgp-mode.md

@@ -0,0 +1,28 @@
+---
+title: "BGP Mode"
+linkTitle: "BGP Mode"
+weight: 1
+---
+
+This document describes the network topology of PorterLB in BGP mode and how PorterLB functions in BGP mode.
+
+{{< notice note >}}
+
+The BGP mode is recommended because it allows you to create a high availability system free of failover interruptions and bandwidth bottlenecks. To use the BGP mode, your router must support BGP and Equal-Cost Multi-Path (ECMP) routing. If your router does not support BGP or ECMP, you can use the Layer 2 mode to achieve similar functionality.
+
+{{</ notice >}}
+
+## Network Topology
+
+The following figure shows the topology of the network between a Kubernetes cluster where PorterLB is installed and a peer BGP router.
+
+![porter-bgp-topology](/images/docs/concepts/bgp-mode/porter-bgp-topology.jpg)
+
+IP addresses and Autonomous System Numbers (ASNs) in the preceding figure are examples only. The topology is described as follows:
+
+* A Service backed by two Pods is deployed in the Kubernetes cluster, and is assigned an IP address 172.22.0.2 for external access.
+* PorterLB installed in the Kubernetes cluster establishes a BGP connection with the BGP router, and publishes routes destined for the Service to the BGP router.
+* When an external client machine attempts to access the Service, the BGP router load balances the traffic among the master, worker 1, and worker 2 nodes based on the routes obtained from PorterLB. After the Service traffic reaches a node, kube-proxy can further forward the traffic to other nodes for load balancing (both Pod 1 and Pod 2 can be reached over kube-proxy).
+
+PorterLB uses [GoBGP](https://github.com/osrg/gobgp) (integrated in PorterLB) to establish a BGP connection for route publishing. Two [CustomResourceDefinitions (CRDs)](https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/), BgpConf and BgpPeer, are provided for users to configure the local and peer BGP properties on PorterLB. BgpConf and BgpPeer are designed according to the [GoBGP API](https://github.com/osrg/gobgp/blob/master/api/gobgp.pb.go). For details about how to use BgpConf and BgpPeer to configure PorterLB in BGP mode, see [Configure PorterLB in BGP Mode](/docs/getting-started/configuration/configure-porter-in-bgp-mode/).
+

content/zh/docs/Concepts/layer-2-mode.md

@@ -0,0 +1,36 @@
+---
+title: "Layer 2 Mode"
+linkTitle: "Layer 2 Mode"
+weight: 1
+---
+
+This document describes the network topology of PorterLB in Layer 2 mode and how PorterLB functions in Layer 2 mode.
+
+{{< notice note >}}
+
+Generally, you are advised to use the BGP mode because it allows you to create a high availability system free of failover interruptions and bandwidth bottlenecks. However, the BGP mode requires your router to support BGP and Equal-Cost Multi-Path (ECMP) routing, which may be unavailable in certain systems. In this case, you can use the Layer 2 mode to achieve similar functionality.
+
+{{</ notice >}}
+
+## Network Topology
+
+The following figure shows the topology of the network between a Kubernetes cluster with PorterLB and a router.
+
+![porter-layer-2-topology](/images/docs/concepts/layer-2-mode/porter-layer-2-topology.jpg)
+
+IP addresses and MAC addresses in the preceding figure are examples only. The topology is described as follows:
+
+* A Service backed by two Pods is deployed in the Kubernetes cluster, and is assigned an IP address 192.168.0.91 for external access. The Service IP address is on the same network segment as the cluster node IP addresses.
+* PorterLB installed in the Kubernetes cluster randomly selects a node (worker 1 in this example) to handle Service requests. After that, PorterLB sends an ARP/NDP packet to the router, which maps the Service IP address to the MAC address of worker 1.
+* If multiple porter-manager replicas have been deployed in the cluster, PorterLB uses the the leader election feature of Kubernetes to ensure that only one replica responds to ARP/NDP requests. 
+* When an external client machine attempts to access the Service, the router forwards the Service traffic to worker 1 based on the mapping between the Service IP address and the MAC address of worker 1. After the Service traffic reaches worker 1, kube-proxy can further forward the traffic to other nodes for load balancing (both Pod 1 and Pod 2 can be reached over kube-proxy).
+* If worker 1 fails, PorterLB re-sends an APR/NDP packet to the router to map the Service IP address to the MAC address of worker 2, and the Service traffic switches to worker 2.
+
+{{< notice note >}}
+
+The Layer 2 mode has two limitations:
+
+* Worker 1 and worker 2 work in active-standby mode in terms of traffic forwarding. When a failover occurs, Services in the Kubernetes cluster will be interrupted for a short while.
+* All Service traffic is always sent to one node first and then forwarded to other nodes over kube-proxy in a second hop. Therefore, the Service bandwidth is limited to the bandwidth of a single node, which causes a bandwidth bottleneck.
+
+{{</ notice >}}

content/zh/docs/Overview/_index.md

@@ -0,0 +1,42 @@
+---
+title: "Overview"
+linkTitle: "Overview"
+weight: 1
+---
+
+![porter-logo](/images/docs/overview/porter-logo.png)
+
+PorterLB is an open-source load balancer implementation designed for bare-metal Kubernetes clusters.
+
+## Why PorterLB
+
+In cloud-based Kubernetes clusters, Services are usually exposed by using load balancers provided by cloud vendors. However, cloud-based load balancers are unavailable in bare-metal environments. PorterLB allows users to create LoadBalancer Services in bare-metal environments for external access, and provides the same user experience as cloud-based load balancers.
+
+## Core Features
+
+- BGP mode and Layer 2 mode
+- ECMP routing and load balancing
+- IP address pool management
+- BGP configuration using CRDs
+- Installation using Helm and KubeSphere
+
+## Support, Discussion and Contributing
+
+PorterLB is a sub-project of [KubeSphere](https://github.com/kubesphere).
+
+* Join us at the [KubeSphere Slack Channel](https://kubesphere.slack.com/join/shared_invite/enQtNTE3MDIxNzUxNzQ0LTZkNTdkYWNiYTVkMTM5ZThhODY1MjAyZmVlYWEwZmQ3ODQ1NmM1MGVkNWEzZTRhNzk0MzM5MmY4NDc3ZWVhMjE#/) to get support or simply tell us that you are using PorterLB.
+* You have code or documents for PorterLB? Contributions are always welcome! See [Building and Contributing](/docs/building-and-contributing/) to obtain guidance.
+
+## Landscapes
+
+<p align="center">
+<br/><br/>
+<img src="https://landscape.cncf.io/images/left-logo.svg" width="150"/>&nbsp;&nbsp;<img src="https://landscape.cncf.io/images/right-logo.svg" width="200"/>&nbsp;&nbsp;
+<br/><br/>
+PorterLB is a promising newcomer in Service proxy, which enriches the <a href="https://landscape.cncf.io/landscape=observability-and-analysis&license=apache-license-2-0">CNCF CLOUD NATIVE Landscape.
+</a>
+</p>
+
+## License
+
+PorterLB is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/kubesphere/porter/blob/master/LICENSE) for the full license text.

content/zh/docs/_index.md

@@ -0,0 +1,33 @@
+---
+title: "文档"
+linkTitle: "文档"
+weight: 20
+menu:
+  main:
+    weight: 20
+no_list: true
+---
+
+Follow the documentation to learn how to use PorterLB.
+
+---
+
+##### **[Overview](/docs/overview/)**
+
+Introduces PorterLB.
+
+##### **[Concepts](/docs/concepts/)**
+
+Describes the basic concepts of PorterLB.
+
+##### **[Getting Started](/docs/getting-started/)**
+
+Describes how to install, configure, and use PorterLB.
+
+##### **[Building and Contributing](/docs/building-and-contributing/)**
+
+Describes how to build the PorterLB project for testing and contribute to the PorterLB project.
+
+##### **[FAQs](/docs/faqs/)**
+
+Provides solutions to frequently asked questions.

content/zh/docs/building-and-contributing/_index.md

@@ -0,0 +1,16 @@
+---
+title: "Building and Contributing"
+linkTitle: "Building and Contributing"
+weight: 4
+no_list: true
+---
+
+This section describes how to build the PorterLB project for testing and contribute to the PorterLB project.
+
+##### **[Build the PorterLB Porject](/docs/building-and-contributing/build-the-porter-project/)**
+
+Describes how to build the PorterLB project for testing.
+
+##### **[Contribute to the PorterLB Porject](/docs/building-and-contributing/contribute-to-the-porter-project/)**
+
+Describes how to contribute to the PorterLB project.