# envoy_powershell

**Repository Path**: weifuwu_springcloud/envoy_powershell

## Basic Information

- **Project Name**: envoy_powershell
- **Description**: powershell 语言编写的 envoy 控制平面。类似于“kong”的负载均衡网关
- **Primary Language**: PowerShell
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-02-18
- **Last Updated**: 2021-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# powershell 语言编写的 envoy 控制平面。

# Envoy control plane written in powershell language.

# 类似于“kong”的动态负载均衡网关

开源+免费项目

项目名：《envoy_powershell》

项目中文名：《envoy powershell 遥控器》

git clone https://gitee.com/chuanjiao10/envoy_powershell.git

git clone git@gitee.com:chuanjiao10/envoy_powershell.git

powershell传教士 作品

技术支持qq群：k4t国产k8s群1

qq群   号：722528388

MIT License

------

envoy是比nginx更好的负载均衡网关，istio就是基于envoy。它的特色是【动态配置】负载均衡后端。而nginx的配置变化需要狂reload。

本项目是powershell语言编写的 envoy 控制平面。

本项目通过在linux中运行一个envoy容器，和powershell脚本，

把【使用本地配置文件，来动态控制envoy】，转换成【从命令行，经过ssh协议，通过命令，控制envoy】，

以达到动态添加后端，删除后端，添加路由，删除路由的功能。

本项目暂时没有写，添加多个envoy【listeners】的脚本。即默认转发源，是一个ip。因为负载均衡网关会占用多核心cpu，建议多虚拟机使用。

可以通过在虚拟机内建立多个ip，和多个目录，docker run多个envoy容器，来实现多个【listeners】副本。

# 使用场景

* 微服务Api gateway

* K8s边缘网关

# 题外话

实际上，不用docker转，而直接在linux中安装二进制的envoy。或许网络性能更好，出问题几率更小。

# 风险警告

生产使用时，应该编辑【envoy.yaml】的【address: 0.0.0.0】，改成【address: 127.0.0.1】或你信任的ip。

------

# 由于目前是第一版，或许bug较多，勿喷！

# 安装

## 1 安装一台linux，不支持win。

## 2 linux一键安装powershell。

https://gitee.com/chuanjiao10/kasini3000_agent_linux

## 3 用git下载本软件的所有脚本，并保存在/etc/envoy_ps1。

## 4 linux上安装docker。

https://docs.docker.com/engine/install/

## 5 下载envoy。

```
docker pull envoyproxy/envoy-alpine:v1.14.4
```

------

# 问：url跳转的源ip是什么？

答： 你的linux的ip

# 问：url跳转的源端口是什么？

答： 取决于你运行docker时的命令行。

下面例子中，源端口就是80

```
docker container run -d -p 80:10000
```

------

# 经过ssh，远程命令行的用法：

```
ssh root@你的linux的ip pwsh -f /etc/envoy_ps1/add-eds.ps1 -cname cds名 -ip 1.2.3.4 -port 80
```

------

# 问：如何运行容器？

答：  docker container run -d -p 80:10000 -p 9901:9901 -v /etc/envoy_ps1:/etc/envoy envoyproxy/envoy-alpine:v1.14.4

* envoy的lds监听，本机linux的，所有ip的，10000端口。这个没必要更改。通过容器映射后，暴露在linux机80端口。

* envoy的admin功能监听，本机linux的，所有ip的，9901端口。

* 建立【/etc/envoy_ps1】目录，并把本项目的所有powershell脚本放进去。

*  **系统需求**  envoy-alpine:v1.14.4 ，不支持15及以上。15的关键字变了。

------

# 问：如何设定cds？

答： cds名，就是应用名。

```
add-cds.ps1 名

del-cds.ps1 名

delall-cds.ps1
```

------

# 问：如何设定后端ip，端口？

答：
```
add-eds.ps1 -cname cds名 -ip 1.2.3.4 -port 80

del-eds.ps1 -cname cds名 -ip 1.2.3.4
```

------

# 问：如何设定路由？

答：

```
add-rds.ps1 -cname cds名 -prefix '/url路径' -domains '域名1','域名2'

del-rds.ps1 -cname cds名 -prefix '/url路径' -domains '域名1','域名2'

delall-rds-and-new-rds.ps1 -cname cds名  # 这相当于添加了  -prefix '/' 和 -domains '*'
```

------

# 问：设定的顺序是？

答：

* 添加顺序：应该先添加cds应用名，然后添加eds后端，最后添加http路由。

```
ssh root@你的linux的ip pwsh -f /etc/envoy_ps1/add-cds.ps1 -cname 'abc1'
ssh root@你的linux的ip pwsh -f /etc/envoy_ps1/add-eds.ps1 -cname 'abc1' -ip 1.2.3.4 -port 80
ssh root@你的linux的ip pwsh -f /etc/envoy_ps1/delall-rds-and-new-rds.ps1 -cname 'abc1'
```

* 删除顺序：应该先删除http路由。后删除cds应用名。

* 后端：当cds存在时，可以任意增删后端。可以把后端删空，但不建议。当删除cds时，会删除cds所属的所有后端。


------

# 问：如何查看脚本结果，及配置文件的正确性？

答：

http://linux的ip:9901/clusters   #后端

http://linux的ip:9901/config_dump   #配置信息

------

# 问：如何测试envoy的url跳转结果？

答：

* 在linux机上，用curl测试，跳转后的结果。若通了，则下一步。若不同，则检查你的网络。

* 在linux机上，用curl测试，跳转前的结果。

比如 192.168.1.2:80 ------> www.baidu.com:80

线在linux上curl后面的端口（百度），然后curl前面的端口。

------