Prečo zdieľať archívy zdrojového kódu odkazom namiesto e-mailu?
Malý súbor sa do e-mailu môže zmestiť. Zdrojový kód aplikácie, obrázky a balíky už nie. Gmail neprijíma prílohy nad 25 MB a Outlook neprijíma prílohy nad približne 20 MB. E-mail môže archív odmietnuť aj z bezpečnostných dôvodov, ak obsahuje spustiteľné súbory, napríklad .exe alebo .js.
Ak kód rozdelíte do viacerých správ, príjemca dostane neúplný projekt. Zdieľaný disk si vyžaduje účet a trvalý prístup. Odkaz umožňuje príjemcovi stiahnuť si kópiu kódu v obmedzenom čase. Nie je to priestor na spoločnú prácu na kóde.
Kópia, ktorú si príjemca otvorí, by mala obsahovať súbory, ktoré ste vybrali.
| Spôsob | Ako funguje | Vhodnosť pre zdrojový kód |
|---|---|---|
| Príloha v službe Gmail alebo Outlook | Prílohy nad 20–25 MB nemožno odoslať | Nevhodné |
| Rozdelenie do viacerých e-mailov | Chýbajúce súbory narušia fungovanie projektu | Nevhodné |
| Zdieľaný disk | Vyžaduje účet a trvalý prístup | Používajte obozretne |
| Hosting repozitára | Uchováva predchádzajúce verzie a revízie kódu | Nenahrádza odovzdanie súborov |
| Odkaz cez SendGB | Kód sa nekompiluje ani neodosiela ako príloha | Vhodné na odovzdanie súborov |
Príklad vyššie ukazuje odovzdanie súborov v rámci bezplatného limitu: archív ZIP s aplikáciou, fotografie produktov, poznámky k inštalácii a prázdny vzorový konfiguračný súbor. Tento príklad neobsahuje priečinok so závislosťami.
Odoslanie repozitára alebo presunutie priečinka
Repozitár obsahuje kód a jeho predchádzajúce verzie. Spravuje ich Git. Neposkytujeme hosting repozitárov. Nepridávame nové verzie, neukladáme revízie kódu ani nepíšeme poznámky k vydaniam.
Kópiu vytvárate vy. Ak nechcete zahrnúť históriu, vytvorte si archív sami. V nástroji Git na to slúži príkaz git archive. Ak chcete mať históriu v jednom súbore, použite git bundle. Tieto príkazy nespúšťame. Repozitáre neklonujeme.
Priečinok so zdrojovým kódom môžete preniesť aj tak, že ho presuniete do poľa na nahrávanie v pôvodnej podobe. Pri stiahnutí celého prenosu sa názvy priečinkov zachovajú. Súbory znova nekomprimujeme. Kliknutím na jednotlivý súbor sa priečinok nevytvorí znova. Prázdne priečinky sa nenahrávajú.
| Ako priečinok | Vami vytvorený archív ZIP | |
|---|---|---|
| Najvhodnejšie pre | Malý počet zdrojových súborov | Veľa súborov alebo odovzdanie v jednom súbore |
| História | Zahrnie sa, ak pridáte .git | Zahrnie sa, ak ju pridáte do archívu |
| Počet súborov | 500 alebo 2 500 so službou SendGB Extra | Zvyčajne jeden súbor |
| Inštalácia | Príjemca si ju vykoná sám | Archív ZIP neotvárame |
| Čo robíme my | Kód nekompilujeme | Archívy nespájame |
Náš balík na stiahnutie nie je repozitár Git. Príjemca ho nemôže otvoriť ako repozitár. Ak má ísť o repozitár, pripravte si archív sami pomocou vlastného nástroja.
Čo by ste mali priložiť?
Samotný zdrojový kód nestačí. Musíte tiež určiť, ktoré verzie balíkov sa majú nainštalovať. Tajné kľúče by ste nemali prikladať.
| Súbor | Účel | Čo sa stane bez neho |
|---|---|---|
| Zdrojové súbory | Samotná aplikácia | Nie je čo nainštalovať |
| Súbor so zamknutými verziami závislostí | Určuje verzie balíkov | Príjemca môže nainštalovať inú verziu |
| Poznámky k inštalácii | Príkazy a verzie | Pri inštalácii treba hádať |
| Vzorová konfigurácia | Názvy polí s prázdnymi hodnotami | Omylom sa môžu odoslať tajné kľúče |
| Obrázok produktu | Potrebný, ak je uložený mimo zdrojových súborov | Stránka sa otvorí prázdna |
Súbor so zamknutými verziami závislostí, napríklad package-lock.json alebo composer.lock, určuje, ktoré verzie sa majú nainštalovať. Pridávate ho vy. Balíky neinštalujeme.
Priečinok so závislosťami obsahuje hotové balíky, ktoré si projekt stiahol. Príkladmi sú node_modules a vendor. Vo väčšine projektov sú v nich tisíce malých súborov. Bezplatný limit je 500 súborov. To nestačí. Odstráňte tento priečinok. Príjemca si balíky nainštaluje sám pomocou príkazu z vašich poznámok.
Ak sa v priečinku nachádza .env a súkromné kľúče, odošlú sa príjemcovi. Neodstraňujeme ich. Pridajte prázdny súbor .env.example. Do odkazu nevkladajte hodnoty. Heslo odošlite oddelene od odkazu. Heslo archívu ZIP je samostatné. Nekontrolujeme ani licencie. Neprikladajte balík, ktorý nemožno legálne šíriť.
Informácie o zachovaní štruktúry priečinkov pri sťahovaní nájdete v návode na prenos priečinkov. Ak chcete odoslať repozitár v archíve ZIP bez jeho otvorenia, pozrite si návod na prenos archívov ZIP. Záloha databázy nie je súčasťou kódu. Odošlite ju samostatne podľa návodu na prenos záloh databáz.
Stačí 5 GB a 500 súborov?
Zdrojový text býva často malý. Obrázky, priečinky so závislosťami a dlhoročná história zvyšujú veľkosť aj počet súborov. Bezplatné prenosy sú obmedzené na 5 GB a 500 súborov. Ak prekročíte ktorýkoľvek z týchto limitov, súbor nemožno odoslať.
Vytvorenie ďalšieho archívu ZIP s kódom veľkosť výrazne nezníži, ak sú obrázky vnútri už skomprimované. Obyčajný text sa môže kompresiou zmenšiť. Kompresiu zabezpečujete vy. Archív ZIP neotvárame ani znova nekomprimujeme.
| Čo odosielate | V praxi | Ktorá možnosť stačí |
|---|---|---|
| Zdrojový kód a súbor so zamknutými verziami závislostí | Málo súborov, menej ako 5 GB | Zadarmo; až 90 dní do 250 MB, nad touto hranicou 7 dní |
| Projekt s obrázkami | Môže mať niekoľko GB | Zadarmo, ak sa zmestí do limitov; inak SendGB Extra |
| Priečinok so závislosťami ako jednotlivé súbory | Tisíce malých súborov | Narazí na limit 500 alebo 2 500 súborov; vytvorte archív ZIP alebo ho vynechajte |
Dlhoročná história .git | Veľa súborov alebo jeden veľký archív | SendGB Extra, 500 GB na prenos |
| Jeden archív nad 500 GB | Zriedkavé | SendGB Exceed, až 1 TB |
Cena predplatného SendGB Extra sa začína na 29,90 € ročne. Zahŕňa úložisko s kapacitou 1 TB. SendGB Extra uchováva súbory až 1 rok. Limit na jeden prenos je 500 GB a 2 500 súborov. Hodí sa pre tímy, ktoré často odovzdávajú veľké archívy.
SendGB Exceed nevyžaduje členstvo. Prenos s veľkosťou 1 TB stojí 9,99 €. Kód možno použiť raz a platí 1 rok. Odkaz je dostupný 7 dní. Limit počtu súborov je 2 500. Stačí na príležitostné odoslanie jedného archívu nad 500 GB. V jednom prenose nedokážeme odoslať viac ako 1 TB.
Ak zadáte svoju e-mailovú adresu, pri začatí sťahovania dostanete jedno oznámenie. Pri odoslaní e-mailom dostanete jedno oznámenie za každého príjemcu. Pri zdieľaní odkazom dostanete jedno oznámenie za každý prenos. Ak tá istá osoba začne sťahovať znova, ďalší e-mail sa neodošle. Oznámenie nepotvrdzuje, že bol celý kód stiahnutý, nainštalovaný alebo nasadený.
Ako odoslať súbory
- 1
Pridajte archív
Pridajte pripravený archív ZIP alebo priečinok s kódom do poľa na nahrávanie. Vynechajte priečinok so závislosťami a súbor s tajným kľúčom. Bezplatný limit je spolu 5 GB a 500 súborov. Ak prekročíte ktorýkoľvek z týchto limitov, potrebujete SendGB Extra alebo SendGB Exceed.
- 2
Odošlite odkaz
Odošlite odkaz na e-mailovú adresu príjemcu alebo ho skopírujte do správy. Pri kóde s uzavretým zdrojom pridajte heslo. Heslo odošlite oddelene od odkazu. Ak zadáte svoju e-mailovú adresu, pri začatí sťahovania dostanete jedno oznámenie.
- 3
Príjemca si stiahne súbory
Príjemca si súbory stiahne cez odkaz bez zakladania účtu. Na stránke kód nekompilujeme. Príjemca si otvorí archív ZIP na vlastnom počítači a sám si nainštaluje balíky. Bezplatné prenosy do 250 MB sú dostupné až 90 dní. Bezplatné prenosy nad 250 MB sú dostupné 7 dní. SendGB Extra uchováva súbory až 1 rok.
Čo sa deje s vaším súborom?
- Vaše súbory ponechávame bez zmien. Archívy neotvárame, kód nekompilujeme a testy nespúšťame.
- Archívy ZIP, priečinky a súbory so zamknutými verziami závislostí sa stiahnu v pôvodnej podobe.
- Pri stiahnutí celého prenosu sa názvy priečinkov zachovajú. Súbory znova nekomprimujeme.
- Ak zadáte svoju e-mailovú adresu, dostanete jedno oznámenie, keď niekto začne sťahovať.
Čo nerobíme
- Neposkytujeme hosting repozitárov. Neukladáme históriu, vetvy ani revízie kódu.
- Neinštalujeme balíky. Neodstraňujeme tajné kľúče ani súbory .env.
- Bezplatné prenosy sú obmedzené na 500 súborov. SendGB Extra a SendGB Exceed umožňujú až 2 500 súborov.
- Oznámenie o sťahovaní neznamená, že kód bol nainštalovaný alebo nasadený.
Často kladené otázky
Čo je archív zdrojového kódu?
Je to kópia projektu, ktorú si iná osoba môže otvoriť na vlastnom počítači. Repozitár obsahuje kód a jeho predchádzajúce verzie. Spravuje ich Git. Neposkytujeme hosting repozitárov. Vy odošlete súbor alebo priečinok. Príjemca si ho stiahne.
Nahrádza SendGB službu GitHub?
Nie. Nie je tu história verzií, revízia kódu ani spoločná práca na kóde. Odkaz umožňuje príjemcovi stiahnuť si kópiu kódu. Neposkytujeme hosting aktívneho repozitára.
Môžem odoslať node_modules alebo vendor?
Áno, ak ich pridáte a zmestia sa do limitov. Tieto priečinky obsahujú hotové balíky. Vo väčšine projektov sú v nich tisíce malých súborov. Bezplatné prenosy sú obmedzené na 500 súborov a SendGB Extra aj SendGB Exceed na 2 500 súborov. Priečinok, ktorý prekračuje limit, nemožno zahrnúť do prenosu. Odstráňte priečinok so závislosťami. Súbor so zamknutými verziami závislostí určuje, ktoré verzie sa majú nainštalovať. Inštalačný príkaz nespúšťame.
Môžem odoslať aj históriu verzií?
Ak pridáte priečinok .git, odošle sa aj história obsiahnutá v tejto kópii. Aj tento priečinok môže obsahovať veľa súborov. Ak históriu nechcete odoslať, vytvorte si archív sami. V nástroji Git na to slúži príkaz git archive. Ak chcete históriu odoslať v jednom súbore, použite git bundle. Tieto príkazy nespúšťame. Repozitáre neklonujeme.
Odstráni sa súbor .env?
Nie. Tajné kľúče, heslá ani súbory .env nijako neupravujeme. Ak ich zahrniete do priečinka, odošlú sa príjemcovi. Namiesto nich pridajte prázdny súbor .env.example. Do odkazu nevkladajte skutočné hodnoty. Heslo odošlite oddelene od odkazu. Nekontrolujeme ani licencie.
Môže si príjemca prezrieť kód na stránke?
Na stránke nie je editor kódu. Kód sa nekompiluje. Archívy ZIP sa neotvárajú. Krátku poznámku vo formáte .txt, .md alebo .json možno otvoriť. Príjemca si kód otvorí na vlastnom počítači. Na stiahnutie nepotrebuje účet. Prehliadač môže pri sťahovaní súborov .js alebo .exe zobraziť upozornenie. Toto upozornenie nevypíname. Súbor neskenujeme.
Musím použiť archív ZIP?
Nie. Môžete odoslať aj priečinok. Pri stiahnutí celého prenosu sa názvy priečinkov zachovajú. Súbory znova nekomprimujeme. Kliknutím na jednotlivý súbor sa priečinok nevytvorí znova. Ak máte veľa malých súborov, jeden archív ZIP je bezpečnejšia voľba. Rozdelené archívy nespájame. Ak má archív ZIP vlastné heslo, zodpovednosť zaň zostáva na vás.
Prečo Gmail neprijme archív?
Gmail neprijíma prílohy nad 25 MB a Outlook neprijíma prílohy nad približne 20 MB. Zdrojový kód, obrázky a balíky tieto limity prekračujú. E-mail môže archív odmietnuť aj preto, že obsahuje spustiteľný súbor. Odkaz nie je príloha. Nepotrebujete žiadny doplnok.
Dostanem oznámenie, keď príjemca začne sťahovať?
Áno, ak zadáte svoju e-mailovú adresu. Pri odoslaní e-mailom dostanete jedno oznámenie za každého príjemcu. Pri zdieľaní odkazom dostanete jedno oznámenie za každý prenos. Oznámenie vás informuje, že sa sťahovanie začalo. Nepotvrdzuje, že bol stiahnutý celý súbor. Neznamená ani to, že bol kód nainštalovaný.
Aký limit prenosu potrebujem?
Archív s veľkosťou pod 5 GB a počtom súborov pod 500 možno odoslať zadarmo. Bezplatné prenosy do 250 MB sú dostupné až 90 dní. Bezplatné prenosy nad 250 MB sú dostupné 7 dní. Na odosielanie väčších objemov potrebujete SendGB Extra: 500 GB na prenos, 2 500 súborov, úložisko s kapacitou 1 TB, cena od 29,90 € ročne. SendGB Extra uchováva súbory až 1 rok. Na jeden archív nad 500 GB stačí SendGB Exceed: bez členstva, 2 500 súborov a 9,99 € za prenos s veľkosťou 1 TB. Kód možno použiť raz a platí 1 rok. Odkaz je dostupný 7 dní. Viac ako 1 TB sa do jedného prenosu nezmestí.
Odošlite odkaz na stiahnutie, nie zdrojový kód v prílohe
Zdrojový kód a súbor so zamknutými verziami závislostí sa často zmestia do 5 GB. Priečinky so závislosťami a dlhoročná história môžu prekročiť limit počtu súborov. SendGB Extra zvládne väčšie archívy do 500 GB a SendGB Exceed až 1 TB v jednom prenose.
Začať odosielať