Proč sdílet archivy zdrojového kódu odkazem místo e-mailu?
Malý soubor se do e-mailu vejít může. Zdrojový kód aplikace, obrázky a balíčky už ne. Gmail nepřijímá přílohy větší než 25 MB a Outlook přílohy větší než přibližně 20 MB. E-mailová služba může archiv z bezpečnostních důvodů odmítnout také tehdy, když obsahuje spustitelné soubory, například .exe nebo .js.
Když kód rozdělíte do více zpráv, příjemce dostane neúplný projekt. Sdílený disk znamená účet a trvalý přístup. Odkaz umožňuje příjemci stáhnout kopii kódu po omezenou dobu. Není to prostor pro společné programování.
Kopie, kterou příjemce otevře, by měla obsahovat soubory, které jste vybrali.
| Způsob | Jak to funguje | Vhodnost pro zdrojový kód |
|---|---|---|
| Příloha v Gmail nebo Outlook | Přílohy větší než 20–25 MB nelze odeslat | Nevhodné |
| Rozdělení do několika e-mailů | Chybějící soubory naruší funkčnost projektu | Nevhodné |
| Sdílený disk | Vyžaduje účet a trvalý přístup | Používejte obezřetně |
| Hosting repozitářů | Uchovává předchozí verze a revize kódu | Nenahrazuje předání souborů |
| Odkaz SendGB | Kód se nekompiluje ani neodesílá jako příloha | Vhodné pro předání souborů |
Výše uvedený příklad se vejde do bezplatného limitu: ZIP s aplikací, produktové fotografie, pokyny k instalaci a prázdný vzorový konfigurační soubor. Tento příklad neobsahuje složku závislostí.
Odeslání repozitáře, nebo přetažení složky?
Repozitář uchovává kód a jeho předchozí verze. O jejich správu se stará Git. Hosting repozitářů neposkytujeme. Nepřidáváme nové verze, neukládáme revize kódu ani nepíšeme poznámky k vydání.
Kopii vytváříte vy. Pokud nechcete zahrnout historii, vytvořte archiv sami. V Gitu k tomu slouží příkaz git archive. Pokud chcete mít historii v jediném souboru, použijte git bundle. Tyto příkazy nespouštíme. Repozitáře neklonujeme.
Složku se zdrojovým kódem můžete přenést i pouhým přetažením v její stávající podobě. Při stažení celého přenosu zůstanou názvy složek zachovány. Soubory znovu nekomprimujeme. Kliknutím na jednotlivý soubor se složka znovu nevytvoří. Prázdné složky se nenahrávají.
| Jako složka | Vlastní archiv ZIP | |
|---|---|---|
| Nejvhodnější pro | Malý počet zdrojových souborů | Mnoho souborů nebo předání v jediném souboru |
| Historie | Zahrnuta, pokud přidáte .git | Zahrnuta, pokud ji přidáte do archivu |
| Počet souborů | 500 nebo 2 500 se SendGB Extra | Obvykle jeden soubor |
| Instalace | Příjemce si vše nainstaluje sám | ZIP neotevíráme |
| Co děláme my | Nekompilujeme kód | Neslučujeme archivy |
Náš balíček ke stažení není repozitář Gitu. Příjemce ho nemůže otevřít jako repozitář. Pokud má jít o repozitář, připravte archiv sami pomocí vlastního nástroje.
Co byste měli přidat?
Samotný zdrojový kód nestačí. Je také potřeba určit, které verze balíčků se mají nainstalovat. Tajné klíče by součástí být neměly.
| Soubor | Účel | Co se stane, když chybí |
|---|---|---|
| Zdrojové soubory | Samotná aplikace | Není co instalovat |
| Soubor se zafixovanými verzemi | Určuje verze balíčků | Příjemce může nainstalovat jinou verzi |
| Pokyny k instalaci | Příkazy a verze | Při instalaci nezbývá než hádat |
| Vzorová konfigurace | Názvy polí s prázdnými hodnotami | Může dojít k nechtěnému odeslání tajných klíčů |
| Produktový obrázek | Potřebný, pokud je uložen mimo zdrojový kód | Stránka se otevře prázdná |
Soubor se zafixovanými verzemi, například package-lock.json nebo composer.lock, určuje, které verze se mají nainstalovat. Přidáváte ho sami. Balíčky neinstalujeme.
Složka závislostí obsahuje hotové balíčky, které si projekt stáhl. Příkladem jsou node_modules a vendor. Ve většině projektů obsahují tisíce malých souborů. Bezplatný limit je 500 souborů. To nestačí. Složku odeberte. Příjemce si balíčky nainstaluje sám pomocí příkazu ve vašich pokynech.
Pokud jsou ve složce .env a soukromé klíče, dostanou se k příjemci. Neodstraňujeme je. Přidejte prázdný soubor .env.example. Hodnoty do odkazu nevkládejte. Heslo odešlete odděleně od odkazu. Heslo k archivu ZIP je samostatné. Nekontrolujeme ani licence. Nepřidávejte balíček, který nelze legálně šířit.
Jak se při stahování zachovává struktura složek, najdete v návodu na přenos složek. Postup pro odeslání repozitáře ve formátu ZIP bez jeho otevření najdete v návodu na přenos archivů ZIP. Záloha databáze není součástí kódu. Odešlete ji samostatně podle návodu na sdílení záloh databází.
Stačí 5 GB a 500 souborů?
Samotný text zdrojového kódu bývá malý. Obrázky, složky závislostí a mnohaletá historie zvyšují velikost i počet souborů. Bezplatné přenosy mají limit 5 GB a 500 souborů. Pokud překročíte kterýkoli z těchto limitů, soubor nelze odeslat.
Vytvoření dalšího archivu ZIP s kódem velikost příliš nezmenší, pokud už jsou obrázky uvnitř komprimované. Prostý text se kompresí zmenšit může. Kompresi provádíte vy. ZIP neotevíráme ani znovu nekomprimujeme.
| Co odesíláte | V praxi | Která možnost stačí |
|---|---|---|
| Zdrojový kód a soubor se zafixovanými verzemi | Málo souborů, méně než 5 GB | Zdarma; až 90 dní do 250 MB, nad tuto velikost 7 dní |
| Projekt s obrázky | Může mít několik GB | Zdarma, pokud se vejde do limitů; jinak SendGB Extra |
| Složka závislostí jako jednotlivé soubory | Tisíce malých souborů | Narazí na limit 500 nebo 2 500 souborů; zabalte ji do ZIP nebo ji vynechte |
Mnohaletá historie .git | Mnoho souborů nebo jeden velký archiv | SendGB Extra, 500 GB na přenos |
| Jeden archiv větší než 500 GB | Výjimečný případ | SendGB Exceed, až 1 TB |
Předplatné SendGB Extra začíná na 29,90 € ročně. Zahrnuje 1 TB úložiště. SendGB Extra uchovává soubory až 1 rok. Limit na přenos je 500 GB a 2 500 souborů. Hodí se pro týmy, které často předávají velké archivy.
SendGB Exceed nevyžaduje členství. Přenos o velikosti 1 TB stojí 9,99 €. Kód lze použít jednou a platí 1 rok. Odkaz je dostupný 7 dní. Limit počtu souborů je 2 500. Stačí na občasné odeslání jednoho archivu většího než 500 GB. Více než 1 TB v jednom přenosu odeslat nemůžeme.
Pokud zadáte svou e-mailovou adresu, dostanete jedno oznámení při zahájení stahování. Při odeslání e-mailem dostanete jedno oznámení za každého příjemce. Při sdílení odkazem dostanete jedno oznámení za každý přenos. Pokud stejná osoba stáhne soubory znovu, další e-mail se neodešle. Oznámení nepotvrzuje, že byl veškerý kód stažen, nainstalován nebo nasazen.
Jak odeslat soubory
- 1
Přidejte archiv
Přidejte připravený ZIP nebo složku s kódem do pole pro nahrávání. Vynechte složku závislostí a soubor s tajným klíčem. Bezplatný limit je celkem 5 GB a 500 souborů. Pokud překročíte kterýkoli z těchto limitů, potřebujete SendGB Extra nebo SendGB Exceed.
- 2
Odešlete odkaz
Odešlete odkaz na e-mailovou adresu příjemce nebo ho zkopírujte do zprávy. U neveřejného zdrojového kódu přidejte heslo. Heslo odešlete odděleně od odkazu. Pokud zadáte vlastní e-mailovou adresu, dostanete jedno oznámení při zahájení stahování.
- 3
Příjemce si stáhne soubory
Příjemce si stáhne soubory přes odkaz bez zakládání účtu. Kód na stránce nekompilujeme. Příjemce otevře ZIP na svém počítači a balíčky si nainstaluje sám. Bezplatné přenosy do 250 MB jsou dostupné až 90 dní. Bezplatné přenosy nad 250 MB jsou dostupné 7 dní. SendGB Extra uchovává soubory až 1 rok.
Co se děje s vaším souborem?
- Vaše soubory necháváme beze změny. Archivy neotevíráme, kód nekompilujeme a testy nespouštíme.
- Archivy ZIP, složky a soubory se zafixovanými verzemi se stahují v původní podobě.
- Při stažení celého přenosu zůstanou názvy složek zachovány. Soubory znovu nekomprimujeme.
- Pokud zadáte svou e-mailovou adresu, dostanete jedno oznámení, jakmile někdo začne stahovat.
Co neděláme
- Nejsme hosting repozitářů. Neukládáme historii, větve ani revize kódu.
- Neinstalujeme balíčky. Neodstraňujeme tajné klíče ani soubory .env.
- Bezplatné přenosy mají limit 500 souborů. SendGB Extra a SendGB Exceed umožňují až 2 500 souborů.
- Oznámení o stahování neznamená, že byl kód nainstalován nebo nasazen.
Časté dotazy
Co je archiv zdrojového kódu?
Je to kopie projektu, kterou si někdo jiný může otevřít na svém počítači. Repozitář uchovává kód a jeho předchozí verze. O jejich správu se stará Git. Nejsme hosting repozitářů. Vy odešlete soubor nebo složku. Příjemce si je stáhne.
Nahrazuje SendGB službu GitHub?
Ne. Není tu historie verzí, revize kódu ani možnost společného programování. Odkaz umožňuje příjemci stáhnout kopii kódu. Nehostujeme průběžně aktualizovaný repozitář.
Mohu odeslat složku node_modules nebo vendor?
Ano, pokud je přidáte a vejdou se do limitů. Tyto složky obsahují hotové balíčky. Ve většině projektů obsahují tisíce malých souborů. Bezplatné přenosy mají limit 500 souborů, SendGB Extra a SendGB Exceed mají limit 2 500 souborů. Složku, která limit překračuje, nelze do přenosu zahrnout. Složku závislostí odeberte. Soubor se zafixovanými verzemi určuje, které verze se mají nainstalovat. Instalační příkaz nespouštíme.
Mohu odeslat i historii verzí?
Pokud přidáte složku .git, odešle se s ní i historie obsažená v této kopii. I tato složka může obsahovat mnoho souborů. Pokud historii odeslat nechcete, vytvořte archiv sami. V Gitu k tomu slouží příkaz git archive. Chcete-li odeslat historii v jediném souboru, použijte git bundle. Tyto příkazy nespouštíme. Repozitáře neklonujeme.
Bude soubor .env odstraněn?
Ne. Tajné klíče, hesla ani soubory .env nijak neupravujeme. Pokud je přidáte do složky, dostanou se k příjemci. Místo nich přidejte prázdný soubor .env.example. Skutečné hodnoty do odkazu nevkládejte. Heslo odešlete odděleně od odkazu. Nekontrolujeme ani licence.
Může si příjemce prohlédnout kód na stránce?
Na stránce není editor kódu. Kód se nekompiluje. Archivy ZIP se neotevírají. Krátkou poznámku ve formátu .txt, .md nebo .json otevřít lze. Příjemce si kód otevře na svém počítači. Ke stažení není potřeba účet. Při stahování souborů .js nebo .exe může prohlížeč zobrazit varování. Toto varování nevypínáme. Soubor nekontrolujeme.
Musím použít ZIP?
Ne. Můžete odeslat i složku. Při stažení celého přenosu zůstanou názvy složek zachovány. Soubory znovu nekomprimujeme. Kliknutím na jednotlivý soubor se složka znovu nevytvoří. Pokud máte mnoho malých souborů, jeden ZIP je bezpečnější volba. Rozdělené archivy neslučujeme. Pokud má ZIP vlastní heslo, odpovídáte za něj vy.
Proč Gmail nepřijme archiv?
Gmail nepřijímá přílohy větší než 25 MB a Outlook přílohy větší než přibližně 20 MB. Zdrojový kód, obrázky a balíčky tyto limity překračují. E-mailová služba může archiv odmítnout také proto, že obsahuje spustitelný soubor. Odkaz není příloha. Není potřeba žádný doplněk.
Dostanu oznámení, když příjemce začne stahovat?
Ano, pokud zadáte svou e-mailovou adresu. Při odeslání e-mailem dostanete jedno oznámení za každého příjemce. Při sdílení odkazem dostanete jedno oznámení za každý přenos. Oznámení vám sdělí, že stahování začalo. Nepotvrzuje, že byl stažen celý soubor. Neznamená ani to, že byl kód nainstalován.
Jaký limit přenosu potřebuji?
Archiv o velikosti menší než 5 GB a s méně než 500 soubory lze odeslat zdarma. Bezplatné přenosy do 250 MB jsou dostupné až 90 dní. Bezplatné přenosy nad 250 MB jsou dostupné 7 dní. Pro větší objemy potřebujete SendGB Extra: 500 GB na přenos, 2 500 souborů, 1 TB úložiště, od 29,90 € ročně. SendGB Extra uchovává soubory až 1 rok. Pro jeden archiv větší než 500 GB stačí SendGB Exceed: bez členství, 2 500 souborů a 9,99 € za přenos o velikosti 1 TB. Kód lze použít jednou a platí 1 rok. Odkaz je dostupný 7 dní. Více než 1 TB se do jednoho přenosu nevejde.
Odešlete odkaz ke stažení, ne zdrojový kód v příloze
Zdrojový kód a soubor se zafixovanými verzemi se často vejdou do 5 GB. Složky závislostí a mnohaletá historie mohou překročit limit počtu souborů. SendGB Extra zvládne větší archivy až do 500 GB a SendGB Exceed až 1 TB v jednom přenosu.
Odeslat soubory