v2.1

v2.1
v2.0
v1.0
Express
  1. Release Notes
  1. 产品介绍
  1. 安装指南
    1. 安装说明
    1. 在 Linux 快速安装 KubeSphere
    1. 安装可插拔的功能组件
    1. 集群高可用配置安装
    1. 在 Kubernetes 安装 KubeSphere
    1. 相关工具与插件
    1. 认证与安全
    1. 运维指南
  1. 快速入门
  1. 管理员指南
    1. 多租户管理
    1. 平台管理
    1. 基础设施
    1. 监控中心
    1. 平台设置
    1. 工具箱
    1. 通用配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. 开发者指南
    1. Helm 应用开发
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2019 All Rights Reserved.

安装使用内置 GitLab

KubeSphere Installer 内置的 Gitlab (版本为 v11.8.1) 作为可选安装项,用户可以根据团队项目的需求来配置安装,方便用户对代码仓库的管理,KubeSphere 安装前或安装后都可以通过简单的配置单独开启 GitLab 的安装,具体可参考以下步骤安装和访问 GitLab。

注意,内置的 GitLab 不建议用在生产环境,仅建议用于开发测试环境方便快速搭建测试;关于如何搭建高可用的 GitLab 请参考 GitLab 官方文档

注意:目前 GitLab 安装暂不支持块存储,安装前需预先配置 Local Volume、NAS 或 GlusterFS 作为集群的存储服务端。

  • 测试环境可以直接使用默认 Local Volume 进行安装。
  • 若您在 QingCloud 云平台部署请参考 QingCloud vNAS
  • 若您自行部署的 NFS 或 GlusterFS 服务端,在 conf/common.yaml 的配置请参考 存储配置说明 - GlusterFS 或 NFS

安装前开启 GitLab 组件安装

第一步:修改配置文件

1、安装 KubeSphere 前,在 Installer 中的 conf/common.yaml 文件中,参考如下配置修改。

# GitLab deployment
gitlab_enable: true
gitlab_hosts_domain: devops.kubesphere.local

2、修改后保存,然后执行安装脚本,即可通过 Helm Chart 的方式来安装 GitLab。

第二步:配置 GitLab 访问

2、KubeSphere 和 GitLab 都安装完成后,若需要在集群外部访问 GitLab,请在本地的 /etc/hosts 文件中参考如下示例添加一行记录,然后即可在浏览器访问 GitLab。

# {$IP} {$GitLab 域名}
139.198.10.10 gitlab.devops.kubesphere.local

注意:在外网访问 GitLab,需要绑定公网 IP 并配置端口转发,若公网 IP 有防火墙,请在防火墙添加规则放行 GitLab 的端口 30080 (HTTP) 保证外网流量可以通过该端口,外部才能够访问。例如在 QingCloud 云平台进行上述操作,则可以参考 云平台配置端口转发和防火墙

提示:若需要在外网使用 GitLab, HTTPS 端口 30443 和 SSH 端口 (输入 kubectl get svc -n kubesphere-devops-system | grep 22: 查看) 也需要保证外网流量可以通过这些端口。

3、在浏览器中可以通过 {$域名}:{$NodePort}http://gitlab.devops.kubesphere.local:30080 访问 GitLab 登录页面。默认的 GitLab 用户名和密码为 admin / P@88w0rd

gitlab

安装后开启 GitLab 组件安装

通过修改 ks-installer 的 configmap 可以选装组件,执行以下命令。

$ kubectl edit cm -n kubesphere-system ks-installer

参考如下修改 ConfigMap

    gitlab:
      enabled: True
      domain: devops.kubesphere.local

保存退出,参考 验证可插拔功能组件的安装 ,通过查询 ks-installer 日志或 Pod 状态验证功能组件是否安装成功。

使用 GitLab 示例

本示例以 devops-java-sample 为例展示如何从 GitHub 导入项目至 GitLab。

​1、请先将 GitHub 仓库 devops-java-sample Fork 至您个人的 GitHub 仓库。

)

​2、使用 Kubesphere 默认的用户名和密码 admin / P@88w0rd 登陆 GitLab 后,选择 Create a project

create

​3、选择 「Import project from GitHub」。

import

​4、按照提示加入个人 Token,Personal access token 可在 GitHub Setting 页面生成。然后可选择 GitHub repositories。

token

​5、选择 devops-java-sample 项目 Import 至 GitLab。

​6、等待 Status 显示为 Done,即导入成功。

done

7、回到 Project 主页面,即可看到项目导入成功。

succ

提示:关于 GitLab 的使用详见 GitLab 文档