Pasi një projekt të ekzekutohet lokalisht, katër komanda e kalojnë atë në një faqe live në hostimin Zinn Digital®: identifikohuni, lidhni projektin me një slot hostimi, lexoni pre-flight-in dhe bëni push. Ky artikull shpjegon secilën prej tyre, çfarë printojnë ato dhe komandat që përdorni më pas — ridislokimet, historikun e dislokimeve dhe regjistrat e ndërtimit.
Identifikohuni me një çelës API
Krijoni një çelës në panelin e kontrollit nën Cilësimet → Çelësat API, më pas:
zinnector login
Çelësi shkruhet në një prompt — ai kurrë nuk pranohet në rreshtin e komandës, kështu që nuk mund të përfundojë në historikun e shell-it tuaj ose në një listë procesesh. Në CI, kalojeni me pipe: echo "$ZINN_API_KEY" | zinnector login --profile ci, ose vendosni ZINNECTOR_TOKEN dhe anashkaloni login tërësisht. Çelësi verifikohet përpara se të ruhet, dhe ruhet me modalitetin e skedarit 600. zinnector whoami --scopes tregon se në cilën organizatë jeni i identifikuar dhe çfarë lejesh mbart çelësi; një çelës sandbox etiketohet si i tillë.
Lidhni projektin me një slot
zinnector link # zgjidhni një faqe nga një listë
zinnector link example.com --repo acme/site --branch main
link shkruan id-në e faqes në zinnector.json dhe, përveç nëse kaloni --no-repo, lidh git remote-in e projektit me faqen në platformë në mënyrë që një push ta dislokojë atë. Bëni commit zinnector.json: një koleg që klonon repozitorin më pas dislokon në të njëjtin vend pa qenë nevoja t'i thuhet. Ai nuk përmban asnjë sekret.
Lexoni pre-flight-in
zinnector check
Kjo është komanda për të cilën ekziston CLI-ja. Ajo krahason projektin tuaj me slotin ku është gati të dislokohet dhe printon çdo mospërputhje — dhe çdo krahasim që nuk mundi të bënte:
- Versioni i PHP-së, me një diferencë versioni madhor të vlerësuar si e lartë sepse prish me siguri një faqe dhe një diferencë minore të vlerësuar më ulët, sepse vlerësimi i gjithçkaje si kritike i mëson njerëzit të anashkalojnë paralajmërimin.
- Nëse sloti mund të kalojë në versionin mbi të cilin keni ndërtuar, nëse PHP-ja e slotit ka kaluar fundin e ciklit jetësor (end of life), dhe nëse makina e ka zbatuar versionin apo thjesht i është thënë.
- Madhësia dhe numri i skedarëve të projektit tuaj kundrejt hapësirës së mbetur reale të diskut dhe inode-ve në slot — një strukturë WordPress mund të mbetet pa skedarë ndërsa është shumë nën kufirin e diskut të saj.
- Versionet e WordPress në secilën anë, nëse sloti ka përfunduar provizionimin, dhe nëse një repozitor është i lidhur për të bërë push.
Ajo paralajmëron; nuk bllokon kurrë. Çdo gjetje mund të anashkalohet me zinnector push --force, sepse ju dini gjëra për faqen tuaj që një kontrollues nuk i di. Një krahasim që nuk mund të bëhej raportohet si i panjohur, kurrë si i kaluar, dhe përmbledhja gjithmonë tregon se sa të tillë ishin. Si parazgjedhje, versioni lokal i PHP-së është ai i deklaruar në zinnector.json; --probe nis runtime-in lokal dhe e mat atë në vend të kësaj. --strict del me kod jo-zero edhe për të panjohurat, gjë që kërkohet nga një portë CI.
Push
zinnector push
push ekzekuton pre-flight-in, bën push commit-et tuaja, nis dislokimin dhe e ndjek atë deri në përfundim, duke printuar statusin përfundimtar dhe commit-in e dislokuar. --dry-run bën gjithçka përveç dislokimit; --no-wait e nis atë dhe del; --no-git dislokon çfarëdo që platforma ka tashmë pa bërë push. Nëse commit-i i dislokuar nuk është ai që sapo u bë push, ajo e tregon këtë.
Kur diçka shkon keq
zinnector deploys example.com # historiku i dislokimeve — statusi, commit-i, nxitësi, mesazhi
zinnector logs example.com --build # regjistri i ndërtimit i dislokimit më të fundit
zinnector logs example.com --error # regjistri i gabimeve të faqes
zinnector deploy example.com # ridislokoni atë që platforma ka tashmë
zinnector ai "why is my deploy failing?"
zinnector ai ekzekutohet në platformë kundrejt llogarisë suaj, kështu që mund të shohë të njëjtin historik dislokimesh dhe regjistrash. Nga brenda një projekti, ai dërgon strukturën e projektit — emrat e drejtorive, versionet dhe id-në e faqes — dhe kurrë përmbajtjen e skedarëve.
Të lidhura