Tirsvad
78d21b34a3
- .gitea/scoped_workflows/publish-wiki.yml is deleted - tools/publish_wiki.py requires WIKI_PRUNE, reads no marker, and defaults WIKI_DIR to docs/wiki; its tests follow - README, onboarding, troubleshooting and upgrading guides, and the wiki pages in English, Danish and Bahasa Malaysia no longer describe the scoped workflow - changelog entry 2.0.0 with the Breaking group Task: MIL-009#6 Task: MIL-009#8
5.1 KiB
Ini ialah terjemahan
Troubleshooting. Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
English | Dansk | Bahasa Melayu
Mendiagnosis larian yang gagal
Buka larian dalam Gitea (Actions) dan baca baris terakhir langkah yang gagal. Setiap kegagalan daripada skrip penyegerakan ditulis sebagai
ERROR: [<category>] <message>
Kategori menunjukkan di mana perlu dilihat. Kegagalan di luar skrip (kerja tidak pernah bermula, atau berhenti sebelum langkah itu) ialah masalah runner.
| Kategori | Maksud | Perkara pertama yang disemak |
|---|---|---|
configuration |
Secret atau tetapan repositori tiada atau tidak betul bentuknya | Nama dan format secret, penyediaan push mirror |
credentials |
Satu perkhidmatan menolak token (HTTP 401) | Token tamat tempoh, dibatalkan atau tersalah taip |
permissions |
Token sah tetapi tidak dibenarkan (HTTP 403, atau tiada akses pentadbiran GitHub) | Skop token dan akses repositori |
api |
Ralat HTTP lain, atau perkhidmatan tidak dapat dicapai | Status perkhidmatan, rangkaian runner |
| runner | Tiada baris ERROR:; larian menunggu, atau kerja gagal sebelum skrip |
Runner dalam talian, label, alat |
Mesej dan pembetulan
| Mesej (permulaan) | Kategori | Punca dan pembetulan |
|---|---|---|
PAT_FOR_GITHUB is missing or empty. |
configuration | Tambah secret |
TOKEN_FOR_GITEA is missing or empty. |
configuration | Tambah secret |
Could not determine the Gitea source repository. |
configuration | Larian tiada nama repositori; laporkan sebagai kecacatan |
Expected at most one GitHub push mirror ... found N |
configuration | Kekalkan satu push mirror GitHub |
TOKEN_FOR_GITEA_WIKI is missing or empty. |
configuration | Penerbitan wiki sahaja: repositori memanggil aliran kerja tetapi organisasinya tiada secret itu, atau panggilan tidak menghantarnya; simpannya dan hantar dalam secrets: (lihat credentials.md) |
The prune input must be 'true' or 'false' |
configuration | Penerbitan wiki sahaja: tetapkan prune dalam panggilan kepada "true" atau "false" |
The wiki folder ... does not exist |
configuration | Penerbitan wiki sahaja: tetapkan wiki_dir dalam panggilan kepada folder yang mengandungi halaman (lalai docs/wiki) |
... HTTP 403 ... semasa menerbitkan wiki |
permissions | Penerbitan wiki sahaja: token memerlukan write:repository dan akses tulis kepada repositori ini |
The wiki is not enabled on <repo> |
configuration | Penerbitan wiki sahaja: aktifkan wiki dalam tetapan repositori |
The wiki source directory ... has no Markdown pages |
configuration | Penerbitan wiki sahaja: folder itu tiada halaman Markdown; tiada apa-apa diubah |
Could not determine the GitHub owner and repository ... |
configuration | Alamat cermin mesti kelihatan seperti https://github.com/<owner>/<repo>.git |
Gitea API request failed with HTTP 401 |
credentials | Cipta token Gitea baharu dan kemas kini TOKEN_FOR_GITEA |
GitHub API request failed with HTTP 401 |
credentials | Cipta token GitHub baharu dan kemas kini PAT_FOR_GITHUB; nilai mesti token sahaja (tiada nama, tanda petikan atau JSON) |
... HTTP 403 ... (Gitea) |
permissions | Token memerlukan read:repository, dan penggunanya mesti pentadbir repositori |
... HTTP 403 ... (GitHub) |
permissions | Token memerlukan Administration read and write pada repositori cermin |
The GitHub token cannot administer <repo> |
permissions | Sama seperti di atas; token boleh membaca repositori tetapi tidak boleh mengeditnya |
... HTTP 404 ... |
configuration | Repositori tidak ditemui, atau token tidak dapat melihatnya; semak alamat cermin dan akses repositori token |
... HTTP 5xx ... |
api | Masalah perkhidmatan; jalankan semula kemudian |
... API is unreachable ... |
api | Masalah rangkaian, DNS atau proksi pada runner |
Bukan satu ralat
No GitHub push mirror configured for <repo>; nothing to sync. diikuti oleh Skipped. Larian berjaya. Tidak semua repositori Gitea mempunyai cermin GitHub, jadi ini dijangka bagi repositori tersebut. Jika repositori itu sepatutnya mempunyainya, tambahkannya dalam tetapan repositori.
WARNING: Gitea returned an invalid push mirror list; GitHub metadata was not synced. Larian berjaya tetapi tiada apa-apa disegerakkan. Semak bahawa versi Gitea menyokong API push mirror dan jalankan semula.
<n> page(s) are in the wiki but not in <folder>/ and were kept; set the prune input to true to delete them. Larian berjaya. Halaman yang hanya ada dalam wiki dibiarkan melainkan panggilan menetapkan prune: "true".
Masalah runner
Lihat bahagian Runners. Ringkasnya: jika larian kekal waiting, tiada runner dalam talian yang mempunyai label itu; jika kerja gagal sebelum skrip, imej runner tiada satu alat.
Menjalankan semula
Gunakan Run workflow (workflow_dispatch) selepas puncanya dibetulkan. Penyegerakan selamat diulang: ia menimpa penerangan dan topik GitHub dengan nilai daripada Gitea.