极狐GitLab 对于 Kubernetes 集群的连接和管理是通过 agent 来实现的。也就是说在每个集群上安装一个 agent,然后 agent 和极狐GitLab 实例进行通信来完成极狐GitLab 和 Kubernetes 集群的连接。所以,安装 agent 是首要工作。
极狐GitLab 是 GitLab 的中国发行版,可以一键进行私有化部署,详情可以查看官网指南:https://dl.gitlab.cn/ljjeo772 。
安装前提
- 必须要有一个可用的 Kubernetes 集群。
本文以 azure 上创建的一个 kubernetes 集群为例来演示:
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
aks-agentpool-22596152-vmss000000 Ready <none> 3d7h v1.29.7
aks-agentpool-22596152-vmss000001 Ready <none> 3d7h v1.29.7
aks-userpool-22596152-vmss000000 Ready <none> 3d7h v1.29.7
aks-userpool-22596152-vmss000001 Ready <none> 3d7h v1.29.7
安装 agent
在 Kubernetes 集群上安装好一个 agent,大体需要三步:
- 创建 agent 配置文件
- 在极狐GitLab 上注册 agent
- 在 Kubernetes 集群上安装 agent
创建 agent 配置文件
agent 一般安装在某个仓库下,因此其配置文件也在某个仓库下,配置文件的名称为 config.yaml,路径如下:
.gitlab/agents/<agent-name>/config.yaml
注意:需要自定义一个 agent 名称,将上面的 <agent-name>
替换成自定义的 agent 名称。比如使用 jh-gitlab。config.yaml文件可以先为空,后面再补充内容。
在极狐GitLab 上注册 agent
首先找到想要注册 agent 的项目,然后选择运维 --> Kubernetes 集群:
点击连接集群,选择一个代理:
然后会出现一个界面,显示 agent 安装的命令:
在命令行中输入以下命令进行 agent 的安装:
$ helm upgrade --install jh-gitlab gitlab/gitlab-agent \
> --namespace gitlab-agent-jh-gitlab \
> --create-namespace \
> --set image.tag=v17.3.0 \
> --set config.token=glagent-McS_oNKq49REYvo_HxTxqe2ozZ3RDzZPzmQU9k2HqQ6LBng8Rg \
> --set config.kasAddress=wss://kas.jihulab.com
Release "jh-gitlab" does not exist. Installing it now.
NAME: jh-gitlab
LAST DEPLOYED: Wed Aug 21 09:47:27 2024
NAMESPACE: gitlab-agent-jh-gitlab
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Thank you for installing gitlab-agent.
Your release is named jh-gitlab.
## Changelog
### 1.17.0
- The default replica count has been increased from `1` to `2` to allow a zero-downtime upgrade experience.
You may use `--set replicas=1` to restore the old default behavior.
然后可以在极狐GitLab 项目 --> 运维 --> Kubernetes 集群中进行查看:
这时候说明极狐GitLab 实例和该 Kubernetes agent 建立了连接。
添加 Kubernetes cluster Dashboard
在极狐GitLab 项目 --> 运维 --> 环境下面,添加环境:
填写好环境名称、选择极狐GitLab 代理,如果只看特定命名空间(namespace)的信息,可以选择特定的命名空间,如果不选择,则会展示所有命名空间下的信息:
可以通过 pod右侧的 Views logs按钮对于 pod的日志进行查看
点击 pod最右侧的三个点,还可以直接删除 pod。
这样操作人员就可以直接在极狐GitLab 上对于 Kubernetes 集群进行操作了,而不需要离开极狐GitLab 在命令行终端中进行操作。
本文由博客一文多发平台 OpenWrite 发布!
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。