跳转至

安装

本章节介绍如何安装 F5network 组件

安装须知

AS3 是 F5 设备上的一个插件，其提供了 F5 设备远程网络可配置的接口，AS3 版本和 F5 设备的软件版本是有版本匹配要求的。

k8s bigip ctlr 是 K8S 集群上的 F5 控制面组件，该组件与 K8S 之间是有版本匹配要求的，且 k8s bigip ctlr 与 AS3 也有版本匹配要求。

因此，务必了解 F5 设备的软件版本和 K8S 集群的软件版本，才能正确掌握安装什么版本的 AS3 和 k8s-bigip-ctlr。

f5network version

获取最新的版本匹配关系，可参考 F5 官方文档的适配矩阵

F5 设备安装 AS3 服务

  1. 登录 F5 设备的管理 Web UI，点击导航栏的 Statics -> Dashboard，获取 F5 设备的版本号。

    f5 bigip version

  2. 根据安装需知中的版本匹配关系，下载匹配版本的 AS3 RPM 包到本地电脑 https://github.com/F5Networks/f5-appsvcs-extension/releases。

  3. 登录 F5 设备的管理 Web UI，进入 iApps -> Package Management Lx 界面，点击右上角的 import。

    f5 as3

  4. 在 import package 界面中，点击浏览，选择本地电脑上的 AS3，完成 upload。

  5. 完成安装后，可查看安装结果。

    f5 as3

F5 设备创建 partition

可在 F5 设备上创建一个独立的 partition，供 k8s bigip ctlr 组件对接存储转发规则。具体步骤如下：

  1. 登录 F5 设备的管理 Web UI，进入 System -> Users -> Partition List 界面，点击右上角的 create。

    f5 partition1

  2. 在创建界面中，填写 Partion Name 即可，其它按照默认值不需要修改，点击 Finished 完成创建。

    f5 partition2

集群安装 storage 存储组件（可选）

如果希望本组件安装在 4 层负载均衡模式下，要求安装 f5 ipam controller， 而 f5 ipam controller 要求集群具备 storage 组件提供 PVC 服务。可参考相关的存储组件安装手册。

如果希望本组件安装在 7 层负载均衡模式下，并不需要要求安装 f5 ipam controller，因此可忽略存储组件的安装。

集群安装组件步骤

  1. 拥有一个 DCE 集群，登录 global 集群的 Web UI 管理界面，在导航的容器管理 -> 集群列表中，登录希望安装本组件的集群。

  2. 在 Helm 应用 -> Helm 模板中，选择 system 仓库和网络组件，点击安装 f5network。

    f5network helm

  3. 在版本选择中选择希望安装的版本，点击安装。

  4. 在安装参数界面，填写如下信息。

    f5network install1

    在如上界面中，填写安装名称、命名空间、版本。

    f5network install2

    如上界面的参数说明:

    • f5-bigip-ctlr Settings -> Registry：设置 f5-bigip-ctlr 镜像的仓库地址，默认已经填写了可用的在线仓库，如果是私有化环境，可修改为私有仓库地址。

    • f5-bigip-ctlr Settings -> repository：设置 f5-bigip-ctlr 镜像名。

    • f5-bigip-ctlr version：设置 f5-bigip-ctlr 的镜像版本，默认值已经设置了最新的版本号。如果进行修改，注意安装需知中提到的版本适配问题。

    • Install ingressClass：是否安装 ingressClass。如果希望使用 7 层转发模式，务必开启本选项，如果希望使用 4 层转发模式，请关闭本选项。

    • IngressClass Name：设置 ingressClass 的名字。如果希望使用 7 层转发模式，务必设置本选项，如果希望使用 4 层转发模式，请忽略本选项。

    • Default ingressClass：是否设置安装的 ingressClass 作为集群的默认ingressClass。如果希望使用 7 层转发模式，务必开启本选项，如果希望使用 4 层转发模式，可忽略本选项。

    • BigIP Management Addr：F5 设备的 WEB UI 登录地址。

    • BigIP Partition：使用 F5 设备的上的 Partition 名字，即在 F5 设备创建 partition 步骤中创建的 Partition。

      若多个集群共用对接同一个 F5 设备，不同集群最好使用独立的 Partition。

    • Default Ingress IP：当本组件安装在 7 层负载均衡模式下，本值设置了 F5 上的 ingress 入口 VIP，注意该 IP 应该是 F5 external interface 子网的 IP 地址。 当本组件安装在 4 层负载均衡模式下，忽略本值。

      若多个集群共用对接同一个 F5 设备，不同集群要使用独立的 IP。

    • Only Watch F5 CRD：当打开本选项，本组件只会监控自己的 CRD，适用于工作在 4 层负载均衡模式；否则，会监控全部的 K8S 资源，适用于工作在 7 层负载均衡模式。

    • Node Label Selector：设置 node label selector，被选择的 node 会作为 nodePort 转发模式下的入口节点，如果不设置本值，F5 会把流量转发到集群所有节点的 nodePort 上。

    • Forward Method：设置 F5 转发流量的模式、nodePort 和 cluster 模式。模式解释，可参考介绍。

    f5network install2

    在如上界面中:

    • BigIP Username：F5 设备的登录账号。

    • BigIP Password：F5 设备的登录密码。

    • install f5-ipam-controller：是否安装 f5-ipam-controller 组件。当希望工作在 7 层负载均衡模式下，请关闭本开关，当本希望工作在 4 层负载均衡模式下，请打开本开关。

    • F5-ipam-controller Settings -> Registry：设置 f5-ipam-controller 镜像的仓库地址，默认已经填写了可用的在线仓库，如果是私有化环境，可修改为私有仓库地址。 当关闭了 install f5-ipam-controller，可忽略本选项。

    • F5-ipam-controller Settings -> repository：设置 f5-ipam-controller 镜像名。 当关闭了 install f5-ipam-controller，可忽略本选项。

    • F5-ipam-controller version：设置 F5-ipam-controller 的镜像版本，默认值已经设置了最新的版本号。 当关闭了 install f5-ipam-controller，可忽略本选项。

    • BIGIP L4 IP Pool：设置 F5 的 4 层负载均衡的 VIP 地址池，这些 IP 应该是 F5 external interface 子网的 IP 地址。 本值的格式类似是 { LabelName: 172.16.1.1-172.16.1.5}， 其中 LabelName 将会用于创建应用 service 时的 annotation 上。

      Note

      创建应用 service 时，只要给 service 打上了 annotation cis.f5.com/ipamLabel: LabelName，就会被本组件分配 VIP，最终生效到 F5 设备上。 当关闭了 install f5-ipam-controller，可忽略本选项。

      若多个集群共用对接同一个 F5 设备，不同集群要使用独立的 IP 池。

    • storageClassName：设置 storageClass Name，f5-ipam-controller 组件将用于常见 PVC 对象。 当关闭了 install f5-ipam-controller，可忽略本选项。

    • storageSize：设置存储池大小，f5-ipam-controller 组件将用于常见 PVC 对象。 当关闭了 install f5-ipam-controller，可忽略本选项。

cluster 转发模式下的配置（可选）

当组件安装为 cluster 转发模式时，需要在 F5 和 K8S 集群之间配置 VXLAN 隧道，或者配置 BGP 邻居。

K8S 的 CNI 组件往往可配置 BGP 及 F5 组件 BPG 邻居，实现网络打通。 例如在 Calico 场景下，具体可参考 F5 官方文档。

关于本组件的更多介绍，可参考 F5 官方文档。

评论