极狐 Gitlab WorkSpaces - 01

1. Gitlab WorkSpaces 是什么

workspaces 官方文档

A workspace is a virtual sandbox environment for your code in GitLab. You can use workspaces to create and manage isolated development environments for your GitLab projects. These environments ensure that different projects don’t interfere with each other.

Each workspace includes its own set of dependencies, libraries, and tools, which you can customize to meet the specific needs of each project. Workspaces use the AMD64 architecture.

• Gitlab WorkSpaces是GitLab中用于托管代码的虚拟沙盒环境。
• 您可以使用工作区创建和管理GitLab项目的隔离开发环境。项目之间项目隔离
• 每个工作区包括自己的一组依赖项、库和工具，您可以根据每个项目的特定需求进行定制（容器环境）。
• WorkSpace使用AMD64体系结构。
  
  

2. Gitlab WorkSpaces 前提条件

• Premium 订阅
• Gitlab SaaS 与自管理 都可以使用 WorkSpaces 功能
• 自管理Gitlab 的版本 >= 16.4 推荐16.6.2
  
  

3. 准备工作Gitlab

• 完成 Gitlab 部署，Gitlab的版本 >= 16.4 推荐16.6.2。
• 导入Premium 或者 Ultimate license。
• 配置域名、证书和DNS解析。测试环境使用域名 gitlab.rzhu.tech，并在阿里云申请了免费证书。
• 创建或选择一个顶层Group，后续使用 WorkSpace 的项目需要位于该Group 下。
• 在顶层Group 中拥有至少 Developer role 权限。
  
  

kubernetes 环境

• 部署kubernetes 集群，集群版本参考文档 supported-kubernetes-versions-for-gitlab-features，目前推荐的kubernetes 集群版本为 1.25 - 1.27。
• kubernetes 集群部署 ingress。
• kubernetes 集群部署 storageClass，并设置成default。
• 安装helm v3.11.0 及以上版本
  
  

其他准备工作

• 准备两个域名分别为 workspaces.<base_domain> 和 *.workspaces.<base_domain>，在本次测试环境中为 workspaces.rzhu.tech 和 *.workspaces.rzhu.tech。
• 添加这两个域名解析到 kubernetes 集群 ingress 地址。
  
  

4. Gitlab 连接kubernetes

agent install 官方文档

Step1：创建kubernetes Agent onfiguration 项目

• 进入准备工作中选择的或创建的顶层Group。
• 创建一个blank Project
• 在项目中 创建 .gitlab/agents/<agent-name>/config.yaml 文件。
• 文件保持空白 并在后续进行修改和配置。
  
  

Step2：在kubernetes 集群中部署Agent

注册Gitlab Agent，请执行以下操作：

• 在左侧边栏中，选择搜索或前往并找到您的项目。  
• 选择 Operate > Kubernetes clusters。  
• 选择 Connect a cluster (agent)。  
• 从列表中选择 agent 配置文件。
• 选择 Register an agent。
  GitLab 为代理生成一个访问令牌。您需要这个令牌来在集群中安装代理。
• 复制Recommended installation method下的命令。使用命令进行一键安装。