Close

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

A kezdéshez szükséged lesz egy Bitbucket Cloud-fiókra, hogy követni tudd az oktatóanyag lépéseit. Az útmutató bemutatja a Bitbucket leggyakrabban használt részeit, így érdemes előtte telepíteni a Gitet, valamint megismerni az alapvető Git-parancsokat és a Git működését.

Új vagy a Giten? Nem probléma, rád is gondoltunk! Olvasd el a „Használd jól a Git szoftvert” című oktatóanyagokat, amelyek kiváló bevezetést nyújtanak a Githez.


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

Mivel az adattárad a felhőben fut, be kell állítanod a helyi rendszeredet, hogy hozzájáruljon a Bitbucketben tárolt kódhoz, vagy módosítsa a kódot. Ehhez a lépéshez telepítened és konfigurálnod kell a Gitet, így ha kihagytad azt a lépést, akkor érdemes visszamenni és befejezni ezt a részt is. Ne feledd, hogy egy teljesen különálló útmutatót is közzétettünk, hogy ebben segítsünk!

Klónozz egy Bitbucket-adattárat!

Amint létrehoztad (vagy importáltad), először klónoznod kell az adattárat a helyi rendszeredbe a Bitbucket-adattáron közösen végrehajtott kódváltoztatásokhoz. További információ a Git klónozásáról.

  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!

A fejlesztők egy átlagos nap során általában helyileg dolgoznak a kódon, majd amint elkészültek, mentik a módosításaikat. Utána általában a parancssori kezelőfelületről hozzáadják, véglegesítik és beküldik a változtatásokat a Bitbucketre. További információk a Git-beküldésről.

Tegyük fel, hogy az egyik munkatársad rendkívül fontos módosításokat végzett azokon a fájlokon, amelyeket te korábban már beküldtél. Lépj be az adattárba a Bitbucketen, majd kattints az egyik fájlra, amelyet beküldtél. Ha eddig követted a lépéseket, akkor az adattárban lennie kell egy README -fájlnak.

A fájl online szerkesztéséhez:

  1. Lépj be az adattárba.
  2. Kattints a fájlnévre.
  3. Kattints a Szerkesztés lehetőségre.
  4. Végezd el a módosítást.
  5. Kattints a Véglegesítés lehetőségre.

Most már vannak változtatások a Bitbucketen, amelyeket lehívhatsz a helyi rendszerbe.

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!

Amikor közösen dolgoztok a kódon, rendszeresen le kell hívnod a csapattársaid által végrehajtott módosításokat, hogy naprakészen tartsd a helyi adattáradat. Így garantáltan mindig a kód legfrissebb változatán fogsz dolgozni. További információk a Git pull-kérelmeirő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 master é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 mastert, valamint az újonnan létrehozott leágazást. git branch
  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