Joan: /* Resum projecte La Palma */

2021-10-20T08:50:10Z

Resum projecte La Palma

Joan: /* Resum pràctic */

2021-10-16T11:30:31Z

Resum pràctic

Joan: /* Resum pràctic */

2020-04-05T23:11:39Z

Resum pràctic

Pàgina nova

__TOC__
=Introducció=
La manera com hem fet servir Github 1000 vegades és descarregar un projecte públic:
<pre>
$ git clone [url]
Clone (download) a repository that already exists on
GitHub, including all of the files, branches, and commits
</pre>
Però el que volem és estudiar el flux de treball i el versionat de projectes, amb comandes de la consola, i sincronitzar-ho tot a Github.com.

El primer que necessitem evidentment és un compte a Github.com:
*https://github.com/joanillo
(joanillo/jq********)

=Referències=
*https://guides.github.com/activities/hello-world/

Github Cheat Sheet:
*https://github.github.com/training-kit/downloads/github-git-cheat-sheet.pdf

=Github pràctic=
Farem un cas pràctic del cicle de vida d'un projecte de Github.

Dels diferents documents que he seguit, em baso principalment amb:
*https://ourcodingclub.github.io/tutorials/git/

#Farem un projecte de prova, i crearem un repositori de prova a github.com. Un possible flux de treball seria:
#Estic treballant en un projecte, en local
#Des de la línia de comandes, crear el git local per versionar el projecte.
#Des de la línia de comandes, o des de github.com, crear el projecte i repositori a github.com
#Treballem en el projecte amb la branca master, i pugem els canvis a la branca master.
#Creem una nova branca.
#Sincronitzem aquesta branca a github.com
#Treballem en la nova branca
#Comparar les dues branques en local
#Fem un merge en local
#etc

Treballarem en el projecte '''git_test'''. Segueixo la part del tutorial que diu: ''Below is a quick exercise so you can familiarise yourself with these command line tools.''

git commit -m "first commit"
<pre>
$ mkdir git_test
cd git_test
</pre>
I ja podem crear un repositori Git sobre aquest directori:
<pre>
$ git init
</pre>
El primer que farem és crear un fitxer (README.md) i veure com poder controlar les seves versions:
<pre>
$ joe README.md (editem el fitxer)
$ git add README.md
</pre>
Acabem d'afegir aquest fitxer a la ''staging area'', però encara no n'hem fet un commit al repositori. Per fer el '''commit''':
<pre>
$ git commit
millor
git commit -m "first commit"
</pre>

Ara al remot Github.com haurem de crear el repositori ''git_test''. Ho fem directament a
*https://github.com/joanillo
I ara ja podem definir un origen remot amb el qual ens sincronitzarem:
<pre>
$ git remote add origin https://github.com/joanillo/git_test.git
</pre>
I ara ja podem fer un push per sincronitzar el nostre directori local amb el remot. De moment, l'únic que tenim és el fitxer ''README.me''. Ens demana el login i password, com és lògic.
<pre>
$ git push -u origin master
</pre>
Podem comprovar en el remot ''github.com/joanillo/git_test'' que tenim aquest fitxer.

Continuem fent més edicions, i les sincronitzem amb el remot:
<pre>
$ joe fitxer1
$ joe fitxer2

$ git add . -> posem tots els fitxers del local en el staged area
$ git commit -m "canvi 2" -> fem un commit de tots els fitxers, a punt per sincronitzar
$ git push -u origin master -> sincronitzem
</pre>
Ara faig un canvi en el fitxer2 de github.com, i el gravo. És a dir, faig un canvi en el remot. Si vull tenir els canvis en local, he de fer git pull:
<pre>
$ git pull
$ joe fitxer2 -> veig en local el canvi que he fet en remot.
</pre>
En un projecte col·laboratiu, abans de fer un commit s'ha de fer un pull, doncs podria ser que mentre hem estat treballant també hi hagi gent que ha retocat els fitxers del remot.

Fins ara he treballat en una sola branca. Ara vull crear una nova branca, en local. Per crear la branca i automàticament canviar a aquesta branca:
<pre>
$ git checkout -b [name_of_your_new_branch]https://ourcodingclub.github.io/tutorials/git/
$ git checkout -b branca_nova
</pre>
(l'opció -b és per crear. Si només vull canviar només s'ha de fer '''git checkout <branca>'''. Per saber totes les opcions:
<pre>
$ git checkout --help
</pre>
I ara fem el push d'aquesta branca a github.com:
<pre>
$ git push origin [name_of_your_new_branch]
$ git push origin branca_nova
</pre>
i efectivament, al remot tenim la nova branca

Per saber les branques que tinc: (amb * surt la branca actual)
<pre>
$ git branch -a
* branca_nova -> local (branca actual)
master -> local
remotes/origin/branca_nova -> remot Github.com
remotes/origin/master -> remot Github.com
</pre>
Fem canvis a fitxer2:
<pre>
$ git commit -a
$ git commit -a -m "commit sense fer add ni stagina area"
$ git push origin branca_nova
</pre>
Fem els canvis amb l'opició '''-a'''. Compte perquè l'opció -a només serveix per fer el stage dels canvis que s'han modificat i esborrat, però no dels fitxers nous. La idea de la -a és ''add changes'', però no pas afegir fitxers nous.
<pre>
$ git commit --help
</pre>
I ara ja puc veure com el ''fitxer2'' té versions diferents en la branca ''master'' i en la ''branca_nova''.

Per veure les diferències entre les dues branques:
<pre>
$ git diff master branca_nova
</pre>
I ara vull incorporar a la branca ''master'' els canvis que he fet en la ''branca_nova''.

Primer canvio a la branca master:
<pre>
$ git checkout master
</pre>
(comprovar fent joe fitxer2)

Faig el merge de la ''branca_nova'' a la branca ''master'' (la branca actual)
<pre>
$ git merge branca_nova
</pre>
(comprovar fent joe fitxer2)

I ara ja puc actualitzar la branca master del remot:
<pre>
$ git commit -a -m "he fet el merge de branca_nova"
$ git push origin master
</pre>
És a dir, el merge el faig en local. Tant en local com en remot tinc el control de versions (tot i que no es visualitza en carpetes).

Per tant, quan creo una nova versió d'un projecte, no s'ha de crear una carpeta, sinó que n'hi ha prou en crear una branca.

Ara continuo desenvolupant. Puc crear una nova branca, o continuar treballant amb la ''branca_nova'', que considero de desenvolupament. És a dir, la branca ''master'' es considera que és la branca de producció, i la ''branca_nova'' de desenvolupament.
<pre>
$ git checkout branca_nova
</pre>
creo dos fitxers
<pre>
$ joe fitxer3
$ joe fitxer.pdf
</pre>
Els fitxers ''pdf'' vull que siguin ignorats, així com el fitxer ocult ''.pwd'' i els fitxers temporals que acaben amb ''~''.

The '''.gitgnore''' file:
<pre>
Sometimes it may be a good idea to exclude files from being
tracked with Git. This is typically done in a special file named
.gitignore . You can find helpful templates for .gitignore
files at github.com/github/gitignore
</pre>
'''.gitignore''' es crea en la carpeta principal:
<pre>
$ joe .gitignore

# Prevent users to commit password
.pwd
# Temporary files
*~
#pdf files
*.pdf
</pre>
I sincronitzem els canvis al remot:
<pre>
$ git add .
$ git commit -m "provo gitignore"
$ git push origin branca_nova
</pre>
I ara efectivament a Github.com ja tinc el fitxer3, però el pdf no s'ha pujat.

Explicació de la '''staging area''':
*https://dev.to/sublimegeek/git-staging-area-explained-like-im-five-1anh
Imagine a box. You can put stuff into the box. You can take stuff out of the box. This box is the ''staging area'' of Git. You can craft commits here. Committing is like sealing that box and sticking a label on it. The contents of that box are your changes. So, why not have the label mean something? You wouldn’t label a moving box with kitchen items as simply ''stuff''.

Diferència entre treballar amb la staging area o fer-ho directament:

<pre>
$ git add .
$ git commit -m "provo gitignore"
</pre>
Poso els fitxers del working Dir a la staging area. Faig el commit en el git local, segello els canvis (abans de sincronitzar amb github.com, o no)

<pre>
$ git commit -a -m "provo gitignore"
</pre>
Poso els fitxers del ''working Dir'' directament al ''commit'' local (però compte, només els fitxers canviats i esborrats, no pas els nous).

=Resum pràctic=
1. crear el repositori a github.com (amb el mateix nom que la carpeta de treball en local)

2. en local:
<pre>
git init
joe README.md
joe .gitignore
</pre>
Per ex:
<pre>
# Temporary files
*~
#Ignore folders
python/previ1
python/previ2
python/previ3
</pre>

3. Vincular el remot
<pre>
git remote add origin https://github.com/joanillo/fusionar_geojson.git
</pre>

4. Afegir fitxers al stage area i fem el commit:
<pre>
git add .
git commit -m "commit1"
</pre>
5. Vull pujar al remot (he tingut un problema, perquè en el remote hi ha el fitxer de LICENCE, i per tant s'ha de fer un pull, però em diu no sé què de unrelated-histories). Ho soluciono fent:
<pre>
git pull --allow-unrelated-histories origin master
</pre>
6. Pujo al remot:
<pre>
git push -u origin master
</pre>
Ara si més no tinc una còpia de seguretat del projecte, amb una sola branca.

A partir d'aquí podem tenir una branca de desenvolupament i una branca de producció.

{{Autor}}, abril 2020

@@ Línia 305: / Línia 305: @@
 git branch -M main
 git push -u origin main -> compte! ara en el password he de posar el personal access token
 </pre>
 {{Autor}}, abril 2020

← Versió més antiga		Revisió del 11:30, 16 oct 2021
Línia 246:		Línia 246:
	A partir d'aquí podem tenir una branca de desenvolupament i una branca de producció.		A partir d'aquí podem tenir una branca de desenvolupament i una branca de producció.

		+	=Resum projecte La Palma=
		+	Primer de tot, creo un repositori buit en el Github:
		+	*https://github.com/joanillo/la_palma_volcano_resort
		+
		+	També creo el fitxer .gitignore:
		+	<pre>
		+	propietat_guanyat_al_mar_legal.txt
		+	FAQS.txt
		+	llegir.txt
		+	llegir_github.txt
		+
		+	# passwords
		+	html/php/.pwd
		+	nodejs/.pwd
		+
		+	# node modules i dist
		+	html/node_modules
		+	html/dist
		+
		+	# Temporary files
		+	*~
		+	</pre>
		+	La primera vegada:
		+	<pre>
		+	cd ~/projectes/OSM/la_palma
		+	echo "LA PALMA VOLCANO RESORT" >> README.md
		+	echo "=======================" >> README.md
		+	git init
		+	git add README.md
		+
		+	git add SQL/
		+	git add html/
		+	git add img/
		+	git add nodejs/
		+	git add versions.txt
		+	git add .gitignore
		+
		+
		+	git commit -m "211016"
		+	git branch -M main
		+	git remote add origin https://github.com/joanillo/la_palma_volcano_resort.git
		+
		+	git branch -M main
		+	git push -u origin main -> compte! ara en el password he de posar el personal access token
		+
		+	remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
		+	</pre>
		+	Ja no podem fer l'autenticació amb login i password
		+
		+	Creating a personal access token:
		+	*https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token
		+
		+	github personal access token: **
		+
		+	I la següent vegada que vulgui fer un commit:
		+	<pre>
		+	git commit -a -m "211016c"
		+	git branch -M main
		+	git push -u origin main -> compte! ara en el password he de posar el personal access token
		+	</pre>
	{{Autor}}, abril 2020		{{Autor}}, abril 2020

Github pràctic: control de versions - Historial de revisió

Joan: /* Resum projecte La Palma */

Joan: /* Resum pràctic */

Joan: /* Resum pràctic */