Publicarea prin Git pe găzduirea cPanel: clonarea unui depozit GitHub și .cpanel.yml

Tipărire
  • 0

Pe scurt: cPanel poate păstra o copie a proiectului dvs. de pe GitHub și poate trimite fișierele lui pe site atunci când îi cereți. Instrumentul se numește Git Version Control și se află printre instrumentele din Files. Un fișier mic, .cpanel.yml, îi spune ce să copieze, iar accesul SSH la găzduire nu este necesar.

Mulți dezvoltatori țin codul pe GitHub, dar urcă totuși modificările manual, prin FTP sau File Manager. Merge, însă durează și e ușor să greșiți. Cu Git în cPanel, codul de pe GitHub devine singura sursă, iar actualizarea site-ului înseamnă două clicuri.

Înainte de a începe

Cum funcționează procesul

cPanel nu clonează niciodată direct în site. Proiectul este ținut într-un folder separat al contului, de exemplu repositories/site. La publicare, cPanel citește .cpanel.yml din această copie și execută comenzile scrise acolo. Comenzile respective pun fișierele alese în public_html. Există deci două locuri: copia depozitului, pe care o atinge doar Git, și folderul site-ului, pe care îl văd vizitatorii.

Pregătiți .cpanel.yml

Creați acest fișier la nivelul de sus al depozitului, faceți commit și trimiteți-l pe GitHub:

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/UTILIZATOR/public_html/
    - /bin/cp -a public/. $DEPLOYPATH

În locul lui UTILIZATOR scrieți numele dvs. de utilizator cPanel. Dacă site-ul se află într-un folder cu alt nume, schimbați public cu acel nume. Indentați rândurile doar cu spații; un tab strică fișierul. Un folder separat pentru site înseamnă și că .git, .cpanel.yml și eventualele notițe private rămân în afara public_html.

Adăugați depozitul în cPanel

  1. Autentificați-vă în cPanel și găsiți Git Version Control la Files. Nu îl vedeți în panou? Trimiteți-ne un tichet și verificăm contul dvs.
  2. Apăsați Create, păstrați pornită opțiunea Clone a Repository și lipiți adresa GitHub în Clone URL, de exemplu https://github.com/utilizator/site.git.
  3. La Repository Path indicați un folder gol, în afara site-ului, cum ar fi repositories/site, scrieți orice Repository Name și apăsați Create.

Un proiect mic, de câțiva MB, este copiat în câteva secunde.

Puneți modificările online

De fiecare dată după ce ați trimis o lucrare nouă pe GitHub:

  1. Reveniți în Git Version Control, apăsați Manage la depozitul dvs. și treceți la fila Pull or Deploy.
  2. Apăsați Update from Remote. cPanel preia cele mai noi commituri de pe GitHub.
  3. Apăsați Deploy HEAD Commit. Comenzile din .cpanel.yml rulează, iar site-ul primește fișierele noi.

Între aceste clicuri nu se întâmplă nimic de la sine. Dacă preferați ca site-ul să urmeze automat fiecare push, consultați Cum publicați automat un site din GitHub: GitHub Actions cu FTPS pe găzduire sau rsync pe VPS.

Alegeți metoda potrivită proiectului

Proiectul dvs.Modul recomandat
Depozit open-source sau publicClonare prin HTTPS, exact ca în acest ghid
Depozit privatUn deploy key GitHub cu drept doar de citire, apoi aceiași pași
Doriți actualizări fără intervenție la fiecare pushUn workflow GitHub Actions care urcă fișierele prin FTPS
Site-ul are nevoie de o etapă de build cu npm (React, Vue, Astro)Rulați build-ul în GitHub Actions sau local și urcați doar rezultatul

Când publicarea nu reușește

Ce observațiCe verificați
Butonul de publicare nu face nimic sau fișierele nu mai ajungSe află .cpanel.yml la nivelul de sus al depozitului? Este indentat cu spații, nu cu taburi?
cPanel refuză publicareaCineva a editat fișiere în repositories/site. Se poate publica doar o copie curată, așa că editați pe GitHub sau pe calculatorul dvs.
Fișierele ajung în alt loc sau nicăieriVerificați DEPLOYPATH: numele de utilizator trebuie să corespundă contului, iar folderul trebuie să existe.

Bine de știut

  • SSH este opțional. Toate cele trei acțiuni (clonare, actualizare, publicare) se fac din interfața cPanel. Un shell vă ajută doar dacă preferați comenzile Git.
  • Fișierele vechi rămân. Comanda cp adaugă și înlocuiește fișiere, dar nu le șterge niciodată. Resturile le curățați din File Manager.
  • Lăsați public_html deoparte. cPanel are nevoie de un folder țintă gol, iar o clonă acolo ar expune vizitatorilor folderul .git.
  • Fără date secrete pe GitHub. Parolele bazei de date și cheile API nu se pun în commituri, nici într-un depozit privat. Protecția cheilor API în aplicațiile din cPanel și în WordPress: păstrare sigură și reacția la scurgeri arată unde să le păstrați.

Articole utile

Răspunsul a fost util?