Clibeanna a bhreachann pointe sonracha sa stair mar thábhachtach — go hiondúil leagtha amach (leaganacha ar nós v1.0.0). Murab ionann is brainsí, bíonn clibeanna geal ag foluain nach n-aistrím, úsáidte chun leaganacha eisithe a lipéadú agus a thagairt. Tá siad lárnach do leagantacht agus bainistíocht eisithe.
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m
git tag v1.0.0
git tag -a v1.0.0 <commit> -m
Clibeanna anótáilte (moladh do leagtha amach) stóraláit teanga-dhata (an taifeadóir, an dáta, an teachtaireacht); clibeanna éadrom ní amháin ainm atá ag pointeáil ar bhreachaoithe.
git tag # list tags
git show v1.0.0 # show a tag and its commit
git checkout v1.0.0 # check out the code at a tag (detached HEAD)
# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0 # push a specific tag
git push origin --tags # push all tags
Tábhachtach: ní dhéantar clibeanna a bhrú go huathoibríoch le git push — déanann tú iad a bhrú go soiléir.
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
(with release notes, built artifacts) for distribution.
Tá sé luachmhar chun tuiscint a fháil ar chlibeanna agus leagtha amach do leagantacht agus bainistíocht eisithe, agus dá bhrí sin tá sé ina bhraistint phraiticiúil úsáideach do obair le bogearraí eisithe. Clibeanna a bhreachann pointe tábhachtacha sa stair — go hiondúil leaganacha eisithe (ar nós v1.0.0) — ag soláthair tagartha geal, buan do bhreachaoithe sonracha, atá riachtanach do rianú agus do thagairt ar an gcód a bhíonn ina chuid de gach eisitheoireacht.
Tá práiticiúil tuiscint ar an idirdhealú idir clibeanna anótáilte (moladh do leagtha amach, ag stóráil teanga-dhata ar nós an taifeadóra, an dáta, agus an teachtaireacht) agus clibeanna éadrom go bhfuil sé de bhraistint phraiticiúil ceart do lipéadú eisithe.
Tá gá go mbeadh a fhios agat conas clibeanna a chruthú, a liostú, agus a sheiceáil amach, agus go háirithe go bhfuil clibeanna nach ndéantar iad a bhrú go huathoibríoch (ag éileamh git push origin --tags soiléir nó clibeanna sonracha a bhrú — gotcha coiteann áit ar fhág daoine clibeanna cruthaithe ach dearmad ar a bhrú iad), riachtanach do bhainistíocht cheart chlibeanna eisithe.
Ta tuiscint ar chlibeanna vs brainsí (is geal foluain socrúchta ar bhreachaoithe sonracha — lipéad buan nach n-aistrím — is geal foluain brainsí a oibríonn le forbairt) a léiríonn a ról éagsúil: clibeanna do lipéadú go buan eisithe/mhílestones, brainsí do obair leanúnach.
Ta tuiscint ar an nasc le leagantacht dhigiteach (coinbhinsiúin MAJOR.MINOR.PATCH do bhreacadh ar nádúr athruithe) agus ar an gcaoi ar thógann ardáin Leagtha Amach ó chlibeanna (le nótaí eisithe agus artefachtaí d'fheidhmiú) ag léiríonn conas a bhíonn clibeanna i gcéill i mbainistíocht eisithe dhomhain.
Ó bhí sé ina riachtanas coiteann bogearraí a eisiúint agus a chóimeáil ar leagan, agus clibeanna an meicníocht Git do bhreachaoithe do lipéadú agus do thagairt ar leaganacha eisithe (lárnach do bhainistíocht eisithe agus comhtháite le feidhmeanna eisithe na n-ardán), tá sé ina bhraistint phraiticiúil, a bhaineann le Git ceart-úsáideach do bhainistíocht ar bhogearraí eisithe — ábhar úsáideach in forbairt ghairmiúil a bhaineann le coinbhinsiúin leagantachta agus próisis eisithe.