Hatékonyabb kódolás a Bitbuckettel: A 4 kezdőlépés


Vágjunk is bele!

1. lépés: Kód bevitele a Bitbucketbe

A Bitbucketben a kódok adattárakban laknak (a szakemberek gyakran egyszerűen „repóknak” hívják őket). Több módon is nekikezdhetsz, attól függően, hogy mire van szükséged:

Új üres adattár létrehozása

  1. Kattints a + gombra a bal oldalon található globális oldalsávon, és a Létrehozás menüben válaszd ki az Adattár lehetőséget.
  2. Adj nevet az adattárnak. Ez fontos! Az adattár neve az URL része lesz.
  3. A „Hozzáadsz egy README-fájlt?” lehetőségnél válaszd az Igen, sablonnal beállítást.
  4. A többinél hagyd meg az alapértelmezett értéket, majd kattints a Létrehozás gombra.
Új adattár létrehozása

Adattár importálása egy másik Git-szolgáltatótól

  1. Kattints a + gombra a bal oldalon található globális oldalsávon, és az Importálás menüben válaszd ki az Adattár lehetőséget.
  2. Add meg az URL-címet, ahol elérhető az adattár.

  3. Ha az adattárhoz hozzáférésre van szükség, jelöld be a Hozzáférés szükséges jelölőnégyzetet, és add meg a hozzáféréshez szükséges hitelesítő adatokat.

  4. Adj nevet az adattárnak. Ez fontos! Az adattár neve az URL része lesz.

  5. A többinél hagyd meg az alapértelmezett értéket, majd kattints az Adattár importálása gombra.

Új adattár létrehozása

2. lépés: Helyi beállítás, globális együttműködés

Klónozz egy Bitbucket-adattárat!

  1. Kattints a + gombra a bal oldalon található globális oldalsávon, és a Lássunk munkához menüben válaszd ki az Adattár klónozása lehetőséget.
  2. Válaszd ki a jobb felső sarokban található menüből a HTTPS lehetőséget (kivéve, ha már beállítottad az SSH-kulcsaidat).
  3. Másold a klónozási parancsot.
Adattár klónozása

A CLI-ből

  1. Válts arra a könyvtárra, ahova klónozni szeretnéd az adattáradat.cd
  1. Illeszd be a Bitbucketből kimásolt parancsot (valahogy így néz ki): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

A helyi meghajtódon megjelenik egy új alkönyvtár, amelynek ugyanaz a neve, mint a klónozott adattárnak. Ha üres adattárat klónoztál, akkor előfordulhat, hogy még nincs semmi a helyi könyvtárban.

Módosíts egy fájlt online a Bitbucketben!

Várj, nincsenek fájljaim a Bitbucketben...

Kihagytad az opcionális lépést, amelyben README-fájlt adtunk a Bitbucket-adattárhoz? Semmi gond! Ha az adattárad továbbra is üres, menj az adattárba, és hozz létre egyet a README létrehozása gombra kattintva. Most már nem egy üres adattárat fogsz klónozni.

Húzd be a frissítéseket a Bitbucketből!

A CLI-ből

  1. Válts arra a könyvtárra, ahova klónozni szeretnéd az adattáradat.cd
  1. Illeszd be a Bitbucketből másolt parancsot (valahogy így néz ki): git clone

Ezzel letöltöttél minden olyan változtatást a helyi rendszerre, amelyet végrehajtottak a fájlokon.

3. lépés: A leágazások alapjai a Bitbucketen

A leágazások lehetővé teszik, hogy az egyes csapattagok párhuzamosan dolgozzanak különböző feladatokon, anélkül, hogy ez befolyásolná az eredeti kódbázist vagy a többiek munkáját. Ha készen állsz a változtatások összefésülésére, akkor küldd be a leágazásodat a Bitbucketbe, ahol mások egy pull-kérelemmel áttekinthetik a munkádat.

Leágazást többféle módon is létrehozhatsz; válaszd azt, amelyik a legmegfelelőbb a csapatodnak.

Hozz létre egy leágazást!

  1. Az adattárból kattints a globális oldalsáv + gombjára, és a Lássunk munkához menüből válaszd ki a Leágazás létrehozása lehetőséget.
  2. A megjelenő felugró menüben válassz egy lehetőséget a Típus beállításnál (ha a Leágazási modell megoldást használod). Töltsd ki a Leágazás neve mezőt, majd kattints a Létrehozás gombra.
Leágazás létrehozása

A CLI-ből

  1. Ha ez megvan, hívd le és töltsd be a leágazásokat a helyi rendszerről. A Bitbucket automatikusan megmutatja a szükséges parancsot, amely valahogy így néz ki: git fetch && git checkout
  2. Hajtsd végre helyileg a változtatásaidat, majd add hozzá, véglegesítsd és küldd be a változtatásaidat a leágazásba:git add . git commit -m "változtatás hozzáadása a funkcióleágazásból" git push origin
  3. Kattints az adattár Forrás oldalára. Itt egyszerre láthatod a fő vonalat és a leágazást egy legördülő menüben
Leágazások szűrése

A helyi adattárkönyvtárban található CLI-ből

  1. Hozz létre egy leágazást a Git leágazás paranccsal. git branch
  2. Listázd az adattár leágazásait. Itt látod az alapértelmezett leágazás fő vonalát, valamint az újonnan létrehozott leágazást. git-leágazás
  3. Töltsd be a leágazást.git checkout

  4. Küldd be az új leágazást a Bitbucketbe. git push --set-upstream origin

Most lépjünk a Bitbucketbe, és nézzük meg a leágazásunkat.

  1. Lépj be az adattáradba.

  2. Kattints a Leágazások lehetőségre.

Leágazások szűrése

Ehhez hozzáférésre van szükséged a Jira Software Cloudhoz, amelyet integrálnod kell a Bitbuckettel. Ehhez adminisztrátori jogosultságokra van szükséged, de ha csak szeretnéd kipróbálni az integrációt, és megnézni, hogy működik, akkor regisztrálj a Jira Software Cloud ingyenes próbaverziójára.

Olvasd el a Bitbucket Cloud csatlakoztatása a Jira Software Cloudhoz című cikket, ha a Jira-webhelyed beállítása után szeretnéd megnézni, hogyan integrálhatod a két terméket.

4. lépés: A kódváltoztatások ellenőrzése pull-kérelemmel

Amint beküldted a kód változtatásait a Bitbucketbe, eljött az idő, hogy egy munkatárssal ellenőriztesd a módosításokat. A pull-kérelem egyszerű és hatékony módja a kódjaid ellenőriztetésének, valamint a csapatod együttműködésének egy megosztott környezetben.

Pull-kérelem létrehozása

  1. A nyitott adattárból kattints a globális oldalsáv + gombjára, és válaszd ki a Pull-kérelem létrehozása lehetőséget a Lássunk munkához menüből.
  2. Töltsd ki a pull-kérelem űrlapjának többi mezőjét:
Pull-kérelem létrehozása
  1. Forrás: Az adattár és a leágazás, amelyen kódváltoztatásokat hajtottál végre, és amelyet egyesíteni szeretnél.
  2. Cél: Az adattár és a leágazás, ahová egyesíteni szeretnéd a változtatásaidat.
  3. Cím és leírás: Mindkettő megjelenik az e-mail-értesítésekben, a cím pedig megjelenik a pull-kérelmek listájában.
  4. Ellenőrzést végzők: Válassz olyan ellenőrzőket, akik hatékony visszajelzést adnak, és akik jóváhagyják majd a változtatásokat.
  5. Leágazás bezárása: Akkor válaszd, ha a pull-kérelem összefésülése után szeretnéd automatikusan lezárni a leágazást.
  6. Változtatások és véglegesítések: Ezeken a füleken láthatod a végrehajtott változtatásokat (Diff) vagy az érintett véglegesítéseket.
  1. Kattints a Pull-kérelem létrehozása gombra.

A pull-kérelmet megtekintheted az adattárad oldalsó navigációs sávjában található Pull-kérelmek listában.

Pull-kérelem ellenőrzése

Ha ellenőrző vagy, kapsz egy értesítést, amely jelzi, hogy egy pull-kérelem az ellenőrzésedre vár. Az Irányítópult Pull-kérelmek fülén rákereshetsz a nyitott pull-kérelmekre. Minőségbiztosítási célokból több módszerrel is ellenőrizheted a kódot: a csapatod dönti el, hogy melyik megoldást választjátok. Íme néhány módszer ahhoz, hogy hatékonyan kommunikálj a munkatársaiddal, hogy mindenki tisztában legyen vele, mi változik, és jóváhagyhassák az összefésülendő változtatásokat.

Lásd a különbséget
Amikor megtekintesz egy pull-kérelmet, a pull-kérelemben módosított összes fájlnál láthatod a diffeket (a változtatásokat). A zölddel besatírozott vonalak a hozzáadást, a pirosak pedig az eltávolítást jelölik. A pull-kérelem felső részén rákattinthatsz a Véglegesítések fülre, ahol megnézheted, hogy mely véglegesítések kerültek be. Ez a nagy méretű pull-kérelmek ellenőrzésekor különösen hasznos lehet.

Küldj visszajelzést és kérdezz a megjegyzésekben
A Bitbucketben megjegyzéseket írhatsz az egész pull-kérelemhez, egy konkrét fájlhoz vagy a fájlon belül egy konkrét helyhez. Ez akkor lehet hasznos, ha kontextust vagy konkrét információkat szeretnél biztosítani a visszajelzéshez. A megjegyzésekhez képeket, linkeket, rich text szöveget is mellékelhetsz, ráadásul egyedi URL-címük van, így könnyen megoszthatsz egy konkrét megjegyzést is.

Pull-kérelem jóváhagyása vagy elutasítása
A kódváltoztatások áttekintése után tájékoztatnod kell a pull-kérelem szerzőjét, hogy a pull-kérelem készen áll-e az összefésülésre. A Jóváhagyás gombbal értesítést küldhetsz a pull-kérelmet létrehozó szerzőnek, hogy véleményed szerint a módosítások biztonságosan összefésülhetők. Ha elutasítod a pull-kérelmet, ennek az ellenkezője igaz. Az elutasított pull-kérelmeket nem lehet újra megnyitni. A leágazás összefésüléséhez új pull-kérelmet kell nyitnod.

Megjegyzés: a pull-kérelem elutasítása sosem kellemes érzés a szerzőnek, így javasoljuk, hogy csak abban az esetekben élj ezzel a lehetőséggel, ha a változtatások teljesen célt tévesztettek, vagy már egyáltalán nincs szükség rájuk. Légy kedves, amikor mások munkáját értékeled, és először próbáld őket megérteni, mielőtt megfogalmazod a saját véleményedet.

Pull-kérelem összefésülése
Miután a kódodat egy pull-kérelemben ellenőrizték és jóváhagyták, kattints az Összefésülés gombra, hogy a leágazásodat összefésüld a fő ággal. A forrásleágazásból származó kódváltoztatások ezzel teljes mértékben bekerültek a célleágazásba.


2. útmutató, 1. rész: A felület bemutatása

1. útmutató: A Bitbucket rövid áttekintése