diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 4b76c4307824ae32d55062dcb15294e4c4d1e31b..262b9a84a0111790725ee814762b0c7bf4fab437 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -29,7 +29,12 @@ - TĂĄvoli Repository - - [Alapok, SSH kulcs](remote/1_basics.md) + - [Alapok ĂŠs SSH kulcs](remote/1_basics.md) + - [Alapok](remote/1_basics.md?id=alapok) + - [SSH](remote/1_basics.md?id=ssh) + - [SajĂĄt SSH kulcs](remote/1_basics.md?id=sajĂĄt-ssh-kulcs) + - [Linuxon / MacOS-en](remote/1_basics.md?id=linuxon-macos-en) + - [Windowson](remote/1_basics.md?id=windowson) - [Github](remote/2_github.md) - [Issue, merge request, Fork](remote/3_issue_merge_fork.md) diff --git a/docs/remote/1_basics.md b/docs/remote/1_basics.md index 0cf729a6f5b54c25dbb80569b570ee5ad6a0ca9c..3f11b22fcde661d4e3115ccf35a003a30d4ed47a 100644 --- a/docs/remote/1_basics.md +++ b/docs/remote/1_basics.md @@ -1 +1,124 @@ -# Alapok, SSH kulcs +# Alapok ĂŠs SSH kulcs + +### Alapok + +Hogyan lehet a mi `.git` mappĂĄnkat megosztani a nagyvilĂĄggal? + +TĂśbb mĂłdja is van ennek, pĂŠldĂĄul akĂĄr egy .git mappĂĄt +is lelehet magunkhoz klĂłnozni. + +A `git clone <elĂŠrĂŠsi Ăşt>` parancsot hasznĂĄljuk ahhoz, hogy +valahonnan lehĂşzzunk egy git repo-t. + +Ha pĂŠldĂĄul csak egy mappĂĄra utalunk, aminek a neve +`awesome_project.git`: + +``` +$ git clone --bare awesome_project awesome_project.git +Cloning into bare repository 'awesome_project.git'... +done. +``` + +Ezt akĂĄr kirakhatjuk egy fĂĄjlszerverre ĂŠs onnan megoszthatnĂĄnk. + +KĂśvetkezĹ szint, mikor weben keresztĂźl szedjĂźk le a nekĂźnk +kellĹ repo-t. Ilyenkor HTTP protokollt hasznĂĄlhatunk, +ami hasonlĂł az elĹzĹhĂśz ĂŠs olyan, mint mikor egy fĂĄjlt +tĂśltĂźnk le egy oldalrĂłl. + +``` +$ git clone https://github.com/rlacko58/git-presentation.git +Cloning into 'git-presentation'... +remote: Enumerating objects: 173, done. +remote: Counting objects: 100% (173/173), done. +remote: Compressing objects: 100% (114/114), done. +remote: Total 173 (delta 65), reused 155 (delta 47), pack-reused 0 +Receiving objects: 100% (173/173), 291.34 KiB | 1.22 MiB/s, done. +Resolving deltas: 100% (65/65), done. +``` + +Ez szimplĂĄn fogja ĂŠs kĂŠszĂt nekĂźnk egy olyan repository-t, mint +amit az elĹzĹkben csinĂĄltunk kĂŠzzel. +LemĂĄsolja a .git mappĂĄt, majd pedig onnan kiszedi a megfelelĹ +dolgokat a mi `work tree`-nkbe. + +### SSH + +MĂĄsik protokoll amit tudunk hasznĂĄlni az az SSH. +Ez azĂŠrt nagyon jĂł, mert ha ezen keresztĂźl szedĂźnk le, +akkor nem kell minden alkalommal a github, gitlab +felhasznĂĄlĂłnkba belĂŠpnĂźnk egy repo-n valĂł dolgozĂĄskor. + +Ahhoz, hogy ilyet tudjunk csinĂĄlni viszont SSH kulcsot kell +kĂŠszĂtenĂźnk. +Ennek annyi a trĂźkkje, hogy rakunk a sajĂĄt gĂŠpĂźnkre egy +privĂĄt kulcsot ĂŠs a tĂĄvoli szerverre egy publikus kulcsot, +vagy bĂĄrhova ahova szeretnĂŠnk. +EzutĂĄn mikor az adott szerverre felakarunk menni, valamit +csinĂĄlni ott, akkor elĹtte a szerver leauthentikĂĄl minket +ĂŠs egy kulcs csere utĂĄn elkezdhetĂźnk vele kommunikĂĄlni. +Az authentikĂĄciĂł lĂŠpĂŠse nagy vonalakban: + +- Szerver publikus kulcsal letitkosĂt valamit ĂŠs elkĂźldi nekĂźnk +- Ezt amit elkĂźld csak a privĂĄt kulccsal lehet kibontani, + ezt mi elvĂŠgezzĂźk +- A kibontott adatok kĂśzt lesz egy mĂĄsik kulcs, mellyel + titkosĂtva elkĂźldjĂźk a szervernek ami kell az authentikĂĄciĂłhoz +- A szerver kibontja, lĂĄtja hogy minden okĂŠ ĂŠs + megtĂśrtĂŠnik a kulcs csere + +EzutĂĄn ĂĄttĂŠrnek egy mĂĄsik mĂłdszerre amihez mĂĄr mindkĂŠt oldalt +megvan a megfelelĹ kulcs ĂŠs titkosĂtva kĂźldik egymĂĄsnak +az adatokat + +Nagyon kirĂĄly dolog, mivel gyors, hatĂŠkony ĂŠs nem kell +jelszĂłt beĂrogatni minden mĹąvelet kĂśzt + +#### SajĂĄt SSH kulcs + +###### Linuxon / MacOS-en + +1. TerminĂĄlt megnyitjuk +2. GenerĂĄlunk egy SSH kulcsot + `ssh-keygen -t rsa -b 4096` +3. AlapĂŠrtelmezett helyre mentjĂźk +4. Megadunk egy jelszĂłt ha szeretnĂŠnk + _Ha valaki megszerzi a privĂĄt kulcsunk nem tudja hasznĂĄlni + a jelszĂł beĂrĂĄsa nĂŠlkĂźl_ + +Adjuk hozzĂĄ az SSH agent-ĂźnkhĂśz. + +1. ElindĂtjuk az agent-et ha mĂŠg nem ment volna + `$ eval "$(ssh-agent -s)"` + `Agent pid 59566` +2. HozzĂĄadjuk az Ăşj kulcsunk + `ssh-add ~/.ssh/id_rsa` + +VĂŠgezetĂźl a publikus kulcsot feltĂśltjĂźk pĂŠldĂĄul githubra + +A publikus kulcs helye: `~/ssh/id_rsa.pub` + +###### Windowson + +1. Git Bash-t megnyitjuk +2. GenerĂĄlunk egy kulcsot + `ssh-keygen -t rsa -b 4096` +3. ElmentjĂźk az alapĂŠrtelmezett helyre +4. JelszĂł adunk hozzĂĄ ha szeretnĂŠnk + +HozzĂĄ adjuk az SSH agent-ĂźnkhĂśz + +1. ElindĂtjuk az agent-et ha mĂŠg nem ment volna + `$ eval $(ssh-agent -s)` + `> Agent pid 59566` +2. HozzĂĄadjuk az Ăşj kulcsunk + `ssh-add ~/.ssh/id_rsa` + +VĂŠgezetĂźl a publikus kulcsot feltĂśltjĂźk pĂŠldĂĄul githubra + +A publikus kulcs helye: `~/ssh/id_rsa.pub` + +ForrĂĄs: [docs.github.com](https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) + +[ElĹzĹ](workshop/3_branch?id=branch-ek-elĂĄgazĂĄs) | +[KĂśvetkezĹ](remote/2_github) diff --git a/docs/workshop/2_basics.md b/docs/workshop/2_basics.md index d4a28b332a6586a7d02b4f3df881fcb4deb4fcf4..b1f099dd1fdd1ce90e7d2c9f48b8a7647c2f0b89 100644 --- a/docs/workshop/2_basics.md +++ b/docs/workshop/2_basics.md @@ -487,4 +487,4 @@ ElĂŠg csak pĂĄr karakter, hogy beazonosĂtsunk pĂŠldĂĄul egy commitot a hash-ĂŠvel. [ElĹzĹ](workshop/1_installation?id=telepĂtĂŠs-ĂŠs-konfigurĂĄciĂł) | -[KĂśvetkezĹ](workshop/3_branch) +[KĂśvetkezĹ](workshop/3_branch?id=branch-ek-elĂĄgazĂĄs) diff --git a/docs/workshop/3_branch.md b/docs/workshop/3_branch.md index a955d0bea3455e2845c632d3c2bff4ef5d4b1e9b..e3d02104d4981b6489c25bee9edb769937c0dbf4 100644 --- a/docs/workshop/3_branch.md +++ b/docs/workshop/3_branch.md @@ -475,4 +475,4 @@ megoldani. Semmi extra effortot nem fog igĂŠnyelni egy hasonlĂł elvĂŠgzĂŠse. [ElĹzĹ](workshop/2_basics?id=alapok) | -[KĂśvetkezĹ](remote/1_basics) +[KĂśvetkezĹ](remote/1_basics?id=alapok-ĂŠs-ssh-kulcs)