Propojte svůj kód: měňte, kontrolujte, schvalujte, nasazujte a vracejte zpět skutečnou kódovou základnu

Pojmenujte projekt a poté vložte adresu repozitáře (z zeleného tlačítka Code na GitHubu) a větev, ze které web běží, obvykle main. Vyberte, jak se k němu aiKit dostane. Token GitHubu: jemně granulovaný token, který vytvoříte na GitHubu jen pro tento jeden repozitář s oprávněním Contents nastaveným na Read and write; používá se s adresou https://. Deploy klíč: pár klíčů vytvořený jen pro tento repozitář, jehož veřejnou část přidáte v nastavení repozitáře v sekci Settings, Deploy keys se zaškrtnutým Allow write access; používá se s adresou git@. Veřejný repozitář: pouze čtení, takže schválené změny nemají kam být uloženy; používejte ho jen k prohlížení.

Token nebo klíč vkládáte sami. Je uložen šifrovaně na motoru aiKitu a nikdy se znovu nezobrazí, nikomu. Stránka ukazuje jen otisk. Propojit repozitář zkopíruje kód na motor a zjistí, jaký typ projektu je (Laravel, JavaScript nebo statické soubory). V repozitáři se nic nemění.

Projekt, který již máte, lze také propojit: na jeho kartě Hosting vlastník uvidí Propojit kód.

Váš vlastní server: web zůstane přesně tam, kde je. Zadejte adresu serveru, port SSH (obvykle 22), přihlášení, které aiKit používá (kroky nastavení vytvoří účet aikit), složku webu (pro web Laravel Forge například /home/forge/vas-web.cz), příkaz pro nasazení, který web už používá (obvykle bash scripts/deploy.sh), a stránky, které musí po každém nasazení odpovědět, jednu úplnou adresu na řádek. Vložte privátní klíč přihlášení k serveru (vytvořený v kroku 1 nastavení). Uložte a zkontrolujte připojení.

Když se aiKit poprvé připojí k serveru, zobrazí otisk serveru a zeptá se: Je to váš server? Porovnejte ho s tím, co server vypsal v kroku 6 nastavení. Stiskněte Shoduje se jen tehdy, když jsou totožné, a poté Připojit. Od té chvíle bude na dané adrese jiný server odmítnut. Když kontrola projde, stránka ukáže, jakou verzi server právě běží.

Hosting aiKit: aiKit kód sám sestaví a poskytuje, s bezplatnou adresou pro začátek. Nejlepší pro weby a frontendy.

V sekci Nastavení serveru stránka uvádí osm kroků ke zkopírování a vložení, již vyplněných vašimi hodnotami; každý má tlačítko Kopírovat. Kroky 1 a 8 běží na vašem počítači, kroky 2 až 7 na serveru jako uživatel se sudo.

Vytvářejí: přihlášení bez hesla a bez shellu (krok 2). Jeho jediný klíč je omezen na malý bránový skript (kroky 3 a 5), který přijímá přesně dva příkazy: status (která verze běží a zda je web v režimu údržby) a deploy jednoho konkrétního commitu. Nasazení běží pod vlastním uživatelem webu přes jediné pravidlo sudo, ověří, že větev na GitHubu ukazuje právě na tento commit, a poté spustí váš stávající deploy skript beze změny. Krok 4 nastaví oprávnění složek tak, aby se přihlášení dostalo jen do složky webu: ne k ostatním webům ve stejné domovské složce a nikdy k .env. Krok 7 vše otestuje a řekne, co máte u každého řádku vidět, a krok 8 otestuje přihlášení z vašeho počítače dřív, než jeho klíč vložíte do aiKitu.

Pokud server hostuje i jiné firmy, v tom je smysl: přihlášení aiKitu může nasadit jen tento jeden web a nic jiného. Kód webu pak stále běží pod uživatelem daného webu, přesně jako když nasazujete z GitHubu sami, a proto je každá změna kontrolována a rizikové soubory jsou chráněny.

Nahoře čtyři dlaždice. Repozitář: repozitář, větev, nejnovější commit a typ projektu. Běží na: váš vlastní server (s přihlášením a časem, kdy naposledy odpověděl) nebo hosting aiKit. Živé vydání: vydání, které web běží, kdo ho vytvořil a kdy. Stránky: kolik ze stránek, které musí odpovědět, odpovědělo při poslední kontrole; Zkontrolovat nyní je navštíví znovu a každá stránka, která neodpověděla, je uvedena níže s tím, co vrátila.

Pod dlaždicemi: Požádat o změnu (nebo právě otevřenou změnu), Vydání, Protokol změn, Chráněné soubory a pro vlastníka Připojení.

Napište, co se má změnit, uveďte stránku a to, co chcete vidět, a stiskněte Provést změnu. Karta se změní na Změna #1 s průběhem v reálném čase: načtení nejnovějšího kódu, soubory, které AI čte a upravuje, poté každá kontrola. AI pouze upravuje soubory; žádné příkazy nespouští. Jedna změna je u projektu otevřená najednou a každý požadavek se počítá do limitu AI projektu.

Po dokončení uvidíte: požadavek a kdo se ptal; co AI uvádí, že udělala; kontroly, každou se zaškrtnutím nebo křížkem a jejím výstupem; tlačítka Náhled u zkontrolovaných stránek; soubory s označením Přidáno, Změněno nebo Odstraněno a odznakem Chráněno tam, kde se to týká; a rozdíly soubor po souboru, zeleně pro přidané řádky a červeně pro odebrané. Tento rozdíl je přesně to, co bude commitnuto a nasazeno.

Schválit a nasadit (vlastníci a tvůrci) potvrdí změnu do větve se zprávou, která uvádí, kdo ji požádal a kdo schválil, odešle ji (nikdy vynuceně: pokud mezitím někdo odeslal změnu, změna se označí jako Zastaralá a nic se nenasadí), nasadí ji a zkontroluje stránky. Zahodit změnu smaže po potvrzení; nic nebylo nasazeno. Recenzenti mohou číst vše, ale ani jedno tlačítko nestisknou.

Co se spustí po úspěšných kontrolách, je nastavení v sekci Připojení, Kontroly a recenze. Výchozí je Čekat na schválení. Automaticky nasadit nasadí změnu sama, pouze pokud prošly všechny kontroly a nezměnil se žádný chráněný soubor; ve všech ostatních případech čeká.

U projektu Laravel jsou kontroly tyto: každý změněný soubor PHP se zparsuje (php -l); každý Blade pohled se zkompiluje (php artisan view:cache); frontend se sestaví (npm run build); a aplikace se spustí v testovacím běhu s jednorázovou databází SQLite, která se migruje a naplní daty z repozitáře, a každá stránka uvedená v Stránkách, které testovací běh musí otevřít, musí odpovědět kódem 200. Běží na motoru aiKitu, nikdy na vašem serveru a nikdy proti vaší živé databázi. Soubor .env projektu se nikdy nekopíruje ani nečte; testovací běh dostane jednorázová nastavení.

Neúspěšná kontrola blokuje Schválit. Pouze vlastník může zaškrtnout Nasadit i přesto, že kontroly selhaly, a to u kontroly, která selhala z důvodu, který nemá vliv na živý web.

Náhled otevře změněnou aplikaci z testovacího běhu v nové kartě, s testovacími daty a vypnutými formuláři. Po 15 minutách od posledního použití se zastaví a skončí, když je změna schválena nebo zahozena.

AI se chráněných souborů nedotýká. Seznam začíná: migrace, které už proběhly na živém webu (každá migrace v živé verzi, protože každé nasazení je spouští), nové migrace (změnily by živou databázi při příštím nasazení), nasazovací skript a soubory závislostí (composer.json, composer.lock, package.json, package-lock.json). U každé položky je uvedeno proč. Vlastník přidá soubor nebo složku (config/** znamená vše v config) s důvodem, položky odebírá a stiskne Uložit chráněné soubory.

Pro úmyslnou změnu chráněného souboru vlastník zaškrtne Povolit chráněné soubory pro tento požadavek. Změna pak ukáže, kterých chráněných souborů se dotkla, a schválit ji může pouze vlastník, a to po zaškrtnutí Ano, nasadit změny chráněných souborů. Tvůrce, který nic nezaškrtne, nemá přístup k chráněným souborům.

Soubory .env, privátní klíče a auth.json patří do přísnější úrovně: nikdy se nečtou, nikdy se nemění, nikdy nejsou součástí rozdílů a nikdo to nemůže vypnout.

Poprvé, když se aiKit připojí k vašemu serveru, zaznamená, co server běží, jako verzi 1, Před aiKitem, takže lze i první nasazení aiKitu vrátit zpět. Poté je každé nasazení očíslovaná verze: Změna (schválená změna; její název otevře danou změnu), Znovu nasadit, nebo Vrácení zpět, s jejím commitem, kdo ji provedl, jejím stavem (Živé, Starší, Živé, ale stránky selhávají, Nasazení selhalo), počtem stránek, které odpověděly, a logem nasazení. aiKit uchovává posledních 5.

Nasadit nejnovější kód nasadí cokoli, co je právě nejnovější ve větvi, po potvrzení, například když někdo odeslal opravu přímo.

Vrátit zpět na tuto verzi, na starší verzi, vytvoří nový commit, jehož soubory jsou přesně soubory dané verze, odešle ho a nasadí běžným způsobem, a poté zkontroluje stránky. Historie se nikdy nepřepisuje, takže samotné vrácení lze vrátit zpět.

Každý požadavek s jeho číslem, zadáním, kdo jej požádal, kdo jej schválil nebo zahodil, kdy, a v jakém je stavu. Kliknutím na řádek otevřete danou změnu s kontrolami a rozdíly; adresa dostane ?change=<id>, takže můžete odkaz sdílet se svým týmem.