GitLab Kubernetes部署文档
本目录包含GitLab在Kubernetes集群上的部署配置和文档。
部署配置
gitlab-deployment.yaml
apiVersion: v1
kind: PersistentVolume
metadata:
name: gitlab-pv
spec:
capacity:
storage: 50Gi
accessModes:
- ReadWriteOnce
hostPath:
path: /data/gitlab
storageClassName: manual
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: gitlab-pvc
namespace: default
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 50Gi
storageClassName: manual
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: gitlab
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: gitlab
template:
metadata:
labels:
app: gitlab
spec:
containers:
- name: gitlab
image: gitlab/gitlab-ce:latest
ports:
- containerPort: 80
name: http
- containerPort: 443
name: https
- containerPort: 22
name: ssh
env:
- name: GITLAB_OMNIBUS_CONFIG
value: |
external_url 'http://<节点IP>:30180'
gitlab_rails['gitlab_shell_ssh_port'] = 30122
nginx['listen_port'] = 80
nginx['listen_https'] = false
volumeMounts:
- name: gitlab-data
mountPath: /var/opt/gitlab
resources:
requests:
memory: "2Gi"
cpu: "1000m"
limits:
memory: "4Gi"
cpu: "2000m"
volumes:
- name: gitlab-data
persistentVolumeClaim:
claimName: gitlab-pvc
---
apiVersion: v1
kind: Service
metadata:
name: gitlab
namespace: default
spec:
type: NodePort
ports:
- port: 80
targetPort: 80
nodePort: 30180
name: http
- port: 443
targetPort: 443
nodePort: 30443
name: https
- port: 22
targetPort: 22
nodePort: 30122
name: ssh
selector:
app: gitlab
注意：在部署前，请将配置中的
<节点IP>替换为实际的节点IP地址。
部署步骤
1. 创建数据目录
mkdir -p /data/gitlab
2. 修改配置文件
将上述YAML配置保存为 gitlab-deployment.yaml 文件，并将 <节点IP> 替换为实际的节点IP地址。
3. 应用部署配置
kubectl apply -f gitlab-deployment.yaml
4. 验证部署状态
# 查看Pod状态
kubectl get pods -l app=gitlab
# 查看Service状态
kubectl get svc gitlab
# 查看详细信息
kubectl describe pod <gitlab-pod-name>
访问地址
| 服务 | 端口 | 说明 |
|---|---|---|
| Web界面 | 30180 | GitLab Web管理界面（http://节点IP:30180） |
| HTTPS | 30443 | 安全HTTPS访问 |
| SSH | 30122 | Git代码推送 |
获取GitLab初始密码
kubectl exec -it $(kubectl get pod -l app=gitlab -o jsonpath='{.items[0].metadata.name}') -- grep 'Password:' /etc/gitlab/initial_root_password
首次登录后，默认用户名为 root，使用上述获取的密码登录。
配置参数
| 参数 | 值 | 说明 |
|---|---|---|
| 镜像 | gitlab/gitlab-ce:latest | GitLab社区版最新版本 |
| 数据目录 | /data/gitlab | HostPath存储路径 |
| 存储容量 | 50Gi | PV/PVC分配存储 |
| 内存请求 | 2Gi | 最小内存需求 |
| 内存限制 | 4Gi | 最大内存限制 |
| CPU请求 | 1000m | 最小CPU需求 |
| CPU限制 | 2000m | 最大CPU限制 |
端口映射
| 容器端口 | NodePort | 用途 |
|---|---|---|
| 80 | 30180 | HTTP Web访问 |
| 443 | 30443 | HTTPS Web访问 |
| 22 | 30122 | SSH Git访问 |
常用管理命令
查看Pod状态
kubectl get pods -l app=gitlab
kubectl logs -f <gitlab-pod-name>
重启服务
kubectl rollout restart deployment gitlab
扩容/缩容
# 扩容到2个副本
kubectl scale deployment gitlab --replicas=2
# 缩容到1个副本
kubectl scale deployment gitlab --replicas=1
查看资源使用
kubectl top pods -l app=gitlab
备份数据
kubectl exec -it $(kubectl get pod -l app=gitlab -o jsonpath='{.items[0].metadata.name}') -- gitlab-backup create
故障排查
Pod无法启动
ImagePullBackOff
# 查看Pod详细信息
kubectl describe pod <gitlab-pod-name>
# 手动拉取镜像
docker pull gitlab/gitlab-ce:latest
# 检查Docker镜像加速配置
cat /etc/docker/daemon.json
ContainerCreating状态持续
# 检查PV/PVC状态
kubectl get pv
kubectl get pvc
# 检查存储目录权限
ls -la /data/gitlab
# 调整目录权限
chmod -R 777 /data/gitlab
服务无法访问
# 检查Service状态
kubectl get svc gitlab
# 检查端口占用
netstat -tlnp | grep 30180
# 检查防火墙
iptables -L -n | grep 30180
性能问题
# 检查资源使用
kubectl top pods -l app=gitlab
# 检查Pod日志
kubectl logs <gitlab-pod-name>
# 调整资源限制
kubectl edit deployment gitlab
维护建议
定期备份
建议配置定期备份策略，在Pod中配置cron任务或使用GitLab内置备份功能。
监控告警
建议配置以下监控指标：
- 资源使用率: CPU、内存、磁盘
- Pod状态: 运行状态、重启次数
- 服务可用性: 访问延迟、错误率
升级策略
- 镜像升级: 更新Deployment中的镜像版本
- 滚动更新: 使用kubectl rollout实现零停机升级
- 备份回滚: 升级前先备份，失败时快速回滚
# 滚动更新
kubectl set image deployment/gitlab gitlab=gitlab/gitlab-ce:17.0.0
# 回滚
kubectl rollout undo deployment/gitlab
版本信息
| 项目 | 版本 |
|---|---|
| 文档版本 | v1.0 |
| GitLab | latest |
| 更新日期 | 2026-01-09 |