Kodėl pirminio kodo archyvus verta siųsti per nuorodą, o ne el. paštu?
Mažas failas gali tilpti į el. laišką. Programos pirminis kodas, vaizdai ir programiniai paketai netilps. Gmail nepriima didesnių nei 25 MB priedų, o Outlook – didesnių nei maždaug 20 MB. El. pašto paslauga taip pat gali atmesti archyvą saugumo sumetimais, jei jame yra vykdomųjų failų, pavyzdžiui, .exe ar .js.
Išskaidžius kodą į kelis laiškus, gavėją pasiekia ne visas projektas. Bendram diskui būtina paskyra ir nuolatinė prieiga. Per nuorodą gavėjas gali atsisiųsti kodo kopiją per ribotą laiką. Tai nėra vieta bendram programavimui.
Gavėjo atidaromoje kopijoje turėtų būti jūsų pasirinkti failai.
| Būdas | Kas vyksta | Tinkamumas pirminiam kodui |
|---|---|---|
| Gmail arba Outlook priedas | Didesnių nei 20–25 MB priedų išsiųsti negalima | Netinka |
| Išskaidymas į kelis el. laiškus | Trūkstant failų projektas neveikia | Netinka |
| Bendras diskas | Būtina paskyra ir nuolatinė prieiga | Naudokite atsargiai |
| Kodo saugyklos priegloba | Saugomos ankstesnės versijos ir kodo peržiūros | Nepakeičia failų siuntimo |
| SendGB nuoroda | Kodas nekompiliuojamas ir nesiunčiamas kaip priedas | Tinka failams siųsti |
Pirmiau pateiktame pavyzdyje siuntinys neviršija nemokamo siuntimo apribojimų: jame yra programos ZIP archyvas, produktų nuotraukos, diegimo pastabos ir tuščias konfigūracijos pavyzdžio failas. Šiame pavyzdyje priklausomybių aplankas neįtrauktas.
Kodo saugyklos siuntimas ar tiesiog aplanko nuvilkimas?
Kodo saugykloje laikomas kodas ir ankstesnės jo versijos. Tai valdo Git. Kodo saugyklos prieglobos neteikiame. Nepridedame naujų versijų, nesaugome kodo peržiūrų ir nerašome leidimų pastabų.
Kopiją sukuriate jūs. Jei nenorite įtraukti istorijos, archyvą sukurkite patys. Git sistemoje tam naudojama komanda git archive. Jei norite istoriją sutalpinti į vieną failą, naudokite git bundle. Šių komandų nevykdome. Kodo saugyklų neklonuojame.
Pirminio kodo aplanką taip pat galite siųsti tiesiog nuvilkdami jį tokį, koks yra. Atsisiunčiant visą siuntinį išsaugomi aplankų pavadinimai. Failai pakartotinai nesuspaudžiami. Spustelėjus atskirą failą aplankas neatkuriamas. Tušti aplankai neįkeliami.
| Kaip aplankas | Jūsų sukurtas ZIP archyvas | |
|---|---|---|
| Labiausiai tinka | Nedideliam pirminio kodo failų skaičiui | Daugeliui failų arba siuntimui vienu failu |
| Istorija | Įtraukiama, jei pridedate .git | Įtraukiama, jei ją pridedate į archyvą |
| Failų skaičius | 500 arba 2 500 su SendGB Extra | Paprastai vienas failas |
| Diegimas | Gavėjas įdiegia pats | ZIP archyvo neatidarome |
| Ką darome mes | Kodo nekompiliuojame | Archyvų nesujungiame |
Mūsų paruoštas atsisiunčiamas rinkinys nėra Git kodo saugykla. Gavėjas negali jo atidaryti kaip kodo saugyklos. Jei jis turi būti kodo saugykla, paruoškite archyvą patys naudodami savo įrankį.
Ką įtraukti?
Vien pirminio kodo nepakanka. Taip pat turite nurodyti, kurias programinių paketų versijas įdiegti. Slaptųjų raktų neįtraukite.
| Failas | Paskirtis | Kas nutiks be jo |
|---|---|---|
| Pirminio kodo failai | Pati programa | Nebus ko įdiegti |
| Priklausomybių versijų fiksavimo failas | Nurodo programinių paketų versijas | Gavėjas gali įdiegti kitą versiją |
| Diegimo pastabos | Komandos ir versijos | Diegiant teks spėlioti |
| Konfigūracijos pavyzdys | Laukų pavadinimai su tuščiomis reikšmėmis | Per klaidą gali būti išsiųsti slaptieji raktai |
| Produkto vaizdas | Būtinas, jei saugomas atskirai nuo pirminio kodo | Atidaromas tuščias puslapis |
Priklausomybių versijų fiksavimo faile, pavyzdžiui, package-lock.json arba composer.lock, nurodyta, kurias versijas įdiegti. Jį įtraukiate patys. Programinių paketų neįdiegiame.
Priklausomybių aplanke laikomi paruošti naudoti programiniai paketai, kuriuos projektas atsisiuntė. Tokių aplankų pavyzdžiai – node_modules ir vendor. Daugumoje projektų juose būna tūkstančiai mažų failų. Nemokamai galima siųsti iki 500 failų. To nepakanka. Pašalinkite aplanką. Gavėjas programinius paketus įdiegia pats, naudodamas jūsų pastabose pateiktą komandą.
Jei aplanke yra .env ir privačiųjų raktų, jie pasieks gavėją. Jų nepašaliname. Įtraukite tuščią .env.example failą. Reikšmių į nuorodą nerašykite. Slaptažodį siųskite atskirai nuo nuorodos. ZIP archyvo slaptažodis yra atskiras. Licencijų taip pat netikriname. Neįtraukite programinio paketo, kurio negalima teisėtai platinti.
Kaip atsisiunčiant išsaugoma aplankų struktūra, skaitykite aplankų siuntimo vadove. Kaip siųsti kodo saugyklos ZIP archyvą jo neatidarant, skaitykite ZIP archyvų siuntimo vadove. Duomenų bazės atsarginė kopija nėra kodo dalis. Siųskite ją atskirai, vadovaudamiesi duomenų bazės atsarginių kopijų siuntimo vadovu.
Ar pakanka 5 GB ir 500 failų?
Pirminio kodo tekstas dažnai užima mažai vietos. Vaizdai, priklausomybių aplankai ir per daugelį metų sukaupta istorija padidina dydį bei failų skaičių. Nemokamai galima siųsti iki 5 GB ir 500 failų. Viršijus bet kurį iš šių apribojimų, failo išsiųsti negalima.
Sukūrus dar vieną kodo ZIP archyvą, dydis sumažės nedaug, jei jame esantys vaizdai jau suspausti. Paprastasis tekstas suspaudus gali užimti mažiau vietos. Suspaudimu pasirūpinate jūs. ZIP archyvo neatidarome ir pakartotinai nesuspaudžiame.
| Ką siunčiate | Praktikoje | Kurio varianto pakanka |
|---|---|---|
| Pirminis kodas ir priklausomybių versijų fiksavimo failas | Nedaug failų, mažiau nei 5 GB | Nemokamai; iki 250 MB – iki 90 dienų, daugiau – 7 dienos |
| Projektas su vaizdais | Gali užimti kelis GB | Nemokamai, jei neviršija apribojimų; kitu atveju – SendGB Extra |
| Priklausomybių aplankas kaip atskiri failai | Tūkstančiai mažų failų | Pasiekia 500 arba 2 500 failų apribojimą; suspauskite į ZIP arba neįtraukite |
Per daugelį metų sukaupta .git istorija | Daug failų arba vienas didelis archyvas | SendGB Extra, 500 GB vienam siuntiniui |
| Vienas didesnis nei 500 GB archyvas | Retas atvejis | SendGB Exceed, iki 1 TB |
SendGB Extra kainuoja nuo 29,90 € per metus. Į kainą įtraukta 1 TB saugykla. SendGB Extra saugo failus iki 1 metų. Viename siuntinyje gali būti iki 500 GB ir 2 500 failų. Šis planas tinka komandoms, kurios dažnai siunčia didelius archyvus.
SendGB Exceed galima naudotis be narystės. 1 TB siuntinys kainuoja 9,99 €. Kodą galima panaudoti vieną kartą, jis galioja 1 metus. Nuoroda išlieka pasiekiama 7 dienas. Failų skaičiaus apribojimas – 2 500. To pakanka retkarčiais siunčiant vieną didesnį nei 500 GB archyvą. Daugiau nei 1 TB vienu siuntiniu išsiųsti negalime.
Jei įvesite savo el. pašto adresą, prasidėjus atsisiuntimui gausite vieną pranešimą. Siunčiant el. paštu, gaunate po vieną pranešimą apie kiekvieną gavėją. Dalijantis nuoroda, gaunate vieną pranešimą apie kiekvieną siuntinį. Jei tas pats žmogus atsisiunčia dar kartą, naujas el. laiškas nesiunčiamas. Pranešimas nepatvirtina, kad visas kodas atsisiųstas, įdiegtas ar paleistas veikti.
Kaip siųsti
- 1
Pridėti archyvą
Į įkėlimo lauką pridėkite paruoštą ZIP archyvą arba kodo aplanką. Neįtraukite priklausomybių aplanko ir slaptųjų raktų failo. Nemokamai galima siųsti iš viso iki 5 GB ir 500 failų. Viršijus bet kurį iš šių apribojimų, būtinas SendGB Extra arba SendGB Exceed.
- 2
Siųsti nuorodą
Nusiųskite nuorodą gavėjo el. pašto adresu arba nukopijuokite ją į žinutę. Siųsdami uždarąjį kodą nustatykite slaptažodį. Slaptažodį siųskite atskirai nuo nuorodos. Jei įvesite savo el. pašto adresą, prasidėjus atsisiuntimui gausite vieną pranešimą.
- 3
Gavėjas atsisiunčia
Gavėjas atsisiunčia per nuorodą ir nekuria paskyros. Puslapyje kodo nekompiliuojame. Gavėjas atidaro ZIP archyvą savo kompiuteryje ir pats įdiegia programinius paketus. Nemokami siuntiniai iki 250 MB išlieka pasiekiami iki 90 dienų. Nemokami siuntiniai virš 250 MB išlieka pasiekiami 7 dienas. SendGB Extra saugo failus iki 1 metų.
Kas nutinka jūsų failui?
- Jūsų failų nekeičiame. Archyvai neatidaromi, kodas nekompiliuojamas, o testai nevykdomi.
- ZIP archyvai, aplankai ir priklausomybių versijų fiksavimo failai atsisiunčiami nepakeisti.
- Atsisiunčiant visą siuntinį išsaugomi aplankų pavadinimai. Failai pakartotinai nesuspaudžiami.
- Jei įvesite savo el. pašto adresą, kam nors pradėjus atsisiųsti gausite vieną pranešimą.
Ko nedarome
- Neteikiame kodo saugyklos prieglobos. Nesaugome versijų istorijos, šakų ar kodo peržiūrų.
- Neįdiegiame programinių paketų. Nepašaliname slaptųjų raktų ar .env failų.
- Nemokamuose siuntiniuose gali būti iki 500 failų. SendGB Extra ir SendGB Exceed leidžia siųsti iki 2 500 failų.
- Pranešimas apie atsisiuntimą nereiškia, kad kodas jau įdiegtas ar paleistas veikti.
Dažnai užduodami klausimai
Kas yra pirminio kodo archyvas?
Tai projekto kopija, kurią kitas žmogus gali atidaryti savo kompiuteryje. Kodo saugykloje laikomas kodas ir ankstesnės jo versijos. Tai valdo Git. Mes neteikiame kodo saugyklos prieglobos. Jūs siunčiate failą arba aplanką. Gavėjas jį atsisiunčia.
Ar SendGB pakeičia GitHub?
Ne. Čia nėra versijų istorijos, kodo peržiūros ar bendro programavimo galimybių. Per nuorodą gavėjas gali atsisiųsti kodo kopiją. Veikiančios kodo saugyklos prieglobos neteikiame.
Ar galiu siųsti node_modules arba vendor?
Taip, jei juos įtrauksite ir neviršysite apribojimų. Šiuose aplankuose laikomi paruošti naudoti programiniai paketai. Daugumoje projektų juose būna tūkstančiai mažų failų. Nemokamuose siuntiniuose gali būti iki 500 failų, o siunčiant per SendGB Extra ir SendGB Exceed – iki 2 500 failų. Apribojimą viršijančio aplanko į siuntinį įtraukti negalima. Pašalinkite priklausomybių aplanką. Priklausomybių versijų fiksavimo faile nurodyta, kurias versijas įdiegti. Diegimo komandos nevykdome.
Ar galiu siųsti ir versijų istoriją?
Jei įtrauksite .git aplanką, kartu išsiųsite ir toje kopijoje esančią istoriją. Šiame aplanke taip pat gali būti daug failų. Jei nenorite siųsti istorijos, archyvą sukurkite patys. Git sistemoje tam naudojama komanda git archive. Norėdami istoriją išsiųsti vienu failu, naudokite git bundle. Šių komandų nevykdome. Kodo saugyklų neklonuojame.
Ar .env failas bus pašalintas?
Ne. Slaptųjų raktų, slaptažodžių ir .env failų neliečiame. Jei juos įtrauksite į aplanką, jie pasieks gavėją. Vietoj jų įtraukite tuščią .env.example failą. Tikrųjų reikšmių į nuorodą nerašykite. Slaptažodį siųskite atskirai nuo nuorodos. Licencijų taip pat netikriname.
Ar gavėjas gali peržiūrėti kodą puslapyje?
Puslapyje nėra kodo rengyklės. Kodas nekompiliuojamas. ZIP archyvai neatidaromi. Trumpą .txt, .md arba .json pastabų failą galima atidaryti. Gavėjas kodą atidaro savo kompiuteryje. Atsisiųsti galima be paskyros. Atsisiunčiant .js ar .exe failus naršyklė gali parodyti įspėjimą. Šio įspėjimo neišjungiame. Failo nenuskaitome.
Ar būtina naudoti ZIP archyvą?
Ne. Galite siųsti ir aplanką. Atsisiunčiant visą siuntinį išsaugomi aplankų pavadinimai. Failai pakartotinai nesuspaudžiami. Spustelėjus atskirą failą aplankas neatkuriamas. Jei turite daug mažų failų, saugiau juos siųsti vienu ZIP archyvu. Į dalis suskaidytų archyvų nesujungiame. Jei ZIP archyvas turi atskirą slaptažodį, už jį atsakote jūs.
Kodėl Gmail nepriima archyvo?
Gmail nepriima didesnių nei 25 MB priedų, o Outlook – didesnių nei maždaug 20 MB. Pirminis kodas, vaizdai ir programiniai paketai šiuos apribojimus viršija. El. pašto paslauga taip pat gali atmesti archyvą, jei jame yra vykdomasis failas. Nuoroda nėra priedas. Galima siųsti be papildinio.
Ar gausiu pranešimą, kai gavėjas pradės atsisiųsti?
Taip, jei įvesite savo el. pašto adresą. Siunčiant el. paštu, gaunate po vieną pranešimą apie kiekvieną gavėją. Dalijantis nuoroda, gaunate vieną pranešimą apie kiekvieną siuntinį. Pranešimas informuoja, kad atsisiuntimas prasidėjo. Jis nepatvirtina, kad atsisiųstas visas failas. Jis nereiškia, kad kodas įdiegtas.
Kokio siuntinio apribojimo man pakanka?
Mažesnį nei 5 GB archyvą, kuriame yra mažiau nei 500 failų, galima siųsti nemokamai. Nemokami siuntiniai iki 250 MB išlieka pasiekiami iki 90 dienų. Nemokami siuntiniai virš 250 MB išlieka pasiekiami 7 dienas. Didesniems siuntiniams būtinas SendGB Extra: 500 GB vienam siuntiniui, 2 500 failų, 1 TB saugykla, kaina nuo 29,90 € per metus. SendGB Extra saugo failus iki 1 metų. Vienam didesniam nei 500 GB archyvui pakanka SendGB Exceed: be narystės, 2 500 failų, o 1 TB siuntinys kainuoja 9,99 €. Kodą galima panaudoti vieną kartą, jis galioja 1 metus. Nuoroda išlieka pasiekiama 7 dienas. Daugiau nei 1 TB į vieną siuntinį netilps.
Siųskite atsisiuntimo nuorodą, o ne pirminį kodą kaip priedą
Pirminis kodas ir priklausomybių versijų fiksavimo failas dažnai telpa į 5 GB. Priklausomybių aplankuose ir per daugelį metų sukauptoje istorijoje gali būti daugiau failų, nei leidžiama. Su SendGB Extra galima siųsti didesnius, iki 500 GB archyvus, o su SendGB Exceed – iki 1 TB vienu siuntiniu.
Pradėti siųsti