GitLab 教學

以下是針對 GitLab 的完整教學，會從基本概念到實際操作，包括如何在本地與 GitLab 倉庫同步、如何在 JetBrains IDE 中使用 GitLab。

🧠 GitLab 是什麼？

GitLab 是一個 Git 倉庫管理平台，像 GitHub 一樣可以用來：

• 存放原始碼
• 版本控制
• 管理多人協作（Merge Requests、Issue）
• 自動化部署（CI/CD）

🔰 GitLab 教學目錄

1. 註冊與建立專案
2. 安裝 Git 與初始設定
3. 將本地專案上傳到 GitLab
4. 基本 Git 指令操作
5. 使用 JetBrains IDE 整合 GitLab
6. 協作與 Merge Requests
7. CI/CD 基本介紹

✅ 1. 註冊與建立專案

1. 前往：https://gitlab.com/
2. 註冊帳號或用 Google 登入
3. 點選「New project」→
   • 選擇「Create blank project」
   • 輸入專案名稱與可見性（Private/Public）
   • 點「Create project」

✅ 2. 安裝 Git 與初始設定

➤ 安裝 Git（如果還沒安裝）

• Windows: 下載 Git
• macOS: 使用 Homebrew 安裝 brew install git

➤ 初次設定

git config --global user.name "你的名字"
git config --global user.email "你的Email"

✅ 3. 將本地專案上傳到 GitLab

方法一：已有本地資料夾（初始化 Git）

cd 專案資料夾
git init
git remote add origin https://gitlab.com/你的帳號/你的專案.git
git add .
git commit -m "Initial commit"
git push -u origin master  # 或 main

⚠️ 注意：GitLab 預設分支有可能是 main，確認後再推送。

✅ 4. 基本 Git 指令操作

✅ 5. 使用 JetBrains IDE 整合 GitLab

JetBrains IDE（如 IntelliJ、PyCharm）有很好的 GitLab 整合：

🔧 設定 Git 與 GitLab 連線

1. 開啟 JetBrains IDE
2. 前往 Settings → Version Control → Git
   • 設定 Git 路徑（例如：/usr/bin/git 或 C:\Program Files\Git\bin\git.exe）
3. 前往 Settings → Version Control → GitHub/GitLab
   • 加入 GitLab 帳號（可用 Personal Access Token 登入）

🔁 Git 操作（圖形化）

• VCS → Git → Commit：提交檔案
• VCS → Git → Push：推送到 GitLab
• VCS → Git → Pull：拉取遠端更新
• 也可以使用版本控制視窗來檢查 Diff、Resolve Conflict、建立分支等

✅ 6. 協作與 Merge Requests

當多人協作開發時，通常流程是：

1. 每個人從主分支拉分支開發（feature/login）
2. 開發完成後，推送到 GitLab 上自己的分支
3. 提出 Merge Request（合併請求）
4. 他人審查（Code Review）
5. 通過後合併到主分支

✅ 7. CI/CD 基本介紹

GitLab 支援自動化流程，透過 .gitlab-ci.yml 檔案配置。

範例 .gitlab-ci.yml：

stages:
  - build
  - test

build_job:
  stage: build
  script:
    - echo "Building..."

test_job:
  stage: test
  script:
    - echo "Running tests"

當你推送時 GitLab Runner 就會自動跑這些工作流程！

💡 補充工具

• GitKraken / Sourcetree：圖形化 Git 操作
• GitLens for VSCode：查看每行代碼的提交歷史
• GitLab Pages：可部署靜態網站