yzeng25 commented on a change in pull request #687: URL: https://github.com/apache/apisix-website/pull/687#discussion_r738898379
########## File path: website/blog/2021/10/22/cert-manager-in-ingress.md ########## @@ -1,66 +1,66 @@ --- -title: "教程篇：如何在 Apache APISIX Ingress Controller 中使用 Cert Manager 管理证书" -author: "张超" +title: "Tutorial: How to use Cert Manager to manage certificates in Apache APISIX Ingress Controller" +author: "Chao Zhang" authorURL: "https://github.com/tokers"; authorImageURL: "https://avatars.githubusercontent.com/u/10428333?v=4"; keywords: - Apache APISIX Ingress Controller - Apache APISIX - Cert Manager - Kubernetes -description: 本文将通过详细的代码步骤为大家介绍如何通过 Cert Manager 在 Apache APISIX Ingress Controller 里进行证书管理。 +description: This article shows how to create a certificate and pair it with Apache APISIX Ingress Controller via the Cert Manager. tags: [technology] --- -> 本文将通过详细的代码步骤为大家介绍如何通过 Cert Manager 在 Apache APISIX Ingress Controller 里进行证书管理。 +> This article shows how to create a certificate and pair it with Apache APISIX Ingress Controller via the Cert Manager. <!--truncate--> -[Apache APISIX Ingress Controller](https://github.com/apache/apisix-ingress-controller) 是一款以 [Apache APISIX](http://apisix.apache.org/) 作为数据面的 [Kubernetes Ingress Controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) 开源工具，目前已经更新到 [v1.3](https://github.com/apache/apisix-ingress-controller/blob/master/CHANGELOG.md#130) 版本，实现了如证书管理、负载均衡、金丝雀发布等功能。 +[Apache APISIX Ingress Controller](https://github.com/apache/apisix-ingress-controller) is a [Kubernetes Ingress Controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) Open Source Tool that uses [Apache APISIX](http://apisix.apache.org/) as a data surface and has been updated to [v1.3](https://github.com/apache/apisix-ingress-controller/blob/master/CHANGELOG.md#130) with features such as certificate management, load balancing, Canary Publishing, and more. -长久以来，证书管理都不是一件简单的事情，虽然 Apache APISIX Ingress Controller 支持从 Kubernetes Secrets 资源中提取证书和私钥，并转换为 Apache APISIX 可识别的 SSL 对象，但这只是整个证书管理链中的一部分，证书的颁发、轮转、吊销逻辑依然需要管理员执行，尤其当证书数量比较多时，工作量往往并不小，因而会占用管理员不少的时间。 +For a long time, certificate management is not a simple thing although Apache APISIX Ingress Controller supports extracting certificates and private keys from Kubernetes Secrets Resources and converting them into Apache APISIX recognizable SSL objects, but this is only a part of the whole certificate management chain, certificate issuance, rotation, revocation logic still need to be implemented by administrators, especially when the number of certificates is relatively large, the workload is often not small, so it takes up a lot of the administrator’s time. -[Cert Manager](https://cert-manager.io/docs/) 是一款致力于在 Kubernetes 平台上简化证书管理的软件，它支持对接许多不同的证书源，如 [Let’s Encrypt](https://letsencrypt.org/) 和 [HashiCorp Vault](https://www.vaultproject.io/)。 +[Cert Manager](https://cert-manager.io/docs/) is a piece of software dedicated to simplifying certificate management on the Kubernetes platform and supports docking many different certificate sources, such as [Let’s Encrypt](https://letsencrypt.org/) and [HashiCorp Vault](https://www.vaultproject.io/). -如果你在使用 Apache APISIX Ingress Controller 时，遇到了证书管理的麻烦，那么使用 Cert Manager 将会是一个不错的选择，本文将介绍如何通过 Cert Manager 来创建证书并对接到 Apache APISIX Ingress Controller。 +If you’re having trouble with certificate management when using Apache APISIX Ingress Controller, using the Cert Manager is a good option, and this article shows how to create a certificate and pair it with Apache APISIX Ingress Controller via the Cert Manager. -## 步骤一：环境准备 +## Step 1: Environmental Preparation -如果你希望按照本文的指导进行实际的操作，请确保以下环境和工具已准备就绪： +If you want to follow the instructions in this article, make sure the following environments and tools are in place: -1. 准备一个可用的 Kubernetes 集群，开发环境中，你可以使用 [Kind](https://kind.sigs.k8s.io/) 和 [Minikube](https://kubernetes.io/docs/tutorials/hello-minikube/) -2. 安装 [kubectl](https://kubernetes.io/docs/tutorials/hello-minikube/) -3. 安装 [Helm v3](https://helm.sh/) +1. To prepare a usable Kubernetes cluster, in the development environment, you can use [Kind](https://kind.sigs.k8s.io/) and [Minikube](https://kubernetes.io/docs/tutorials/hello-minikube/) +3. Install [kubectl](https://kubernetes.io/docs/tutorials/hello-minikube/) +4. Install [Helm v3](https://helm.sh/) -> 请注意，下文所有的操作都将在 ingress-apisix 命名空间中执行，因此需要先创建该命名空间：`kubectl create namespace ingress-apisix` +> Note that all of the following operations will be performed in the ingress-apisix namespace, so you need to create the namespace first: `kubectl create namespace ingress-apisix` -## 步骤二：安装 Apache APISIX Ingress Controller +## Step 2：Install Apache APISIX Ingress Controller -我们可以通过 Helm 来安装 Apache APISIX Ingress Controller，包括数据面的 Apache APISIX 和 etcd 集群。 +You can install Apache APISIX Ingress Controller via Helm, including Apache APISIX and etcd clusters for data planes. ``` shell helm repo add apisix https://charts.apiseven.com helm repo update helm install apisix apisix/apisix --set gateway.tls.enabled=true --set ingress-controller.enabled=true --namespace ingress-apisix ``` -点击查看[详细安装介绍](https://github.com/apache/apisix-helm-chart/blob/master/charts/apisix/README.md)。 +Click to view the [installation details](https://github.com/apache/apisix-helm-chart/blob/master/charts/apisix/README.md). -## 步骤三：安装 Cert Manager +## Step 3：Install Cert Manager -通过 Helm 来安装 Cert Manager，点击可查看[详细安装介绍](https://cert-manager.io/docs/installation/)。 +To Install Cert Manager from Helm, click to view the [installation details](https://cert-manager.io/docs/installation/). ```shell helm install cert-manager jetstack/cert-manager --namespace ingress-apisix --set prometheus.enabled=false --set installCRDs=true ``` -安装完毕后请等待一会后查看组件的运行状态，确保所有组件都已正常运行，你可以通过如下命令进行查看。 +Please wait for a moment after installation to check the running status of the components and make sure that all the components are working properly. You can do this by following the command. ```shell kubectl get all -n ingress-apisix ``` -返回结果如下所示，表示所有组件都已正常运行。 +The result is as follows, indicating that all components are working properly. ```Apache Review comment: ```suggestion ```shell ``` ########## File path: website/blog/2021/10/22/cert-manager-in-ingress.md ########## @@ -218,15 +218,15 @@ spec: servicePort: 80 ``` -接下来访问服务 `apisix-gateway`。注意，默认情况下该服务的类型为 `NodePort`，你可以根据需要修改其类型，比如你的 Kubernetes 集群是云厂商托管的，则可以考虑将其修改为 `LoadBalancer` 类型，以获取一个外部可达的 IP。 +Next access the service `apisix-gateway`. Note that the service is `NodePort` by default, and you can change its type as needed. If your Kubernetes cluster is hosted by the cloud vendor, consider changing it to the LoadBalancer type, to get an externally accessible IP. Review comment: ```suggestion Next access the service `apisix-gateway`. Note that the service is `NodePort` by default, and you can change its type as needed. If your Kubernetes cluster is hosted by the cloud vendor, consider changing it to the `LoadBalancer` type, to get an externally accessible IP. ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
