Počnite besplatno
← Svi vodiči

Povežite svoj kod: mijenjajte, provjeravajte, odobravajte, objavljujte i vraćajte stvarnu bazu koda

Povežite svoj kod (/projects/connect/code) povezuje aiKit projekt s Git repozitorijem koji već imate, primjerice Laravel aplikaciju na GitHubu, i s mjestom na kojem se pokreće: vašim vlastitim poslužiteljem ili aiKit hostingom. Od tada zahtjeve za promjene šaljete običnim riječima na kartici Hosting projekta. aiKitova AI uređuje kopiju koda, pokreće provjere projekta, prikazuje vam razliku i pregled te objavljuje tek nakon što netko iz vašeg tima odobri. Svaka objava je numerirano izdanje koje možete vratiti jednim klikom. Vaš repozitorij ostaje izvor istine, a vaš poslužitelj i dalje se objavljuje na način na koji je to uvijek radio.

Povežite svoj kod →
1

Korak 1 i 2: imenujte projekt i povežite repozitorij

Imenujte projekt, zatim zalijepite adresu repozitorija (sa zelenog gumba Code na GitHubu) i granu s koje se stranica pokreće, obično main. Odaberite kako aiKit pristupa repozitoriju. GitHub token: fine-grained token koji napravite na GitHubu samo za taj repozitorij, s postavkom Contents na Read and write; ide uz adresu https://. Deploy ključ: par ključeva napravljen samo za taj repozitorij, čiji javni dio dodajete pod Settings, Deploy keys u repozitoriju, uz označeno Allow write access; ide uz adresu git@. Javni repozitorij: samo za čitanje, pa odobrene promjene nemaju gdje biti spremljene; koristite ga samo za razgledavanje.

Token ili ključ zalijepite sami. Pohranjen je šifriran na aiKitovom motoru i nikad se više ne prikazuje nikome. Stranica prikazuje samo otisak. Povezivanje repozitorija kopira kod na motor i prepoznaje vrstu projekta (Laravel, JavaScript ili statičke datoteke). Ništa u repozitoriju se ne mijenja.

Možete povezati i projekt koji već imate: na njegovoj kartici Hosting vlasnik vidi Povežite svoj kod.

2

Korak 3: gdje se pokreće

Vlastiti poslužitelj: stranica ostaje točno tamo gdje je. Unesite adresu poslužitelja, SSH port (obično 22), prijavu koju aiKit koristi (koraci postavljanja je stvaraju pod imenom aikit), mapu stranice (za Laravel Forge stranicu, /home/forge/vasa-stranica.com), naredbu za objavu koju stranica već koristi (obično bash scripts/deploy.sh) i stranice koje moraju odgovoriti nakon svake objave, jednu punu adresu po retku. Zalijepite privatni ključ prijave na poslužitelj (napravljen u koraku 1 postavljanja). Spremite i provjerite vezu.

Prvi put kad aiKit dođe do poslužitelja prikazuje njegov otisak i pita: Je li ovo vaš poslužitelj? Usporedite ga s onim što je poslužitelj ispisao u koraku 6 postavljanja. Pritisnite samo Odgovara. Povežite kad su identični. Od tada se drugi poslužitelj na toj adresi odbija. Kad provjera prođe, stranica kaže koju verziju poslužitelj trenutno pokreće.

aiKit hosting: aiKit sam gradi i poslužuje kod, s besplatnom adresom za početak. Najbolje za web stranice i frontend.

3

Postavljanje poslužitelja (jednom, oko 10 minuta)

Pod Postavljanje poslužitelja stranica navodi osam koraka za kopiranje i lijepljenje, već popunjenih vašim vrijednostima; svaki ima gumb Kopiraj. Koraci 1 i 8 izvode se na vašem računalu, koraci 2 do 7 na poslužitelju kao korisnik sa sudo ovlastima.

Što grade: prijavu bez lozinke i bez ljuske (korak 2). Njezin jedini ključ zaključan je na mali prolazni skript (koraci 3 i 5) koji prihvaća točno dvije naredbe: status (koja verzija radi i je li stranica u načinu održavanja) i deploy jednog točno određenog commita. Objava se izvodi kao vlastiti korisnik stranice kroz jedno sudo pravilo, provjerava pokazuje li grana na GitHubu na taj točan commit, zatim pokreće vaš postojeći skript za objavu nepromijenjen. Korak 4 postavlja dopuštenja mape tako da prijava dosegne samo mapu stranice: ne druge stranice u istoj početnoj mapi i nikad .env. Korak 7 testira sve to i kaže što trebate vidjeti za svaki redak, a korak 8 testira prijavu s vašeg računala prije nego zalijepite njezin ključ u aiKit.

Ako poslužitelj gostuje i druge tvrtke, u tome je poanta: aiKit prijava može objaviti samo ovu jednu stranicu i ništa drugo. Kod stranice i dalje se izvodi kao korisnik stranice, baš kao kad sami objavljujete s GitHuba, zato se svaka promjena pregledava i zato su rizične datoteke zaštićene.

4

Kartica Hosting projekta s kodom

Četiri pločice na vrhu. Repozitorij: repozitorij, grana, najnoviji commit i vrsta projekta. Pokreće se na: vlastiti poslužitelj (s prijavom i kada je zadnji put odgovorio) ili aiKit hosting. Aktivno izdanje: izdanje koje stranica pokreće, tko ga je napravio i kada. Stranice: koliko stranica koje moraju odgovoriti je odgovorilo na zadnjoj provjeri; Provjeri sada ih ponovno posjećuje, a svaka stranica koja nije odgovorila navedena je ispod s onim što je vratila.

Ispod pločica: Zatraži promjenu (ili promjena koja je trenutno otvorena), Izdanja, Dnevnik promjena, Zaštićene datoteke i, za vlasnika, Veza.

5

Zatražite promjenu, pregledajte je, odobrite je

Upišite što treba promijeniti, navodeći stranicu i što želite vidjeti, i pritisnite Napravi promjenu. Kartica se pretvara u Promjena #1 s napretkom uživo: dohvaćanje najnovijeg koda, datoteke koje AI čita i uređuje, zatim svaka provjera. AI samo uređuje datoteke; ne pokreće naredbe. Po projektu je istovremeno otvorena jedna promjena, a svaki zahtjev se računa u AI ograničenje projekta.

Kad završi, vidite: zahtjev i tko ga je tražio; što AI kaže da je napravio; provjere, svaka s kvačicom ili križićem i svojim ispisom; gumbe Pregled za provjerene stranice; datoteke s oznakama Dodano, Promijenjeno ili Uklonjeno te oznaku Zaštićeno tamo gdje vrijedi; i razliku, datoteku po datoteku, zeleno za dodane retke i crveno za uklonjene retke. Ta razlika točno je ono što će biti spremljeno i objavljeno.

Odobri i objavi (vlasnici i graditelji) upisuje promjenu u granu s porukom koja navodi tko je tražio i tko je odobrio, šalje je (nikada silom: ako je netko u međuvremenu poslao svoju promjenu, promjena se označava kao Zastarjela i ništa se ne objavljuje), objavljuje je i provjerava stranice. Odbaci briše promjenu nakon potvrde; ništa nije objavljeno. Recenzenti mogu sve pročitati, ali ne mogu pritisnuti nijedno od ta dva.

Nakon što provjere prođu, postavka se nalazi pod Veza, Provjere i pregled. Čekaj odobrenje zadana je opcija. Objavi automatski sama objavljuje promjenu samo kada su sve provjere prošle i nijedna zaštićena datoteka nije promijenjena; sve ostalo i dalje čeka.

6

Provjere i pregled

Za Laravel projekt provjere su: svaka promijenjena PHP datoteka mora se ispravno raščlaniti (php -l); svaki Blade prikaz mora se ispravno prevesti (php artisan view:cache); frontend se mora uspješno izgraditi (npm run build); a aplikacija se pokreće u probnom pokretanju s privremenom SQLite bazom podataka, migriranom i napunjenom iz repozitorija, pri čemu svaka stranica navedena u Stranice mora na probnom pokretanju vratiti odgovor 200. Provjere se izvode na aiKitovom motoru, nikada na vašem serveru i nikada nad vašom aktivnom bazom podataka. Datoteka .env projekta se nikada ne kopira niti čita; probno pokretanje dobiva privremene postavke.

Neuspješna provjera blokira Odobri i objavi. Samo vlasnik može označiti Objavi iako su provjere neuspjele, i to za provjeru koja nije uspjela iz razloga koji ne utječe na aktivnu stranicu.

Pregled otvara promijenjenu aplikaciju iz probnog pokretanja u novoj kartici, s testnim podacima i isključenim obrascima. Zatvara se 15 minuta nakon posljednjeg korištenja i završava kada se promjena odobri ili odbaci.

7

Zaštićene datoteke

AI ne dira zaštićene datoteke. Popis počinje s: migracijama koje su već izvršene na aktivnoj stranici (svaka migracija u aktivnoj verziji, jer ih svaka objava izvršava), novim migracijama (one bi promijenile aktivnu bazu pri sljedećoj objavi), skriptom za objavu i datotekama ovisnosti (composer.json, composer.lock, package.json, package-lock.json). Svaka stavka navodi razlog. Vlasnik dodaje datoteku ili mapu (config/** znači sve unutar config) s razlogom, uklanja stavke i pritišće Spremi zaštićene datoteke.

Za namjernu promjenu zaštićene datoteke vlasnik označava Dopusti zaštićene datoteke za ovaj zahtjev. Promjena tada prikazuje koje su zaštićene datoteke dirane, a samo vlasnik je može odobriti, nakon što označi Da, objavi promjene na zaštićenim datotekama. Graditelj koji ništa ne označi nema pristup zaštićenim datotekama.

Datoteke .env, privatni ključevi i auth.json nalaze se u strožoj razini: nikada se ne čitaju, nikada ne mijenjaju, nikada nisu dio razlike i nitko to ne može isključiti.

8

Verzije, Objavi i Vrati unatrag

Prvi put kada aiKit dođe do vašeg servera, bilježi što server pokreće kao verziju 1, Prije aiKita, pa se i prva aiKitova objava može vratiti unatrag. Nakon toga svaka objava je numerirana verzija: Promjena (odobrena promjena; njezin naziv otvara tu promjenu), Ponovna objava ili Povratak, s commitom, tko ju je izvršio, statusom (Aktivna, Ranija, Aktivna, ali stranice ne rade, Objava nije uspjela), koliko je stranica odgovorilo i dnevnikom objave. aiKit čuva zadnjih 5.

Objavi najnoviji kod objavljuje ono što je trenutno najnovije na grani, nakon potvrde, na primjer kada je netko izravno poslao ispravak.

Vrati na ovo, na ranijoj verziji, stvara novi commit čije su datoteke točno one iz te verzije, šalje ga i objavljuje na uobičajen način, a zatim provjerava stranice. Povijest se nikada ne prepisuje, pa se sam povratak može poništiti.

9

Dnevnik promjena

Svaki zahtjev s brojem, tekstom zahtjeva, tko ga je tražio, tko ga je odobrio ili odbacio, kada i u kojem je stanju. Pritisnite redak da otvorite tu promjenu s provjerama i razlikama; adresa dobiva ?change=<id>, pa možete podijeliti poveznicu sa svojim timom.

Sljedeći vodič O Printer's Helperu: čemu služi i koja su mu ograničenja

Imate brže, konkretno pitanje? Pogledajte česta pitanja.