Přejít na obsah

Automatické aktualizace

Automatické nasazování nastavte až po ověření ručního Git pull a nasazovacího skriptu. Konfiguraci otevřete u projektu.

Způsoby spuštění

  • Periodicky: volba pravidelné kontroly spouští minutové ověřování; aktualizace se zařadí, pokud je potvrzen dostupný novější kód.
  • Naplánovaný čas: použije čas nabídnutý formulářem.
  • Webhook: aktualizaci vyvolá podporovaná zpráva z Git poskytovatele.
  • Vypnuto: automatické aktualizace se nespouštějí.

Automatické zpracování závisí na běžícím plánovači a zpracování úloh služby. Nepovažujte uložení režimu za záruku okamžitého nasazení.

Webhook

  1. Zvolte režim webhook a uložte jej.
  2. Zkopírujte adresu webhooku z rozhraní projektu.
  3. Zobrazte webhook secret a nastavte stejnou hodnotu u poskytovatele.
  4. U GitHubu zvolte obsah application/json. Zvolte událost push (GitHub nebo GitLab) pro větev nastavenou v projektu a ověřte skutečný push.
  5. Zkontrolujte doručení u poskytovatele a navazující operaci v projektu.

Secret chrání ověření zprávy; nezveřejňujte jej. Při vypnutí automatického nasazování se uložený secret odstraní. Po novém zapnutí webhooku zkontrolujte také jeho nastavení u poskytovatele.

Úvodní ping nebo push do jiné větve nemusí nic spustit. Úspěšné přijetí webhooku samo o sobě nepotvrzuje nasazení.

GitHub webhook vrací chybu 422

Odpověď 422 znamená, že endpoint nedokázal načíst tělo požadavku jako JSON. Častou příčinou je nastavení Content type na application/x-www-form-urlencoded: GitHub v takovém případě posílá JSON uvnitř formulářového parametru payload, který tento endpoint nezpracovává. Ověření secretu probíhá před načtením JSON, takže při této odpovědi již podpis prošel kontrolou.

  1. V GitHub repozitáři otevřete Settings → Webhooks → váš webhook.
  2. Nastavte Content type → application/json a uložte přes Update webhook.
  3. Proveďte nový push do větve nastavené v projektu.
  4. V Recent Deliveries otevřete nové doručení a zkontrolujte odpověď. Očekávaný stav je 202; přijetí zprávy samo o sobě nepotvrzuje dokončení nasazení.

Pokud chyba přetrvává, zkontrolujte u doručení hlavičku Content-Type, tělo požadavku a Response body. Chybný nebo chybějící podpis vrací 401. Při sdílení diagnostiky nezveřejňujte secret ani citlivé údaje z payloadu. Podrobnosti k formátům najdete v dokumentaci GitHubu.

Když se změna nenasadí

Vlastnictví a práva souborů

Aktualizace repozitáře nemění rekurzivně vlastníka ani skupinu projektových souborů. Git uživatel musí mít přístup k repozitáři nastavený předem; chybějící přístup se při pullu automaticky neopravuje změnou vlastníka. Sledované soubory může Git při aktualizaci nahradit, proto runtime data neukládejte do verzovaných souborů.

V nastavení deploy skriptu zvolte uživatele s odpovídajícím přístupem k projektu. Laravel vyžaduje zápis do storage a bootstrap/cache také pro PHP a workery. Společný přístup nastavte jednorázově vhodným vlastnictvím, skupinou a děděním práv nebo ACL. Starší deploy skripty bez uloženého nastavení uživatele se spouštějí jako root a mohou vytvářet soubory vlastněné rootem; uložte jejich nastavení se správným uživatelem. Oprava pullu sama neobnoví vlastnictví změněné předchozím nasazením.

Ověřte vybranou větev, dostupnost repozitáře, doručení webhooku a historii operací. Probíhající operace může blokovat souběžné spuštění. Opakovaný neúspěch řešte nejdříve ručním postupem.

Příprava ručně přidaného repozitáře

Pokud jste projekt na VM naklonovali ručně, například jako root, automatická kontrola může potřebovat nastavit místní oprávnění i přístup ke GitHubu. Jde o dva samostatné kroky: oprava souborových práv sama nezajistí přístup k soukromému repozitáři.

Následující postup je pro GitHub a Debian/Ubuntu. Příkazy spouštějte v jedné SSH nebo VNC konzoli jako root nebo uživatel s oprávněním sudo. Nic se nenasazuje; poslední krok pouze stáhne Git metadata. Pro deployment mohou být potřeba další práva k pracovním souborům.

1. Zadejte skutečnou cestu a Git uživatele

Cestu zkopírujte z přehledu projektu v cloudu. Zadejte celou cestu k repozitáři, nikoli jen jeho nadřazenou složku. Git uživatel je obvykle grapeCloud; pokud má VM nastaveného jiného přihlašovacího uživatele, zadejte jeho jméno. Uživatelské jméno rozlišuje velká a malá písmena.

read -r -p 'Celá cesta k projektu z cloudu: ' REPO_PATH
read -r -p 'Git uživatel [grapeCloud]: ' GIT_USER
GIT_USER="${GIT_USER:-grapeCloud}"
GIT_HOME="$(getent passwd "$GIT_USER" | cut -d: -f6)"

# Kontrola projektu používá rootův klíč, pokud uživatelův klíč chybí.
if ! sudo test -r "$GIT_HOME/.ssh/id_rsa" && [ "$GIT_USER" != root ] && sudo test -r /root/.ssh/id_rsa; then
    GIT_USER=root
    GIT_HOME=/root
fi
printf 'Projekt: %s\nGit uživatel: %s\n' "$REPO_PATH" "$GIT_USER"

Pokud je cesta nebo uživatel chybný, zopakujte tento krok. Pokud zadaný uživatel neexistuje (getent passwd "$GIT_USER" nic nevypíše), nejprve opravte jeho jméno.

2. Opravte místní oprávnění pouze při chybě přístupu

Pro chybu cannot open .git/FETCH_HEAD: Permission denied použijte Zkopírovat příkazy v upozornění projektu. Obsahuje instalaci acl, skutečnou cestu a nastavení přístupu ke Git metadatům. Celý blok vložte do konzole. Příkazy zachovají vlastníka projektu; ACL může změnit masku a tím i účinná práva existujících ACL položek.

Pokud upozornění nevidíte, následující obecný blok používá hodnoty z prvního kroku. Při jakékoli chybě nepokračujte dalším krokem, dokud ji nevyřešíte.

sudo apt-get install -y acl && (
    set -eu
    GIT_DIR="$(sudo git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" rev-parse --absolute-git-dir)"
    COMMON_DIR="$(sudo git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" rev-parse --git-common-dir)"
    case "$COMMON_DIR" in
        /*) ;;
        *) COMMON_DIR="$REPO_PATH/$COMMON_DIR" ;;
    esac
    sudo test -d "$GIT_DIR"
    sudo test -d "$COMMON_DIR"
    PARENT="$(dirname "$REPO_PATH")"
    while [ "$PARENT" != / ] && [ "$PARENT" != . ]; do
        sudo setfacl -m "u:$GIT_USER:--x" -- "$PARENT"
        PARENT="$(dirname "$PARENT")"
    done
    sudo setfacl -m "u:$GIT_USER:r-x" -- "$REPO_PATH"
    for DIRECTORY in "$GIT_DIR" "$COMMON_DIR"; do
        sudo setfacl -R -m "u:$GIT_USER:rwX" -- "$DIRECTORY"
        sudo find "$DIRECTORY" -type d -exec setfacl -m "d:u:$GIT_USER:rwx" -- {} +
    done
)

3. Nastavte skutečnou SSH adresu repozitáře

Chyba could not read Username for 'https://github.com' znamená, že HTTPS přihlašovací údaje nejsou pro automatickou kontrolu dostupné. Pro použití SSH klíče projektu přepněte origin na SSH.

Otevřete svůj skutečný repozitář na GitHubu → Code → SSH a zkopírujte adresu. Následující příkazy vás vyzvou k jejímu vložení. Nepoužívejte doslova ukázkové názvy OWNER/REPOSITORY; adresa musí obsahovat skutečného vlastníka a název projektu.

sudo -u "$GIT_USER" git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" remote get-url origin
read -r -p 'SSH adresa z GitHub → Code → SSH: ' REPO_SSH_URL
if [ -n "$REPO_SSH_URL" ]; then
    sudo -u "$GIT_USER" git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" remote set-url origin "$REPO_SSH_URL"
    sudo -u "$GIT_USER" git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" remote get-url origin
fi

Pokud váš repozitář záměrně používá HTTPS s nastavenými přihlašovacími údaji, tento krok přeskočte. Přihlašovací údaje musí být dostupné skutečnému Git uživateli bez interaktivního dotazu.

4. Ověřte SSH klíč a přístup k projektu

sudo -u "$GIT_USER" ssh -T -o IdentitiesOnly=yes \
    -i "$GIT_HOME/.ssh/id_rsa" git@github.com

Při prvním připojení ověřte otisk hostitelského klíče podle dokumentace GitHubu. Odpověď You've successfully authenticated, but GitHub does not provide shell access potvrzuje SSH identitu; tento test běžně končí kódem 1. Nepotvrzuje však přístup ke konkrétnímu repozitáři.

Pokud fetch hlásí Repository not found, ověřte adresu origin a přístup rozpoznané identity k projektu. Pro soukromý repozitář lze přidat veřejný klíč z cloudu do GitHub → Settings → Deploy keys → Add deploy key. Pro kontrolu a stahování stačí přístup ke čtení. U účtového SSH klíče musí mít rozpoznaný účet přístup k repozitáři. Nepřepisujte existující klíč kvůli této chybě.

5. Ověřte fetch a počkejte na automatickou kontrolu

sudo -u "$GIT_USER" env HOME="$GIT_HOME" \
    GIT_SSH_COMMAND="ssh -o IdentitiesOnly=yes -i $GIT_HOME/.ssh/id_rsa" \
    git -c safe.directory="$REPO_PATH" -C "$REPO_PATH" fetch origin

Pokud příkaz skončí bez chyby, počkejte na další automatickou kontrolu projektu. Upozornění zmizí až po jejím úspěchu, nikoli hned po vložení opravných příkazů. Když fetch uspěje, ale kontrola dál selhává, ověřte také nastavenou větev a její existenci na origin. Prázdné pole větve znamená automatické určení sledované nebo aktuální větve.