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
- 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.
- Adj nevet az adattárnak. Ez fontos! Az adattár neve az URL része lesz.
- A „Hozzáadsz egy README-fájlt?” lehetőségnél válaszd az Igen, sablonnal beállítást.
- A többinél hagyd meg az alapértelmezett értéket, majd kattints a Létrehozás gombra.
Adattár importálása egy másik Git-szolgáltatótól
- 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.
-
Add meg az URL-címet, ahol elérhető az adattár.
-
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.
-
Adj nevet az adattárnak. Ez fontos! Az adattár neve az URL része lesz.
-
A többinél hagyd meg az alapértelmezett értéket, majd kattints az Adattár importálása gombra.
2. lépés: Helyi beállítás, globális együttműködés
Klónozz egy Bitbucket-adattárat!
- 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.
- 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).
- Másold a klónozási parancsot.
A CLI-ből
- Válts arra a könyvtárra, ahova klónozni szeretnéd az adattáradat.
cd
- 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
- Válts arra a könyvtárra, ahova klónozni szeretnéd az adattáradat.
cd
- 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!
- 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.
- 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.
A CLI-ből
- 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 - 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 - 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
A helyi adattárkönyvtárban található CLI-ből
- Hozz létre egy leágazást a Git leágazás paranccsal.
git branch - 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 -
Töltsd be a leágazást.
git checkout -
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.
-
Lépj be az adattáradba.
-
Kattints a Leágazások lehetőségre.
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
- 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.
- Töltsd ki a pull-kérelem űrlapjának többi mezőjét:
- 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.
- Cél: Az adattár és a leágazás, ahová egyesíteni szeretnéd a változtatásaidat.
- 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.
- 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.
- 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.
- 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.
- 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.