github tutorial developers how use github
Aquest tutorial de GitHub explica què és GitHub i com es pot crear una sol·licitud de dipòsit, ramificació i extracció. Inclou Normes de protecció d'oficines i resolució de conflictes:
Què és GitHub?
GitHub és un servei al núvol que ajuda els desenvolupadors a emmagatzemar i gestionar el seu codi font, així com a controlar i controlar tots els canvis al codi font.
En termes senzills, GitHub està pensat per a desenvolupadors on poden gestionar el projecte, allotjar el codi font i revisar-los també. Explorarem tot això en aquesta sèrie.
Llista de tutorials d'aquesta sèrie GitHub:
Tutorial # 1: Tutorial de GitHub per a desenvolupadors | Com utilitzar GitHub (Aquest tutorial)
Tutorial # 2: Projectes, equips, forquilla i wiki de GitHub per documentar projectes
Tutorial # 3: Comandaments avançats de Git i tutorial d'integració de GitHub
Tutorial # 4: Tutorial de l'API REST de GitHub: suport de l'API REST a GitHub
Tutorial # 5: Tutorial de l'escriptori GitHub: col.laboreu amb GitHub des del vostre escriptori
Tutorial # 6: Tutorial TortoiseGit - Com utilitzar TortoiseGit per al control de versions
Què aprendreu:
Què és Git?
Git és un sistema de control de versions de codi obert on tot el codi font està disponible a la màquina del desenvolupador. Git també és un sistema de control de versions distribuït i client (DVCS) on es poden fer branques i fusions.
Introducció a GitHub
Per començar a utilitzar GitHub, realitzarem els passos següents.
- Creeu un dipòsit per organitzar projectes.
- Creeu una sucursal
- Feu canvis al fitxer i feu el compromís.
- Creeu una sol·licitud d'extracció per combinar contingut.
- Protegiu la branca
A la segona part de la sèrie, també veurem les altres característiques de GitHub com Creació d’organitzacions, equips, números, fites, forquilles, llançaments i Wikis.
Creeu un dipòsit de GitHub
Un dipòsit GitHub conté artefactes del projecte, com ara codi font, documents, imatges, etc. Crearem i utilitzarem un dipòsit de demostració per realitzar tots els passos anteriors.
Inicieu la sessió a Github.com i Creeu un nou dipòsit . Feu clic al botó Novetat botó.
Afegiu els detalls de la reposició següents com es mostra i feu clic a Crea un dipòsit . Estableix l'accés a privat o públic. És millor establir-lo al públic, ja que poques funcions depenen d’aquest accés.
Nota: L'usuari que crea el dipòsit és el propietari del dipòsit GitHub.
El dipòsit es crea amb un fitxer README.
Addició de col·laboradors al dipòsit de GitHub
Voldríem que l'equip treballés en aquest dipòsit. Per a això, haurem de convidar els col·laboradors a treballar al dipòsit. Per afegir col·laboradors, aneu a la pàgina principal del repositori i feu clic a Configuració icona.
Fer clic a Col·laboradors al tauler esquerre i afegiu els col·laboradors que tenen un compte de Github. S’enviaria una invitació i els col·laboradors haurien d’acceptar la invitació.
Els col·laboradors s’afegeixen com es mostra a continuació. Més endavant, en aquest tutorial, veurem com s'afegiran els col·laboradors com a revisor de la sol·licitud d'extracció creada per combinar el codi.
Realització d’una C bàsica ommit
Obriu el fitxer README i realitzeu una confirmació bàsica. Feu clic al botó Icona d'edició per començar a modificar el fitxer.
Modifiqueu el fitxer, afegiu un comentari i feu clic a Compromís .
El fitxer es confia (es guarden els canvis) al dipòsit Github.
Es veuran poques operacions per crear carpetes i fitxers dins del dipòsit.
Per crear la carpeta i un fitxer dins: Feu clic al botó Crea un fitxer nou botó a nivell de dipòsit. Escriviu el nom del directori seguit de / i el nom del fitxer com es mostra a continuació.
Fer clic a Compromís a la part inferior. La carpeta i el fitxer es creen com es mostra. Per tant, els fitxers i carpetes es creen al fitxer mestre branca que és la branca d'integració principal i principalment on es poden construir les versions del programari.
Normalment, els desenvolupadors treballen en la tasca que se'ls assigna en una branca independent i fusionen els canvis amb la branca mestra. Per exemple, es poden crear branques per al desenvolupament de funcions o per resoldre errors o treballar en millores, etc. Així, creant una branca el treball queda aïllat sense molestar les altres branques.
Al següent pas, podem veure com es poden crear les branques i definir les sol·licituds d'extracció per revisar i combinar el codi a la branca mestra.
Moure un fitxer
Per moure un fitxer a una altra carpeta, seguiu els passos següents. Per exemple, per moure el fitxer rules.txt a una carpeta doc. Feu clic al fitxer.
Feu clic a la icona per editar el fitxer.
Afegiu el camí doc / abans del fitxer regles.txt . Fer clic a Fer canvis.
El camí s'ha actualitzat.
Creant una sucursal GitHub
Aneu a la pàgina principal del dipòsit i escriviu per crear un fitxer característica branca com es mostra. Fer clic a Crea una sucursal.
Ara som a la característica branca. Els fitxers són els mateixos. Ara farem alguns canvis als fitxers del fitxer característica branch i creeu una sol·licitud d'extracció per revisar els canvis i combinar el codi amb el fitxer mestre branca.
Feu canvis als fitxers de la branca de funcions.
Obriu el fitxer Java a la carpeta Src i afegiu-hi codi i confirmeu el canvi.
Creeu una sol·licitud d'extracció de GitHub
A la secció anterior, vam crear una sucursal característica i va fer alguns canvis en un fitxer. Els canvis no es troben al fitxer mestre branca. Per a això, hem de crear una sol·licitud d'extracció mitjançant la qual l'usuari proposa revisar certs canvis i combinar-los amb el fitxer mestre branca.
La creació de la sol·licitud d'extracció mostrarà les diferències entre la branca d'origen i la destinació i, si n'hi ha, haurà de resoldre conflictes.
Fer clic a Sol·licitud de comparació i extracció a la pàgina principal del dipòsit.
Podeu veure que es poden combinar els canvis a les dues branques. Fer clic a Crea una sol·licitud d'extracció.
Fer clic a Fusiona la sol·licitud d'extracció i Confirmeu per completar la combinació.
Els canvis es combinen amb èxit en el fitxer mestre branca. La nostra primera sol·licitud Pull s'ha completat amb èxit.
Assigneu revisors amb sol·licituds d'extracció i revisió de codi
Github té una bona característica d’utilitzar un fitxer CODEOWNERS en el qual podem seleccionar les persones responsables del codi font al dipòsit. Els propietaris del dipòsit poden crear aquest fitxer i tots els usuaris definits al fitxer se sol·liciten per defecte per a la revisió durant la creació de la sol·licitud d'extracció.
Per utilitzar aquesta funció, heu d’utilitzar la versió de GitHub Pro o fer públic el dipòsit.
A l'arrel del dipòsit, creeu aquest fitxer en el format següent i confieu el fitxer.
* @usuari o @orgname o @teamname
* significa principalment tots els fitxers del repo. També podeu especificar extensions específiques com * .java o * .js, etc. Els usuaris definits al fitxer rebran una sol·licitud de revisió automàticament. Amb el fitxer CODEOWNERS definit, no cal afegir explícitament revisors manualment i té una mica més de flexibilitat per triar quins fitxers es revisaran.
De nou al característica fer un petit canvi al fitxer Java i crear una sol·licitud d'extracció. A la pantalla Pull Request, assigneu un revisor a la part dreta. Fer clic a Crea una sol·licitud d'extracció.
Podeu veure a la pantalla anterior que els revisors es poden assignar manualment, però els revisors es defineixen al fitxer CODEOWNERS que rebrà automàticament una sol·licitud per revisar els canvis de codi.
De totes maneres, de moment, anem iniciar Sessió com a revisor i aprovar els canvis. Inicieu la sessió com a usuari vniranjan2512 per aprovar els canvis.
Hi ha una sol·licitud per aprovar / rebutjar els canvis a sota Sol·licitud d'extracció.
Feu clic a la sol·licitud de tracció i Afegiu la vostra ressenya.
Podeu fer clic a + signeu i afegiu comentaris de ressenyes per a la línia de codi Afegit / Modificat / Suprimit, a la pantalla que apareix.
Fer clic a Comenceu una revisió.
Fer clic a Acaba la revisió. Aprovar com es mostra i Envia la revisió .
Com a usuari original que va presentar una sol·licitud d'extracció, podeu afegir un comentari i resoldre o tancar la conversa.
Ara es pot completar la sol·licitud de combinació.
Els canvis es combinen amb èxit en el fitxer mestre sucursal publicar la revisió i fusionar la sol·licitud d'extracció.
Per tant, per resumir en aquesta etapa, hem vist que els desenvolupadors treballen en característica i després aixequeu una sol·licitud d'extracció per combinar els canvis amb el fitxer mestre branca. L’anterior era un escenari on els conflictes no hi eren. A la secció següent, veurem les maneres de resoldre els conflictes manualment si es canvien els fitxers en diverses branques.
Resoldre conflictes
És possible que es canvien els mateixos fitxers en diverses branques. En aquest cas, hi hauria conflictes i s’ha de resoldre mitjançant la sol·licitud d’extracció plantejada.
Per exemple, fer canvis al fitxer Java tant al fitxer mestre i característica branques i aixecar una sol·licitud de tracció.
El missatge de sol·licitud d'extracció que es mostra és que els canvis no es poden combinar automàticament. Per tant, els conflictes s'han de resoldre. Procediu per crear una sol·licitud d'extracció.
Un cop plantejada la sol·licitud d'extracció, caldrà resoldre els conflictes fent clic a Resoldre conflictes botó.
Elimineu les marques que bàsicament resolen conflictes manualment i feu clic a Marca com a resolt i Fes una combinació.
La vista final del fitxer després d’eliminar les marques.
Es pot completar la sol·licitud de combinació. El mestre i característica ara les branques seran idèntiques.
Encara podeu veure a la pantalla anterior que es demana la revisió però no és obligatòria. A la següent secció, veurem les regles de protecció de sucursal en què el propietari del dipòsit pot sol·licitar obligatòriament una revisió i també protegir el mestre branca de comprometre-s'hi directament, però només mitjançant una sol·licitud de tracció.
Normes de protecció de sucursal
A les seccions anteriors, vam veure les sol·licituds de retirada de Github i també la sol·licitud de revisions que no eren obligatòries ni opcionals. En el codi típic dels escenaris del projecte, les revisions són imprescindibles i formen part del procés de desenvolupament.
Vegem com aplicar-ho.
A github.com aquesta característica només es pot configurar per a repositoris públics o mitjançant la versió Github pro. A la pàgina principal del dipòsit, aneu a Configuració i feu clic al botó Branques categoria a l’esquerra.
Fer clic a Afegeix una regla sota la Normes de protecció de sucursal. La regla va afegir sol·licituds de revisions obligatòries de sol·licituds d'extracció dels propietaris de codi abans de combinar-les per a mestre branca.
Això també garantirà que el fitxer branca mestra està protegit i no es poden fer compromisos directes en aquesta sucursal i només es poden comprometre mitjançant les sol·licituds de tracció després d’una revisió exhaustiva. Aquesta configuració la defineix el propietari del dipòsit.
Una gran característica!
Fer clic a Crear un cop fet. Per provar aquest escenari, feu un canvi a un fitxer al fitxer característica sucursal i creeu una sol·licitud d'extracció
La pantalla següent mostra que els propietaris del codi han de fer una revisió obligatòriament.
Envia la revisió als propietaris del codi, es pot combinar la sol·licitud d'extracció.
Com a col·laborador del dipòsit, si feu canvis a algun dels fitxers, a causa de les regles de les branques protegides creades, no podreu accedir directament a la branca mestra, sinó només mitjançant una sol·licitud de tracció després de crear una branca, tal com es mostra baix.
Transferència d’un dipòsit a un altre compte d’usuari
Normalment, un dipòsit d’usuaris personal té un únic propietari i tots els altres són col·laboradors. Per tant, en un sentit que no podeu tenir diversos propietaris en un dipòsit de comptes d’usuari. Però la propietat es pot transferir a un altre compte d'usuari. En acabar, el propietari del dipòsit original es converteix automàticament en col·laboradors del dipòsit del compte d'usuari nou.
Aleshores, el nou propietari pot començar a administrar els artefactes, els problemes, les sol·licituds extretes, els projectes, les versions i la configuració.
Normalment, quan es realitzen ordres com 'git clone' o 'git push' al dipòsit local, les ordres es redirigiran al nou dipòsit. Però quan executeu l’ordre ‘git remote -v’, continuarà mostrant l’URL original del dipòsit. Per evitar confusions, canvieu al nou URL remot i publiqueu la transferència del dipòsit mitjançant l'ordre 'git remote set-url'.
Per transferir un dipòsit, aneu a la pestanya Configuració del dipòsit i a Opcions? Feu clic a la zona de perill Transferència
Introduïu el nom del dipòsit i el nou compte d'usuari al qual s'ha de transferir la propietat.
Feu clic a Entenc, transfereixo aquest repositori
Heu de veure un missatge que indica que el dipòsit es transfereix al nou propietari.
S’enviarà un correu electrònic al propietari del dipòsit original per aprovar la transferència. Un cop aprovada la transferència, el dipòsit es transferirà al nou propietari i s'afegirà el propietari original del dipòsit com a col·laborador.
Ara configureu l'URL del dipòsit nou a la màquina on es va clonar l'antic dipòsit. Les ordres següents s'han d'establir a totes les màquines on es va clonar l'antic dipòsit.
Totes les sol·licituds d'extracció, problemes i wiki es transferiran. Les assignacions d’emissions es mantindran intactes.
Alguns ordres útils de Git
Hi ha algunes de les ordres bàsiques de Git que es configuraran inicialment a la vostra màquina local un cop instal·lat el client Git a la vostra màquina Linux o Windows. Els desenvolupadors treballen localment, sense connexió amb el dipòsit de GitHub, amb la còpia completa del codi font disponible a GitHub i se sincronitzen amb ell.
En primer lloc, configureu el vostre nom d'usuari i adreça de correu electrònic per assegurar-vos que tots els compromisos que feu fan servir aquesta informació.
git config –nom d'usuari global “Nom d'usuari”
git config –global user.email “myemail@myemail.com”
Quan hàgiu d'afegir un missatge durant les confirmacions, també podeu configurar l'editor necessari per al mateix.
Preguntes i respostes de l'entrevista de desenvolupadors .net
git config – bloc de notes core.editor global
Obteniu una llista de tots els valors de configuració establerts.
git config –list
De vegades, les organitzacions tenen servidors proxy per connectar-se a Internet. En aquest cas, haureu d'especificar un servidor intermediari i un número de port per accedir a tots els repositoris de GitHub.
git config –global http.proxyhttp: // Nom d'usuari: Contrasenya @ servidor intermediari: port
Cloneu o feu una còpia local del dipòsit. Obteniu l'URL de clonació del dipòsit a GitHub i executeu l'ordre git.
Conclusió
En aquest tutorial, hem vist com un desenvolupador pot començar a treballar a GitHub, des de la creació d’un dipòsit de GitHub, sucursal, sol·licitud d’extracció, protecció d’una sucursal i algunes ordres bàsiques de Git.
Al nostre proper tutorial, veurem les altres funcions de GitHub principalment sobre com crear organitzacions, equips, bifurcar un repositori, crear problemes, fites i associar-los amb les sol·licituds pull, wiki i els seus usos i algunes altres ordres Git avançades que seran útils. als desenvolupadors.
Lectura recomanada
- Tutorial de reflexió de Java amb exemples
- Git contra GitHub: exploreu les diferències amb exemples
- Tutorial de Python DateTime amb exemples
- Integració de seleni amb GitHub mitjançant Eclipse
- Una guia ràpida de SoapUI per emmagatzemar dades de sol·licituds i respostes en un fitxer: tutorial de SoapUI núm. 15
- Tutorial Bugzilla: Tutorial pràctic de l'eina de gestió de defectes
- 20+ Tutorial de MongoDB per a principiants: curs gratuït de MongoDB
- Tutorial de fragments de MongoDB amb exemple