ISTIO 学习笔记(一)之 安装

一、背景

  serviceMesh 目前 在服务治理方面 作为新兴技术 已逐步被使用,其对应的 产品为 Istio。

二、部署

1、前提条件

    在物理服务器上或虚拟机中部署好 kubernetes集群。 (参考:kubernetes 学习笔记之安装)

2、部署 Istio

    Istio目前最新版本为1.7.3,但是由于1.7.3提供的 demo profile 不支持默认安装 grafana、kiali、prometheus、tracing 等第三方组件,但 1.6.12支持,且1.6.12和1.7.3 在架构上是一致的,所以选择安装1.6.12。

(1) 下载包

   在 https://github.com/istio/istio/releases 中下载

 (2) 配置 istioctl

    将istio-1.6.12-linux-amd64.tar.gz上传到安装kubernetes集群的物理机或虚拟机上,执行以下命令。

#切换到包所在目录

cd /root/wf

#解压包

tar -zxvf  istio-1.6.12-linux-amd64.tar.gz

#重命名

mv istio-1.6.12 istio

#添加环境变量

vi /etc/profile

export PATH=/root/wf/istio/bin:$PATH

#修改的环境变量生效

source /etc/profile

#验证istioctl命令是否存在

istioctl

(3) 安装 istio

  a) 查看 profile demo

说明:

  • addonComponents:表示要安装的第三方组件,这里显示:istiocoredns不默认安装,grafana\kiali\prometheus\tracing默认安装;
  • components:表示istio内部组件,这里显示,citadel\cni不默认安装。

  b) 执行部署命令

    为了最大限度的能够使用istio的特性功能,这里选择安装所有支持的addonComponents及components。

istioctl manifest apply --set profile=demo --set addonComponents.istiocoredns.enabled=true --set components.citadel.enabled=true --set components.cni.enabled=true

  c) 配置 kiali kubernetes 集群外可访问

  • 在kubernetes中创建gateway及vritualservice,文件信息如下:
apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: kiali
  namespace: istio-system
spec:
  gateways:
  - kiali-gateway  #该虚拟服务的路由规则适用于流入kiali-gateway网关的流量
  hosts:
  - "*"
  http:
  - match:
    - uri:
        prefix: /
    route:
    - destination:
        host: kiali
        port:
          number: 20001
---
apiVersion: networking.istio.io/v1alpha3
kind: Gateway
metadata:
  name: kiali-gateway
  namespace: istio-system
spec:
  selector:
    istio: ingressgateway   #使用 istio 提供的 ingressgateway服务
  servers:
  - port:
      number: 80
      name: http
      protocol: HTTP
    hosts:
          - "*"
  • gateway 及 vritualservice(PS:其实vritualservice可以直接用于所有集群入口流量路由的配置)
#部署gateway\virtualservice
kubectl apply -f /root/wf/docker/kiali-virtualservice.yaml
#查看istio-system 安装的 istio-ingressgateway 对外提供的访问端口
kubectl get svc -n istio-system

 图中显示 istio-ingressgateway 80 对外对应的端口为 30932

  • 配置 grafana 到 kiali 中
#查看kiali的configmap内容,其实可以看到kiali挂载的配置文件config.yaml 中grafana.url值为空
kubectl get cm -n istio-system kiali -o yaml
#编辑configmap
kubectl edit cm –n istio-system kiali

 

   配置完成后,可以在services/workload下的 Inbound Metrics/ Outbound Metrics 看到内容。

(3) 部署 bookinfo 示例程序

  • 部署
#查看集群中所有的命名空间
kubectl get namespaces
#查看default命名空间的信息
kubectl describe ns default
#给default命名空间添加标签,该标签添加成功则部署在该命名空间中的pod会自动注入sidecar容器
kubectl label namespace default istio-injection=enabled
#部署bookinfo 官方示例程序
kubectl apply-f /root/wf/istio/samples/bookinfo/platform/kube/ bookinfo.yaml
#检查是否bookinfo相关的pod都是running状态
kubectl get pods 
#当发现通过以上部署pod时,未创建pod且原因 为 sidecar容器自动失败,此时可以采用手动注入方式
#卸载bookinfo示例程序
kubectl delete -f /root/wf/istio/samples/bookinfo/platform/kube/ bookinfo.yaml
#手动注入sidecar容器
istioctl kube-inject -f /root/wf/istio/samples/bookinfo/platform/kube/ bookinfo.yaml |kubectl apply -f -
  • 配置 bookinfo kubernetes 集群外可访问

            在配置kiali的时候已经创建了针对kubernetes集群外访问集群内服务的gateway,因此这里直接使用这个gateway,现在要做的是创建virtualservice,内容如下:

apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: bookinfo
spec:
  hosts:
  - "*"
  gateways:
  - istio-system/kiali-gateway
  http:
  - match:
    - uri:
        exact: /productpage
    - uri:
        prefix: /static
    - uri:
        exact: /login
    - uri:
        exact: /logout
    - uri:
        prefix: /api/v1/products
    route:
    - destination:
        host: productpage
        port:
            number: 9080

执行命令:

kubectl apply –f /root/wf/istio/samples/bookinfo/networking/bookinfo-gateway.yaml

  在浏览器输入 http://x.x.x.x:30932/productpage 即可访问集群内的 bookinfo系统,不断刷新会发现页面右侧的星级状态一直在发生变化。

三、部署过程中遇到的问题

1、镜像拉取不成功

(1) 在通过istioctl manifest部署的时候,会遇到timeout的情况,导致部署不成功。

排查方法:

#istio内部组件及第三方组件默认安装在 istio-system命名空间
#查看该命名空间上的所有pod,会看到部分不是running的状态
kubectl get pods –n istio-system
#查看失败的pod的描述信息,在events 一栏可以看到错误信息,这里会提示是imagepull失败,xxx 为 pod name
kubectl describe pod xxx –n istio-system

解决办法:

  方法一:让kubernetes 所属服务器能够连上外网(这种是最好的,这样部署的时候,会自动从外网拉取所需镜像文件);

  方法二:在方法一不可行的情况下使用,提前下载好所有需要的image.

  a) 在kubernetes服务器上,通过以下命令获取所有需要下载的image

kubectl get deployment –n istio-system –o yaml > test.yaml

     打开test.yaml文件,其中image 的值就是需要的image.

grafana/grafana:6.7.4
docker.io/istio/proxyv2:1.6.12
docker.io/jaegertracing/all-in-one:1.16
coredns/coredns:1.6.2
istio/coredns-plugin:0.2-istio-1.1
docker.io/istio/pilot:1.6.12
quay.io/kiali/kiali:v1.18
docker.io/prom/prometheus:v2.15.1
docker.io/istio/install-cni:1.6.12

  b) 使用一台可以连接外网的服务器,且该服务器上已经安装了docker;

  c) 在可连接外网的服务器上执行以下命令,save image

docker pull xxxx
docker images
docker save –o /root/wf/kiali.tar quay.io/kiali/kiali:v1.18

   d) 在kubernetes 服务器上,load image 到docker中(PS: kubernetes集群的master 和worker node所属服务器都要操作)

        将连接外网上save下来 image文件都上传到kubernetes所属服务器上,并执行以下命令。

#加载镜像文件
docker load -i kiali.tar
#显示本地docker中所有的镜像文件
docker images

   e) 重新部署 istio

#卸载
istioctl manifest generate --set profile=demo --set addonComponents.istiocoredns.enabled=true --set components.citadel.enabled=true --set components.cni.enabled=true | kubectl delete -f -
#安装
istioctl manifest apply --set profile=demo --set addonComponents.istiocoredns.enabled=true --set components.citadel.enabled=true --set components.cni.enabled=true

 (2) 部署 bookinfo 中也会出现 pod 状态部署 running,且是由于镜像拉取失败造成的,按照以上方式提前准备好镜像。

#卸载
kubectl delete -f /root/wf/istio/samples/bookinfo/platform/kube/ bookinfo.yaml
#部署
kubectl apply-f /root/wf/istio/samples/bookinfo/platform/kube/ bookinfo.yaml

2、部署 bookinfo 发现对应的 pod 没有创建

排查方法:

#查看default命名空间中所有已创建的 deployment
kubectl getdeployment 
#查看default命名空间中 name为details-v1 的deployment信息
kubectl describe deployment details-v1
#查看副本资源数据信息
kubectl describe rs/details-v1-5974b67c8

 

 

 有时副本资源报的错误信息如下:

通过如下命令也可以查看到错误日志:

kubectl logs kube-controller-manager-master1 -n kube-system

或者

kubectl logs kube-apiserver-master1 -n kube-system

 解决方法:

   以上是网络插件存在问题,在istio的deployment部署文件中添加 hostNetwork:true,表示使用宿主机网络,即没有问题。但是具体原因,好需要研究。

 

posted @ 2020-10-20 19:42  夏之夜  阅读(1339)  评论(0编辑  收藏  举报