Git

Introduction

Git is a distributed version control system developed by Linus Torvalds for managing the source code of the Linux kernel. Git is designed for speed, data integrity, support for non-linear development (multiple branches), and strong branch management, making it widely used in software development. To effectively use Git, it is important to not only be familiar with its basic operations but also to master its workflow for better collaborative development. This article introduces some Git software development guidelines to help teams improve collaboration efficiency.

Due to the complexity of team development, using Git can become more challenging. To enhance team collaboration efficiency, we need to establish a set of Git software development guidelines to standardize team members’ operations and ensure the stability and maintainability of the codebase. Adhering to certain principles can accelerate the development process, reduce errors, and improve code quality.

Git Software Development Workflow

Below is a simple Git software development workflow diagram, illustrating how team members collaborate in development:

The above workflow may not be suitable for all teams, but it can serve as a reference and be adjusted according to actual situations. Next, we will introduce some Git software development guidelines to help teams improve collaboration efficiency.

前言

Git 是一個分散式版本控制系統，由 Linus Torvalds 開發，用於管理 Linux 核心的原始碼。Git 的設計目標是速度、資料完整性、支援非線性開發（多分支）、強大的分支管理等，因此廣泛地應用於軟體開發領域。而要有效地使用 Git，除了熟悉 Git 的基本操作外，更重要的是要掌握 Git 的工作流程，這樣才能更好地協作開發。本文將介紹一些 Git 軟體開發指南，幫助團隊提高協作效率。

由於團隊開發的複雜性，Git 的使用也變得更加困難。為了提高團隊協作的效率，我們需要制定一套 Git 軟體開發指南，以規範團隊成員的操作行為，確保代碼庫的穩定性和可維護性。遵守一定的原則，可以加速開發進程，減少錯誤，提高代碼品質。

Git 軟體開發流程圖

以下是一個簡單的 Git 軟體開發流程圖，用於說明團隊成員之間如何協作開發：

上述流程不一定適用於所有團隊，但可作為參考，並根據實際情況進行調整。接下來，我們將介紹一些 Git 軟體開發指南，幫助團隊提高協作效率。

大家可以看到上面這張圖的第一筆 commit 是有加上綠色框框的 Verified 標籤，這是因為我有設定 Git Commit Signature Verification，這樣的好處是可以確保每次的 commit 都是由我本人所做的，而不是其他人偽造的。這邊我們來看看如何設定 Git Commit Signature Verification。

新課程上架:『Docker 容器實用實戰』目前特價 $800 TWD，優惠代碼『20200222』，也可以直接匯款（價格再減 100），如果想搭配另外兩門課程合購可以透過 FB 聯絡我

Gitea 在本週發佈了 1.11.0 版本，本篇就使用 Docker 方式來安裝 Gitea，執行時間不會超過五分鐘。Gitea 是一套開源的 Git Hosting，除了 Gitea 之外，您可以選擇 GitHub 或自行安裝 GitLab，但是我為什麼選擇 Gitea 呢？原因有底下幾點

1. Gitea 是開源專案，全世界的開發者都可以進行貢獻
2. Gitea 是 Go 語言所開發，啟動速度超快
3. Gitea 開源社區非常完整，每年固定挑選三位為主要負責人
4. Gitea 可以使用執行檔或 Docker 方式進行安裝

Gitea 目前發展方向就是自己服務自己，大家可能有發現原本在 GitHub 上面的 Repository 已經全面轉到 Gitea 自主服務了，這也代表著未來會全面轉過去，只是時間上的問題。Gitea 目前的功能其實相當完整，大家有興趣可以看這張比較表，新創團隊我都強烈建議使用 Gitea。

大家在寫開源專案時，一定需要一個免費的雲空間來放置網站，方便其他開發者在 GitHub 看到時，可以先點選 Demo 網站來試用，也許開發者可以使用 GitHub 提供的免費靜態網站，但是如果是跑 Golang 或是其他語言 Node.js 就不支援了，本篇來介紹 Heroku 雲平台，它提供了開發者免費的方案，您可以將 GitHub 儲存庫跟 Heroku 結合，快速的將程式碼部署上去，Heroku 會給開發者一個固定的 URL (含有 HTTPS 憑證)，也可以動態的用自己買的網域。最重要的是 Heroku 提供了兩種更新方式，第一為 Git，只要開發者將程式碼 Push 到 Heroku 儲存庫，Heroku 就可以自動判斷開發者上傳的語言，並進行相對應的部署，另一種方式為 Docker 部署，只要在儲存庫內放上 Dockerfile，透過 Heroku CLI 指令就可以將 Docker 容器上傳到 Heroku Docker Registry，並且自動部署網站。底下我們來透過簡單的 Go 語言專案: Facebook Account Kit 來說明如何快速部署到 Heroku。

2022.03.26 Updated: 現在主流分支名稱為 main

在 Facebook 上面看到這篇『git flow 實戰經驗談』，想說來寫一下對於團隊內該導入 GitHub Flow 還是 Git Flow，寫下自己的想法給大家參考看看。當你加入團隊，第一件事情就是嘗試了解目前團隊是走哪一種 Git 流程，但是在團隊內可能使用 GitHub 流程或者是傳統 Git 流程，在開始進入開發流程時，請務必先了解團隊整個 Release 流程。後者流程在筆者幾年前有發表一篇『branch model 分支模組基本介紹』，如果大家有興趣可以先看看，而我自己在團隊內使用這兩種流程，嘗試過幾個團隊，得到底下結論:

• 公司內部請使用 GitHub 流程
• 開源專案請使用 GitHub 流程 + Git 流程

底下來探討為什麼我會有這些想法。首先先來看看公司團隊內部如果是走 Git 流程會有哪些缺陷。

今年很高興可以到 COSCUP 分享『Gitea + Drone 介紹』，我是在第二天的最後一場來做分享，最後還被大會進來趕人，講超過時間了。這次是我第一次到台大社科院，太陽真的好大，兩天下來流的汗水，大概已經是一年份的了。由於今年 COSCUP 不供應午餐，在第一天中午到科技站出口，左轉第一個店面就坐下來吃麵，店面不大，賣傳統小吃，我點了麻醬麵大碗 55 元，燙青菜 35 元，真的很大碗，不知道是不是因為在學校附近的關係，所以特別大碗，我心裡想說，這裡不是台北嗎？

現在 Git 服務最有名的就是 Github，如果是開放原始碼，我很推薦 Github。如果是想要放大量私有專案或企業內及個人使用，想必大家會推薦 Gitlab，在這裡就不多介紹 Gitlab 了，可以從 Google 找到許多相關資料，本篇會介紹另類的 Git 自架服務選擇 Gitea，在介紹之前可以先參考我在 2014 年寫了一篇用 Go 語言開發的 Git 服務叫做 Gogs。

目前團隊是使用 Atlassian Bitbucket 搭配 Bamboo，雖然 Bamboo 搭配自家的 Bitbucket (前身是 Stash Server) 整合得相當不錯，但是個人覺得設定上蠻複雜的，所以才想測試看看其他家 CI Service 對團隊學習及設定上更容易。最近找到一套用 Golang 寫的 CI Server 就是 Drone，Drone 線上文件提供了 Github, Gitlab, Gogs, Bitbucket (Stash) 等整合。在整合 Drone 搭配 Bitbucket 時，文件寫得不是很清楚，尤其是在 Bitbucket 建立 Application Link 遇到許多問題，官方文件也沒寫得很清楚，故寫此篇記錄如何將 Drone 服務整合 Bitbucket 伺服器。

今年第一次參加 iThome 舉辦的 DevOps Summit 研討會，這次舉辦在台北文創大樓，就是在大巨蛋隔壁，很高興今年第一次投稿就錄取，題目是『用 Dokcer 改善團隊合作模式』，主題偏向如何用 Docker 改善個人或團隊的開發狀況，尤其是在 IC 或系統廠如何導入 Docker。研討會上沒有提到很深入的 Docker 應用，在投影片內強調的是，如何將 Git 及 Docker 帶入團隊內不同角色，包含 QA 及 PM，讓大家在團隊合作上能夠各自獨立，不會互相影響。底下就是我今年的投影片: