Aktualizacje Git: token dostępu do prywatnego repozytorium

Aktualizacje Git (Baza Helper > Aktualizacje Git, narzędzie Pro) instaluje motyw z repozytorium Git. Repozytorium publiczne nie wymaga tokenu. Prywatne wymaga tokenu, dzięki któremu witryna może je czytać, i tylko czytać.

Zanim zaczniesz

• Repozytorium publiczne: zostaw Token dostępu (repozytorium prywatne) puste. Jeśli token jest już zapisany, kliknij Usuń zapisany token.
• Repozytorium prywatne: utwórz token, który czyta tylko to jedno repozytorium i nic więcej, aby nie wyrządził szkody, gdyby kiedyś wyciekł.
• Token jest zapisywany w postaci zaszyfrowanej i nie jest już pokazywany. Skopiuj go, gdy pokaże go serwis.

GitHub: token typu fine-grained

1. Otwórz github.com/settings/personal-access-tokens/new (Settings, Developer settings, Personal access tokens, Fine-grained tokens).
2. Wpisz nazwę i wybierz datę wygaśnięcia.
3. Resource owner: Twoje konto. Jeśli repozytorium należy do organizacji, wybierz organizację. Organizacja może musieć zatwierdzić token, zanim zacznie działać.
4. Repository access: wybierz Only select repositories i zaznacz repozytorium z Twoim motywem.
5. Repository permissions: ustaw Contents na Read-only. Metadata: Read-only GitHub dodaje sam. Resztę zostaw jako No access.
6. Kliknij Generate token, skopiuj token i wklej go w Token dostępu (repozytorium prywatne).
7. Kliknij Zapisz zmiany, potem Sprawdź teraz. Przyciski działają na zapisanych ustawieniach.

GitLab

Utwórz osobisty lub projektowy token dostępu z zakresem read_repository. Token projektu wymaga roli Reporter lub wyższej. Wklej go w to samo pole.

Bitbucket

Otwórz repozytorium, potem Repository settings, Access tokens, i utwórz repository access token z uprawnieniem do odczytu. Wklej go w to samo pole.

Co zastępuje synchronizacja

• Aktualizuj teraz zastępuje cały folder motywu zawartością archiwum repozytorium. Plik, który jest na stronie, ale nie ma go w archiwum, po tym znika.
• Baza Helper nie czyta pliku .gitignore. To, co tam wpisano, na przykład vendor/ lub node_modules/, nie ma go w repozytorium, więc po synchronizacji zniknie ze strony. Zatwierdź w repozytorium foldery potrzebne motywowi w działaniu albo zbuduj je przed wysłaniem.
• GitHub pomija w swoim archiwum to, co w .gitattributes oznaczono jako export-ignore, więc te pliki również znikną ze strony.
• Przed każdą aktualizacją zapisywany jest zip bieżącego motywu. Zachowywane są najnowsze kopie (Liczba zachowywanych kopii, domyślnie 3), a Przywróć poprzednią wersję instaluje najnowszą.

Częste błędy

• Repozytorium odrzuciło zapisany token (401 lub 403): token wygasł, utworzono go dla innego właściciela lub innego repozytorium, organizacja go nie zatwierdziła, Contents nie ma ustawienia Read-only albo token wklejono ze spacją.
• Nie znaleziono repozytorium (404), także przy pobieraniu archiwum: adres jest błędny albo token nie może czytać zawartości tego prywatnego repozytorium. Utwórz token ponownie z prawami opisanymi wyżej. Dla organizacji wybierz ją jako Resource owner.
• Repozytorium prosi o logowanie, a token nie jest zapisany: repozytorium jest prywatne. Dodaj token i zapisz.
• W repozytorium nie ma tam motywu: w tym miejscu brakuje pliku style.css z Theme Name. Sprawdź Folder motywu w repozytorium.
• Repozytorium jest publiczne, ale token jest zapisany: błędny lub wygasły token może sprawić, że serwis odmówi dostępu do repozytorium, które może czytać każdy. Usuń token: repozytorium publiczne go nie potrzebuje.