在Minikube部署NGINX Ingress Controller¶

Ingress 是定义允许外部访问集群服务的规则的API对象，而 Ingress控制器(controller) 则是实现Ingress规则的组件。

激活Ingress Controlleer¶

执行以下命令激活NGINX Ingress controller:
```
minikube addons enable ingress
```
验证NGINX ingress controller已经运行:
```
kubectl get pods -n kube-system
```

可以看到输出:

NAME                                        READY   STATUS    RESTARTS   AGE
...
default-http-backend-6864bbb7db-kv2sm       1/1     Running   0          2m56s
...
nginx-ingress-controller-586cdc477c-xj9rq   1/1     Running   0          2m55s
...

部署hello,wold app¶

使用以下命令创建一个测试部署:

kubectl run web --image=gcr.io/google-samples/hello-app:1.0 --port=8080

直接输出部署(NodePort)

kubectl expose deployment web --target-port=8080 --type=NodePort

检查输出的服务:
```
kubectl get service web
```

显示输出:

NAME   TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
web    NodePort   10.97.135.77   <none>        8080:32030/TCP   23s

验证服务通过NodePort的输出:
```
minikube service web --url
```

显示输出:

http://192.168.101.81:32030

现在我们可以检查这个对外输出:
```
curl http://192.168.101.81:32030
```

显示输出:

Hello, world!
Version: 1.0.0
Hostname: web-ddb799d85-889fm

备注

现在我们使用NodePort方式输出服务，对外的端口是随机的，所以并适合日常使用服务。下面我们正式采用 Ingress 来输出服务

创建Ingress资源¶

创建 example-ingress.yaml 如下:

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
 rules:
 - host: hello-world.info
   http:
     paths:
     - path: /*
       backend:
         serviceName: web
         servicePort: 8080

使用以下命令创建 Ingress 资源:
```
kubectl apply -f example-ingress.yaml
```

输出显示:

ingress.extensions/example-ingress created

验证IP地址:
```
kubectl get ingress
```

当前还没有显示IP地址:

NAME              HOSTS              ADDRESS   PORTS   AGE
example-ingress   hello-world.info             80      26s

不过，几分钟之后再次使用该命令就可以看到服务对外低筒的IP地址:

NAME              HOSTS              ADDRESS          PORTS   AGE
example-ingress   hello-world.info   192.168.101.81   80      96s

备注

注意，Ingress对外输出的端口默认是HTTP端口，所以后端指定服务端口8080就会将对外输出的80端口反向代理到内部网络的应用服务器的8080端口。实际上这是我们很久以前就常用的Nginx反向代理部署，只不过Kubernetes高度抽象并自动化完成了这些部署。

在本次主机 /etc/hosts 中添加解析:
```
192.168.101.81 hello-world.info
```
现在我们就可以直接像平时访问WEB服务器一样访问kubernetes集群对外输出的WEB服务:
```
curl hello-world.info
```

输出内容就是:

Hello, world!
Version: 1.0.0
Hostname: web-ddb799d85-889fm

创建第二个部署¶

创建 v2 部署:

kubectl run web2 --image=gcr.io/google-samples/hello-app:2.0 --port=8080

同样也将这个部署输出:

kubectl expose deployment web2 --target-port=8080 --type=NodePort

编辑刚才的 example-ingress.yaml 添加以下内容:

- path: /v2/*
  backend:
    serviceName: web2
    servicePort: 8080

然后将修改生效:
```
kubectl apply -f example-ingress.yaml
```

验证Ingress¶

现在可以有2个pod，都是运行在8080的端口，其中1st版本访问:
```
curl hello-world.info
```

输出:

Hello, world!
Version: 1.0.0
Hostname: web-ddb799d85-889fm

访问 2nd 版本:
```
curl hello-world.info/v2
```

输出:

Hello, world!
Version: 2.0.0
Hostname: web2-5cf6945d9b-v5fbq

参考¶

Set up Ingress on Minikube with the NGINX Ingress Controller