Fabric8使用说明

Fabric8 UI

本平台基于openshift搭建 
平台信息! 
URL： http://fabric8.fabric8.ipaas.seanzhau.com 
账号： admin 
密码： 12345678 
*打开以上URL时，首先会跳到openshift登录页面。

登陆平台 

界面说明 
Fabric8默认项目区域，如果需要多个Team，使用右上角的“Create Team”来创建。

• Current等同于fabric8下面的Runtime
• Production表示生产环境
• Staging表示预发布测试环境，用于发布正常的测试
• Testing表示自动化集成测试环境，自定义的脚本自动化测试

Other Namespaces区域，主要是openshift默认的namespace，主要是openshift平台用来做日志采集、监控和cicd等应用的namespace，与fabric8使用无关，严禁删除。 

进入“Runtime” 

快捷连接 
Gogs：代码管理系统，默认账号：gogsadmin:RedHat$1 
Grafana：图像监控系统，默认账号：admin:admin 
Jenkins：持续集成系统 
Kibana：日志系统 
Nexus：二进制包管理系统，默认账号：admin:admin123 
Prometheus：监控数据存储 

Jenkins 

gogs 

Nexus 

Overview 
主要是服务运行管理。 
Run：运行一个fabric8提供的快捷服务（运行在容器中）。 
Pods：pod数量伸缩管理，修改副本的数量。 

Run 

Pods 

Services 
每一个应用对应为一个service，主要是fabric8系统服务，service也可以看作为负载均衡。 

Deployments 
用于创建服务的yaml配置，点击Name可以查看配置详细内容，点击Scale可以修改副本的数量。 
 
配置内容 
 
Config快捷连接 

Replicas 
每修改一次Deployments，pod都会重新构建，因此会有多个历史版本。Replicas用于管理管理这些版本，Name后面的数字表示这个服务pod构建的次数。默认新版本启动以后，老版本会自动停止。对于不用的pod我们可以删除。 

Pods 
Pods就是具体的服务实例 
Name：服务名称 
Status：服务状态，可以查看Pod Terminal（显示器图标）和服务日志（文本图标） 
Events：是pod运行的日志，注意区分服务日志 
Restarts：重启次数 
Age：启动时长 
Images：运行这个pod使用的镜像以及版本 
Host：pod所在的宿主机 

Pod Terminal 

服务日志 

Config 
应用关联配置，也可以说应用使用外部其他服务的配置（目前还未深入了解，慎用！）。有变量配置和yaml配置2种方式。 
 
变量配置 
 
YAML配置 

Events 
pod事件 

Secrets 
各服务之间认证证书、密钥、账号密码等 

Nodes 
宿主机节点，可以看到fabric8在每个节点上运行的pod数量 

Diagram 
Pod、Node和服务端口关联拓扑 

Dashboard 
自建App在各环境发布情况，各Environment中pod数量。 

Apps 
自建应用列表，包含应用名称、仓库连接和版本信息等。 

Builds 
所有App构建历史，Pipeline快捷连接 

Environments 
环境配置，和Team界面对应 

Create Apps

Creat App 
在Dashboard和Apps界面都可以创建新的应用，点击右上角的“Creat App” 

选择应用仓库 
Setup Gogs Secret：配置gogs账号，即使有fabric8自带的代码仓库，我们选择fabric8自带的gogs仓库。 
Import from Git：使用外部代码仓库。 

Setup Gogs Secret 
第一次使用如果有账号就选择默认账号，如果没有账号则需要手动创建。点击下面的“Create New Secret” 

Create New Secret 
这个账号一定要与gogs里面的账号一致，不熟悉fabric8的情况下，别随意修改gogs默认的账号和密码，一些列的账号密码问题会很头疼。 
新建账号可以使用账号密码，也可以使用ssh key。 

重新进入创建应用界面，选择“Creat New App” 

Creat Project 
可以选择Quickstart也可以根据自己的需求来选择，Quickstart提供了一些自带的模板，自定义选择需要自己手动选择。 
Name：App名称 
Top level package：包com.abc… 
Version：版本信息 

Creat Project选择模板 

Creat Project自定义模板 

Pipeline 
根据需求选择一个pipeline，勾选Copy pipeline to project，点Next完成创建。完成创建以后默认会自动执行一次构建。 

App demo 
项目界面，使用快捷连接查看jenkins和gogs确认项目创建的情况。 

Jenkins项目界面 

Gogs项目界面 

Apps 
Java类应用默认会生成一个类似于demo-s2i的app，用于构建镜像。s2i指source to images。 

Dashboard 
Environments：项目发布的情况 
Active Pipelines：pipeline执行详情，构建完成以后点Proceed完成生产发布，点Abort取消发布。 
Commits：gogs中该项目提交的历史 

Proceed发布 

Proceed发布完成 

Pipelines历史 

Builds历史 

Settings 
Core：代码gogs连接，主要配置默认不用修改 
Secrets：配置gogs账号密码，不用修改 
Pipeline：选择pipeline模板，不用修改 

Source 
源码目录和gogs项目文件一致，fabric8项目和普通我们本地项目的差别在于以下3个文件：

• Jenkinsfile
• Fabric8.yml
• pom.xml

Fabric8.yml 
声明了这是一个fabric8项目，并且定义了fabric8对于该项目的使用哪一个jenkinsfile，以及定义项目的environments。

这个文件根据我们前面选择的pipeline模板自动生成。 

Jenkinsfile 
Jenkinsfile：是项目使用Jenkins pipeline的主要文件，里面定义了pipeline的主要流程，使用基础image名称和版本信息。 

pom.xml 
与本地项目对比，多定义了fabric8-maven-plugin、 maven-compiler-plugin、metric和log插件。

我们在实际的使用过程中，以我们现有app的pom.xml为母版，将我们刚刚创建的fabric8的pom.xml内容合并到现有的app中。 

fabric8-staging 
通过“Teams - fabric8 – Environments - fabric8-staging”进入，查看pod运行状况。（参考PPT Environments） 

fabric8-testing 
通过“Teams - fabric8 – Environments - fabric8-testing”进入，查看pod运行状况。（参考PPT Environments） 

fabric8-production 
通过“Teams - fabric8 – Environments - fabric8-production”进入，查看pod运行状况。（参考PPT Environments） 

遇到过的问题

• 无法解析gogs域名，这个主要是dnsmasq解析的问题
• 提示目录已存在，需要进入fabric8-forge所在的pod删除/tmp/fabric8-forge/user/gogsadmin/{app名称}
• 提示gogs仓库已经存在该项目，登录gogs删除项目
• 进入app dashboard加载慢，主要是因为fabric8-forge下的缓存目录加载慢，可能与磁盘的IOPS有关
• unable to resolve class io.fabric8.Utils，删除jenkins pod
• jenkins-workflow-library.git下载慢，把仓库迁移至本地gogs
• Pod重建重新下载maven数据，使用外部pvc存储数据
• 创建项目时选择pipeline一直在加载，需要进入fabric8-forge删除 /tmp/fabric8-forge/user/gogsadmin/{app名称}和/tmp/fabric8-forge/namespace/user-secrets-source-awadmin/gogs/fabric8/{app名称} 下的缓存文件，重新进入项目的secrets配置。

官方文档

• Fabric8 Spring：https://spring.fabric8.io/
• fabric8-maven-plugin：https://maven.fabric8.io/

版权所有，转载请注明出处：https://ipaas.com.cn/blog/post/seanzhau/aa95e6279f35。