Kubernetesイングレスは、外部からKubernetesクラスタサービスへのトラフィックをルーティングするためにルールを追加します。この記事では、Kubernetes展開コントローラ入に外部トラフィックをルーティングするためだけでなく、侵入の概念を理解します。
一般的に、カスタムまたはnginxのHAproxy Kubernetesの展開は、クラスタ内のサービスの外部トラフィックのためのエージェントというサービスとして公開されます。前記ルーティングルールは、ポッドを焼くとconfigmapとして追加されます。Kubernetes進入動作は同様であるが、Kubernetes入力オブジェクトとしてルーティングルールを維持します。これは、動的な再デプロイプロキシポッドへの必要性を排除し、ルールの構成をルーティングの大きな利点があります。
Kubernetesイングレスのエントリで
Kubernetesイングレスで素晴らしいスタートをしたい、あなたは二つの重要な概念を理解する必要があります。
1、Kubernetesイングレス
2、コントローラKubernetesイングレス
さんが一つ一つを理解しましょう。
イングレスKubernetes
Kubernetesイングレスは、クラスタサービスのエンドポイントの外側から内側にトラフィックをルーティングするルールを設定することができ、ネイティブKubernetes資源です。これは、オブジェクトを指定されたルート進入規則に進入コントローラーが必要です。次のように入オブジェクトは、次のとおりです。
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: test-ingress
namespace: dev
spec:
rules:
- host: test.apps.example.com
http:
paths:
- backend:
serviceName: hello-service
servicePort: 80
test.apps.example.comへのすべてのコールは、サービスの名前のハローサービスを打つべきであると上記のステートメント手段が、サービスはDEVの名前空間に位置しています。
イングレスは、あなたが次のことを知っておく必要がある重要な問題上のオブジェクト:
あなたがサービスを展開し、名前空間に進入するルールを作成する必要があります。なし他の名前空間の入口のオブジェクトの場合は、内のサービスのトラフィックをルーティングすることができません。
入力オブジェクトは、トラフィックをルーティングする入力制御を必要とします
外部流量将不会hit ingress API,而是hit ingress controller服务。
Kubernetes Ingress Controller
Ingress controller是一个典型的部署在集群中的代理服务,它只是暴露给服务的Kubernetes部署。以下是可用于Kubernetes的Ingress Controller:
Nginx Ingress Controller
Traefik
HAproxy
Contour
GKE Ingress Controller
目前,Nginx是大多数企业的选择。以下是Nginx Ingress Controller的工作原理:
在Nginx controller pod内部的nginx.conf文件是一个go 模板,它可以与Kubernetes Ingress API通信并实时获得流量路由的最新值。
Nginx controller与Kubernetes ingress API 通信以检查是否为流量路由创建了规则。
如果它发现了任何ingress规则,它将应用到Nginx Controller配置,也就是使用go模板在pod内的nginx.conf文件。
如果你使用exec连接到pod并检查/etc/nginx/nginx.conf文件,则可以看到在conf文件中应用的ingress对象中指定的所有规则。
以下的架构图将解释在一个Kubernetes集群上的ingress设置。
接下来,我们详细看看如何使用Nginx Ingress Controller在Kubernetes中设置Ingress。
前期准备
一个Kubernetes集群
安装好的kubectl并已对Kubernetes集群进行身份验证
Kubernetes集群的管理员访问权限
指向ingress controller负载均衡器的有效域
如果你在谷歌云上,请为你的账户分配管理员权限以启用集群角色。
ACCOUNT=$(gcloud info --format='value(config.account)')
kubectl create clusterrolebinding owner-cluster-admin-binding \
--clusterrole cluster-admin \
--user $ACCOUNT
请注意:本教程已在Google Cloud GKE集群上尝试过。理论上,它可在所有云环境中使用。如果你真的遇到任何错误,则可能需要在设置中进行一些调整。
设置Nginx Ingress Controller
有两个nginx ingress controller:
Kubernetes社区的Nginx ingress controller: https://github.com/kubernetes/ingress-nginx
Nginx公司的Nginx ingress controller: https://github.com/nginxinc/kubernetes-ingress
我们将使用Kubernetes社区的nginx controller。
Ingress controller需要特定的命名空间、服务账户、集群角色绑定、configmap等。因此,你需要使用官方ingress repo中的yaml文件来创建所提到的Kubernetes对象。
官方repo:
https://github.com/kubernetes/ingress-nginx/tree/master/deploy
让我们使用mandatory.yaml文件部署ingress controller,你可以在官方repo找到它。它有nginx所需的Kubernetes对象列表。
让我们使用kubectl创建Nginx controller deployment:
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/static/mandatory.yaml
检查ingress controller pod以确保它是否正确设置:
kubectl get pods -n ingress-nginx
为Ingress Controller设置 LoadBalancer 服务
下一步是创建一个LoadBalancer类型的服务,以在集群外部暴露nginx controller部署。
Step1:在本地创建项目目录,然后切换到该目录。
mkdir ingress-deployment && cd ingress-deployment
Step2:创建一个名为nginx-ingress.yaml的文件
vi nginx-ingress.yaml
Step3:复制以下内容到文件
请注意:label下的annotation对于nginx controller部署集成非常重要
kind: Service
apiVersion: v1
metadata:
name: ingress-nginx
namespace: ingress-nginx
labels:
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/part-of: ingress-nginx
spec:
externalTrafficPolicy: Local
type: LoadBalancer
selector:
app.kubernetes.io/name: ingress-nginx
app.kubernetes.io/part-of: ingress-nginx
ports:
- name: http
port: 80
targetPort: http
- name: https
port: 443
targetPort: https
Step4:创建ingress 服务
kubectl apply -f nginx-ingress.yaml
Step5:检查已创建的服务是否已连接到外部负载均衡器
kubectl get svc -n ingress-nginx
将域名映射到Loadbalancer IP
为了让我们的ingress的设置运转起来,我们需要映射一个域名到负载均衡器IP。你可以用两种方式,完成此操作。
单个DNS映射
你可以将单个域作为A record直接映射到负载均衡器IP,使用这一功能,你只能为ingress controller提供一个域,并可以基于多个路径进行流量路由。
例如:
www.example.com --> Loadbalancer IP
您可以使用此模型进行基于路径的路由。
以下有几个例子:
http://www.example.com/app1
http://www.example.com/app2
http://www.example.com/app1/api
http://www.example.com/app2/api
通配符DNS映射
如果你映射一个通配符DNS到负载均衡器,你就可以通过ingress拥有动态DNS端点。
例如:
*.apps.example.com
这样,你可以通过单个ingress controller拥有多个动态子域,并且每个DNS有自己基于路径的路由。
例如:
#URL one
http://demo1.apps.example.com/api
http://demo1.apps.example.com/api/v1
http://demo1.apps.example.com/api/v2
#URL two
http://demo2.apps.example.com/api
http://demo2.apps.example.com/api/v1
http://demo2.apps.example.com/api/v2
出于演示目的,我们已将通配符DNS映射到LoadBalancer IP。你可以根据你的DNS提供商进行此设置。
设置一个Demo 应用程序
出于测试的目的,我们将部署一个demo应用程序并且添加一个ClusterIP服务到应用程序上。
Step1:创建一个名为dev的命名空间
kubectl create namespace dev
Step2:创建一个名为hello-app.yaml
的文件
Step3:复制以下内容到文件并保存
apiVersion: apps/v1
kind: Deployment
metadata:
name: hello-app
namespace: dev
spec:
selector:
matchLabels:
app: hello
replicas: 3
template:
metadata:
labels:
app: hello
spec:
containers:
- name: hello
image: "gcr.io/google-samples/hello-app:2.0"
Step4:使用kubectl创建deployment
kubectl create -f hello-app.yaml
检查deployment状态
Step5:创建一个名为hello-app-service.yaml
的文件
Step6:复制以下内容到文件并保存
apiVersion: v1
kind: Service
metadata:
name: hello-service
namespace: dev
labels:
app: hello
spec:
type: ClusterIP
selector:
app: hello
ports:
- port: 80
targetPort: 8080
protocol: TCP
Step7:使用kubectl创建服务
kubectl create -f hello-app-service.yaml
检查服务状态
kubectl get svc -n dev
创建Kubernetes Ingress对象
现在让我们使用一个DNS创建一个Ingress对象来访问我们的hello app。Ingress对象可以设置路由规则。
Ingress controller pod会连接到Ingress API来检查规则,并且会相应地更新其nginx.conf。
Step1:创建一个名为ingress.yaml
的文件
Step2:复制以下内容到文件并保存
使用你的域名替换test.apps.example.info
。此处,我们假设你已经有*.apps.example.info
格式的通配符域名。
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: test-ingress
namespace: dev
spec:
rules:
- host: test.apps.example.info
http:
paths:
- backend:
serviceName: hello-service
servicePort: 80
Step3:描述已创建的ingress对象,它用于检查配置
kubectl describe ingress -n dev
现在,如果你尝试访问test.apps.example.info
域(用你的域名代替它),你应该能够访问我们部署的app。
原文链接:
https://devopscube.com/kubernetes-ingress-tutorial/
https://devopscube.com/setup-ingress-kubernetes-nginx-controller/