Què és Github, com utilitzar-lo, com crear un projecte, gestionar-lo i configurar-lo

Què és GitHub, per què es necessita i com utilitzar GitHub, com començar a utilitzar el servei: una guia per a principiants.
GitHub és un dels serveis més populars per allotjar dipòsits de codi obert. El lloc us permet publicar projectes personalitzats i fer un seguiment dels canvis realitzats en cada iteració. Altres usuaris de GitHub poden revisar el codi d’usuari i suggerir els seus propis canvis. Aquesta definició només proporciona una breu comprensió. Tanmateix, la funcionalitat del servei no es limita a això. En aquest article de revisió, veurem Github amb més detall.

Què és GitHub i com començar: una guia per a principiants

GitHub és un portal en línia on els desenvolupadors i programadors poden penjar el codi que creen i treballar junts per millorar-lo. El segell distintiu de GitHub és el seu robust sistema de control de versions. El control de versions permet als programadors personalitzar el programari sense comprometre el programari en si. Els canvis proposats es poden combinar fàcilment en una versió completa, però només després que s’hagin revisat i aprovat tots els canvis.

Git i GitHub: quina diferència hi ha, primer coneixement de Git i GitHub

Què és Git?

Resposta: Un sistema de control de versions ràpid i escalable . Git és un sistema de control de versions distribuït gratuït i de codi obert dissenyat per ser ràpid i eficient per a qualsevol projecte, des de petits fins a molt grans.

Què és GitHub?

Resposta: un potent servei al núvol per gestionar desenvolupaments privats i projectes de codi obert.

Quina és la diferència principal?

Git és un programari complet de la categoria del sistema de control de versions, que s’instal·la a l’ordinador personal de l’usuari. Git us permet fer canvis al codi mitjançant la línia d’ordres (Microsoft PowerShell) i GitHub ofereix la possibilitat d’emmagatzemar projectes en accés públic.

Dades interessants sobre Github

1. El nombre màxim d’usuaris del lloc l’any passat (segons les estadístiques del 24 de juliol de 2021) va ser de 45 milions de persones.
2. El 2018, Microsoft va adquirir GitHub per 7.500 milions de dòlars.
3. Hi ha un repositori git de codi obert a Github. Qualsevol pot fer-hi canvis. El projecte està disponible a l’enllaç – https://github.com/git/git?ref=stackshare

Característiques de Github

1. Capacitat d’integrar-se amb les plataformes i serveis més populars: Amazon, Google Cloud i Code Climate.
2. Suport per a més de 200 llenguatges de programació.
3. Alt nivell de consolidació i “solidaritat gremial”. Quan un usuari publica el seu projecte a GitHub, la resta de la comunitat de programadors pot descarregar i avaluar el treball, la qualitat del codi i el grau de sofisticació. Els usuaris de tercers poden avisar el propietari del projecte sobre possibles problemes, conflictes de variables, etc.

Com funciona GitHub, característiques

Tres de les característiques més importants de Github són la ramificació, les sol·licituds d’extracció i la fusió. Val la pena considerar cada funció per separat.

Bifurcació

La bifurcació d’un projecte crea una còpia (fork) que permet a l’usuari experimentar lliurement sense afectar el projecte original. Crea bifurcacions i sol·licituds d’extracció: https://youtu.be/nT8KGYVurIU

Sol·licituds d’extracció

El desenvolupador publica una sol·licitud d’extracció després que acabi de treballar per arreglar/canviar el codi. Al mateix temps, el propi propietari del projecte pot revisar els canvis realitzats i fer qualsevol pregunta addicional.

Fusió

Després que el propietari aprovi la sol·licitud d’extracció, la fusiona i apliquen els canvis del projecte bifurcat al codi font.

Guia: com començar a Github des de zero

Aquesta guia és perfecta per a tots els principiants que tot just comencen a aprendre Git i Github. Els passos següents us ajudaran a crear un sistema òptim per treballar amb aquest programari. Aprendràs a fer canvis a la base de codi, obrir una sol·licitud d’extracció (crear una sol·licitud d’extracció) i combinar el codi a la branca principal. Així que comencem.

Pas 0 Instal·leu Git i creeu un compte de GitHub

1. Aneu al lloc web oficial de Git: https://git-scm.com/downloads
2. Feu clic a l’enllaç per descarregar la versió d’escriptori de Git per a Windows i espereu que finalitzi la descàrrega.
3. Extraieu i executeu l’instal·lador de Git fent doble clic al fitxer Git.exe.
4. Permeteu que l’aplicació faci canvis a l’ordinador fent clic al botó “Sí” al quadre de diàleg “Control del compte d’usuari” que s’obre.
5. Inicieu el procés d’instal·lació de Git. Llegiu el document principal de la llicència pública de GNU i feu clic a Següent.
6. Especifiqueu una ubicació per instal·lar el programa o deixeu els valors predeterminats. El programa us demanarà que creeu una carpeta del menú Inici. Omet aquest element.
7. Seleccioneu l’editor de text que voleu utilitzar amb Git. A la finestra desplegable, seleccioneu Bloc de notes ++ (o qualsevol altre editor de text amb el qual hàgiu treballat anteriorment) i feu clic a “Següent”.
8. Especifiqueu un nom per a la nova branca del projecte. El valor per defecte és “master”. Es recomana deixar aquesta configuració com a predeterminada.
9. A les opcions per triar PATH, client SSH, certificats de servidor, finals de línia i terminal, deixeu-ho tot com està i feu clic al botó “Següent”.
10. Deixeu tota la configuració predeterminada i comenceu a instal·lar el programa.
11. Un cop finalitzada la instal·lació, marqueu les caselles per veure les notes de la versió i inicieu Git Bash. Tanqueu la finestra de l’instal·lador.

Podeu registrar un compte a Github mitjançant el següent enllaç: https://github.com/join. Per fer-ho, heu d’introduir les dades bàsiques de registre necessàries en el futur per verificar el compte.

Pas 1: inicieu Git i creeu el primer dipòsit local

Git té dos modes d’ús: bash (Git Bash) i interfície d’usuari gràfica (Git GUI). Per iniciar Git Bash, obriu el menú Inici – Windows, escriviu git bash i premeu Enter (o feu doble clic amb el botó esquerre a la drecera del programa). Per iniciar la GUI de Git, obriu el menú Inici – Windows, escriviu git gui i premeu Intro. En el nostre cas, utilitzarem Git Bash.
Crear un projecte nou a Git Bash implica utilitzar ordres especials per inicialitzar un nou dipòsit. Primer heu d’obrir un terminal Bash fent clic amb el botó dret a l’escriptori i després al menú desplegable Git Bash Aquí. En una finestra de terminal de la vostra màquina local, creeu un nou directori de prova (carpeta) escrivint el següent:
getrekt:Desktop getrekt $ cd ~/Desktop
getrekt:Desktop getrekt $ mkdir myproject
getrekt:Desktop getrekt $ cd myproject/
L’ ordre mkdir crea una nova carpeta de projecte local. Creeu el nostre primer dipòsit de Github: https://youtu.be/yHCUc6cmhcc

Pas 2. Creeu un fitxer nou al repositori

A la carpeta del projecte, afegiu un fitxer de text nou amb l’ordre tàctil. De la manera estàndard, l’ordre crearà un fitxer de text buit que tindrà l’extensió .txt.

Atenció! Git desa/gestiona els canvis només als fitxers dels quals fa un seguiment. Després de crear un fitxer nou, l’usuari pot fer un seguiment del seu estat mitjançant l’ordre git status. La consola donarà una llista dels fitxers que hi ha al repositori.

Tan bon punt afegiu un fitxer a la carpeta que conté el repositori git, el programa notarà el canvi dins del projecte. Tanmateix, el seguiment automàtic no s’habilitarà, heu d’utilitzar una ordre especial per a això: git add.
getrekt:el meu projecte getrekt $ toca getrekt.txt
getrekt:el meu projecte getrekt $ ls
getrekt.txt

Pas 3: afegiu el fitxer a l’entorn de seguiment

Afegiu el fitxer a l’entorn de prova amb l’ordre git add.
getrekt:myproject git add . Amb aquesta ordre, el programa iniciarà el seguiment automàtic de tots els fitxers que es crearan a la carpeta del projecte. Podeu comprovar si l’ordre funciona amb git status. Així es veuen els registres a la línia d’ordres de Git Bash després d’escriure git status:
getrekt: getrekt getrekt$ git status
Al mestre de la branca
Compromís inicial
Canvis que s’han de confirmar:
(utilitza “git rm –cached …” per sortir de l’escenari)
Fitxer nou afegit
Nom
de fitxer nou: getrekt.txt Fitxer nou: getrekt.txt Comentari de registre: El fitxer encara no s’ha compromès, però està a punt de ser afegit.

Pas 4 Creeu un compromís

Commit és un punt de control de qualsevol repositori. En poques paraules, un paquet de canvis que emmagatzema informació sobre fitxers afegits, editats o suprimits que emmagatzemen cert codi.
getrekt:myproject getrekt $ git commit -m “Els MEUS PRIMERS COMPROMISOS!”
[master (root-commit) b345d9a] LA MEVA PRIMERA COMMISSIÓ!
S’ha canviat 1 fitxer, 1 inserció (+)
mode de creació 100644 getrekt.txt

L’ordre per crear un commit és git commit -m “Nom del commit”.

Atenció! El missatge al final de l’ordre ha de ser significatiu i comprensible per a altres desenvolupadors de projectes. No anomeneu els vostres commits com “asdfadsf” o “foobar”. En cas contrari, ningú no entendrà res, i hauràs de passar molt de temps esborrant-los.

Pas 5. Creeu una branca nova

La nova branca és una branca completa del projecte, que consta de tot un conjunt de commits. Representa una versió independent del producte, però dins del sistema de control de versions. Les branques permeten a l’usuari moure’s entre “estats” d’un projecte.

A la documentació oficial de git, la descripció de les branques és: “La branca a Git i Github és un punter mòbil a una de les confirmacions del dipòsit”.

Per exemple, si un usuari volgués afegir una pàgina nova al seu lloc web, podria crear una branca nova només per a aquesta pàgina en particular sense afectar el cos principal del projecte. Tan bon punt acabi amb això, pot fusionar els canvis de la seva branca a la principal. En el cas d’una nova branca, Git fa un seguiment de quina commit s’ha ramificat.
Després d’executar l’ordre, podeu escriure git branch a la consola per confirmar la creació de la branca:
getrekt:myproject getrekt $ git branch
master
* my-new-branch El nom my-new-branch amb un asterisc indica quina branca l’usuari està en marxa actualment.

Nota: Per defecte, la primera branca de cada repo git s’anomena “mestre” (i normalment s’utilitza com a mestre en un projecte). Com a part de la lluita contra el racisme, alguns desenvolupadors han començat a utilitzar noms alternatius per a la branca predeterminada, com ara “principal”. Tanmateix, la majoria de vegades, els usuaris poden veure noms “mestre” o similars utilitzats per referir-s’hi.

Val la pena tenir en compte que gairebé tots els dipòsits tenen una branca mestra que es pot considerar la versió oficial del projecte. Si es tracta d’un lloc web, la branca és la versió que veuen els usuaris. Si es tracta d’una aplicació, la branca mestra és la versió que els usuaris instal·len al seu ordinador o dispositiu mòbil. Així és com funciona la versió tradicional dels productes Git i Github. El lloc oficial té documentació més detallada sobre l’ús de diferents noms de branques predeterminats. La informació està disponible a Github a https://github.com/github/renaming
En el cas de tornar a una branca del projecte i crear múltiples commits, el sistema de control de versions no farà un seguiment de la nova branca fins que l’usuari escrigui un seguiment automàtic .

Pas 6 Creeu un nou dipòsit de GitHub

Aquest pas no és necessari si només voleu fer un seguiment del vostre codi localment. Però si treballeu en equip i accepteu els canvis d’altres programadors, podeu utilitzar les capacitats actuals de GitHub per canviar conjuntament el codi del projecte. Per crear un nou dipòsit a GitHub, heu d’iniciar sessió al sistema i anar a la pàgina principal del lloc. Des del menú principal, feu clic al botó “Nou repositori”, que es troba sota el signe “+” al costat de la foto del perfil a l’extrem superior dret de la barra de navegació: Després de fer clic al botó, GitHub preguntarà al propietari del projecte. per anomenar el repositori i proporcionar una breu descripció:
A continuació, feu clic al botó “Crea un repositori” per confirmar la creació d’un nou projecte. Apareixerà un quadre de diàleg preguntant a l’usuari si vol crear un repositori des de zero o afegir-ne un existent creat localment. En el segon cas, heu de carregar la carpeta del projecte a Github.

Atenció! La descàrrega d’un dipòsit local també es pot produir mitjançant la línia d’ordres, i més concretament les ordres git remote add origin github_url (crea un registre d’una nova connexió al dipòsit remot), git push -u origin master (estableix una connexió entre la branca de on es troba el desenvolupador i la branca mestra en un servidor remot).

Així són els registres a la línia d’ordres de Git Bash:
getrekt:myproject getrekt $ git remote add origin https://github.com/cubeton/mynewrepository.git
getrekt:myproject getrekt $ git push -u origin master
Comptar objectes: 3, fet.
Objectes d’escriptura: 100% (3/3), 263 bytes | 0 bytes/s, fet.
Total 3 (delta 0), reutilitzat 0 (delta 0)
A https://github.com/cubeton/mynewrepository.git
* [new branch] master -> master
Branch master configurat per fer un seguiment del mestre de branca remota des de l’origen.

Pas 7: empènyer la branca del projecte a GitHub

S’ha creat una nova branca de projecte i un repositori. Queda per “empènyer” la branca i transferir-la al nou dipòsit de Github. D’aquesta manera, els membres de la comunitat de tercers podran veure el codi i fer-hi canvis. Si s’aproven les revisions, el propietari del projecte pot combinar els canvis a la versió principal del projecte. Per enviar els canvis a una branca nova a GitHub, heu d’introduir l’ordre git push a la línia d’ordres. GitHub crearà automàticament una branca al repositori remot:
getrekt:myproject getrekt$ git push origin my-new-branch
Comptar objectes: 3, fet.
Compressió delta utilitzant fins a 8 fils.
Compressió d’objectes: 100% (2/2), fet.
Escriptura d’objectes: 100% (3/3), 313 bytes | 0 bytes/s, fet.
Total 3 (delta 0), reutilitzat 0 (delta 0)
A https://github.com/cubeton/mynewrepository.git
* [new branch] my-new-branch -> my-new-branch Després d’actualitzar la pàgina de GitHub, l’usuari veurà la nova branca que s’ha introduït a la repositori.

A més

Què significa la paraula origen a l’ordre git push origin? Quan un usuari clona un dipòsit remot a la seva màquina local, git en crea un àlies estàndard en gairebé tots els casos, “origen”, que és essencialment una abreviatura de l’URL del dipòsit remot. Enviament d’un projecte a GitHub: https://youtu.be/zM6z57OtR2Q

Pas 8. Creeu la primera sol·licitud d’extracció

Una sol·licitud d’extracció (o sol·licitud d’extracció) és una manera d’avisar els propietaris del dipòsit que un desenvolupador vol fer alguns canvis al codi. Així és com es veu la pàgina amb la sol·licitud d’extracció afegida:
Així és com es veu la interfície de la secció després de crear la sol·licitud d’extracció:

Pas 9 Combina la sol·licitud d’extracció

El botó verd “Combina la sol·licitud d’extracció” a la part inferior crea una sol·licitud d’extracció. Després de fer-hi clic, els canvis realitzats s’afegeixen a la branca principal del projecte.

Atenció! Suprimeix la branca després de la fusió. Un gran nombre d’ells poden generar confusió en el projecte. Per suprimir una branca, feu clic al botó gris “Suprimeix la branca” a l’extrem inferior dret.

Per comprovar l’estat actual dels commits, feu clic a l’enllaç “Commits” a la primera pàgina del repositori. Si feu clic, es mostrarà tota la llista de commits d’aquesta branca. La captura de pantalla mostra exactament el que s’acaba de crear.

A la part dreta hi ha el codi hash de cada commit. El codi hash és un identificador únic que es pot utilitzar quan es connecten API i serveis de tercers. També podeu fer referència a una confirmació específica mitjançant el número d’identificació de la versió d’escriptori de Git Bash a la línia d’ordres.

Pas 10 Reverteix els canvis de Github a la màquina local

De moment, el dipòsit del sistema Github sembla una mica diferent de l’usuari de l’ordinador local. Per exemple, una confirmació que un usuari va fer a la seva pròpia branca i es va fusionar amb la branca mestra no existeix a la màquina local. Per sincronitzar automàticament diferents versions d’un projecte, heu d’utilitzar l’ordre git pull origin master (quan treballeu a la branca mestra) o git pull.
getrekt:myproject getrekt $ git pull origin master
remote: comptant objectes: 1, fet.
remot: Total 1 (delta 0), reutilitzat 0 (delta 0), pack-reused 0
Des de https://github.com/cubeton/mynewrepository
* branch master -> FETCH_HEAD  
23242..232433berer3444 master -> origin/master
getrekt. txt | 1 +
1 fitxer canviat, 1 inserció (+)Per comprovar l’estat actual d’una ordre, escriviu git log a la línia d’ordres. Enumerarà tots els compromisos.
getrekt: miproyecto getrekt $ git log
cometre 32dgt472hf74yh7734hf747fh373hde7r3heduer73hfhf
Combinar: 3fg4dd 34fg3u7j7
Autor: Ethan Mtdes <getrekt@yandex.ru>
Data: Fri Set 11 17:48:11 2015 -0400
branca Combina / cubeton / MiNuevoRepositorio
el commit 44hgfh7f74hdu9jt93hf9ifejffe
Autor: Mtdes de Ethan <getrekt@yandex.ru> a
Data : dv. 07 gen 17:48:00 2021 -02 356
la confirmació 46thf9496hf9485hkf857tg9hfj8rh4j
la fusió: 33fh5d 3689gfh 3689gfh
de 7 de gener de l’autor de l’autor.
:51:00 2021 -02356
46THF9496HF9485HKF857TG9HFJ8RH4J The Commit
the Merge: 33FH5D 3689GFH
Autor: MTDES d’ETO <GETREKT@YANDEX.RU>
A DATA: FRI Jan 07 17:55:00 2021 -02 356
Afegit alguns més text per al meu fitxer
El compromís 355904-43HG940FG959HFG0G95JJDGDFGF57I86F
la combinació : 343fggdd 53efhgffddg
Autor: Mtdes of Ethan < getrekt@yandex.ru>
Data: Div. 07 gen 17:58:00 2021 -02356
Aquesta és la meva primera confirmació! A punt! Ara l’usuari està familiaritzat amb tot tipus de treball en el sistema de control de versions. Tutorial de Git i GitHub per a principiants sobre com instal·lar Git i començar amb Github, branques, repositoris, commits i altres conceptes a la pràctica de GitHub: https://youtu.be/zZBiln_2FhM

Funcions addicionals de Github i Git

Vegem altres “xips” útils que permetran al desenvolupador simplificar el treball en el control de versions.

Clonació d’un dipòsit a una màquina local

Aneu al vostre repositori de GitHub. A l’extrem superior dret a sobre de la llista de fitxers, obriu el menú desplegable “Clona o baixa”. Copieu l’URL del clon HTTPS.
Torneu a la finestra de Git Bash i introduïu l’ordre:
git clone repository_url

repository_url – URL del projecte actual que s’ha de clonar. En canvi, s’insereix l’URL del dipòsit.

A l’exemple anterior, l’ordre clona el dipòsit mitjançant HTTPS. Una altra opció és clonar amb URL sobre claus SSH. Per fer-ho, heu de generar un parell de claus SSH a Windows i assignar una clau pública al compte de GitHub.

Trobar repositoris remots

Després de la clonació, hauria d’aparèixer una còpia del dipòsit de GitHub al directori de treball de l’ordinador. El projecte ha de contenir un directori amb un nom i fitxers principals. Per canviar-hi, heu d’escriure l’ordre següent:
cd git_project

Nota: Substituïu git_project pel nom real del repositori descarregat o especifiqueu el contingut del directori actual amb l’ordre ls. El segon mètode s’utilitza en els casos en què l’usuari no recorda el nom del projecte.

Versió d’escriptori GitHub: què és GitHub Desktop, funcionalitat principal, característiques i procés d’instal·lació

GitHub Desktop és una aplicació d’escriptori que proporciona una interacció basada en GUI amb GitHub. A diferència de Git, la versió d’escriptori de GitHub us permet executar les mateixes ordres mitjançant la interfície d’usuari fent clic als botons, cosa que fa que sigui molt més fàcil treballar amb repositoris.

Com instal · lar

1. Seguiu l’enllaç: https://desktop.github.com/
2. Comenceu a descarregar el paquet d’instal·lació del programa.
3. Feu doble clic a la icona del fitxer descarregat i procediu a la instal·lació de Github Desktop.
4. Inicieu el programa a través del menú Inici.
5. Inicieu la sessió a GitHub amb les dades del vostre compte d’usuari.

Funcionalitat principal

• Crear, afegir i clonar repositoris.
• Ús del programa per gestionar les pestanyes del projecte.
• Fer canvis en una branca.
• Creació de problemes, sol·licituds d’extracció i confirmacions.
• Possibilitat d’accedir a les primeres versions de nous productes.

API Github

L’API REST de Github és una interfície que proporciona als desenvolupadors accés a dades, projectes i repositoris de Github, així com l’enviament de sol·licituds al servidor. L’enllaç https://api.github.com/ conté tots els URL als quals podeu enviar les sol·licituds GET més senzilles:
Molt sovint, els desenvolupadors creen sol·licituds en el llenguatge de programació Python en format JSON. Primer cal obtenir la informació bàsica sobre el dipòsit des de l’enllaç – https://api.github.com/user/repos La informació bàsica s’introdueix al fitxer de configuració en format JSON. Conté els principals paràmetres sobre l’usuari: avatar, lectors, nombre de repositoris, descàrregues, etc. A continuació, aquestes dades es transmeten al servidor.

Gestió i configuració de projectes Github Desktop

Després d’instal·lar, registrar un compte i configurar l’aplicació, l’usuari pot començar a utilitzar el programa GitHub.

Crear, afegir i clonar un repositori

Per crear un repositori nou, seleccioneu “Fitxer” i feu clic al botó “Crea un repositori”. Per afegir un projecte local, seleccioneu el menú “Fitxer” i feu clic al botó “Afegeix un repositori local”. Per a la clonació, heu de seleccionar el menú “Fitxer” – “Clonar dipòsit”.

Creació d’una nova sucursal

Per crear una branca de projecte independent, obriu la secció Branca actual i feu clic al botó Nova branca. L’usuari podrà veure la branca a la interfície de GitHub i fer una sol·licitud d’extracció per fer un seguiment dels canvis.

Seguretat

La versió d’escriptori i web de Github us permet configurar i augmentar el nivell de seguretat d’un compte d’usuari. Totes les funcionalitats estan disponibles a la secció “Configuració de seguretat per a l’emmagatzematge”. Val la pena considerar-ho amb més detall.

Configuració de la política de seguretat

A la pàgina principal del vostre repositori, feu clic a:

• “Seguretat” – “Política de seguretat” – “Iniciar la configuració”.
• Afegiu informació sobre les versions compatibles del vostre projecte i com informar de possibles vulnerabilitats.

Gestió de gràfics de dependència

Es genera automàticament un gràfic de dependència per a tots els dipòsits públics, però no hi ha aquesta característica per als dipòsits privats. El gràfic identifica tots els fluxos de dependència sortints i us permet identificar les vulnerabilitats del projecte. Per configurar el gràfic de dependència, feu clic a “Configuració” – “Seguretat i anàlisi”. Davant del gràfic, feu clic a “Activa” o “Desactiva”.

Llicències

La llicència de Github preveu l’ús de dos tipus principals de
llicència :

1. La GPL és un tipus de llicència que permet a altres usuaris utilitzar el treball d’una altra persona en altres projectes de codi obert. Tanmateix, les empreses comercials no poden fer-ho.
2. LGPL/Commons/MIT/Apache , etc. – l’usuari regala el seu codi per a ús gratuït. Altres poden guanyar diners amb això.

Hem revisat la funcionalitat principal del servei al núvol Github i el programa per treballar amb repositoris Git Bash . Pas a pas hem parlat de com crear un projecte complet en el sistema de control de versions.