Publicarea prin Git pe găzduirea cPanel: clonarea unui depozit GitHub și .cpanel.yml
TipărirePe 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
- Proiectul dvs. se află deja pe GitHub. Dacă depozitul este privat, configurați mai întâi o cheie doar pentru citire, după instrucțiunile din Depozit GitHub privat pe găzduirea cPanel: configurarea unui deploy key doar pentru citire (ed25519).
- Cunoașteți numele de utilizator cPanel, deoarece calea de publicare îl conține.
- Fișierele site-ului sunt adunate într-un singur folder al depozitului (mai jos îl numim
public), nu amestecate cu notițe, teste sau configurări.
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
- 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.
- 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. - 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:
- Reveniți în Git Version Control, apăsați Manage la depozitul dvs. și treceți la fila Pull or Deploy.
- Apăsați Update from Remote. cPanel preia cele mai noi commituri de pe GitHub.
- Apăsați Deploy HEAD Commit. Comenzile din
.cpanel.ymlrulează, 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 public | Clonare prin HTTPS, exact ca în acest ghid |
| Depozit privat | Un deploy key GitHub cu drept doar de citire, apoi aceiași pași |
| Doriți actualizări fără intervenție la fiecare push | Un 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ți | Ce verificați |
|---|---|
| Butonul de publicare nu face nimic sau fișierele nu mai ajung | Se află .cpanel.yml la nivelul de sus al depozitului? Este indentat cu spații, nu cu taburi? |
| cPanel refuză publicarea | Cineva 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ăieri | Verificaț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
cpadaugă și înlocuiește fișiere, dar nu le șterge niciodată. Resturile le curățați din File Manager. - Lăsați
public_htmldeoparte. 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
- Depozit GitHub privat pe găzduirea cPanel: configurarea unui deploy key doar pentru citire (ed25519)
- Cum publicați automat un site din GitHub: GitHub Actions cu FTPS pe găzduire sau rsync pe VPS
- Acces SSH pe găzduirea cPanel: activare, Terminal și conectare din program
- Unde încărcați fișierele site-ului în cPanel: folderul public_html