kubernetes/CICD/Gitlab/README.md

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状态: 运行状态、重启次数
• 服务可用性: 访问延迟、错误率

升级策略

1. 镜像升级: 更新Deployment中的镜像版本
2. 滚动更新: 使用kubectl rollout实现零停机升级
3. 备份回滚: 升级前先备份，失败时快速回滚

# 滚动更新
kubectl set image deployment/gitlab gitlab=gitlab/gitlab-ce:17.0.0

# 回滚
kubectl rollout undo deployment/gitlab

版本信息

项目	版本
文档版本	v1.0
GitLab	latest
更新日期	2026-01-09